updated project site -- build no: 96 -- publish Ditto 2.0
Signed-off-by: Eclipse Ditto Bot <ditto-bot@eclipse.org>
diff --git a/1.0/2017-11-10-welcome-to-ditto.html b/1.0/2017-11-10-welcome-to-ditto.html
index 8b2a606..327cba1 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 436b432..4765244 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 898e87a..85c1d0e 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 aba4984..e001212 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 6093198..1327cee 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 7171d9a..620339d 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 c1538cc..1651c31 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 1a956da..c87f44e 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 5fc5743..e00466f 100644
--- a/1.0/2018-05-02-connecting-ditto-hono.html
+++ b/1.0/2018-05-02-connecting-ditto-hono.html
@@ -1006,7 +1006,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 4a09c14..259566f 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 8edcfaa..5831433 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 5addbf1..1540e80 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 d8098f1..4a2d90e 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 10a424e..6dfa6c8 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 44586a1..4ad754f 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 15c83d2..e483b67 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 afd15e5..1889958 100644
--- a/1.0/2018-12-05-example-command-and-control.html
+++ b/1.0/2018-12-05-example-command-and-control.html
@@ -519,7 +519,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 1f45d55..d8d07e1 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 a0df7ca..6c50986 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 df41334..b3eb2ee 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 6cee3b5..21f79ae 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 25fb1a8..d4e2a33 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 9ba05f0..a5a51c5 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 da4dd5c..5dad5dd 100644
--- a/1.0/2019-10-17-http-connectivity.html
+++ b/1.0/2019-10-17-http-connectivity.html
@@ -291,7 +291,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 dcf4a88..05851ae 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 07ba0a0..1ef5720 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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
index f398829..0260a65 100644
--- a/1.0/2020-04-16-connecting-to-ttn-via-mqtt.html
+++ b/1.0/2020-04-16-connecting-to-ttn-via-mqtt.html
@@ -778,7 +778,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/2020-04-29-release-announcement-110.html b/1.0/2020-04-29-release-announcement-110.html
index ca98a52..9f21017 100644
--- a/1.0/2020-04-29-release-announcement-110.html
+++ b/1.0/2020-04-29-release-announcement-110.html
@@ -312,7 +312,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/404.html b/1.0/404.html
index e4ea50e..1506c4d 100644
--- a/1.0/404.html
+++ b/1.0/404.html
@@ -1456,7 +1456,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 1539a20..4de879e 100644
--- a/1.0/architecture-overview.html
+++ b/1.0/architecture-overview.html
@@ -1509,7 +1509,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 2b617fe..89f1ee6 100644
--- a/1.0/architecture-services-concierge.html
+++ b/1.0/architecture-services-concierge.html
@@ -1495,7 +1495,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 7588cb5..ab2ba13 100644
--- a/1.0/architecture-services-connectivity.html
+++ b/1.0/architecture-services-connectivity.html
@@ -1509,7 +1509,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 08e5333..177737a 100644
--- a/1.0/architecture-services-gateway.html
+++ b/1.0/architecture-services-gateway.html
@@ -1487,7 +1487,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 1425db7..b50ae3c 100644
--- a/1.0/architecture-services-policies.html
+++ b/1.0/architecture-services-policies.html
@@ -1488,7 +1488,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 8885c41..dd47043 100644
--- a/1.0/architecture-services-things-search.html
+++ b/1.0/architecture-services-things-search.html
@@ -1532,7 +1532,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 4a284d9..258afb1 100644
--- a/1.0/architecture-services-things.html
+++ b/1.0/architecture-services-things.html
@@ -1488,7 +1488,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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
index 3c4de6b..99b3a7d 100644
--- a/1.0/basic-acknowledgements.html
+++ b/1.0/basic-acknowledgements.html
@@ -1637,7 +1637,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/basic-acl.html b/1.0/basic-acl.html
index ee3aa4b..08c1fd1 100644
--- a/1.0/basic-acl.html
+++ b/1.0/basic-acl.html
@@ -1526,7 +1526,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 8899dc8..5234934 100644
--- a/1.0/basic-apis.html
+++ b/1.0/basic-apis.html
@@ -1584,7 +1584,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 4d2644c..3078eec 100644
--- a/1.0/basic-auth.html
+++ b/1.0/basic-auth.html
@@ -1505,7 +1505,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 ab28e9c..d80085b 100644
--- a/1.0/basic-changenotifications.html
+++ b/1.0/basic-changenotifications.html
@@ -1528,7 +1528,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 7aee278..9ff725d 100644
--- a/1.0/basic-connections.html
+++ b/1.0/basic-connections.html
@@ -1923,7 +1923,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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
index 7f5f06c..fb2f872 100644
--- a/1.0/basic-enrichment.html
+++ b/1.0/basic-enrichment.html
@@ -1561,7 +1561,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/basic-feature.html b/1.0/basic-feature.html
index 9f71983..ef94407 100644
--- a/1.0/basic-feature.html
+++ b/1.0/basic-feature.html
@@ -1689,7 +1689,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 ab4b379..ca7b3d8 100644
--- a/1.0/basic-messages.html
+++ b/1.0/basic-messages.html
@@ -1598,7 +1598,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 11fe01a..dcfc4e5 100644
--- a/1.0/basic-namespaces-and-names.html
+++ b/1.0/basic-namespaces-and-names.html
@@ -1528,7 +1528,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 db32ca0..a2fd479 100644
--- a/1.0/basic-overview.html
+++ b/1.0/basic-overview.html
@@ -1601,7 +1601,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 a5a169b..80a0563 100644
--- a/1.0/basic-placeholders.html
+++ b/1.0/basic-placeholders.html
@@ -1721,7 +1721,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 57826a2..b408753 100644
--- a/1.0/basic-policy.html
+++ b/1.0/basic-policy.html
@@ -1867,7 +1867,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 11ecd78..dbb7532 100644
--- a/1.0/basic-rql.html
+++ b/1.0/basic-rql.html
@@ -1707,7 +1707,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 4f876b2..3609ce7 100644
--- a/1.0/basic-search.html
+++ b/1.0/basic-search.html
@@ -1600,7 +1600,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 45d5c45..bc5b033 100644
--- a/1.0/basic-signals-command.html
+++ b/1.0/basic-signals-command.html
@@ -1486,7 +1486,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 4373477..1ac64c6 100644
--- a/1.0/basic-signals-commandresponse.html
+++ b/1.0/basic-signals-commandresponse.html
@@ -1466,7 +1466,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 e9d38e1..088b5b8 100644
--- a/1.0/basic-signals-errorresponse.html
+++ b/1.0/basic-signals-errorresponse.html
@@ -1468,7 +1468,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 f1a8144..a21a5b4 100644
--- a/1.0/basic-signals-event.html
+++ b/1.0/basic-signals-event.html
@@ -1472,7 +1472,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 3aeef04..91f84cd 100644
--- a/1.0/basic-signals.html
+++ b/1.0/basic-signals.html
@@ -1516,7 +1516,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 2d1c245..029e5a3 100644
--- a/1.0/basic-thing.html
+++ b/1.0/basic-thing.html
@@ -1552,7 +1552,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 69c880e..997326d 100644
--- a/1.0/blog.html
+++ b/1.0/blog.html
@@ -393,7 +393,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 4e918b9..90712ce 100644
--- a/1.0/blog_archive.html
+++ b/1.0/blog_archive.html
@@ -446,7 +446,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 a1a4ab5..7225ddb 100644
--- a/1.0/client-sdk-java.html
+++ b/1.0/client-sdk-java.html
@@ -1713,7 +1713,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 d41cfa7..14e4058 100644
--- a/1.0/client-sdk-javascript.html
+++ b/1.0/client-sdk-javascript.html
@@ -1522,7 +1522,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 173985c..f98d079 100644
--- a/1.0/client-sdk-overview.html
+++ b/1.0/client-sdk-overview.html
@@ -1469,7 +1469,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 724c747..a0f039d 100644
--- a/1.0/connectivity-header-mapping.html
+++ b/1.0/connectivity-header-mapping.html
@@ -1479,7 +1479,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 1601aac..ac8c26b 100644
--- a/1.0/connectivity-manage-connections.html
+++ b/1.0/connectivity-manage-connections.html
@@ -1784,7 +1784,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 6ef952e..ee0ac00 100644
--- a/1.0/connectivity-mapping.html
+++ b/1.0/connectivity-mapping.html
@@ -2249,7 +2249,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 6c69e42..fb4ac40 100644
--- a/1.0/connectivity-overview.html
+++ b/1.0/connectivity-overview.html
@@ -1480,7 +1480,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 4aa3ce3..dad690a 100644
--- a/1.0/connectivity-protocol-bindings-amqp091.html
+++ b/1.0/connectivity-protocol-bindings-amqp091.html
@@ -1578,7 +1578,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 2120699..67d5a09 100644
--- a/1.0/connectivity-protocol-bindings-amqp10.html
+++ b/1.0/connectivity-protocol-bindings-amqp10.html
@@ -1624,7 +1624,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 6a5ab98..b75a291 100644
--- a/1.0/connectivity-protocol-bindings-http.html
+++ b/1.0/connectivity-protocol-bindings-http.html
@@ -1569,7 +1569,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 95973cc..c33296c 100644
--- a/1.0/connectivity-protocol-bindings-kafka2.html
+++ b/1.0/connectivity-protocol-bindings-kafka2.html
@@ -1568,7 +1568,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 853f6d7..bed6b9e 100644
--- a/1.0/connectivity-protocol-bindings-mqtt.html
+++ b/1.0/connectivity-protocol-bindings-mqtt.html
@@ -1673,7 +1673,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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
index 7d4b822..4597494 100644
--- a/1.0/connectivity-protocol-bindings-mqtt5.html
+++ b/1.0/connectivity-protocol-bindings-mqtt5.html
@@ -1641,7 +1641,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/connectivity-tls-certificates.html b/1.0/connectivity-tls-certificates.html
index 808052c..6f9d4d7 100644
--- a/1.0/connectivity-tls-certificates.html
+++ b/1.0/connectivity-tls-certificates.html
@@ -1575,7 +1575,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 b055d5b..c836367 100644
--- a/1.0/feedback.html
+++ b/1.0/feedback.html
@@ -1481,7 +1481,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/glossary.html b/1.0/glossary.html
index 7dfb7ce..47ddc33 100644
--- a/1.0/glossary.html
+++ b/1.0/glossary.html
@@ -1469,7 +1469,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 6298788..8d4776c 100644
--- a/1.0/http-api-doc.html
+++ b/1.0/http-api-doc.html
@@ -201,7 +201,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/httpapi-concepts.html b/1.0/httpapi-concepts.html
index 5beb357..1bc53b6 100644
--- a/1.0/httpapi-concepts.html
+++ b/1.0/httpapi-concepts.html
@@ -2055,7 +2055,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 78a4975..70f2c4d 100644
--- a/1.0/httpapi-messages.html
+++ b/1.0/httpapi-messages.html
@@ -1557,7 +1557,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 ef19cd3..f58dc3b 100644
--- a/1.0/httpapi-overview.html
+++ b/1.0/httpapi-overview.html
@@ -1477,7 +1477,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 895ee7c..83e247d 100644
--- a/1.0/httpapi-protocol-bindings-websocket.html
+++ b/1.0/httpapi-protocol-bindings-websocket.html
@@ -1757,7 +1757,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 a1d13c3..e15f501 100644
--- a/1.0/httpapi-search.html
+++ b/1.0/httpapi-search.html
@@ -1524,7 +1524,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 cae08fd..5629580 100644
--- a/1.0/httpapi-sse.html
+++ b/1.0/httpapi-sse.html
@@ -1703,7 +1703,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/index.html b/1.0/index.html
index d3a5764..e0a34ee 100644
--- a/1.0/index.html
+++ b/1.0/index.html
@@ -264,7 +264,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 2965e15..83d87ee 100644
--- a/1.0/installation-building.html
+++ b/1.0/installation-building.html
@@ -1496,7 +1496,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 95b15f6..170db50 100644
--- a/1.0/installation-operating.html
+++ b/1.0/installation-operating.html
@@ -2352,7 +2352,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 6a3851d..7df1563 100644
--- a/1.0/installation-running.html
+++ b/1.0/installation-running.html
@@ -1524,7 +1524,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 8034185..fd2c75e 100644
--- a/1.0/intro-digitaltwins.html
+++ b/1.0/intro-digitaltwins.html
@@ -1499,7 +1499,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 8b825de..b642fbd 100644
--- a/1.0/intro-hello-world.html
+++ b/1.0/intro-hello-world.html
@@ -1588,7 +1588,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 f4f23ee..35f70a2 100644
--- a/1.0/intro-overview.html
+++ b/1.0/intro-overview.html
@@ -1515,7 +1515,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/presentations.html b/1.0/presentations.html
index cd39a37..5175bc5 100644
--- a/1.0/presentations.html
+++ b/1.0/presentations.html
@@ -1497,7 +1497,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 e990998..2c708ec 100644
--- a/1.0/protocol-bindings.html
+++ b/1.0/protocol-bindings.html
@@ -1488,7 +1488,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 fd3080f..b30fed7 100644
--- a/1.0/protocol-examples-createattribute.html
+++ b/1.0/protocol-examples-createattribute.html
@@ -1491,7 +1491,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 03d0c6d..55d084b 100644
--- a/1.0/protocol-examples-createattributes.html
+++ b/1.0/protocol-examples-createattributes.html
@@ -1496,7 +1496,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 4fd6169..ecccc72 100644
--- a/1.0/protocol-examples-createdefinition.html
+++ b/1.0/protocol-examples-createdefinition.html
@@ -1489,7 +1489,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 305d3f8..a8c0d1d 100644
--- a/1.0/protocol-examples-createfeature.html
+++ b/1.0/protocol-examples-createfeature.html
@@ -1500,7 +1500,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 d6784d5..957c89b 100644
--- a/1.0/protocol-examples-createfeatures.html
+++ b/1.0/protocol-examples-createfeatures.html
@@ -1504,7 +1504,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 5d55ce8..bb76825 100644
--- a/1.0/protocol-examples-createproperties.html
+++ b/1.0/protocol-examples-createproperties.html
@@ -1495,7 +1495,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 40bb9cd..9155616 100644
--- a/1.0/protocol-examples-createproperty.html
+++ b/1.0/protocol-examples-createproperty.html
@@ -1485,7 +1485,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 2154bd1..706b436 100644
--- a/1.0/protocol-examples-creatething.html
+++ b/1.0/protocol-examples-creatething.html
@@ -1584,7 +1584,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 273978b..0a1b59e 100644
--- a/1.0/protocol-examples-createthingdefinition.html
+++ b/1.0/protocol-examples-createthingdefinition.html
@@ -1486,7 +1486,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 76530e3..a7501a8 100644
--- a/1.0/protocol-examples-deleteattribute.html
+++ b/1.0/protocol-examples-deleteattribute.html
@@ -1483,7 +1483,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 94a460a..e631318 100644
--- a/1.0/protocol-examples-deleteattributes.html
+++ b/1.0/protocol-examples-deleteattributes.html
@@ -1483,7 +1483,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 1df408a..5272f52 100644
--- a/1.0/protocol-examples-deletedefinition.html
+++ b/1.0/protocol-examples-deletedefinition.html
@@ -1483,7 +1483,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 d6800eb..bbd8c65 100644
--- a/1.0/protocol-examples-deletefeature.html
+++ b/1.0/protocol-examples-deletefeature.html
@@ -1483,7 +1483,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 13778c1..3332f1a 100644
--- a/1.0/protocol-examples-deletefeatures.html
+++ b/1.0/protocol-examples-deletefeatures.html
@@ -1483,7 +1483,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 e51ed4a..0da5ccd 100644
--- a/1.0/protocol-examples-deleteproperties.html
+++ b/1.0/protocol-examples-deleteproperties.html
@@ -1483,7 +1483,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 3d6f2da..a4819c8 100644
--- a/1.0/protocol-examples-deleteproperty.html
+++ b/1.0/protocol-examples-deleteproperty.html
@@ -1483,7 +1483,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 0fa8196..7264684 100644
--- a/1.0/protocol-examples-deletething.html
+++ b/1.0/protocol-examples-deletething.html
@@ -1483,7 +1483,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 2e895cf..0dce9d1 100644
--- a/1.0/protocol-examples-deletethingdefinition.html
+++ b/1.0/protocol-examples-deletethingdefinition.html
@@ -1483,7 +1483,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 c7731a1..ed9e262 100644
--- a/1.0/protocol-examples-errorresponses.html
+++ b/1.0/protocol-examples-errorresponses.html
@@ -1918,7 +1918,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 3e11e54..5ec9b23 100644
--- a/1.0/protocol-examples-modifyattribute.html
+++ b/1.0/protocol-examples-modifyattribute.html
@@ -1491,7 +1491,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 d62beee..e354351 100644
--- a/1.0/protocol-examples-modifyattributes.html
+++ b/1.0/protocol-examples-modifyattributes.html
@@ -1496,7 +1496,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 096ac58..11d57d6 100644
--- a/1.0/protocol-examples-modifydefinition.html
+++ b/1.0/protocol-examples-modifydefinition.html
@@ -1489,7 +1489,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 25114a4..e5b8421 100644
--- a/1.0/protocol-examples-modifyfeature.html
+++ b/1.0/protocol-examples-modifyfeature.html
@@ -1500,7 +1500,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 fc4561c..d7346a0 100644
--- a/1.0/protocol-examples-modifyfeatures.html
+++ b/1.0/protocol-examples-modifyfeatures.html
@@ -1504,7 +1504,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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
index b593f9f..b18595a 100644
--- a/1.0/protocol-examples-modifypolicyid.html
+++ b/1.0/protocol-examples-modifypolicyid.html
@@ -1507,7 +1507,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-modifyproperties.html b/1.0/protocol-examples-modifyproperties.html
index 2e7eac6..9b3adfd 100644
--- a/1.0/protocol-examples-modifyproperties.html
+++ b/1.0/protocol-examples-modifyproperties.html
@@ -1495,7 +1495,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 e3300ca..d8b13a3 100644
--- a/1.0/protocol-examples-modifyproperty.html
+++ b/1.0/protocol-examples-modifyproperty.html
@@ -1485,7 +1485,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 4a55756..3d2d0fb 100644
--- a/1.0/protocol-examples-modifything.html
+++ b/1.0/protocol-examples-modifything.html
@@ -1565,7 +1565,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 99410f3..f313423 100644
--- a/1.0/protocol-examples-modifythingdefinition.html
+++ b/1.0/protocol-examples-modifythingdefinition.html
@@ -1485,7 +1485,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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
index c073e9e..690d636 100644
--- a/1.0/protocol-examples-policies-createpolicy.html
+++ b/1.0/protocol-examples-policies-createpolicy.html
@@ -1519,7 +1519,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-policies-createpolicyentry.html b/1.0/protocol-examples-policies-createpolicyentry.html
index 894556f..0b0ac5f 100644
--- a/1.0/protocol-examples-policies-createpolicyentry.html
+++ b/1.0/protocol-examples-policies-createpolicyentry.html
@@ -1495,7 +1495,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-policies-createresource.html b/1.0/protocol-examples-policies-createresource.html
index 867644f..b8872b1 100644
--- a/1.0/protocol-examples-policies-createresource.html
+++ b/1.0/protocol-examples-policies-createresource.html
@@ -1484,7 +1484,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-policies-createsubject.html b/1.0/protocol-examples-policies-createsubject.html
index 07846bf..143d690 100644
--- a/1.0/protocol-examples-policies-createsubject.html
+++ b/1.0/protocol-examples-policies-createsubject.html
@@ -1480,7 +1480,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-policies-deletepolicy.html b/1.0/protocol-examples-policies-deletepolicy.html
index 60f4f40..c295048 100644
--- a/1.0/protocol-examples-policies-deletepolicy.html
+++ b/1.0/protocol-examples-policies-deletepolicy.html
@@ -1477,7 +1477,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-policies-deletepolicyentry.html b/1.0/protocol-examples-policies-deletepolicyentry.html
index 5bf3335..8744b23 100644
--- a/1.0/protocol-examples-policies-deletepolicyentry.html
+++ b/1.0/protocol-examples-policies-deletepolicyentry.html
@@ -1477,7 +1477,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-policies-deleteresource.html b/1.0/protocol-examples-policies-deleteresource.html
index 8c49fa7..27910a3 100644
--- a/1.0/protocol-examples-policies-deleteresource.html
+++ b/1.0/protocol-examples-policies-deleteresource.html
@@ -1477,7 +1477,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-policies-deletesubject.html b/1.0/protocol-examples-policies-deletesubject.html
index 40a5362..bfde7c8 100644
--- a/1.0/protocol-examples-policies-deletesubject.html
+++ b/1.0/protocol-examples-policies-deletesubject.html
@@ -1477,7 +1477,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-policies-errorresponses.html b/1.0/protocol-examples-policies-errorresponses.html
index 5cba241..115ee21 100644
--- a/1.0/protocol-examples-policies-errorresponses.html
+++ b/1.0/protocol-examples-policies-errorresponses.html
@@ -1815,7 +1815,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-policies-modifypolicy.html b/1.0/protocol-examples-policies-modifypolicy.html
index b020d16..8efb695 100644
--- a/1.0/protocol-examples-policies-modifypolicy.html
+++ b/1.0/protocol-examples-policies-modifypolicy.html
@@ -1498,7 +1498,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-policies-modifypolicyentries.html b/1.0/protocol-examples-policies-modifypolicyentries.html
index 6c82187..f4f1e8c 100644
--- a/1.0/protocol-examples-policies-modifypolicyentries.html
+++ b/1.0/protocol-examples-policies-modifypolicyentries.html
@@ -1517,7 +1517,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-policies-modifypolicyentry.html b/1.0/protocol-examples-policies-modifypolicyentry.html
index b64f494..5836e39 100644
--- a/1.0/protocol-examples-policies-modifypolicyentry.html
+++ b/1.0/protocol-examples-policies-modifypolicyentry.html
@@ -1495,7 +1495,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-policies-modifyresource.html b/1.0/protocol-examples-policies-modifyresource.html
index f2cd355..86d5c52 100644
--- a/1.0/protocol-examples-policies-modifyresource.html
+++ b/1.0/protocol-examples-policies-modifyresource.html
@@ -1484,7 +1484,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-policies-modifyresources.html b/1.0/protocol-examples-policies-modifyresources.html
index 89c8edb..5f63a89 100644
--- a/1.0/protocol-examples-policies-modifyresources.html
+++ b/1.0/protocol-examples-policies-modifyresources.html
@@ -1487,7 +1487,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-policies-modifysubject.html b/1.0/protocol-examples-policies-modifysubject.html
index aea967e..4cdf960 100644
--- a/1.0/protocol-examples-policies-modifysubject.html
+++ b/1.0/protocol-examples-policies-modifysubject.html
@@ -1480,7 +1480,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-policies-modifysubjects.html b/1.0/protocol-examples-policies-modifysubjects.html
index 99e69a8..0375f96 100644
--- a/1.0/protocol-examples-policies-modifysubjects.html
+++ b/1.0/protocol-examples-policies-modifysubjects.html
@@ -1483,7 +1483,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-policies-retrievepolicy.html b/1.0/protocol-examples-policies-retrievepolicy.html
index 05d8ee3..ba07759 100644
--- a/1.0/protocol-examples-policies-retrievepolicy.html
+++ b/1.0/protocol-examples-policies-retrievepolicy.html
@@ -1498,7 +1498,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-policies-retrievepolicyentries.html b/1.0/protocol-examples-policies-retrievepolicyentries.html
index 398a4a8..674ba55 100644
--- a/1.0/protocol-examples-policies-retrievepolicyentries.html
+++ b/1.0/protocol-examples-policies-retrievepolicyentries.html
@@ -1511,7 +1511,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-policies-retrievepolicyentry.html b/1.0/protocol-examples-policies-retrievepolicyentry.html
index 54b5fe3..b8adec8 100644
--- a/1.0/protocol-examples-policies-retrievepolicyentry.html
+++ b/1.0/protocol-examples-policies-retrievepolicyentry.html
@@ -1493,7 +1493,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-policies-retrieveresource.html b/1.0/protocol-examples-policies-retrieveresource.html
index ea56369..6fba612 100644
--- a/1.0/protocol-examples-policies-retrieveresource.html
+++ b/1.0/protocol-examples-policies-retrieveresource.html
@@ -1484,7 +1484,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-policies-retrieveresources.html b/1.0/protocol-examples-policies-retrieveresources.html
index ea46318..dad1a82 100644
--- a/1.0/protocol-examples-policies-retrieveresources.html
+++ b/1.0/protocol-examples-policies-retrieveresources.html
@@ -1486,7 +1486,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-policies-retrievesubject.html b/1.0/protocol-examples-policies-retrievesubject.html
index 5935f74..4ac2f81 100644
--- a/1.0/protocol-examples-policies-retrievesubject.html
+++ b/1.0/protocol-examples-policies-retrievesubject.html
@@ -1480,7 +1480,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-policies-retrievesubjects.html b/1.0/protocol-examples-policies-retrievesubjects.html
index 118d6a3..4f67b6c 100644
--- a/1.0/protocol-examples-policies-retrievesubjects.html
+++ b/1.0/protocol-examples-policies-retrievesubjects.html
@@ -1482,7 +1482,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples-retrieveattribute.html b/1.0/protocol-examples-retrieveattribute.html
index c032c4a..77958c5 100644
--- a/1.0/protocol-examples-retrieveattribute.html
+++ b/1.0/protocol-examples-retrieveattribute.html
@@ -1477,7 +1477,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 88fa829..e5800be 100644
--- a/1.0/protocol-examples-retrieveattributes.html
+++ b/1.0/protocol-examples-retrieveattributes.html
@@ -1479,7 +1479,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 a2698b4..6b32071 100644
--- a/1.0/protocol-examples-retrievedefinition.html
+++ b/1.0/protocol-examples-retrievedefinition.html
@@ -1476,7 +1476,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 1b670b4..0aab5a6 100644
--- a/1.0/protocol-examples-retrievefeature.html
+++ b/1.0/protocol-examples-retrievefeature.html
@@ -1481,7 +1481,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 db953ca..42056bc 100644
--- a/1.0/protocol-examples-retrievefeatures.html
+++ b/1.0/protocol-examples-retrievefeatures.html
@@ -1483,7 +1483,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 06e751c..5c5225d 100644
--- a/1.0/protocol-examples-retrieveproperties.html
+++ b/1.0/protocol-examples-retrieveproperties.html
@@ -1479,7 +1479,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 39c6296..99a0e33 100644
--- a/1.0/protocol-examples-retrieveproperty.html
+++ b/1.0/protocol-examples-retrieveproperty.html
@@ -1474,7 +1474,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 81b629b..3ab4180 100644
--- a/1.0/protocol-examples-retrievething.html
+++ b/1.0/protocol-examples-retrievething.html
@@ -1503,7 +1503,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 c997f8d..8d9bdad 100644
--- a/1.0/protocol-examples-retrievethingdefinition.html
+++ b/1.0/protocol-examples-retrievethingdefinition.html
@@ -1474,7 +1474,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 8759d94..2cd79b7 100644
--- a/1.0/protocol-examples-retrievethings.html
+++ b/1.0/protocol-examples-retrievethings.html
@@ -1500,7 +1500,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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
index 6a8d1ca..a43c175 100644
--- a/1.0/protocol-examples-search.html
+++ b/1.0/protocol-examples-search.html
@@ -1578,7 +1578,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-examples.html b/1.0/protocol-examples.html
index 2a220d8..e76aaf8 100644
--- a/1.0/protocol-examples.html
+++ b/1.0/protocol-examples.html
@@ -1560,7 +1560,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 fa8a7b0..9e8ba36 100644
--- a/1.0/protocol-overview.html
+++ b/1.0/protocol-overview.html
@@ -1476,7 +1476,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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
index 51addb9..24f656d 100644
--- a/1.0/protocol-specification-acks.html
+++ b/1.0/protocol-specification-acks.html
@@ -1500,7 +1500,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-specification-policies-create-or-modify.html b/1.0/protocol-specification-policies-create-or-modify.html
index cc75eb5..12c24ad 100644
--- a/1.0/protocol-specification-policies-create-or-modify.html
+++ b/1.0/protocol-specification-policies-create-or-modify.html
@@ -2078,7 +2078,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-specification-policies-delete.html b/1.0/protocol-specification-policies-delete.html
index cc4099f..f4e4755 100644
--- a/1.0/protocol-specification-policies-delete.html
+++ b/1.0/protocol-specification-policies-delete.html
@@ -1748,7 +1748,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-specification-policies-retrieve.html b/1.0/protocol-specification-policies-retrieve.html
index dfad744..413fa83 100644
--- a/1.0/protocol-specification-policies-retrieve.html
+++ b/1.0/protocol-specification-policies-retrieve.html
@@ -1971,7 +1971,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-specification-policies.html b/1.0/protocol-specification-policies.html
index 9b539fb..29dff02 100644
--- a/1.0/protocol-specification-policies.html
+++ b/1.0/protocol-specification-policies.html
@@ -1558,7 +1558,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/protocol-specification-things-create-or-modify.html b/1.0/protocol-specification-things-create-or-modify.html
index 7231d96..c315db1 100644
--- a/1.0/protocol-specification-things-create-or-modify.html
+++ b/1.0/protocol-specification-things-create-or-modify.html
@@ -2878,7 +2878,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 af72870..859e87a 100644
--- a/1.0/protocol-specification-things-delete.html
+++ b/1.0/protocol-specification-things-delete.html
@@ -2365,7 +2365,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 437b090..a5c382f 100644
--- a/1.0/protocol-specification-things-messages.html
+++ b/1.0/protocol-specification-things-messages.html
@@ -1720,7 +1720,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 79451df..9f716aa 100644
--- a/1.0/protocol-specification-things-retrieve.html
+++ b/1.0/protocol-specification-things-retrieve.html
@@ -2167,7 +2167,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 d909759..27b6d98 100644
--- a/1.0/protocol-specification-things-search.html
+++ b/1.0/protocol-specification-things-search.html
@@ -1824,7 +1824,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 49f5a50..fdbb271 100644
--- a/1.0/protocol-specification-things.html
+++ b/1.0/protocol-specification-things.html
@@ -1529,7 +1529,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 4553749..a8776f0 100644
--- a/1.0/protocol-specification-topic.html
+++ b/1.0/protocol-specification-topic.html
@@ -1634,7 +1634,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 b03db42..4691817 100644
--- a/1.0/protocol-specification.html
+++ b/1.0/protocol-specification.html
@@ -1616,7 +1616,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 d68a34e..b993b94 100644
--- a/1.0/protocol-twinlive.html
+++ b/1.0/protocol-twinlive.html
@@ -1487,7 +1487,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 ef84e09..bc29cf6 100644
--- a/1.0/release_notes_010-M1.html
+++ b/1.0/release_notes_010-M1.html
@@ -1466,7 +1466,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 e12f666..828b1d6 100644
--- a/1.0/release_notes_010-M3.html
+++ b/1.0/release_notes_010-M3.html
@@ -1522,7 +1522,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 dc96454..647d354 100644
--- a/1.0/release_notes_020-M1.html
+++ b/1.0/release_notes_020-M1.html
@@ -1507,7 +1507,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 3584790..9d92607 100644
--- a/1.0/release_notes_030-M1.html
+++ b/1.0/release_notes_030-M1.html
@@ -1518,7 +1518,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 3658465..ab86c1c 100644
--- a/1.0/release_notes_030-M2.html
+++ b/1.0/release_notes_030-M2.html
@@ -1515,7 +1515,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 a57d5f9..227d851 100644
--- a/1.0/release_notes_080-M1.html
+++ b/1.0/release_notes_080-M1.html
@@ -1537,7 +1537,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 3e6520a..6517b87 100644
--- a/1.0/release_notes_080-M2.html
+++ b/1.0/release_notes_080-M2.html
@@ -1521,7 +1521,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 135099f..1532fc3 100644
--- a/1.0/release_notes_080-M3.html
+++ b/1.0/release_notes_080-M3.html
@@ -1525,7 +1525,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 5eff1be..73aa29d 100644
--- a/1.0/release_notes_080.html
+++ b/1.0/release_notes_080.html
@@ -1531,7 +1531,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 b83c300..da55e3b 100644
--- a/1.0/release_notes_090-M1.html
+++ b/1.0/release_notes_090-M1.html
@@ -1503,7 +1503,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 a0b50be..3af55e6 100644
--- a/1.0/release_notes_090-M2.html
+++ b/1.0/release_notes_090-M2.html
@@ -1504,7 +1504,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 2f78973..a1f9b37 100644
--- a/1.0/release_notes_090.html
+++ b/1.0/release_notes_090.html
@@ -1561,7 +1561,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 ef8eaf0..4b27b97 100644
--- a/1.0/release_notes_100-M1a.html
+++ b/1.0/release_notes_100-M1a.html
@@ -1522,7 +1522,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 acad07a..c250eb6 100644
--- a/1.0/release_notes_100-M2.html
+++ b/1.0/release_notes_100-M2.html
@@ -1539,7 +1539,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 e3fd1ef..bb1eb03 100644
--- a/1.0/release_notes_100.html
+++ b/1.0/release_notes_100.html
@@ -1544,7 +1544,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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
index 479b9fa..e018c1d 100644
--- a/1.0/release_notes_110.html
+++ b/1.0/release_notes_110.html
@@ -1585,7 +1585,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/sandbox.html b/1.0/sandbox.html
index 95a574d..072796c 100644
--- a/1.0/sandbox.html
+++ b/1.0/sandbox.html
@@ -1511,7 +1511,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.0/tag_architecture.html b/1.0/tag_architecture.html
index 84a16e9..515237b 100644
--- a/1.0/tag_architecture.html
+++ b/1.0/tag_architecture.html
@@ -2217,7 +2217,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 f77192c..b46ce3f 100644
--- a/1.0/tag_blog.html
+++ b/1.0/tag_blog.html
@@ -2343,7 +2343,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 08545cb..1de0eaf 100644
--- a/1.0/tag_client_sdk.html
+++ b/1.0/tag_client_sdk.html
@@ -2203,7 +2203,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 7fb60d8..a11d5ee 100644
--- a/1.0/tag_connectivity.html
+++ b/1.0/tag_connectivity.html
@@ -2289,7 +2289,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 fb87cc8..99cdf4e 100644
--- a/1.0/tag_getting_started.html
+++ b/1.0/tag_getting_started.html
@@ -2217,7 +2217,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 bdeb0cc..b20680b 100644
--- a/1.0/tag_http.html
+++ b/1.0/tag_http.html
@@ -2211,7 +2211,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 c47b8d7..d3ae889 100644
--- a/1.0/tag_installation.html
+++ b/1.0/tag_installation.html
@@ -2193,7 +2193,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 0e6433b..ae4b14b 100644
--- a/1.0/tag_model.html
+++ b/1.0/tag_model.html
@@ -2241,7 +2241,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 3a6d9b5..f14b818 100644
--- a/1.0/tag_news.html
+++ b/1.0/tag_news.html
@@ -2175,7 +2175,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 e3a74d2..dc80133 100644
--- a/1.0/tag_protocol.html
+++ b/1.0/tag_protocol.html
@@ -2331,7 +2331,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 a2f4a06..44b8c94 100644
--- a/1.0/tag_release_notes.html
+++ b/1.0/tag_release_notes.html
@@ -2271,7 +2271,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 599ae49..f229c9e 100644
--- a/1.0/tag_rql.html
+++ b/1.0/tag_rql.html
@@ -2241,7 +2241,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 1cb8872..785c05a 100644
--- a/1.0/tag_search.html
+++ b/1.0/tag_search.html
@@ -2211,7 +2211,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 5232e30..4b5dfde 100644
--- a/1.0/tag_signal.html
+++ b/1.0/tag_signal.html
@@ -2210,7 +2210,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 1e7dde1..8d11880 100644
--- a/1.0/tag_troubleshooting.html
+++ b/1.0/tag_troubleshooting.html
@@ -2181,7 +2181,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 8b2a606..327cba1 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 436b432..4765244 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 898e87a..85c1d0e 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 aba4984..e001212 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 6093198..1327cee 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 7171d9a..620339d 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 c1538cc..1651c31 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 1a956da..c87f44e 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 5fc5743..e00466f 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 4a09c14..259566f 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 8edcfaa..5831433 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 5addbf1..1540e80 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 d8098f1..4a2d90e 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 10a424e..6dfa6c8 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 44586a1..4ad754f 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 15c83d2..e483b67 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 afd15e5..1889958 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 1f45d55..d8d07e1 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 a0df7ca..6c50986 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 df41334..b3eb2ee 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 6cee3b5..21f79ae 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 25fb1a8..d4e2a33 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 9ba05f0..a5a51c5 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 da4dd5c..5dad5dd 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 dcf4a88..05851ae 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 07ba0a0..1ef5720 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 f398829..0260a65 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 ca98a52..9f21017 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">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 31fe5a8..bd4c70f 100644
--- a/1.1/404.html
+++ b/1.1/404.html
@@ -1484,7 +1484,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 7745799..603fcd3 100644
--- a/1.1/architecture-overview.html
+++ b/1.1/architecture-overview.html
@@ -1537,7 +1537,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 4bb4da1..175c329 100644
--- a/1.1/architecture-services-concierge.html
+++ b/1.1/architecture-services-concierge.html
@@ -1523,7 +1523,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 0088d78..38cadbd 100644
--- a/1.1/architecture-services-connectivity.html
+++ b/1.1/architecture-services-connectivity.html
@@ -1537,7 +1537,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 0a95b40..d28c3a7 100644
--- a/1.1/architecture-services-gateway.html
+++ b/1.1/architecture-services-gateway.html
@@ -1515,7 +1515,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 c7d026b..ae8eedf 100644
--- a/1.1/architecture-services-policies.html
+++ b/1.1/architecture-services-policies.html
@@ -1516,7 +1516,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 90a54ae..85f14b6 100644
--- a/1.1/architecture-services-things-search.html
+++ b/1.1/architecture-services-things-search.html
@@ -1560,7 +1560,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 671ae09..4733430 100644
--- a/1.1/architecture-services-things.html
+++ b/1.1/architecture-services-things.html
@@ -1516,7 +1516,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 a0d18de..318f1bf 100644
--- a/1.1/basic-acknowledgements.html
+++ b/1.1/basic-acknowledgements.html
@@ -1665,7 +1665,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 b60f6fe..c4bd652 100644
--- a/1.1/basic-acl.html
+++ b/1.1/basic-acl.html
@@ -1554,7 +1554,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 83475c8..ecd9782 100644
--- a/1.1/basic-apis.html
+++ b/1.1/basic-apis.html
@@ -1612,7 +1612,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 961638f..e956dd4 100644
--- a/1.1/basic-auth.html
+++ b/1.1/basic-auth.html
@@ -1533,7 +1533,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 624ab01..a852dbf 100644
--- a/1.1/basic-changenotifications.html
+++ b/1.1/basic-changenotifications.html
@@ -1556,7 +1556,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 f447f73..a2a5b72 100644
--- a/1.1/basic-connections.html
+++ b/1.1/basic-connections.html
@@ -1951,7 +1951,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 7ed4ee9..e800040 100644
--- a/1.1/basic-enrichment.html
+++ b/1.1/basic-enrichment.html
@@ -1589,7 +1589,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 376aa01..a03bd12 100644
--- a/1.1/basic-feature.html
+++ b/1.1/basic-feature.html
@@ -1717,7 +1717,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 e65e9df..1bcd25d 100644
--- a/1.1/basic-messages.html
+++ b/1.1/basic-messages.html
@@ -1626,7 +1626,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 7b6ebca..117c30b 100644
--- a/1.1/basic-namespaces-and-names.html
+++ b/1.1/basic-namespaces-and-names.html
@@ -1556,7 +1556,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 ad340a8..244fc5c 100644
--- a/1.1/basic-overview.html
+++ b/1.1/basic-overview.html
@@ -1629,7 +1629,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 c7b5d86..155c54e 100644
--- a/1.1/basic-placeholders.html
+++ b/1.1/basic-placeholders.html
@@ -1749,7 +1749,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 925a2d5..ee955cc 100644
--- a/1.1/basic-policy.html
+++ b/1.1/basic-policy.html
@@ -1895,7 +1895,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 79d2706..2d4e1e9 100644
--- a/1.1/basic-rql.html
+++ b/1.1/basic-rql.html
@@ -1735,7 +1735,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 b9e33b9..26eae43 100644
--- a/1.1/basic-search.html
+++ b/1.1/basic-search.html
@@ -1628,7 +1628,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 00e1aa7..2373f0b 100644
--- a/1.1/basic-signals-command.html
+++ b/1.1/basic-signals-command.html
@@ -1514,7 +1514,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 ddb6d32..e8c2012 100644
--- a/1.1/basic-signals-commandresponse.html
+++ b/1.1/basic-signals-commandresponse.html
@@ -1494,7 +1494,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 7154021..f9afcfa 100644
--- a/1.1/basic-signals-errorresponse.html
+++ b/1.1/basic-signals-errorresponse.html
@@ -1496,7 +1496,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 d37753f..af0296f 100644
--- a/1.1/basic-signals-event.html
+++ b/1.1/basic-signals-event.html
@@ -1500,7 +1500,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 d1c2bbd..eeeee20 100644
--- a/1.1/basic-signals.html
+++ b/1.1/basic-signals.html
@@ -1544,7 +1544,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 b55e380..57e5c8d 100644
--- a/1.1/basic-thing.html
+++ b/1.1/basic-thing.html
@@ -1580,7 +1580,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 69c880e..997326d 100644
--- a/1.1/blog.html
+++ b/1.1/blog.html
@@ -393,7 +393,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 4e918b9..90712ce 100644
--- a/1.1/blog_archive.html
+++ b/1.1/blog_archive.html
@@ -446,7 +446,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 63d4d2c..1e9da4f 100644
--- a/1.1/client-sdk-java.html
+++ b/1.1/client-sdk-java.html
@@ -1741,7 +1741,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 fb26a00..e01fa8d 100644
--- a/1.1/client-sdk-javascript.html
+++ b/1.1/client-sdk-javascript.html
@@ -1550,7 +1550,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 0755e4a..62348b0 100644
--- a/1.1/client-sdk-overview.html
+++ b/1.1/client-sdk-overview.html
@@ -1497,7 +1497,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 d5baf9c..71ac917 100644
--- a/1.1/connectivity-header-mapping.html
+++ b/1.1/connectivity-header-mapping.html
@@ -1507,7 +1507,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 0e280b2..782d068 100644
--- a/1.1/connectivity-manage-connections.html
+++ b/1.1/connectivity-manage-connections.html
@@ -1812,7 +1812,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 1354f28..7831a3d 100644
--- a/1.1/connectivity-mapping.html
+++ b/1.1/connectivity-mapping.html
@@ -2277,7 +2277,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 b3db8e2..c2fd29c 100644
--- a/1.1/connectivity-overview.html
+++ b/1.1/connectivity-overview.html
@@ -1508,7 +1508,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 83efe02..b6e1eae 100644
--- a/1.1/connectivity-protocol-bindings-amqp091.html
+++ b/1.1/connectivity-protocol-bindings-amqp091.html
@@ -1606,7 +1606,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 fc73b06..0ba67df 100644
--- a/1.1/connectivity-protocol-bindings-amqp10.html
+++ b/1.1/connectivity-protocol-bindings-amqp10.html
@@ -1652,7 +1652,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 2571939..9cade28 100644
--- a/1.1/connectivity-protocol-bindings-http.html
+++ b/1.1/connectivity-protocol-bindings-http.html
@@ -1597,7 +1597,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 385a925..2263a74 100644
--- a/1.1/connectivity-protocol-bindings-kafka2.html
+++ b/1.1/connectivity-protocol-bindings-kafka2.html
@@ -1596,7 +1596,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 85dec5f..0bd1fa5 100644
--- a/1.1/connectivity-protocol-bindings-mqtt.html
+++ b/1.1/connectivity-protocol-bindings-mqtt.html
@@ -1701,7 +1701,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 ce0af95..1616db5 100644
--- a/1.1/connectivity-protocol-bindings-mqtt5.html
+++ b/1.1/connectivity-protocol-bindings-mqtt5.html
@@ -1669,7 +1669,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 6f4b870..efc297b 100644
--- a/1.1/connectivity-tls-certificates.html
+++ b/1.1/connectivity-tls-certificates.html
@@ -1603,7 +1603,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 7e18efe..8d3ae1d 100644
--- a/1.1/feedback.html
+++ b/1.1/feedback.html
@@ -1509,7 +1509,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 b47da02..f9c7c0e 100644
--- a/1.1/glossary.html
+++ b/1.1/glossary.html
@@ -1497,7 +1497,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 6298788..8d4776c 100644
--- a/1.1/http-api-doc.html
+++ b/1.1/http-api-doc.html
@@ -201,7 +201,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 14149ba..76299df 100644
--- a/1.1/httpapi-concepts.html
+++ b/1.1/httpapi-concepts.html
@@ -2083,7 +2083,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 d331cde..1622a35 100644
--- a/1.1/httpapi-messages.html
+++ b/1.1/httpapi-messages.html
@@ -1585,7 +1585,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 9d9ae83..cda898e 100644
--- a/1.1/httpapi-overview.html
+++ b/1.1/httpapi-overview.html
@@ -1505,7 +1505,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 3b224cd..ea5ab5f 100644
--- a/1.1/httpapi-protocol-bindings-websocket.html
+++ b/1.1/httpapi-protocol-bindings-websocket.html
@@ -1785,7 +1785,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 c434edf..5514a81 100644
--- a/1.1/httpapi-search.html
+++ b/1.1/httpapi-search.html
@@ -1552,7 +1552,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 968dce2..ac6470e 100644
--- a/1.1/httpapi-sse.html
+++ b/1.1/httpapi-sse.html
@@ -1731,7 +1731,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 d3a5764..e0a34ee 100644
--- a/1.1/index.html
+++ b/1.1/index.html
@@ -264,7 +264,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 6ff98ae..83ad63c 100644
--- a/1.1/installation-building.html
+++ b/1.1/installation-building.html
@@ -1524,7 +1524,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 cc29482..d3ee820 100644
--- a/1.1/installation-operating.html
+++ b/1.1/installation-operating.html
@@ -2380,7 +2380,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 2f99560..f0c8f21 100644
--- a/1.1/installation-running.html
+++ b/1.1/installation-running.html
@@ -1552,7 +1552,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 f822f51..1b06e85 100644
--- a/1.1/intro-digitaltwins.html
+++ b/1.1/intro-digitaltwins.html
@@ -1527,7 +1527,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 01c9358..8ef0cf7 100644
--- a/1.1/intro-hello-world.html
+++ b/1.1/intro-hello-world.html
@@ -1616,7 +1616,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 20c55ba..8256794 100644
--- a/1.1/intro-overview.html
+++ b/1.1/intro-overview.html
@@ -1543,7 +1543,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/presentations.html b/1.1/presentations.html
index d67392f..20e8b80 100644
--- a/1.1/presentations.html
+++ b/1.1/presentations.html
@@ -1525,7 +1525,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 347f08c..a14eef6 100644
--- a/1.1/protocol-bindings.html
+++ b/1.1/protocol-bindings.html
@@ -1516,7 +1516,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 9a81d18..e9161ea 100644
--- a/1.1/protocol-examples-createattribute.html
+++ b/1.1/protocol-examples-createattribute.html
@@ -1519,7 +1519,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 a6f513b..108085b 100644
--- a/1.1/protocol-examples-createattributes.html
+++ b/1.1/protocol-examples-createattributes.html
@@ -1524,7 +1524,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 e1fdf46..5514ea8 100644
--- a/1.1/protocol-examples-createdefinition.html
+++ b/1.1/protocol-examples-createdefinition.html
@@ -1517,7 +1517,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 692d072..5443a0c 100644
--- a/1.1/protocol-examples-createfeature.html
+++ b/1.1/protocol-examples-createfeature.html
@@ -1528,7 +1528,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 a974ed1..3d8ebe5 100644
--- a/1.1/protocol-examples-createfeatures.html
+++ b/1.1/protocol-examples-createfeatures.html
@@ -1532,7 +1532,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 6c56453..cd6742f 100644
--- a/1.1/protocol-examples-createproperties.html
+++ b/1.1/protocol-examples-createproperties.html
@@ -1523,7 +1523,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 2c2a627..dc54787 100644
--- a/1.1/protocol-examples-createproperty.html
+++ b/1.1/protocol-examples-createproperty.html
@@ -1513,7 +1513,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 8a292db..372af60 100644
--- a/1.1/protocol-examples-creatething.html
+++ b/1.1/protocol-examples-creatething.html
@@ -1612,7 +1612,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 9422b67..ce1023c 100644
--- a/1.1/protocol-examples-createthingdefinition.html
+++ b/1.1/protocol-examples-createthingdefinition.html
@@ -1514,7 +1514,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 492ad97..6d8e9e8 100644
--- a/1.1/protocol-examples-deleteattribute.html
+++ b/1.1/protocol-examples-deleteattribute.html
@@ -1511,7 +1511,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 9e046a4..69fd528 100644
--- a/1.1/protocol-examples-deleteattributes.html
+++ b/1.1/protocol-examples-deleteattributes.html
@@ -1511,7 +1511,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 aef7543..6a6f464 100644
--- a/1.1/protocol-examples-deletedefinition.html
+++ b/1.1/protocol-examples-deletedefinition.html
@@ -1511,7 +1511,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 1cd4064..9f375f9 100644
--- a/1.1/protocol-examples-deletefeature.html
+++ b/1.1/protocol-examples-deletefeature.html
@@ -1511,7 +1511,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 a45a147..a88ca43 100644
--- a/1.1/protocol-examples-deletefeatures.html
+++ b/1.1/protocol-examples-deletefeatures.html
@@ -1511,7 +1511,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 c17e6c4..b8230c6 100644
--- a/1.1/protocol-examples-deleteproperties.html
+++ b/1.1/protocol-examples-deleteproperties.html
@@ -1511,7 +1511,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 2cc636e..6dddcdb 100644
--- a/1.1/protocol-examples-deleteproperty.html
+++ b/1.1/protocol-examples-deleteproperty.html
@@ -1511,7 +1511,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 ee8be74..ad44b0a 100644
--- a/1.1/protocol-examples-deletething.html
+++ b/1.1/protocol-examples-deletething.html
@@ -1511,7 +1511,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 79a80d8..9ccf724 100644
--- a/1.1/protocol-examples-deletethingdefinition.html
+++ b/1.1/protocol-examples-deletethingdefinition.html
@@ -1511,7 +1511,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 7401d0c..28a8a9b 100644
--- a/1.1/protocol-examples-errorresponses.html
+++ b/1.1/protocol-examples-errorresponses.html
@@ -1946,7 +1946,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 51e2e76..5977330 100644
--- a/1.1/protocol-examples-modifyattribute.html
+++ b/1.1/protocol-examples-modifyattribute.html
@@ -1519,7 +1519,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 f5d6139..26d5d2f 100644
--- a/1.1/protocol-examples-modifyattributes.html
+++ b/1.1/protocol-examples-modifyattributes.html
@@ -1524,7 +1524,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 2b5303a..840951d 100644
--- a/1.1/protocol-examples-modifydefinition.html
+++ b/1.1/protocol-examples-modifydefinition.html
@@ -1517,7 +1517,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 14deeba..a9383cb 100644
--- a/1.1/protocol-examples-modifyfeature.html
+++ b/1.1/protocol-examples-modifyfeature.html
@@ -1528,7 +1528,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 386fd07..07568e6 100644
--- a/1.1/protocol-examples-modifyfeatures.html
+++ b/1.1/protocol-examples-modifyfeatures.html
@@ -1532,7 +1532,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 4dc0f53..ca744c2 100644
--- a/1.1/protocol-examples-modifypolicyid.html
+++ b/1.1/protocol-examples-modifypolicyid.html
@@ -1535,7 +1535,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 9a55590..8d4a590 100644
--- a/1.1/protocol-examples-modifyproperties.html
+++ b/1.1/protocol-examples-modifyproperties.html
@@ -1523,7 +1523,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 15e3eef..ecd7495 100644
--- a/1.1/protocol-examples-modifyproperty.html
+++ b/1.1/protocol-examples-modifyproperty.html
@@ -1513,7 +1513,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 43acc31..e31cea1 100644
--- a/1.1/protocol-examples-modifything.html
+++ b/1.1/protocol-examples-modifything.html
@@ -1593,7 +1593,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 9683e25..cc6499f 100644
--- a/1.1/protocol-examples-modifythingdefinition.html
+++ b/1.1/protocol-examples-modifythingdefinition.html
@@ -1513,7 +1513,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 fe92428..fc1bc31 100644
--- a/1.1/protocol-examples-policies-createpolicy.html
+++ b/1.1/protocol-examples-policies-createpolicy.html
@@ -1547,7 +1547,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 a5dea46..37dad84 100644
--- a/1.1/protocol-examples-policies-createpolicyentry.html
+++ b/1.1/protocol-examples-policies-createpolicyentry.html
@@ -1523,7 +1523,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 7d46106..6f573b9 100644
--- a/1.1/protocol-examples-policies-createresource.html
+++ b/1.1/protocol-examples-policies-createresource.html
@@ -1512,7 +1512,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 fd69fd8..82e5c94 100644
--- a/1.1/protocol-examples-policies-createsubject.html
+++ b/1.1/protocol-examples-policies-createsubject.html
@@ -1508,7 +1508,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 a9bc632..6658076 100644
--- a/1.1/protocol-examples-policies-deletepolicy.html
+++ b/1.1/protocol-examples-policies-deletepolicy.html
@@ -1505,7 +1505,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 886aaed..3b0466a 100644
--- a/1.1/protocol-examples-policies-deletepolicyentry.html
+++ b/1.1/protocol-examples-policies-deletepolicyentry.html
@@ -1505,7 +1505,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 c6dd66b..903de52 100644
--- a/1.1/protocol-examples-policies-deleteresource.html
+++ b/1.1/protocol-examples-policies-deleteresource.html
@@ -1505,7 +1505,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 f31c42b..2ee5dda 100644
--- a/1.1/protocol-examples-policies-deletesubject.html
+++ b/1.1/protocol-examples-policies-deletesubject.html
@@ -1505,7 +1505,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 2e2b7db..12d3b34 100644
--- a/1.1/protocol-examples-policies-errorresponses.html
+++ b/1.1/protocol-examples-policies-errorresponses.html
@@ -1843,7 +1843,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 250f112..5a3460d 100644
--- a/1.1/protocol-examples-policies-modifypolicy.html
+++ b/1.1/protocol-examples-policies-modifypolicy.html
@@ -1526,7 +1526,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 abdcff9..eeb9e9f 100644
--- a/1.1/protocol-examples-policies-modifypolicyentries.html
+++ b/1.1/protocol-examples-policies-modifypolicyentries.html
@@ -1545,7 +1545,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 9abb142..9a10156 100644
--- a/1.1/protocol-examples-policies-modifypolicyentry.html
+++ b/1.1/protocol-examples-policies-modifypolicyentry.html
@@ -1523,7 +1523,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 0107f85..f5e4728 100644
--- a/1.1/protocol-examples-policies-modifyresource.html
+++ b/1.1/protocol-examples-policies-modifyresource.html
@@ -1512,7 +1512,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 8f58014..83a3696 100644
--- a/1.1/protocol-examples-policies-modifyresources.html
+++ b/1.1/protocol-examples-policies-modifyresources.html
@@ -1515,7 +1515,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 10b01f1..283035c 100644
--- a/1.1/protocol-examples-policies-modifysubject.html
+++ b/1.1/protocol-examples-policies-modifysubject.html
@@ -1508,7 +1508,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 198185e..2b4a5ef 100644
--- a/1.1/protocol-examples-policies-modifysubjects.html
+++ b/1.1/protocol-examples-policies-modifysubjects.html
@@ -1511,7 +1511,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 6926b7c..f62c5d3 100644
--- a/1.1/protocol-examples-policies-retrievepolicy.html
+++ b/1.1/protocol-examples-policies-retrievepolicy.html
@@ -1526,7 +1526,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 26582aa..66d0368 100644
--- a/1.1/protocol-examples-policies-retrievepolicyentries.html
+++ b/1.1/protocol-examples-policies-retrievepolicyentries.html
@@ -1539,7 +1539,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 ca3ee8c..7af9c0a 100644
--- a/1.1/protocol-examples-policies-retrievepolicyentry.html
+++ b/1.1/protocol-examples-policies-retrievepolicyentry.html
@@ -1521,7 +1521,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 98de60e..245fcdb 100644
--- a/1.1/protocol-examples-policies-retrieveresource.html
+++ b/1.1/protocol-examples-policies-retrieveresource.html
@@ -1512,7 +1512,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 79cc2b8..acdb504 100644
--- a/1.1/protocol-examples-policies-retrieveresources.html
+++ b/1.1/protocol-examples-policies-retrieveresources.html
@@ -1514,7 +1514,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 8bc53bb..25d926c 100644
--- a/1.1/protocol-examples-policies-retrievesubject.html
+++ b/1.1/protocol-examples-policies-retrievesubject.html
@@ -1508,7 +1508,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 783c1b3..23aecbd 100644
--- a/1.1/protocol-examples-policies-retrievesubjects.html
+++ b/1.1/protocol-examples-policies-retrievesubjects.html
@@ -1510,7 +1510,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 79b538a..76d7c14 100644
--- a/1.1/protocol-examples-retrieveattribute.html
+++ b/1.1/protocol-examples-retrieveattribute.html
@@ -1505,7 +1505,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 8e5467b..82dc84f 100644
--- a/1.1/protocol-examples-retrieveattributes.html
+++ b/1.1/protocol-examples-retrieveattributes.html
@@ -1507,7 +1507,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 5ad13f1..c2eee76 100644
--- a/1.1/protocol-examples-retrievedefinition.html
+++ b/1.1/protocol-examples-retrievedefinition.html
@@ -1504,7 +1504,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 8aebcc2..7db97d4 100644
--- a/1.1/protocol-examples-retrievefeature.html
+++ b/1.1/protocol-examples-retrievefeature.html
@@ -1509,7 +1509,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 72f329f..620000f 100644
--- a/1.1/protocol-examples-retrievefeatures.html
+++ b/1.1/protocol-examples-retrievefeatures.html
@@ -1511,7 +1511,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 b8aecae..e3a9cd5 100644
--- a/1.1/protocol-examples-retrieveproperties.html
+++ b/1.1/protocol-examples-retrieveproperties.html
@@ -1507,7 +1507,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 af7bca4..53897a7 100644
--- a/1.1/protocol-examples-retrieveproperty.html
+++ b/1.1/protocol-examples-retrieveproperty.html
@@ -1502,7 +1502,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 2cbf36b..0e76033 100644
--- a/1.1/protocol-examples-retrievething.html
+++ b/1.1/protocol-examples-retrievething.html
@@ -1531,7 +1531,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 8a08e86..968a167 100644
--- a/1.1/protocol-examples-retrievethingdefinition.html
+++ b/1.1/protocol-examples-retrievethingdefinition.html
@@ -1502,7 +1502,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 943de8f..e53501e 100644
--- a/1.1/protocol-examples-retrievethings.html
+++ b/1.1/protocol-examples-retrievethings.html
@@ -1528,7 +1528,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 2c832b7..1a4e514 100644
--- a/1.1/protocol-examples-search.html
+++ b/1.1/protocol-examples-search.html
@@ -1606,7 +1606,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 261005a..de408d9 100644
--- a/1.1/protocol-examples.html
+++ b/1.1/protocol-examples.html
@@ -1588,7 +1588,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 f78ba1f..2f15fe0 100644
--- a/1.1/protocol-overview.html
+++ b/1.1/protocol-overview.html
@@ -1504,7 +1504,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 a4d7309..1826322 100644
--- a/1.1/protocol-specification-acks.html
+++ b/1.1/protocol-specification-acks.html
@@ -1528,7 +1528,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 00e9bab..16879e5 100644
--- a/1.1/protocol-specification-policies-create-or-modify.html
+++ b/1.1/protocol-specification-policies-create-or-modify.html
@@ -2106,7 +2106,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 f2cba6f..6bd8160 100644
--- a/1.1/protocol-specification-policies-delete.html
+++ b/1.1/protocol-specification-policies-delete.html
@@ -1776,7 +1776,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 918b5ea..c4ebb21 100644
--- a/1.1/protocol-specification-policies-retrieve.html
+++ b/1.1/protocol-specification-policies-retrieve.html
@@ -1999,7 +1999,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 110e749..ffad629 100644
--- a/1.1/protocol-specification-policies.html
+++ b/1.1/protocol-specification-policies.html
@@ -1586,7 +1586,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 4d73fa2..b606202 100644
--- a/1.1/protocol-specification-things-create-or-modify.html
+++ b/1.1/protocol-specification-things-create-or-modify.html
@@ -2906,7 +2906,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 eb2c416..cfa7ff2 100644
--- a/1.1/protocol-specification-things-delete.html
+++ b/1.1/protocol-specification-things-delete.html
@@ -2393,7 +2393,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 7f31372..b392bd0 100644
--- a/1.1/protocol-specification-things-messages.html
+++ b/1.1/protocol-specification-things-messages.html
@@ -1748,7 +1748,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 ab3a749..056d4a5 100644
--- a/1.1/protocol-specification-things-retrieve.html
+++ b/1.1/protocol-specification-things-retrieve.html
@@ -2195,7 +2195,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 b6fc113..a5d6d5f 100644
--- a/1.1/protocol-specification-things-search.html
+++ b/1.1/protocol-specification-things-search.html
@@ -1852,7 +1852,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 c19a573..00a1f33 100644
--- a/1.1/protocol-specification-things.html
+++ b/1.1/protocol-specification-things.html
@@ -1557,7 +1557,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 52cfe96..377b168 100644
--- a/1.1/protocol-specification-topic.html
+++ b/1.1/protocol-specification-topic.html
@@ -1662,7 +1662,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 d27ba7f..9037e6e 100644
--- a/1.1/protocol-specification.html
+++ b/1.1/protocol-specification.html
@@ -1644,7 +1644,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 aec6737..d527b02 100644
--- a/1.1/protocol-twinlive.html
+++ b/1.1/protocol-twinlive.html
@@ -1515,7 +1515,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 aa9ef11..ffb8ad4 100644
--- a/1.1/release_notes_010-M1.html
+++ b/1.1/release_notes_010-M1.html
@@ -1494,7 +1494,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 7f4aec1..5e9e25f 100644
--- a/1.1/release_notes_010-M3.html
+++ b/1.1/release_notes_010-M3.html
@@ -1550,7 +1550,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 25090f3..83811fd 100644
--- a/1.1/release_notes_020-M1.html
+++ b/1.1/release_notes_020-M1.html
@@ -1535,7 +1535,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 2a33723..b763dff 100644
--- a/1.1/release_notes_030-M1.html
+++ b/1.1/release_notes_030-M1.html
@@ -1546,7 +1546,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 6215111..87e3d47 100644
--- a/1.1/release_notes_030-M2.html
+++ b/1.1/release_notes_030-M2.html
@@ -1543,7 +1543,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 91d0941..3f58ada 100644
--- a/1.1/release_notes_080-M1.html
+++ b/1.1/release_notes_080-M1.html
@@ -1565,7 +1565,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 b0f9397..069a64c 100644
--- a/1.1/release_notes_080-M2.html
+++ b/1.1/release_notes_080-M2.html
@@ -1549,7 +1549,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 fdd602a..8dd1ef5 100644
--- a/1.1/release_notes_080-M3.html
+++ b/1.1/release_notes_080-M3.html
@@ -1553,7 +1553,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 2b34717..b683862 100644
--- a/1.1/release_notes_080.html
+++ b/1.1/release_notes_080.html
@@ -1559,7 +1559,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 47b276b..4197a7b 100644
--- a/1.1/release_notes_090-M1.html
+++ b/1.1/release_notes_090-M1.html
@@ -1531,7 +1531,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 e9d5605..78c364a 100644
--- a/1.1/release_notes_090-M2.html
+++ b/1.1/release_notes_090-M2.html
@@ -1532,7 +1532,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 6292262..5ed10e1 100644
--- a/1.1/release_notes_090.html
+++ b/1.1/release_notes_090.html
@@ -1589,7 +1589,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 52c2927..efcdae8 100644
--- a/1.1/release_notes_100-M1a.html
+++ b/1.1/release_notes_100-M1a.html
@@ -1550,7 +1550,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 1292d7b..50c67c7 100644
--- a/1.1/release_notes_100-M2.html
+++ b/1.1/release_notes_100-M2.html
@@ -1567,7 +1567,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 c3c3d7d..58a6ceb 100644
--- a/1.1/release_notes_100.html
+++ b/1.1/release_notes_100.html
@@ -1570,7 +1570,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 80eeb62..0c363b8 100644
--- a/1.1/release_notes_110.html
+++ b/1.1/release_notes_110.html
@@ -1611,7 +1611,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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
index 78bb5e3..b81f59a 100644
--- a/1.1/release_notes_111.html
+++ b/1.1/release_notes_111.html
@@ -1509,7 +1509,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/release_notes_112.html b/1.1/release_notes_112.html
index b6ffed1..70143f3 100644
--- a/1.1/release_notes_112.html
+++ b/1.1/release_notes_112.html
@@ -1525,7 +1525,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/release_notes_113.html b/1.1/release_notes_113.html
index 12806e0..fc1aa86 100644
--- a/1.1/release_notes_113.html
+++ b/1.1/release_notes_113.html
@@ -1525,7 +1525,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/release_notes_115.html b/1.1/release_notes_115.html
index 2f7db03..8ca736e 100644
--- a/1.1/release_notes_115.html
+++ b/1.1/release_notes_115.html
@@ -1513,7 +1513,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/sandbox.html b/1.1/sandbox.html
index a400c43..9079af3 100644
--- a/1.1/sandbox.html
+++ b/1.1/sandbox.html
@@ -1539,7 +1539,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.1/tag_architecture.html b/1.1/tag_architecture.html
index be3a9b6..5d68982 100644
--- a/1.1/tag_architecture.html
+++ b/1.1/tag_architecture.html
@@ -2261,7 +2261,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 e995931..aae7e25 100644
--- a/1.1/tag_blog.html
+++ b/1.1/tag_blog.html
@@ -2387,7 +2387,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 b3bac08..57aa20d 100644
--- a/1.1/tag_client_sdk.html
+++ b/1.1/tag_client_sdk.html
@@ -2247,7 +2247,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 d428d57..1a3759b 100644
--- a/1.1/tag_connectivity.html
+++ b/1.1/tag_connectivity.html
@@ -2333,7 +2333,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 9b1ebc5..1c4a3f0 100644
--- a/1.1/tag_getting_started.html
+++ b/1.1/tag_getting_started.html
@@ -2261,7 +2261,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 b659528..c231aa4 100644
--- a/1.1/tag_http.html
+++ b/1.1/tag_http.html
@@ -2255,7 +2255,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 cda77f1..7bb6865 100644
--- a/1.1/tag_installation.html
+++ b/1.1/tag_installation.html
@@ -2237,7 +2237,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 802f8d4..64685ac 100644
--- a/1.1/tag_model.html
+++ b/1.1/tag_model.html
@@ -2285,7 +2285,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 ad06626..94ed042 100644
--- a/1.1/tag_news.html
+++ b/1.1/tag_news.html
@@ -2219,7 +2219,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 2b1a61d..5bc9d33 100644
--- a/1.1/tag_protocol.html
+++ b/1.1/tag_protocol.html
@@ -2375,7 +2375,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 f4b061d..128777a 100644
--- a/1.1/tag_release_notes.html
+++ b/1.1/tag_release_notes.html
@@ -2339,7 +2339,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 e12a1f5..3b777c9 100644
--- a/1.1/tag_rql.html
+++ b/1.1/tag_rql.html
@@ -2285,7 +2285,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 164a83b..6b4c7af 100644
--- a/1.1/tag_search.html
+++ b/1.1/tag_search.html
@@ -2255,7 +2255,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 22f88ce..84145ae 100644
--- a/1.1/tag_signal.html
+++ b/1.1/tag_signal.html
@@ -2254,7 +2254,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <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 c81b99d..cae9897 100644
--- a/1.1/tag_troubleshooting.html
+++ b/1.1/tag_troubleshooting.html
@@ -2225,7 +2225,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2017-11-10-welcome-to-ditto.html b/1.2/2017-11-10-welcome-to-ditto.html
index af61245..a38399d 100644
--- a/1.2/2017-11-10-welcome-to-ditto.html
+++ b/1.2/2017-11-10-welcome-to-ditto.html
@@ -264,7 +264,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2017-12-18-milestone-announcement-010-M1.html b/1.2/2017-12-18-milestone-announcement-010-M1.html
index 995ef92..2497278 100644
--- a/1.2/2017-12-18-milestone-announcement-010-M1.html
+++ b/1.2/2017-12-18-milestone-announcement-010-M1.html
@@ -268,7 +268,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2018-01-12-milestone-announcement-010-M3.html b/1.2/2018-01-12-milestone-announcement-010-M3.html
index 443b45c..a5c012c 100644
--- a/1.2/2018-01-12-milestone-announcement-010-M3.html
+++ b/1.2/2018-01-12-milestone-announcement-010-M3.html
@@ -287,7 +287,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2018-01-15-example-demonstrating-rest-to-websocket.html b/1.2/2018-01-15-example-demonstrating-rest-to-websocket.html
index 288bb6d..1c59809 100644
--- a/1.2/2018-01-15-example-demonstrating-rest-to-websocket.html
+++ b/1.2/2018-01-15-example-demonstrating-rest-to-websocket.html
@@ -276,7 +276,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2018-02-07-milestone-announcement-020-M1.html b/1.2/2018-02-07-milestone-announcement-020-M1.html
index 386c53e..c4e3505 100644
--- a/1.2/2018-02-07-milestone-announcement-020-M1.html
+++ b/1.2/2018-02-07-milestone-announcement-020-M1.html
@@ -288,7 +288,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2018-02-08-feature-definition.html b/1.2/2018-02-08-feature-definition.html
index 4d2a7a0..1ec5e6b 100644
--- a/1.2/2018-02-08-feature-definition.html
+++ b/1.2/2018-02-08-feature-definition.html
@@ -318,7 +318,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2018-04-25-connectivity-service.html b/1.2/2018-04-25-connectivity-service.html
index ee6325f..a4c770b 100644
--- a/1.2/2018-04-25-connectivity-service.html
+++ b/1.2/2018-04-25-connectivity-service.html
@@ -332,7 +332,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2018-04-26-milestone-announcement-030-M1.html b/1.2/2018-04-26-milestone-announcement-030-M1.html
index f32d1a7..edaa08b 100644
--- a/1.2/2018-04-26-milestone-announcement-030-M1.html
+++ b/1.2/2018-04-26-milestone-announcement-030-M1.html
@@ -284,7 +284,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2018-05-02-connecting-ditto-hono.html b/1.2/2018-05-02-connecting-ditto-hono.html
index 4087f26..75da7a3 100644
--- a/1.2/2018-05-02-connecting-ditto-hono.html
+++ b/1.2/2018-05-02-connecting-ditto-hono.html
@@ -1006,7 +1006,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2018-06-15-milestone-announcement-030-M2.html b/1.2/2018-06-15-milestone-announcement-030-M2.html
index 8de57e6..be0475d 100644
--- a/1.2/2018-06-15-milestone-announcement-030-M2.html
+++ b/1.2/2018-06-15-milestone-announcement-030-M2.html
@@ -284,7 +284,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2018-08-14-milestone-announcement-080-M1.html b/1.2/2018-08-14-milestone-announcement-080-M1.html
index e734fed..c2aaab0 100644
--- a/1.2/2018-08-14-milestone-announcement-080-M1.html
+++ b/1.2/2018-08-14-milestone-announcement-080-M1.html
@@ -284,7 +284,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2018-09-21-selective-push-notifications.html b/1.2/2018-09-21-selective-push-notifications.html
index 154a661..c551aea 100644
--- a/1.2/2018-09-21-selective-push-notifications.html
+++ b/1.2/2018-09-21-selective-push-notifications.html
@@ -484,7 +484,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2018-09-27-milestone-announcement-080-M2.html b/1.2/2018-09-27-milestone-announcement-080-M2.html
index 991f731..778a524 100644
--- a/1.2/2018-09-27-milestone-announcement-080-M2.html
+++ b/1.2/2018-09-27-milestone-announcement-080-M2.html
@@ -286,7 +286,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2018-10-16-example-mqtt-bidirectional.html b/1.2/2018-10-16-example-mqtt-bidirectional.html
index 41c0e0b..25eb822 100644
--- a/1.2/2018-10-16-example-mqtt-bidirectional.html
+++ b/1.2/2018-10-16-example-mqtt-bidirectional.html
@@ -292,7 +292,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2018-11-14-milestone-announcement-080-M3.html b/1.2/2018-11-14-milestone-announcement-080-M3.html
index 11db738..72ca105 100644
--- a/1.2/2018-11-14-milestone-announcement-080-M3.html
+++ b/1.2/2018-11-14-milestone-announcement-080-M3.html
@@ -285,7 +285,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2018-11-28-release-announcement-080.html b/1.2/2018-11-28-release-announcement-080.html
index 56fc132..f02de58 100644
--- a/1.2/2018-11-28-release-announcement-080.html
+++ b/1.2/2018-11-28-release-announcement-080.html
@@ -280,7 +280,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2018-12-05-example-command-and-control.html b/1.2/2018-12-05-example-command-and-control.html
index 93f7564..b070207 100644
--- a/1.2/2018-12-05-example-command-and-control.html
+++ b/1.2/2018-12-05-example-command-and-control.html
@@ -519,7 +519,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2019-03-13-kafka-connectivity.html b/1.2/2019-03-13-kafka-connectivity.html
index 5124a67..78f385b 100644
--- a/1.2/2019-03-13-kafka-connectivity.html
+++ b/1.2/2019-03-13-kafka-connectivity.html
@@ -266,7 +266,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2019-03-28-milestone-announcement-090-M1.html b/1.2/2019-03-28-milestone-announcement-090-M1.html
index 34122f3..e6ca182 100644
--- a/1.2/2019-03-28-milestone-announcement-090-M1.html
+++ b/1.2/2019-03-28-milestone-announcement-090-M1.html
@@ -282,7 +282,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2019-04-29-milestone-announcement-090-M2.html b/1.2/2019-04-29-milestone-announcement-090-M2.html
index 9868b05..cb7f802 100644
--- a/1.2/2019-04-29-milestone-announcement-090-M2.html
+++ b/1.2/2019-04-29-milestone-announcement-090-M2.html
@@ -280,7 +280,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2019-07-10-release-announcement-090.html b/1.2/2019-07-10-release-announcement-090.html
index 5d00af2..2d22fd9 100644
--- a/1.2/2019-07-10-release-announcement-090.html
+++ b/1.2/2019-07-10-release-announcement-090.html
@@ -286,7 +286,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2019-08-28-openid-connect.html b/1.2/2019-08-28-openid-connect.html
index 8debef6..c912e6d 100644
--- a/1.2/2019-08-28-openid-connect.html
+++ b/1.2/2019-08-28-openid-connect.html
@@ -332,7 +332,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2019-09-17-milestone-announcement-100-M1a.html b/1.2/2019-09-17-milestone-announcement-100-M1a.html
index 8a0fd63..a9f6c76 100644
--- a/1.2/2019-09-17-milestone-announcement-100-M1a.html
+++ b/1.2/2019-09-17-milestone-announcement-100-M1a.html
@@ -283,7 +283,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2019-10-17-http-connectivity.html b/1.2/2019-10-17-http-connectivity.html
index 4a252cf..22db3d3 100644
--- a/1.2/2019-10-17-http-connectivity.html
+++ b/1.2/2019-10-17-http-connectivity.html
@@ -291,7 +291,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2019-11-04-milestone-announcement-100-M2.html b/1.2/2019-11-04-milestone-announcement-100-M2.html
index 1e041a6..229eacf 100644
--- a/1.2/2019-11-04-milestone-announcement-100-M2.html
+++ b/1.2/2019-11-04-milestone-announcement-100-M2.html
@@ -282,7 +282,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2019-12-12-release-announcement-100.html b/1.2/2019-12-12-release-announcement-100.html
index 4926b82..c591729 100644
--- a/1.2/2019-12-12-release-announcement-100.html
+++ b/1.2/2019-12-12-release-announcement-100.html
@@ -331,7 +331,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2020-04-16-connecting-to-ttn-via-mqtt.html b/1.2/2020-04-16-connecting-to-ttn-via-mqtt.html
index 5e3d6a9..0d64784 100644
--- a/1.2/2020-04-16-connecting-to-ttn-via-mqtt.html
+++ b/1.2/2020-04-16-connecting-to-ttn-via-mqtt.html
@@ -778,7 +778,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2020-04-29-release-announcement-110.html b/1.2/2020-04-29-release-announcement-110.html
index 90a7768..02d87b3 100644
--- a/1.2/2020-04-29-release-announcement-110.html
+++ b/1.2/2020-04-29-release-announcement-110.html
@@ -312,7 +312,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/2020-08-31-release-announcement-120.html b/1.2/2020-08-31-release-announcement-120.html
index cad8590..c70e4e4 100644
--- a/1.2/2020-08-31-release-announcement-120.html
+++ b/1.2/2020-08-31-release-announcement-120.html
@@ -290,7 +290,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/404.html b/1.2/404.html
index 29f5c63..70c3ea8 100644
--- a/1.2/404.html
+++ b/1.2/404.html
@@ -1516,7 +1516,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/architecture-overview.html b/1.2/architecture-overview.html
index db42b19..385e983 100644
--- a/1.2/architecture-overview.html
+++ b/1.2/architecture-overview.html
@@ -1569,7 +1569,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/architecture-services-concierge.html b/1.2/architecture-services-concierge.html
index 39d32c4..2a60df2 100644
--- a/1.2/architecture-services-concierge.html
+++ b/1.2/architecture-services-concierge.html
@@ -1555,7 +1555,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/architecture-services-connectivity.html b/1.2/architecture-services-connectivity.html
index a26e8c9..343c59e 100644
--- a/1.2/architecture-services-connectivity.html
+++ b/1.2/architecture-services-connectivity.html
@@ -1569,7 +1569,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/architecture-services-gateway.html b/1.2/architecture-services-gateway.html
index 3119588..8a22f90 100644
--- a/1.2/architecture-services-gateway.html
+++ b/1.2/architecture-services-gateway.html
@@ -1547,7 +1547,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/architecture-services-policies.html b/1.2/architecture-services-policies.html
index 00d0372..57cabfb 100644
--- a/1.2/architecture-services-policies.html
+++ b/1.2/architecture-services-policies.html
@@ -1548,7 +1548,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/architecture-services-things-search.html b/1.2/architecture-services-things-search.html
index 32939f7..bb01384 100644
--- a/1.2/architecture-services-things-search.html
+++ b/1.2/architecture-services-things-search.html
@@ -1592,7 +1592,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/architecture-services-things.html b/1.2/architecture-services-things.html
index 6e8b0f6..54fd0b8 100644
--- a/1.2/architecture-services-things.html
+++ b/1.2/architecture-services-things.html
@@ -1548,7 +1548,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/basic-acknowledgements.html b/1.2/basic-acknowledgements.html
index 725fce1..7447474 100644
--- a/1.2/basic-acknowledgements.html
+++ b/1.2/basic-acknowledgements.html
@@ -2105,7 +2105,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/basic-acl.html b/1.2/basic-acl.html
index 0b88ae1..23bf256 100644
--- a/1.2/basic-acl.html
+++ b/1.2/basic-acl.html
@@ -1586,7 +1586,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/basic-apis.html b/1.2/basic-apis.html
index 1b90078..46239e3 100644
--- a/1.2/basic-apis.html
+++ b/1.2/basic-apis.html
@@ -1644,7 +1644,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/basic-auth.html b/1.2/basic-auth.html
index 1d14cc7..3216bb0 100644
--- a/1.2/basic-auth.html
+++ b/1.2/basic-auth.html
@@ -1565,7 +1565,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/basic-changenotifications.html b/1.2/basic-changenotifications.html
index ddd8031..82abbd6 100644
--- a/1.2/basic-changenotifications.html
+++ b/1.2/basic-changenotifications.html
@@ -1588,7 +1588,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/basic-connections.html b/1.2/basic-connections.html
index f5dbd5d..7d6257a 100644
--- a/1.2/basic-connections.html
+++ b/1.2/basic-connections.html
@@ -2083,7 +2083,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/basic-enrichment.html b/1.2/basic-enrichment.html
index 83d7ba4..b7a278c 100644
--- a/1.2/basic-enrichment.html
+++ b/1.2/basic-enrichment.html
@@ -1621,7 +1621,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/basic-errors.html b/1.2/basic-errors.html
index 959ebf6..76363da 100644
--- a/1.2/basic-errors.html
+++ b/1.2/basic-errors.html
@@ -1565,7 +1565,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/basic-feature.html b/1.2/basic-feature.html
index ce3856c..1d625b6 100644
--- a/1.2/basic-feature.html
+++ b/1.2/basic-feature.html
@@ -1749,7 +1749,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/basic-messages.html b/1.2/basic-messages.html
index 92dba77..506cf4a 100644
--- a/1.2/basic-messages.html
+++ b/1.2/basic-messages.html
@@ -1658,7 +1658,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/basic-metadata.html b/1.2/basic-metadata.html
index ed31579..b4e5806 100644
--- a/1.2/basic-metadata.html
+++ b/1.2/basic-metadata.html
@@ -1699,7 +1699,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/basic-namespaces-and-names.html b/1.2/basic-namespaces-and-names.html
index 8c26059..e42a40a 100644
--- a/1.2/basic-namespaces-and-names.html
+++ b/1.2/basic-namespaces-and-names.html
@@ -1592,7 +1592,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/basic-overview.html b/1.2/basic-overview.html
index b87ab68..f7f82b6 100644
--- a/1.2/basic-overview.html
+++ b/1.2/basic-overview.html
@@ -1661,7 +1661,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/basic-placeholders.html b/1.2/basic-placeholders.html
index 0cb89b7..13bbd2b 100644
--- a/1.2/basic-placeholders.html
+++ b/1.2/basic-placeholders.html
@@ -1799,7 +1799,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/basic-policy.html b/1.2/basic-policy.html
index 4efd071..e49f336 100644
--- a/1.2/basic-policy.html
+++ b/1.2/basic-policy.html
@@ -1927,7 +1927,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/basic-rql.html b/1.2/basic-rql.html
index 1fe9558..d1bc078 100644
--- a/1.2/basic-rql.html
+++ b/1.2/basic-rql.html
@@ -1767,7 +1767,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/basic-search.html b/1.2/basic-search.html
index 4720d05..cd0c95a 100644
--- a/1.2/basic-search.html
+++ b/1.2/basic-search.html
@@ -1660,7 +1660,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/basic-signals-command.html b/1.2/basic-signals-command.html
index cea9d0c..4a991a2 100644
--- a/1.2/basic-signals-command.html
+++ b/1.2/basic-signals-command.html
@@ -1546,7 +1546,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/basic-signals-commandresponse.html b/1.2/basic-signals-commandresponse.html
index 38d9e1a..7eb75e0 100644
--- a/1.2/basic-signals-commandresponse.html
+++ b/1.2/basic-signals-commandresponse.html
@@ -1526,7 +1526,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/basic-signals-errorresponse.html b/1.2/basic-signals-errorresponse.html
index 1ccac5d..fe9c5fe 100644
--- a/1.2/basic-signals-errorresponse.html
+++ b/1.2/basic-signals-errorresponse.html
@@ -1530,7 +1530,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/basic-signals-event.html b/1.2/basic-signals-event.html
index d27ceca..aa2aa8f 100644
--- a/1.2/basic-signals-event.html
+++ b/1.2/basic-signals-event.html
@@ -1532,7 +1532,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/basic-signals.html b/1.2/basic-signals.html
index d4d819c..aa2e1ad 100644
--- a/1.2/basic-signals.html
+++ b/1.2/basic-signals.html
@@ -1576,7 +1576,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/basic-thing.html b/1.2/basic-thing.html
index 123d992..d3eed03 100644
--- a/1.2/basic-thing.html
+++ b/1.2/basic-thing.html
@@ -1617,7 +1617,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/blog.html b/1.2/blog.html
index 25212ea..8b1a802 100644
--- a/1.2/blog.html
+++ b/1.2/blog.html
@@ -393,7 +393,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/blog_archive.html b/1.2/blog_archive.html
index 7c384da..a0b9b7e 100644
--- a/1.2/blog_archive.html
+++ b/1.2/blog_archive.html
@@ -453,7 +453,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/client-sdk-java.html b/1.2/client-sdk-java.html
index 4c09788..5dd9d64 100644
--- a/1.2/client-sdk-java.html
+++ b/1.2/client-sdk-java.html
@@ -1773,7 +1773,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/client-sdk-javascript.html b/1.2/client-sdk-javascript.html
index 2eee1bf..aee5c6e 100644
--- a/1.2/client-sdk-javascript.html
+++ b/1.2/client-sdk-javascript.html
@@ -1582,7 +1582,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/client-sdk-overview.html b/1.2/client-sdk-overview.html
index d9f1237..660b253 100644
--- a/1.2/client-sdk-overview.html
+++ b/1.2/client-sdk-overview.html
@@ -1529,7 +1529,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/connectivity-header-mapping.html b/1.2/connectivity-header-mapping.html
index 28ade05..feaace4 100644
--- a/1.2/connectivity-header-mapping.html
+++ b/1.2/connectivity-header-mapping.html
@@ -1539,7 +1539,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/connectivity-manage-connections.html b/1.2/connectivity-manage-connections.html
index 1ff3664..1c68e09 100644
--- a/1.2/connectivity-manage-connections.html
+++ b/1.2/connectivity-manage-connections.html
@@ -1844,7 +1844,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/connectivity-mapping.html b/1.2/connectivity-mapping.html
index 6be8580..81f1717 100644
--- a/1.2/connectivity-mapping.html
+++ b/1.2/connectivity-mapping.html
@@ -2309,7 +2309,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/connectivity-overview.html b/1.2/connectivity-overview.html
index 39461ef..237fe5e 100644
--- a/1.2/connectivity-overview.html
+++ b/1.2/connectivity-overview.html
@@ -1541,7 +1541,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/connectivity-protocol-bindings-amqp091.html b/1.2/connectivity-protocol-bindings-amqp091.html
index 53c9694..bcf7b5e 100644
--- a/1.2/connectivity-protocol-bindings-amqp091.html
+++ b/1.2/connectivity-protocol-bindings-amqp091.html
@@ -1687,7 +1687,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/connectivity-protocol-bindings-amqp10.html b/1.2/connectivity-protocol-bindings-amqp10.html
index 1c820ed..0eb9242 100644
--- a/1.2/connectivity-protocol-bindings-amqp10.html
+++ b/1.2/connectivity-protocol-bindings-amqp10.html
@@ -1733,7 +1733,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/connectivity-protocol-bindings-http.html b/1.2/connectivity-protocol-bindings-http.html
index 68971d6..a58d4d4 100644
--- a/1.2/connectivity-protocol-bindings-http.html
+++ b/1.2/connectivity-protocol-bindings-http.html
@@ -1686,7 +1686,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/connectivity-protocol-bindings-kafka2.html b/1.2/connectivity-protocol-bindings-kafka2.html
index eabb925..ca531d7 100644
--- a/1.2/connectivity-protocol-bindings-kafka2.html
+++ b/1.2/connectivity-protocol-bindings-kafka2.html
@@ -1665,7 +1665,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/connectivity-protocol-bindings-mqtt.html b/1.2/connectivity-protocol-bindings-mqtt.html
index 0203612..1145fcd 100644
--- a/1.2/connectivity-protocol-bindings-mqtt.html
+++ b/1.2/connectivity-protocol-bindings-mqtt.html
@@ -1858,7 +1858,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/connectivity-protocol-bindings-mqtt5.html b/1.2/connectivity-protocol-bindings-mqtt5.html
index 0806403..1370623 100644
--- a/1.2/connectivity-protocol-bindings-mqtt5.html
+++ b/1.2/connectivity-protocol-bindings-mqtt5.html
@@ -1866,7 +1866,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/connectivity-tls-certificates.html b/1.2/connectivity-tls-certificates.html
index c818f8b..3f57ecd 100644
--- a/1.2/connectivity-tls-certificates.html
+++ b/1.2/connectivity-tls-certificates.html
@@ -1637,7 +1637,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/feedback.html b/1.2/feedback.html
index d2d9814..5c20776 100644
--- a/1.2/feedback.html
+++ b/1.2/feedback.html
@@ -1541,7 +1541,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/glossary.html b/1.2/glossary.html
index 20c6a35..1b665d3 100644
--- a/1.2/glossary.html
+++ b/1.2/glossary.html
@@ -1529,7 +1529,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/http-api-doc.html b/1.2/http-api-doc.html
index 84bcfff..454ef27 100644
--- a/1.2/http-api-doc.html
+++ b/1.2/http-api-doc.html
@@ -201,7 +201,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/httpapi-concepts.html b/1.2/httpapi-concepts.html
index d2e138b..3de3b89 100644
--- a/1.2/httpapi-concepts.html
+++ b/1.2/httpapi-concepts.html
@@ -2115,7 +2115,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/httpapi-messages.html b/1.2/httpapi-messages.html
index 504a7f1..cae0425 100644
--- a/1.2/httpapi-messages.html
+++ b/1.2/httpapi-messages.html
@@ -1617,7 +1617,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/httpapi-overview.html b/1.2/httpapi-overview.html
index ea0ebb8..4facde4 100644
--- a/1.2/httpapi-overview.html
+++ b/1.2/httpapi-overview.html
@@ -1537,7 +1537,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/httpapi-protocol-bindings-websocket.html b/1.2/httpapi-protocol-bindings-websocket.html
index 95225e4..9db8468 100644
--- a/1.2/httpapi-protocol-bindings-websocket.html
+++ b/1.2/httpapi-protocol-bindings-websocket.html
@@ -1817,7 +1817,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/httpapi-search.html b/1.2/httpapi-search.html
index 9a8c501..5413484 100644
--- a/1.2/httpapi-search.html
+++ b/1.2/httpapi-search.html
@@ -1584,7 +1584,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/httpapi-sse.html b/1.2/httpapi-sse.html
index f8a25e0..6177505 100644
--- a/1.2/httpapi-sse.html
+++ b/1.2/httpapi-sse.html
@@ -1769,7 +1769,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/index.html b/1.2/index.html
index 89d333b..9ac6f17 100644
--- a/1.2/index.html
+++ b/1.2/index.html
@@ -264,7 +264,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/installation-building.html b/1.2/installation-building.html
index 541b590..360600f 100644
--- a/1.2/installation-building.html
+++ b/1.2/installation-building.html
@@ -1556,7 +1556,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/installation-operating.html b/1.2/installation-operating.html
index e8fbefd..a6a390c 100644
--- a/1.2/installation-operating.html
+++ b/1.2/installation-operating.html
@@ -2412,7 +2412,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/installation-running.html b/1.2/installation-running.html
index 58b4731..11f9859 100644
--- a/1.2/installation-running.html
+++ b/1.2/installation-running.html
@@ -1584,7 +1584,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/intro-digitaltwins.html b/1.2/intro-digitaltwins.html
index 8c0cd2b..54ba520 100644
--- a/1.2/intro-digitaltwins.html
+++ b/1.2/intro-digitaltwins.html
@@ -1559,7 +1559,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/intro-hello-world.html b/1.2/intro-hello-world.html
index a26e6de..ae5291c 100644
--- a/1.2/intro-hello-world.html
+++ b/1.2/intro-hello-world.html
@@ -1648,7 +1648,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/intro-overview.html b/1.2/intro-overview.html
index cfc6c12..8e01a27 100644
--- a/1.2/intro-overview.html
+++ b/1.2/intro-overview.html
@@ -1575,7 +1575,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/presentations.html b/1.2/presentations.html
index 91bd1fc..27f746b 100644
--- a/1.2/presentations.html
+++ b/1.2/presentations.html
@@ -1563,7 +1563,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-bindings.html b/1.2/protocol-bindings.html
index 4435920..9e62e2f 100644
--- a/1.2/protocol-bindings.html
+++ b/1.2/protocol-bindings.html
@@ -1549,7 +1549,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-createattribute.html b/1.2/protocol-examples-createattribute.html
index de10b91..33d5cc6 100644
--- a/1.2/protocol-examples-createattribute.html
+++ b/1.2/protocol-examples-createattribute.html
@@ -1551,7 +1551,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-createattributes.html b/1.2/protocol-examples-createattributes.html
index 9e72832..f41a601 100644
--- a/1.2/protocol-examples-createattributes.html
+++ b/1.2/protocol-examples-createattributes.html
@@ -1556,7 +1556,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-createdefinition.html b/1.2/protocol-examples-createdefinition.html
index b9c3c89..27d9841 100644
--- a/1.2/protocol-examples-createdefinition.html
+++ b/1.2/protocol-examples-createdefinition.html
@@ -1549,7 +1549,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-createfeature.html b/1.2/protocol-examples-createfeature.html
index a151215..bc1e26e 100644
--- a/1.2/protocol-examples-createfeature.html
+++ b/1.2/protocol-examples-createfeature.html
@@ -1560,7 +1560,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-createfeatures.html b/1.2/protocol-examples-createfeatures.html
index 6133e76..44adb91 100644
--- a/1.2/protocol-examples-createfeatures.html
+++ b/1.2/protocol-examples-createfeatures.html
@@ -1564,7 +1564,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-createproperties.html b/1.2/protocol-examples-createproperties.html
index 43dc181..8e75a58 100644
--- a/1.2/protocol-examples-createproperties.html
+++ b/1.2/protocol-examples-createproperties.html
@@ -1555,7 +1555,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-createproperty.html b/1.2/protocol-examples-createproperty.html
index 95c199e..fbbd27c 100644
--- a/1.2/protocol-examples-createproperty.html
+++ b/1.2/protocol-examples-createproperty.html
@@ -1545,7 +1545,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-creatething.html b/1.2/protocol-examples-creatething.html
index 5b54f49..385a529 100644
--- a/1.2/protocol-examples-creatething.html
+++ b/1.2/protocol-examples-creatething.html
@@ -1644,7 +1644,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-createthingdefinition.html b/1.2/protocol-examples-createthingdefinition.html
index a7af648..3968b97 100644
--- a/1.2/protocol-examples-createthingdefinition.html
+++ b/1.2/protocol-examples-createthingdefinition.html
@@ -1546,7 +1546,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-deleteattribute.html b/1.2/protocol-examples-deleteattribute.html
index 871be39..076ae1a 100644
--- a/1.2/protocol-examples-deleteattribute.html
+++ b/1.2/protocol-examples-deleteattribute.html
@@ -1543,7 +1543,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-deleteattributes.html b/1.2/protocol-examples-deleteattributes.html
index a64b264..b010212 100644
--- a/1.2/protocol-examples-deleteattributes.html
+++ b/1.2/protocol-examples-deleteattributes.html
@@ -1543,7 +1543,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-deletedefinition.html b/1.2/protocol-examples-deletedefinition.html
index f9b7380..1a7a70c 100644
--- a/1.2/protocol-examples-deletedefinition.html
+++ b/1.2/protocol-examples-deletedefinition.html
@@ -1543,7 +1543,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-deletefeature.html b/1.2/protocol-examples-deletefeature.html
index 04307d5..3d812c1 100644
--- a/1.2/protocol-examples-deletefeature.html
+++ b/1.2/protocol-examples-deletefeature.html
@@ -1543,7 +1543,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-deletefeatures.html b/1.2/protocol-examples-deletefeatures.html
index efad03c..1d74342 100644
--- a/1.2/protocol-examples-deletefeatures.html
+++ b/1.2/protocol-examples-deletefeatures.html
@@ -1543,7 +1543,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-deleteproperties.html b/1.2/protocol-examples-deleteproperties.html
index 8886f3d..e3a92b5 100644
--- a/1.2/protocol-examples-deleteproperties.html
+++ b/1.2/protocol-examples-deleteproperties.html
@@ -1543,7 +1543,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-deleteproperty.html b/1.2/protocol-examples-deleteproperty.html
index ff80531..1fd5587 100644
--- a/1.2/protocol-examples-deleteproperty.html
+++ b/1.2/protocol-examples-deleteproperty.html
@@ -1543,7 +1543,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-deletething.html b/1.2/protocol-examples-deletething.html
index fe5d778..232ffb7 100644
--- a/1.2/protocol-examples-deletething.html
+++ b/1.2/protocol-examples-deletething.html
@@ -1543,7 +1543,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-deletethingdefinition.html b/1.2/protocol-examples-deletethingdefinition.html
index 58cccdf..36924f8 100644
--- a/1.2/protocol-examples-deletethingdefinition.html
+++ b/1.2/protocol-examples-deletethingdefinition.html
@@ -1543,7 +1543,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-errorresponses.html b/1.2/protocol-examples-errorresponses.html
index 35c160d..e03d05e 100644
--- a/1.2/protocol-examples-errorresponses.html
+++ b/1.2/protocol-examples-errorresponses.html
@@ -1978,7 +1978,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-modifyattribute.html b/1.2/protocol-examples-modifyattribute.html
index 95546ba..5485881 100644
--- a/1.2/protocol-examples-modifyattribute.html
+++ b/1.2/protocol-examples-modifyattribute.html
@@ -1551,7 +1551,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-modifyattributes.html b/1.2/protocol-examples-modifyattributes.html
index 5ad9c70..5a18a53 100644
--- a/1.2/protocol-examples-modifyattributes.html
+++ b/1.2/protocol-examples-modifyattributes.html
@@ -1556,7 +1556,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-modifydefinition.html b/1.2/protocol-examples-modifydefinition.html
index fe6f316..60c55bf 100644
--- a/1.2/protocol-examples-modifydefinition.html
+++ b/1.2/protocol-examples-modifydefinition.html
@@ -1549,7 +1549,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-modifyfeature.html b/1.2/protocol-examples-modifyfeature.html
index 818cbb6..8b02b52 100644
--- a/1.2/protocol-examples-modifyfeature.html
+++ b/1.2/protocol-examples-modifyfeature.html
@@ -1560,7 +1560,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-modifyfeatures.html b/1.2/protocol-examples-modifyfeatures.html
index 711fa0d..82cff37 100644
--- a/1.2/protocol-examples-modifyfeatures.html
+++ b/1.2/protocol-examples-modifyfeatures.html
@@ -1564,7 +1564,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-modifypolicyid.html b/1.2/protocol-examples-modifypolicyid.html
index d9a630e..663a278 100644
--- a/1.2/protocol-examples-modifypolicyid.html
+++ b/1.2/protocol-examples-modifypolicyid.html
@@ -1567,7 +1567,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-modifyproperties.html b/1.2/protocol-examples-modifyproperties.html
index 80a408f..2b55f91 100644
--- a/1.2/protocol-examples-modifyproperties.html
+++ b/1.2/protocol-examples-modifyproperties.html
@@ -1555,7 +1555,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-modifyproperty.html b/1.2/protocol-examples-modifyproperty.html
index cfaa0fc..53ea982 100644
--- a/1.2/protocol-examples-modifyproperty.html
+++ b/1.2/protocol-examples-modifyproperty.html
@@ -1545,7 +1545,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-modifything.html b/1.2/protocol-examples-modifything.html
index 47a94ab..0d72c0a 100644
--- a/1.2/protocol-examples-modifything.html
+++ b/1.2/protocol-examples-modifything.html
@@ -1625,7 +1625,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-modifythingdefinition.html b/1.2/protocol-examples-modifythingdefinition.html
index 67dc363..193a7d6 100644
--- a/1.2/protocol-examples-modifythingdefinition.html
+++ b/1.2/protocol-examples-modifythingdefinition.html
@@ -1545,7 +1545,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-policies-createpolicy.html b/1.2/protocol-examples-policies-createpolicy.html
index 1b950f3..197383e 100644
--- a/1.2/protocol-examples-policies-createpolicy.html
+++ b/1.2/protocol-examples-policies-createpolicy.html
@@ -1579,7 +1579,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-policies-createpolicyentry.html b/1.2/protocol-examples-policies-createpolicyentry.html
index 67126be..7c15895 100644
--- a/1.2/protocol-examples-policies-createpolicyentry.html
+++ b/1.2/protocol-examples-policies-createpolicyentry.html
@@ -1555,7 +1555,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-policies-createresource.html b/1.2/protocol-examples-policies-createresource.html
index 258ac4f..e4ff7e9 100644
--- a/1.2/protocol-examples-policies-createresource.html
+++ b/1.2/protocol-examples-policies-createresource.html
@@ -1544,7 +1544,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-policies-createsubject.html b/1.2/protocol-examples-policies-createsubject.html
index 6f0fec4..ee51b29 100644
--- a/1.2/protocol-examples-policies-createsubject.html
+++ b/1.2/protocol-examples-policies-createsubject.html
@@ -1540,7 +1540,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-policies-deletepolicy.html b/1.2/protocol-examples-policies-deletepolicy.html
index 15cceea..35ed8f1 100644
--- a/1.2/protocol-examples-policies-deletepolicy.html
+++ b/1.2/protocol-examples-policies-deletepolicy.html
@@ -1537,7 +1537,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-policies-deletepolicyentry.html b/1.2/protocol-examples-policies-deletepolicyentry.html
index ef9fdae..4a6ca6a 100644
--- a/1.2/protocol-examples-policies-deletepolicyentry.html
+++ b/1.2/protocol-examples-policies-deletepolicyentry.html
@@ -1537,7 +1537,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-policies-deleteresource.html b/1.2/protocol-examples-policies-deleteresource.html
index 9369162..7df6781 100644
--- a/1.2/protocol-examples-policies-deleteresource.html
+++ b/1.2/protocol-examples-policies-deleteresource.html
@@ -1537,7 +1537,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-policies-deletesubject.html b/1.2/protocol-examples-policies-deletesubject.html
index 8da39e9..0277b8c 100644
--- a/1.2/protocol-examples-policies-deletesubject.html
+++ b/1.2/protocol-examples-policies-deletesubject.html
@@ -1537,7 +1537,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-policies-errorresponses.html b/1.2/protocol-examples-policies-errorresponses.html
index 32a8624..cc04bf3 100644
--- a/1.2/protocol-examples-policies-errorresponses.html
+++ b/1.2/protocol-examples-policies-errorresponses.html
@@ -1875,7 +1875,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-policies-modifypolicy.html b/1.2/protocol-examples-policies-modifypolicy.html
index 24d70c0..c8fb69e 100644
--- a/1.2/protocol-examples-policies-modifypolicy.html
+++ b/1.2/protocol-examples-policies-modifypolicy.html
@@ -1558,7 +1558,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-policies-modifypolicyentries.html b/1.2/protocol-examples-policies-modifypolicyentries.html
index f8fdf6e..b0f9115 100644
--- a/1.2/protocol-examples-policies-modifypolicyentries.html
+++ b/1.2/protocol-examples-policies-modifypolicyentries.html
@@ -1577,7 +1577,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-policies-modifypolicyentry.html b/1.2/protocol-examples-policies-modifypolicyentry.html
index 188f5ee..19bfb69 100644
--- a/1.2/protocol-examples-policies-modifypolicyentry.html
+++ b/1.2/protocol-examples-policies-modifypolicyentry.html
@@ -1555,7 +1555,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-policies-modifyresource.html b/1.2/protocol-examples-policies-modifyresource.html
index 9b80de2..d6d9b5e 100644
--- a/1.2/protocol-examples-policies-modifyresource.html
+++ b/1.2/protocol-examples-policies-modifyresource.html
@@ -1544,7 +1544,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-policies-modifyresources.html b/1.2/protocol-examples-policies-modifyresources.html
index b446a5b..4a6f66b 100644
--- a/1.2/protocol-examples-policies-modifyresources.html
+++ b/1.2/protocol-examples-policies-modifyresources.html
@@ -1547,7 +1547,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-policies-modifysubject.html b/1.2/protocol-examples-policies-modifysubject.html
index 09107b0..6c330d7 100644
--- a/1.2/protocol-examples-policies-modifysubject.html
+++ b/1.2/protocol-examples-policies-modifysubject.html
@@ -1540,7 +1540,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-policies-modifysubjects.html b/1.2/protocol-examples-policies-modifysubjects.html
index 78c9511..15c01ff 100644
--- a/1.2/protocol-examples-policies-modifysubjects.html
+++ b/1.2/protocol-examples-policies-modifysubjects.html
@@ -1543,7 +1543,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-policies-retrievepolicy.html b/1.2/protocol-examples-policies-retrievepolicy.html
index 60d4365..d1f6eb3 100644
--- a/1.2/protocol-examples-policies-retrievepolicy.html
+++ b/1.2/protocol-examples-policies-retrievepolicy.html
@@ -1558,7 +1558,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-policies-retrievepolicyentries.html b/1.2/protocol-examples-policies-retrievepolicyentries.html
index 3b201a1..a448e95 100644
--- a/1.2/protocol-examples-policies-retrievepolicyentries.html
+++ b/1.2/protocol-examples-policies-retrievepolicyentries.html
@@ -1571,7 +1571,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-policies-retrievepolicyentry.html b/1.2/protocol-examples-policies-retrievepolicyentry.html
index 552ac2f..9888841 100644
--- a/1.2/protocol-examples-policies-retrievepolicyentry.html
+++ b/1.2/protocol-examples-policies-retrievepolicyentry.html
@@ -1553,7 +1553,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-policies-retrieveresource.html b/1.2/protocol-examples-policies-retrieveresource.html
index 56d63a4..8c76e02 100644
--- a/1.2/protocol-examples-policies-retrieveresource.html
+++ b/1.2/protocol-examples-policies-retrieveresource.html
@@ -1544,7 +1544,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-policies-retrieveresources.html b/1.2/protocol-examples-policies-retrieveresources.html
index 73c7eba..aab9477 100644
--- a/1.2/protocol-examples-policies-retrieveresources.html
+++ b/1.2/protocol-examples-policies-retrieveresources.html
@@ -1546,7 +1546,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-policies-retrievesubject.html b/1.2/protocol-examples-policies-retrievesubject.html
index 783ea22..be6ac66 100644
--- a/1.2/protocol-examples-policies-retrievesubject.html
+++ b/1.2/protocol-examples-policies-retrievesubject.html
@@ -1540,7 +1540,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-policies-retrievesubjects.html b/1.2/protocol-examples-policies-retrievesubjects.html
index 0eea0b2..30046a8 100644
--- a/1.2/protocol-examples-policies-retrievesubjects.html
+++ b/1.2/protocol-examples-policies-retrievesubjects.html
@@ -1542,7 +1542,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-retrieveattribute.html b/1.2/protocol-examples-retrieveattribute.html
index 8a74515..ec81509 100644
--- a/1.2/protocol-examples-retrieveattribute.html
+++ b/1.2/protocol-examples-retrieveattribute.html
@@ -1537,7 +1537,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-retrieveattributes.html b/1.2/protocol-examples-retrieveattributes.html
index 176a222..1100b81 100644
--- a/1.2/protocol-examples-retrieveattributes.html
+++ b/1.2/protocol-examples-retrieveattributes.html
@@ -1539,7 +1539,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-retrievedefinition.html b/1.2/protocol-examples-retrievedefinition.html
index 11e1b52..a135699 100644
--- a/1.2/protocol-examples-retrievedefinition.html
+++ b/1.2/protocol-examples-retrievedefinition.html
@@ -1536,7 +1536,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-retrievefeature.html b/1.2/protocol-examples-retrievefeature.html
index 0ad13e5..4b36090 100644
--- a/1.2/protocol-examples-retrievefeature.html
+++ b/1.2/protocol-examples-retrievefeature.html
@@ -1541,7 +1541,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-retrievefeatures.html b/1.2/protocol-examples-retrievefeatures.html
index 4164553..575fb44 100644
--- a/1.2/protocol-examples-retrievefeatures.html
+++ b/1.2/protocol-examples-retrievefeatures.html
@@ -1543,7 +1543,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-retrieveproperties.html b/1.2/protocol-examples-retrieveproperties.html
index 31d2fe6..002e445 100644
--- a/1.2/protocol-examples-retrieveproperties.html
+++ b/1.2/protocol-examples-retrieveproperties.html
@@ -1539,7 +1539,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-retrieveproperty.html b/1.2/protocol-examples-retrieveproperty.html
index 3c742d6..ca77710 100644
--- a/1.2/protocol-examples-retrieveproperty.html
+++ b/1.2/protocol-examples-retrieveproperty.html
@@ -1534,7 +1534,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-retrievething.html b/1.2/protocol-examples-retrievething.html
index 49e6f01..0ff4ebd 100644
--- a/1.2/protocol-examples-retrievething.html
+++ b/1.2/protocol-examples-retrievething.html
@@ -1563,7 +1563,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-retrievethingdefinition.html b/1.2/protocol-examples-retrievethingdefinition.html
index b22c259..04c8277 100644
--- a/1.2/protocol-examples-retrievethingdefinition.html
+++ b/1.2/protocol-examples-retrievethingdefinition.html
@@ -1534,7 +1534,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-retrievethings.html b/1.2/protocol-examples-retrievethings.html
index f5727af..c32e92b 100644
--- a/1.2/protocol-examples-retrievethings.html
+++ b/1.2/protocol-examples-retrievethings.html
@@ -1560,7 +1560,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples-search.html b/1.2/protocol-examples-search.html
index 1492a3f..b4dd306 100644
--- a/1.2/protocol-examples-search.html
+++ b/1.2/protocol-examples-search.html
@@ -1638,7 +1638,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-examples.html b/1.2/protocol-examples.html
index 5d4ca10..602ee75 100644
--- a/1.2/protocol-examples.html
+++ b/1.2/protocol-examples.html
@@ -1620,7 +1620,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-overview.html b/1.2/protocol-overview.html
index 54db79b..c094ede 100644
--- a/1.2/protocol-overview.html
+++ b/1.2/protocol-overview.html
@@ -1536,7 +1536,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-specification-acks.html b/1.2/protocol-specification-acks.html
index 7d57e82..042aed7 100644
--- a/1.2/protocol-specification-acks.html
+++ b/1.2/protocol-specification-acks.html
@@ -1560,7 +1560,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-specification-errors.html b/1.2/protocol-specification-errors.html
index 754fcea..af42319 100644
--- a/1.2/protocol-specification-errors.html
+++ b/1.2/protocol-specification-errors.html
@@ -1529,7 +1529,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-specification-policies-create-or-modify.html b/1.2/protocol-specification-policies-create-or-modify.html
index 1e34a1f..ebe5aa4 100644
--- a/1.2/protocol-specification-policies-create-or-modify.html
+++ b/1.2/protocol-specification-policies-create-or-modify.html
@@ -2138,7 +2138,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-specification-policies-delete.html b/1.2/protocol-specification-policies-delete.html
index 69000b0..602ea92 100644
--- a/1.2/protocol-specification-policies-delete.html
+++ b/1.2/protocol-specification-policies-delete.html
@@ -1808,7 +1808,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-specification-policies-retrieve.html b/1.2/protocol-specification-policies-retrieve.html
index e147c79..b86859a 100644
--- a/1.2/protocol-specification-policies-retrieve.html
+++ b/1.2/protocol-specification-policies-retrieve.html
@@ -2031,7 +2031,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-specification-policies.html b/1.2/protocol-specification-policies.html
index f14d3ff..fe6d6d1 100644
--- a/1.2/protocol-specification-policies.html
+++ b/1.2/protocol-specification-policies.html
@@ -1618,7 +1618,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-specification-things-create-or-modify.html b/1.2/protocol-specification-things-create-or-modify.html
index de1dc3e..dc4f42b 100644
--- a/1.2/protocol-specification-things-create-or-modify.html
+++ b/1.2/protocol-specification-things-create-or-modify.html
@@ -2938,7 +2938,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-specification-things-delete.html b/1.2/protocol-specification-things-delete.html
index 42b96ce..d7bbd68 100644
--- a/1.2/protocol-specification-things-delete.html
+++ b/1.2/protocol-specification-things-delete.html
@@ -2425,7 +2425,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-specification-things-messages.html b/1.2/protocol-specification-things-messages.html
index eaff21a..2b9bf7f 100644
--- a/1.2/protocol-specification-things-messages.html
+++ b/1.2/protocol-specification-things-messages.html
@@ -1780,7 +1780,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-specification-things-retrieve.html b/1.2/protocol-specification-things-retrieve.html
index abdb94d..206ffe6 100644
--- a/1.2/protocol-specification-things-retrieve.html
+++ b/1.2/protocol-specification-things-retrieve.html
@@ -2316,7 +2316,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-specification-things-search.html b/1.2/protocol-specification-things-search.html
index 10bb22b..0820371 100644
--- a/1.2/protocol-specification-things-search.html
+++ b/1.2/protocol-specification-things-search.html
@@ -1884,7 +1884,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-specification-things.html b/1.2/protocol-specification-things.html
index 3e43196..39de220 100644
--- a/1.2/protocol-specification-things.html
+++ b/1.2/protocol-specification-things.html
@@ -1589,7 +1589,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-specification-topic.html b/1.2/protocol-specification-topic.html
index 002202e..9399e40 100644
--- a/1.2/protocol-specification-topic.html
+++ b/1.2/protocol-specification-topic.html
@@ -1694,7 +1694,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-specification.html b/1.2/protocol-specification.html
index 52df982..daf38c8 100644
--- a/1.2/protocol-specification.html
+++ b/1.2/protocol-specification.html
@@ -1684,7 +1684,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/protocol-twinlive.html b/1.2/protocol-twinlive.html
index 8970510..59c258e 100644
--- a/1.2/protocol-twinlive.html
+++ b/1.2/protocol-twinlive.html
@@ -1547,7 +1547,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/release_notes_010-M1.html b/1.2/release_notes_010-M1.html
index 20b2003..57aeeef 100644
--- a/1.2/release_notes_010-M1.html
+++ b/1.2/release_notes_010-M1.html
@@ -1526,7 +1526,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/release_notes_010-M3.html b/1.2/release_notes_010-M3.html
index da9c605..65173e1 100644
--- a/1.2/release_notes_010-M3.html
+++ b/1.2/release_notes_010-M3.html
@@ -1582,7 +1582,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/release_notes_020-M1.html b/1.2/release_notes_020-M1.html
index b4b341f..c2d8f16 100644
--- a/1.2/release_notes_020-M1.html
+++ b/1.2/release_notes_020-M1.html
@@ -1567,7 +1567,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/release_notes_030-M1.html b/1.2/release_notes_030-M1.html
index c96cd6d..e327bd2 100644
--- a/1.2/release_notes_030-M1.html
+++ b/1.2/release_notes_030-M1.html
@@ -1578,7 +1578,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/release_notes_030-M2.html b/1.2/release_notes_030-M2.html
index 25878fd..a9fdc71 100644
--- a/1.2/release_notes_030-M2.html
+++ b/1.2/release_notes_030-M2.html
@@ -1575,7 +1575,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/release_notes_080-M1.html b/1.2/release_notes_080-M1.html
index 095b4e2..61b9e27 100644
--- a/1.2/release_notes_080-M1.html
+++ b/1.2/release_notes_080-M1.html
@@ -1597,7 +1597,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/release_notes_080-M2.html b/1.2/release_notes_080-M2.html
index eb67bad..14c025a 100644
--- a/1.2/release_notes_080-M2.html
+++ b/1.2/release_notes_080-M2.html
@@ -1581,7 +1581,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/release_notes_080-M3.html b/1.2/release_notes_080-M3.html
index 92ba2eb..024da65 100644
--- a/1.2/release_notes_080-M3.html
+++ b/1.2/release_notes_080-M3.html
@@ -1585,7 +1585,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/release_notes_080.html b/1.2/release_notes_080.html
index 8bec9ef..77772b4 100644
--- a/1.2/release_notes_080.html
+++ b/1.2/release_notes_080.html
@@ -1591,7 +1591,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/release_notes_090-M1.html b/1.2/release_notes_090-M1.html
index 7ee806f..789cd52 100644
--- a/1.2/release_notes_090-M1.html
+++ b/1.2/release_notes_090-M1.html
@@ -1563,7 +1563,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/release_notes_090-M2.html b/1.2/release_notes_090-M2.html
index 83a0ba5..2414583 100644
--- a/1.2/release_notes_090-M2.html
+++ b/1.2/release_notes_090-M2.html
@@ -1564,7 +1564,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/release_notes_090.html b/1.2/release_notes_090.html
index 504337a..323a741 100644
--- a/1.2/release_notes_090.html
+++ b/1.2/release_notes_090.html
@@ -1621,7 +1621,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/release_notes_100-M1a.html b/1.2/release_notes_100-M1a.html
index eba6736..1ef5654 100644
--- a/1.2/release_notes_100-M1a.html
+++ b/1.2/release_notes_100-M1a.html
@@ -1582,7 +1582,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/release_notes_100-M2.html b/1.2/release_notes_100-M2.html
index 85d841d..0b788b3 100644
--- a/1.2/release_notes_100-M2.html
+++ b/1.2/release_notes_100-M2.html
@@ -1599,7 +1599,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/release_notes_100.html b/1.2/release_notes_100.html
index cf1d85d..76a0209 100644
--- a/1.2/release_notes_100.html
+++ b/1.2/release_notes_100.html
@@ -1602,7 +1602,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/release_notes_110.html b/1.2/release_notes_110.html
index 0a54645..8aaa926 100644
--- a/1.2/release_notes_110.html
+++ b/1.2/release_notes_110.html
@@ -1643,7 +1643,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/release_notes_111.html b/1.2/release_notes_111.html
index d12aa43..cc9e462 100644
--- a/1.2/release_notes_111.html
+++ b/1.2/release_notes_111.html
@@ -1541,7 +1541,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/release_notes_112.html b/1.2/release_notes_112.html
index 63540c8..94f9c1e 100644
--- a/1.2/release_notes_112.html
+++ b/1.2/release_notes_112.html
@@ -1557,7 +1557,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/release_notes_113.html b/1.2/release_notes_113.html
index 82b0d9d..f3b27fc 100644
--- a/1.2/release_notes_113.html
+++ b/1.2/release_notes_113.html
@@ -1557,7 +1557,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/release_notes_115.html b/1.2/release_notes_115.html
index 914e869..979455c 100644
--- a/1.2/release_notes_115.html
+++ b/1.2/release_notes_115.html
@@ -1545,7 +1545,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/release_notes_120.html b/1.2/release_notes_120.html
index 08cd6ca..b8d6751 100644
--- a/1.2/release_notes_120.html
+++ b/1.2/release_notes_120.html
@@ -1617,7 +1617,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/release_notes_121.html b/1.2/release_notes_121.html
index fbe3a55..7cb67d4 100644
--- a/1.2/release_notes_121.html
+++ b/1.2/release_notes_121.html
@@ -1544,7 +1544,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/sandbox.html b/1.2/sandbox.html
index ff13248..cf9d5e7 100644
--- a/1.2/sandbox.html
+++ b/1.2/sandbox.html
@@ -1580,7 +1580,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/tag_architecture.html b/1.2/tag_architecture.html
index 9b51385..249d1b4 100644
--- a/1.2/tag_architecture.html
+++ b/1.2/tag_architecture.html
@@ -2317,7 +2317,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/tag_blog.html b/1.2/tag_blog.html
index cb3a3a1..611d3a5 100644
--- a/1.2/tag_blog.html
+++ b/1.2/tag_blog.html
@@ -2449,7 +2449,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/tag_client_sdk.html b/1.2/tag_client_sdk.html
index cb5d1f0..ceca5be 100644
--- a/1.2/tag_client_sdk.html
+++ b/1.2/tag_client_sdk.html
@@ -2303,7 +2303,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/tag_connectivity.html b/1.2/tag_connectivity.html
index 25f4d01..38858ce 100644
--- a/1.2/tag_connectivity.html
+++ b/1.2/tag_connectivity.html
@@ -2389,7 +2389,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/tag_getting_started.html b/1.2/tag_getting_started.html
index e050351..dd94806 100644
--- a/1.2/tag_getting_started.html
+++ b/1.2/tag_getting_started.html
@@ -2317,7 +2317,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/tag_http.html b/1.2/tag_http.html
index 06f31dd..06fabae 100644
--- a/1.2/tag_http.html
+++ b/1.2/tag_http.html
@@ -2311,7 +2311,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/tag_installation.html b/1.2/tag_installation.html
index 1f13332..6d6e58b 100644
--- a/1.2/tag_installation.html
+++ b/1.2/tag_installation.html
@@ -2293,7 +2293,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/tag_model.html b/1.2/tag_model.html
index 2ca50ad..d3874d6 100644
--- a/1.2/tag_model.html
+++ b/1.2/tag_model.html
@@ -2353,7 +2353,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/tag_news.html b/1.2/tag_news.html
index 37777c2..e0ead21 100644
--- a/1.2/tag_news.html
+++ b/1.2/tag_news.html
@@ -2275,7 +2275,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/tag_protocol.html b/1.2/tag_protocol.html
index 8655070..85d9930 100644
--- a/1.2/tag_protocol.html
+++ b/1.2/tag_protocol.html
@@ -2445,7 +2445,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/tag_release_notes.html b/1.2/tag_release_notes.html
index ccfb0d5..999edc9 100644
--- a/1.2/tag_release_notes.html
+++ b/1.2/tag_release_notes.html
@@ -2407,7 +2407,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/tag_rql.html b/1.2/tag_rql.html
index 552f1e3..0f6a96e 100644
--- a/1.2/tag_rql.html
+++ b/1.2/tag_rql.html
@@ -2341,7 +2341,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/tag_search.html b/1.2/tag_search.html
index 1ed375c..a205a0a 100644
--- a/1.2/tag_search.html
+++ b/1.2/tag_search.html
@@ -2311,7 +2311,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/tag_signal.html b/1.2/tag_signal.html
index 8707ff9..c4f2198 100644
--- a/1.2/tag_signal.html
+++ b/1.2/tag_signal.html
@@ -2310,7 +2310,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.2/tag_troubleshooting.html b/1.2/tag_troubleshooting.html
index 2ebcbc3..6a8639d 100644
--- a/1.2/tag_troubleshooting.html
+++ b/1.2/tag_troubleshooting.html
@@ -2281,7 +2281,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2017-11-10-welcome-to-ditto.html b/1.3/2017-11-10-welcome-to-ditto.html
index af61245..a38399d 100644
--- a/1.3/2017-11-10-welcome-to-ditto.html
+++ b/1.3/2017-11-10-welcome-to-ditto.html
@@ -264,7 +264,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2017-12-18-milestone-announcement-010-M1.html b/1.3/2017-12-18-milestone-announcement-010-M1.html
index 995ef92..2497278 100644
--- a/1.3/2017-12-18-milestone-announcement-010-M1.html
+++ b/1.3/2017-12-18-milestone-announcement-010-M1.html
@@ -268,7 +268,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2018-01-12-milestone-announcement-010-M3.html b/1.3/2018-01-12-milestone-announcement-010-M3.html
index 443b45c..a5c012c 100644
--- a/1.3/2018-01-12-milestone-announcement-010-M3.html
+++ b/1.3/2018-01-12-milestone-announcement-010-M3.html
@@ -287,7 +287,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2018-01-15-example-demonstrating-rest-to-websocket.html b/1.3/2018-01-15-example-demonstrating-rest-to-websocket.html
index 288bb6d..1c59809 100644
--- a/1.3/2018-01-15-example-demonstrating-rest-to-websocket.html
+++ b/1.3/2018-01-15-example-demonstrating-rest-to-websocket.html
@@ -276,7 +276,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2018-02-07-milestone-announcement-020-M1.html b/1.3/2018-02-07-milestone-announcement-020-M1.html
index 386c53e..c4e3505 100644
--- a/1.3/2018-02-07-milestone-announcement-020-M1.html
+++ b/1.3/2018-02-07-milestone-announcement-020-M1.html
@@ -288,7 +288,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2018-02-08-feature-definition.html b/1.3/2018-02-08-feature-definition.html
index 4d2a7a0..1ec5e6b 100644
--- a/1.3/2018-02-08-feature-definition.html
+++ b/1.3/2018-02-08-feature-definition.html
@@ -318,7 +318,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2018-04-25-connectivity-service.html b/1.3/2018-04-25-connectivity-service.html
index ee6325f..a4c770b 100644
--- a/1.3/2018-04-25-connectivity-service.html
+++ b/1.3/2018-04-25-connectivity-service.html
@@ -332,7 +332,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2018-04-26-milestone-announcement-030-M1.html b/1.3/2018-04-26-milestone-announcement-030-M1.html
index f32d1a7..edaa08b 100644
--- a/1.3/2018-04-26-milestone-announcement-030-M1.html
+++ b/1.3/2018-04-26-milestone-announcement-030-M1.html
@@ -284,7 +284,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2018-05-02-connecting-ditto-hono.html b/1.3/2018-05-02-connecting-ditto-hono.html
index 4087f26..75da7a3 100644
--- a/1.3/2018-05-02-connecting-ditto-hono.html
+++ b/1.3/2018-05-02-connecting-ditto-hono.html
@@ -1006,7 +1006,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2018-06-15-milestone-announcement-030-M2.html b/1.3/2018-06-15-milestone-announcement-030-M2.html
index 8de57e6..be0475d 100644
--- a/1.3/2018-06-15-milestone-announcement-030-M2.html
+++ b/1.3/2018-06-15-milestone-announcement-030-M2.html
@@ -284,7 +284,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2018-08-14-milestone-announcement-080-M1.html b/1.3/2018-08-14-milestone-announcement-080-M1.html
index e734fed..c2aaab0 100644
--- a/1.3/2018-08-14-milestone-announcement-080-M1.html
+++ b/1.3/2018-08-14-milestone-announcement-080-M1.html
@@ -284,7 +284,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2018-09-21-selective-push-notifications.html b/1.3/2018-09-21-selective-push-notifications.html
index 154a661..c551aea 100644
--- a/1.3/2018-09-21-selective-push-notifications.html
+++ b/1.3/2018-09-21-selective-push-notifications.html
@@ -484,7 +484,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2018-09-27-milestone-announcement-080-M2.html b/1.3/2018-09-27-milestone-announcement-080-M2.html
index 991f731..778a524 100644
--- a/1.3/2018-09-27-milestone-announcement-080-M2.html
+++ b/1.3/2018-09-27-milestone-announcement-080-M2.html
@@ -286,7 +286,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2018-10-16-example-mqtt-bidirectional.html b/1.3/2018-10-16-example-mqtt-bidirectional.html
index 41c0e0b..25eb822 100644
--- a/1.3/2018-10-16-example-mqtt-bidirectional.html
+++ b/1.3/2018-10-16-example-mqtt-bidirectional.html
@@ -292,7 +292,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2018-11-14-milestone-announcement-080-M3.html b/1.3/2018-11-14-milestone-announcement-080-M3.html
index 11db738..72ca105 100644
--- a/1.3/2018-11-14-milestone-announcement-080-M3.html
+++ b/1.3/2018-11-14-milestone-announcement-080-M3.html
@@ -285,7 +285,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2018-11-28-release-announcement-080.html b/1.3/2018-11-28-release-announcement-080.html
index 56fc132..f02de58 100644
--- a/1.3/2018-11-28-release-announcement-080.html
+++ b/1.3/2018-11-28-release-announcement-080.html
@@ -280,7 +280,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2018-12-05-example-command-and-control.html b/1.3/2018-12-05-example-command-and-control.html
index 93f7564..b070207 100644
--- a/1.3/2018-12-05-example-command-and-control.html
+++ b/1.3/2018-12-05-example-command-and-control.html
@@ -519,7 +519,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2019-03-13-kafka-connectivity.html b/1.3/2019-03-13-kafka-connectivity.html
index 5124a67..78f385b 100644
--- a/1.3/2019-03-13-kafka-connectivity.html
+++ b/1.3/2019-03-13-kafka-connectivity.html
@@ -266,7 +266,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2019-03-28-milestone-announcement-090-M1.html b/1.3/2019-03-28-milestone-announcement-090-M1.html
index 34122f3..e6ca182 100644
--- a/1.3/2019-03-28-milestone-announcement-090-M1.html
+++ b/1.3/2019-03-28-milestone-announcement-090-M1.html
@@ -282,7 +282,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2019-04-29-milestone-announcement-090-M2.html b/1.3/2019-04-29-milestone-announcement-090-M2.html
index 9868b05..cb7f802 100644
--- a/1.3/2019-04-29-milestone-announcement-090-M2.html
+++ b/1.3/2019-04-29-milestone-announcement-090-M2.html
@@ -280,7 +280,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2019-07-10-release-announcement-090.html b/1.3/2019-07-10-release-announcement-090.html
index 5d00af2..2d22fd9 100644
--- a/1.3/2019-07-10-release-announcement-090.html
+++ b/1.3/2019-07-10-release-announcement-090.html
@@ -286,7 +286,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2019-08-28-openid-connect.html b/1.3/2019-08-28-openid-connect.html
index 8debef6..c912e6d 100644
--- a/1.3/2019-08-28-openid-connect.html
+++ b/1.3/2019-08-28-openid-connect.html
@@ -332,7 +332,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2019-09-17-milestone-announcement-100-M1a.html b/1.3/2019-09-17-milestone-announcement-100-M1a.html
index 8a0fd63..a9f6c76 100644
--- a/1.3/2019-09-17-milestone-announcement-100-M1a.html
+++ b/1.3/2019-09-17-milestone-announcement-100-M1a.html
@@ -283,7 +283,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2019-10-17-http-connectivity.html b/1.3/2019-10-17-http-connectivity.html
index 4a252cf..22db3d3 100644
--- a/1.3/2019-10-17-http-connectivity.html
+++ b/1.3/2019-10-17-http-connectivity.html
@@ -291,7 +291,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2019-11-04-milestone-announcement-100-M2.html b/1.3/2019-11-04-milestone-announcement-100-M2.html
index 1e041a6..229eacf 100644
--- a/1.3/2019-11-04-milestone-announcement-100-M2.html
+++ b/1.3/2019-11-04-milestone-announcement-100-M2.html
@@ -282,7 +282,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2019-12-12-release-announcement-100.html b/1.3/2019-12-12-release-announcement-100.html
index 4926b82..c591729 100644
--- a/1.3/2019-12-12-release-announcement-100.html
+++ b/1.3/2019-12-12-release-announcement-100.html
@@ -331,7 +331,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2020-04-16-connecting-to-ttn-via-mqtt.html b/1.3/2020-04-16-connecting-to-ttn-via-mqtt.html
index 5e3d6a9..0d64784 100644
--- a/1.3/2020-04-16-connecting-to-ttn-via-mqtt.html
+++ b/1.3/2020-04-16-connecting-to-ttn-via-mqtt.html
@@ -778,7 +778,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2020-04-29-release-announcement-110.html b/1.3/2020-04-29-release-announcement-110.html
index 90a7768..02d87b3 100644
--- a/1.3/2020-04-29-release-announcement-110.html
+++ b/1.3/2020-04-29-release-announcement-110.html
@@ -312,7 +312,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2020-08-31-release-announcement-120.html b/1.3/2020-08-31-release-announcement-120.html
index cad8590..c70e4e4 100644
--- a/1.3/2020-08-31-release-announcement-120.html
+++ b/1.3/2020-08-31-release-announcement-120.html
@@ -290,7 +290,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/2020-09-30-release-announcement-130.html b/1.3/2020-09-30-release-announcement-130.html
index 25de33f..f4f9bea 100644
--- a/1.3/2020-09-30-release-announcement-130.html
+++ b/1.3/2020-09-30-release-announcement-130.html
@@ -290,7 +290,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/404.html b/1.3/404.html
index 47665f5..34e9628 100644
--- a/1.3/404.html
+++ b/1.3/404.html
@@ -1523,7 +1523,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/architecture-overview.html b/1.3/architecture-overview.html
index c4ed19c..a63c2c7 100644
--- a/1.3/architecture-overview.html
+++ b/1.3/architecture-overview.html
@@ -1576,7 +1576,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/architecture-services-concierge.html b/1.3/architecture-services-concierge.html
index a3aef6e..a63d87c 100644
--- a/1.3/architecture-services-concierge.html
+++ b/1.3/architecture-services-concierge.html
@@ -1562,7 +1562,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/architecture-services-connectivity.html b/1.3/architecture-services-connectivity.html
index 59630a6..fda8788 100644
--- a/1.3/architecture-services-connectivity.html
+++ b/1.3/architecture-services-connectivity.html
@@ -1576,7 +1576,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/architecture-services-gateway.html b/1.3/architecture-services-gateway.html
index c6fc77b..e2337f0 100644
--- a/1.3/architecture-services-gateway.html
+++ b/1.3/architecture-services-gateway.html
@@ -1554,7 +1554,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/architecture-services-policies.html b/1.3/architecture-services-policies.html
index f44eb1b..678aa34 100644
--- a/1.3/architecture-services-policies.html
+++ b/1.3/architecture-services-policies.html
@@ -1555,7 +1555,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/architecture-services-things-search.html b/1.3/architecture-services-things-search.html
index 958eefa..b4558b5 100644
--- a/1.3/architecture-services-things-search.html
+++ b/1.3/architecture-services-things-search.html
@@ -1599,7 +1599,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/architecture-services-things.html b/1.3/architecture-services-things.html
index 0f298cb..b681968 100644
--- a/1.3/architecture-services-things.html
+++ b/1.3/architecture-services-things.html
@@ -1555,7 +1555,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/basic-acknowledgements.html b/1.3/basic-acknowledgements.html
index c114b18..1f1bfa8 100644
--- a/1.3/basic-acknowledgements.html
+++ b/1.3/basic-acknowledgements.html
@@ -2111,7 +2111,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/basic-acl.html b/1.3/basic-acl.html
index 961f03a..ab5e1d3 100644
--- a/1.3/basic-acl.html
+++ b/1.3/basic-acl.html
@@ -1593,7 +1593,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/basic-apis.html b/1.3/basic-apis.html
index 66cb491..8691bb7 100644
--- a/1.3/basic-apis.html
+++ b/1.3/basic-apis.html
@@ -1651,7 +1651,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/basic-auth.html b/1.3/basic-auth.html
index 2ff08d8..67e39fe 100644
--- a/1.3/basic-auth.html
+++ b/1.3/basic-auth.html
@@ -1572,7 +1572,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/basic-changenotifications.html b/1.3/basic-changenotifications.html
index 2f0eaa8..8dafcba 100644
--- a/1.3/basic-changenotifications.html
+++ b/1.3/basic-changenotifications.html
@@ -1595,7 +1595,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/basic-connections.html b/1.3/basic-connections.html
index f12945e..040dc6e 100644
--- a/1.3/basic-connections.html
+++ b/1.3/basic-connections.html
@@ -2090,7 +2090,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/basic-enrichment.html b/1.3/basic-enrichment.html
index 730a211..19ebf7e 100644
--- a/1.3/basic-enrichment.html
+++ b/1.3/basic-enrichment.html
@@ -1628,7 +1628,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/basic-errors.html b/1.3/basic-errors.html
index 914d920..1044ce1 100644
--- a/1.3/basic-errors.html
+++ b/1.3/basic-errors.html
@@ -1572,7 +1572,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/basic-feature.html b/1.3/basic-feature.html
index 57efd37..6981010 100644
--- a/1.3/basic-feature.html
+++ b/1.3/basic-feature.html
@@ -1756,7 +1756,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/basic-messages.html b/1.3/basic-messages.html
index 3882c39..d540bd0 100644
--- a/1.3/basic-messages.html
+++ b/1.3/basic-messages.html
@@ -1664,7 +1664,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/basic-metadata.html b/1.3/basic-metadata.html
index c9c6577..399e5e8 100644
--- a/1.3/basic-metadata.html
+++ b/1.3/basic-metadata.html
@@ -1706,7 +1706,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/basic-namespaces-and-names.html b/1.3/basic-namespaces-and-names.html
index eb54609..ba472fa 100644
--- a/1.3/basic-namespaces-and-names.html
+++ b/1.3/basic-namespaces-and-names.html
@@ -1599,7 +1599,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/basic-overview.html b/1.3/basic-overview.html
index 135280f..7f98138 100644
--- a/1.3/basic-overview.html
+++ b/1.3/basic-overview.html
@@ -1668,7 +1668,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/basic-placeholders.html b/1.3/basic-placeholders.html
index 57c7466..6734601 100644
--- a/1.3/basic-placeholders.html
+++ b/1.3/basic-placeholders.html
@@ -1806,7 +1806,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/basic-policy.html b/1.3/basic-policy.html
index 36bd23c..6d935c5 100644
--- a/1.3/basic-policy.html
+++ b/1.3/basic-policy.html
@@ -1934,7 +1934,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/basic-rql.html b/1.3/basic-rql.html
index bff4b77..65d7376 100644
--- a/1.3/basic-rql.html
+++ b/1.3/basic-rql.html
@@ -1774,7 +1774,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/basic-search.html b/1.3/basic-search.html
index 76c0cc7..66a585d 100644
--- a/1.3/basic-search.html
+++ b/1.3/basic-search.html
@@ -1667,7 +1667,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/basic-signals-command.html b/1.3/basic-signals-command.html
index 227c075..8fc24be 100644
--- a/1.3/basic-signals-command.html
+++ b/1.3/basic-signals-command.html
@@ -1553,7 +1553,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/basic-signals-commandresponse.html b/1.3/basic-signals-commandresponse.html
index 4c82cb8..bb48662 100644
--- a/1.3/basic-signals-commandresponse.html
+++ b/1.3/basic-signals-commandresponse.html
@@ -1533,7 +1533,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/basic-signals-errorresponse.html b/1.3/basic-signals-errorresponse.html
index f8b562a..366d791 100644
--- a/1.3/basic-signals-errorresponse.html
+++ b/1.3/basic-signals-errorresponse.html
@@ -1537,7 +1537,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/basic-signals-event.html b/1.3/basic-signals-event.html
index 3f36b37..bc16f2f 100644
--- a/1.3/basic-signals-event.html
+++ b/1.3/basic-signals-event.html
@@ -1539,7 +1539,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/basic-signals.html b/1.3/basic-signals.html
index 6f7fa30..0f1a649 100644
--- a/1.3/basic-signals.html
+++ b/1.3/basic-signals.html
@@ -1583,7 +1583,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/basic-thing.html b/1.3/basic-thing.html
index f2139c9..642ccc3 100644
--- a/1.3/basic-thing.html
+++ b/1.3/basic-thing.html
@@ -1624,7 +1624,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/blog.html b/1.3/blog.html
index 47a7e53..1425f5e 100644
--- a/1.3/blog.html
+++ b/1.3/blog.html
@@ -393,7 +393,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/blog_archive.html b/1.3/blog_archive.html
index 9c888b0..6dabdaf 100644
--- a/1.3/blog_archive.html
+++ b/1.3/blog_archive.html
@@ -460,7 +460,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/client-sdk-java.html b/1.3/client-sdk-java.html
index 2a5a223..9cff699 100644
--- a/1.3/client-sdk-java.html
+++ b/1.3/client-sdk-java.html
@@ -1780,7 +1780,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/client-sdk-javascript.html b/1.3/client-sdk-javascript.html
index fc74327..5893f17 100644
--- a/1.3/client-sdk-javascript.html
+++ b/1.3/client-sdk-javascript.html
@@ -1589,7 +1589,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/client-sdk-overview.html b/1.3/client-sdk-overview.html
index f37ff90..989df7e 100644
--- a/1.3/client-sdk-overview.html
+++ b/1.3/client-sdk-overview.html
@@ -1536,7 +1536,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/connectivity-header-mapping.html b/1.3/connectivity-header-mapping.html
index 858ce4b..91a10c1 100644
--- a/1.3/connectivity-header-mapping.html
+++ b/1.3/connectivity-header-mapping.html
@@ -1546,7 +1546,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/connectivity-manage-connections.html b/1.3/connectivity-manage-connections.html
index 1b39a24..a234c72 100644
--- a/1.3/connectivity-manage-connections.html
+++ b/1.3/connectivity-manage-connections.html
@@ -1851,7 +1851,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/connectivity-mapping.html b/1.3/connectivity-mapping.html
index a1ef208..33d801f 100644
--- a/1.3/connectivity-mapping.html
+++ b/1.3/connectivity-mapping.html
@@ -2457,7 +2457,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/connectivity-overview.html b/1.3/connectivity-overview.html
index 95f816a..c1c6d7e 100644
--- a/1.3/connectivity-overview.html
+++ b/1.3/connectivity-overview.html
@@ -1548,7 +1548,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/connectivity-protocol-bindings-amqp091.html b/1.3/connectivity-protocol-bindings-amqp091.html
index 8f0eaeb..603f11c 100644
--- a/1.3/connectivity-protocol-bindings-amqp091.html
+++ b/1.3/connectivity-protocol-bindings-amqp091.html
@@ -1694,7 +1694,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/connectivity-protocol-bindings-amqp10.html b/1.3/connectivity-protocol-bindings-amqp10.html
index 88c7c42..de29520 100644
--- a/1.3/connectivity-protocol-bindings-amqp10.html
+++ b/1.3/connectivity-protocol-bindings-amqp10.html
@@ -1740,7 +1740,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/connectivity-protocol-bindings-http.html b/1.3/connectivity-protocol-bindings-http.html
index b1c498e..04c2bbb 100644
--- a/1.3/connectivity-protocol-bindings-http.html
+++ b/1.3/connectivity-protocol-bindings-http.html
@@ -1747,7 +1747,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/connectivity-protocol-bindings-kafka2.html b/1.3/connectivity-protocol-bindings-kafka2.html
index 608c85e..fcb9b98 100644
--- a/1.3/connectivity-protocol-bindings-kafka2.html
+++ b/1.3/connectivity-protocol-bindings-kafka2.html
@@ -1672,7 +1672,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/connectivity-protocol-bindings-mqtt.html b/1.3/connectivity-protocol-bindings-mqtt.html
index 78c7b35..e2b5191 100644
--- a/1.3/connectivity-protocol-bindings-mqtt.html
+++ b/1.3/connectivity-protocol-bindings-mqtt.html
@@ -1865,7 +1865,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/connectivity-protocol-bindings-mqtt5.html b/1.3/connectivity-protocol-bindings-mqtt5.html
index d21b3ab..52ffae8 100644
--- a/1.3/connectivity-protocol-bindings-mqtt5.html
+++ b/1.3/connectivity-protocol-bindings-mqtt5.html
@@ -1873,7 +1873,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/connectivity-tls-certificates.html b/1.3/connectivity-tls-certificates.html
index 5638c5e..01a7d12 100644
--- a/1.3/connectivity-tls-certificates.html
+++ b/1.3/connectivity-tls-certificates.html
@@ -1644,7 +1644,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/feedback.html b/1.3/feedback.html
index 34daf67..ce13cd9 100644
--- a/1.3/feedback.html
+++ b/1.3/feedback.html
@@ -1548,7 +1548,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/glossary.html b/1.3/glossary.html
index 500f5ef..bb4af17 100644
--- a/1.3/glossary.html
+++ b/1.3/glossary.html
@@ -1536,7 +1536,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/http-api-doc.html b/1.3/http-api-doc.html
index 84bcfff..454ef27 100644
--- a/1.3/http-api-doc.html
+++ b/1.3/http-api-doc.html
@@ -201,7 +201,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/httpapi-concepts.html b/1.3/httpapi-concepts.html
index 5bb1f99..953e04f 100644
--- a/1.3/httpapi-concepts.html
+++ b/1.3/httpapi-concepts.html
@@ -2122,7 +2122,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/httpapi-messages.html b/1.3/httpapi-messages.html
index 4de8ed6..78f8f7d 100644
--- a/1.3/httpapi-messages.html
+++ b/1.3/httpapi-messages.html
@@ -1624,7 +1624,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/httpapi-overview.html b/1.3/httpapi-overview.html
index 92396c1..99ac4d5 100644
--- a/1.3/httpapi-overview.html
+++ b/1.3/httpapi-overview.html
@@ -1544,7 +1544,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/httpapi-protocol-bindings-websocket.html b/1.3/httpapi-protocol-bindings-websocket.html
index 3c914c8..137703c 100644
--- a/1.3/httpapi-protocol-bindings-websocket.html
+++ b/1.3/httpapi-protocol-bindings-websocket.html
@@ -1824,7 +1824,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/httpapi-search.html b/1.3/httpapi-search.html
index e92acce..d577a76 100644
--- a/1.3/httpapi-search.html
+++ b/1.3/httpapi-search.html
@@ -1591,7 +1591,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/httpapi-sse.html b/1.3/httpapi-sse.html
index 568d143..022bb53 100644
--- a/1.3/httpapi-sse.html
+++ b/1.3/httpapi-sse.html
@@ -1776,7 +1776,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/index.html b/1.3/index.html
index ec47e7f..e0b6937 100644
--- a/1.3/index.html
+++ b/1.3/index.html
@@ -265,7 +265,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/installation-building.html b/1.3/installation-building.html
index 670e574..b46b4a9 100644
--- a/1.3/installation-building.html
+++ b/1.3/installation-building.html
@@ -1563,7 +1563,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/installation-operating.html b/1.3/installation-operating.html
index 26821c9..e5f71b2 100644
--- a/1.3/installation-operating.html
+++ b/1.3/installation-operating.html
@@ -2419,7 +2419,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/installation-running.html b/1.3/installation-running.html
index de7e97d..d1d69a7 100644
--- a/1.3/installation-running.html
+++ b/1.3/installation-running.html
@@ -1591,7 +1591,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/intro-digitaltwins.html b/1.3/intro-digitaltwins.html
index e9fd21f..30bd1c8 100644
--- a/1.3/intro-digitaltwins.html
+++ b/1.3/intro-digitaltwins.html
@@ -1566,7 +1566,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/intro-hello-world.html b/1.3/intro-hello-world.html
index 86a8919..f92a7a1 100644
--- a/1.3/intro-hello-world.html
+++ b/1.3/intro-hello-world.html
@@ -1655,7 +1655,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/intro-overview.html b/1.3/intro-overview.html
index 26fcf4e..1245e57 100644
--- a/1.3/intro-overview.html
+++ b/1.3/intro-overview.html
@@ -1582,7 +1582,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/presentations.html b/1.3/presentations.html
index 2f3435b..ad61977 100644
--- a/1.3/presentations.html
+++ b/1.3/presentations.html
@@ -1570,7 +1570,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-bindings.html b/1.3/protocol-bindings.html
index 744cc5e..f20f97b 100644
--- a/1.3/protocol-bindings.html
+++ b/1.3/protocol-bindings.html
@@ -1556,7 +1556,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-createattribute.html b/1.3/protocol-examples-createattribute.html
index 85f6937..dbc84eb 100644
--- a/1.3/protocol-examples-createattribute.html
+++ b/1.3/protocol-examples-createattribute.html
@@ -1558,7 +1558,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-createattributes.html b/1.3/protocol-examples-createattributes.html
index 6627249..2ea9349 100644
--- a/1.3/protocol-examples-createattributes.html
+++ b/1.3/protocol-examples-createattributes.html
@@ -1563,7 +1563,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-createdefinition.html b/1.3/protocol-examples-createdefinition.html
index 8a6e37f..c4b64d0 100644
--- a/1.3/protocol-examples-createdefinition.html
+++ b/1.3/protocol-examples-createdefinition.html
@@ -1556,7 +1556,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-createfeature.html b/1.3/protocol-examples-createfeature.html
index 6f34c0b..8cfd93b 100644
--- a/1.3/protocol-examples-createfeature.html
+++ b/1.3/protocol-examples-createfeature.html
@@ -1567,7 +1567,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-createfeatures.html b/1.3/protocol-examples-createfeatures.html
index cbc0148..94cedd9 100644
--- a/1.3/protocol-examples-createfeatures.html
+++ b/1.3/protocol-examples-createfeatures.html
@@ -1571,7 +1571,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-createproperties.html b/1.3/protocol-examples-createproperties.html
index b84da62..9c7ab2c 100644
--- a/1.3/protocol-examples-createproperties.html
+++ b/1.3/protocol-examples-createproperties.html
@@ -1562,7 +1562,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-createproperty.html b/1.3/protocol-examples-createproperty.html
index 7e096a0..d77dacf 100644
--- a/1.3/protocol-examples-createproperty.html
+++ b/1.3/protocol-examples-createproperty.html
@@ -1552,7 +1552,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-creatething.html b/1.3/protocol-examples-creatething.html
index 963878b..396dc4a 100644
--- a/1.3/protocol-examples-creatething.html
+++ b/1.3/protocol-examples-creatething.html
@@ -1651,7 +1651,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-createthingdefinition.html b/1.3/protocol-examples-createthingdefinition.html
index 735794f..a946cfc 100644
--- a/1.3/protocol-examples-createthingdefinition.html
+++ b/1.3/protocol-examples-createthingdefinition.html
@@ -1553,7 +1553,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-deleteattribute.html b/1.3/protocol-examples-deleteattribute.html
index 66fab56..f909be4 100644
--- a/1.3/protocol-examples-deleteattribute.html
+++ b/1.3/protocol-examples-deleteattribute.html
@@ -1550,7 +1550,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-deleteattributes.html b/1.3/protocol-examples-deleteattributes.html
index 23b3546..5878d1d 100644
--- a/1.3/protocol-examples-deleteattributes.html
+++ b/1.3/protocol-examples-deleteattributes.html
@@ -1550,7 +1550,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-deletedefinition.html b/1.3/protocol-examples-deletedefinition.html
index 8a14512..f51d7d7 100644
--- a/1.3/protocol-examples-deletedefinition.html
+++ b/1.3/protocol-examples-deletedefinition.html
@@ -1550,7 +1550,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-deletefeature.html b/1.3/protocol-examples-deletefeature.html
index a6f3aed..8931d75 100644
--- a/1.3/protocol-examples-deletefeature.html
+++ b/1.3/protocol-examples-deletefeature.html
@@ -1550,7 +1550,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-deletefeatures.html b/1.3/protocol-examples-deletefeatures.html
index e2a53ad..0c9fef1 100644
--- a/1.3/protocol-examples-deletefeatures.html
+++ b/1.3/protocol-examples-deletefeatures.html
@@ -1550,7 +1550,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-deleteproperties.html b/1.3/protocol-examples-deleteproperties.html
index ba7aeba..0979a14 100644
--- a/1.3/protocol-examples-deleteproperties.html
+++ b/1.3/protocol-examples-deleteproperties.html
@@ -1550,7 +1550,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-deleteproperty.html b/1.3/protocol-examples-deleteproperty.html
index 4e70c0c..c2e3505 100644
--- a/1.3/protocol-examples-deleteproperty.html
+++ b/1.3/protocol-examples-deleteproperty.html
@@ -1550,7 +1550,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-deletething.html b/1.3/protocol-examples-deletething.html
index d0690f0..0bacdf3 100644
--- a/1.3/protocol-examples-deletething.html
+++ b/1.3/protocol-examples-deletething.html
@@ -1550,7 +1550,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-deletethingdefinition.html b/1.3/protocol-examples-deletethingdefinition.html
index 3454e38..451c8a4 100644
--- a/1.3/protocol-examples-deletethingdefinition.html
+++ b/1.3/protocol-examples-deletethingdefinition.html
@@ -1550,7 +1550,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-errorresponses.html b/1.3/protocol-examples-errorresponses.html
index 9760e4f..0e47659 100644
--- a/1.3/protocol-examples-errorresponses.html
+++ b/1.3/protocol-examples-errorresponses.html
@@ -1985,7 +1985,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-modifyattribute.html b/1.3/protocol-examples-modifyattribute.html
index 5332cc6..1fe6354 100644
--- a/1.3/protocol-examples-modifyattribute.html
+++ b/1.3/protocol-examples-modifyattribute.html
@@ -1558,7 +1558,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-modifyattributes.html b/1.3/protocol-examples-modifyattributes.html
index 3e1b81e..4f38f75 100644
--- a/1.3/protocol-examples-modifyattributes.html
+++ b/1.3/protocol-examples-modifyattributes.html
@@ -1563,7 +1563,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-modifydefinition.html b/1.3/protocol-examples-modifydefinition.html
index bec6d03..5d92725 100644
--- a/1.3/protocol-examples-modifydefinition.html
+++ b/1.3/protocol-examples-modifydefinition.html
@@ -1556,7 +1556,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-modifyfeature.html b/1.3/protocol-examples-modifyfeature.html
index f7e0e1e..2fb061c 100644
--- a/1.3/protocol-examples-modifyfeature.html
+++ b/1.3/protocol-examples-modifyfeature.html
@@ -1567,7 +1567,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-modifyfeatures.html b/1.3/protocol-examples-modifyfeatures.html
index 4cc8a3d..2ca9386 100644
--- a/1.3/protocol-examples-modifyfeatures.html
+++ b/1.3/protocol-examples-modifyfeatures.html
@@ -1571,7 +1571,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-modifypolicyid.html b/1.3/protocol-examples-modifypolicyid.html
index cb7ba85..146578b 100644
--- a/1.3/protocol-examples-modifypolicyid.html
+++ b/1.3/protocol-examples-modifypolicyid.html
@@ -1574,7 +1574,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-modifyproperties.html b/1.3/protocol-examples-modifyproperties.html
index 7638e97..db63b6b 100644
--- a/1.3/protocol-examples-modifyproperties.html
+++ b/1.3/protocol-examples-modifyproperties.html
@@ -1562,7 +1562,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-modifyproperty.html b/1.3/protocol-examples-modifyproperty.html
index 22a3a24..d96a741 100644
--- a/1.3/protocol-examples-modifyproperty.html
+++ b/1.3/protocol-examples-modifyproperty.html
@@ -1552,7 +1552,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-modifything.html b/1.3/protocol-examples-modifything.html
index 07698c5..77dc3ad 100644
--- a/1.3/protocol-examples-modifything.html
+++ b/1.3/protocol-examples-modifything.html
@@ -1632,7 +1632,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-modifythingdefinition.html b/1.3/protocol-examples-modifythingdefinition.html
index 5946815..b72e80e 100644
--- a/1.3/protocol-examples-modifythingdefinition.html
+++ b/1.3/protocol-examples-modifythingdefinition.html
@@ -1552,7 +1552,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-policies-createpolicy.html b/1.3/protocol-examples-policies-createpolicy.html
index f7f4992..95fb25d 100644
--- a/1.3/protocol-examples-policies-createpolicy.html
+++ b/1.3/protocol-examples-policies-createpolicy.html
@@ -1586,7 +1586,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-policies-createpolicyentry.html b/1.3/protocol-examples-policies-createpolicyentry.html
index 0acc6bf..1c57522 100644
--- a/1.3/protocol-examples-policies-createpolicyentry.html
+++ b/1.3/protocol-examples-policies-createpolicyentry.html
@@ -1562,7 +1562,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-policies-createresource.html b/1.3/protocol-examples-policies-createresource.html
index 4bc5a89..54ee643 100644
--- a/1.3/protocol-examples-policies-createresource.html
+++ b/1.3/protocol-examples-policies-createresource.html
@@ -1551,7 +1551,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-policies-createsubject.html b/1.3/protocol-examples-policies-createsubject.html
index aa949ec..278f673 100644
--- a/1.3/protocol-examples-policies-createsubject.html
+++ b/1.3/protocol-examples-policies-createsubject.html
@@ -1547,7 +1547,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-policies-deletepolicy.html b/1.3/protocol-examples-policies-deletepolicy.html
index 12fcf9d..9f37d72 100644
--- a/1.3/protocol-examples-policies-deletepolicy.html
+++ b/1.3/protocol-examples-policies-deletepolicy.html
@@ -1544,7 +1544,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-policies-deletepolicyentry.html b/1.3/protocol-examples-policies-deletepolicyentry.html
index ed3fd4b..7006740 100644
--- a/1.3/protocol-examples-policies-deletepolicyentry.html
+++ b/1.3/protocol-examples-policies-deletepolicyentry.html
@@ -1544,7 +1544,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-policies-deleteresource.html b/1.3/protocol-examples-policies-deleteresource.html
index e2068e7..cdcbedb 100644
--- a/1.3/protocol-examples-policies-deleteresource.html
+++ b/1.3/protocol-examples-policies-deleteresource.html
@@ -1544,7 +1544,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-policies-deletesubject.html b/1.3/protocol-examples-policies-deletesubject.html
index 1d5bbb9..3a6127a 100644
--- a/1.3/protocol-examples-policies-deletesubject.html
+++ b/1.3/protocol-examples-policies-deletesubject.html
@@ -1544,7 +1544,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-policies-errorresponses.html b/1.3/protocol-examples-policies-errorresponses.html
index 712c799..7a11f15 100644
--- a/1.3/protocol-examples-policies-errorresponses.html
+++ b/1.3/protocol-examples-policies-errorresponses.html
@@ -1882,7 +1882,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-policies-modifypolicy.html b/1.3/protocol-examples-policies-modifypolicy.html
index a793632..9c69b9a 100644
--- a/1.3/protocol-examples-policies-modifypolicy.html
+++ b/1.3/protocol-examples-policies-modifypolicy.html
@@ -1565,7 +1565,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-policies-modifypolicyentries.html b/1.3/protocol-examples-policies-modifypolicyentries.html
index d17fa7c..a1e03ab 100644
--- a/1.3/protocol-examples-policies-modifypolicyentries.html
+++ b/1.3/protocol-examples-policies-modifypolicyentries.html
@@ -1584,7 +1584,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-policies-modifypolicyentry.html b/1.3/protocol-examples-policies-modifypolicyentry.html
index eb1ca0a..3355f34 100644
--- a/1.3/protocol-examples-policies-modifypolicyentry.html
+++ b/1.3/protocol-examples-policies-modifypolicyentry.html
@@ -1562,7 +1562,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-policies-modifyresource.html b/1.3/protocol-examples-policies-modifyresource.html
index d750159..47ad573 100644
--- a/1.3/protocol-examples-policies-modifyresource.html
+++ b/1.3/protocol-examples-policies-modifyresource.html
@@ -1551,7 +1551,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-policies-modifyresources.html b/1.3/protocol-examples-policies-modifyresources.html
index cb622e4..2228b5c 100644
--- a/1.3/protocol-examples-policies-modifyresources.html
+++ b/1.3/protocol-examples-policies-modifyresources.html
@@ -1554,7 +1554,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-policies-modifysubject.html b/1.3/protocol-examples-policies-modifysubject.html
index f792d57..b08c35d 100644
--- a/1.3/protocol-examples-policies-modifysubject.html
+++ b/1.3/protocol-examples-policies-modifysubject.html
@@ -1547,7 +1547,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-policies-modifysubjects.html b/1.3/protocol-examples-policies-modifysubjects.html
index 3c2ad99..aec32c9 100644
--- a/1.3/protocol-examples-policies-modifysubjects.html
+++ b/1.3/protocol-examples-policies-modifysubjects.html
@@ -1550,7 +1550,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-policies-retrievepolicy.html b/1.3/protocol-examples-policies-retrievepolicy.html
index ea85c63..f961124 100644
--- a/1.3/protocol-examples-policies-retrievepolicy.html
+++ b/1.3/protocol-examples-policies-retrievepolicy.html
@@ -1565,7 +1565,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-policies-retrievepolicyentries.html b/1.3/protocol-examples-policies-retrievepolicyentries.html
index bf5145b..465fcb1 100644
--- a/1.3/protocol-examples-policies-retrievepolicyentries.html
+++ b/1.3/protocol-examples-policies-retrievepolicyentries.html
@@ -1578,7 +1578,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-policies-retrievepolicyentry.html b/1.3/protocol-examples-policies-retrievepolicyentry.html
index 9cb0162..48c407c 100644
--- a/1.3/protocol-examples-policies-retrievepolicyentry.html
+++ b/1.3/protocol-examples-policies-retrievepolicyentry.html
@@ -1560,7 +1560,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-policies-retrieveresource.html b/1.3/protocol-examples-policies-retrieveresource.html
index 3781ea6..05726c8 100644
--- a/1.3/protocol-examples-policies-retrieveresource.html
+++ b/1.3/protocol-examples-policies-retrieveresource.html
@@ -1551,7 +1551,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-policies-retrieveresources.html b/1.3/protocol-examples-policies-retrieveresources.html
index 60f59ba..7c7f1ce 100644
--- a/1.3/protocol-examples-policies-retrieveresources.html
+++ b/1.3/protocol-examples-policies-retrieveresources.html
@@ -1553,7 +1553,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-policies-retrievesubject.html b/1.3/protocol-examples-policies-retrievesubject.html
index f5b7927..b9f6d09 100644
--- a/1.3/protocol-examples-policies-retrievesubject.html
+++ b/1.3/protocol-examples-policies-retrievesubject.html
@@ -1547,7 +1547,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-policies-retrievesubjects.html b/1.3/protocol-examples-policies-retrievesubjects.html
index a32611f..a218d13 100644
--- a/1.3/protocol-examples-policies-retrievesubjects.html
+++ b/1.3/protocol-examples-policies-retrievesubjects.html
@@ -1549,7 +1549,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-retrieveattribute.html b/1.3/protocol-examples-retrieveattribute.html
index 63492bc..88faee9 100644
--- a/1.3/protocol-examples-retrieveattribute.html
+++ b/1.3/protocol-examples-retrieveattribute.html
@@ -1544,7 +1544,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-retrieveattributes.html b/1.3/protocol-examples-retrieveattributes.html
index b27913f..be319bf 100644
--- a/1.3/protocol-examples-retrieveattributes.html
+++ b/1.3/protocol-examples-retrieveattributes.html
@@ -1546,7 +1546,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-retrievedefinition.html b/1.3/protocol-examples-retrievedefinition.html
index 3273978..dc99d62 100644
--- a/1.3/protocol-examples-retrievedefinition.html
+++ b/1.3/protocol-examples-retrievedefinition.html
@@ -1543,7 +1543,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-retrievefeature.html b/1.3/protocol-examples-retrievefeature.html
index b1bede0..becbe9b 100644
--- a/1.3/protocol-examples-retrievefeature.html
+++ b/1.3/protocol-examples-retrievefeature.html
@@ -1548,7 +1548,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-retrievefeatures.html b/1.3/protocol-examples-retrievefeatures.html
index 4cfa98b..2dd57ab 100644
--- a/1.3/protocol-examples-retrievefeatures.html
+++ b/1.3/protocol-examples-retrievefeatures.html
@@ -1550,7 +1550,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-retrieveproperties.html b/1.3/protocol-examples-retrieveproperties.html
index 0caa6bf..e86189e 100644
--- a/1.3/protocol-examples-retrieveproperties.html
+++ b/1.3/protocol-examples-retrieveproperties.html
@@ -1546,7 +1546,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-retrieveproperty.html b/1.3/protocol-examples-retrieveproperty.html
index b56d674..52914fa 100644
--- a/1.3/protocol-examples-retrieveproperty.html
+++ b/1.3/protocol-examples-retrieveproperty.html
@@ -1541,7 +1541,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-retrievething.html b/1.3/protocol-examples-retrievething.html
index 82414ae..4e75704 100644
--- a/1.3/protocol-examples-retrievething.html
+++ b/1.3/protocol-examples-retrievething.html
@@ -1570,7 +1570,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-retrievethingdefinition.html b/1.3/protocol-examples-retrievethingdefinition.html
index 2c434c7..90f72a2 100644
--- a/1.3/protocol-examples-retrievethingdefinition.html
+++ b/1.3/protocol-examples-retrievethingdefinition.html
@@ -1541,7 +1541,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-retrievethings.html b/1.3/protocol-examples-retrievethings.html
index 6fd0a0c..bacc56d 100644
--- a/1.3/protocol-examples-retrievethings.html
+++ b/1.3/protocol-examples-retrievethings.html
@@ -1567,7 +1567,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples-search.html b/1.3/protocol-examples-search.html
index 11f83bc..a8e9a41 100644
--- a/1.3/protocol-examples-search.html
+++ b/1.3/protocol-examples-search.html
@@ -1645,7 +1645,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-examples.html b/1.3/protocol-examples.html
index 3e1a40b..c64eefb 100644
--- a/1.3/protocol-examples.html
+++ b/1.3/protocol-examples.html
@@ -1627,7 +1627,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-overview.html b/1.3/protocol-overview.html
index 3621c6a..4a717a5 100644
--- a/1.3/protocol-overview.html
+++ b/1.3/protocol-overview.html
@@ -1543,7 +1543,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-specification-acks.html b/1.3/protocol-specification-acks.html
index d9b04f0..6faaf7c 100644
--- a/1.3/protocol-specification-acks.html
+++ b/1.3/protocol-specification-acks.html
@@ -1567,7 +1567,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-specification-errors.html b/1.3/protocol-specification-errors.html
index e15a33c..3b8f587 100644
--- a/1.3/protocol-specification-errors.html
+++ b/1.3/protocol-specification-errors.html
@@ -1536,7 +1536,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-specification-policies-create-or-modify.html b/1.3/protocol-specification-policies-create-or-modify.html
index 1a8d1b4..b774bdd 100644
--- a/1.3/protocol-specification-policies-create-or-modify.html
+++ b/1.3/protocol-specification-policies-create-or-modify.html
@@ -2145,7 +2145,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-specification-policies-delete.html b/1.3/protocol-specification-policies-delete.html
index ec08acf..c28dbac 100644
--- a/1.3/protocol-specification-policies-delete.html
+++ b/1.3/protocol-specification-policies-delete.html
@@ -1815,7 +1815,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-specification-policies-retrieve.html b/1.3/protocol-specification-policies-retrieve.html
index 214df41..e8d2d9d 100644
--- a/1.3/protocol-specification-policies-retrieve.html
+++ b/1.3/protocol-specification-policies-retrieve.html
@@ -2038,7 +2038,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-specification-policies.html b/1.3/protocol-specification-policies.html
index 6ae9e01..98d19cc 100644
--- a/1.3/protocol-specification-policies.html
+++ b/1.3/protocol-specification-policies.html
@@ -1625,7 +1625,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-specification-things-create-or-modify.html b/1.3/protocol-specification-things-create-or-modify.html
index d878e93..4434062 100644
--- a/1.3/protocol-specification-things-create-or-modify.html
+++ b/1.3/protocol-specification-things-create-or-modify.html
@@ -2945,7 +2945,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-specification-things-delete.html b/1.3/protocol-specification-things-delete.html
index 60e03ec..e1ffb62 100644
--- a/1.3/protocol-specification-things-delete.html
+++ b/1.3/protocol-specification-things-delete.html
@@ -2432,7 +2432,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-specification-things-messages.html b/1.3/protocol-specification-things-messages.html
index 8e1c7a8..a858ce8 100644
--- a/1.3/protocol-specification-things-messages.html
+++ b/1.3/protocol-specification-things-messages.html
@@ -1787,7 +1787,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-specification-things-retrieve.html b/1.3/protocol-specification-things-retrieve.html
index 23d1b94..52bbe24 100644
--- a/1.3/protocol-specification-things-retrieve.html
+++ b/1.3/protocol-specification-things-retrieve.html
@@ -2323,7 +2323,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-specification-things-search.html b/1.3/protocol-specification-things-search.html
index 4de70db..4818979 100644
--- a/1.3/protocol-specification-things-search.html
+++ b/1.3/protocol-specification-things-search.html
@@ -1891,7 +1891,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-specification-things.html b/1.3/protocol-specification-things.html
index deb1376..a1c0261 100644
--- a/1.3/protocol-specification-things.html
+++ b/1.3/protocol-specification-things.html
@@ -1596,7 +1596,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-specification-topic.html b/1.3/protocol-specification-topic.html
index ef90d50..acbe9c4 100644
--- a/1.3/protocol-specification-topic.html
+++ b/1.3/protocol-specification-topic.html
@@ -1701,7 +1701,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-specification.html b/1.3/protocol-specification.html
index 7cbac2e..fe5cfbb 100644
--- a/1.3/protocol-specification.html
+++ b/1.3/protocol-specification.html
@@ -1691,7 +1691,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/protocol-twinlive.html b/1.3/protocol-twinlive.html
index 595691b..a85d9fc 100644
--- a/1.3/protocol-twinlive.html
+++ b/1.3/protocol-twinlive.html
@@ -1554,7 +1554,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/release_notes_010-M1.html b/1.3/release_notes_010-M1.html
index f50810a..a3548f5 100644
--- a/1.3/release_notes_010-M1.html
+++ b/1.3/release_notes_010-M1.html
@@ -1533,7 +1533,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/release_notes_010-M3.html b/1.3/release_notes_010-M3.html
index 6425bba..8ac19e9 100644
--- a/1.3/release_notes_010-M3.html
+++ b/1.3/release_notes_010-M3.html
@@ -1589,7 +1589,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/release_notes_020-M1.html b/1.3/release_notes_020-M1.html
index 142bb60..173b489 100644
--- a/1.3/release_notes_020-M1.html
+++ b/1.3/release_notes_020-M1.html
@@ -1574,7 +1574,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/release_notes_030-M1.html b/1.3/release_notes_030-M1.html
index a70ecb5..9c8ac79 100644
--- a/1.3/release_notes_030-M1.html
+++ b/1.3/release_notes_030-M1.html
@@ -1585,7 +1585,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/release_notes_030-M2.html b/1.3/release_notes_030-M2.html
index b752d00..0323270 100644
--- a/1.3/release_notes_030-M2.html
+++ b/1.3/release_notes_030-M2.html
@@ -1582,7 +1582,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/release_notes_080-M1.html b/1.3/release_notes_080-M1.html
index 26feb4a..765a6ce 100644
--- a/1.3/release_notes_080-M1.html
+++ b/1.3/release_notes_080-M1.html
@@ -1604,7 +1604,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/release_notes_080-M2.html b/1.3/release_notes_080-M2.html
index e46fe24..5b6e173 100644
--- a/1.3/release_notes_080-M2.html
+++ b/1.3/release_notes_080-M2.html
@@ -1588,7 +1588,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/release_notes_080-M3.html b/1.3/release_notes_080-M3.html
index 5841d1f..5b531e7 100644
--- a/1.3/release_notes_080-M3.html
+++ b/1.3/release_notes_080-M3.html
@@ -1592,7 +1592,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/release_notes_080.html b/1.3/release_notes_080.html
index 46986a8..f26b9d7 100644
--- a/1.3/release_notes_080.html
+++ b/1.3/release_notes_080.html
@@ -1598,7 +1598,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/release_notes_090-M1.html b/1.3/release_notes_090-M1.html
index bb28b5c..e7d4803 100644
--- a/1.3/release_notes_090-M1.html
+++ b/1.3/release_notes_090-M1.html
@@ -1570,7 +1570,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/release_notes_090-M2.html b/1.3/release_notes_090-M2.html
index 9f6934f..f73bca3 100644
--- a/1.3/release_notes_090-M2.html
+++ b/1.3/release_notes_090-M2.html
@@ -1571,7 +1571,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/release_notes_090.html b/1.3/release_notes_090.html
index 4e474de..57bf20c 100644
--- a/1.3/release_notes_090.html
+++ b/1.3/release_notes_090.html
@@ -1628,7 +1628,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/release_notes_100-M1a.html b/1.3/release_notes_100-M1a.html
index 743a31a..7b54122 100644
--- a/1.3/release_notes_100-M1a.html
+++ b/1.3/release_notes_100-M1a.html
@@ -1589,7 +1589,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/release_notes_100-M2.html b/1.3/release_notes_100-M2.html
index 74f073d..c1a807e 100644
--- a/1.3/release_notes_100-M2.html
+++ b/1.3/release_notes_100-M2.html
@@ -1606,7 +1606,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/release_notes_100.html b/1.3/release_notes_100.html
index 79a4fdb..691e45e 100644
--- a/1.3/release_notes_100.html
+++ b/1.3/release_notes_100.html
@@ -1609,7 +1609,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/release_notes_110.html b/1.3/release_notes_110.html
index facb39b..afb835d 100644
--- a/1.3/release_notes_110.html
+++ b/1.3/release_notes_110.html
@@ -1650,7 +1650,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/release_notes_111.html b/1.3/release_notes_111.html
index 754d0f9..00cf01c 100644
--- a/1.3/release_notes_111.html
+++ b/1.3/release_notes_111.html
@@ -1548,7 +1548,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/release_notes_112.html b/1.3/release_notes_112.html
index 206d959..f10ab30 100644
--- a/1.3/release_notes_112.html
+++ b/1.3/release_notes_112.html
@@ -1564,7 +1564,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/release_notes_113.html b/1.3/release_notes_113.html
index d04a95c..f293a94 100644
--- a/1.3/release_notes_113.html
+++ b/1.3/release_notes_113.html
@@ -1564,7 +1564,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/release_notes_115.html b/1.3/release_notes_115.html
index ce0ac03..61fdbb3 100644
--- a/1.3/release_notes_115.html
+++ b/1.3/release_notes_115.html
@@ -1552,7 +1552,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/release_notes_120.html b/1.3/release_notes_120.html
index 9664c19..ce6c2dc 100644
--- a/1.3/release_notes_120.html
+++ b/1.3/release_notes_120.html
@@ -1624,7 +1624,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/release_notes_121.html b/1.3/release_notes_121.html
index 9f1488a..4419ff1 100644
--- a/1.3/release_notes_121.html
+++ b/1.3/release_notes_121.html
@@ -1551,7 +1551,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/release_notes_130.html b/1.3/release_notes_130.html
index 15bc7ac..981de38 100644
--- a/1.3/release_notes_130.html
+++ b/1.3/release_notes_130.html
@@ -1641,7 +1641,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/sandbox.html b/1.3/sandbox.html
index 41b44c9..d70f872 100644
--- a/1.3/sandbox.html
+++ b/1.3/sandbox.html
@@ -1587,7 +1587,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/tag_architecture.html b/1.3/tag_architecture.html
index f0aa0b1..3a13b79 100644
--- a/1.3/tag_architecture.html
+++ b/1.3/tag_architecture.html
@@ -2332,7 +2332,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/tag_blog.html b/1.3/tag_blog.html
index af46592..0860b0e 100644
--- a/1.3/tag_blog.html
+++ b/1.3/tag_blog.html
@@ -2470,7 +2470,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/tag_client_sdk.html b/1.3/tag_client_sdk.html
index face787..e2b6a94 100644
--- a/1.3/tag_client_sdk.html
+++ b/1.3/tag_client_sdk.html
@@ -2318,7 +2318,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/tag_connectivity.html b/1.3/tag_connectivity.html
index a94c6c5..a16a067 100644
--- a/1.3/tag_connectivity.html
+++ b/1.3/tag_connectivity.html
@@ -2404,7 +2404,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/tag_getting_started.html b/1.3/tag_getting_started.html
index 930860a..6fbd280 100644
--- a/1.3/tag_getting_started.html
+++ b/1.3/tag_getting_started.html
@@ -2332,7 +2332,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/tag_http.html b/1.3/tag_http.html
index 73c6cab..771cf0e 100644
--- a/1.3/tag_http.html
+++ b/1.3/tag_http.html
@@ -2326,7 +2326,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/tag_installation.html b/1.3/tag_installation.html
index e936bf8..9d4a74c 100644
--- a/1.3/tag_installation.html
+++ b/1.3/tag_installation.html
@@ -2308,7 +2308,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/tag_model.html b/1.3/tag_model.html
index 36f285a..c0fbf8d 100644
--- a/1.3/tag_model.html
+++ b/1.3/tag_model.html
@@ -2368,7 +2368,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/tag_news.html b/1.3/tag_news.html
index 67e5728..07ce000 100644
--- a/1.3/tag_news.html
+++ b/1.3/tag_news.html
@@ -2290,7 +2290,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/tag_protocol.html b/1.3/tag_protocol.html
index 391c53e..586d0d7 100644
--- a/1.3/tag_protocol.html
+++ b/1.3/tag_protocol.html
@@ -2460,7 +2460,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/tag_release_notes.html b/1.3/tag_release_notes.html
index ce3a56a..2a42cb9 100644
--- a/1.3/tag_release_notes.html
+++ b/1.3/tag_release_notes.html
@@ -2428,7 +2428,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/tag_rql.html b/1.3/tag_rql.html
index 5c5fe61..ecba6f6 100644
--- a/1.3/tag_rql.html
+++ b/1.3/tag_rql.html
@@ -2356,7 +2356,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/tag_search.html b/1.3/tag_search.html
index 869b045..db13548 100644
--- a/1.3/tag_search.html
+++ b/1.3/tag_search.html
@@ -2326,7 +2326,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/tag_signal.html b/1.3/tag_signal.html
index 52a5633..e08e22f 100644
--- a/1.3/tag_signal.html
+++ b/1.3/tag_signal.html
@@ -2325,7 +2325,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.3/tag_troubleshooting.html b/1.3/tag_troubleshooting.html
index b8a6a70..98037f6 100644
--- a/1.3/tag_troubleshooting.html
+++ b/1.3/tag_troubleshooting.html
@@ -2296,7 +2296,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2017-11-10-welcome-to-ditto.html b/1.4/2017-11-10-welcome-to-ditto.html
index baeaa3c..186bf2d 100644
--- a/1.4/2017-11-10-welcome-to-ditto.html
+++ b/1.4/2017-11-10-welcome-to-ditto.html
@@ -264,7 +264,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2017-12-18-milestone-announcement-010-M1.html b/1.4/2017-12-18-milestone-announcement-010-M1.html
index 86f4906..4a79564 100644
--- a/1.4/2017-12-18-milestone-announcement-010-M1.html
+++ b/1.4/2017-12-18-milestone-announcement-010-M1.html
@@ -268,7 +268,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2018-01-12-milestone-announcement-010-M3.html b/1.4/2018-01-12-milestone-announcement-010-M3.html
index 9cf3d02..1889ddd 100644
--- a/1.4/2018-01-12-milestone-announcement-010-M3.html
+++ b/1.4/2018-01-12-milestone-announcement-010-M3.html
@@ -287,7 +287,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2018-01-15-example-demonstrating-rest-to-websocket.html b/1.4/2018-01-15-example-demonstrating-rest-to-websocket.html
index 4771e14..d504047 100644
--- a/1.4/2018-01-15-example-demonstrating-rest-to-websocket.html
+++ b/1.4/2018-01-15-example-demonstrating-rest-to-websocket.html
@@ -276,7 +276,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2018-02-07-milestone-announcement-020-M1.html b/1.4/2018-02-07-milestone-announcement-020-M1.html
index 27f2dc2..82d3841 100644
--- a/1.4/2018-02-07-milestone-announcement-020-M1.html
+++ b/1.4/2018-02-07-milestone-announcement-020-M1.html
@@ -288,7 +288,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2018-02-08-feature-definition.html b/1.4/2018-02-08-feature-definition.html
index 93cb268..36d228d 100644
--- a/1.4/2018-02-08-feature-definition.html
+++ b/1.4/2018-02-08-feature-definition.html
@@ -318,7 +318,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2018-04-25-connectivity-service.html b/1.4/2018-04-25-connectivity-service.html
index 60c98bd..6ea87ec 100644
--- a/1.4/2018-04-25-connectivity-service.html
+++ b/1.4/2018-04-25-connectivity-service.html
@@ -332,7 +332,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2018-04-26-milestone-announcement-030-M1.html b/1.4/2018-04-26-milestone-announcement-030-M1.html
index b393aa1..f8398e2 100644
--- a/1.4/2018-04-26-milestone-announcement-030-M1.html
+++ b/1.4/2018-04-26-milestone-announcement-030-M1.html
@@ -284,7 +284,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2018-05-02-connecting-ditto-hono.html b/1.4/2018-05-02-connecting-ditto-hono.html
index 466caf0..91b3822 100644
--- a/1.4/2018-05-02-connecting-ditto-hono.html
+++ b/1.4/2018-05-02-connecting-ditto-hono.html
@@ -1006,7 +1006,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2018-06-15-milestone-announcement-030-M2.html b/1.4/2018-06-15-milestone-announcement-030-M2.html
index 5f9fb51..d9eefd0 100644
--- a/1.4/2018-06-15-milestone-announcement-030-M2.html
+++ b/1.4/2018-06-15-milestone-announcement-030-M2.html
@@ -284,7 +284,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2018-08-14-milestone-announcement-080-M1.html b/1.4/2018-08-14-milestone-announcement-080-M1.html
index ac8dd8c..a3832d2 100644
--- a/1.4/2018-08-14-milestone-announcement-080-M1.html
+++ b/1.4/2018-08-14-milestone-announcement-080-M1.html
@@ -284,7 +284,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2018-09-21-selective-push-notifications.html b/1.4/2018-09-21-selective-push-notifications.html
index f40157d..c3d1db8 100644
--- a/1.4/2018-09-21-selective-push-notifications.html
+++ b/1.4/2018-09-21-selective-push-notifications.html
@@ -484,7 +484,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2018-09-27-milestone-announcement-080-M2.html b/1.4/2018-09-27-milestone-announcement-080-M2.html
index 0288517..7d0b4b5 100644
--- a/1.4/2018-09-27-milestone-announcement-080-M2.html
+++ b/1.4/2018-09-27-milestone-announcement-080-M2.html
@@ -286,7 +286,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2018-10-16-example-mqtt-bidirectional.html b/1.4/2018-10-16-example-mqtt-bidirectional.html
index ec89ae0..276722c 100644
--- a/1.4/2018-10-16-example-mqtt-bidirectional.html
+++ b/1.4/2018-10-16-example-mqtt-bidirectional.html
@@ -292,7 +292,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2018-11-14-milestone-announcement-080-M3.html b/1.4/2018-11-14-milestone-announcement-080-M3.html
index 491b550..ecd0d03 100644
--- a/1.4/2018-11-14-milestone-announcement-080-M3.html
+++ b/1.4/2018-11-14-milestone-announcement-080-M3.html
@@ -285,7 +285,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2018-11-28-release-announcement-080.html b/1.4/2018-11-28-release-announcement-080.html
index 04cc602..4a8ed29 100644
--- a/1.4/2018-11-28-release-announcement-080.html
+++ b/1.4/2018-11-28-release-announcement-080.html
@@ -280,7 +280,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2018-12-05-example-command-and-control.html b/1.4/2018-12-05-example-command-and-control.html
index df639da..6040f47 100644
--- a/1.4/2018-12-05-example-command-and-control.html
+++ b/1.4/2018-12-05-example-command-and-control.html
@@ -519,7 +519,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2019-03-13-kafka-connectivity.html b/1.4/2019-03-13-kafka-connectivity.html
index d781786..57678db 100644
--- a/1.4/2019-03-13-kafka-connectivity.html
+++ b/1.4/2019-03-13-kafka-connectivity.html
@@ -266,7 +266,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2019-03-28-milestone-announcement-090-M1.html b/1.4/2019-03-28-milestone-announcement-090-M1.html
index f1595ec..c07edc5 100644
--- a/1.4/2019-03-28-milestone-announcement-090-M1.html
+++ b/1.4/2019-03-28-milestone-announcement-090-M1.html
@@ -282,7 +282,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2019-04-29-milestone-announcement-090-M2.html b/1.4/2019-04-29-milestone-announcement-090-M2.html
index 47b9c1e..dbc9ba6 100644
--- a/1.4/2019-04-29-milestone-announcement-090-M2.html
+++ b/1.4/2019-04-29-milestone-announcement-090-M2.html
@@ -280,7 +280,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2019-07-10-release-announcement-090.html b/1.4/2019-07-10-release-announcement-090.html
index f2f747d..200d5cb 100644
--- a/1.4/2019-07-10-release-announcement-090.html
+++ b/1.4/2019-07-10-release-announcement-090.html
@@ -286,7 +286,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2019-08-28-openid-connect.html b/1.4/2019-08-28-openid-connect.html
index 43638f8..a4870ab 100644
--- a/1.4/2019-08-28-openid-connect.html
+++ b/1.4/2019-08-28-openid-connect.html
@@ -332,7 +332,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2019-09-17-milestone-announcement-100-M1a.html b/1.4/2019-09-17-milestone-announcement-100-M1a.html
index 1f5b677..0055d5f 100644
--- a/1.4/2019-09-17-milestone-announcement-100-M1a.html
+++ b/1.4/2019-09-17-milestone-announcement-100-M1a.html
@@ -283,7 +283,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2019-10-17-http-connectivity.html b/1.4/2019-10-17-http-connectivity.html
index e56304e..5d4c56d 100644
--- a/1.4/2019-10-17-http-connectivity.html
+++ b/1.4/2019-10-17-http-connectivity.html
@@ -291,7 +291,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2019-11-04-milestone-announcement-100-M2.html b/1.4/2019-11-04-milestone-announcement-100-M2.html
index 6b2cba2..bdb5548 100644
--- a/1.4/2019-11-04-milestone-announcement-100-M2.html
+++ b/1.4/2019-11-04-milestone-announcement-100-M2.html
@@ -282,7 +282,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2019-12-12-release-announcement-100.html b/1.4/2019-12-12-release-announcement-100.html
index b454464..0cc4b94 100644
--- a/1.4/2019-12-12-release-announcement-100.html
+++ b/1.4/2019-12-12-release-announcement-100.html
@@ -331,7 +331,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2020-04-16-connecting-to-ttn-via-mqtt.html b/1.4/2020-04-16-connecting-to-ttn-via-mqtt.html
index 47308d6..864c2d9 100644
--- a/1.4/2020-04-16-connecting-to-ttn-via-mqtt.html
+++ b/1.4/2020-04-16-connecting-to-ttn-via-mqtt.html
@@ -778,7 +778,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2020-04-29-release-announcement-110.html b/1.4/2020-04-29-release-announcement-110.html
index 15937da..caac6c2 100644
--- a/1.4/2020-04-29-release-announcement-110.html
+++ b/1.4/2020-04-29-release-announcement-110.html
@@ -312,7 +312,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2020-08-31-release-announcement-120.html b/1.4/2020-08-31-release-announcement-120.html
index 5e9187b..8d84292 100644
--- a/1.4/2020-08-31-release-announcement-120.html
+++ b/1.4/2020-08-31-release-announcement-120.html
@@ -290,7 +290,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2020-09-30-release-announcement-130.html b/1.4/2020-09-30-release-announcement-130.html
index 28d1e30..6e54ab1 100644
--- a/1.4/2020-09-30-release-announcement-130.html
+++ b/1.4/2020-09-30-release-announcement-130.html
@@ -290,7 +290,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2020-10-08-asynchronous-client-creation.html b/1.4/2020-10-08-asynchronous-client-creation.html
index 6ff7f6f..deb03e6 100644
--- a/1.4/2020-10-08-asynchronous-client-creation.html
+++ b/1.4/2020-10-08-asynchronous-client-creation.html
@@ -324,7 +324,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2020-10-23-end-2-end-acknowledgment.html b/1.4/2020-10-23-end-2-end-acknowledgment.html
index cbb5248..e5d08f5 100644
--- a/1.4/2020-10-23-end-2-end-acknowledgment.html
+++ b/1.4/2020-10-23-end-2-end-acknowledgment.html
@@ -563,7 +563,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/2020-10-28-release-announcement-140.html b/1.4/2020-10-28-release-announcement-140.html
index 543f530..f354e9f 100644
--- a/1.4/2020-10-28-release-announcement-140.html
+++ b/1.4/2020-10-28-release-announcement-140.html
@@ -288,7 +288,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/404.html b/1.4/404.html
index 3e10b93..b12e4f8 100644
--- a/1.4/404.html
+++ b/1.4/404.html
@@ -1530,7 +1530,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/architecture-overview.html b/1.4/architecture-overview.html
index 1af6bd0..9c6d71c 100644
--- a/1.4/architecture-overview.html
+++ b/1.4/architecture-overview.html
@@ -1583,7 +1583,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/architecture-services-concierge.html b/1.4/architecture-services-concierge.html
index 4a038f6..db231e7 100644
--- a/1.4/architecture-services-concierge.html
+++ b/1.4/architecture-services-concierge.html
@@ -1569,7 +1569,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/architecture-services-connectivity.html b/1.4/architecture-services-connectivity.html
index 58335ff..5ade3c6 100644
--- a/1.4/architecture-services-connectivity.html
+++ b/1.4/architecture-services-connectivity.html
@@ -1583,7 +1583,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/architecture-services-gateway.html b/1.4/architecture-services-gateway.html
index bb6d153..f1b122e 100644
--- a/1.4/architecture-services-gateway.html
+++ b/1.4/architecture-services-gateway.html
@@ -1561,7 +1561,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/architecture-services-policies.html b/1.4/architecture-services-policies.html
index 628eb0e..69f52b3 100644
--- a/1.4/architecture-services-policies.html
+++ b/1.4/architecture-services-policies.html
@@ -1562,7 +1562,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/architecture-services-things-search.html b/1.4/architecture-services-things-search.html
index a844b2b..b93e444 100644
--- a/1.4/architecture-services-things-search.html
+++ b/1.4/architecture-services-things-search.html
@@ -1606,7 +1606,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/architecture-services-things.html b/1.4/architecture-services-things.html
index 743baef..c0605e8 100644
--- a/1.4/architecture-services-things.html
+++ b/1.4/architecture-services-things.html
@@ -1562,7 +1562,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/basic-acknowledgements.html b/1.4/basic-acknowledgements.html
index 6101f86..8581584 100644
--- a/1.4/basic-acknowledgements.html
+++ b/1.4/basic-acknowledgements.html
@@ -2185,7 +2185,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/basic-acl.html b/1.4/basic-acl.html
index 41be487..a9e9cf6 100644
--- a/1.4/basic-acl.html
+++ b/1.4/basic-acl.html
@@ -1600,7 +1600,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/basic-apis.html b/1.4/basic-apis.html
index ff10006..126c960 100644
--- a/1.4/basic-apis.html
+++ b/1.4/basic-apis.html
@@ -1658,7 +1658,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/basic-auth.html b/1.4/basic-auth.html
index 3c42e5a..f89305d 100644
--- a/1.4/basic-auth.html
+++ b/1.4/basic-auth.html
@@ -1604,7 +1604,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/basic-changenotifications.html b/1.4/basic-changenotifications.html
index 6cb109f..b9654ce 100644
--- a/1.4/basic-changenotifications.html
+++ b/1.4/basic-changenotifications.html
@@ -1602,7 +1602,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/basic-connections.html b/1.4/basic-connections.html
index 4a06565..99628cc 100644
--- a/1.4/basic-connections.html
+++ b/1.4/basic-connections.html
@@ -2120,7 +2120,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/basic-enrichment.html b/1.4/basic-enrichment.html
index 54879c3..1af7b5c 100644
--- a/1.4/basic-enrichment.html
+++ b/1.4/basic-enrichment.html
@@ -1633,7 +1633,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/basic-errors.html b/1.4/basic-errors.html
index c414b74..f2ec5e0 100644
--- a/1.4/basic-errors.html
+++ b/1.4/basic-errors.html
@@ -1579,7 +1579,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/basic-feature.html b/1.4/basic-feature.html
index bea0a5e..6c20ddf 100644
--- a/1.4/basic-feature.html
+++ b/1.4/basic-feature.html
@@ -1763,7 +1763,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/basic-messages.html b/1.4/basic-messages.html
index 1581e42..7b5507b 100644
--- a/1.4/basic-messages.html
+++ b/1.4/basic-messages.html
@@ -1671,7 +1671,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/basic-metadata.html b/1.4/basic-metadata.html
index e630a26..ceeb458 100644
--- a/1.4/basic-metadata.html
+++ b/1.4/basic-metadata.html
@@ -1713,7 +1713,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/basic-namespaces-and-names.html b/1.4/basic-namespaces-and-names.html
index 4ac12dd..3788725 100644
--- a/1.4/basic-namespaces-and-names.html
+++ b/1.4/basic-namespaces-and-names.html
@@ -1606,7 +1606,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/basic-overview.html b/1.4/basic-overview.html
index d11d2b0..19bfc56 100644
--- a/1.4/basic-overview.html
+++ b/1.4/basic-overview.html
@@ -1675,7 +1675,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/basic-placeholders.html b/1.4/basic-placeholders.html
index e0052c1..cf92c74 100644
--- a/1.4/basic-placeholders.html
+++ b/1.4/basic-placeholders.html
@@ -1817,7 +1817,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/basic-policy.html b/1.4/basic-policy.html
index 9798694..827f5b9 100644
--- a/1.4/basic-policy.html
+++ b/1.4/basic-policy.html
@@ -1941,7 +1941,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/basic-rql.html b/1.4/basic-rql.html
index ffcce4b..5191bcc 100644
--- a/1.4/basic-rql.html
+++ b/1.4/basic-rql.html
@@ -1781,7 +1781,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/basic-search.html b/1.4/basic-search.html
index 44be0e7..b0ce064 100644
--- a/1.4/basic-search.html
+++ b/1.4/basic-search.html
@@ -1674,7 +1674,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/basic-signals-command.html b/1.4/basic-signals-command.html
index dd4075e..7c1e3d9 100644
--- a/1.4/basic-signals-command.html
+++ b/1.4/basic-signals-command.html
@@ -1560,7 +1560,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/basic-signals-commandresponse.html b/1.4/basic-signals-commandresponse.html
index 3e455ae..04a4dee 100644
--- a/1.4/basic-signals-commandresponse.html
+++ b/1.4/basic-signals-commandresponse.html
@@ -1540,7 +1540,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/basic-signals-errorresponse.html b/1.4/basic-signals-errorresponse.html
index 659e991..dc5ed2f 100644
--- a/1.4/basic-signals-errorresponse.html
+++ b/1.4/basic-signals-errorresponse.html
@@ -1544,7 +1544,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/basic-signals-event.html b/1.4/basic-signals-event.html
index 76e7582..0d97756 100644
--- a/1.4/basic-signals-event.html
+++ b/1.4/basic-signals-event.html
@@ -1546,7 +1546,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/basic-signals.html b/1.4/basic-signals.html
index 989c522..7ba9e45 100644
--- a/1.4/basic-signals.html
+++ b/1.4/basic-signals.html
@@ -1590,7 +1590,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/basic-thing.html b/1.4/basic-thing.html
index 62a91ef..233f208 100644
--- a/1.4/basic-thing.html
+++ b/1.4/basic-thing.html
@@ -1631,7 +1631,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/blog.html b/1.4/blog.html
index ac5d005..67a906f 100644
--- a/1.4/blog.html
+++ b/1.4/blog.html
@@ -393,7 +393,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/blog_archive.html b/1.4/blog_archive.html
index 40f36b8..c66c5bd 100644
--- a/1.4/blog_archive.html
+++ b/1.4/blog_archive.html
@@ -481,7 +481,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/client-sdk-java.html b/1.4/client-sdk-java.html
index 9684593..ce16372 100644
--- a/1.4/client-sdk-java.html
+++ b/1.4/client-sdk-java.html
@@ -1785,7 +1785,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/client-sdk-javascript.html b/1.4/client-sdk-javascript.html
index 5243728..ffbaf0b 100644
--- a/1.4/client-sdk-javascript.html
+++ b/1.4/client-sdk-javascript.html
@@ -1596,7 +1596,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/client-sdk-overview.html b/1.4/client-sdk-overview.html
index a185999..e5b07bc 100644
--- a/1.4/client-sdk-overview.html
+++ b/1.4/client-sdk-overview.html
@@ -1543,7 +1543,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/connectivity-header-mapping.html b/1.4/connectivity-header-mapping.html
index 4da2f5d..60fa247 100644
--- a/1.4/connectivity-header-mapping.html
+++ b/1.4/connectivity-header-mapping.html
@@ -1553,7 +1553,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/connectivity-manage-connections.html b/1.4/connectivity-manage-connections.html
index 2a2fe44..46854aa 100644
--- a/1.4/connectivity-manage-connections.html
+++ b/1.4/connectivity-manage-connections.html
@@ -1858,7 +1858,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/connectivity-mapping.html b/1.4/connectivity-mapping.html
index dcbece2..7041643 100644
--- a/1.4/connectivity-mapping.html
+++ b/1.4/connectivity-mapping.html
@@ -2464,7 +2464,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/connectivity-overview.html b/1.4/connectivity-overview.html
index bd20121..f4b1185 100644
--- a/1.4/connectivity-overview.html
+++ b/1.4/connectivity-overview.html
@@ -1555,7 +1555,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/connectivity-protocol-bindings-amqp091.html b/1.4/connectivity-protocol-bindings-amqp091.html
index b9b3d01..c97caed 100644
--- a/1.4/connectivity-protocol-bindings-amqp091.html
+++ b/1.4/connectivity-protocol-bindings-amqp091.html
@@ -1701,7 +1701,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/connectivity-protocol-bindings-amqp10.html b/1.4/connectivity-protocol-bindings-amqp10.html
index 1551552..144f245 100644
--- a/1.4/connectivity-protocol-bindings-amqp10.html
+++ b/1.4/connectivity-protocol-bindings-amqp10.html
@@ -1747,7 +1747,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/connectivity-protocol-bindings-http.html b/1.4/connectivity-protocol-bindings-http.html
index 6ed26a9..b9d9a6b 100644
--- a/1.4/connectivity-protocol-bindings-http.html
+++ b/1.4/connectivity-protocol-bindings-http.html
@@ -1754,7 +1754,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/connectivity-protocol-bindings-kafka2.html b/1.4/connectivity-protocol-bindings-kafka2.html
index e268742..b23c6fb 100644
--- a/1.4/connectivity-protocol-bindings-kafka2.html
+++ b/1.4/connectivity-protocol-bindings-kafka2.html
@@ -1679,7 +1679,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/connectivity-protocol-bindings-mqtt.html b/1.4/connectivity-protocol-bindings-mqtt.html
index 7b82b5c..784d136 100644
--- a/1.4/connectivity-protocol-bindings-mqtt.html
+++ b/1.4/connectivity-protocol-bindings-mqtt.html
@@ -1872,7 +1872,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/connectivity-protocol-bindings-mqtt5.html b/1.4/connectivity-protocol-bindings-mqtt5.html
index a355193..d541536 100644
--- a/1.4/connectivity-protocol-bindings-mqtt5.html
+++ b/1.4/connectivity-protocol-bindings-mqtt5.html
@@ -1880,7 +1880,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/connectivity-tls-certificates.html b/1.4/connectivity-tls-certificates.html
index 19666e6..f9dfd28 100644
--- a/1.4/connectivity-tls-certificates.html
+++ b/1.4/connectivity-tls-certificates.html
@@ -1651,7 +1651,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/feedback.html b/1.4/feedback.html
index c37cc14..5c14d6a 100644
--- a/1.4/feedback.html
+++ b/1.4/feedback.html
@@ -1555,7 +1555,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/glossary.html b/1.4/glossary.html
index f06ebe3..44d9dca 100644
--- a/1.4/glossary.html
+++ b/1.4/glossary.html
@@ -1543,7 +1543,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/http-api-doc.html b/1.4/http-api-doc.html
index 84bcfff..454ef27 100644
--- a/1.4/http-api-doc.html
+++ b/1.4/http-api-doc.html
@@ -201,7 +201,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/httpapi-concepts.html b/1.4/httpapi-concepts.html
index dca1633..df3f6f3 100644
--- a/1.4/httpapi-concepts.html
+++ b/1.4/httpapi-concepts.html
@@ -2129,7 +2129,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/httpapi-messages.html b/1.4/httpapi-messages.html
index 5ac80ae..c63a8e5 100644
--- a/1.4/httpapi-messages.html
+++ b/1.4/httpapi-messages.html
@@ -1631,7 +1631,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/httpapi-overview.html b/1.4/httpapi-overview.html
index 0d64d16..05319c2 100644
--- a/1.4/httpapi-overview.html
+++ b/1.4/httpapi-overview.html
@@ -1551,7 +1551,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/httpapi-protocol-bindings-websocket.html b/1.4/httpapi-protocol-bindings-websocket.html
index 2a80167..4e51ea7 100644
--- a/1.4/httpapi-protocol-bindings-websocket.html
+++ b/1.4/httpapi-protocol-bindings-websocket.html
@@ -1837,7 +1837,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/httpapi-search.html b/1.4/httpapi-search.html
index 5f9fc66..7579779 100644
--- a/1.4/httpapi-search.html
+++ b/1.4/httpapi-search.html
@@ -1598,7 +1598,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/httpapi-sse.html b/1.4/httpapi-sse.html
index 33fcad9..c0aa53f 100644
--- a/1.4/httpapi-sse.html
+++ b/1.4/httpapi-sse.html
@@ -1785,7 +1785,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/index.html b/1.4/index.html
index ec47e7f..e0b6937 100644
--- a/1.4/index.html
+++ b/1.4/index.html
@@ -265,7 +265,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/installation-building.html b/1.4/installation-building.html
index 7fc5b5d..5011756 100644
--- a/1.4/installation-building.html
+++ b/1.4/installation-building.html
@@ -1570,7 +1570,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/installation-operating.html b/1.4/installation-operating.html
index 9608456..5c5cbcf 100644
--- a/1.4/installation-operating.html
+++ b/1.4/installation-operating.html
@@ -2426,7 +2426,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/installation-running.html b/1.4/installation-running.html
index 8b8ad60..34b3076 100644
--- a/1.4/installation-running.html
+++ b/1.4/installation-running.html
@@ -1598,7 +1598,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/intro-digitaltwins.html b/1.4/intro-digitaltwins.html
index 8d65be5..9b89c3a 100644
--- a/1.4/intro-digitaltwins.html
+++ b/1.4/intro-digitaltwins.html
@@ -1573,7 +1573,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/intro-hello-world.html b/1.4/intro-hello-world.html
index b5ee9f5..e533efe 100644
--- a/1.4/intro-hello-world.html
+++ b/1.4/intro-hello-world.html
@@ -1662,7 +1662,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/intro-overview.html b/1.4/intro-overview.html
index 051393e..a7f88fe 100644
--- a/1.4/intro-overview.html
+++ b/1.4/intro-overview.html
@@ -1589,7 +1589,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/presentations.html b/1.4/presentations.html
index eb2a590..4e0b5ad 100644
--- a/1.4/presentations.html
+++ b/1.4/presentations.html
@@ -1583,7 +1583,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-bindings.html b/1.4/protocol-bindings.html
index 71e47ee..e9b99b5 100644
--- a/1.4/protocol-bindings.html
+++ b/1.4/protocol-bindings.html
@@ -1563,7 +1563,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-createattribute.html b/1.4/protocol-examples-createattribute.html
index 2d1b99e..cf8c0bd 100644
--- a/1.4/protocol-examples-createattribute.html
+++ b/1.4/protocol-examples-createattribute.html
@@ -1565,7 +1565,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-createattributes.html b/1.4/protocol-examples-createattributes.html
index 1041332..b341579 100644
--- a/1.4/protocol-examples-createattributes.html
+++ b/1.4/protocol-examples-createattributes.html
@@ -1570,7 +1570,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-createdefinition.html b/1.4/protocol-examples-createdefinition.html
index d9f43ff..f7460b4 100644
--- a/1.4/protocol-examples-createdefinition.html
+++ b/1.4/protocol-examples-createdefinition.html
@@ -1563,7 +1563,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-createfeature.html b/1.4/protocol-examples-createfeature.html
index 5ad2970..a59fdf1 100644
--- a/1.4/protocol-examples-createfeature.html
+++ b/1.4/protocol-examples-createfeature.html
@@ -1574,7 +1574,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-createfeatures.html b/1.4/protocol-examples-createfeatures.html
index 46fb30a..9360877 100644
--- a/1.4/protocol-examples-createfeatures.html
+++ b/1.4/protocol-examples-createfeatures.html
@@ -1578,7 +1578,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-createproperties.html b/1.4/protocol-examples-createproperties.html
index 6f5fd34..429eb54 100644
--- a/1.4/protocol-examples-createproperties.html
+++ b/1.4/protocol-examples-createproperties.html
@@ -1569,7 +1569,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-createproperty.html b/1.4/protocol-examples-createproperty.html
index 6f354bd..e600cf4 100644
--- a/1.4/protocol-examples-createproperty.html
+++ b/1.4/protocol-examples-createproperty.html
@@ -1559,7 +1559,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-creatething.html b/1.4/protocol-examples-creatething.html
index f50a2d7..17fa25a 100644
--- a/1.4/protocol-examples-creatething.html
+++ b/1.4/protocol-examples-creatething.html
@@ -1658,7 +1658,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-createthingdefinition.html b/1.4/protocol-examples-createthingdefinition.html
index 3cd60df..6db9d03 100644
--- a/1.4/protocol-examples-createthingdefinition.html
+++ b/1.4/protocol-examples-createthingdefinition.html
@@ -1560,7 +1560,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-deleteattribute.html b/1.4/protocol-examples-deleteattribute.html
index 61f0222..234e75d 100644
--- a/1.4/protocol-examples-deleteattribute.html
+++ b/1.4/protocol-examples-deleteattribute.html
@@ -1557,7 +1557,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-deleteattributes.html b/1.4/protocol-examples-deleteattributes.html
index af7f48e..b33b19d 100644
--- a/1.4/protocol-examples-deleteattributes.html
+++ b/1.4/protocol-examples-deleteattributes.html
@@ -1557,7 +1557,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-deletedefinition.html b/1.4/protocol-examples-deletedefinition.html
index 1372fe8..83d3e18 100644
--- a/1.4/protocol-examples-deletedefinition.html
+++ b/1.4/protocol-examples-deletedefinition.html
@@ -1557,7 +1557,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-deletefeature.html b/1.4/protocol-examples-deletefeature.html
index 33ee61a..4cca92d 100644
--- a/1.4/protocol-examples-deletefeature.html
+++ b/1.4/protocol-examples-deletefeature.html
@@ -1557,7 +1557,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-deletefeatures.html b/1.4/protocol-examples-deletefeatures.html
index 8383209..515c0a9 100644
--- a/1.4/protocol-examples-deletefeatures.html
+++ b/1.4/protocol-examples-deletefeatures.html
@@ -1557,7 +1557,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-deleteproperties.html b/1.4/protocol-examples-deleteproperties.html
index bf36b45..6a1b6b1 100644
--- a/1.4/protocol-examples-deleteproperties.html
+++ b/1.4/protocol-examples-deleteproperties.html
@@ -1557,7 +1557,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-deleteproperty.html b/1.4/protocol-examples-deleteproperty.html
index 11faa6d..60912c1 100644
--- a/1.4/protocol-examples-deleteproperty.html
+++ b/1.4/protocol-examples-deleteproperty.html
@@ -1557,7 +1557,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-deletething.html b/1.4/protocol-examples-deletething.html
index c721e1c..ba40a7f 100644
--- a/1.4/protocol-examples-deletething.html
+++ b/1.4/protocol-examples-deletething.html
@@ -1557,7 +1557,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-deletethingdefinition.html b/1.4/protocol-examples-deletethingdefinition.html
index 0355134..e2c4951 100644
--- a/1.4/protocol-examples-deletethingdefinition.html
+++ b/1.4/protocol-examples-deletethingdefinition.html
@@ -1557,7 +1557,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-errorresponses.html b/1.4/protocol-examples-errorresponses.html
index 1cbae75..3ce3369 100644
--- a/1.4/protocol-examples-errorresponses.html
+++ b/1.4/protocol-examples-errorresponses.html
@@ -1992,7 +1992,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-modifyattribute.html b/1.4/protocol-examples-modifyattribute.html
index a12a8f4..19ede97 100644
--- a/1.4/protocol-examples-modifyattribute.html
+++ b/1.4/protocol-examples-modifyattribute.html
@@ -1565,7 +1565,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-modifyattributes.html b/1.4/protocol-examples-modifyattributes.html
index 1782b16..9153fac 100644
--- a/1.4/protocol-examples-modifyattributes.html
+++ b/1.4/protocol-examples-modifyattributes.html
@@ -1570,7 +1570,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-modifydefinition.html b/1.4/protocol-examples-modifydefinition.html
index 92ebcd4..89b71ac 100644
--- a/1.4/protocol-examples-modifydefinition.html
+++ b/1.4/protocol-examples-modifydefinition.html
@@ -1563,7 +1563,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-modifyfeature.html b/1.4/protocol-examples-modifyfeature.html
index 2abc2ba..d7aa42f 100644
--- a/1.4/protocol-examples-modifyfeature.html
+++ b/1.4/protocol-examples-modifyfeature.html
@@ -1574,7 +1574,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-modifyfeatures.html b/1.4/protocol-examples-modifyfeatures.html
index 3278d00..df19972 100644
--- a/1.4/protocol-examples-modifyfeatures.html
+++ b/1.4/protocol-examples-modifyfeatures.html
@@ -1578,7 +1578,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-modifypolicyid.html b/1.4/protocol-examples-modifypolicyid.html
index 3b6a706..ca0dee6 100644
--- a/1.4/protocol-examples-modifypolicyid.html
+++ b/1.4/protocol-examples-modifypolicyid.html
@@ -1581,7 +1581,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-modifyproperties.html b/1.4/protocol-examples-modifyproperties.html
index ab64c5d..29cc554 100644
--- a/1.4/protocol-examples-modifyproperties.html
+++ b/1.4/protocol-examples-modifyproperties.html
@@ -1569,7 +1569,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-modifyproperty.html b/1.4/protocol-examples-modifyproperty.html
index fac13f2..19e5645 100644
--- a/1.4/protocol-examples-modifyproperty.html
+++ b/1.4/protocol-examples-modifyproperty.html
@@ -1559,7 +1559,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-modifything.html b/1.4/protocol-examples-modifything.html
index 7aaa8a3..fac3d67 100644
--- a/1.4/protocol-examples-modifything.html
+++ b/1.4/protocol-examples-modifything.html
@@ -1639,7 +1639,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-modifythingdefinition.html b/1.4/protocol-examples-modifythingdefinition.html
index 02f1b9d..01969f7 100644
--- a/1.4/protocol-examples-modifythingdefinition.html
+++ b/1.4/protocol-examples-modifythingdefinition.html
@@ -1559,7 +1559,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-policies-createpolicy.html b/1.4/protocol-examples-policies-createpolicy.html
index b2623c3..58ef660 100644
--- a/1.4/protocol-examples-policies-createpolicy.html
+++ b/1.4/protocol-examples-policies-createpolicy.html
@@ -1593,7 +1593,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-policies-createpolicyentry.html b/1.4/protocol-examples-policies-createpolicyentry.html
index d0807db..4d98270 100644
--- a/1.4/protocol-examples-policies-createpolicyentry.html
+++ b/1.4/protocol-examples-policies-createpolicyentry.html
@@ -1569,7 +1569,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-policies-createresource.html b/1.4/protocol-examples-policies-createresource.html
index ba2211f..326773d 100644
--- a/1.4/protocol-examples-policies-createresource.html
+++ b/1.4/protocol-examples-policies-createresource.html
@@ -1558,7 +1558,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-policies-createsubject.html b/1.4/protocol-examples-policies-createsubject.html
index 7084cc9..14e5fb9 100644
--- a/1.4/protocol-examples-policies-createsubject.html
+++ b/1.4/protocol-examples-policies-createsubject.html
@@ -1554,7 +1554,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-policies-deletepolicy.html b/1.4/protocol-examples-policies-deletepolicy.html
index eaf4f13..f609856 100644
--- a/1.4/protocol-examples-policies-deletepolicy.html
+++ b/1.4/protocol-examples-policies-deletepolicy.html
@@ -1551,7 +1551,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-policies-deletepolicyentry.html b/1.4/protocol-examples-policies-deletepolicyentry.html
index 9cffd82..c8f8f47 100644
--- a/1.4/protocol-examples-policies-deletepolicyentry.html
+++ b/1.4/protocol-examples-policies-deletepolicyentry.html
@@ -1551,7 +1551,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-policies-deleteresource.html b/1.4/protocol-examples-policies-deleteresource.html
index 6cc86d5..89cd2b2 100644
--- a/1.4/protocol-examples-policies-deleteresource.html
+++ b/1.4/protocol-examples-policies-deleteresource.html
@@ -1551,7 +1551,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-policies-deletesubject.html b/1.4/protocol-examples-policies-deletesubject.html
index 6f7f8a3..1bef2f8 100644
--- a/1.4/protocol-examples-policies-deletesubject.html
+++ b/1.4/protocol-examples-policies-deletesubject.html
@@ -1551,7 +1551,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-policies-errorresponses.html b/1.4/protocol-examples-policies-errorresponses.html
index 18d8dd6..74d203c 100644
--- a/1.4/protocol-examples-policies-errorresponses.html
+++ b/1.4/protocol-examples-policies-errorresponses.html
@@ -1889,7 +1889,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-policies-modifypolicy.html b/1.4/protocol-examples-policies-modifypolicy.html
index d48b15d..3aaf273 100644
--- a/1.4/protocol-examples-policies-modifypolicy.html
+++ b/1.4/protocol-examples-policies-modifypolicy.html
@@ -1572,7 +1572,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-policies-modifypolicyentries.html b/1.4/protocol-examples-policies-modifypolicyentries.html
index c32c4ab..9b16c17 100644
--- a/1.4/protocol-examples-policies-modifypolicyentries.html
+++ b/1.4/protocol-examples-policies-modifypolicyentries.html
@@ -1591,7 +1591,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-policies-modifypolicyentry.html b/1.4/protocol-examples-policies-modifypolicyentry.html
index 3d83e34..41419dd 100644
--- a/1.4/protocol-examples-policies-modifypolicyentry.html
+++ b/1.4/protocol-examples-policies-modifypolicyentry.html
@@ -1569,7 +1569,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-policies-modifyresource.html b/1.4/protocol-examples-policies-modifyresource.html
index e1cdfbf..bb2d2d8 100644
--- a/1.4/protocol-examples-policies-modifyresource.html
+++ b/1.4/protocol-examples-policies-modifyresource.html
@@ -1558,7 +1558,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-policies-modifyresources.html b/1.4/protocol-examples-policies-modifyresources.html
index 086e6fa..b1fd35e 100644
--- a/1.4/protocol-examples-policies-modifyresources.html
+++ b/1.4/protocol-examples-policies-modifyresources.html
@@ -1561,7 +1561,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-policies-modifysubject.html b/1.4/protocol-examples-policies-modifysubject.html
index 6b92ae4..b1b2465 100644
--- a/1.4/protocol-examples-policies-modifysubject.html
+++ b/1.4/protocol-examples-policies-modifysubject.html
@@ -1554,7 +1554,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-policies-modifysubjects.html b/1.4/protocol-examples-policies-modifysubjects.html
index bb74566..81e5a10 100644
--- a/1.4/protocol-examples-policies-modifysubjects.html
+++ b/1.4/protocol-examples-policies-modifysubjects.html
@@ -1557,7 +1557,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-policies-retrievepolicy.html b/1.4/protocol-examples-policies-retrievepolicy.html
index 35f9e70..680d7a3 100644
--- a/1.4/protocol-examples-policies-retrievepolicy.html
+++ b/1.4/protocol-examples-policies-retrievepolicy.html
@@ -1572,7 +1572,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-policies-retrievepolicyentries.html b/1.4/protocol-examples-policies-retrievepolicyentries.html
index 156bf32..eb6673e 100644
--- a/1.4/protocol-examples-policies-retrievepolicyentries.html
+++ b/1.4/protocol-examples-policies-retrievepolicyentries.html
@@ -1585,7 +1585,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-policies-retrievepolicyentry.html b/1.4/protocol-examples-policies-retrievepolicyentry.html
index a71a4fa..4f5b9d0 100644
--- a/1.4/protocol-examples-policies-retrievepolicyentry.html
+++ b/1.4/protocol-examples-policies-retrievepolicyentry.html
@@ -1567,7 +1567,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-policies-retrieveresource.html b/1.4/protocol-examples-policies-retrieveresource.html
index cfd9d48..4d80d13 100644
--- a/1.4/protocol-examples-policies-retrieveresource.html
+++ b/1.4/protocol-examples-policies-retrieveresource.html
@@ -1558,7 +1558,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-policies-retrieveresources.html b/1.4/protocol-examples-policies-retrieveresources.html
index 327916d..96d8526 100644
--- a/1.4/protocol-examples-policies-retrieveresources.html
+++ b/1.4/protocol-examples-policies-retrieveresources.html
@@ -1560,7 +1560,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-policies-retrievesubject.html b/1.4/protocol-examples-policies-retrievesubject.html
index 3f8bcc3..dd1cacc 100644
--- a/1.4/protocol-examples-policies-retrievesubject.html
+++ b/1.4/protocol-examples-policies-retrievesubject.html
@@ -1554,7 +1554,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-policies-retrievesubjects.html b/1.4/protocol-examples-policies-retrievesubjects.html
index 5b02bef..dde3ff9 100644
--- a/1.4/protocol-examples-policies-retrievesubjects.html
+++ b/1.4/protocol-examples-policies-retrievesubjects.html
@@ -1556,7 +1556,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-retrieveattribute.html b/1.4/protocol-examples-retrieveattribute.html
index 7608a7b..ee5112c 100644
--- a/1.4/protocol-examples-retrieveattribute.html
+++ b/1.4/protocol-examples-retrieveattribute.html
@@ -1551,7 +1551,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-retrieveattributes.html b/1.4/protocol-examples-retrieveattributes.html
index dc53f41..d42359c 100644
--- a/1.4/protocol-examples-retrieveattributes.html
+++ b/1.4/protocol-examples-retrieveattributes.html
@@ -1553,7 +1553,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-retrievedefinition.html b/1.4/protocol-examples-retrievedefinition.html
index 9148cb4..a83ee10 100644
--- a/1.4/protocol-examples-retrievedefinition.html
+++ b/1.4/protocol-examples-retrievedefinition.html
@@ -1550,7 +1550,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-retrievefeature.html b/1.4/protocol-examples-retrievefeature.html
index 5c0b979..4229512 100644
--- a/1.4/protocol-examples-retrievefeature.html
+++ b/1.4/protocol-examples-retrievefeature.html
@@ -1555,7 +1555,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-retrievefeatures.html b/1.4/protocol-examples-retrievefeatures.html
index c87ef0f..da6cf88 100644
--- a/1.4/protocol-examples-retrievefeatures.html
+++ b/1.4/protocol-examples-retrievefeatures.html
@@ -1557,7 +1557,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-retrieveproperties.html b/1.4/protocol-examples-retrieveproperties.html
index 4c15f84..f359a62 100644
--- a/1.4/protocol-examples-retrieveproperties.html
+++ b/1.4/protocol-examples-retrieveproperties.html
@@ -1553,7 +1553,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-retrieveproperty.html b/1.4/protocol-examples-retrieveproperty.html
index f2b2b48..62de5e1 100644
--- a/1.4/protocol-examples-retrieveproperty.html
+++ b/1.4/protocol-examples-retrieveproperty.html
@@ -1548,7 +1548,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-retrievething.html b/1.4/protocol-examples-retrievething.html
index a544636..1163462 100644
--- a/1.4/protocol-examples-retrievething.html
+++ b/1.4/protocol-examples-retrievething.html
@@ -1577,7 +1577,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-retrievethingdefinition.html b/1.4/protocol-examples-retrievethingdefinition.html
index ca19a84..c4cc4e4 100644
--- a/1.4/protocol-examples-retrievethingdefinition.html
+++ b/1.4/protocol-examples-retrievethingdefinition.html
@@ -1548,7 +1548,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-retrievethings.html b/1.4/protocol-examples-retrievethings.html
index 2477d2a..ca4f97e 100644
--- a/1.4/protocol-examples-retrievethings.html
+++ b/1.4/protocol-examples-retrievethings.html
@@ -1574,7 +1574,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples-search.html b/1.4/protocol-examples-search.html
index ab7e2ec..393dd25 100644
--- a/1.4/protocol-examples-search.html
+++ b/1.4/protocol-examples-search.html
@@ -1652,7 +1652,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-examples.html b/1.4/protocol-examples.html
index e4bd9eb..4de6c62 100644
--- a/1.4/protocol-examples.html
+++ b/1.4/protocol-examples.html
@@ -1634,7 +1634,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-overview.html b/1.4/protocol-overview.html
index 704be5a..f01cdb2 100644
--- a/1.4/protocol-overview.html
+++ b/1.4/protocol-overview.html
@@ -1550,7 +1550,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-specification-acks.html b/1.4/protocol-specification-acks.html
index 14276f4..6207ed3 100644
--- a/1.4/protocol-specification-acks.html
+++ b/1.4/protocol-specification-acks.html
@@ -1574,7 +1574,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-specification-errors.html b/1.4/protocol-specification-errors.html
index dfaa58f..a3a9a43 100644
--- a/1.4/protocol-specification-errors.html
+++ b/1.4/protocol-specification-errors.html
@@ -1543,7 +1543,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-specification-policies-create-or-modify.html b/1.4/protocol-specification-policies-create-or-modify.html
index caa6e5f..65d87cc 100644
--- a/1.4/protocol-specification-policies-create-or-modify.html
+++ b/1.4/protocol-specification-policies-create-or-modify.html
@@ -2152,7 +2152,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-specification-policies-delete.html b/1.4/protocol-specification-policies-delete.html
index 8bf1698..d849756 100644
--- a/1.4/protocol-specification-policies-delete.html
+++ b/1.4/protocol-specification-policies-delete.html
@@ -1822,7 +1822,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-specification-policies-retrieve.html b/1.4/protocol-specification-policies-retrieve.html
index fc2af69..eec6dc4 100644
--- a/1.4/protocol-specification-policies-retrieve.html
+++ b/1.4/protocol-specification-policies-retrieve.html
@@ -2045,7 +2045,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-specification-policies.html b/1.4/protocol-specification-policies.html
index 00ca4e6..f975a4f 100644
--- a/1.4/protocol-specification-policies.html
+++ b/1.4/protocol-specification-policies.html
@@ -1632,7 +1632,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-specification-things-create-or-modify.html b/1.4/protocol-specification-things-create-or-modify.html
index 81fe448..8568488 100644
--- a/1.4/protocol-specification-things-create-or-modify.html
+++ b/1.4/protocol-specification-things-create-or-modify.html
@@ -2952,7 +2952,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-specification-things-delete.html b/1.4/protocol-specification-things-delete.html
index 9b35cb4..1abdcb3 100644
--- a/1.4/protocol-specification-things-delete.html
+++ b/1.4/protocol-specification-things-delete.html
@@ -2439,7 +2439,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-specification-things-messages.html b/1.4/protocol-specification-things-messages.html
index 06aa865..719881d 100644
--- a/1.4/protocol-specification-things-messages.html
+++ b/1.4/protocol-specification-things-messages.html
@@ -1794,7 +1794,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-specification-things-retrieve.html b/1.4/protocol-specification-things-retrieve.html
index 60ffb1d..2d06e78 100644
--- a/1.4/protocol-specification-things-retrieve.html
+++ b/1.4/protocol-specification-things-retrieve.html
@@ -2330,7 +2330,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-specification-things-search.html b/1.4/protocol-specification-things-search.html
index f7c71ea..ef7229b 100644
--- a/1.4/protocol-specification-things-search.html
+++ b/1.4/protocol-specification-things-search.html
@@ -1898,7 +1898,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-specification-things.html b/1.4/protocol-specification-things.html
index a8fad1b..5b9d1d2 100644
--- a/1.4/protocol-specification-things.html
+++ b/1.4/protocol-specification-things.html
@@ -1603,7 +1603,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-specification-topic.html b/1.4/protocol-specification-topic.html
index 22e893b..59e31e8 100644
--- a/1.4/protocol-specification-topic.html
+++ b/1.4/protocol-specification-topic.html
@@ -1708,7 +1708,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-specification.html b/1.4/protocol-specification.html
index 5d6a9f4..6bd82bc 100644
--- a/1.4/protocol-specification.html
+++ b/1.4/protocol-specification.html
@@ -1698,7 +1698,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/protocol-twinlive.html b/1.4/protocol-twinlive.html
index 0105ea0..0104abe 100644
--- a/1.4/protocol-twinlive.html
+++ b/1.4/protocol-twinlive.html
@@ -1561,7 +1561,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/release_notes_010-M1.html b/1.4/release_notes_010-M1.html
index 37f19ed..85cef53 100644
--- a/1.4/release_notes_010-M1.html
+++ b/1.4/release_notes_010-M1.html
@@ -1540,7 +1540,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/release_notes_010-M3.html b/1.4/release_notes_010-M3.html
index bba2726..d8f6d8d 100644
--- a/1.4/release_notes_010-M3.html
+++ b/1.4/release_notes_010-M3.html
@@ -1596,7 +1596,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/release_notes_020-M1.html b/1.4/release_notes_020-M1.html
index bb7e0f7..88e0e5d 100644
--- a/1.4/release_notes_020-M1.html
+++ b/1.4/release_notes_020-M1.html
@@ -1581,7 +1581,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/release_notes_030-M1.html b/1.4/release_notes_030-M1.html
index 154489b..16f8de9 100644
--- a/1.4/release_notes_030-M1.html
+++ b/1.4/release_notes_030-M1.html
@@ -1592,7 +1592,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/release_notes_030-M2.html b/1.4/release_notes_030-M2.html
index f30a8ee..1a47bb9 100644
--- a/1.4/release_notes_030-M2.html
+++ b/1.4/release_notes_030-M2.html
@@ -1589,7 +1589,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/release_notes_080-M1.html b/1.4/release_notes_080-M1.html
index 8258ee6..0166325 100644
--- a/1.4/release_notes_080-M1.html
+++ b/1.4/release_notes_080-M1.html
@@ -1611,7 +1611,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/release_notes_080-M2.html b/1.4/release_notes_080-M2.html
index 7587431..998f49f 100644
--- a/1.4/release_notes_080-M2.html
+++ b/1.4/release_notes_080-M2.html
@@ -1595,7 +1595,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/release_notes_080-M3.html b/1.4/release_notes_080-M3.html
index 8a8ec96..0627e3a 100644
--- a/1.4/release_notes_080-M3.html
+++ b/1.4/release_notes_080-M3.html
@@ -1599,7 +1599,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/release_notes_080.html b/1.4/release_notes_080.html
index 2630758..9eab7f0 100644
--- a/1.4/release_notes_080.html
+++ b/1.4/release_notes_080.html
@@ -1605,7 +1605,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/release_notes_090-M1.html b/1.4/release_notes_090-M1.html
index b95b167..a8860e4 100644
--- a/1.4/release_notes_090-M1.html
+++ b/1.4/release_notes_090-M1.html
@@ -1577,7 +1577,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/release_notes_090-M2.html b/1.4/release_notes_090-M2.html
index 0e71f54..baa3baf 100644
--- a/1.4/release_notes_090-M2.html
+++ b/1.4/release_notes_090-M2.html
@@ -1578,7 +1578,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/release_notes_090.html b/1.4/release_notes_090.html
index c07e0c7..d422bdc 100644
--- a/1.4/release_notes_090.html
+++ b/1.4/release_notes_090.html
@@ -1635,7 +1635,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/release_notes_100-M1a.html b/1.4/release_notes_100-M1a.html
index beaa6b7..0c8eb13 100644
--- a/1.4/release_notes_100-M1a.html
+++ b/1.4/release_notes_100-M1a.html
@@ -1596,7 +1596,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/release_notes_100-M2.html b/1.4/release_notes_100-M2.html
index 42808da..ec42e17 100644
--- a/1.4/release_notes_100-M2.html
+++ b/1.4/release_notes_100-M2.html
@@ -1613,7 +1613,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/release_notes_100.html b/1.4/release_notes_100.html
index c77df1b..f74e274 100644
--- a/1.4/release_notes_100.html
+++ b/1.4/release_notes_100.html
@@ -1616,7 +1616,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/release_notes_110.html b/1.4/release_notes_110.html
index c03803f..a4bf41a 100644
--- a/1.4/release_notes_110.html
+++ b/1.4/release_notes_110.html
@@ -1657,7 +1657,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/release_notes_111.html b/1.4/release_notes_111.html
index 4f8f2bf..3f19f6f 100644
--- a/1.4/release_notes_111.html
+++ b/1.4/release_notes_111.html
@@ -1555,7 +1555,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/release_notes_112.html b/1.4/release_notes_112.html
index 10d7962..36d2d07 100644
--- a/1.4/release_notes_112.html
+++ b/1.4/release_notes_112.html
@@ -1571,7 +1571,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/release_notes_113.html b/1.4/release_notes_113.html
index f5b87c7..0e3c929 100644
--- a/1.4/release_notes_113.html
+++ b/1.4/release_notes_113.html
@@ -1571,7 +1571,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/release_notes_115.html b/1.4/release_notes_115.html
index 62b8195..871a1ac 100644
--- a/1.4/release_notes_115.html
+++ b/1.4/release_notes_115.html
@@ -1559,7 +1559,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/release_notes_120.html b/1.4/release_notes_120.html
index 6f50908..92f0a4d 100644
--- a/1.4/release_notes_120.html
+++ b/1.4/release_notes_120.html
@@ -1631,7 +1631,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/release_notes_121.html b/1.4/release_notes_121.html
index caaf179..1ca5518 100644
--- a/1.4/release_notes_121.html
+++ b/1.4/release_notes_121.html
@@ -1558,7 +1558,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/release_notes_130.html b/1.4/release_notes_130.html
index 3d31fce..c3d187b 100644
--- a/1.4/release_notes_130.html
+++ b/1.4/release_notes_130.html
@@ -1648,7 +1648,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/release_notes_140.html b/1.4/release_notes_140.html
index 7831650..60f9776 100644
--- a/1.4/release_notes_140.html
+++ b/1.4/release_notes_140.html
@@ -1625,7 +1625,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/sandbox.html b/1.4/sandbox.html
index 000a02b..2a69e09 100644
--- a/1.4/sandbox.html
+++ b/1.4/sandbox.html
@@ -1594,7 +1594,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/tag_architecture.html b/1.4/tag_architecture.html
index 7fa69ed..4805ccd 100644
--- a/1.4/tag_architecture.html
+++ b/1.4/tag_architecture.html
@@ -2355,7 +2355,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/tag_blog.html b/1.4/tag_blog.html
index a6dcdbb..e914f89 100644
--- a/1.4/tag_blog.html
+++ b/1.4/tag_blog.html
@@ -2511,7 +2511,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/tag_client_sdk.html b/1.4/tag_client_sdk.html
index 9aeeec7..0366a27 100644
--- a/1.4/tag_client_sdk.html
+++ b/1.4/tag_client_sdk.html
@@ -2341,7 +2341,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/tag_connectivity.html b/1.4/tag_connectivity.html
index 02ba0d5..066475e 100644
--- a/1.4/tag_connectivity.html
+++ b/1.4/tag_connectivity.html
@@ -2427,7 +2427,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/tag_getting_started.html b/1.4/tag_getting_started.html
index 66ebac8..2d665ac 100644
--- a/1.4/tag_getting_started.html
+++ b/1.4/tag_getting_started.html
@@ -2355,7 +2355,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/tag_http.html b/1.4/tag_http.html
index 0eec6fb..efee362 100644
--- a/1.4/tag_http.html
+++ b/1.4/tag_http.html
@@ -2349,7 +2349,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/tag_installation.html b/1.4/tag_installation.html
index ff9bd4f..4250a06 100644
--- a/1.4/tag_installation.html
+++ b/1.4/tag_installation.html
@@ -2331,7 +2331,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/tag_model.html b/1.4/tag_model.html
index 0bc6491..c9ad081 100644
--- a/1.4/tag_model.html
+++ b/1.4/tag_model.html
@@ -2391,7 +2391,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/tag_news.html b/1.4/tag_news.html
index 70f1ec5..db0cafd 100644
--- a/1.4/tag_news.html
+++ b/1.4/tag_news.html
@@ -2313,7 +2313,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/tag_protocol.html b/1.4/tag_protocol.html
index 5c8e030..f6c36d9 100644
--- a/1.4/tag_protocol.html
+++ b/1.4/tag_protocol.html
@@ -2483,7 +2483,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/tag_release_notes.html b/1.4/tag_release_notes.html
index dfe9bd7..7ae5152 100644
--- a/1.4/tag_release_notes.html
+++ b/1.4/tag_release_notes.html
@@ -2457,7 +2457,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/tag_rql.html b/1.4/tag_rql.html
index a48c0ad..ce5172d 100644
--- a/1.4/tag_rql.html
+++ b/1.4/tag_rql.html
@@ -2379,7 +2379,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/tag_search.html b/1.4/tag_search.html
index 46098d8..10fbbd1 100644
--- a/1.4/tag_search.html
+++ b/1.4/tag_search.html
@@ -2349,7 +2349,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/tag_signal.html b/1.4/tag_signal.html
index a16ed72..7414b3d 100644
--- a/1.4/tag_signal.html
+++ b/1.4/tag_signal.html
@@ -2348,7 +2348,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.4/tag_troubleshooting.html b/1.4/tag_troubleshooting.html
index 5f5d8ae..271b592 100644
--- a/1.4/tag_troubleshooting.html
+++ b/1.4/tag_troubleshooting.html
@@ -2319,7 +2319,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Feb 22, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2017-11-10-welcome-to-ditto.html b/1.5/2017-11-10-welcome-to-ditto.html
index f7d8aa2..27b0efb 100644
--- a/1.5/2017-11-10-welcome-to-ditto.html
+++ b/1.5/2017-11-10-welcome-to-ditto.html
@@ -264,7 +264,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2017-12-18-milestone-announcement-010-M1.html b/1.5/2017-12-18-milestone-announcement-010-M1.html
index d4009f9..0db8ce5 100644
--- a/1.5/2017-12-18-milestone-announcement-010-M1.html
+++ b/1.5/2017-12-18-milestone-announcement-010-M1.html
@@ -268,7 +268,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2018-01-12-milestone-announcement-010-M3.html b/1.5/2018-01-12-milestone-announcement-010-M3.html
index 96c6e9e..149de71 100644
--- a/1.5/2018-01-12-milestone-announcement-010-M3.html
+++ b/1.5/2018-01-12-milestone-announcement-010-M3.html
@@ -287,7 +287,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2018-01-15-example-demonstrating-rest-to-websocket.html b/1.5/2018-01-15-example-demonstrating-rest-to-websocket.html
index 486f493..d504047 100644
--- a/1.5/2018-01-15-example-demonstrating-rest-to-websocket.html
+++ b/1.5/2018-01-15-example-demonstrating-rest-to-websocket.html
@@ -276,7 +276,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2018-02-07-milestone-announcement-020-M1.html b/1.5/2018-02-07-milestone-announcement-020-M1.html
index fc34074..7b55b54 100644
--- a/1.5/2018-02-07-milestone-announcement-020-M1.html
+++ b/1.5/2018-02-07-milestone-announcement-020-M1.html
@@ -288,7 +288,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2018-02-08-feature-definition.html b/1.5/2018-02-08-feature-definition.html
index 92f6ae8..36d228d 100644
--- a/1.5/2018-02-08-feature-definition.html
+++ b/1.5/2018-02-08-feature-definition.html
@@ -318,7 +318,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2018-04-25-connectivity-service.html b/1.5/2018-04-25-connectivity-service.html
index a657d8f..3bf93d5 100644
--- a/1.5/2018-04-25-connectivity-service.html
+++ b/1.5/2018-04-25-connectivity-service.html
@@ -332,7 +332,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2018-04-26-milestone-announcement-030-M1.html b/1.5/2018-04-26-milestone-announcement-030-M1.html
index 3aa3e36..32850b1 100644
--- a/1.5/2018-04-26-milestone-announcement-030-M1.html
+++ b/1.5/2018-04-26-milestone-announcement-030-M1.html
@@ -284,7 +284,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2018-05-02-connecting-ditto-hono.html b/1.5/2018-05-02-connecting-ditto-hono.html
index 1bb19ea..a1a6b67 100644
--- a/1.5/2018-05-02-connecting-ditto-hono.html
+++ b/1.5/2018-05-02-connecting-ditto-hono.html
@@ -1006,7 +1006,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2018-06-15-milestone-announcement-030-M2.html b/1.5/2018-06-15-milestone-announcement-030-M2.html
index 8ffb91f..d049748 100644
--- a/1.5/2018-06-15-milestone-announcement-030-M2.html
+++ b/1.5/2018-06-15-milestone-announcement-030-M2.html
@@ -284,7 +284,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2018-08-14-milestone-announcement-080-M1.html b/1.5/2018-08-14-milestone-announcement-080-M1.html
index 9770ed5..f29e32b 100644
--- a/1.5/2018-08-14-milestone-announcement-080-M1.html
+++ b/1.5/2018-08-14-milestone-announcement-080-M1.html
@@ -284,7 +284,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2018-09-21-selective-push-notifications.html b/1.5/2018-09-21-selective-push-notifications.html
index 7b679f1..c3d1db8 100644
--- a/1.5/2018-09-21-selective-push-notifications.html
+++ b/1.5/2018-09-21-selective-push-notifications.html
@@ -484,7 +484,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2018-09-27-milestone-announcement-080-M2.html b/1.5/2018-09-27-milestone-announcement-080-M2.html
index c2810ba..51d795c 100644
--- a/1.5/2018-09-27-milestone-announcement-080-M2.html
+++ b/1.5/2018-09-27-milestone-announcement-080-M2.html
@@ -286,7 +286,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2018-10-16-example-mqtt-bidirectional.html b/1.5/2018-10-16-example-mqtt-bidirectional.html
index 8f6e01a..5751e45 100644
--- a/1.5/2018-10-16-example-mqtt-bidirectional.html
+++ b/1.5/2018-10-16-example-mqtt-bidirectional.html
@@ -292,7 +292,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2018-11-14-milestone-announcement-080-M3.html b/1.5/2018-11-14-milestone-announcement-080-M3.html
index 8ff4560..f66a65e 100644
--- a/1.5/2018-11-14-milestone-announcement-080-M3.html
+++ b/1.5/2018-11-14-milestone-announcement-080-M3.html
@@ -285,7 +285,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2018-11-28-release-announcement-080.html b/1.5/2018-11-28-release-announcement-080.html
index de75e46..fe69acc 100644
--- a/1.5/2018-11-28-release-announcement-080.html
+++ b/1.5/2018-11-28-release-announcement-080.html
@@ -280,7 +280,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2018-12-05-example-command-and-control.html b/1.5/2018-12-05-example-command-and-control.html
index 14677a9..0950ca1 100644
--- a/1.5/2018-12-05-example-command-and-control.html
+++ b/1.5/2018-12-05-example-command-and-control.html
@@ -519,7 +519,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2019-03-13-kafka-connectivity.html b/1.5/2019-03-13-kafka-connectivity.html
index 59bc189..5bbd8ab 100644
--- a/1.5/2019-03-13-kafka-connectivity.html
+++ b/1.5/2019-03-13-kafka-connectivity.html
@@ -266,7 +266,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2019-03-28-milestone-announcement-090-M1.html b/1.5/2019-03-28-milestone-announcement-090-M1.html
index 1befaeb..535b6bb 100644
--- a/1.5/2019-03-28-milestone-announcement-090-M1.html
+++ b/1.5/2019-03-28-milestone-announcement-090-M1.html
@@ -282,7 +282,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2019-04-29-milestone-announcement-090-M2.html b/1.5/2019-04-29-milestone-announcement-090-M2.html
index b617fb3..60b5ee5 100644
--- a/1.5/2019-04-29-milestone-announcement-090-M2.html
+++ b/1.5/2019-04-29-milestone-announcement-090-M2.html
@@ -280,7 +280,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2019-07-10-release-announcement-090.html b/1.5/2019-07-10-release-announcement-090.html
index 11363d4..d90f6bd 100644
--- a/1.5/2019-07-10-release-announcement-090.html
+++ b/1.5/2019-07-10-release-announcement-090.html
@@ -286,7 +286,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2019-08-28-openid-connect.html b/1.5/2019-08-28-openid-connect.html
index 1fd8b12..a4870ab 100644
--- a/1.5/2019-08-28-openid-connect.html
+++ b/1.5/2019-08-28-openid-connect.html
@@ -332,7 +332,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2019-09-17-milestone-announcement-100-M1a.html b/1.5/2019-09-17-milestone-announcement-100-M1a.html
index 24eb1b7..0055d5f 100644
--- a/1.5/2019-09-17-milestone-announcement-100-M1a.html
+++ b/1.5/2019-09-17-milestone-announcement-100-M1a.html
@@ -283,7 +283,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2019-10-17-http-connectivity.html b/1.5/2019-10-17-http-connectivity.html
index aa83a43..247e021 100644
--- a/1.5/2019-10-17-http-connectivity.html
+++ b/1.5/2019-10-17-http-connectivity.html
@@ -291,7 +291,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2019-11-04-milestone-announcement-100-M2.html b/1.5/2019-11-04-milestone-announcement-100-M2.html
index 3dbb7cd..5fd13f6 100644
--- a/1.5/2019-11-04-milestone-announcement-100-M2.html
+++ b/1.5/2019-11-04-milestone-announcement-100-M2.html
@@ -282,7 +282,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2019-12-12-release-announcement-100.html b/1.5/2019-12-12-release-announcement-100.html
index 4f1e501..e400156 100644
--- a/1.5/2019-12-12-release-announcement-100.html
+++ b/1.5/2019-12-12-release-announcement-100.html
@@ -331,7 +331,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2020-04-16-connecting-to-ttn-via-mqtt.html b/1.5/2020-04-16-connecting-to-ttn-via-mqtt.html
index 00e152c..293e9d7 100644
--- a/1.5/2020-04-16-connecting-to-ttn-via-mqtt.html
+++ b/1.5/2020-04-16-connecting-to-ttn-via-mqtt.html
@@ -778,7 +778,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2020-04-29-release-announcement-110.html b/1.5/2020-04-29-release-announcement-110.html
index d12abcc..96a6a0d 100644
--- a/1.5/2020-04-29-release-announcement-110.html
+++ b/1.5/2020-04-29-release-announcement-110.html
@@ -312,7 +312,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2020-08-31-release-announcement-120.html b/1.5/2020-08-31-release-announcement-120.html
index 47593e0..a6f0db1 100644
--- a/1.5/2020-08-31-release-announcement-120.html
+++ b/1.5/2020-08-31-release-announcement-120.html
@@ -290,7 +290,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2020-09-30-release-announcement-130.html b/1.5/2020-09-30-release-announcement-130.html
index b8907e9..c9a6fc5 100644
--- a/1.5/2020-09-30-release-announcement-130.html
+++ b/1.5/2020-09-30-release-announcement-130.html
@@ -290,7 +290,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2020-10-08-asynchronous-client-creation.html b/1.5/2020-10-08-asynchronous-client-creation.html
index fe120bb..deb03e6 100644
--- a/1.5/2020-10-08-asynchronous-client-creation.html
+++ b/1.5/2020-10-08-asynchronous-client-creation.html
@@ -324,7 +324,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2020-10-23-end-2-end-acknowledgment.html b/1.5/2020-10-23-end-2-end-acknowledgment.html
index 0beec5b..eda0b6c 100644
--- a/1.5/2020-10-23-end-2-end-acknowledgment.html
+++ b/1.5/2020-10-23-end-2-end-acknowledgment.html
@@ -565,7 +565,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2020-10-28-release-announcement-140.html b/1.5/2020-10-28-release-announcement-140.html
index 795f996..f354e9f 100644
--- a/1.5/2020-10-28-release-announcement-140.html
+++ b/1.5/2020-10-28-release-announcement-140.html
@@ -288,7 +288,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2020-11-11-desired-properties.html b/1.5/2020-11-11-desired-properties.html
index a04e90d..129e203 100644
--- a/1.5/2020-11-11-desired-properties.html
+++ b/1.5/2020-11-11-desired-properties.html
@@ -392,7 +392,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2020-11-16-weak-acknowledgements.html b/1.5/2020-11-16-weak-acknowledgements.html
index 0e9c48a..589cb7d 100644
--- a/1.5/2020-11-16-weak-acknowledgements.html
+++ b/1.5/2020-11-16-weak-acknowledgements.html
@@ -349,7 +349,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/2020-12-10-release-announcement-150.html b/1.5/2020-12-10-release-announcement-150.html
index 30c5aac..7d82c2b 100644
--- a/1.5/2020-12-10-release-announcement-150.html
+++ b/1.5/2020-12-10-release-announcement-150.html
@@ -290,7 +290,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/404.html b/1.5/404.html
index ea023d8..cbcc35d 100644
--- a/1.5/404.html
+++ b/1.5/404.html
@@ -1599,7 +1599,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/architecture-overview.html b/1.5/architecture-overview.html
index 201e75a..33e945e 100644
--- a/1.5/architecture-overview.html
+++ b/1.5/architecture-overview.html
@@ -1652,7 +1652,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/architecture-services-concierge.html b/1.5/architecture-services-concierge.html
index adf1da2..bd72cbb 100644
--- a/1.5/architecture-services-concierge.html
+++ b/1.5/architecture-services-concierge.html
@@ -1638,7 +1638,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/architecture-services-connectivity.html b/1.5/architecture-services-connectivity.html
index fddd452..dbcce05 100644
--- a/1.5/architecture-services-connectivity.html
+++ b/1.5/architecture-services-connectivity.html
@@ -1652,7 +1652,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/architecture-services-gateway.html b/1.5/architecture-services-gateway.html
index fadc84a..9eaf67b 100644
--- a/1.5/architecture-services-gateway.html
+++ b/1.5/architecture-services-gateway.html
@@ -1631,7 +1631,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/architecture-services-policies.html b/1.5/architecture-services-policies.html
index 2696371..f4eaee0 100644
--- a/1.5/architecture-services-policies.html
+++ b/1.5/architecture-services-policies.html
@@ -1631,7 +1631,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/architecture-services-things-search.html b/1.5/architecture-services-things-search.html
index 14dcdb0..b30b41d 100644
--- a/1.5/architecture-services-things-search.html
+++ b/1.5/architecture-services-things-search.html
@@ -1675,7 +1675,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/architecture-services-things.html b/1.5/architecture-services-things.html
index 6e80235..833e1e9 100644
--- a/1.5/architecture-services-things.html
+++ b/1.5/architecture-services-things.html
@@ -1631,7 +1631,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/basic-acknowledgements.html b/1.5/basic-acknowledgements.html
index efd573b..284e88e 100644
--- a/1.5/basic-acknowledgements.html
+++ b/1.5/basic-acknowledgements.html
@@ -2265,7 +2265,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/basic-acl.html b/1.5/basic-acl.html
index e9b389a..00e8663 100644
--- a/1.5/basic-acl.html
+++ b/1.5/basic-acl.html
@@ -1669,7 +1669,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/basic-apis.html b/1.5/basic-apis.html
index c676941..95e0aae 100644
--- a/1.5/basic-apis.html
+++ b/1.5/basic-apis.html
@@ -1727,7 +1727,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/basic-auth.html b/1.5/basic-auth.html
index 21c7d80..fee17ab 100644
--- a/1.5/basic-auth.html
+++ b/1.5/basic-auth.html
@@ -1673,7 +1673,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/basic-changenotifications.html b/1.5/basic-changenotifications.html
index 8bc4aea..e21d8f6 100644
--- a/1.5/basic-changenotifications.html
+++ b/1.5/basic-changenotifications.html
@@ -1671,7 +1671,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/basic-connections.html b/1.5/basic-connections.html
index c19ce62..de86802 100644
--- a/1.5/basic-connections.html
+++ b/1.5/basic-connections.html
@@ -2189,7 +2189,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/basic-enrichment.html b/1.5/basic-enrichment.html
index cafef6d..18a76d2 100644
--- a/1.5/basic-enrichment.html
+++ b/1.5/basic-enrichment.html
@@ -1702,7 +1702,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/basic-errors.html b/1.5/basic-errors.html
index 748a437..218cdeb 100644
--- a/1.5/basic-errors.html
+++ b/1.5/basic-errors.html
@@ -1648,7 +1648,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/basic-feature.html b/1.5/basic-feature.html
index 4c557b8..ecc1bd5 100644
--- a/1.5/basic-feature.html
+++ b/1.5/basic-feature.html
@@ -1852,7 +1852,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/basic-messages.html b/1.5/basic-messages.html
index fe48b18..4fdec2e 100644
--- a/1.5/basic-messages.html
+++ b/1.5/basic-messages.html
@@ -1740,7 +1740,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/basic-metadata.html b/1.5/basic-metadata.html
index 298181e..6df03e8 100644
--- a/1.5/basic-metadata.html
+++ b/1.5/basic-metadata.html
@@ -1782,7 +1782,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/basic-namespaces-and-names.html b/1.5/basic-namespaces-and-names.html
index 40805e6..506856c 100644
--- a/1.5/basic-namespaces-and-names.html
+++ b/1.5/basic-namespaces-and-names.html
@@ -1675,7 +1675,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/basic-overview.html b/1.5/basic-overview.html
index 4d2655b..cee8b69 100644
--- a/1.5/basic-overview.html
+++ b/1.5/basic-overview.html
@@ -1744,7 +1744,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/basic-placeholders.html b/1.5/basic-placeholders.html
index 08d0770..1ffe533 100644
--- a/1.5/basic-placeholders.html
+++ b/1.5/basic-placeholders.html
@@ -1890,7 +1890,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/basic-policy.html b/1.5/basic-policy.html
index c0a6c57..7def6fd 100644
--- a/1.5/basic-policy.html
+++ b/1.5/basic-policy.html
@@ -2018,7 +2018,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/basic-rql.html b/1.5/basic-rql.html
index 357dc19..fafe7b5 100644
--- a/1.5/basic-rql.html
+++ b/1.5/basic-rql.html
@@ -1850,7 +1850,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/basic-search.html b/1.5/basic-search.html
index 1e3d358..5520cba 100644
--- a/1.5/basic-search.html
+++ b/1.5/basic-search.html
@@ -1743,7 +1743,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/basic-signals-command.html b/1.5/basic-signals-command.html
index d062749..fead5fb 100644
--- a/1.5/basic-signals-command.html
+++ b/1.5/basic-signals-command.html
@@ -1629,7 +1629,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/basic-signals-commandresponse.html b/1.5/basic-signals-commandresponse.html
index 4bfe228..c8eec97 100644
--- a/1.5/basic-signals-commandresponse.html
+++ b/1.5/basic-signals-commandresponse.html
@@ -1609,7 +1609,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/basic-signals-errorresponse.html b/1.5/basic-signals-errorresponse.html
index 1aaa371..49839b0 100644
--- a/1.5/basic-signals-errorresponse.html
+++ b/1.5/basic-signals-errorresponse.html
@@ -1613,7 +1613,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/basic-signals-event.html b/1.5/basic-signals-event.html
index 20f74a4..ce7426e 100644
--- a/1.5/basic-signals-event.html
+++ b/1.5/basic-signals-event.html
@@ -1615,7 +1615,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/basic-signals.html b/1.5/basic-signals.html
index 421fca1..22b0be6 100644
--- a/1.5/basic-signals.html
+++ b/1.5/basic-signals.html
@@ -1659,7 +1659,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/basic-thing.html b/1.5/basic-thing.html
index 639fc86..fe686b6 100644
--- a/1.5/basic-thing.html
+++ b/1.5/basic-thing.html
@@ -1703,7 +1703,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/blog.html b/1.5/blog.html
index d730846..2393a6b 100644
--- a/1.5/blog.html
+++ b/1.5/blog.html
@@ -393,7 +393,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/blog_archive.html b/1.5/blog_archive.html
index 749e82f..df8d7ce 100644
--- a/1.5/blog_archive.html
+++ b/1.5/blog_archive.html
@@ -502,7 +502,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/client-sdk-java.html b/1.5/client-sdk-java.html
index c701daa..a1ccd41 100644
--- a/1.5/client-sdk-java.html
+++ b/1.5/client-sdk-java.html
@@ -1854,7 +1854,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/client-sdk-javascript.html b/1.5/client-sdk-javascript.html
index 3eb64cb..9a35bd2 100644
--- a/1.5/client-sdk-javascript.html
+++ b/1.5/client-sdk-javascript.html
@@ -1665,7 +1665,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/client-sdk-overview.html b/1.5/client-sdk-overview.html
index c99e7b2..83ca5db 100644
--- a/1.5/client-sdk-overview.html
+++ b/1.5/client-sdk-overview.html
@@ -1612,7 +1612,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/connectivity-header-mapping.html b/1.5/connectivity-header-mapping.html
index a1d9551..94ea5e3 100644
--- a/1.5/connectivity-header-mapping.html
+++ b/1.5/connectivity-header-mapping.html
@@ -1622,7 +1622,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/connectivity-manage-connections.html b/1.5/connectivity-manage-connections.html
index 13220af..1b115fc 100644
--- a/1.5/connectivity-manage-connections.html
+++ b/1.5/connectivity-manage-connections.html
@@ -1927,7 +1927,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/connectivity-mapping.html b/1.5/connectivity-mapping.html
index 307e7dd..4df5ab6 100644
--- a/1.5/connectivity-mapping.html
+++ b/1.5/connectivity-mapping.html
@@ -2533,7 +2533,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/connectivity-overview.html b/1.5/connectivity-overview.html
index ae10f9e..23f7dd2 100644
--- a/1.5/connectivity-overview.html
+++ b/1.5/connectivity-overview.html
@@ -1625,7 +1625,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/connectivity-protocol-bindings-amqp091.html b/1.5/connectivity-protocol-bindings-amqp091.html
index edf07e1..0de2cef 100644
--- a/1.5/connectivity-protocol-bindings-amqp091.html
+++ b/1.5/connectivity-protocol-bindings-amqp091.html
@@ -1770,7 +1770,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/connectivity-protocol-bindings-amqp10.html b/1.5/connectivity-protocol-bindings-amqp10.html
index 8a1c770..cc93be9 100644
--- a/1.5/connectivity-protocol-bindings-amqp10.html
+++ b/1.5/connectivity-protocol-bindings-amqp10.html
@@ -1816,7 +1816,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/connectivity-protocol-bindings-http.html b/1.5/connectivity-protocol-bindings-http.html
index 2a0c2af..d59cc3f 100644
--- a/1.5/connectivity-protocol-bindings-http.html
+++ b/1.5/connectivity-protocol-bindings-http.html
@@ -1823,7 +1823,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/connectivity-protocol-bindings-kafka2.html b/1.5/connectivity-protocol-bindings-kafka2.html
index e830651..8b2a19c 100644
--- a/1.5/connectivity-protocol-bindings-kafka2.html
+++ b/1.5/connectivity-protocol-bindings-kafka2.html
@@ -1748,7 +1748,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/connectivity-protocol-bindings-mqtt.html b/1.5/connectivity-protocol-bindings-mqtt.html
index ea4fba7..d140703 100644
--- a/1.5/connectivity-protocol-bindings-mqtt.html
+++ b/1.5/connectivity-protocol-bindings-mqtt.html
@@ -1941,7 +1941,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/connectivity-protocol-bindings-mqtt5.html b/1.5/connectivity-protocol-bindings-mqtt5.html
index cde6eab..6185347 100644
--- a/1.5/connectivity-protocol-bindings-mqtt5.html
+++ b/1.5/connectivity-protocol-bindings-mqtt5.html
@@ -1949,7 +1949,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/connectivity-tls-certificates.html b/1.5/connectivity-tls-certificates.html
index 87bbbcb..d0c9236 100644
--- a/1.5/connectivity-tls-certificates.html
+++ b/1.5/connectivity-tls-certificates.html
@@ -1720,7 +1720,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/feedback.html b/1.5/feedback.html
index 57dfc79..da50866 100644
--- a/1.5/feedback.html
+++ b/1.5/feedback.html
@@ -1616,7 +1616,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/glossary.html b/1.5/glossary.html
index 77afea3..5b4ac56 100644
--- a/1.5/glossary.html
+++ b/1.5/glossary.html
@@ -1614,7 +1614,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/http-api-doc.html b/1.5/http-api-doc.html
index 6a61f28..454ef27 100644
--- a/1.5/http-api-doc.html
+++ b/1.5/http-api-doc.html
@@ -201,7 +201,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/httpapi-concepts.html b/1.5/httpapi-concepts.html
index 5ec5887..a687fc2 100644
--- a/1.5/httpapi-concepts.html
+++ b/1.5/httpapi-concepts.html
@@ -2198,7 +2198,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/httpapi-messages.html b/1.5/httpapi-messages.html
index 18e45a7..2a528b1 100644
--- a/1.5/httpapi-messages.html
+++ b/1.5/httpapi-messages.html
@@ -1700,7 +1700,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/httpapi-overview.html b/1.5/httpapi-overview.html
index 9368a43..cae187f 100644
--- a/1.5/httpapi-overview.html
+++ b/1.5/httpapi-overview.html
@@ -1620,7 +1620,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/httpapi-protocol-bindings-cloudevents.html b/1.5/httpapi-protocol-bindings-cloudevents.html
index 369fd28..c0b3216 100644
--- a/1.5/httpapi-protocol-bindings-cloudevents.html
+++ b/1.5/httpapi-protocol-bindings-cloudevents.html
@@ -1707,7 +1707,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/httpapi-protocol-bindings-websocket.html b/1.5/httpapi-protocol-bindings-websocket.html
index 9269a7f..134b75e 100644
--- a/1.5/httpapi-protocol-bindings-websocket.html
+++ b/1.5/httpapi-protocol-bindings-websocket.html
@@ -1921,7 +1921,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/httpapi-search.html b/1.5/httpapi-search.html
index 4c26cf1..593e118 100644
--- a/1.5/httpapi-search.html
+++ b/1.5/httpapi-search.html
@@ -1667,7 +1667,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/httpapi-sse.html b/1.5/httpapi-sse.html
index 77b310f..0e97817 100644
--- a/1.5/httpapi-sse.html
+++ b/1.5/httpapi-sse.html
@@ -1854,7 +1854,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/index.html b/1.5/index.html
index c5a6443..e0b6937 100644
--- a/1.5/index.html
+++ b/1.5/index.html
@@ -265,7 +265,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/installation-building.html b/1.5/installation-building.html
index a7f1688..da044f0 100644
--- a/1.5/installation-building.html
+++ b/1.5/installation-building.html
@@ -1639,7 +1639,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/installation-operating.html b/1.5/installation-operating.html
index a8b9294..81b42af 100644
--- a/1.5/installation-operating.html
+++ b/1.5/installation-operating.html
@@ -2495,7 +2495,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/installation-running.html b/1.5/installation-running.html
index efa2f0e..2e07d04 100644
--- a/1.5/installation-running.html
+++ b/1.5/installation-running.html
@@ -1667,7 +1667,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/intro-digitaltwins.html b/1.5/intro-digitaltwins.html
index 64e2849..6a3601c 100644
--- a/1.5/intro-digitaltwins.html
+++ b/1.5/intro-digitaltwins.html
@@ -1642,7 +1642,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/intro-hello-world.html b/1.5/intro-hello-world.html
index 58542f6..8275325 100644
--- a/1.5/intro-hello-world.html
+++ b/1.5/intro-hello-world.html
@@ -1731,7 +1731,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/intro-overview.html b/1.5/intro-overview.html
index 1a10e12..bd6a37f 100644
--- a/1.5/intro-overview.html
+++ b/1.5/intro-overview.html
@@ -1658,7 +1658,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/presentations.html b/1.5/presentations.html
index f471ba8..9bf4de9 100644
--- a/1.5/presentations.html
+++ b/1.5/presentations.html
@@ -1652,7 +1652,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-bindings.html b/1.5/protocol-bindings.html
index ab450be..c457433 100644
--- a/1.5/protocol-bindings.html
+++ b/1.5/protocol-bindings.html
@@ -1632,7 +1632,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-createattribute.html b/1.5/protocol-examples-createattribute.html
index 38c0fea..c23d42e 100644
--- a/1.5/protocol-examples-createattribute.html
+++ b/1.5/protocol-examples-createattribute.html
@@ -1634,7 +1634,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-createattributes.html b/1.5/protocol-examples-createattributes.html
index f953dd5..f879a74 100644
--- a/1.5/protocol-examples-createattributes.html
+++ b/1.5/protocol-examples-createattributes.html
@@ -1639,7 +1639,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-createdefinition.html b/1.5/protocol-examples-createdefinition.html
index cc4c7c4..6701c77 100644
--- a/1.5/protocol-examples-createdefinition.html
+++ b/1.5/protocol-examples-createdefinition.html
@@ -1632,7 +1632,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-createdesiredproperties.html b/1.5/protocol-examples-createdesiredproperties.html
index 0eb7928..f969d9e 100644
--- a/1.5/protocol-examples-createdesiredproperties.html
+++ b/1.5/protocol-examples-createdesiredproperties.html
@@ -1637,7 +1637,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-createdesiredproperty.html b/1.5/protocol-examples-createdesiredproperty.html
index 9476f5b..527eb50 100644
--- a/1.5/protocol-examples-createdesiredproperty.html
+++ b/1.5/protocol-examples-createdesiredproperty.html
@@ -1627,7 +1627,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-createfeature.html b/1.5/protocol-examples-createfeature.html
index 4b6de16..245e857 100644
--- a/1.5/protocol-examples-createfeature.html
+++ b/1.5/protocol-examples-createfeature.html
@@ -1655,7 +1655,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-createfeatures.html b/1.5/protocol-examples-createfeatures.html
index 88a2ab8..5767add 100644
--- a/1.5/protocol-examples-createfeatures.html
+++ b/1.5/protocol-examples-createfeatures.html
@@ -1659,7 +1659,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-createproperties.html b/1.5/protocol-examples-createproperties.html
index 8ab61d7..debe342 100644
--- a/1.5/protocol-examples-createproperties.html
+++ b/1.5/protocol-examples-createproperties.html
@@ -1638,7 +1638,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-createproperty.html b/1.5/protocol-examples-createproperty.html
index aae8022..a5f8294 100644
--- a/1.5/protocol-examples-createproperty.html
+++ b/1.5/protocol-examples-createproperty.html
@@ -1628,7 +1628,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-creatething.html b/1.5/protocol-examples-creatething.html
index 27ccdb1..b5ffecb 100644
--- a/1.5/protocol-examples-creatething.html
+++ b/1.5/protocol-examples-creatething.html
@@ -1739,7 +1739,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-createthingdefinition.html b/1.5/protocol-examples-createthingdefinition.html
index 8a5766e..d2be585 100644
--- a/1.5/protocol-examples-createthingdefinition.html
+++ b/1.5/protocol-examples-createthingdefinition.html
@@ -1629,7 +1629,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-deleteattribute.html b/1.5/protocol-examples-deleteattribute.html
index 2ccfadd..83e4452 100644
--- a/1.5/protocol-examples-deleteattribute.html
+++ b/1.5/protocol-examples-deleteattribute.html
@@ -1626,7 +1626,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-deleteattributes.html b/1.5/protocol-examples-deleteattributes.html
index b3c7ec1..be1433f 100644
--- a/1.5/protocol-examples-deleteattributes.html
+++ b/1.5/protocol-examples-deleteattributes.html
@@ -1626,7 +1626,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-deletedefinition.html b/1.5/protocol-examples-deletedefinition.html
index a0aff22..28ff411 100644
--- a/1.5/protocol-examples-deletedefinition.html
+++ b/1.5/protocol-examples-deletedefinition.html
@@ -1626,7 +1626,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-deletedesiredproperties.html b/1.5/protocol-examples-deletedesiredproperties.html
index 3b9cc6f..c452f50 100644
--- a/1.5/protocol-examples-deletedesiredproperties.html
+++ b/1.5/protocol-examples-deletedesiredproperties.html
@@ -1625,7 +1625,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-deletedesiredproperty.html b/1.5/protocol-examples-deletedesiredproperty.html
index b4586dd..1112c28 100644
--- a/1.5/protocol-examples-deletedesiredproperty.html
+++ b/1.5/protocol-examples-deletedesiredproperty.html
@@ -1625,7 +1625,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-deletefeature.html b/1.5/protocol-examples-deletefeature.html
index 738f5ec..12bb369 100644
--- a/1.5/protocol-examples-deletefeature.html
+++ b/1.5/protocol-examples-deletefeature.html
@@ -1626,7 +1626,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-deletefeatures.html b/1.5/protocol-examples-deletefeatures.html
index bf356cb..dcc885c 100644
--- a/1.5/protocol-examples-deletefeatures.html
+++ b/1.5/protocol-examples-deletefeatures.html
@@ -1626,7 +1626,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-deleteproperties.html b/1.5/protocol-examples-deleteproperties.html
index 6811f75..508422c 100644
--- a/1.5/protocol-examples-deleteproperties.html
+++ b/1.5/protocol-examples-deleteproperties.html
@@ -1626,7 +1626,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-deleteproperty.html b/1.5/protocol-examples-deleteproperty.html
index 0a8aba4..687a803 100644
--- a/1.5/protocol-examples-deleteproperty.html
+++ b/1.5/protocol-examples-deleteproperty.html
@@ -1626,7 +1626,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-deletething.html b/1.5/protocol-examples-deletething.html
index 185b0eb..eddfee1 100644
--- a/1.5/protocol-examples-deletething.html
+++ b/1.5/protocol-examples-deletething.html
@@ -1626,7 +1626,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-deletethingdefinition.html b/1.5/protocol-examples-deletethingdefinition.html
index a097dfc..a2f2598 100644
--- a/1.5/protocol-examples-deletethingdefinition.html
+++ b/1.5/protocol-examples-deletethingdefinition.html
@@ -1626,7 +1626,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-errorresponses.html b/1.5/protocol-examples-errorresponses.html
index 2880602..ba4716a 100644
--- a/1.5/protocol-examples-errorresponses.html
+++ b/1.5/protocol-examples-errorresponses.html
@@ -2125,7 +2125,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-modifyattribute.html b/1.5/protocol-examples-modifyattribute.html
index 1c3c19d..f1e1e94 100644
--- a/1.5/protocol-examples-modifyattribute.html
+++ b/1.5/protocol-examples-modifyattribute.html
@@ -1634,7 +1634,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-modifyattributes.html b/1.5/protocol-examples-modifyattributes.html
index 3ee8cf9..c015144 100644
--- a/1.5/protocol-examples-modifyattributes.html
+++ b/1.5/protocol-examples-modifyattributes.html
@@ -1639,7 +1639,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-modifydefinition.html b/1.5/protocol-examples-modifydefinition.html
index 7a61281..57d1482 100644
--- a/1.5/protocol-examples-modifydefinition.html
+++ b/1.5/protocol-examples-modifydefinition.html
@@ -1632,7 +1632,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-modifydesiredproperties.html b/1.5/protocol-examples-modifydesiredproperties.html
index d0c6bbc..c124485 100644
--- a/1.5/protocol-examples-modifydesiredproperties.html
+++ b/1.5/protocol-examples-modifydesiredproperties.html
@@ -1637,7 +1637,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-modifydesiredproperty.html b/1.5/protocol-examples-modifydesiredproperty.html
index 0ca2523..d225f83 100644
--- a/1.5/protocol-examples-modifydesiredproperty.html
+++ b/1.5/protocol-examples-modifydesiredproperty.html
@@ -1627,7 +1627,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-modifyfeature.html b/1.5/protocol-examples-modifyfeature.html
index 7c8585e..4282502 100644
--- a/1.5/protocol-examples-modifyfeature.html
+++ b/1.5/protocol-examples-modifyfeature.html
@@ -1655,7 +1655,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-modifyfeatures.html b/1.5/protocol-examples-modifyfeatures.html
index e33d6fe..7eeea93 100644
--- a/1.5/protocol-examples-modifyfeatures.html
+++ b/1.5/protocol-examples-modifyfeatures.html
@@ -1659,7 +1659,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-modifypolicyid.html b/1.5/protocol-examples-modifypolicyid.html
index 646fdb9..0402da7 100644
--- a/1.5/protocol-examples-modifypolicyid.html
+++ b/1.5/protocol-examples-modifypolicyid.html
@@ -1650,7 +1650,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-modifyproperties.html b/1.5/protocol-examples-modifyproperties.html
index 627c2be..2ca2ec8 100644
--- a/1.5/protocol-examples-modifyproperties.html
+++ b/1.5/protocol-examples-modifyproperties.html
@@ -1638,7 +1638,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-modifyproperty.html b/1.5/protocol-examples-modifyproperty.html
index 276491b..6ef0f40 100644
--- a/1.5/protocol-examples-modifyproperty.html
+++ b/1.5/protocol-examples-modifyproperty.html
@@ -1628,7 +1628,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-modifything.html b/1.5/protocol-examples-modifything.html
index 7d422d2..07b6529 100644
--- a/1.5/protocol-examples-modifything.html
+++ b/1.5/protocol-examples-modifything.html
@@ -1720,7 +1720,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-modifythingdefinition.html b/1.5/protocol-examples-modifythingdefinition.html
index 63a386a..a334057 100644
--- a/1.5/protocol-examples-modifythingdefinition.html
+++ b/1.5/protocol-examples-modifythingdefinition.html
@@ -1628,7 +1628,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-policies-createpolicy.html b/1.5/protocol-examples-policies-createpolicy.html
index 345999d..6f6b439 100644
--- a/1.5/protocol-examples-policies-createpolicy.html
+++ b/1.5/protocol-examples-policies-createpolicy.html
@@ -1662,7 +1662,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-policies-createpolicyentry.html b/1.5/protocol-examples-policies-createpolicyentry.html
index 50fdd0e..90fc006 100644
--- a/1.5/protocol-examples-policies-createpolicyentry.html
+++ b/1.5/protocol-examples-policies-createpolicyentry.html
@@ -1638,7 +1638,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-policies-createresource.html b/1.5/protocol-examples-policies-createresource.html
index c2b10de..c97cf0d 100644
--- a/1.5/protocol-examples-policies-createresource.html
+++ b/1.5/protocol-examples-policies-createresource.html
@@ -1627,7 +1627,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-policies-createsubject.html b/1.5/protocol-examples-policies-createsubject.html
index 40a5850..6476370 100644
--- a/1.5/protocol-examples-policies-createsubject.html
+++ b/1.5/protocol-examples-policies-createsubject.html
@@ -1623,7 +1623,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-policies-deletepolicy.html b/1.5/protocol-examples-policies-deletepolicy.html
index 2c73450..2f2384c 100644
--- a/1.5/protocol-examples-policies-deletepolicy.html
+++ b/1.5/protocol-examples-policies-deletepolicy.html
@@ -1620,7 +1620,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-policies-deletepolicyentry.html b/1.5/protocol-examples-policies-deletepolicyentry.html
index 7474f1f..2ced0e4 100644
--- a/1.5/protocol-examples-policies-deletepolicyentry.html
+++ b/1.5/protocol-examples-policies-deletepolicyentry.html
@@ -1620,7 +1620,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-policies-deleteresource.html b/1.5/protocol-examples-policies-deleteresource.html
index 999d492..053767b 100644
--- a/1.5/protocol-examples-policies-deleteresource.html
+++ b/1.5/protocol-examples-policies-deleteresource.html
@@ -1620,7 +1620,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-policies-deletesubject.html b/1.5/protocol-examples-policies-deletesubject.html
index de8b0dd..3bd354e 100644
--- a/1.5/protocol-examples-policies-deletesubject.html
+++ b/1.5/protocol-examples-policies-deletesubject.html
@@ -1620,7 +1620,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-policies-errorresponses.html b/1.5/protocol-examples-policies-errorresponses.html
index c4392af..36f2a67 100644
--- a/1.5/protocol-examples-policies-errorresponses.html
+++ b/1.5/protocol-examples-policies-errorresponses.html
@@ -1958,7 +1958,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-policies-modifypolicy.html b/1.5/protocol-examples-policies-modifypolicy.html
index eab3ddf..e4cee64 100644
--- a/1.5/protocol-examples-policies-modifypolicy.html
+++ b/1.5/protocol-examples-policies-modifypolicy.html
@@ -1641,7 +1641,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-policies-modifypolicyentries.html b/1.5/protocol-examples-policies-modifypolicyentries.html
index 8bfec27..6821651 100644
--- a/1.5/protocol-examples-policies-modifypolicyentries.html
+++ b/1.5/protocol-examples-policies-modifypolicyentries.html
@@ -1660,7 +1660,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-policies-modifypolicyentry.html b/1.5/protocol-examples-policies-modifypolicyentry.html
index 909fa1f..a827968 100644
--- a/1.5/protocol-examples-policies-modifypolicyentry.html
+++ b/1.5/protocol-examples-policies-modifypolicyentry.html
@@ -1638,7 +1638,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-policies-modifyresource.html b/1.5/protocol-examples-policies-modifyresource.html
index 2bf0371..7875885 100644
--- a/1.5/protocol-examples-policies-modifyresource.html
+++ b/1.5/protocol-examples-policies-modifyresource.html
@@ -1627,7 +1627,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-policies-modifyresources.html b/1.5/protocol-examples-policies-modifyresources.html
index ecd0a8b..e5911e3 100644
--- a/1.5/protocol-examples-policies-modifyresources.html
+++ b/1.5/protocol-examples-policies-modifyresources.html
@@ -1630,7 +1630,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-policies-modifysubject.html b/1.5/protocol-examples-policies-modifysubject.html
index d6b107f..f40b72b 100644
--- a/1.5/protocol-examples-policies-modifysubject.html
+++ b/1.5/protocol-examples-policies-modifysubject.html
@@ -1623,7 +1623,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-policies-modifysubjects.html b/1.5/protocol-examples-policies-modifysubjects.html
index a3a1b3b..766a97d 100644
--- a/1.5/protocol-examples-policies-modifysubjects.html
+++ b/1.5/protocol-examples-policies-modifysubjects.html
@@ -1626,7 +1626,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-policies-retrievepolicy.html b/1.5/protocol-examples-policies-retrievepolicy.html
index 1e73ee3..18aa7f9 100644
--- a/1.5/protocol-examples-policies-retrievepolicy.html
+++ b/1.5/protocol-examples-policies-retrievepolicy.html
@@ -1641,7 +1641,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-policies-retrievepolicyentries.html b/1.5/protocol-examples-policies-retrievepolicyentries.html
index 482c767..99d5139 100644
--- a/1.5/protocol-examples-policies-retrievepolicyentries.html
+++ b/1.5/protocol-examples-policies-retrievepolicyentries.html
@@ -1654,7 +1654,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-policies-retrievepolicyentry.html b/1.5/protocol-examples-policies-retrievepolicyentry.html
index 17fc9e0..0a91524 100644
--- a/1.5/protocol-examples-policies-retrievepolicyentry.html
+++ b/1.5/protocol-examples-policies-retrievepolicyentry.html
@@ -1636,7 +1636,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-policies-retrieveresource.html b/1.5/protocol-examples-policies-retrieveresource.html
index d05fd26..e04ca20 100644
--- a/1.5/protocol-examples-policies-retrieveresource.html
+++ b/1.5/protocol-examples-policies-retrieveresource.html
@@ -1627,7 +1627,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-policies-retrieveresources.html b/1.5/protocol-examples-policies-retrieveresources.html
index 5b9ff69..b4e0c32 100644
--- a/1.5/protocol-examples-policies-retrieveresources.html
+++ b/1.5/protocol-examples-policies-retrieveresources.html
@@ -1629,7 +1629,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-policies-retrievesubject.html b/1.5/protocol-examples-policies-retrievesubject.html
index e36e987..88f7a21 100644
--- a/1.5/protocol-examples-policies-retrievesubject.html
+++ b/1.5/protocol-examples-policies-retrievesubject.html
@@ -1623,7 +1623,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-policies-retrievesubjects.html b/1.5/protocol-examples-policies-retrievesubjects.html
index c188ed8..f9ccaa8 100644
--- a/1.5/protocol-examples-policies-retrievesubjects.html
+++ b/1.5/protocol-examples-policies-retrievesubjects.html
@@ -1625,7 +1625,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-retrieveattribute.html b/1.5/protocol-examples-retrieveattribute.html
index fc55c19..ab47cda 100644
--- a/1.5/protocol-examples-retrieveattribute.html
+++ b/1.5/protocol-examples-retrieveattribute.html
@@ -1620,7 +1620,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-retrieveattributes.html b/1.5/protocol-examples-retrieveattributes.html
index 5c31e0f..555cffd 100644
--- a/1.5/protocol-examples-retrieveattributes.html
+++ b/1.5/protocol-examples-retrieveattributes.html
@@ -1622,7 +1622,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-retrievedefinition.html b/1.5/protocol-examples-retrievedefinition.html
index 3ac8d65..313c758 100644
--- a/1.5/protocol-examples-retrievedefinition.html
+++ b/1.5/protocol-examples-retrievedefinition.html
@@ -1619,7 +1619,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-retrievedesiredproperties.html b/1.5/protocol-examples-retrievedesiredproperties.html
index 6e43ef8..20851fb 100644
--- a/1.5/protocol-examples-retrievedesiredproperties.html
+++ b/1.5/protocol-examples-retrievedesiredproperties.html
@@ -1621,7 +1621,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-retrievedesiredproperty.html b/1.5/protocol-examples-retrievedesiredproperty.html
index 16a7147..2f8958b 100644
--- a/1.5/protocol-examples-retrievedesiredproperty.html
+++ b/1.5/protocol-examples-retrievedesiredproperty.html
@@ -1616,7 +1616,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-retrievefeature.html b/1.5/protocol-examples-retrievefeature.html
index 996f87c..80f1b74 100644
--- a/1.5/protocol-examples-retrievefeature.html
+++ b/1.5/protocol-examples-retrievefeature.html
@@ -1630,7 +1630,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-retrievefeatures.html b/1.5/protocol-examples-retrievefeatures.html
index 8cf311b..3b77604 100644
--- a/1.5/protocol-examples-retrievefeatures.html
+++ b/1.5/protocol-examples-retrievefeatures.html
@@ -1632,7 +1632,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-retrieveproperties.html b/1.5/protocol-examples-retrieveproperties.html
index 43bba5e..8ced097 100644
--- a/1.5/protocol-examples-retrieveproperties.html
+++ b/1.5/protocol-examples-retrieveproperties.html
@@ -1622,7 +1622,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-retrieveproperty.html b/1.5/protocol-examples-retrieveproperty.html
index 20680d2..3c69ba2 100644
--- a/1.5/protocol-examples-retrieveproperty.html
+++ b/1.5/protocol-examples-retrieveproperty.html
@@ -1617,7 +1617,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-retrievething.html b/1.5/protocol-examples-retrievething.html
index ecac275..e860905 100644
--- a/1.5/protocol-examples-retrievething.html
+++ b/1.5/protocol-examples-retrievething.html
@@ -1652,7 +1652,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-retrievethingdefinition.html b/1.5/protocol-examples-retrievethingdefinition.html
index 4faaaca..3677656 100644
--- a/1.5/protocol-examples-retrievethingdefinition.html
+++ b/1.5/protocol-examples-retrievethingdefinition.html
@@ -1617,7 +1617,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-retrievethings.html b/1.5/protocol-examples-retrievethings.html
index 732cdd6..ac4450c 100644
--- a/1.5/protocol-examples-retrievethings.html
+++ b/1.5/protocol-examples-retrievethings.html
@@ -1649,7 +1649,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples-search.html b/1.5/protocol-examples-search.html
index 15179d6..56b3a4f 100644
--- a/1.5/protocol-examples-search.html
+++ b/1.5/protocol-examples-search.html
@@ -1721,7 +1721,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-examples.html b/1.5/protocol-examples.html
index 5f27ce1..a14cd76 100644
--- a/1.5/protocol-examples.html
+++ b/1.5/protocol-examples.html
@@ -1703,7 +1703,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-overview.html b/1.5/protocol-overview.html
index 2eb91a5..b8d8707 100644
--- a/1.5/protocol-overview.html
+++ b/1.5/protocol-overview.html
@@ -1619,7 +1619,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-specification-acks.html b/1.5/protocol-specification-acks.html
index dc76559..54296f5 100644
--- a/1.5/protocol-specification-acks.html
+++ b/1.5/protocol-specification-acks.html
@@ -1643,7 +1643,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-specification-errors.html b/1.5/protocol-specification-errors.html
index 74f2253..b86cc3e 100644
--- a/1.5/protocol-specification-errors.html
+++ b/1.5/protocol-specification-errors.html
@@ -1612,7 +1612,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-specification-policies-create-or-modify.html b/1.5/protocol-specification-policies-create-or-modify.html
index 0e2490a..d0e30f3 100644
--- a/1.5/protocol-specification-policies-create-or-modify.html
+++ b/1.5/protocol-specification-policies-create-or-modify.html
@@ -2221,7 +2221,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-specification-policies-delete.html b/1.5/protocol-specification-policies-delete.html
index 0c17e70..3525d15 100644
--- a/1.5/protocol-specification-policies-delete.html
+++ b/1.5/protocol-specification-policies-delete.html
@@ -1891,7 +1891,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-specification-policies-retrieve.html b/1.5/protocol-specification-policies-retrieve.html
index 0c39fe7..ee354ca 100644
--- a/1.5/protocol-specification-policies-retrieve.html
+++ b/1.5/protocol-specification-policies-retrieve.html
@@ -2114,7 +2114,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-specification-policies.html b/1.5/protocol-specification-policies.html
index a55983a..7a1b10d 100644
--- a/1.5/protocol-specification-policies.html
+++ b/1.5/protocol-specification-policies.html
@@ -1701,7 +1701,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-specification-things-create-or-modify.html b/1.5/protocol-specification-things-create-or-modify.html
index 655c284..7aa4e41 100644
--- a/1.5/protocol-specification-things-create-or-modify.html
+++ b/1.5/protocol-specification-things-create-or-modify.html
@@ -3320,7 +3320,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-specification-things-delete.html b/1.5/protocol-specification-things-delete.html
index 14d1324..0cf7af7 100644
--- a/1.5/protocol-specification-things-delete.html
+++ b/1.5/protocol-specification-things-delete.html
@@ -2709,7 +2709,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-specification-things-messages.html b/1.5/protocol-specification-things-messages.html
index b4ac312..ed24c45 100644
--- a/1.5/protocol-specification-things-messages.html
+++ b/1.5/protocol-specification-things-messages.html
@@ -1863,7 +1863,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-specification-things-retrieve.html b/1.5/protocol-specification-things-retrieve.html
index b6782dc..a021cb2 100644
--- a/1.5/protocol-specification-things-retrieve.html
+++ b/1.5/protocol-specification-things-retrieve.html
@@ -2556,7 +2556,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-specification-things-search.html b/1.5/protocol-specification-things-search.html
index 99a3732..3436b6a 100644
--- a/1.5/protocol-specification-things-search.html
+++ b/1.5/protocol-specification-things-search.html
@@ -1967,7 +1967,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-specification-things.html b/1.5/protocol-specification-things.html
index 16fadff..0644caa 100644
--- a/1.5/protocol-specification-things.html
+++ b/1.5/protocol-specification-things.html
@@ -1672,7 +1672,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-specification-topic.html b/1.5/protocol-specification-topic.html
index e1cf516..d676727 100644
--- a/1.5/protocol-specification-topic.html
+++ b/1.5/protocol-specification-topic.html
@@ -1777,7 +1777,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-specification.html b/1.5/protocol-specification.html
index 23051bd..94dc5ab 100644
--- a/1.5/protocol-specification.html
+++ b/1.5/protocol-specification.html
@@ -1772,7 +1772,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/protocol-twinlive.html b/1.5/protocol-twinlive.html
index b1524f5..d84d7f4 100644
--- a/1.5/protocol-twinlive.html
+++ b/1.5/protocol-twinlive.html
@@ -1630,7 +1630,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/release_notes_010-M1.html b/1.5/release_notes_010-M1.html
index 530602b..af4d72d 100644
--- a/1.5/release_notes_010-M1.html
+++ b/1.5/release_notes_010-M1.html
@@ -1609,7 +1609,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/release_notes_010-M3.html b/1.5/release_notes_010-M3.html
index 7b9a41d..f126ed3 100644
--- a/1.5/release_notes_010-M3.html
+++ b/1.5/release_notes_010-M3.html
@@ -1665,7 +1665,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/release_notes_020-M1.html b/1.5/release_notes_020-M1.html
index 3d018d6..82dea18 100644
--- a/1.5/release_notes_020-M1.html
+++ b/1.5/release_notes_020-M1.html
@@ -1650,7 +1650,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/release_notes_030-M1.html b/1.5/release_notes_030-M1.html
index 4725313..abecb28 100644
--- a/1.5/release_notes_030-M1.html
+++ b/1.5/release_notes_030-M1.html
@@ -1661,7 +1661,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/release_notes_030-M2.html b/1.5/release_notes_030-M2.html
index 43a9ff4..3bb9059 100644
--- a/1.5/release_notes_030-M2.html
+++ b/1.5/release_notes_030-M2.html
@@ -1658,7 +1658,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/release_notes_080-M1.html b/1.5/release_notes_080-M1.html
index 0f3d989..3b620a5 100644
--- a/1.5/release_notes_080-M1.html
+++ b/1.5/release_notes_080-M1.html
@@ -1680,7 +1680,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/release_notes_080-M2.html b/1.5/release_notes_080-M2.html
index 551f365..42c231e 100644
--- a/1.5/release_notes_080-M2.html
+++ b/1.5/release_notes_080-M2.html
@@ -1664,7 +1664,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/release_notes_080-M3.html b/1.5/release_notes_080-M3.html
index 0ed701e..5121594 100644
--- a/1.5/release_notes_080-M3.html
+++ b/1.5/release_notes_080-M3.html
@@ -1668,7 +1668,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/release_notes_080.html b/1.5/release_notes_080.html
index 0a03e5a..b9805c3 100644
--- a/1.5/release_notes_080.html
+++ b/1.5/release_notes_080.html
@@ -1674,7 +1674,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/release_notes_090-M1.html b/1.5/release_notes_090-M1.html
index b10524d..0edc32d 100644
--- a/1.5/release_notes_090-M1.html
+++ b/1.5/release_notes_090-M1.html
@@ -1646,7 +1646,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/release_notes_090-M2.html b/1.5/release_notes_090-M2.html
index 8885639..2fb4069 100644
--- a/1.5/release_notes_090-M2.html
+++ b/1.5/release_notes_090-M2.html
@@ -1647,7 +1647,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/release_notes_090.html b/1.5/release_notes_090.html
index 5d3f1c9..254f75d 100644
--- a/1.5/release_notes_090.html
+++ b/1.5/release_notes_090.html
@@ -1704,7 +1704,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/release_notes_100-M1a.html b/1.5/release_notes_100-M1a.html
index a457ab2..0180cf5 100644
--- a/1.5/release_notes_100-M1a.html
+++ b/1.5/release_notes_100-M1a.html
@@ -1665,7 +1665,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/release_notes_100-M2.html b/1.5/release_notes_100-M2.html
index 25b075f..f4bab29 100644
--- a/1.5/release_notes_100-M2.html
+++ b/1.5/release_notes_100-M2.html
@@ -1682,7 +1682,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/release_notes_100.html b/1.5/release_notes_100.html
index 8faeaba..50a71c5 100644
--- a/1.5/release_notes_100.html
+++ b/1.5/release_notes_100.html
@@ -1685,7 +1685,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/release_notes_110.html b/1.5/release_notes_110.html
index c604dd1..76fa889 100644
--- a/1.5/release_notes_110.html
+++ b/1.5/release_notes_110.html
@@ -1726,7 +1726,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/release_notes_111.html b/1.5/release_notes_111.html
index a4f756f..eeb0677 100644
--- a/1.5/release_notes_111.html
+++ b/1.5/release_notes_111.html
@@ -1624,7 +1624,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/release_notes_112.html b/1.5/release_notes_112.html
index a8f4fc0..83919b6 100644
--- a/1.5/release_notes_112.html
+++ b/1.5/release_notes_112.html
@@ -1640,7 +1640,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/release_notes_113.html b/1.5/release_notes_113.html
index a6a6757..1a9b235 100644
--- a/1.5/release_notes_113.html
+++ b/1.5/release_notes_113.html
@@ -1640,7 +1640,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/release_notes_115.html b/1.5/release_notes_115.html
index 621bfe6..991b3c9 100644
--- a/1.5/release_notes_115.html
+++ b/1.5/release_notes_115.html
@@ -1628,7 +1628,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/release_notes_120.html b/1.5/release_notes_120.html
index 8fef235..578c660 100644
--- a/1.5/release_notes_120.html
+++ b/1.5/release_notes_120.html
@@ -1700,7 +1700,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/release_notes_121.html b/1.5/release_notes_121.html
index 80e1abc..a6f39fc 100644
--- a/1.5/release_notes_121.html
+++ b/1.5/release_notes_121.html
@@ -1627,7 +1627,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/release_notes_130.html b/1.5/release_notes_130.html
index d57880c..0c245bb 100644
--- a/1.5/release_notes_130.html
+++ b/1.5/release_notes_130.html
@@ -1717,7 +1717,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/release_notes_140.html b/1.5/release_notes_140.html
index 2afa70b..d642940 100644
--- a/1.5/release_notes_140.html
+++ b/1.5/release_notes_140.html
@@ -1694,7 +1694,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/release_notes_150.html b/1.5/release_notes_150.html
index a8bf7db..990dcad 100644
--- a/1.5/release_notes_150.html
+++ b/1.5/release_notes_150.html
@@ -1728,7 +1728,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/release_notes_151.html b/1.5/release_notes_151.html
index 566fe24..e8fa97c 100644
--- a/1.5/release_notes_151.html
+++ b/1.5/release_notes_151.html
@@ -1616,7 +1616,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/sandbox.html b/1.5/sandbox.html
index 5bff36c..b096972 100644
--- a/1.5/sandbox.html
+++ b/1.5/sandbox.html
@@ -1663,7 +1663,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/tag_architecture.html b/1.5/tag_architecture.html
index 504b76e..c2e90c0 100644
--- a/1.5/tag_architecture.html
+++ b/1.5/tag_architecture.html
@@ -2468,7 +2468,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/tag_blog.html b/1.5/tag_blog.html
index 41804da..3c5902d 100644
--- a/1.5/tag_blog.html
+++ b/1.5/tag_blog.html
@@ -2642,7 +2642,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/tag_client_sdk.html b/1.5/tag_client_sdk.html
index 86dee99..f0983a2 100644
--- a/1.5/tag_client_sdk.html
+++ b/1.5/tag_client_sdk.html
@@ -2454,7 +2454,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/tag_connectivity.html b/1.5/tag_connectivity.html
index 3760f94..b26054a 100644
--- a/1.5/tag_connectivity.html
+++ b/1.5/tag_connectivity.html
@@ -2540,7 +2540,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/tag_getting_started.html b/1.5/tag_getting_started.html
index dd780bd..01210d0 100644
--- a/1.5/tag_getting_started.html
+++ b/1.5/tag_getting_started.html
@@ -2476,7 +2476,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/tag_http.html b/1.5/tag_http.html
index e0dbd5f..a5a86f8 100644
--- a/1.5/tag_http.html
+++ b/1.5/tag_http.html
@@ -2468,7 +2468,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/tag_installation.html b/1.5/tag_installation.html
index 1c4a186..e0bd330 100644
--- a/1.5/tag_installation.html
+++ b/1.5/tag_installation.html
@@ -2444,7 +2444,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/tag_model.html b/1.5/tag_model.html
index 1655047..2d0991b 100644
--- a/1.5/tag_model.html
+++ b/1.5/tag_model.html
@@ -2504,7 +2504,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/tag_news.html b/1.5/tag_news.html
index 60609a8..1b4af4c 100644
--- a/1.5/tag_news.html
+++ b/1.5/tag_news.html
@@ -2426,7 +2426,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/tag_protocol.html b/1.5/tag_protocol.html
index 2da5e77..202e77f 100644
--- a/1.5/tag_protocol.html
+++ b/1.5/tag_protocol.html
@@ -2602,7 +2602,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/tag_release_notes.html b/1.5/tag_release_notes.html
index 80862be..3149268 100644
--- a/1.5/tag_release_notes.html
+++ b/1.5/tag_release_notes.html
@@ -2582,7 +2582,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/tag_rql.html b/1.5/tag_rql.html
index 8cd30d8..67a87a6 100644
--- a/1.5/tag_rql.html
+++ b/1.5/tag_rql.html
@@ -2492,7 +2492,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/tag_search.html b/1.5/tag_search.html
index 0ce67a4..7b48ce1 100644
--- a/1.5/tag_search.html
+++ b/1.5/tag_search.html
@@ -2462,7 +2462,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/tag_signal.html b/1.5/tag_signal.html
index c0feab5..91d186d 100644
--- a/1.5/tag_signal.html
+++ b/1.5/tag_signal.html
@@ -2461,7 +2461,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/1.5/tag_troubleshooting.html b/1.5/tag_troubleshooting.html
index f1c821c..cbf3366 100644
--- a/1.5/tag_troubleshooting.html
+++ b/1.5/tag_troubleshooting.html
@@ -2440,7 +2440,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2.0/2017-11-10-welcome-to-ditto.html b/2.0/2017-11-10-welcome-to-ditto.html
new file mode 100644
index 0000000..62c172e
--- /dev/null
+++ b/2.0/2017-11-10-welcome-to-ditto.html
@@ -0,0 +1,319 @@
+<!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="This is our very first blog post of our new project site and we continue to add more documentation.">
+<meta name="keywords" content="blog, ">
+<title> Welcome to the Eclipse Ditto project site </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Welcome to the Eclipse Ditto project site">{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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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">Welcome to the Eclipse Ditto project site</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2017-11-10T00:00:00+00:00" itemprop="datePublished">Nov 10, 2017</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+ <div class="summary">This is our very first blog post of our new project site and we continue to add more documentation.</div>
+
+
+
+
+ <p>A warm welcome, dear visitor, to our new project site.</p>
+
+<p>The initial contribution of the Ditto codebase was one month ago and we did show the Digital twins a little on
+EclipseCon Europe in Ludwigsburg.<br />
+Meanwhile we worked on setting up the project site and documentation which we have now finished from the technical side.</p>
+
+<p>The <a href="http-api-doc.html">HTTP API Documentation</a> is already complete and describes both of our API versions 1 and 2.</p>
+
+<p>Next we focus on releasing a first Milestone <code class="highlighter-rouge">0.1.0-M1</code> including images on <a href="https://hub.docker.com/u/eclipse/">Docker Hub</a>
+so that you can try out Eclipse Ditto more easily without building it first.</p>
+
+<p>We are looking forward to any feedback you have via our <a href="feedback.html">Feedback channels</a>.</p>
+
+<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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2017-12-18-milestone-announcement-010-M1.html b/2.0/2017-12-18-milestone-announcement-010-M1.html
new file mode 100644
index 0000000..b4f3da2
--- /dev/null
+++ b/2.0/2017-12-18-milestone-announcement-010-M1.html
@@ -0,0 +1,323 @@
+<!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 Ditto Milestone 0.1.0-M1 </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 Ditto Milestone 0.1.0-M1">{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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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 Ditto Milestone 0.1.0-M1</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2017-12-18T00:00:00+00:00" itemprop="datePublished">Dec 18, 2017</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>We finally managed to build our first milestone of Eclipse Ditto: <a href="release_notes_010-M1.html">0.1.0-M1</a></p>
+
+<p>Java artifacts were published to both 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>Additionally Docker images were 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>
+</ul>
+
+<p>You can simply follow the instructions in <a href="installation-running.html">Running Ditto</a> to try it out now.</p>
+
+<p>We also have found our logo which you can now see on the landing page.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2018-01-12-milestone-announcement-010-M3.html b/2.0/2018-01-12-milestone-announcement-010-M3.html
new file mode 100644
index 0000000..d9434a6
--- /dev/null
+++ b/2.0/2018-01-12-milestone-announcement-010-M3.html
@@ -0,0 +1,342 @@
+<!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 Ditto Milestone 0.1.0-M3 </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 Ditto Milestone 0.1.0-M3">{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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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 Ditto Milestone 0.1.0-M3</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2018-01-12T00:00:00+00:00" itemprop="datePublished">Jan 12, 2018</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>We wish you all a happy new year<br />
+and an hope you are curious about our new Eclipse Ditto milestone.</p>
+
+<h2 id="milestone-3">Milestone 3</h2>
+
+<p>Our new milestone, namely <a href="release_notes_010-M3.html">0.1.0-M3</a>, adds an AMQP 1.0 bridge. The bridge enables to connect
+to a running instance of <a href="https://eclipse.org/hono/">Eclipse Hono</a>. Ditto can consume telemetry and event messages from Hono<br />
+and interpret those, given that these are compatible to our <a href="protocol-overview.html">Ditto Protocol</a>.</p>
+
+<p>Find more information about the milestone in the <a href="release_notes_010-M3.html">0.1.0-M3 release notes</a>.</p>
+
+<h2 id="sandbox">Sandbox</h2>
+
+<p>Together with this milestone release we have set up a sandbox at <a href="https://ditto.eclipseprojects.io">https://ditto.eclipseprojects.io</a>.</p>
+
+<p>There, everyone with a Google account can try out the HTTP API by using the interactive
+<a href="https://ditto.eclipseprojects.io/apidoc/">HTTP API documentation</a> (powered by <a href="https://swagger.io">Swagger</a>).</p>
+
+<p>Try it out and share your experience.</p>
+
+<p>The sandbox does not yet start the new Connectivity in order to connect to Hono; we will work on that soon.</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>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-amqp-bridge/">eclipse/ditto-amqp-bridge</a></li>
+</ul>
+
+<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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2018-01-15-example-demonstrating-rest-to-websocket.html b/2.0/2018-01-15-example-demonstrating-rest-to-websocket.html
new file mode 100644
index 0000000..0c2e5d6
--- /dev/null
+++ b/2.0/2018-01-15-example-demonstrating-rest-to-websocket.html
@@ -0,0 +1,331 @@
+<!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> Example demonstrating REST and WebSocket API </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Example demonstrating REST and WebSocket API">{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/9ca96e4eae3d3cf7df52ece39dc0b2fb?s=135" alt="A photo of Florian Fendt" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.com/ffendt" target="_blank">Florian Fendt</a>-->
+<!--</span>-->
+<!---->
+
+<article class="post" itemscope itemtype="http://schema.org/BlogPosting">
+
+ <header class="post-header">
+ <h1 class="post-title" itemprop="name headline">Example demonstrating REST and WebSocket API</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/9ca96e4eae3d3cf7df52ece39dc0b2fb?s=135" alt="A photo of Florian Fendt" 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="https://github.com/ffendt" target="_blank">Florian Fendt</a> </span></span> on <time datetime="2018-01-15T00:00:00+00:00" itemprop="datePublished">Jan 15, 2018</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>There’s a new example showing how to combine the REST and WebSocket API
+over at the <a href="https://github.com/eclipse/ditto-examples/tree/master/rest-to-websocket">Eclipse Ditto examples repository</a>.
+Right from the project’s description:</p>
+
+<blockquote>
+ <p>This example shows how to leverage the powers of combining the REST and
+ WebSocket Messages API of <a href="https://eclipse.org/ditto/">Eclipse Ditto</a>.
+ It demonstrates how to send direct Messages to a <em>live</em> Thing, as well as
+ updating the <em>twin</em> representation of a Thing inside Ditto.
+<br />
+<br />
+ The Thing in this case is a smart coffee machine (“SmartCoffee”) that has
+ some basic functionality. It accepts Messages that allow to start or stop
+ the heating of the water tank. Moreover you can request the coffee
+ machine to brew coffee, so you don’t have to wait for your dose of caffeine.<br />
+ But before starting to brew a coffee, SmartCoffee will send a captcha
+ that has to be solved.</p>
+</blockquote>
+
+<figure><img class="docimage" src="https://raw.githubusercontent.com/eclipse/ditto-examples/master/rest-to-websocket/docs/images/make-coffee.gif" alt="Eclipse Ditto REST to WebSocket example gif" style="max-width: 800px" /><figcaption>Source: https://github.com/eclipse/ditto-examples</figcaption></figure>
+
+<p>If you have any wishes, improvements, are missing something
+or just want to get in touch with us, you can use one of
+our <a href="https://eclipse.org/ditto/feedback.html">feedback channels</a>.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2018-02-07-milestone-announcement-020-M1.html b/2.0/2018-02-07-milestone-announcement-020-M1.html
new file mode 100644
index 0000000..cd18c6e
--- /dev/null
+++ b/2.0/2018-02-07-milestone-announcement-020-M1.html
@@ -0,0 +1,343 @@
+<!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 Ditto Milestone 0.2.0-M1 </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 Ditto Milestone 0.2.0-M1">{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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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 Ditto Milestone 0.2.0-M1</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2018-02-07T00:00:00+00:00" itemprop="datePublished">Feb 7, 2018</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>The Ditto team is proud to announce the next milestone release.</p>
+
+<p>Have a look at the Milestone <a href="release_notes_020-M1.html">0.2.0-M1 release notes</a>.</p>
+
+<p>The main changes are</p>
+<ul>
+ <li>being able to <a href="httpapi-search.html#query-parameters">search in namespaces</a> which can speed up search queries when applied
+to a large population of digital twins</li>
+ <li>the enhancement of our <a href="basic-feature.html">Feature entity</a> by <a href="basic-feature.html#feature-definition">Definitions</a>
+which lays the foundation for using Features in a typesafe way (later by enforcing the schema with the help of an
+Eclipse Vorto generator</li>
+</ul>
+
+<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>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-amqp-bridge/">eclipse/ditto-amqp-bridge</a></li>
+</ul>
+
+<h2 id="virtual-iot-meetup">Virtual IoT Meetup</h2>
+
+<p>Today at 8am PT / 11am ET / 5pm CET Eclipse IoT will host a <a href="https://www.meetup.com/Virtual-IoT/events/247048104/">Virtual IoT meetup</a>
+in which we will show Eclipse Ditto’s features from a technical perspective.</p>
+
+<p>The video will be streamed on YouTube and will be available afterwards here: <a href="https://www.youtube.com/watch?v=NpC4ROGqwKc">youtube.com/watch?v=NpC4ROGqwKc</a></p>
+
+<p>See you there ;-)</p>
+
+<p><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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2018-02-08-feature-definition.html b/2.0/2018-02-08-feature-definition.html
new file mode 100644
index 0000000..8646a36
--- /dev/null
+++ b/2.0/2018-02-08-feature-definition.html
@@ -0,0 +1,373 @@
+<!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> Introducing Feature Definition </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Introducing Feature Definition">{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/e26f930e0305b0e8b3cfb1a868a719d6?s=135" alt="A photo of Jürgen Fickel" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.com/jufickel-b" target="_blank">Jürgen Fickel</a>-->
+<!--</span>-->
+<!---->
+
+<article class="post" itemscope itemtype="http://schema.org/BlogPosting">
+
+ <header class="post-header">
+ <h1 class="post-title" itemprop="name headline">Introducing Feature Definition</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/e26f930e0305b0e8b3cfb1a868a719d6?s=135" alt="A photo of Jürgen Fickel" 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="https://github.com/jufickel-b" target="_blank">Jürgen Fickel</a> </span></span> on <time datetime="2018-02-08T00:00:00+00:00" itemprop="datePublished">Feb 8, 2018</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>Brace yourselves, <a href="https://eclipse.org/vorto">Eclipse Vorto</a> is going to be integrated with Ditto.</p>
+
+<h2 id="rationale">Rationale</h2>
+<p>By now you most probably represented your devices as <em>things</em> with <em>features</em>.
+This is indeed the proper way to do it.
+This approach is flexible and easy so far.</p>
+
+<p>But wouldn’t it be nice to have the possibility of providing an explicit schema for the digital twins of your devices?</p>
+
+<p>This is where Eclipse Vorto enters the game.
+Vorto enables you to define <em>information models</em> and <em>function blocks</em> which would be mapped to <em>things</em> and <em>features</em>
+in Ditto.</p>
+
+<p>To make a feature aware of a schema we have extended feature by a <em>definition</em>.
+A feature definition is a means of describing the type of a feature, thus enabling the validation the integrity of
+a feature’s properties.</p>
+
+<figure><img class="docimage" src="images/pages/basic/ditto-thing-feature-definition-model.png" alt="Feature Definition Model" style="max-width: 250px" /><figcaption>One Thing can have many features. A feature may conform to a *definition*</figcaption></figure>
+
+<p>Technically, a definition is an array of identifier strings each of which having the form
+ <code class="highlighter-rouge"><namespace>:<name>:<version></code>.</p>
+
+<p>A fully-fledged JSON representation of a feature with a definition is shown below:</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">"lamp"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"com.mycompany.fb:Lamp:1.0.0"</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">"configuration"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"on"</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">"location"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">34.052235</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">-118.243683</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="p">{</span><span class="w">
+ </span><span class="s2">"on"</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">"color"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"red"</span><span class="p">:</span><span class="w"> </span><span class="mi">128</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"green"</span><span class="p">:</span><span class="w"> </span><span class="mi">255</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"blue"</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><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>For diving deeper into feature definitions, please have a look at <a href="basic-feature.html#feature-definition">Basic concept - Feature Definition</a>.</p>
+
+<h2 id="validation">Validation</h2>
+<div class="alert alert-danger" role="alert"><i class="fa fa-exclamation-circle"></i> <b>Warning:</b> Yet Ditto does not use definition to validate features by itself.</div>
+
+<p>However, nothing can stop you from enforcing types by yourself:</p>
+
+<ol>
+ <li>Use the <a href="http://vorto.eclipse.org/#/generators">Ditto generator</a> to generate JSON schema files from your Vorto
+model(s).</li>
+ <li>Identify the schema files to be used by the Feature definition identifiers.</li>
+ <li>Validate the JSON representation of your feature using the JSON schema before sending it over the wire.</li>
+</ol>
+
+<h2 id="example">Example</h2>
+<p>Please find more information and an example at <a href="basic-feature.html#feature-definition">Basic concept - Feature Definition</a>.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2018-04-25-connectivity-service.html b/2.0/2018-04-25-connectivity-service.html
new file mode 100644
index 0000000..695eaae
--- /dev/null
+++ b/2.0/2018-04-25-connectivity-service.html
@@ -0,0 +1,387 @@
+<!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> Ditto's connectivity capabilities are pimped up </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Ditto's connectivity capabilities are pimped up">{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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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">Ditto's connectivity capabilities are pimped up</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2018-04-25T00:00:00+00:00" itemprop="datePublished">Apr 25, 2018</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>,
+
+
+
+ <a href="tag_connectivity.html">connectivity</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>It has been quite lately on our website and on GitHub as the Ditto team currently prepares its new <code class="highlighter-rouge">connectivity</code>
+microservice. Until now Ditto’s <code class="highlighter-rouge">amqp-bridge</code> service could connect to AMQP1.0 endpoints
+(e.g. <a href="https://www.eclipse.org/hono/">Eclipse Hono</a>).</p>
+
+<p>That worked quite well, but still had some issues:</p>
+
+<ul>
+ <li>failover/reconnection was not always done properly</li>
+ <li>the current connection state could not yet be retrieved</li>
+ <li>AMQP 1.0 is a great protocol including <a href="https://www.reactivemanifesto.org">reactive principles</a> but it still is not very “mainstream”</li>
+ <li>the AMQP 1.0 messages consumed by Ditto already had to be in <a href="protocol-overview.html">Ditto Protocol</a>, otherwise Ditto
+could not understand them</li>
+</ul>
+
+<p>Our current implementation focus lies on two GitHub issues resolving those problems:</p>
+
+<ul>
+ <li><a href="https://github.com/eclipse/ditto/issues/129">Enhance existing AMQP-bridge with AMQP 0.9.1 connectivity</a></li>
+ <li><a href="https://github.com/eclipse/ditto/issues/130">Support mapping arbitrary message payloads in AMQP-bridge</a></li>
+</ul>
+
+<h2 id="changes-and-enhancements">Changes and Enhancements</h2>
+
+<h3 id="renaming">Renaming</h3>
+
+<p>With the new responsibilities of the former amqp-bridge we have renamed the <code class="highlighter-rouge">amqp-bridge-service</code> to <code class="highlighter-rouge">connectivity-service</code>. <br />
+The Docker image and the Maven artifacts are affected by this change.</p>
+
+<h3 id="enhanced-connectivity">Enhanced connectivity</h3>
+
+<p>The new <a href="architecture-services-connectivity.html">connectivity</a> microservice can now manage and handle both AMQP 1.0 and
+AMQP 0.9.1 connections at the same time. <br />
+That means that Ditto from now on supports connecting to running AMQP 1.0 endpoints or to AMQP 0.9.1 brokers (e.g. RabbitMQ).
+The architecture of the <code class="highlighter-rouge">connectivity</code> microservice is designed to also support connecting via other protocols in the future.</p>
+
+<p>Need to connect to a Kafka in order to process digital twin <a href="basic-signals-command.html">commands</a> from there or publish
+<a href="basic-changenotifications.html">change notifications</a>? <br />
+Or want to send all state changes happening to twins to a time series database?</p>
+
+<p>The <code class="highlighter-rouge">connectivity</code> service is the new place to integrate your managed digital twins with other systems.</p>
+
+<h3 id="json-format-of-connections">JSON format of connections</h3>
+
+<p>As Ditto now supports more than AMQP 1.0, we had to adjust the JSON format for creating new connections.
+The new one is documented here: <a href="connectivity-manage-connections.html">Manage connections in connectivity</a>.</p>
+
+<h3 id="payload-mapping-of-external-messages">Payload mapping of external messages</h3>
+
+<p>Eclipse Ditto is about providing access to IoT devices via the <a href="intro-digitaltwins.html">digital twin</a> pattern. In order to
+provide structured APIs for different heterogeneous devices Ditto defines a lightweight JSON based <a href="basic-overview.html">model</a>.</p>
+
+<p>Devices in the IoT, may they be brownfield devices or newly produced devices, will probably not send their data to the
+cloud in the structure and <a href="protocol-overview.html">protocol</a> Ditto requires. They should not need to be aware of something
+like Ditto running in the cloud mirroring them as digital twins.</p>
+
+<p>That’s why we added a JavaScript based payload mapping to the <code class="highlighter-rouge">connectivity</code> service which is responsible for:</p>
+
+<ul>
+ <li>transforming text- or byte-payload from messages consumed via a <code class="highlighter-rouge">source</code> of a created connection to
+<a href="protocol-overview.html">Ditto Protocol</a> <a href="basic-signals-command.html">commands</a> and <a href="basic-messages.html">messages</a></li>
+ <li>transforming back <a href="basic-signals-commandresponse.html">responses</a> issued by commands and <a href="basic-signals-event.html">events</a>
+from Ditto Protocol to some text- or byte-payload before sending the message back via the configured <code class="highlighter-rouge">target</code> channel</li>
+</ul>
+
+<p>The <code class="highlighter-rouge">incoming</code> and <code class="highlighter-rouge">outgoing</code> scripts must be configured when creating a new connection
+<a href="connectivity-manage-connections.html">via DevOps commands</a>.</p>
+
+<h2 id="example">Example</h2>
+<p>Please find more information and examples at:</p>
+
+<ul>
+ <li><a href="connectivity-overview.html">Connectivity overview</a></li>
+ <li><a href="connectivity-mapping.html">Payload mapping in connectivity</a></li>
+</ul>
+
+<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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2018-04-26-milestone-announcement-030-M1.html b/2.0/2018-04-26-milestone-announcement-030-M1.html
new file mode 100644
index 0000000..647b155
--- /dev/null
+++ b/2.0/2018-04-26-milestone-announcement-030-M1.html
@@ -0,0 +1,339 @@
+<!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 Ditto Milestone 0.3.0-M1 </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 Ditto Milestone 0.3.0-M1">{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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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 Ditto Milestone 0.3.0-M1</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2018-04-26T00:00:00+00:00" itemprop="datePublished">Apr 26, 2018</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>After some time of silence of Ditto milestone releases we are very proud to present our next one to the public.</p>
+
+<p>Have a look at the Milestone <a href="release_notes_030-M1.html">0.3.0-M1 release notes</a>.</p>
+
+<p>The main changes are</p>
+
+<ul>
+ <li>switch to <a href="https://www.eclipse.org/openj9/">Eclipse OpenJ9</a> JVM in Ditto’s Docker images</li>
+ <li>renaming of Ditto’s “AMQP bridge” service to “Connectivity” due to more responsibilities for that service:
+ <ul>
+ <li>managing + connecting to AMQP 0.9.1 endpoints as well as to AMQP 1.0 endpoints</li>
+ <li>transforming/mapping message payloads to/from <a href="protocol-overview.html">Ditto Protocol</a></li>
+ <li>for further details, have a look at our <a href="2018-04-25-connectivity-service.html">blogpost about that</a></li>
+ </ul>
+ </li>
+</ul>
+
+<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>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>
+</ul>
+
+<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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2018-05-02-connecting-ditto-hono.html b/2.0/2018-05-02-connecting-ditto-hono.html
new file mode 100644
index 0000000..b235af7
--- /dev/null
+++ b/2.0/2018-05-02-connecting-ditto-hono.html
@@ -0,0 +1,1061 @@
+<!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> Connecting Eclipse Ditto to Eclipse Hono </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Connecting Eclipse Ditto to Eclipse Hono">{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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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">Connecting Eclipse Ditto to Eclipse Hono</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2018-05-02T00:00:00+00:00" itemprop="datePublished">May 2, 2018</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>
+
+
+
+ <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
+is provided via AMQP 1.0.<br />
+By doing so it is for example possible to receive Hono telemetry
+messages (see heading “Northbound Operations”) which a device <code class="highlighter-rouge">demo-device</code> connected to the “southbound” of Hono sends
+via HTTP or MQTT (the currently available protocol adapters of Hono) in Ditto.<br />
+When received, the payload can be translated into a format Ditto understands in order to update the
+<a href="intro-digitaltwins.html">digital twin</a> of the <code class="highlighter-rouge">demo-device</code> device and provide API access to the twin, e.g. via <code class="highlighter-rouge">HTTP</code>
+or <code class="highlighter-rouge">WebSocket</code>.</p>
+
+<p>This blog post walks through the steps required to connect Ditto and Hono by adding a connection between the Hono and
+Ditto sandboxes at</p>
+
+<ul>
+ <li><a href="http://hono.eclipse.org">hono.eclipse.org</a></li>
+ <li><a href="https://ditto.eclipseprojects.io">ditto.eclipseprojects.io</a></li>
+</ul>
+
+<h2 id="scenario">Scenario</h2>
+
+<p>The following graphic illustrates the scenario:</p>
+
+<figure><img class="docimage" src="images/blog/2018-05-02-ditto-hono-digital-twin.png" alt="Ditto-Hono digital twin" style="max-width: 469px" /><figcaption>Scenario for providing a digital twin in Ditto of a device connected via Hono</figcaption></figure>
+
+<p>Let’s assume for this tutorial that we have a device (e.g. containing a sensor) <code class="highlighter-rouge">demo-device</code> which is capable of
+measuring temperature and humidity.</p>
+
+<p>This device sends the sensor telemetry data every 5 minutes via MQTT into the cloud in either of the following formats:</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">"temp"</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">"hum"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.42</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"temp"</span><span class="p">:</span><span class="w"> </span><span class="mf">23.42</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"hum"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.42</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>We want to create a digital twin for this device in order to access the device’s sensor data as API via Eclipse Ditto.</p>
+
+<h2 id="steps-in-hono">Steps in Hono</h2>
+
+<p>The steps in order to get started with Eclipse Hono are documented in the
+<a href="https://www.eclipse.org/hono/getting-started/">Hono getting started</a> and in a new
+<a href="https://blog.bosch-si.com/developer/using-multi-tenancy-in-eclipse-hono/">Blog post about using multi-tenancy in Eclipse Hono</a>.
+We show them very briefly here as well but in order to comprehend what and why we are doing what we do please consult
+the Hono documentation.</p>
+
+<h3 id="create-a-tenant">Create a tenant</h3>
+
+<p>First of all, create a new Hono tenant (we chose the tenant name <code class="highlighter-rouge">org.eclipse.ditto</code>):</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>curl <span class="nt">-X</span> POST <span class="nt">-i</span> <span class="nt">-H</span> <span class="s1">'Content-Type: application/json'</span> <span class="nt">-d</span> <span class="s1">'{"tenant-id": "org.eclipse.ditto"}'</span> http://hono.eclipse.org:28080/tenant
+</code></pre></div></div>
+
+<h3 id="register-a-device">Register a device</h3>
+
+<p>Register a new device in Hono (we chose the device-id <code class="highlighter-rouge">demo-device</code>):</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>curl <span class="nt">-X</span> POST <span class="nt">-i</span> <span class="nt">-H</span> <span class="s1">'Content-Type: application/json'</span> <span class="nt">-d</span> <span class="s1">'{"device-id": "demo-device"}'</span> http://hono.eclipse.org:28080/registration/org.eclipse.ditto
+</code></pre></div></div>
+
+<h3 id="add-a-device-credential">Add a device credential</h3>
+
+<p>In order for the device being able to send telemetry it needs to authenticate. For that we will need to add a credential
+for that device in Hono.</p>
+
+<p>We choose the <code class="highlighter-rouge">hashed-password</code> type:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ PWD_HASH</span><span class="o">=</span><span class="k">$(</span><span class="nb">echo</span> <span class="nt">-n</span> <span class="s1">'demo-device-password'</span> | openssl dgst <span class="nt">-binary</span> <span class="nt">-sha512</span> | base64 <span class="nt">-w</span> 0<span class="k">)</span>
+<span class="nv">$ </span>curl <span class="nt">-X</span> POST <span class="nt">-i</span> <span class="nt">-H</span> <span class="s1">'Content-Type: application/json'</span> <span class="nt">-d</span> <span class="s1">'{
+ "device-id": "demo-device",
+ "type": "hashed-password",
+ "auth-id": "demo-device-auth",
+ "secrets": [{
+ "hash-function" : "sha-512",
+ "pwd-hash": "'</span><span class="nv">$PWD_HASH</span><span class="s1">'"
+ }]
+}'</span> http://hono.eclipse.org:28080/credentials/org.eclipse.ditto
+</code></pre></div></div>
+
+<h3 id="publish-data">Publish data</h3>
+
+<p>You are now able to publish <code class="highlighter-rouge">telemetry</code> (or also <code class="highlighter-rouge">event</code>) data via the Hono HTTP adapter:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>curl <span class="nt">-X</span> POST <span class="nt">-i</span> <span class="nt">-u</span> demo-device-auth@org.eclipse.ditto:demo-device-password <span class="nt">-H</span> <span class="s1">'Content-Type: application/json'</span> <span class="nt">-d</span> <span class="s1">'{"temp": 23.07}'</span> http://hono.eclipse.org:8080/telemetry
+<span class="nv">$ </span>curl <span class="nt">-X</span> POST <span class="nt">-i</span> <span class="nt">-u</span> demo-device-auth@org.eclipse.ditto:demo-device-password <span class="nt">-H</span> <span class="s1">'Content-Type: application/json'</span> <span class="nt">-d</span> <span class="s1">'{"hum": 45.85}'</span> http://hono.eclipse.org:8080/telemetry
+</code></pre></div></div>
+
+<p>However as there is not yet a <code class="highlighter-rouge">consumer</code> listening for the messages, the Hono HTTP adapter will for example return an
+error code <code class="highlighter-rouge">503 - Service unavailable</code> when publishing a <code class="highlighter-rouge">telemetry</code> message.</p>
+
+<p>Alternatively you can also publish telemetry data via MQTT:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>mosquitto_pub <span class="nt">-u</span> <span class="s1">'demo-device-auth@org.eclipse.ditto'</span> <span class="nt">-P</span> demo-device-password <span class="nt">-t</span> telemetry <span class="nt">-m</span> <span class="s1">'{"temp": 23.07}'</span>
+<span class="nv">$ </span>mosquitto_pub <span class="nt">-u</span> <span class="s1">'demo-device-auth@org.eclipse.ditto'</span> <span class="nt">-P</span> demo-device-password <span class="nt">-t</span> telemetry <span class="nt">-m</span> <span class="s1">'{"hum": 45.85}'</span>
+</code></pre></div></div>
+
+<p>In the following steps we will register the missing <code class="highlighter-rouge">consumer</code> in Ditto by creating a connection to the Hono tenant
+in Ditto’s connectivity.</p>
+
+<h2 id="steps-in-ditto">Steps in Ditto</h2>
+
+<p>We want to create a digital twin of the device connected to Eclipse Hono in order to access its latest reported state
+via the Ditto <a href="httpapi-overview.html">HTTP API</a>, in order to be able to find it in a population of digital twins or
+in order to be notified about changed via an API optimized for the web.</p>
+
+<h3 id="create-a-digital-twin">Create a digital twin</h3>
+
+<p>The first step is to create a skeleton for the digital twin by creating a Ditto <code class="highlighter-rouge">Thing</code>.<br />
+Notice that we authenticate with the sandbox user <code class="highlighter-rouge">demo5</code> - a default <a href="basic-policy.html">Policy</a> is implicitly
+created so that only that user may read+write the created <code class="highlighter-rouge">Thing</code>.</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>curl <span class="nt">-X</span> PUT <span class="nt">-i</span> <span class="nt">-u</span> demo5:demo <span class="nt">-H</span> <span class="s1">'Content-Type: application/json'</span> <span class="nt">-d</span> <span class="s1">'{
+ "attributes": {
+ "location": "Germany"
+ },
+ "features": {
+ "temperature": {
+ "properties": {
+ "value": null
+ }
+ },
+ "humidity": {
+ "properties": {
+ "value": null
+ }
+ }
+ }
+}'</span> https://ditto.eclipseprojects.io/api/2/things/org.eclipse.ditto:demo-device
+</code></pre></div></div>
+
+<p>Make sure the digital twin was created:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>curl <span class="nt">-i</span> <span class="nt">-u</span> demo5:demo https://ditto.eclipseprojects.io/api/2/things/org.eclipse.ditto:demo-device
+</code></pre></div></div>
+
+<h3 id="create-a-connection-to-hono">Create a connection to Hono</h3>
+
+<p>Ditto recently added support for <a href="connectivity-manage-connections.html">managing connections</a> to foreign endpoints
+(currently to AMQP 1.0 or to AMQP 0.9.1). As Hono provides an AMQP 1.0 endpoint, a connection can be added in Ditto
+which connects to Hono and acts as a “northbound” <code class="highlighter-rouge">consumer</code>.</p>
+
+<p>The following configuration for the connection has to be applied:</p>
+
+<ul>
+ <li>AMQP 1.0 hostname: <code class="highlighter-rouge">hono.eclipse.org</code></li>
+ <li>AMQP 1.0 port: <code class="highlighter-rouge">15672</code></li>
+ <li>username: <code class="highlighter-rouge">consumer@HONO</code></li>
+ <li>password: <code class="highlighter-rouge">verysecret</code></li>
+ <li>sources:
+ <ul>
+ <li><code class="highlighter-rouge">telemetry/org.eclipse.ditto</code></li>
+ <li><code class="highlighter-rouge">event/org.eclipse.ditto</code></li>
+ </ul>
+ </li>
+</ul>
+
+<h4 id="test-the-connection">Test the connection</h4>
+
+<p>Send the following “test connection” command via HTTP in order to test if the Ditto sandbox can connect to the Hono one.</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>curl <span class="nt">-X</span> POST <span class="nt">-i</span> <span class="nt">-u</span> devops:devopsPw1! <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:testConnection",
+ "connection": {
+ "id": "hono-sandbox-connection-1",
+ "connectionType": "amqp-10",
+ "connectionStatus": "open",
+ "uri": "amqp://consumer%40HONO:verysecret@hono.eclipse.org:15672",
+ "failoverEnabled": true,
+ "sources": [{
+ "addresses": [
+ "telemetry/org.eclipse.ditto",
+ "event/org.eclipse.ditto"
+ ],
+ "authorizationContext": ["nginx:demo5"]
+ }]
+ }
+ }
+}'</span> https://ditto.eclipseprojects.io/devops/piggyback/connectivity?timeout<span class="o">=</span>8s
+</code></pre></div></div>
+
+<p>The result should be:</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">"?"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"-1"</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">"connectivity.responses:testConnection"</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">"connectionId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hono-sandbox-connection-1"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"testResult"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ditto-cluster=Success(successfully connected + initialized mapper)"</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>Great, it looks like with the provided credentials we can connect to the Hono sandbox.</p>
+
+<h4 id="define-a-payload-mapping">Define a payload mapping</h4>
+
+<p>In the <a href="#scenario">scenario</a> we described the payloads our device sends via MQTT. As those JSON payloads are missing
+some information required for Ditto to map it to a <a href="protocol-overview.html">Ditto Protocol</a> message Ditto uses for
+updating the digital twin, we have to configure a <a href="connectivity-mapping.html">payload mapping</a> in order to add the
+missing information.</p>
+
+<p>Whenever one of the 3 following messages arrives at Ditto’s <code class="highlighter-rouge">consumer</code>, a payload mapping should be performed:</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">"temp"</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">"hum"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.42</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"temp"</span><span class="p">:</span><span class="w"> </span><span class="mf">23.42</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"hum"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.42</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>A JavaScript based mapping which exactly does this could look like this:</p>
+
+<div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><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="k">if</span> <span class="p">(</span><span class="nx">contentType</span> <span class="o">!==</span> <span class="s2">"application/json"</span><span class="p">)</span> <span class="p">{</span>
+ <span class="k">return</span> <span class="kc">null</span><span class="p">;</span> <span class="c1">// only handle messages with content-type application/json</span>
+ <span class="p">}</span>
+
+ <span class="kd">var</span> <span class="nx">jsonData</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="kd">var</span> <span class="nx">temperature</span> <span class="o">=</span> <span class="nx">jsonData</span><span class="p">.</span><span class="nx">temp</span><span class="p">;</span>
+ <span class="kd">var</span> <span class="nx">humidity</span> <span class="o">=</span> <span class="nx">jsonData</span><span class="p">.</span><span class="nx">hum</span><span class="p">;</span>
+
+ <span class="kd">var</span> <span class="nx">path</span><span class="p">;</span>
+ <span class="kd">var</span> <span class="nx">value</span><span class="p">;</span>
+ <span class="k">if</span> <span class="p">(</span><span class="nx">temperature</span> <span class="o">!=</span> <span class="kc">null</span> <span class="o">&&</span> <span class="nx">humidity</span> <span class="o">!=</span> <span class="kc">null</span><span class="p">)</span> <span class="p">{</span>
+ <span class="nx">path</span> <span class="o">=</span> <span class="s2">"/features"</span><span class="p">;</span>
+ <span class="nx">value</span> <span class="o">=</span> <span class="p">{</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">temperature</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">humidity</span>
+ <span class="p">}</span>
+ <span class="p">}</span>
+ <span class="p">};</span>
+ <span class="p">}</span> <span class="k">else</span> <span class="k">if</span> <span class="p">(</span><span class="nx">temperature</span> <span class="o">!=</span> <span class="kc">null</span><span class="p">)</span> <span class="p">{</span>
+ <span class="nx">path</span> <span class="o">=</span> <span class="s2">"/features/temperature/properties/value"</span><span class="p">;</span>
+ <span class="nx">value</span> <span class="o">=</span> <span class="nx">temperature</span><span class="p">;</span>
+ <span class="p">}</span> <span class="k">else</span> <span class="k">if</span> <span class="p">(</span><span class="nx">humidity</span> <span class="o">!=</span> <span class="kc">null</span><span class="p">)</span> <span class="p">{</span>
+ <span class="nx">path</span> <span class="o">=</span> <span class="s2">"/features/humidity/properties/value"</span><span class="p">;</span>
+ <span class="nx">value</span> <span class="o">=</span> <span class="nx">humidity</span><span class="p">;</span>
+ <span class="p">}</span>
+
+ <span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="nx">path</span> <span class="o">||</span> <span class="o">!</span><span class="nx">value</span><span class="p">)</span> <span class="p">{</span>
+ <span class="k">return</span> <span class="kc">null</span><span class="p">;</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="s2">"org.eclipse.ditto"</span><span class="p">,</span> <span class="c1">// the namespace we use</span>
+ <span class="nx">headers</span><span class="p">[</span><span class="s2">"device_id"</span><span class="p">],</span> <span class="c1">// Hono sets the authenticated device-id in this header</span>
+ <span class="s2">"things"</span><span class="p">,</span> <span class="c1">// it is a Thing entity we want to update</span>
+ <span class="s2">"twin"</span><span class="p">,</span> <span class="c1">// we want to update the twin</span>
+ <span class="s2">"commands"</span><span class="p">,</span>
+ <span class="s2">"modify"</span><span class="p">,</span> <span class="c1">// command = modify</span>
+ <span class="nx">path</span><span class="p">,</span>
+ <span class="nx">headers</span><span class="p">,</span> <span class="c1">// copy all headers as Ditto headers</span>
+ <span class="nx">value</span>
+ <span class="p">);</span>
+<span class="p">}</span>
+</code></pre></div></div>
+
+<p>In order to add this script to the connection we want to create, the newlines have to be replaced by <code class="highlighter-rouge">\n</code> so that
+the script fits in a single line JSON string and the <code class="highlighter-rouge">"</code> characters have to be replaced with <code class="highlighter-rouge">\"</code>:</p>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="s2">"function mapToDittoProtocolMsg(</span><span class="se">\n</span><span class="s2"> headers,</span><span class="se">\n</span><span class="s2"> textPayload,</span><span class="se">\n</span><span class="s2"> bytePayload,</span><span class="se">\n</span><span class="s2"> contentType</span><span class="se">\n</span><span class="s2">) {</span><span class="se">\n\n</span><span class="s2"> if (contentType !== </span><span class="se">\"</span><span class="s2">application/json</span><span class="se">\"</span><span class="s2">) {</span><span class="se">\n</span><span class="s2"> return null;</span><span class="se">\n</span><span class="s2"> }</span><span class="se">\n\n</span><span class="s2"> var jsonData = JSON.parse(textPayload);</span><span class="se">\n</span><span class="s2"> var temperature = jsonData.temp;</span><span class="se">\n</span><span class="s2"> var humidity = jsonData.hum;</span><span class="se">\n</span><span class="s2"> </span><span class="se">\n</span><span class="s2"> var path;</span><span class="se">\n</span><span class="s2"> var value;</span><span class="se">\n</span><span class="s2"> if (temperature != null && humidity != null) {</span><span class="se">\n</span><span class="s2"> path = </span><span class="se">\"</span><span class="s2">/features</span><span class="se">\"</span><span class="s2">;</span><span class="se">\n</span><span class="s2"> value = {</span><span class="se">\n</span><span class="s2"> temperature: {</span><span class="se">\n</span><span class="s2"> properties: {</span><span class="se">\n</span><span class="s2"> value: temperature</span><span class="se">\n</span><span class="s2"> }</span><span class="se">\n</span><span class="s2"> },</span><span class="se">\n</span><span class="s2"> humidity: {</span><span class="se">\n</span><span class="s2"> properties: {</span><span class="se">\n</span><span class="s2"> value: humidity</span><span class="se">\n</span><span class="s2"> }</span><span class="se">\n</span><span class="s2"> }</span><span class="se">\n</span><span class="s2"> };</span><span class="se">\n</span><span class="s2"> } else if (temperature != null) {</span><span class="se">\n</span><span class="s2"> path = </span><span class="se">\"</span><span class="s2">/features/temperature/properties/value</span><span class="se">\"</span><span class="s2">;</span><span class="se">\n</span><span class="s2"> value = temperature;</span><span class="se">\n</span><span class="s2"> } else if (humidity != null) {</span><span class="se">\n</span><span class="s2"> path = </span><span class="se">\"</span><span class="s2">/features/humidity/properties/value</span><span class="se">\"</span><span class="s2">;</span><span class="se">\n</span><span class="s2"> value = humidity;</span><span class="se">\n</span><span class="s2"> }</span><span class="se">\n</span><span class="s2"> </span><span class="se">\n</span><span class="s2"> if (!path || !value) {</span><span class="se">\n</span><span class="s2"> return null;</span><span class="se">\n</span><span class="s2"> }</span><span class="se">\n\n</span><span class="s2"> return Ditto.buildDittoProtocolMsg(</span><span class="se">\n</span><span class="s2"> </span><span class="se">\"</span><span class="s2">org.eclipse.ditto</span><span class="se">\"</span><span class="s2">,</span><span class="se">\n</span><span class="s2"> headers[</span><span class="se">\"</span><span class="s2">device_id</span><span class="se">\"</span><span class="s2">],</span><span class="se">\n</span><span class="s2"> </span><span class="se">\"</span><span class="s2">things</span><span class="se">\"</span><span class="s2">,</span><span class="se">\n</span><span class="s2"> </span><span class="se">\"</span><span class="s2">twin</span><span class="se">\"</span><span class="s2">,</span><span class="se">\n</span><span class="s2"> </span><span class="se">\"</span><span class="s2">commands</span><span class="se">\"</span><span class="s2">,</span><span class="se">\n</span><span class="s2"> </span><span class="se">\"</span><span class="s2">modify</span><span class="se">\"</span><span class="s2">,</span><span class="se">\n</span><span class="s2"> path,</span><span class="se">\n</span><span class="s2"> headers,</span><span class="se">\n</span><span class="s2"> value</span><span class="se">\n</span><span class="s2"> );</span><span class="se">\n</span><span class="s2">}"</span><span class="w">
+</span></code></pre></div></div>
+
+<h4 id="create-the-connection">Create the connection</h4>
+
+<p>We use the payload of the previous “test connection” command and add the JavaScript mapping script from above in order
+to specify the “create connection” command, which we will use to create the connection between Eclipse Hono and Ditto:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>curl <span class="nt">-X</span> POST <span class="nt">-i</span> <span class="nt">-u</span> devops:devopsPw1! <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": "hono-sandbox-connection-1",
+ "connectionType": "amqp-10",
+ "connectionStatus": "open",
+ "uri": "amqp://consumer%40HONO:verysecret@hono.eclipse.org:15672",
+ "failoverEnabled": true,
+ "sources": [{
+ "addresses": [
+ "telemetry/org.eclipse.ditto",
+ "event/org.eclipse.ditto"
+ ],
+ "authorizationContext": ["nginx:demo5"]
+ }],
+ "mappingContext": {
+ "mappingEngine": "JavaScript",
+ "options": {
+ "incomingScript": "function mapToDittoProtocolMsg(\n headers,\n textPayload,\n bytePayload,\n contentType\n) {\n\n if (contentType !== \"application/json\") {\n return null;\n }\n\n var jsonData = JSON.parse(textPayload);\n var temperature = jsonData.temp;\n var humidity = jsonData.hum;\n \n var path;\n var value;\n if (temperature != null && humidity != null) {\n path = \"/features\";\n value = {\n temperature: {\n properties: {\n value: temperature\n }\n },\n humidity: {\n properties: {\n value: humidity\n }\n }\n };\n } else if (temperature != null) {\n path = \"/features/temperature/properties/value\";\n value = temperature;\n } else if (humidity != null) {\n path = \"/features/humidity/properties/value\";\n value = humidity;\n }\n \n if (!path || !value) {\n return null;\n }\n\n return Ditto.buildDittoProtocolMsg(\n \"org.eclipse.ditto\",\n headers[\"device_id\"],\n \"things\",\n \"twin\",\n \"commands\",\n \"modify\",\n path,\n headers,\n value\n );\n}"
+ }
+ }
+ }
+ }
+}'</span> https://ditto.eclipseprojects.io/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,
+otherwise an error message would be returned.</p>
+
+<h4 id="retrieve-connection-metrics">Retrieve connection metrics</h4>
+
+<p>After the connection was created, we can use the following command in order to retrieve the current connection status
+and some metrics about how many messages were consumed:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>curl <span class="nt">-X</span> POST <span class="nt">-i</span> <span class="nt">-u</span> devops:devopsPw1! <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:retrieveConnectionMetrics",
+ "connectionId": "hono-sandbox-connection-1"
+ }
+}'</span> https://ditto.eclipseprojects.io/devops/piggyback/connectivity?timeout<span class="o">=</span>8s
+</code></pre></div></div>
+
+<p>The result looks 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">"?"</span><span class="p">:</span><span class="w"> </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><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"connectivity.responses:retrieveConnectionMetrics"</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">"connectionId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"hono-sandbox-connection-1"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"containsFailures"</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">"connectionMetrics"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"inbound"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"consumed"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"success"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2019-02-06T09:37:28.416Z"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"failure"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"mapped"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"success"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2019-02-06T09:37:28.422Z"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"failure"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"dropped"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"success"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"failure"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"enforced"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"success"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2019-02-06T09:37:28.422Z"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"failure"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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">"outbound"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"dispatched"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"success"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"failure"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2019-02-06T09:37:28.439Z"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"filtered"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"success"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"failure"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"mapped"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"success"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2019-02-06T09:37:28.443Z"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"failure"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"dropped"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"success"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"failure"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"published"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"success"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"failure"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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">"sourceMetrics"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"addressMetrics"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"event/org.eclipse.ditto"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"consumed"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"success"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"failure"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"mapped"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"success"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"failure"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"dropped"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"success"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"failure"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"enforced"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"success"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"failure"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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">"telemetry/org.eclipse.ditto"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"consumed"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"success"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2019-02-06T09:37:28.416Z"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"failure"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"mapped"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"success"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2019-02-06T09:37:28.422Z"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"failure"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"dropped"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"success"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"failure"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"enforced"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"success"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2019-02-06T09:37:28.422Z"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"failure"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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">"targetMetrics"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"addressMetrics"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"_responses"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"dispatched"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"success"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"failure"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2019-02-06T09:37:28.439Z"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"filtered"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"success"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"failure"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"mapped"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"success"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2019-02-06T09:37:28.443Z"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"failure"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"dropped"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"success"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"failure"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"published"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"success"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"failure"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"PT1M"</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">"PT1H"</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">"PT24H"</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">"lastMessageAt"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="test-the-integration">Test the integration</h2>
+
+<p>Whenever the device now sends telemetry in its own JSON format</p>
+
+<ul>
+ <li>the message count of the <a href="#retrieve-connection-metrics">connection metrics in Ditto</a> should be increased by one</li>
+ <li>the digital twin with the <code class="highlighter-rouge">Thing</code> ID <code class="highlighter-rouge">org.eclipse.ditto:demo-device</code> should receive the updated value which is also
+reflected at the twin’s HTTP endpoint
+<a href="https://demo5:demo@ditto.eclipseprojects.io/api/2/things/org.eclipse.ditto:demo-device">https://ditto.eclipseprojects.io/api/2/things/org.eclipse.ditto:demo-device</a></li>
+</ul>
+
+<p>Verify that by simulate sending telemetry using the Hono HTTP adapter:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>curl <span class="nt">-X</span> POST <span class="nt">-i</span> <span class="nt">-u</span> demo-device-auth@org.eclipse.ditto:demo-device-password <span class="nt">-H</span> <span class="s1">'Content-Type: application/json'</span> <span class="nt">-d</span> <span class="s1">'{"temp": 14.51}'</span> http://hono.eclipse.org:8080/telemetry
+<span class="nv">$ </span>curl <span class="nt">-X</span> POST <span class="nt">-i</span> <span class="nt">-u</span> demo-device-auth@org.eclipse.ditto:demo-device-password <span class="nt">-H</span> <span class="s1">'Content-Type: application/json'</span> <span class="nt">-d</span> <span class="s1">'{"hum": 52.17}'</span> http://hono.eclipse.org:8080/telemetry
+
+<span class="nv">$ </span>curl <span class="nt">-X</span> POST <span class="nt">-i</span> <span class="nt">-u</span> demo-device-auth@org.eclipse.ditto:demo-device-password <span class="nt">-H</span> <span class="s1">'Content-Type: application/json'</span> <span class="nt">-d</span> <span class="s1">'{"temp": 23.07, "hum": 45.85}'</span> http://hono.eclipse.org:8080/telemetry
+</code></pre></div></div>
+
+<p><br />
+<br /></p>
+
+<p>Try it out for yourself and give us (the Ditto and the Hono teams) feedback what you like or what could be improved.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2018-06-15-milestone-announcement-030-M2.html b/2.0/2018-06-15-milestone-announcement-030-M2.html
new file mode 100644
index 0000000..1f0e234
--- /dev/null
+++ b/2.0/2018-06-15-milestone-announcement-030-M2.html
@@ -0,0 +1,339 @@
+<!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 Ditto Milestone 0.3.0-M2 </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 Ditto Milestone 0.3.0-M2">{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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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 Ditto Milestone 0.3.0-M2</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2018-06-15T00:00:00+00:00" itemprop="datePublished">Jun 15, 2018</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>Today we, the Eclipse Ditto team, are happy to announce our next milestone 0.3.0-M2.</p>
+
+<p>The main changes are</p>
+
+<ul>
+ <li>improvement of Ditto’s cluster performance with many managed Things
+ <ul>
+ <li>a new Ditto service <a href="architecture-services-concierge.html">ditto-concierge</a> was added for this</li>
+ </ul>
+ </li>
+ <li>improved cluster bootstrapping based on DNS with the potential to easy plugin other mechanism (e.g. for Kubernetes)</li>
+</ul>
+
+<p>Have a look at the Milestone <a href="release_notes_030-M2.html">0.3.0-M2 release notes</a> for a detailed description of what
+changed.</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>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>
+
+<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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2018-08-14-milestone-announcement-080-M1.html b/2.0/2018-08-14-milestone-announcement-080-M1.html
new file mode 100644
index 0000000..ccf0650
--- /dev/null
+++ b/2.0/2018-08-14-milestone-announcement-080-M1.html
@@ -0,0 +1,339 @@
+<!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 Ditto Milestone 0.8.0-M1 </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 Ditto Milestone 0.8.0-M1">{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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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 Ditto Milestone 0.8.0-M1</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2018-08-14T00:00:00+00:00" itemprop="datePublished">Aug 14, 2018</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>Even during the summer break the Ditto team worked hard in order to provide the next milestone release. Here it is:
+Milestone 0.8.0-M1.</p>
+
+<p>Have a look at the Milestone <a href="release_notes_080-M1.html">0.8.0-M1 release notes</a> for what changed in detail and why
+there was a version bump from 0.3.0-M2 to 0.8.0-M1.</p>
+
+<p>The main changes and new features are</p>
+
+<ul>
+ <li>security enhancement by making some of Ditto’s headers not settable from the outside</li>
+ <li>report application metrics to Prometheus</li>
+ <li>automatically form a cluster when running in Kubernetes</li>
+ <li>improvement of Ditto’s <code class="highlighter-rouge">things-service</code> memory consumption</li>
+ <li>stabilization of the connectivity to AMQP 1.0 and 0.9.1</li>
+</ul>
+
+<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>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>
+
+<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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2018-09-21-selective-push-notifications.html b/2.0/2018-09-21-selective-push-notifications.html
new file mode 100644
index 0000000..36fb04c
--- /dev/null
+++ b/2.0/2018-09-21-selective-push-notifications.html
@@ -0,0 +1,539 @@
+<!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="blogconnectivityrql, ">
+<title> Selective push notifications available </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Selective push notifications available">{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/a8d528a8ecb11113b79e11e54e73a323?s=135" alt="A photo of Philipp Michalski" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.com/phalski" target="_blank">Philipp Michalski</a>-->
+<!--</span>-->
+<!---->
+
+<article class="post" itemscope itemtype="http://schema.org/BlogPosting">
+
+ <header class="post-header">
+ <h1 class="post-title" itemprop="name headline">Selective push notifications available</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/a8d528a8ecb11113b79e11e54e73a323?s=135" alt="A photo of Philipp Michalski" 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="https://github.com/phalski" target="_blank">Philipp Michalski</a> </span></span> on <time datetime="2018-09-21T00:00:00+00:00" itemprop="datePublished">Sep 21, 2018</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>,
+
+
+
+ <a href="tag_connectivity.html">connectivity</a>,
+
+
+
+ <a href="tag_rql.html">rql</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>
+
+
+
+ <p>The <a href="architecture-services-connectivity.html">connectivity service</a> supercharged Ditto’s flexibility in integrating with other services.
+It’s such a great feature to let the other connected services know about thing updates and property changes.
+Even the direct exchange with real-world assets became more flexible through the multi-protocol support.
+But with a steady increase in connected devices, those messages easily sum up to a huge number.</p>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> In order to simplify a little, we here use the term <code class="highlighter-rouge">message</code> as synonym for both Ditto
+ <a href="basic-signals.html">signals</a> and <a href="basic-messages.html">messages</a>.</div>
+
+<p>Also, not every consuming application needs to know everything that’s going on.
+In fact, the only use case that requires processing of every message is logging.
+Therefore most of the times an application waits for a specific message to trigger a specific action.
+So all other messages are discarded unused.
+This adds a lot of unnecessary overhead both to the message transport capabilities and the processing of messages at the receiving end.</p>
+
+<p>But what if you could avoid receiving those messages at all.<br />
+Well, you can!<br />
+This is exactly what selective push notifications do:
+Configurable message filters that are applied to Ditto’s publishing connection before anything goes on the line.
+They can help you with a lot of problems in a bunch of scenarios:</p>
+
+<ul>
+ <li>Bandwidth limitations: The amount of occurring events is too large and/or frequent to be delivered via the available channels. With selective message filters, you can mute the noise in your event stream.</li>
+ <li>Information hiding: Let consuming services only know what they need to know. Message filters allow you to control all published content in great detail.</li>
+ <li>Specialized notifications: A specific event filter can be used to set a value thresholds or a status-change trigger. This removes the burden of implementing filter logic on the application side.</li>
+ <li>Event routing: Create multiple connections with Ditto’s connectivity service and route your events through those aligned with your requirements. All by specifying appropriate filters for your connection targets.</li>
+</ul>
+
+<p>The following diagram visualizes this context:</p>
+
+<p><img src="images/blog/2018-09-21-selective-push-notifications-visual-comparison.png" alt="visual comparison" /></p>
+
+<p>With the upcoming Ditto release <code class="highlighter-rouge">0.8.0-M2</code>, those filters are available for the following endpoints:</p>
+
+<ul>
+ <li>WebSocket</li>
+ <li>Server-Sent Events (SSE)</li>
+ <li>All supported connectivity protocols (AMQP 0.9.1, AMQP 1.0 / <a href="https://eclipse.org/hono/">Eclipse Hono</a>, MQTT)</li>
+</ul>
+
+<p>You can use a basic namespace filter on the following topics:</p>
+
+<ul>
+ <li>Twin events</li>
+ <li>Live events</li>
+ <li>Live messages</li>
+ <li>Live commands</li>
+</ul>
+
+<p>This filter is a comma-separated list of selected namespaces. It only allows messages related to one of the given namespaces.</p>
+
+<p>Furthermore, there is an additional <a href="basic-rql.html">RQL filter</a> for an advanced description of twin and live events.
+Powered by the mighty syntax of Ditto’s search API it allows configuring the selected events in the same manner as you search for things.</p>
+
+<p>Check out the <a href="basic-changenotifications.html#filtering">documentation</a> for more information on options and configuration.</p>
+
+<h2 id="a-simple-example">A simple example</h2>
+
+<p>Imagine you have a flat with multiple environmental sensors: Some measure temperature, some humidity and some both.
+This information can be useful for different applications.
+In our case, a smart thermostat uses the sensor data to control the indoor climate and there is also a fire alarm installed that detects fires by abnormal high measured temperatures</p>
+
+<p>The following figure displays this setting:</p>
+
+<p><img src="images/blog/2018-09-21-selective-push-notifications-example-setup.png" alt="example setup" /></p>
+
+<p>So let’s start with the prerequisites. You need:</p>
+
+<ul>
+ <li>A running Ditto instance with a valid user (You can follow our <a href="intro-hello-world.html">Hello World example</a> to create one). This example uses dittos default user on a locally running instance.</li>
+ <li>A tool for executing HTTP requests (e.g. Ditto’s Swagger API, cURL, Postman). We use this to create our twins and simulate the sensors.</li>
+ <li>A modern browser supporting WebSockets. This example uses <a href="https://websocket.org/echo.html">websocket.org</a> as a websocket client. The site will tell you if your browser supports the WebSocket protocol. We will mock our applications this way.</li>
+</ul>
+
+<h3 id="the-digital-twins">The digital twins</h3>
+
+<p>First we configure our sensors digital twins:</p>
+
+<p>A temperature sensor</p>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-X</span> PUT <span class="nt">-u</span> <span class="s1">'ditto:ditto'</span> <span class="nt">--header</span> <span class="s1">'Content-Type: application/json'</span> <span class="nt">-d</span> <span class="se">\</span>
+ <span class="s1">'{
+ "features": {
+ "environmentSensor": {
+ "properties": {
+ "temperature": 0.0
+ }
+ }
+ }
+ }'</span> <span class="se">\</span>
+ <span class="s1">'http://localhost:8080/api/2/things/org.eclipse.ditto%3ATemperatureSensor'</span>
+</code></pre></div></div>
+
+<p>A humidity sensor</p>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-X</span> PUT <span class="nt">-u</span> <span class="s1">'ditto:ditto'</span> <span class="nt">--header</span> <span class="s1">'Content-Type: application/json'</span> <span class="nt">-d</span> <span class="se">\</span>
+ <span class="s1">'{
+ "features": {
+ "environmentSensor": {
+ "properties": {
+ "humidity": 0
+ }
+ }
+ }
+ }'</span> <span class="se">\</span>
+ <span class="s1">'http://localhost:8080/api/2/things/org.eclipse.ditto%3AHumiditySensor'</span>
+</code></pre></div></div>
+
+<p>A combined temperature and humidity sensor</p>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-X</span> PUT <span class="nt">-u</span> <span class="s1">'ditto:ditto'</span> <span class="nt">--header</span> <span class="s1">'Content-Type: application/json'</span> <span class="nt">-d</span> <span class="se">\</span>
+ <span class="s1">'{
+ "features": {
+ "environmentSensor": {
+ "properties": {
+ "temperature": 0.0,
+ "humidity": 0
+ }
+ }
+ }
+ }'</span> <span class="se">\</span>
+ <span class="s1">'http://localhost:8080/api/2/things/org.eclipse.ditto%3ATemperatureAndHumiditySensor'</span>
+</code></pre></div></div>
+
+<p>And finally, a teapot</p>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-X</span> PUT <span class="nt">-u</span> <span class="s1">'ditto:ditto'</span> <span class="nt">--header</span> <span class="s1">'Content-Type: application/json'</span> <span class="nt">-d</span> <span class="se">\</span>
+ <span class="s1">'{}'</span> <span class="se">\</span>
+ <span class="s1">'http://localhost:8080/api/2/things/org.eclipse.ditto%3ATeapot'</span>
+</code></pre></div></div>
+
+<h3 id="mocking-the-consuming-applications">Mocking the consuming applications</h3>
+
+<p>Open your browser on https://websocket.org/echo.html.
+This site allows you to connect with any WebSocket endpoint and supports simple sending and receiving of messages. The interface is shown below:</p>
+
+<p><img src="images/blog/2018-09-21-selective-push-notifications-websocket_org.png" alt="websocket.org site" /></p>
+
+<p>Enter Ditto’s WebSocket endpoint with user credentials <code class="highlighter-rouge">ws://ditto:ditto@localhost:8080/ws/2</code> and hit the <em>Connect</em> button.
+The log output should confirm the action by printing a simple <code class="highlighter-rouge">CONNECTED</code>.</p>
+
+<p>This means the socket is open and you’re able to receive messages from Ditto.
+But first, you should let Ditto know in what kind of messages you’re interested.
+This interest differs for both of the example applications:</p>
+
+<p>The thermostat app only needs to know every humidity and temperature report so you can define a filter for change events on twins having those properties:</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>START-SEND-EVENTS?filter=or(exists(features/environmentSensor/properties/temperature),exists(features/environmentSensor/properties/humidity))
+</code></pre></div></div>
+
+<p>Paste it into the <em>Message</em> input and use the <em>Send</em> button to post it. Ditto should acknowledge with a <code class="highlighter-rouge">START-SEND-EVENTS:ACK</code>.</p>
+
+<p>That’s it for our thermostat app, let’s proceed to the fire alarm.
+Open https://websocket.org/echo.html again in a separate tab and repeat the connection process.
+But instead of consuming all temperature and humidity reports, we only want to be notified when a specific temperature threshold is exceeded.
+90°C seems to be a solid value for this:</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>START-SEND-EVENTS?filter=gt(features/environmentSensor/properties/temperature,90)
+</code></pre></div></div>
+
+<p>After receiving Ditto’s acknowledgment, you’re done with the configuration.</p>
+
+<h3 id="report-mocked-sensor-values-to-ditto">Report mocked sensor values to Ditto</h3>
+
+<p>Use Ditto’s HTTP API to send mocked data on behalf of our sensors. First report a new humidity value for the humidity sensor:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-X</span> PUT <span class="nt">-u</span> <span class="s1">'ditto:ditto'</span> <span class="nt">--header</span> <span class="s1">'Content-Type: application/json'</span> <span class="nt">-d</span> <span class="se">\</span>
+ <span class="s1">'55'</span> <span class="se">\</span>
+ <span class="s1">'http://localhost:8080/api/2/things/org.eclipse.ditto%3AHumiditySensor/features/environmentSensor/properties/humidity'</span>
+</code></pre></div></div>
+
+<p>Now check both websocket.org tabs. The thermostat tab should have received an event with the reported value while nothing happened in the alarm tab.</p>
+
+<p>Continue with some temperature data from another sensor:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-X</span> PUT <span class="nt">-u</span> <span class="s1">'ditto:ditto'</span> <span class="nt">--header</span> <span class="s1">'Content-Type: application/json'</span> <span class="nt">-d</span> <span class="se">\</span>
+ <span class="s1">'23'</span> <span class="se">\</span>
+ <span class="s1">'http://localhost:8080/api/2/things/org.eclipse.ditto%3ATemperatureAndHumiditySensor/features/environmentSensor/properties/temperature'</span>
+</code></pre></div></div>
+<p>The value change should be reported to the thermostat, but still no events for the alarm tab.</p>
+
+<p>Finally it’s time to start a fire. Report a very high temperature for the third sensor:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-X</span> PUT <span class="nt">-u</span> <span class="s1">'ditto:ditto'</span> <span class="nt">--header</span> <span class="s1">'Content-Type: application/json'</span> <span class="nt">-d</span> <span class="se">\</span>
+ <span class="s1">'120'</span> <span class="se">\</span>
+ <span class="s1">'http://localhost:8080/api/2/things/org.eclipse.ditto%3ATemperatureSensor/features/environmentSensor/properties/temperature'</span>
+</code></pre></div></div>
+
+<p>Now both applications should have received the reported data, and the fire alarm can use this event to (virtually) trigger its bell.</p>
+
+<p>But what about the teapot? Let him declare his identity by setting a personal message:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-X</span> PUT <span class="nt">-u</span> <span class="s1">'ditto:ditto'</span> <span class="nt">--header</span> <span class="s1">'Content-Type: application/json'</span> <span class="nt">-d</span> <span class="se">\</span>
+ <span class="s1">'{
+ "properties": {
+ "message": "I'</span><span class="se">\'</span><span class="s1">'m a teapot"
+ }
+ }'</span> <span class="se">\</span>
+ <span class="s1">'http://localhost:8080/api/2/things/org.eclipse.ditto%3ATeapot/features/status'</span>
+</code></pre></div></div>
+
+<p>Unfortunately, no one cares and this no one is notified about that change.</p>
+
+<p><br />
+We do hope that <strong>you</strong> care about this feature, we think it’s really awesome.
+<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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2018-09-27-milestone-announcement-080-M2.html b/2.0/2018-09-27-milestone-announcement-080-M2.html
new file mode 100644
index 0000000..1e9926e
--- /dev/null
+++ b/2.0/2018-09-27-milestone-announcement-080-M2.html
@@ -0,0 +1,341 @@
+<!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 Ditto Milestone 0.8.0-M2 </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 Ditto Milestone 0.8.0-M2">{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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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 Ditto Milestone 0.8.0-M2</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2018-09-27T00:00:00+00:00" itemprop="datePublished">Sep 27, 2018</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>Brace yourself, Eclipse Ditto is preparing for its
+<a href="https://projects.eclipse.org/projects/iot.ditto/releases/0.8.0">first release 0.8.0</a>. We are happy to announce our next
+milestone towards that goal.</p>
+
+<p>Have a look at the Milestone <a href="release_notes_080-M2.html">0.8.0-M2 release notes</a> for what changed in detail.</p>
+
+<p>The main changes and new features are</p>
+
+<ul>
+ <li>enforcement of max. entity size of twins and messages</li>
+ <li>added MQTT support connecting to MQTT 3.1.1 brokers</li>
+ <li>subscribing to changes based on filters</li>
+ <li>conditional requests at all APIs</li>
+</ul>
+
+<h2 id="artifacts">Artifacts</h2>
+
+<p>Unfortunately, we had some problems during the milestone release build causing that the released artifacts have version
+<code class="highlighter-rouge">0.8.0-M2b</code> instead of <code class="highlighter-rouge">0.8.0-M2</code>.</p>
+
+<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>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>
+
+<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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2018-10-16-example-mqtt-bidirectional.html b/2.0/2018-10-16-example-mqtt-bidirectional.html
new file mode 100644
index 0000000..3ba8a44
--- /dev/null
+++ b/2.0/2018-10-16-example-mqtt-bidirectional.html
@@ -0,0 +1,347 @@
+<!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> Example demonstrating connectivity to an MQTT broker </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Example demonstrating connectivity to an MQTT broker">{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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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">Example demonstrating connectivity to an MQTT broker</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2018-10-16T00:00:00+00:00" itemprop="datePublished">Oct 16, 2018</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>Eclipse Ditto can now connect to MQTT 3.1.1 brokers.</p>
+
+<p>Perfect timing to happily welcome a new colleague to our team behind Eclipse Ditto: <a href="https://github.com/joosdavid">David</a>.</p>
+
+<p>In order to get familiar with Ditto and the development with digital twins, David was assigned with one of his first
+tasks to get his hands on one of our newest features, <a href="connectivity-protocol-bindings-mqtt.html">MQTT connectivity</a>
+which was released recently with milestone <a href="2018-09-27-milestone-announcement-080-M2.html">0.8.0-M2</a>.</p>
+
+<p>On his journey into digital twin land he made a great example with an ESP8266 powered board connected via an MQTT broker
+to Ditto and published it to the
+<a href="https://github.com/eclipse/ditto-examples/tree/master/mqtt-bidirectional">Eclipse Ditto examples repository</a>:</p>
+
+<blockquote>
+ <p>This example is about how to communicate between device and solution in a two way pattern through Ditto using MQTT.
+ This means we will add a policy, a thing and a MQTT connection to Ditto.
+ When Ditto ist set up and working, we will create real world device (“octopus board”) and connect it to it’s
+ digital twin via MQTT.
+ <br /><br />
+ At the end, we will create a basic frontend webapp.
+ The webapp will automatically connect to Ditto when you type in your credentials, automatically pull your things
+ and show them in a list.
+ <br />
+ You can create, modify and delete devices in the webapp and if there is a real world device connected to the thing
+ in the list, you can send it a command message to control any feature on it.
+ The list of things will always be up-to-date when you listen to server-sent-events, which you can activate easily
+ with pressing a button.</p>
+</blockquote>
+
+<figure><img class="docimage" src="https://raw.githubusercontent.com/eclipse/ditto-examples/master/mqtt-bidirectional/img/diagram.jpg" alt="Eclipse Ditto bidirectional MQTT diagram" style="max-width: 800px" /><figcaption>Source: https://github.com/eclipse/ditto-examples</figcaption></figure>
+
+<blockquote>
+ <p>We will use an Octopus-board with an ESP8266 on it. It has several sensors built in, but for simplicity we will
+ just use it’s temperature and altitude sensor.
+ <br />
+ To show the functionality of Eclipse Ditto messages, we will switch on/off a LED on the Octopus-board through it.</p>
+</blockquote>
+
+<p>If you have any wishes, improvements, are missing something
+or just want to get in touch with us, you can use one of
+our <a href="https://eclipse.org/ditto/feedback.html">feedback channels</a>.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2018-11-14-milestone-announcement-080-M3.html b/2.0/2018-11-14-milestone-announcement-080-M3.html
new file mode 100644
index 0000000..8696ae8
--- /dev/null
+++ b/2.0/2018-11-14-milestone-announcement-080-M3.html
@@ -0,0 +1,340 @@
+<!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 Ditto Milestone 0.8.0-M3 </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 Ditto Milestone 0.8.0-M3">{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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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 Ditto Milestone 0.8.0-M3</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2018-11-14T00:00:00+00:00" itemprop="datePublished">Nov 14, 2018</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>Preparing the upcoming first release <a href="https://projects.eclipse.org/projects/iot.ditto/releases/0.8.0">0.8.0</a> of
+Eclipse Ditto, this milestone is a last checkpoint to ensure that the release will be performed smoothly.<br />
+Therefore, this milestone release primarily focuses on stabilization.</p>
+
+<p>Have a look at the Milestone <a href="release_notes_080-M3.html">0.8.0-M3 release notes</a> for what changed in detail.</p>
+
+<div class="alert alert-danger" role="alert"><i class="fa fa-exclamation-circle"></i> <b>Warning:</b> If you want to upgrade an existing Ditto installation, you’ll have to execute a small
+ database migration - see release notes.</div>
+
+<p>The main changes and new features are</p>
+
+<ul>
+ <li>speed up of search index creation</li>
+ <li>applying enforcement of messages received via connections (e.g. from Eclipse Hono)</li>
+ <li>copying already existing policies when creating things</li>
+</ul>
+
+<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>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>
+
+<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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2018-11-28-release-announcement-080.html b/2.0/2018-11-28-release-announcement-080.html
new file mode 100644
index 0000000..c630cae
--- /dev/null
+++ b/2.0/2018-11-28-release-announcement-080.html
@@ -0,0 +1,335 @@
+<!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 0.8.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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 0.8.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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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 0.8.0</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2018-11-28T00:00:00+00:00" itemprop="datePublished">Nov 28, 2018</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>Today the Eclipse Ditto team proudly presents its first release
+<a href="https://projects.eclipse.org/projects/iot.ditto/releases/0.8.0">0.8.0</a>.</p>
+
+<p>Please have a look at the <a href="release_notes_080.html">0.8.0 release notes</a> for a more detailed information on the release.</p>
+
+<p>The main changes and new features since the latest milestone <a href="release_notes_080-M3.html">0.8.0-M3</a> are:</p>
+
+<ul>
+ <li>Support Eclipse Hono’s command&control in Ditto connectivity</li>
+ <li>several smaller bugfixes</li>
+</ul>
+
+<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>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>
+
+<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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2018-12-05-example-command-and-control.html b/2.0/2018-12-05-example-command-and-control.html
new file mode 100644
index 0000000..14d3df7
--- /dev/null
+++ b/2.0/2018-12-05-example-command-and-control.html
@@ -0,0 +1,574 @@
+<!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> Using Eclipse Hono's Command&Control with Eclipse Ditto </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Using Eclipse Hono's Command&Control with Eclipse Ditto">{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/ce9011e32b5ea7c8fe00893ae278cb0a?s=135" alt="A photo of Dominik Guggemos" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.com/dguggemos" target="_blank">Dominik Guggemos</a>-->
+<!--</span>-->
+<!---->
+
+<article class="post" itemscope itemtype="http://schema.org/BlogPosting">
+
+ <header class="post-header">
+ <h1 class="post-title" itemprop="name headline">Using Eclipse Hono's Command&Control with Eclipse Ditto</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/ce9011e32b5ea7c8fe00893ae278cb0a?s=135" alt="A photo of Dominik Guggemos" 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="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>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>With <a href="release_notes_080.html">version 0.8.0</a> 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, which in turn can send a response to the command including a
+status, telling if the command was successfully processed or not.
+This response is routed back via Hono to the Ditto Message API.</p>
+
+<p>In this example we connect the <a href="https://ditto.eclipseprojects.io/">Ditto sandbox</a> and the
+<a href="https://www.eclipse.org/hono/sandbox/">Hono sandbox</a> to send a message (3) to a simulated device via the
+Ditto Messages API. The device receives the command from the Hono HTTP Adapter and responds with a message (4)
+that is routed back to the caller at the Ditto Message API (5). For the sake of simplicity we use simple curl
+commands both for the Ditto and Hono HTTP APIs.</p>
+
+<p>The following steps are covered in this example:</p>
+
+<ol>
+ <li>Setup a connection between Eclipse Ditto and Hono sandboxes</li>
+ <li>Signal availability of the device</li>
+ <li>Send a Ditto message</li>
+ <li>Device receives command and sends command response</li>
+ <li>Caller receives response at Ditto Message API</li>
+</ol>
+
+<p><img src="images/blog/2018-12-14-command-and-control.png" alt="Command and Control" /></p>
+
+<h3 id="prerequisites-a-ditto-digital-twin-and-a-hono-device">Prerequisites: A Ditto digital twin and a Hono device</h3>
+
+<p>The creation of a Hono device and Ditto digital twin has already been covered in the blog post
+<a href="2018-05-02-connecting-ditto-hono.html">Connecting Eclipse Ditto to Eclipse Hono</a>. For brevity we will just list the
+required commands to create a twin/device here. For a detailed explanation of the steps please refer to the previous
+post.</p>
+
+<h4 id="create-hono-device">Create Hono device</h4>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c"># setup a tenant</span>
+<span class="nv">$ </span>curl <span class="nt">-X</span> POST <span class="nt">-i</span> <span class="nt">-H</span> <span class="s1">'Content-Type: application/json'</span> <span class="nt">-d</span> <span class="s1">'{"tenant-id": "org.eclipse.ditto"}'</span> http://hono.eclipse.org:28080/tenant
+<span class="c"># create a device</span>
+<span class="nv">$ </span>curl <span class="nt">-X</span> POST <span class="nt">-i</span> <span class="nt">-H</span> <span class="s1">'Content-Type: application/json'</span> <span class="nt">-d</span> <span class="s1">'{"device-id": "org.eclipse.ditto:teapot"}'</span> http://hono.eclipse.org:28080/registration/org.eclipse.ditto
+<span class="c"># add device credentials</span>
+<span class="nv">$ PWD_HASH</span><span class="o">=</span><span class="k">$(</span><span class="nb">echo</span> <span class="nt">-n</span> <span class="s1">'teapot'</span> | openssl dgst <span class="nt">-binary</span> <span class="nt">-sha512</span> | base64 <span class="nt">-w</span> 0<span class="k">)</span>
+<span class="nv">$ </span>curl <span class="nt">-X</span> POST <span class="nt">-i</span> <span class="nt">-H</span> <span class="s1">'Content-Type: application/json'</span> <span class="nt">-d</span> <span class="s1">'{
+ "device-id": "org.eclipse.ditto:teapot",
+ "type": "hashed-password",
+ "auth-id": "teapot",
+ "secrets": [{
+ "hash-function" : "sha-512",
+ "pwd-hash": "'</span><span class="nv">$PWD_HASH</span><span class="s1">'"
+ }]
+}'</span> http://hono.eclipse.org:28080/credentials/org.eclipse.ditto
+</code></pre></div></div>
+
+<h4 id="create-ditto-policy-for-digital-twin">Create Ditto policy for digital twin</h4>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c"># create policy in Ditto</span>
+<span class="nv">$ </span>curl <span class="nt">-X</span> PUT <span class="nt">-i</span> <span class="nt">-u</span> demo5:demo <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:teapot-policy",
+ "entries": {
+ "DEMO": {
+ "subjects": {
+ "nginx:demo5": {
+ "type": "basic auth user and user used in connection'</span>s authorizationContext<span class="s2">"
+ }
+ },
+ "</span>resources<span class="s2">": {
+ "</span>thing:/<span class="s2">": {
+ "</span>grant<span class="s2">": ["</span>READ<span class="s2">", "</span>WRITE<span class="s2">"],
+ "</span>revoke<span class="s2">": []
+ },
+ "</span>policy:/<span class="s2">": {
+ "</span>grant<span class="s2">": ["</span>READ<span class="s2">", "</span>WRITE<span class="s2">"],
+ "</span>revoke<span class="s2">": []
+ },
+ "</span>message:/<span class="s2">": {
+ "</span>grant<span class="s2">": ["</span>READ<span class="s2">", "</span>WRITE<span class="s2">"],
+ "</span>revoke<span class="s2">": []
+ }
+ }
+ }
+ }
+}' https://ditto.eclipseprojects.io/api/2/policies/org.eclipse.ditto:teapot-policy
+</span></code></pre></div></div>
+
+<h4 id="create-ditto-digital-twin">Create Ditto digital twin</h4>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c"># create thing in Ditto</span>
+<span class="nv">$ </span>curl <span class="nt">-X</span> PUT <span class="nt">-i</span> <span class="nt">-u</span> demo5:demo <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:teapot-policy",
+ "features": {
+ "water": {
+ "properties": {
+ "temperature": 20
+ }
+ }
+ }
+}'</span> https://ditto.eclipseprojects.io/api/2/things/org.eclipse.ditto:teapot
+</code></pre></div></div>
+
+<h3 id="setup-a-connection-for-command--control">Setup a connection for Command & Control</h3>
+<p>In order to forward Ditto Messages to the device as a Hono command we first need to setup and configure a
+<a href="connectivity-manage-connections.html">connection</a> between Eclipse Ditto and Eclipse Hono that is prepared for
+<em>Command & Control</em> messages. According to the
+<a href="https://www.eclipse.org/hono/">Hono documentation</a>
+the connection must contain a target with the address <code class="highlighter-rouge">control/<tenant-id>/<device-id></code>
+and a source with the address <code class="highlighter-rouge">control/<tenant-id>/<reply-identifier></code>. The <code class="highlighter-rouge">reply-identifier</code> can be
+chosen arbitrarily, but must be set as the <code class="highlighter-rouge">reply-to</code> header of a command exactly as defined in the connection:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-X</span> POST <span class="nt">-i</span> <span class="nt">-u</span> devops:devopsPw1! <span class="se">\</span>
+ <span class="nt">-H</span> <span class="s1">'Content-Type: application/json'</span> <span class="se">\</span>
+ <span class="nt">-d</span> <span class="s1">'{
+ "targetActorSelection": "/system/sharding/connection",
+ "headers": {
+ "aggregate": false
+ },
+ "piggybackCommand": {
+ "type": "connectivity.commands:createConnection",
+ "connection": {
+ "id": "command-and-control-connection",
+ "connectionType": "amqp-10",
+ "connectionStatus": "open",
+ "uri": "amqp://consumer%40HONO:verysecret@hono.eclipse.org:15672",
+ "failoverEnabled": true,
+ "sources": [{
+ "addresses": [
+ "control/org.eclipse.ditto/replies"
+ ],
+ "authorizationContext": [
+ "nginx:demo5"
+ ],
+ "headerMapping": {
+ "correlation-id": "{{ header:correlation-id }}",
+ "status": "{{ header:status }}",
+ "content-type": "{{ header:content-type }}"
+ }
+ }
+ ],
+ "targets": [{
+ "address": "control/org.eclipse.ditto/{{ thing:name }}",
+ "authorizationContext": [
+ "nginx:demo5"
+ ],
+ "topics":["_/_/things/live/messages"],
+ "headerMapping": {
+ "message-id": "{{ header:correlation-id }}",
+ "subject": "{{ topic:subject }}",
+ "content-type": "application/vnd.eclipse.ditto+json",
+ "reply-to": "control/org.eclipse.ditto/replies"
+ }
+ }
+ ]
+ }
+ }
+ }'</span> <span class="se">\</span>
+ https://ditto.eclipseprojects.io/devops/piggyback/connectivity?timeout<span class="o">=</span>10s
+</code></pre></div></div>
+
+<p>As described in the
+<a href="https://www.eclipse.org/hono/">Hono API description</a>
+a command message has three mandatory properties: <code class="highlighter-rouge">correlation-id</code>, <code class="highlighter-rouge">subject</code> and <code class="highlighter-rouge">reply-to</code>, these are defined in the
+target header mapping of the connection.
+The source header mapping defines a mapping for <code class="highlighter-rouge">correlation-id</code> and <code class="highlighter-rouge">status</code> to internal headers, they are required
+to properly map the Hono command response to a Ditto message response.</p>
+
+<h3 id="signal-availability-of-device">Signal availability of device</h3>
+
+<p>As we are using the Hono HTTP Adapter to connect our device, send telemetry and receive commands, the designated way
+is therefor to signal readiness to receive a command by specifying the <code class="highlighter-rouge">hono-ttd</code> parameter on an arbitrary event (for
+detailed description please consult the
+[Hono HTTP Adapter] (https://www.eclipse.org/hono/)
+guide).</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-X</span> POST <span class="nt">-i</span> <span class="nt">-u</span> teapot@org.eclipse.ditto:teapot <span class="nt">-H</span> <span class="s1">'hono-ttd: 60'</span> <span class="nt">-H</span> <span class="s1">'Content-Type: application/json'</span> <span class="se">\</span>
+ <span class="nt">-d</span> <span class="s1">'{
+ "topic": "org.eclipse.ditto/teapot/things/twin/commands/modify",
+ "path": "/features/water/properties/temperature",
+ "value": 23
+ }'</span> <span class="se">\</span>
+ http://hono.eclipse.org:8080/telemetry
+</code></pre></div></div>
+
+<p>The request is now open to receive a command for 60 seconds before it is terminated.</p>
+
+<h3 id="send-a-ditto-message">Send a Ditto message</h3>
+
+<p>Now we can use the <a href="protocol-specification-things-messages.html#using-the-messages-api">Ditto Messages API</a> to send a
+message to the device waiting for a command:</p>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-i</span> <span class="nt">-X</span> POST <span class="s1">'https://ditto.eclipseprojects.io/api/2/things/org.eclipse.ditto:teapot/inbox/messages/brew?timeout=60'</span> <span class="se">\</span>
+ <span class="nt">-u</span> demo5:demo <span class="se">\</span>
+ <span class="nt">-H</span> <span class="s1">'x-correlation-id: command-and-control'</span> <span class="se">\</span>
+ <span class="nt">-d</span> <span class="s1">'{"targetTemperature":85}'</span>
+</code></pre></div></div>
+
+<h3 id="device-receives-the-command">Device receives the command</h3>
+
+<p>The message is forwarded to Hono as configured in the connection and finally terminates the pending request we opened
+before with a status code of <code class="highlighter-rouge">200 OK</code>:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>HTTP/1.1 200 OK
+hono-command: brew
+hono-cmd-req-id: 013command-and-controlreplies
+Content-Type: application/octet-stream
+Content-Length: 17
+Connection: Keep-Alive
+</code></pre></div></div>
+
+<p>Hono adds two headers besides the standard HTTP headers: <code class="highlighter-rouge">hono-command</code> and <code class="highlighter-rouge">hono-cmd-req-id</code>.
+<code class="highlighter-rouge">hono-command</code> contains the subject of the message and <code class="highlighter-rouge">hono-cmd-req-id</code> identifies the messages and is used to
+correlate the request and the response we are now going to send.</p>
+
+<h3 id="device-sends-a-command-response">Device sends a command response</h3>
+
+<p>We use the header value of <code class="highlighter-rouge">hono-cmd-req-id</code> to construct the response address:
+<code class="highlighter-rouge">http://hono.eclipse.org:8080/control/res/013command-and-controlreplies</code></p>
+
+<p>Another curl command completes the roundtrip with a response from the simulated device:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-i</span> <span class="nt">-X</span> POST <span class="nt">-u</span> teapot@org.eclipse.ditto:teapot <span class="se">\</span>
+ <span class="nt">-H</span> <span class="s1">'Content-Type: application/json'</span> <span class="se">\</span>
+ <span class="nt">-H</span> <span class="s1">'hono-cmd-status: 200'</span> <span class="se">\</span>
+ <span class="nt">-d</span> <span class="s1">'{
+ "topic": "org.eclipse.ditto/teapot/things/live/messages/brew",
+ "headers": {
+ "content-type": "application/json",
+ "correlation-id": "command-and-control"
+ },
+ "path": "/inbox/messages/brew",
+ "value": { "eta": 56},
+ "status": 200
+ }'</span> <span class="se">\</span>
+ http://hono.eclipse.org:8080/control/res/013command-and-controlreplies
+</code></pre></div></div>
+
+<h3 id="message-response-is-received-at-ditto-message-api">Message response is received at Ditto Message API</h3>
+<p>And finally we receive the command response at the Ditto Message API where we sent the original message:</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>HTTP/1.1 200 OK
+correlation-id: command-and-control
+message-id: command-and-control
+status: 200
+Content-Type: application/json
+Content-Length: 10
+
+{"eta":56}
+</code></pre></div></div>
+
+<h3 id="alternative-receive-command-and-send-response-via-mqtt">Alternative: Receive command and send response via MQTT</h3>
+
+<p>Alternatively we can also receive the command by subscribing to the MQTT topic <code class="highlighter-rouge">control/+/+/req/#</code> at the
+<a href="https://www.eclipse.org/hono/">Hono MQTT Adapter</a>:</p>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nv">$ </span>mosquitto_sub <span class="nt">-d</span> <span class="nt">-h</span> hono.eclipse.org <span class="nt">-p</span> 8883 <span class="nt">-v</span> <span class="nt">-u</span> <span class="s1">'teapot@org.eclipse.ditto'</span> <span class="nt">-P</span> teapot <span class="nt">-t</span> <span class="s1">'control/+/+/req/#'</span>
+</code></pre></div></div>
+
+<p>And also publish the command response on the MQTT topic <code class="highlighter-rouge">control///res/013command-and-controlreplies/200</code>:</p>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>mosquitto_pub <span class="nt">-d</span> <span class="nt">-h</span> hono.eclipse.org <span class="nt">-p</span> 8883 <span class="nt">-u</span> <span class="s1">'teapot@org.eclipse.ditto'</span> <span class="nt">-P</span> teapot <span class="se">\</span>
+ <span class="nt">-t</span> control///res/013command-and-controlreplies/200 <span class="se">\</span>
+ <span class="nt">-m</span> <span class="s1">'{
+ "topic": "org.eclipse.ditto/teapot/things/live/messages/brew",
+ "headers": {
+ "content-type": "application/json",
+ "correlation-id": "command-and-control"
+ },
+ "path": "/inbox/messages/brew",
+ "value": {
+ "eta": 58
+ },
+ "status": 200
+ }'</span>
+</code></pre></div></div>
+
+<p>If you have any wishes, improvements, are missing something
+or just want to get in touch with us, you can use one of
+our <a href="feedback.html">feedback channels</a>.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2019-03-13-kafka-connectivity.html b/2.0/2019-03-13-kafka-connectivity.html
new file mode 100644
index 0000000..fc663be
--- /dev/null
+++ b/2.0/2019-03-13-kafka-connectivity.html
@@ -0,0 +1,321 @@
+<!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> Connectivity to Apache Kafka in Eclipse Ditto </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Connectivity to Apache Kafka in Eclipse Ditto">{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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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">Connectivity to Apache Kafka in Eclipse Ditto</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.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>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>Today we added connectivity to <a href="https://kafka.apache.org/">Apache Kafka</a>. In a first step, it is possible to publish
+<em>twin events</em>, <em>messages</em>, <em>live commands and events</em> to Kafka topics.</p>
+
+<p>Since the last addition to Ditto’s connectivity which <a href="2018-10-16-example-mqtt-bidirectional.html">added MQTT connectivity</a>,
+the connectivity feature got a lot of stabilization and new smaller features, e.g. the recent addition of
+<a href="basic-placeholders.html#function-expressions">placeholder functions</a>.</p>
+
+<p>Returning to the Kafka integration Ditto can now, for example, whenever a <a href="intro-digitaltwins.html">digital twin</a> is
+changed (e.g. a device updated some state data), publish a <em>twin event</em> to a Kafka topic.</p>
+
+<p>If you already rely on Apache Kafka as a source for your data lake or analytics, integrating Ditto and its digital twins
+is now super easy.</p>
+
+<p>Find out more at our <a href="connectivity-protocol-bindings-kafka2.html">Kafka documentation</a>.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2019-03-28-milestone-announcement-090-M1.html b/2.0/2019-03-28-milestone-announcement-090-M1.html
new file mode 100644
index 0000000..0a7cd8d
--- /dev/null
+++ b/2.0/2019-03-28-milestone-announcement-090-M1.html
@@ -0,0 +1,337 @@
+<!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 Ditto Milestone 0.9.0-M1 </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 Ditto Milestone 0.9.0-M1">{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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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 Ditto Milestone 0.9.0-M1</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2019-03-28T00:00:00+00:00" itemprop="datePublished">Mar 28, 2019</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>Today the Ditto team is happy to announce the first milestone of the upcoming release
+<a href="https://projects.eclipse.org/projects/iot.ditto/releases/0.9.0">0.9.0</a>.</p>
+
+<p>Have a look at the Milestone <a href="release_notes_090-M1.html">0.9.0-M1 release notes</a> for what changed in detail.</p>
+
+<p>The main changes and new features since the last release <a href="release_notes_080.html">0.8.0</a> are</p>
+
+<ul>
+ <li>memory optimizations when working with millions of digital twins</li>
+ <li>enhance connectivity to also be able to establish connections to Apache Kafka</li>
+ <li>providing more detailed metrics for connections</li>
+ <li>cluster bootstrapping stability improvements</li>
+</ul>
+
+<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>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>
+
+<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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2019-04-29-milestone-announcement-090-M2.html b/2.0/2019-04-29-milestone-announcement-090-M2.html
new file mode 100644
index 0000000..0803018
--- /dev/null
+++ b/2.0/2019-04-29-milestone-announcement-090-M2.html
@@ -0,0 +1,335 @@
+<!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 Ditto Milestone 0.9.0-M2 </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 Ditto Milestone 0.9.0-M2">{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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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 Ditto Milestone 0.9.0-M2</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2019-04-29T00:00:00+00:00" itemprop="datePublished">Apr 29, 2019</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>The second milestone of the upcoming release
+<a href="https://projects.eclipse.org/projects/iot.ditto/releases/0.9.0">0.9.0</a> was released today.</p>
+
+<p>Have a look at the Milestone <a href="release_notes_090-M2.html">0.9.0-M2 release notes</a> for what changed in detail.</p>
+
+<p>The main changes and new features since the last milestone <a href="release_notes_090-M1.html">0.9.0-M1</a> are</p>
+
+<ul>
+ <li>rewrite of Ditto’s “search” service in order to use the same index and have the same query performance for API v1 and v2</li>
+ <li>several contributions in order to operate Eclipse Ditto on Microsoft Azure</li>
+</ul>
+
+<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>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>
+
+<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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2019-07-10-release-announcement-090.html b/2.0/2019-07-10-release-announcement-090.html
new file mode 100644
index 0000000..331e8e6
--- /dev/null
+++ b/2.0/2019-07-10-release-announcement-090.html
@@ -0,0 +1,341 @@
+<!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 0.9.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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 0.9.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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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 0.9.0</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2019-07-10T00:00:00+00:00" itemprop="datePublished">Jul 10, 2019</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>Today the Eclipse Ditto team proudly presents its second release
+<a href="https://projects.eclipse.org/projects/iot.ditto/releases/0.9.0">0.9.0</a>.</p>
+
+<p>The topics of this release in a nutshell were:</p>
+
+<ul>
+ <li>Memory improvements for huge amounts (multi million) of digital twins which are held in memory</li>
+ <li>Adding metrics and logging around the connectivity feature in order to enable being able to operate connections to foreign systems/brokers via APIs</li>
+ <li>Enhancing Ditto’s connectivity feature by additionally being able to connect to Apache Kafka</li>
+ <li>Performance improvements of Ditto’s search functionality</li>
+ <li>Stabilization of cluster bootstrapping</li>
+ <li>Refactoring of how the services configurations are determined</li>
+ <li>Addition of a Helm template in order to simplify Kubernetes based deployments</li>
+ <li>Contributions from Microsoft in order to ease operating Eclipse Ditto on Microsoft Azure</li>
+</ul>
+
+<p>Please have a look at the <a href="release_notes_090.html">0.9.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>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>
+
+<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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2019-08-28-openid-connect.html b/2.0/2019-08-28-openid-connect.html
new file mode 100644
index 0000000..5d69cec
--- /dev/null
+++ b/2.0/2019-08-28-openid-connect.html
@@ -0,0 +1,387 @@
+<!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> Eclipse Ditto now supports OpenID Connect </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Eclipse Ditto now supports OpenID Connect">{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/b82b2c7526d4adfe84a03fe9c7cfaae9?s=135" alt="A photo of Johannes Schneider" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.com/jokraehe" target="_blank">Johannes Schneider</a>-->
+<!--</span>-->
+<!---->
+
+<article class="post" itemscope itemtype="http://schema.org/BlogPosting">
+
+ <header class="post-header">
+ <h1 class="post-title" itemprop="name headline">Eclipse Ditto now supports OpenID Connect</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/b82b2c7526d4adfe84a03fe9c7cfaae9?s=135" alt="A photo of Johannes Schneider" 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="https://github.com/jokraehe" target="_blank">Johannes Schneider</a> </span></span> on <time datetime="2019-08-28T00:00:00+00:00" itemprop="datePublished">Aug 28, 2019</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>Eclipse Ditto now supports all OAuth 2.0 providers which implement <a href="https://openid.net/connect/">OpenID Connect</a> out-of-the-box.
+You can find a list of certified providers at <a href="https://openid.net/developers/certified/">OpenID Connect - Certified OpenID Provider Servers and Services</a>.</p>
+
+<p>With this post, we want to give an example of this new feature using the open source provider <a href="https://www.ory.sh">ORY Hydra</a>.
+Follow their <a href="https://www.ory.sh/docs/next/hydra/configure-deploy#installing-ory-hydra">installation guide</a> for a
+ docker based setup on your development machine.</p>
+
+<h4 id="configuration">Configuration</h4>
+<p>Download the self-signed certificate form the ORY Hydra server: https://localhost:9000/.well-known/openid-configuration</p>
+
+<p>Use the downloaded certificate for the akka-http ssl configuration.</p>
+<pre><code class="language-hocon">ssl-config {
+ trustManager = {
+ stores = [
+ { type = "PEM", path = "/path/to/cert/globalsign.crt" }
+ ]
+ }
+}
+</code></pre>
+
+<p>The authentication provider must be added to the ditto-gateway configuration.</p>
+<pre><code class="language-hocon">ditto.gateway.authentication {
+ oauth {
+ openid-connect-issuers = {
+ ory = "https://localhost:9000/"
+ }
+ }
+}
+</code></pre>
+
+<p>The configured subject-issuer will be used to prefix the value of the “sub” claim, e.g.</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">"subjects"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"ory:foo@bar.com"</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">"generated"</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>
+
+<h4 id="authenticate-ditto-api">Authenticate Ditto API</h4>
+<p>Create an OAuth client with hydra to be able to create ID Tokens.</p>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>docker run <span class="nt">--rm</span> <span class="nt">-it</span> <span class="se">\</span>
+ <span class="nt">-e</span> <span class="nv">HYDRA_ADMIN_URL</span><span class="o">=</span>https://ory-hydra-example--hydra:4445 <span class="se">\</span>
+ <span class="nt">--network</span> hydraguide <span class="se">\</span>
+ oryd/hydra:v1.0.0 <span class="se">\</span>
+ clients create <span class="nt">--skip-tls-verify</span> <span class="se">\</span>
+ <span class="nt">--id</span> eclipse-ditto <span class="se">\</span>
+ <span class="nt">--secret</span> some-secret <span class="se">\</span>
+ <span class="nt">--grant-types</span> authorization_code,refresh_token,client_credentials,implicit <span class="se">\</span>
+ <span class="nt">--response-types</span> token,code,id_token <span class="se">\</span>
+ <span class="nt">--scope</span> openid,offline <span class="se">\</span>
+ <span class="nt">--callbacks</span> http://127.0.0.1:9010/callback
+</code></pre></div></div>
+
+<p>Use the client to generate an ID Token.</p>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>docker run <span class="nt">--rm</span> <span class="nt">-it</span> <span class="se">\</span>
+ <span class="nt">--network</span> hydraguide <span class="se">\</span>
+ <span class="nt">-p</span> 9010:9010 <span class="se">\</span>
+ oryd/hydra:v1.0.0 <span class="se">\</span>
+ token user <span class="nt">--skip-tls-verify</span> <span class="se">\</span>
+ <span class="nt">--port</span> 9010 <span class="se">\</span>
+ <span class="nt">--auth-url</span> https://localhost:9000/oauth2/auth <span class="se">\</span>
+ <span class="nt">--token-url</span> https://ory-hydra-example--hydra:4444/oauth2/token <span class="se">\</span>
+ <span class="nt">--client-id</span> eclipse-ditto <span class="se">\</span>
+ <span class="nt">--client-secret</span> some-secret <span class="se">\</span>
+ <span class="nt">--scope</span> openid
+</code></pre></div></div>
+<p>After that perform the OAuth 2.0 Authorize Code Flow by opening the link, as prompted,
+in your browser, and follow the steps shown there.</p>
+
+<p>Use the generated token to authenticate Ditto API.</p>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-X</span> POST <span class="se">\</span>
+ http://localhost:8080/api/2/things <span class="se">\</span>
+ <span class="nt">-H</span> <span class="s1">'Authorization: Bearer <JWT>'</span> <span class="se">\</span>
+ <span class="nt">-H</span> <span class="s1">'Content-Type: application/json'</span> <span class="se">\</span>
+ <span class="nt">-d</span> <span class="s1">'{}'</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2019-09-17-milestone-announcement-100-M1a.html b/2.0/2019-09-17-milestone-announcement-100-M1a.html
new file mode 100644
index 0000000..aa9f96b
--- /dev/null
+++ b/2.0/2019-09-17-milestone-announcement-100-M1a.html
@@ -0,0 +1,338 @@
+<!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 Ditto Milestone 1.0.0-M1a </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 Ditto Milestone 1.0.0-M1a">{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/b82b2c7526d4adfe84a03fe9c7cfaae9?s=135" alt="A photo of Johannes Schneider" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.com/jokraehe" target="_blank">Johannes Schneider</a>-->
+<!--</span>-->
+<!---->
+
+<article class="post" itemscope itemtype="http://schema.org/BlogPosting">
+
+ <header class="post-header">
+ <h1 class="post-title" itemprop="name headline">Announcing Ditto Milestone 1.0.0-M1a</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/b82b2c7526d4adfe84a03fe9c7cfaae9?s=135" alt="A photo of Johannes Schneider" 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="https://github.com/jokraehe" target="_blank">Johannes Schneider</a> </span></span> on <time datetime="2019-09-17T00:00:00+00:00" itemprop="datePublished">Sep 17, 2019</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>Today the Ditto team is happy to announce the first milestone of the upcoming release
+<a href="https://projects.eclipse.org/projects/iot.ditto/releases/1.0.0">1.0.0</a>.</p>
+
+<p>Have a look at the Milestone <a href="release_notes_100-M1a.html">1.0.0-M1a release notes</a> for what changed in detail.</p>
+
+<p>The main changes and new features since the last release <a href="release_notes_090.html">0.9.0</a> are</p>
+
+<ul>
+ <li>initial contribution of Java client SDK</li>
+ <li>configurable OpenID Connect authorization servers</li>
+ <li>fine grained access for connections</li>
+ <li>scalable event publishing</li>
+ <li>typed entity IDs</li>
+</ul>
+
+<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>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>
+
+<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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2019-10-17-http-connectivity.html b/2.0/2019-10-17-http-connectivity.html
new file mode 100644
index 0000000..6591fce
--- /dev/null
+++ b/2.0/2019-10-17-http-connectivity.html
@@ -0,0 +1,346 @@
+<!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> Integration of HTTP endpoints/webhooks </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Integration of HTTP endpoints/webhooks">{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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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">Integration of HTTP endpoints/webhooks</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2019-10-17T00:00:00+00:00" itemprop="datePublished">Oct 17, 2019</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>By adding another connectivity type - <a href="connectivity-protocol-bindings-http.html">HTTP</a> - to Ditto’s
+ connectivity, it is now (to be released in the next Ditto milestone 1.0.0-M2) possible to
+ publish <em>twin events</em>, <em>messages</em>, <em>live commands and events</em> to existing HTTP servers/endpoints.</p>
+
+<p>That is especially useful for invoking existing APIs (which are most of the time HTTP based) whenever e.g.
+ a digital twin was modified.</p>
+
+<p>One example on how to benefit from this new feature is to invoke a custom
+ <a href="https://ifttt.com">IFTTT</a> (if-this-than-that) <a href="https://ifttt.com/maker_webhooks">webhook</a> via a HTTP <code class="highlighter-rouge">POST</code> request
+ which then may trigger other IFTTT follow-up-actions (e.g. send a chat message to a <a href="https://ifttt.com/slack">Slack</a>
+ room).</p>
+
+<p>For IFTTT “webhooks” the address would be <code class="highlighter-rouge">POST https://maker.ifttt.com/trigger/<your-event-name>/with/key/<your-key></code>
+ and the expected JSON body:</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">"value1"</span><span class="p">:</span><span class="w"> </span><span class="s2">"..."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value2"</span><span class="p">:</span><span class="w"> </span><span class="s2">"..."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value3"</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>
+
+<p>In combination with <a href="connectivity-mapping.html">payload mapping</a>, the <code class="highlighter-rouge">value1</code> to <code class="highlighter-rouge">value3</code> fields requested by the IFTTT
+API can be extracted from the <a href="protocol-specification.html">Ditto Protocol</a> and could contain the changed value.</p>
+
+<p>In combination with <a href="basic-connections.html#target-topics-and-filtering">filters for targets</a> you can even specify to
+only publish e.g. <code class="highlighter-rouge">twin events</code>, where the temperature of a twin exceeded a certain threshold:</p>
+
+<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/properties/value,25)"
+ ],
+ ...
+}
+</code></pre></div></div>
+
+<p>Get creative on which HTTP APIs to trigger based on twin events. E.g. invoke a “function-as-a-service” API or invoke the
+Twitter API and let your digital twin tweet whenever it detects, that it is getting too warm in your office.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2019-11-04-milestone-announcement-100-M2.html b/2.0/2019-11-04-milestone-announcement-100-M2.html
new file mode 100644
index 0000000..7e3a654
--- /dev/null
+++ b/2.0/2019-11-04-milestone-announcement-100-M2.html
@@ -0,0 +1,337 @@
+<!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 Ditto Milestone 1.0.0-M2 </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 Ditto Milestone 1.0.0-M2">{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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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 Ditto Milestone 1.0.0-M2</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2019-11-04T00:00:00+00:00" itemprop="datePublished">Nov 4, 2019</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>The second and last milestone of the upcoming release
+<a href="https://projects.eclipse.org/projects/iot.ditto/releases/1.0.0">1.0.0</a> was released today.</p>
+
+<p>Have a look at the Milestone <a href="release_notes_100-M2.html">1.0.0-M2 release notes</a> for what changed in detail.</p>
+
+<p>The main changes and new features since the last release <a href="release_notes_100-M1a.html">1.0.0-M1a release notes</a> are</p>
+
+<ul>
+ <li>invoking custom foreign HTTP endpoints as a result of events/messages</li>
+ <li>ability to reflect Eclipse Hono’s device connection state in Ditto’s things</li>
+ <li>support for OpenID Connect / OAuth2.0 based authentication in Ditto Java Client</li>
+ <li>configurbale throttling of max. consumed WebSocket commands / time interval</li>
+</ul>
+
+<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>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>
+
+<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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2019-12-12-release-announcement-100.html b/2.0/2019-12-12-release-announcement-100.html
new file mode 100644
index 0000000..2ac44ed
--- /dev/null
+++ b/2.0/2019-12-12-release-announcement-100.html
@@ -0,0 +1,386 @@
+<!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.0.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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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.0.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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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.0.0</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.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:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>Today the Eclipse Ditto team is thrilled to announce the availability of Eclipse Ditto’s first major release
+<a href="https://projects.eclipse.org/projects/iot.ditto/releases/1.0.0">1.0.0</a>.</p>
+
+<h2 id="maturity">Maturity</h2>
+
+<p>The initial code contribution was done in October 2017, 2 years later and 2 releases
+(<a href="2018-11-28-release-announcement-080.html">0.8.0</a> and <a href="2019-07-10-release-announcement-090.html">0.9.0</a>) later, we
+think its time to graduate from the Eclipse “incubation” phase and officially declare the project as mature.</p>
+
+<p>Recent adoptions and contributions from our community show us that Eclipse Ditto solves problems which also other
+companies have. Adopters add Eclipse Ditto as a central part of their own IoT platforms.</p>
+
+<h3 id="api-stability">API stability</h3>
+
+<p>Having reached 1.0.0, some additional promises towards “API stability” do apply:</p>
+
+<h4 id="http-api-stability">HTTP API stability</h4>
+<p>Ditto uses schema versioning (currently schema version 1 and 2) at the HTTP API level in order to being able to
+evolve APIs.
+It is backward compatible to the prior versions 0.8.0 and 0.9.0.</p>
+
+<h4 id="json-api-stability">JSON API stability</h4>
+<p>Ditto kept its main JSON APIs (regarding things, policies and search) backwards compatible to 0.8.0 and 0.9.0 releases.
+The JSON format of “connections” was changed since 0.9.0 and will from 1.0.0 on be kept backwards compatible as well.</p>
+
+<h4 id="java-api-stability">Java API stability</h4>
+<p>The Java APIs will for the 1.x release be kept backwards compatible, so only non-breaking additions to the APIs will be done. This is enforced by a Maven tooling.</p>
+
+<p>The following Java modules are treated as API for which compatibility is enforced:</p>
+
+<ul>
+ <li>ditto-json</li>
+ <li>ditto-model-*</li>
+ <li>ditto-signals-*</li>
+ <li>ditto-protocol-adapter</li>
+ <li>ditto-utils</li>
+ <li>ditto-client</li>
+</ul>
+
+<h3 id="scalability">Scalability</h3>
+
+<p>The focus on the 0.9.0 and 1.0.0 releases regarding non-functionals were laid on horizontal scalability.</p>
+
+<p>With Eclipse Ditto 1.0.0 we are confident to face production grade scalability requirements being capable of handling
+millions of managed things.</p>
+
+<h2 id="changelog">Changelog</h2>
+
+<p>The main changes compared to the last release, <a href="release_notes_090.html">0.9.0</a>, are:</p>
+
+<ul>
+ <li>addition of a Java and a JavaScript client SDK in separate <a href="https://github.com/eclipse/ditto-clients">GitHub repo</a></li>
+ <li>configurable OpenID Connect authorization servers</li>
+ <li>support for OpenID Connect / OAuth2.0 based authentication in Ditto Java Client</li>
+ <li>invoking custom foreign HTTP endpoints as a result of events/messages</li>
+ <li>ability to reflect Eclipse Hono’s device connection state in Ditto’s things</li>
+ <li>configurable throttling of max. consumed WebSocket commands / time interval</li>
+ <li>Addition of “definition” field in thing at model level containing the model ID a thing may follow</li>
+ <li>Improved connection response handling/mapping</li>
+</ul>
+
+<p>Please have a look at the <a href="release_notes_100.html">1.0.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>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>
+
+<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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2020-04-16-connecting-to-ttn-via-mqtt.html b/2.0/2020-04-16-connecting-to-ttn-via-mqtt.html
new file mode 100644
index 0000000..31e7cd8
--- /dev/null
+++ b/2.0/2020-04-16-connecting-to-ttn-via-mqtt.html
@@ -0,0 +1,833 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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/19a9fd49b6778aef898249fb4f11bd24?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="https://github.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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2020-04-29-release-announcement-110.html b/2.0/2020-04-29-release-announcement-110.html
new file mode 100644
index 0000000..529fb4f
--- /dev/null
+++ b/2.0/2020-04-29-release-announcement-110.html
@@ -0,0 +1,367 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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/19a9fd49b6778aef898249fb4f11bd24?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="https://github.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 ACL 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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2020-08-31-release-announcement-120.html b/2.0/2020-08-31-release-announcement-120.html
new file mode 100644
index 0000000..dfdbf11
--- /dev/null
+++ b/2.0/2020-08-31-release-announcement-120.html
@@ -0,0 +1,345 @@
+<!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.2.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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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.2.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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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.2.0</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2020-08-31T00:00:00+00:00" itemprop="datePublished">Aug 31, 2020</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>Today, the Ditto team is happy to announce the second minor (feature) update of Ditto <code class="highlighter-rouge">1.x</code>:<br />
+<strong>Eclipse Ditto 1.2.0</strong></p>
+
+<p>1.2.0 focuses on the following areas:</p>
+
+<ul>
+ <li>“At least once” (QoS 1) processing of messages consumed/sent via Ditto’s managed <a href="basic-connections.html">connections</a>
+ (via <a href="basic-acknowledgements.html">acknowledgements</a>)</li>
+ <li>Addition of a <code class="highlighter-rouge">"_created"</code> timestamp for newly created digital twins (things)</li>
+ <li>Possibility to inject arbitrary <code class="highlighter-rouge">"_metadata"</code> when modifying digital twins (things)</li>
+ <li>Authenticate HTTP push connections with client certificates</li>
+</ul>
+
+<p>Please have a look at the <a href="release_notes_120.html">1.2.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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2020-09-30-release-announcement-130.html b/2.0/2020-09-30-release-announcement-130.html
new file mode 100644
index 0000000..5e3d69a
--- /dev/null
+++ b/2.0/2020-09-30-release-announcement-130.html
@@ -0,0 +1,345 @@
+<!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.3.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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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.3.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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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.3.0</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2020-09-30T00:00:00+00:00" itemprop="datePublished">Sep 30, 2020</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>Today, the Ditto team is happy to announce the next feature update of Ditto <code class="highlighter-rouge">1.x</code>: <strong>Eclipse Ditto 1.3.0</strong></p>
+
+<p>1.3.0 focuses on the following areas:</p>
+
+<ul>
+ <li>Implicit/automatic creation of digital twins (things)</li>
+ <li>Use response of HTTP push connections as live message response</li>
+ <li>“Raw” payload mapper for “pass-through” connectivity scenarios not affecting the twin</li>
+</ul>
+
+<p>Please have a look at the <a href="release_notes_130.html">1.3.0 release notes</a> for a more detailed information on the release.</p>
+
+<p>Also, some bugs were fixed which are not backported to Ditto 1.2.x - it is recommended to update to Ditto 1.3.0 right
+away and skip 1.2.x.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2020-10-08-asynchronous-client-creation.html b/2.0/2020-10-08-asynchronous-client-creation.html
new file mode 100644
index 0000000..0e3b0d4
--- /dev/null
+++ b/2.0/2020-10-08-asynchronous-client-creation.html
@@ -0,0 +1,379 @@
+<!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> Asynchronous Client Creation in Ditto Java Client 1.3.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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Asynchronous Client Creation in Ditto Java Client 1.3.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/d923944b6a8c76e411ff838fb19acfa7?s=135" alt="A photo of Yufei Cai" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.com/yufei-cai" target="_blank">Yufei Cai</a>-->
+<!--</span>-->
+<!---->
+
+<article class="post" itemscope itemtype="http://schema.org/BlogPosting">
+
+ <header class="post-header">
+ <h1 class="post-title" itemprop="name headline">Asynchronous Client Creation in Ditto Java Client 1.3.0</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/d923944b6a8c76e411ff838fb19acfa7?s=135" alt="A photo of Yufei Cai" 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="https://github.com/yufei-cai" target="_blank">Yufei Cai</a> </span></span> on <time datetime="2020-10-08T00:00:00+00:00" itemprop="datePublished">Oct 8, 2020</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>Before <a href="https://github.com/eclipse/ditto-clients/tree/master/java">Ditto Java Client</a> 1.3.0,
+a client object connects to a configured Ditto back-end during its creation.</p>
+
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">// create a client object and block until it connects to the Ditto back-end.</span>
+<span class="kd">final</span> <span class="n">DittoClient</span> <span class="n">client</span> <span class="o">=</span> <span class="n">DittoClients</span><span class="o">.</span><span class="na">newInstance</span><span class="o">(</span><span class="n">messagingProvider</span><span class="o">);</span>
+</code></pre></div></div>
+
+<p>There are several problems with the approach.</p>
+<ol>
+ <li>The calling thread blocks waiting for IO, namely the authentication process
+and establishment of a websocket.</li>
+ <li>If the client is configured to reconnect, then an incorrect end-ponit configuration
+makes the factory method block forever.</li>
+ <li>If the client is not configured to reconnect, then the factory method will throw
+an exception. But it is not possible to give the client reference to the exception
+handler, since the client creation did not complete. Consequently the exception handler
+has no simple way to free all resources allocated for the client.</li>
+</ol>
+
+<p>1.3.0 addresses these problems by introducing an asynchronous client creation interface.</p>
+
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">final</span> <span class="kd">class</span> <span class="nc">DittoClients</span> <span class="o">{</span>
+
+ <span class="kd">public</span> <span class="kd">static</span> <span class="n">DisconnectedDittoClient</span> <span class="nf">newDisconnectedInstance</span><span class="o">(</span><span class="n">MessagingProvider</span> <span class="n">mp</span><span class="o">);</span>
+<span class="o">}</span>
+
+<span class="kd">public</span> <span class="kd">interface</span> <span class="nc">DisconnectedDittoClient</span> <span class="o">{</span>
+
+ <span class="n">CompletionStage</span><span class="o"><</span><span class="n">DittoClient</span><span class="o">></span> <span class="nf">connect</span><span class="o">();</span>
+
+ <span class="kt">void</span> <span class="nf">destroy</span><span class="o">();</span>
+<span class="o">}</span>
+</code></pre></div></div>
+
+<p>The method <code class="highlighter-rouge">DittoClients.newDisconnectedInstance(MessagingProvider)</code> creates a <code class="highlighter-rouge">DisconnectedDittoClient</code>
+object. The <code class="highlighter-rouge">DisconnectedDittoClient</code> has references to all resources allocated for the client and
+can free them via the <code class="highlighter-rouge">destroy()</code> method. The <code class="highlighter-rouge">DisconnectedDittoClient</code> object offers no method to
+interact with the Ditto API. By calling <code class="highlighter-rouge">connect()</code>, one obtains a future that yields a familiar
+<code class="highlighter-rouge">DittoClient</code> object upon completion. One might use the asynchronous client creation interface thus:</p>
+
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">final</span> <span class="n">DisconnectedDittoClient</span> <span class="n">disconnectedClient</span> <span class="o">=</span>
+ <span class="n">DittoClients</span><span class="o">.</span><span class="na">newDisconnectedInstance</span><span class="o">(</span><span class="n">messagingProvider</span><span class="o">);</span>
+
+<span class="n">disconnectedClient</span><span class="o">.</span><span class="na">connect</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">thenAccept</span><span class="o">(</span><span class="k">this</span><span class="o">::</span><span class="n">startUsingDittoClient</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">exceptionally</span><span class="o">(</span><span class="n">exception</span> <span class="o">-></span> <span class="o">{</span>
+ <span class="k">this</span><span class="o">.</span><span class="na">handleConnectionFailure</span><span class="o">(</span><span class="n">exception</span><span class="o">);</span>
+ <span class="n">disconnectedClient</span><span class="o">.</span><span class="na">destroy</span><span class="o">();</span>
+ <span class="k">return</span> <span class="kc">null</span><span class="o">;</span>
+ <span class="o">});</span>
+</code></pre></div></div>
+
+<p>The asynchronous client creation interface has the following advantages.</p>
+
+<ol>
+ <li>
+ <p>The calling thread does not block.</p>
+ </li>
+ <li>
+ <p>Even if configured to reconnect, the user can receive connection errors via
+the connection error handler in <code class="highlighter-rouge">MessagingConfiguration</code> and shut down the client
+at will.</p>
+ </li>
+ <li>
+ <p>When initial reconnection is disabled, the method <code class="highlighter-rouge">DisconnectedDittoClient.connect()</code>
+returns a failed future on connection error. It is possible to reference the
+<code class="highlighter-rouge">DittoDisconnectedClient</code> object in the future’s error handler, where the client can
+be destroyed.</p>
+ </li>
+</ol>
+
+<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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2020-10-23-end-2-end-acknowledgment.html b/2.0/2020-10-23-end-2-end-acknowledgment.html
new file mode 100644
index 0000000..0f0b7a1
--- /dev/null
+++ b/2.0/2020-10-23-end-2-end-acknowledgment.html
@@ -0,0 +1,620 @@
+<!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> E2E acknowledgment </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="E2E acknowledgment">{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/d2b4eba8f1c947a3fb94be23d8b82d8b?s=135" alt="A photo of Yannic Klem" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.com/Yannic92" target="_blank">Yannic Klem</a>-->
+<!--</span>-->
+<!---->
+
+<article class="post" itemscope itemtype="http://schema.org/BlogPosting">
+
+ <header class="post-header">
+ <h1 class="post-title" itemprop="name headline">E2E acknowledgment</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/d2b4eba8f1c947a3fb94be23d8b82d8b?s=135" alt="A photo of Yannic Klem" 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="https://github.com/Yannic92" target="_blank">Yannic Klem</a> </span></span> on <time datetime="2020-10-23T00:00:00+00:00" itemprop="datePublished">Oct 23, 2020</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</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>
+
+
+
+ <h2 id="e2e-acknowledgement-using-eclipse-ditto">E2E acknowledgement using Eclipse Ditto</h2>
+
+<p>By adding the new <a href="basic-acknowledgements.html">acknowledgements feature</a> to Ditto, it is now possible to provide an end to end QoS (quality of service) with level 1.
+Previously the <a href="architecture-services-connectivity.html">connectivity service</a> of Ditto did accept all incoming messages immediately as soon as it received the message.</p>
+
+<p>This behaviour can now be controlled by a Ditto header called <a href="basic-acknowledgements.html#requesting-acks"><code class="highlighter-rouge">requested-acks</code></a>.</p>
+
+<p>In this blog post I will provide a few examples for how to use this new feature in the following scenarios:</p>
+
+<ol>
+ <li>Device publishes a change of its state and doesn’t care about whether the event regarding this change will be received by any subscriber or not.<br />
+This is the <a href="#scenario-1---fire-and-forget">fire and forget</a> scenario.</li>
+ <li>Device publishes a change of its state and wants to be sure it is persisted in Ditto.<br />
+This is the <a href="#scenario-2---processed-in-ditto">processed in Ditto</a> scenario.</li>
+ <li>Device publishes a change of its state and wants to be sure an application connected to Eclipse Ditto will receive the event regarding this change of the state.<br />
+This is the <a href="#scenario-3---notification-scenario">notification</a> scenario.</li>
+ <li>Device publishes a change of its state and wants to be notified when a subscriber was not able to receive the event regarding this change.<br />
+This is the <a href="#scenario-4---tracked-notification-scenario">tracked notification</a> scenario.</li>
+ <li>Device sends a live message and wants to be sure that it will eventually receive a response.<br />
+This is the <a href="#scenario-5---long-running-live-message-scenario">long running live message</a> scenario.</li>
+ <li>Device sends a live message and wants to either receive the response within a given timeout or never.<br />
+This is the <a href="#scenario-6---asking-for-required-information-scenario">asking for required information</a> scenario.</li>
+</ol>
+
+<h2 id="scenarios">Scenarios</h2>
+
+<p>The following scenarios all share the same context:</p>
+<ul>
+ <li>a device sends data/messages via a device connectivity layer (e.g. <a href="https://eclipse.org/hono/">Eclipse Hono</a> or an MQTT broker) to Ditto</li>
+ <li>Ditto’s <a href="architecture-services-connectivity.html">connectivity service</a>
+ <ul>
+ <li>consumes the <a href="protocol-specification.html">Ditto Protocol</a> message</li>
+ <li>forwards the message into the Ditto cluster to be processed</li>
+ <li>is responsible for technically acknowledging/settling the consumed message at the device connectivity layer / broker
+ <ul>
+ <li>the strategy of when this is done and with which outcome is handled by the Ditto headers mentioned in the scenarios</li>
+ </ul>
+ </li>
+ </ul>
+ </li>
+</ul>
+
+<p>Although all scenarios are based on the device sending something (e.g. telemetry data or a message), the
+E2E acknowledgement can also be used the other way around when e.g. a backend application sends something to a device.</p>
+
+<h3 id="scenario-1---fire-and-forget">Scenario 1 - Fire and Forget</h3>
+
+<p>This is the simplest scenario of all, since the change can be published in a fire and forget semantics.</p>
+
+<p>In this scenario the device will send the modification command containing the headers:</p>
+<ul>
+ <li><code class="highlighter-rouge">response-required=false</code></li>
+ <li><code class="highlighter-rouge">requested-acks=[]</code></li>
+</ul>
+
+<p>Example <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/my-thing/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">"response-required"</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">"requested-acks"</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">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/features/lightSwitch/properties/status"</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">"on"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>For this case the connectivity service will immediately acknowledge the incoming message at the messaging system and then continues to process the command.</p>
+
+<p>It doesn’t matter if the command could be processed successfully or if any subscriber received an event for this change.</p>
+
+<h3 id="scenario-2---processed-in-ditto">Scenario 2 - Processed in Ditto</h3>
+
+<p>For this scenario the device wants to be sure its change will be properly persisted in Ditto.</p>
+
+<p>The command needs to define the following headers:</p>
+<ul>
+ <li><code class="highlighter-rouge">response-required=false</code></li>
+ <li><code class="highlighter-rouge">requested-acks=["twin-persisted"]</code></li>
+</ul>
+
+<p>Example <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/my-thing/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">"response-required"</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">"requested-acks"</span><span class="p">:</span><span class="w"> </span><span class="p">[</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">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/features/lightSwitch/properties/status"</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">"on"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>For this case the connectivity service will wait until the modification will be properly persisted in Ditto before acknowledging the incoming message at the messaging system.</p>
+
+<p>If the device published this command for example via an AMQP broker (with a QoS 1 “at least once” semantic),
+this will cause the broker to redeliver the command to Ditto if the acknowledgment fails.<br />
+Please be aware that a redelivery will only be requested for the following error status codes:</p>
+<ul>
+ <li><code class="highlighter-rouge">408</code> (Request timed out)</li>
+ <li><code class="highlighter-rouge">424</code> (Dependency Failure)</li>
+ <li>All kinds of <code class="highlighter-rouge">5xx</code> status codes</li>
+</ul>
+
+<p>In this scenario it does matter if the command could be processed successfully, but it’s still not relevant if any subscriber received an event for this change.</p>
+
+<h3 id="scenario-3---notification-scenario">Scenario 3 - Notification scenario</h3>
+
+<p>For this scenario the device wants to be sure another system will be notified about the change of its state.</p>
+
+<p>This could be for example an alarming system which wants to be sure a backend application receives the information that the alarm was triggered.</p>
+
+<p>A prerequisite for this is that any kind of connection exists that publishes the event to the backend application and declares a user defined acknowledgement label.
+This can be a <a href="httpapi-protocol-bindings-websocket.html">WebSocket session</a> or any kind of Ditto Connection types which can be found <a href="connectivity-overview.html">here</a>.</p>
+
+<p>For this example we expect the event to be forwarded by an <a href="connectivity-protocol-bindings-http.html">HTTP connection</a>
+which declared the following acknowledgement label as
+<a href="basic-connections.html#target-issued-acknowledgement-label">issued acknowledgement of the target</a>: <code class="highlighter-rouge">d45d4522-142e-4057-ae87-8969343a3ddc:backend-processed</code>.</p>
+
+<p>The UUID prefix in this case is the ID of the HTTP connection and the<code class="highlighter-rouge">backend-process</code> part is a custom label, defined by the user.</p>
+
+<p>The command needs to define the following headers:</p>
+<ul>
+ <li><code class="highlighter-rouge">response-required=false</code></li>
+ <li><code class="highlighter-rouge">requested-acks=["d45d4522-142e-4057-ae87-8969343a3ddc:backend-processed"]</code></li>
+ <li><code class="highlighter-rouge">timeout=30s</code> (optional. Default is 10s.)</li>
+</ul>
+
+<p>Example <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/my-thing/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">"response-required"</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">"requested-acks"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"d45d4522-142e-4057-ae87-8969343a3ddc:backend-processed"</span><span class="p">],</span><span class="w">
+ </span><span class="s2">"timeout"</span><span class="p">:</span><span class="w"> </span><span class="s2">"30s"</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/alarm/properties/status"</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">"on"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>For this case the connectivity service will wait until the HTTP request, which forwards the event regarding the thing change,
+will be finished before acknowledging the incoming message at the messaging system.</p>
+
+<p>The status code of the HTTP response will in this case determine if the message will be acknowledged successfully or not and if a redelivery will be requested or not.<br />
+All kinds of <code class="highlighter-rouge">2xx</code> status codes will lead to a successful acknowledgement at the messaging system.<br />
+All other status codes will lead to a failed acknowledgement at the messaging system and for the following status codes a redelivery will be requested:</p>
+<ul>
+ <li><code class="highlighter-rouge">408</code> (Request timed out)</li>
+ <li><code class="highlighter-rouge">424</code> (Dependency Failure)</li>
+ <li>All kinds of <code class="highlighter-rouge">5xx</code> status codes</li>
+</ul>
+
+<p>In this scenario it is ensured a specified subscriber will receive an event for this change.</p>
+
+<h3 id="scenario-4---tracked-notification-scenario">Scenario 4 - Tracked notification scenario</h3>
+
+<p>For this scenario the device wants to know when a system could not be notified about the change of its state.</p>
+
+<p>This could be for example an alarming system which wants to be sure a backend application receives the information,
+or if not: tries to send an SMS as notification.</p>
+
+<p>This scenario is mostly like scenario 3, but needs to set the <code class="highlighter-rouge">response-required</code> header to <code class="highlighter-rouge">true</code> and it’s required
+to <a href="basic-connections.html#source-reply-target">configure the reply-target of the source</a> to also expect “nack” responses.</p>
+
+<p>Example <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/my-thing/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">"response-required"</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">"requested-acks"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"d45d4522-142e-4057-ae87-8969343a3ddc:backend-processed"</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/alarm/properties/status"</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">"on"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>In this case the device will receive an acknowledgement response containing the status code and payload of the response of the backend application.<br />
+Based on this the device can decide how to handle the situation.<br />
+It is suggested to publish the modification command with QoS 0 (“at most once” semantics) in this case because the
+device handles the result of the E2E acknowledgement. With QoS 1 (“at least once” semantics) brokers would usually redeliver the message to Ditto.</p>
+
+<p>If the HTTP endpoint of the backend application responds with the following response:</p>
+
+<p>headers:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>"content-type": "application/json"
+</code></pre></div></div>
+
+<p>body:</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">"errorCode"</span><span class="p">:</span><span class="w"> </span><span class="s2">"notification.smartphone.failed"</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">"Could not notify smartphone."</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>status code: <code class="highlighter-rouge">424</code></p>
+
+<p>The response received at the device 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">"org.eclipse.ditto/my-thing/things/twin/acks/d45d4522-142e-4057-ae87-8969343a3ddc:backend-processed"</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">"response-required"</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">"requested-acks"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"d45d4522-142e-4057-ae87-8969343a3ddc:backend-processed"</span><span class="p">],</span><span class="w">
+ </span><span class="s2">"timeout"</span><span class="p">:</span><span class="w"> </span><span class="s2">"30s"</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/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">"errorCode"</span><span class="p">:</span><span class="w"> </span><span class="s2">"notification.smartphone.failed"</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">"Could not notify smartphone."</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">424</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h3 id="scenario-5---long-running-live-message-scenario">Scenario 5 - Long running live message scenario</h3>
+
+<p>For this scenario the device is going to ask for an information which it needs eventually.</p>
+
+<p>Let’s say the device asks for the endpoint where it should download the new firmware from.<br />
+It’s not required that this response arrives within a given time. It’s just required to eventually arrive at the device
+and after it was received the device can signal the user, that it is ready to download the firmware.</p>
+
+<p>The headers of the live message should have the following values:</p>
+<ul>
+ <li><code class="highlighter-rouge">response-required=true</code></li>
+ <li><code class="highlighter-rouge">requested-acks=["live-response"]</code></li>
+</ul>
+
+<p>Example <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/my-thing/things/live/messages/firmware"</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">"response-required"</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">"requested-acks"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"live-response"</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">"text/plain"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"timeout"</span><span class="p">:</span><span class="w"> </span><span class="s2">"5s"</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">"/outbox/messages/firmware"</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">"firmware.url.query"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>By requesting the acknowledgement <code class="highlighter-rouge">live-response</code> the connectivity service will wait until the response for the live message arrived
+for 5s before acknowledging the incoming message at the broker and will request a redelivery if the response did not arrive within this timeout.</p>
+
+<p>This will repeat until either the broker discards the message or the response arrives in the specified timeout.
+That way it is guaranteed that the device will eventually receive the response.</p>
+
+<h3 id="scenario-6---asking-for-required-information-scenario">Scenario 6 - Asking for required information scenario</h3>
+
+<p>For this scenario the device is going to ask for an information which it needs right now to proceed with its current task.</p>
+
+<p>Let’s say the device asks if it should allow a car with a license plate it detected to drive on the property by opening the barrier.
+It could be possible to ask for that information, so the barrier opens automatically, but providing a fallback mechanism
+like entering a code directly at the device if this response does not arrive within time.</p>
+
+<p>The headers of the live message should have the following values:</p>
+<ul>
+ <li><code class="highlighter-rouge">response-required=true</code></li>
+ <li><code class="highlighter-rouge">requested-acks=[]</code></li>
+</ul>
+
+<p>Example <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/my-thing/things/live/messages/car-enter"</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">"response-required"</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">"requested-acks"</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">"text/plain"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"timeout"</span><span class="p">:</span><span class="w"> </span><span class="s2">"5s"</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">"/outbox/messages/car-enter"</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">"FN IB 1337"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>By requesting explicitly not requesting any acknowledgement but still requiring a response, the connectivity service will
+immediately acknowledge the incoming message at the broker. The device will then either receive the response within the specified timeout or never.
+So the device can provide its alternative options to open the barrier after 5 seconds.</p>
+
+<h2 id="we-embrace-your-feedback">We embrace your feedback</h2>
+
+<p>I hope I could demonstrate the power of the new acknowledgement feature properly and could make it clear how it can be used.
+Maybe you did recognize some of your use cases in the given examples or maybe you have another use case which can or cannot be solved by this feature.</p>
+
+<p>We would love to get your <a href="feedback.html">feedback</a>.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2020-10-28-release-announcement-140.html b/2.0/2020-10-28-release-announcement-140.html
new file mode 100644
index 0000000..22c3c4d
--- /dev/null
+++ b/2.0/2020-10-28-release-announcement-140.html
@@ -0,0 +1,343 @@
+<!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.4.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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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.4.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/d923944b6a8c76e411ff838fb19acfa7?s=135" alt="A photo of Yufei Cai" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.com/yufei-cai" target="_blank">Yufei Cai</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.4.0</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/d923944b6a8c76e411ff838fb19acfa7?s=135" alt="A photo of Yufei Cai" 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="https://github.com/yufei-cai" target="_blank">Yufei Cai</a> </span></span> on <time datetime="2020-10-28T00:00:00+00:00" itemprop="datePublished">Oct 28, 2020</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>Today, the Ditto team is happy to announce the next feature update of Ditto <code class="highlighter-rouge">1.x</code>: <strong>Eclipse Ditto 1.4.0</strong></p>
+
+<p>1.4.0 focuses on:</p>
+
+<ul>
+ <li>Declaration of acknowledgement labels unique to each subscriber</li>
+</ul>
+
+<p>Please have a look at the <a href="release_notes_140.html">1.4.0 release notes</a> for a more detailed information on the release.</p>
+
+<p>Also, some bugs were fixed which are not backported to Ditto 1.3.0 - it is recommended to update to Ditto 1.4.0 right
+away and skip 1.3.0.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2020-11-11-desired-properties.html b/2.0/2020-11-11-desired-properties.html
new file mode 100644
index 0000000..362e249
--- /dev/null
+++ b/2.0/2020-11-11-desired-properties.html
@@ -0,0 +1,447 @@
+<!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> Desired Feature Properties </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Desired Feature Properties">{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/3c657b46dc4d006056091942068f6ad7?s=135" alt="A photo of David Schwilk" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.com/derschwilk" target="_blank">David Schwilk</a>-->
+<!--</span>-->
+<!---->
+
+<article class="post" itemscope itemtype="http://schema.org/BlogPosting">
+
+ <header class="post-header">
+ <h1 class="post-title" itemprop="name headline">Desired Feature Properties</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/3c657b46dc4d006056091942068f6ad7?s=135" alt="A photo of David Schwilk" 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="https://github.com/derschwilk" target="_blank">David Schwilk</a> </span></span> on <time datetime="2020-11-11T00:00:00+00:00" itemprop="datePublished">Nov 11, 2020</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</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>
+
+
+
+ <h2 id="desired-feature-properties-added-to-things-model">Desired feature properties added to things model</h2>
+<p>With the upcoming release of Eclipse Ditto <strong>version 1.5.0</strong>
+<a href="basic-feature.html#feature-desired-properties">desired feature properties</a> are introduced to the things model for
+<strong>API versions later than 1</strong>. The <em>desired properties</em> for features are added on the same level of the model as
+the feature properties and can reflect for example feature property updates ,which are intended, but not yet applied.</p>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Further logics for desired feature properties might be implemented in future Ditto
+ versions.</div>
+
+<p>A fully-fledged JSON representation of a feature with desired properties is shown below:</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">"lamp"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"com.mycompany.fb:Lamp:1.0.0"</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">"configuration"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"on"</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">"location"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">34.052235</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">-118.243683</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="p">{</span><span class="w">
+ </span><span class="s2">"on"</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">"color"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"red"</span><span class="p">:</span><span class="w"> </span><span class="mi">128</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"green"</span><span class="p">:</span><span class="w"> </span><span class="mi">255</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"blue"</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><span class="s2">"desiredProperties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"configuration"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"on"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</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="operations-on-desired-feature-properties">Operations on desired feature properties</h2>
+
+<ul>
+ <li><strong>CRUD operations</strong>
+ <ul>
+ <li>You can create multiple desired properties of a feature or just single ones.</li>
+ <li>You can retrieve all desired properties of a feature or just single ones.</li>
+ <li>You can modify all desired properties of a feature or just single ones.</li>
+ <li>You can delete all desired properties of a feature or just single ones.</li>
+ </ul>
+ </li>
+ <li><strong>Search</strong>
+ <ul>
+ <li>You can <a href="httpapi-search.html">search</a> for things with specific desired properties with <a href="basic-rql.html">RQL-functions</a>.</li>
+ <li>You can search for things, which have <a href="basic-rql.html#exists">existent</a> desired properties for a feature.</li>
+ </ul>
+ </li>
+ <li><strong>Get notified on changes</strong>
+ <ul>
+ <li>You can <a href="basic-signals-event.html">receive events</a> for changes done to the desired properties of things
+you’re authorized to read.</li>
+ <li>You can <a href="basic-enrichment.html">enrich</a> and <a href="basic-changenotifications.html#filtering">filter</a> the
+ events you want to receive, for changes done to the desired properties.</li>
+ </ul>
+ </li>
+</ul>
+
+<h3 id="executing-crud-operations-on-desired-feature-properties">Executing CRUD operations on desired feature properties</h3>
+<p>CRUD operations can be executed either via the <a href="httpapi-concepts.html">Ditto HTTP API</a> <strong>versions later than 1</strong> or via
+<a href="protocol-overview.html">ditto-protocol</a> messages.</p>
+
+<p><em>Possible CRUD operations for desired feature properties via ditto-protocol</em>:</p>
+
+<ul>
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve all desired properties of a feature via ditto-protocol</a></li>
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired property of a feature via ditto-protocol</a></li>
+ <li><a href="protocol-examples-modifydesiredproperties.html">Create/Modify all desired properties of a feature via ditto-protocol</a></li>
+ <li><a href="protocol-examples-modifydesiredproperty.html">Create/Modify a single desired property of a feature via ditto-protocol</a></li>
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete all desired properties of a feature via ditto-protocol</a></li>
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired property of a feature via ditto-protocol</a></li>
+</ul>
+
+<h3 id="using-the-ditto-client-to-manage-desired-feature-properties">Using the ditto-client to manage desired feature properties</h3>
+<p>The desired feature properties can also be retrieved, modified and deleted via the <a href="client-sdk-java.html">Ditto Java Client</a>.
+With the upcoming (<strong>Ditto Java Client version 1.5.0</strong>), no special CRUD operations for
+desired feature properties are implemented in the client. Thus, the operations have to be executed via creating
+<strong>ditto-protocol messages</strong> manually in the client.</p>
+
+<p>Example for creating/modifying desired feature properties of a thing via the ditto-client:</p>
+
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">final</span> <span class="n">Adaptable</span> <span class="n">modifyFeatureDesiredProperties</span> <span class="o">=</span>
+ <span class="n">Adaptable</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="n">TopicPath</span><span class="o">.</span><span class="na">newBuilder</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">"com.mycompany.fb:Car:1.0.0"</span><span class="o">))</span>
+ <span class="o">.</span><span class="na">things</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">twin</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">commands</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">modify</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">build</span><span class="o">())</span>
+ <span class="o">.</span><span class="na">withPayload</span><span class="o">(</span><span class="n">Payload</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span>
+ <span class="n">JsonPointer</span><span class="o">.</span><span class="na">of</span><span class="o">(</span><span class="s">"/features/lamp/desiredProperties"</span><span class="o">))</span>
+ <span class="o">.</span><span class="na">withValue</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="na">set</span><span class="o">(</span><span class="s">"on"</span><span class="o">,</span> <span class="kc">false</span><span class="o">).</span><span class="na">build</span><span class="o">())</span>
+ <span class="o">.</span><span class="na">build</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">sendDittoProtocol</span><span class="o">(</span><span class="n">modifyFeatureDesiredProperties</span><span class="o">).</span><span class="na">whenComplete</span><span class="o">(((</span><span class="n">adaptable</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="o">!=</span> <span class="kc">null</span><span class="o">)</span> <span class="o">{</span>
+ <span class="n">LOGGER</span><span class="o">.</span><span class="na">error</span><span class="o">(</span><span class="s">"Received error while sending ModifyFeatureDesiredProperties: '{}' "</span><span class="o">,</span>
+ <span class="n">throwable</span><span class="o">.</span><span class="na">toString</span><span class="o">());</span>
+ <span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
+ <span class="n">LOGGER</span><span class="o">.</span><span class="na">info</span><span class="o">(</span><span class="s">"Received response for ModifyFeatureDesiredProperties: '{}'"</span><span class="o">,</span> <span class="n">adaptable</span><span class="o">);</span>
+ <span class="o">}</span>
+ <span class="o">}));</span>
+</code></pre></div></div>
+
+<h2 id="feedback">Feedback?</h2>
+
+<p>Please <a href="feedback.html">get in touch</a> if you have feedback or questions towards this new concept of desired properties.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2020-11-16-weak-acknowledgements.html b/2.0/2020-11-16-weak-acknowledgements.html
new file mode 100644
index 0000000..973a25d
--- /dev/null
+++ b/2.0/2020-11-16-weak-acknowledgements.html
@@ -0,0 +1,404 @@
+<!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> Weak acknowledgments to decouple signal publishers and subscribers </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Weak acknowledgments to decouple signal publishers and subscribers">{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/d923944b6a8c76e411ff838fb19acfa7?s=135" alt="A photo of Yufei Cai" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.com/yufei-cai" target="_blank">Yufei Cai</a>-->
+<!--</span>-->
+<!---->
+
+<article class="post" itemscope itemtype="http://schema.org/BlogPosting">
+
+ <header class="post-header">
+ <h1 class="post-title" itemprop="name headline">Weak acknowledgments to decouple signal publishers and subscribers</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/d923944b6a8c76e411ff838fb19acfa7?s=135" alt="A photo of Yufei Cai" 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="https://github.com/yufei-cai" target="_blank">Yufei Cai</a> </span></span> on <time datetime="2020-11-16T00:00:00+00:00" itemprop="datePublished">Nov 16, 2020</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</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>
+
+
+
+ <h2 id="motivation">Motivation</h2>
+
+<p><a href="2020-08-31-release-announcement-120.html">Ditto 1.2.0</a> introduced at-least-once delivery via
+<a href="basic-acknowledgements.html">acknowledgement requests</a>.<br />
+It increased coupling between the publisher and the subscriber of signals in that the subscriber is no longer at the
+liberty to filter for signals it is interested in. Instead, the subscriber must consume all signals in order to
+fulfill acknowledgement requests and prevent endless redelivery.</p>
+
+<p>To combat the problem,
+<a href="2020-10-28-release-announcement-140.html">Ditto 1.4.0</a> made acknowledgement labels unique and introduced the requirement
+to manage <a href="basic-acknowledgements.html#issuing-acknowledgements"><em>declared acknowledgements</em></a>, identifying of each
+subscriber.<br />
+It is now possible for Ditto to issue
+<a href="basic-acknowledgements.html#weak-acknowledgements-wacks"><em>weak acknowledgements</em></a> on behalf of the subscriber
+whenever it decides to not consume a signal. That allows subscribers to configure RQL and namespace filters freely
+without causing any futile redelivery.</p>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Weak acknowledgements are available since Ditto 1.5.0.</div>
+
+<h2 id="what-it-is">What it is</h2>
+
+<p>A <a href="basic-acknowledgements.html#weak-acknowledgements-wacks"><em>weak acknowledgement</em></a> is issued by Ditto for any
+<a href="basic-acknowledgements.html#requesting-acks">acknowledgement request</a> that will not be fulfilled now or ever without
+configuration change.<br />
+A weak acknowledgement is identified by the header <code class="highlighter-rouge">ditto-weak-ack: true</code>.</p>
+
+<p>The status code of weak acknowledgements is <code class="highlighter-rouge">200 OK</code>; it signifies that any redelivery is not to be made on their
+account.</p>
+
+<p>A weak acknowledgement may look like this in Ditto protocol:</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/xdk_53/things/twin/acks/my-mqtt-connection:my-mqtt-topic"</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">"ditto-weak-ack"</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">"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">"Acknowledgement was issued automatically, because the subscriber is not authorized to receive the signal."</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>
+
+<h2 id="how-it-works">How it works</h2>
+
+<p>Since Ditto 1.4.0, subscribers of <em>twin events</em> or <em>live signals</em> are required to declare unique acknowledgement labels
+they are allowed to send. The labels of acknowledgement requests are then identifying the intended subscribers.<br />
+If the intended subscriber exists but does not receive the signal for non-transient reasons, Ditto issues
+a weak acknowledgement for that subscriber.<br />
+Such reasons may be:</p>
+<ul>
+ <li>The intended subscriber <strong>is not authorized</strong> to receive the signal by policy;</li>
+ <li>The intended subscriber did not subscribe for the signal type (<em>twin event, live command, live event or live message</em>);</li>
+ <li>The intended subscriber filtered the signal out by its <a href="basic-changenotifications.html#filtering">namespace or RQL filter</a>;</li>
+ <li>The intended subscriber dropped the signal because its <a href="connectivity-mapping.html">payload mapper</a> produced nothing.</li>
+</ul>
+
+<h2 id="limitation">Limitation</h2>
+
+<p>The distributed nature of cluster pub/sub means that weak acknowledgements are not always issued correctly.<br />
+They are only <em>eventually correct</em> in the sense that some time after a change to the publisher-subscriber pair,
+the issued weak acknowledgements will reflect the change.<br />
+Such changes include:</p>
+<ul>
+ <li>Opening and closing of Websocket or other connections acting as the subscriber;</li>
+ <li>Subscribing and unsubscribing for different signal types via Websocket;</li>
+ <li>Modification of connections via the <a href="connectivity-manage-connections.html">connectivity API</a>;</li>
+ <li>Migration of a connection from one Ditto cluster member to another due to load balancing.</li>
+</ul>
+
+<h2 id="feedback">Feedback?</h2>
+
+<p>Please <a href="feedback.html">get in touch</a> if you have feedback or questions towards this new concept of weak
+acknowledgements.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2020-12-10-release-announcement-150.html b/2.0/2020-12-10-release-announcement-150.html
new file mode 100644
index 0000000..495eb41
--- /dev/null
+++ b/2.0/2020-12-10-release-announcement-150.html
@@ -0,0 +1,345 @@
+<!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.5.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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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.5.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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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.5.0</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2020-12-10T00:00:00+00:00" itemprop="datePublished">Dec 10, 2020</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>Wrapping up this crazy year, the Ditto team is happy to announce the next feature update of Ditto <code class="highlighter-rouge">1.x</code>:
+<strong>Eclipse Ditto 1.5.0</strong></p>
+
+<p>1.5.0 focuses on:</p>
+
+<ul>
+ <li>Desired properties management (CRUD)</li>
+ <li>Addition of “cloudevents” HTTP endpoint</li>
+ <li>Ditto internal pub/sub supports using a “grouping” concept which improves Ditto’s scalability capabilities</li>
+ <li>Issuing “weak Acknowledgements” when a command requesting acks was filtered out by Ditto (improvement of “at least once” delivery scenarios)</li>
+ <li>Feature ID may be used in header mappings of connections</li>
+</ul>
+
+<p>Please have a look at the <a href="release_notes_150.html">1.5.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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2021-01-22-policy-subject-activate-token-integration.html b/2.0/2021-01-22-policy-subject-activate-token-integration.html
new file mode 100644
index 0000000..1a0d20e
--- /dev/null
+++ b/2.0/2021-01-22-policy-subject-activate-token-integration.html
@@ -0,0 +1,504 @@
+<!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> Policy actions: token based subject activation </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Policy actions: token based subject activation">{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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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">Policy actions: token based subject activation</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2021-01-22T00:00:00+00:00" itemprop="datePublished">Jan 22, 2021</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</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>
+
+
+
+ <p>The upcoming version of Eclipse Ditto <strong>2.0.0</strong> will be enhanced with the ability to
+<a href="basic-policy.html#actions">alter policies based on policy actions</a>.</p>
+
+<h2 id="policy-actions">Policy actions</h2>
+
+<p>This new concept of <a href="basic-policy.html#actions">Policy actions</a> allows upfront defined modifications to policies without
+the need for the one invoking the action to have “WRITE” permissions granted on the policy.</p>
+
+<h2 id="token-based-activation-of-subject">Token based activation of subject</h2>
+
+<p>Together with the concept of actions, a first action named
+<a href="basic-policy.html#action-activatetokenintegration"><code class="highlighter-rouge">activateTokenIntegration</code></a> is added.<br />
+This action</p>
+<ul>
+ <li>only works when using <a href="#" data-toggle="tooltip" data-original-title="JSON Web Token (JWT)">JWT</a>
+based authentication issued by Google or other OpenID Connect providers as
+<a href="installation-operating.html#openid-connect">documented in the installation/operation guide</a></li>
+ <li>checks whether the <a href="basic-auth.html#authenticated-subjects">authenticated subjects</a> which invoked the action have the
+permission to <code class="highlighter-rouge">EXECUTE</code> the action on a policy entry</li>
+ <li>checks whether the <a href="basic-auth.html#authenticated-subjects">authenticated subjects</a> which invoked the action have at
+least some kind of <code class="highlighter-rouge">READ</code> permission to any <code class="highlighter-rouge">thing:/</code> resource in a policy entry</li>
+</ul>
+
+<p>When all the conditions were met for a policy entry, the action will inject a new <a href="basic-policy.html#subjects">subject</a>
+into the matched policy entry which by default (the
+<a href="basic-policy.html#action-activatetokenintegration">pattern is configurable</a>) is the following.
+This syntax uses <a href="basic-placeholders.html">placeholders</a> in order to extract information from the authenticated JWT and
+the policy entry:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>
+integration:{{policy-entry:label}}:{{jwt:aud}}
+
+</code></pre></div></div>
+
+<p>The value of the injected subject will contain the <a href="basic-policy.html#expiring-policy-subjects">expiry</a> timestamp
+copied from the JWT <code class="highlighter-rouge">"exp"</code> (the expiration time of the token) claim.</p>
+
+<h2 id="example-use-case">Example use case</h2>
+
+<p>Assuming that you have configured a custom OpenID Connect provider <code class="highlighter-rouge">some-openid-connect-provider</code> as
+<a href="installation-operating.html#openid-connect">documented in the installation/operation guide</a>:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ditto.gateway.authentication {
+ oauth {
+ openid-connect-issuers = {
+ some-openid-connect-provider = "https://some-openid-connect-provider.com"
+ }
+ }
+}
+</code></pre></div></div>
+
+<p>Let’s describe our scenario:</p>
+<ul>
+ <li>It is required to enable that a Ditto <a href="basic-connections.html">connection</a> (e.g. an
+<a href="connectivity-protocol-bindings-http.html">HTTP connection</a> invoking an HTTP webhook) shall receive events whenever
+the temperature of a twin is modified</li>
+ <li>For security reasons however, the webhook shall not receive events longer than the expiration time of the JWT which
+was used in order to activate the webhook</li>
+ <li>The webhook can be extended by invoking the action again before the “expiry” time was reached</li>
+</ul>
+
+<p>The underlying <a href="basic-policy.html">policy</a> shall be the following one:</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">"policyId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"my.namespace:policy-a"</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">"owner"</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">"some-openid-connect-provider:some-admin-id"</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">"authenticated via OpenID connect provider <some-openid-connect-provider>"</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:/"</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="s2">"READ"</span><span class="p">,</span><span class="w"> </span><span class="s2">"WRITE"</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">"policy:/"</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="s2">"READ"</span><span class="p">,</span><span class="w"> </span><span class="s2">"WRITE"</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">"temperature-observer"</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">"some-openid-connect-provider:some-user-id"</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">"authenticated via OpenID connect provider <some-openid-connect-provider>"</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:/features/temperature"</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="s2">"READ"</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">"policy:/entries/temperature-observer/actions/activateTokenIntegration"</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="s2">"EXECUTE"</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>
+
+<p>The policy entry <code class="highlighter-rouge">"temperature-observer"</code> above describes that:</p>
+<ul>
+ <li>the user “some-user-id” may <code class="highlighter-rouge">READ</code> the <code class="highlighter-rouge">"temperature"</code> feature of things using this policy</li>
+ <li>is allowed to <code class="highlighter-rouge">EXECUTE</code> the <code class="highlighter-rouge">activateTokenIntegration</code> action in order to inject a subject derived from his provided
+JWT</li>
+</ul>
+
+<p>Let’s assume that the authenticated JWT used for executing the action contained the following claims:</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">"iss"</span><span class="p">:</span><span class="w"> </span><span class="s2">"https://some-openid-connect-provider.com"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"sub"</span><span class="p">:</span><span class="w"> </span><span class="s2">"some-user-id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"exp"</span><span class="p">:</span><span class="w"> </span><span class="mi">1622802633</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"aud"</span><span class="p">:</span><span class="w"> </span><span class="s2">"some-specific-audience-0815"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>The “exp” field contains the token expiry timestamp (seconds since epoch) and resolves to:
+<code class="highlighter-rouge">Friday, June 4, 2021 10:30:33 AM</code>.</p>
+
+<p>Once the HTTP API
+<a href="/http-api-doc.html#/Policies/post_policies__policyId__entries__label__actions_activateTokenIntegration">POST /api/2/policies/{policyId}/entries/{label}/actions/activateTokenIntegration</a>, with <code class="highlighter-rouge">policyId=my.namespace:policy-a</code> and <code class="highlighter-rouge">label=temperature-observer</code>,<br />
+is invoked (without any payload), a new subject will be injected when the
+<a href="basic-policy.html#action-activatetokenintegration">described prerequisites</a> were enforced successfully.</p>
+
+<p>As a simplification, all possible policy entries may be injected with the subject by invoking the top level action<br />
+<a href="/http-api-doc.html#/Policies/post_policies__policyId__actions_activateTokenIntegration">POST /api/2/policies/{policyId}/actions/activateTokenIntegration</a>, with <code class="highlighter-rouge">policyId=my.namespace:policy-a</code>.</p>
+
+<p>The value of the injected subject will contain the expiration timestamp from the JWT, so the injected policy subject
+<code class="highlighter-rouge">integration:temperature-observer:some-specific-audience-0815</code> will result in a modified policy:</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">"policyId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"my.namespace:policy-a"</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">"owner"</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="err">unchanged</span><span class="w"> </span><span class="err">...</span><span class="w"> </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"temperature-observer"</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">"some-openid-connect-provider:some-user-id"</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">"authenticated via OpenID connect provider <some-openid-connect-provider>"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"integration:temperature-observer:some-specific-audience-0815"</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">"added via action <activateTokenIntegration>"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"expiry"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2021-06-04T10:30:33Z"</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:/features/temperature"</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="s2">"READ"</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">"policy:/entries/temperature-observer/actions/activateTokenIntegration"</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="s2">"EXECUTE"</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>
+
+<p>When we now have a
+managed HTTP connection which <a href="basic-connections.html#authorization">configures the <code class="highlighter-rouge">authorizationContext</code></a> to include
+the subject <code class="highlighter-rouge">integration:temperature-observer:some-specific-audience-0815</code> for a
+<a href="basic-connections.html#targets">connection target</a>, this connection is allowed to publish changes to the temperature of
+all things using the above policy until the <code class="highlighter-rouge">"expiry"</code> timestamp was reached.<br />
+Afterwards, publishing changes automatically stops, unless the action is invoked again with a JWT having a longer “exp”
+time prolonging the injected policy subject.</p>
+
+<h2 id="feedback">Feedback?</h2>
+
+<p>Please <a href="feedback.html">get in touch</a> if you have feedback or questions towards this new token based subject activation
+for policies.<br />
+Or do you have other use cases in mind you might be able to solve with this feature? Please let us know.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2021-02-04-merge-feature.html b/2.0/2021-02-04-merge-feature.html
new file mode 100644
index 0000000..d4a7ed5
--- /dev/null
+++ b/2.0/2021-02-04-merge-feature.html
@@ -0,0 +1,643 @@
+<!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="bloghttpprotocol, ">
+<title> Support merge functionality for things resources </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Support merge functionality for things 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">
+
+
+
+ <!-- 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/4125883975796a6f81e380b371438549?s=135" alt="A photo of Stefan Maute" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.com/stmaute" target="_blank">Stefan Maute</a>-->
+<!--</span>-->
+<!---->
+
+<article class="post" itemscope itemtype="http://schema.org/BlogPosting">
+
+ <header class="post-header">
+ <h1 class="post-title" itemprop="name headline">Support merge functionality for things resources</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/4125883975796a6f81e380b371438549?s=135" alt="A photo of Stefan Maute" 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="https://github.com/stmaute" target="_blank">Stefan Maute</a> </span></span> on <time datetime="2021-02-04T00:00:00+00:00" itemprop="datePublished">Feb 4, 2021</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>,
+
+
+
+ <a href="tag_http.html">http</a>,
+
+
+
+ <a href="tag_protocol.html">protocol</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>
+
+
+
+ <p>With the upcoming release of Eclipse Ditto <strong>version 2.0.0</strong> it will be possible to merge existing things and their subresources.</p>
+
+<h2 id="merge-functionality-for-things-resources">Merge functionality for things resources</h2>
+<p>Ditto now supports merging of existing things and all of its subresources with the provided payload in the request.
+This can be done by using the HTTP API with the PATCH method, via the Ditto protocol, and also by using the Ditto Java Client.
+For all three ways there is an example provided in this blog post.</p>
+
+<p>In contrast to the already existing PUT resource, this new functionality <strong>allows partial updates</strong> on a thing and all its subresources.
+To get more into detail, from now on it is possible to add or update attributes, and a feature property at the same time,
+without overwriting the complete thing. Another use case might be to update several feature properties within a single request
+and let all other parts of the thing untouched.</p>
+
+<p>Ditto uses the <a href="https://tools.ietf.org/html/rfc7396">JSON Merge Patch</a> semantics to merge the request body
+with the existing thing. In short, a JSON merge patch resembles the original JSON structure of a thing, and
+the fields provided in the patch are added, updated, or deleted in the existing thing.</p>
+
+<p>Please be aware that <code class="highlighter-rouge">null</code> values have a special meaning when applying a merge patch. A <code class="highlighter-rouge">null</code> value indicates
+the removal of existing fields in the updated thing.
+For more details and examples, please refer to <a href="https://tools.ietf.org/html/rfc7396">RFC-7396</a>.</p>
+
+<h3 id="permissions-to-merge-things-and-things-subresources">Permissions to merge things and things subresources</h3>
+<p>In order to execute such a merge operation, the authorized subject needs to have WRITE permission at all resources
+that should change by the merge. Consequently, if the permission is missing for some part of the merge,
+the merge is rejected and <strong>not</strong> applied at all.</p>
+
+<h2 id="examples">Examples</h2>
+
+<p>To demonstrate the new merge feature, we assume that the following thing already exists:</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">"com.acme:coffeebrewer"</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:coffeebrewer-policy"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:coffeebrewer:0.1.0"</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 demo corp."</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">"Berlin, main floor"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"serialno"</span><span class="p">:</span><span class="w"> </span><span class="s2">"42"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"model"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Speaking coffee machine"</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">"coffee-brewer"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"com.acme:coffeebrewer:0.1.0"</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">"brewed-coffees"</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="s2">"water-tank"</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">"configuration"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"smartMode"</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">"brewingTemp"</span><span class="p">:</span><span class="w"> </span><span class="mi">87</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"tempToHold"</span><span class="p">:</span><span class="w"> </span><span class="mi">44</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"timeoutSeconds"</span><span class="p">:</span><span class="w"> </span><span class="mi">6000</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="p">{</span><span class="w">
+ </span><span class="s2">"waterAmount"</span><span class="p">:</span><span class="w"> </span><span class="mi">731</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">44</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>
+
+<h3 id="permissions-to-execute-the-example">Permissions to execute the example</h3>
+<p>For this example, the authorized subject needs to have unrestricted WRITE permissions on all affected paths
+of the JSON merge patch: <em>attributes/manufacturingYear</em>, <em>features/water-tank/properties/configuration/smartMode</em>, and
+<em>features/water-tank/properties/configuration/tempToHold</em>.
+The WRITE permission must not be revoked on any level further down the hierarchy.
+Consequently, it is also sufficient for the authorized subject to have unrestricted WRITE permission at root level or
+unrestricted WRITE permission at /attributes and /features etc.</p>
+
+<p>The following subparts will show how to use the merge feature via the HTTP API, the Ditto protocol
+and the Ditto Java Client.</p>
+
+<h3 id="merge-via-http-api">Merge via HTTP API</h3>
+<p>An existing thing can be merged via the HTTP API using the <em>PATCH</em> method with the following request body.
+Notice that this request will add the “manufacturingYear” to the attributes, update the “tempToHold” to 50 and
+delete the “smartMode” key from the feature property “water-tank”.</p>
+
+<p>The <code class="highlighter-rouge">Content-Type</code> header for this request must be <em>application/merge-patch+json</em>.</p>
+
+<p>PATCH /things/com.acme:coffeebrewer</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">"attributes"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"manufacturingYear"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2020"</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">"water-tank"</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">"configuration"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"smartMode"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"tempToHold"</span><span class="p">:</span><span class="w"> </span><span class="mi">50</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>After the request was successfully performed the thing will 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">"com.acme:coffeebrewer"</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:coffeebrewer-policy"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:coffeebrewer:0.1.0"</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 demo corp."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"manufacturingYear"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2020"</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">"Berlin, main floor"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"serialno"</span><span class="p">:</span><span class="w"> </span><span class="s2">"42"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"model"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Speaking coffee machine"</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">"coffee-brewer"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"com.acme:coffeebrewer:0.1.0"</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">"brewed-coffees"</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="s2">"water-tank"</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">"configuration"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"brewingTemp"</span><span class="p">:</span><span class="w"> </span><span class="mi">87</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"tempToHold"</span><span class="p">:</span><span class="w"> </span><span class="mi">50</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"timeoutSeconds"</span><span class="p">:</span><span class="w"> </span><span class="mi">6000</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="p">{</span><span class="w">
+ </span><span class="s2">"waterAmount"</span><span class="p">:</span><span class="w"> </span><span class="mi">731</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">44</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>It is also possible to apply the <em>PATCH</em> method to all subresources of a thing, e.g. merging only the attributes of a thing. <br />
+Check out the newly added <em>PATCH</em> resources in our <a href="http-api-doc.html">HTTP API</a>.</p>
+
+<h3 id="merge-via-ditto-protocol">Merge via Ditto protocol</h3>
+<p>It is also possible to merge the existing thing via the Ditto protocol.
+Applying the following Ditto merge command to the existing thing will lead to the same result as in the above HTTP 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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/coffeebrewer/things/twin/commands/merge"</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/merge-patch+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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:coffeebrewer"</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">"manufacturingYear"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2020"</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">"water-tank"</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">"configuration"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"smartMode"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"tempToHold"</span><span class="p">:</span><span class="w"> </span><span class="mi">50</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>
+
+<p>Another Ditto protocol example to merge a feature property:</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/coffeebrewer/things/twin/commands/merge"</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/merge-patch+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">"/features/coffee-brewer/properties/brewed-coffees"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">42</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h3 id="using-the-ditto-client-to-merge-things">Using the ditto-client to merge things</h3>
+<p>The merge functionality is also supported via the <a href="client-sdk-java.html">Ditto Java Client</a>
+with the upcoming (<strong>Ditto Java Client version 2.0.0</strong>).</p>
+
+<p>Example for merging a thing with the Ditto Java Client:</p>
+
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">final</span> <span class="n">String</span> <span class="n">THING_ID</span> <span class="o">=</span> <span class="s">"com.acme:coffeebrewer"</span><span class="o">;</span>
+<span class="kd">final</span> <span class="n">String</span> <span class="n">FEATURE_ID</span> <span class="o">=</span> <span class="s">"water-tank"</span><span class="o">;</span>
+<span class="kd">final</span> <span class="n">JsonPointer</span> <span class="n">ATTRIBUTE_KEY</span> <span class="o">=</span> <span class="n">JsonFactory</span><span class="o">.</span><span class="na">newPointer</span><span class="o">(</span><span class="s">"manufacturingYear"</span><span class="o">);</span>
+<span class="kd">final</span> <span class="n">String</span> <span class="n">ATTRIBUTE_VALUE</span> <span class="o">=</span> <span class="s">"2020"</span><span class="o">;</span>
+<span class="kd">final</span> <span class="n">Feature</span> <span class="n">FEATURE</span> <span class="o">=</span> <span class="n">ThingsModelFactory</span><span class="o">.</span><span class="na">newFeatureBuilder</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">withId</span><span class="o">(</span><span class="n">FEATURE_ID</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">properties</span><span class="o">(</span><span class="n">ThingsModelFactory</span><span class="o">.</span><span class="na">newFeaturePropertiesBuilder</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">set</span><span class="o">(</span><span class="s">"smartMode"</span><span class="o">,</span> <span class="kc">false</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">set</span><span class="o">(</span><span class="s">"tempToHold"</span><span class="o">,</span> <span class="mi">50</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">build</span><span class="o">())</span>
+ <span class="o">.</span><span class="na">build</span><span class="o">();</span>
+
+<span class="kd">final</span> <span class="n">Thing</span> <span class="n">THING</span> <span class="o">=</span> <span class="n">ThingsModelFactory</span><span class="o">.</span><span class="na">newThingBuilder</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">setId</span><span class="o">(</span><span class="n">THING_ID</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">setAttribute</span><span class="o">(</span><span class="n">ATTRIBUTE_KEY_NEW</span><span class="o">,</span> <span class="n">JsonFactory</span><span class="o">.</span><span class="na">newValue</span><span class="o">(</span><span class="n">ATTRIBUTE_VALUE</span><span class="o">))</span>
+ <span class="o">.</span><span class="na">setFeature</span><span class="o">(</span><span class="n">FEATURE</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">build</span><span class="o">();</span>
+
+<span class="c1">// initialize the ditto-client</span>
+<span class="kd">final</span> <span class="n">DittoClient</span> <span class="n">dittoClient</span> <span class="o">=</span> <span class="o">...</span> <span class="o">;</span>
+
+<span class="n">dittoClient</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">merge</span><span class="o">(</span><span class="n">THING_ID</span><span class="o">,</span> <span class="n">THING</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">whenComplete</span><span class="o">(((</span><span class="n">adaptable</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="o">!=</span> <span class="kc">null</span><span class="o">)</span> <span class="o">{</span>
+ <span class="n">LOGGER</span><span class="o">.</span><span class="na">error</span><span class="o">(</span><span class="s">"Received error while sending MergeThing: '{}' "</span><span class="o">,</span> <span class="n">throwable</span><span class="o">.</span><span class="na">toString</span><span class="o">());</span>
+ <span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
+ <span class="n">LOGGER</span><span class="o">.</span><span class="na">info</span><span class="o">(</span><span class="s">"Received response for MergeThing: '{}'"</span><span class="o">,</span> <span class="n">adaptable</span><span class="o">);</span>
+ <span class="o">}</span>
+ <span class="o">}));</span>
+</code></pre></div></div>
+
+<p>After running this code snippet, the existing thing should look like the above result for the HTTP example.</p>
+
+<p>More examples for merging an attribute, all attributes and a feature property via Ditto Java Client.</p>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">// initialize the ditto-client</span>
+<span class="kd">final</span> <span class="n">DittoClient</span> <span class="n">dittoClient</span> <span class="o">=</span> <span class="o">...</span> <span class="o">;</span>
+
+ <span class="c1">// merge attribute</span>
+ <span class="n">dittoClient</span><span class="o">.</span><span class="na">twin</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">forId</span><span class="o">(</span><span class="s">"com.acme:coffeebrewer"</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">mergeAttribute</span><span class="o">(</span><span class="s">"manufacturingYear"</span><span class="o">,</span> <span class="s">"2021"</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">whenComplete</span><span class="o">(...);</span>
+
+ <span class="c1">// merge attributes</span>
+ <span class="n">dittoClient</span><span class="o">.</span><span class="na">twin</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">forId</span><span class="o">(</span><span class="s">"com.acme:coffeebrewer"</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">mergeAttributes</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="na">set</span><span class="o">(</span><span class="s">"manufacturingYear"</span><span class="o">,</span> <span class="s">"2021"</span><span class="o">).</span><span class="na">build</span><span class="o">())</span>
+ <span class="o">.</span><span class="na">whenComplete</span><span class="o">(...);</span>
+
+ <span class="c1">// merge feature property</span>
+ <span class="n">dittoClient</span><span class="o">.</span><span class="na">twin</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">forFeature</span><span class="o">(</span><span class="s">"com.acme:coffeebrewer"</span><span class="o">,</span> <span class="s">"water-tank"</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">mergeProperty</span><span class="o">(</span><span class="s">"configuration/smartMode"</span><span class="o">,</span> <span class="kc">false</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">whenComplete</span><span class="o">(...);</span>
+</code></pre></div></div>
+
+<h2 id="merge-events">Merge events</h2>
+<p>In this section we want to cover the new <code class="highlighter-rouge">ThingMerged</code> event which will be emitted after successfully applying an <code class="highlighter-rouge">MergeThing</code> command.
+For every HTTP request or Ditto protocol message which performs a merge operation on a thing there will be sent out
+exactly one <code class="highlighter-rouge">ThingMerged</code> event. This event contains the <strong>path</strong> and the <strong>value</strong> of the merge operation.
+The <strong>path</strong> describes on which level of the thing the <strong>value</strong> was merged.</p>
+
+<h3 id="merge-event-example">Merge event example</h3>
+<p>Let’s assume we want to patch/merge multiple feature properties at once.
+PATCH /things/com.acme:coffeebrewer/features</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">"coffee-brewer"</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">"brewed-coffees"</span><span class="p">:</span><span class="w"> </span><span class="mi">10</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"water-tank"</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">"configuration"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"smartMode"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"tempToHold"</span><span class="p">:</span><span class="w"> </span><span class="mi">30</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>The following <code class="highlighter-rouge">ThingMerged</code> event is emitted:</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/coffeebrewer/things/twin/events/merged"</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/merge-patch+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">"/features"</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">"coffee-brewer"</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">"brewed-coffees"</span><span class="p">:</span><span class="w"> </span><span class="mi">10</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"water-tank"</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">"configuration"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"smartMode"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"tempToHold"</span><span class="p">:</span><span class="w"> </span><span class="mi">30</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">"revision"</span><span class="p">:</span><span class="w"> </span><span class="mi">42</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"timestamp"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2021-02-04T09:42:39Z"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="feedback">Feedback?</h2>
+
+<p>Please <a href="feedback.html">get in touch</a> if you have feedback or questions towards this new functionality.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2021-03-22-azure-iot-hub-integration.html b/2.0/2021-03-22-azure-iot-hub-integration.html
new file mode 100644
index 0000000..a2ae5c6
--- /dev/null
+++ b/2.0/2021-03-22-azure-iot-hub-integration.html
@@ -0,0 +1,560 @@
+<!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="blogarchitectureconnectivity, ">
+<title> Use Eclipse Ditto with Azure IoT Hub as message broker </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Use Eclipse Ditto with Azure IoT Hub as message broker">{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/3c657b46dc4d006056091942068f6ad7?s=135" alt="A photo of David Schwilk" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.com/derschwilk" target="_blank">David Schwilk</a>-->
+<!--</span>-->
+<!---->
+
+<article class="post" itemscope itemtype="http://schema.org/BlogPosting">
+
+ <header class="post-header">
+ <h1 class="post-title" itemprop="name headline">Use Eclipse Ditto with Azure IoT Hub as message broker</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/3c657b46dc4d006056091942068f6ad7?s=135" alt="A photo of David Schwilk" 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="https://github.com/derschwilk" target="_blank">David Schwilk</a> </span></span> on <time datetime="2021-03-22T00:00:00+00:00" itemprop="datePublished">Mar 22, 2021</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>,
+
+
+
+ <a href="tag_architecture.html">architecture</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>
+
+
+
+ <p>This blogpost is based upon Eclipse Ditto Version <strong>1.5.0</strong>, the Azure IoT Suite as of
+<strong>2021-03-19</strong> and the azure-iot-device-client version <strong>1.29.2</strong>.</p>
+
+<h1 id="connecting-devices-to-eclipse-ditto-via-azure-iot-hub">Connecting devices to Eclipse Ditto via Azure IoT Hub</h1>
+<p>This blog post elaborates on connecting and managing devices in Eclipse Ditto by using the Azure IoT Hub
+as a message broker.</p>
+
+<p><img src="images/blog/2021-03-22-azure-iot-hub-integration-overview.png" alt="Connection Overview" /></p>
+
+<p>The basic functionality that can be used at the time of creating this blogpost are:</p>
+
+<ul>
+ <li>[D2C] Sending telemetry data from the device to update its Ditto digital-twin representation.</li>
+ <li>[D2C] Same ID enforcement based on the Azure IoT Hub device-id to prevent spoofing other digital-twins.</li>
+ <li>[C2D] Sending live-messages to the device.</li>
+ <li>[D2C] Sending feedback to live messages to the service.</li>
+</ul>
+
+<h2 id="setting-up-connections-in-ditto">Setting up connections in Ditto</h2>
+<p>The features described above will work with an “out-of-the-box” Azure IoT Hub subscription,
+so no additional configuration is needed in the IoT Hub. In order to connect Ditto to the IoT Hub you have to set up
+two AMQP 1.0 connections. One for receiving telemetry data, the other for sending live-messages and receiving
+live-message feedback.</p>
+
+<h3 id="telemetry-connection">Telemetry Connection</h3>
+
+<p>This connection subscribes to telemetry messages, published by the Azure IoT Hub built-in “Event Hub like” endpoint.</p>
+
+<p>Adding an enforcement for the <code class="highlighter-rouge">{{ thing:id }}</code> based on the <code class="highlighter-rouge">{{ header:iothub-connection-device-id }}</code> prevents
+applying a digital-twin update to the twin of another device (Device Spoofing).</p>
+
+<p>To establish this connection the placeholders below have to be substituted by:</p>
+
+<ul>
+ <li>
+ <p><code class="highlighter-rouge">{{userName}}</code>: The <code class="highlighter-rouge">SharedAccessKeyName</code> in your Event Hub-compatible endpoint (i.e. service).</p>
+ </li>
+ <li>
+ <p><code class="highlighter-rouge">{{password}}</code>: The <code class="highlighter-rouge">SharedAccessKey</code> in your Event Hub-compatible endpoint.</p>
+ </li>
+ <li>
+ <p><code class="highlighter-rouge">{{endpoint}}</code>: The <code class="highlighter-rouge">Endpoint</code> in your Event Hub-compatible endpoint (Cut leading “sb://” and trailing slash,
+e.g.. ihsuprodblres055dednamespace.servicebus.windows.net).</p>
+ </li>
+ <li>
+ <p><code class="highlighter-rouge">{{entityPath}}</code>: The <code class="highlighter-rouge">EntitiyPath</code> in your Event Hub-compatible endpoint (e.g.. hubname-8584619-2e72252706).</p>
+ </li>
+</ul>
+
+<p><em>Note: You can use the “service” IoT Hub policy instead of the “iothubowner” policy, since this is more restricitve,
+and represents the actual use of Ditto as a northbound service.</em></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">"azure-example-connection-telemetry"</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">"amqp-10"</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">false</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">"amqps://{{userName}}:{{password}}@{{endpoint}}:5671"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"source"</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">"{{entityPath}}/ConsumerGroups/$Default/Partitions/0"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"{{entityPath}}/ConsumerGroups/$Default/Partitions/1"</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"</span><span class="p">],</span><span class="w">
+ </span><span class="s2">"enforcement"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"input"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ header:iothub-connection-device-id }}"</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="s2">"{{ thing:id }}"</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>
+<ul>
+ <li>
+ <p><a href="https://www.eclipse.org/ditto/connectivity-manage-connections.html">Further information on creating connections</a></p>
+ </li>
+ <li>
+ <p><a href="https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-devguide-messages-d2c">Further information on D2C messaging capabilities of Azure IoT Hub</a></p>
+ </li>
+ <li>
+ <p><a href="https://docs.microsoft.com/de-de/azure/iot-hub/iot-hub-devguide-messages-read-builtin">Further information on the built-in “event-hub like” endpoint of Azure IoT Hub</a></p>
+ </li>
+</ul>
+
+<h3 id="message-connection">Message connection</h3>
+
+<p>This connection enables forwarding live messages to the Azure IoT Hub (which forwards it to the device)
+and receiving feedback to these live-messages from the device.</p>
+
+<p>Adding the header-mapping <code class="highlighter-rouge">"message_id": "{{header:correlation-id}}"</code> enables Azure IoT Hub to correlate messages.
+Adding the header-mapping <code class="highlighter-rouge">"to": "/devices/{{ header:ditto-message-thing-id }}/messages/deviceInbound"</code> is
+necessary for correct message routing by Azure IoT Hub. The header <code class="highlighter-rouge">ditto-message-thing-id</code> will be set as a
+default header by Ditto.</p>
+
+<p>To establish this connection the placeholders below have to be substituted:</p>
+
+<ul>
+ <li>
+ <p><code class="highlighter-rouge">{{userName}}</code>: The name of the chosen IoT Hub policy + “@sas.root.” + the name of your IoT Hub
+(i.e. service@sas.root.my-hub).</p>
+ </li>
+ <li>
+ <p><code class="highlighter-rouge">{{hostName}}</code>: The Hostname of your IoT Hub (i.e. my-hub.azure-devices.net).</p>
+ </li>
+ <li>
+ <p><code class="highlighter-rouge">{{encodedSasToken}}</code>: An URL encoded SAS token. Information on how to generate a token can be found at
+<a href="https://docs.microsoft.com/en-us/cli/azure/ext/azure-iot/iot/hub?view=azure-cli-latest#ext_azure_iot_az_iot_hub_generate_sas_token">az iot hub generate-sas-token.</a>
+The generated token has to be additionally URL encoded (browser console -> <code class="highlighter-rouge">encodeURI('{{generatedToken}}')</code>).</p>
+ </li>
+</ul>
+
+<p><em>Note: The generated SAS token has a maximum TTL of 365 days, so the token has to be changed to a newly generated before expiry.
+Otherwise, the connection tries to reconnect or closes automatically, when <code class="highlighter-rouge">failoverEnabled</code> is set to <code class="highlighter-rouge">false</code>.</em></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">"azure-example-connection-messages"</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">"amqp-10"</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">false</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">"amqps://{{userName}}:{{encodedSasToken}}@{{hostName}}:5671"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"target"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="p">{</span><span class="s2">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/messages/devicebound"</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/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"</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">"message_id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{header:correlation-id}}"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"to"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/devices/{{ header:ditto-message-thing-id }}/messages/deviceInbound"</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><strong>The java azure-iot-device-client currently can not be used to receive messages with JSON as body.
+Thus, the messages’ payload has to be byte-encoded.</strong></p>
+
+<p>This can be achieved by configuring an outgoing JavaScript payload mapper in the message connection:</p>
+<div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">function</span> <span class="nx">mapFromDittoProtocolMsg</span><span class="p">(</span>
+ <span class="nx">namespace</span><span class="p">,</span>
+ <span class="nx">name</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">headers</span> <span class="o">=</span> <span class="nx">dittoHeaders</span><span class="p">;</span>
+ <span class="kd">let</span> <span class="nx">textPayload</span> <span class="o">=</span> <span class="kc">null</span><span class="p">;</span>
+ <span class="kd">let</span> <span class="nx">bytePayload</span> <span class="o">=</span> <span class="nx">Ditto</span><span class="p">.</span><span class="nx">stringToArrayBuffer</span><span class="p">(</span><span class="nx">Ditto</span><span class="p">.</span><span class="nx">buildDittoProtocolMsg</span><span class="p">(</span><span class="nx">namespace</span><span class="p">,</span> <span class="nx">name</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">toString</span><span class="p">());</span>
+ <span class="kd">let</span> <span class="nx">contentType</span> <span class="o">=</span> <span class="s1">'application/octet-stream'</span><span class="p">;</span>
+
+ <span class="k">return</span> <span class="nx">Ditto</span><span class="p">.</span><span class="nx">buildExternalMsg</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>
+</code></pre></div></div>
+
+<ul>
+ <li>
+ <p><a href="https://www.eclipse.org/ditto/connectivity-manage-connections.html">Further information on creating connections</a></p>
+ </li>
+ <li>
+ <p><a href="https://www.eclipse.org/ditto/connectivity-mapping.html">Further information on payload-mapping</a></p>
+ </li>
+ <li>
+ <p><a href="https://docs.microsoft.com/de-de/azure/iot-hub/iot-hub-devguide-messages-c2d">Further information on C2D messaging capabilities of Azure IoT Hub</a></p>
+ </li>
+</ul>
+
+<h2 id="possible-improvements">Possible improvements</h2>
+
+<p>Some features of Ditto could be used in combination with Azure IoT Hub with some adjustments. These include:</p>
+
+<ul>
+ <li>Using the <code class="highlighter-rouge">ImplicitThingCreationMapper</code> to implicitly create a new thing when a new device is registered in Azure IoT Hub.</li>
+ <li>Using the ConnectionStatusMapper to update the ConnectionStatus of things, when their devices disconnect from Azure IoT Hub.</li>
+ <li>[C2D] Directly invoke methods on the device (Direct Method Invocation).</li>
+</ul>
+
+<h3 id="using-the-implicitthingcreation-and-connectionstatus-features-based-on-azure-iot-hub-events">Using the ImplicitThingCreation and ConnectionStatus features based on Azure IoT Hub events</h3>
+
+<p>Azure IoT Hub has the possibility to publish events for status changes of device connections and the creation/removal of new devices.
+These events are published via an Azure EventGrid to another chosen Azure application.
+By publishing these events to an Azure Event Hub, a Ditto AMQP connection can subscribe for them.</p>
+
+<p>The payload-mappers for <code class="highlighter-rouge">ImplicitThingCreation</code> and <code class="highlighter-rouge">ConnectionStatus</code> could be adjusted to handle such event messages and
+create new things or update the <code class="highlighter-rouge">ConnectionStatus</code> feature depending on the received messages.</p>
+
+<ul>
+ <li><a href="https://docs.microsoft.com/de-de/azure/event-grid/event-schema-iot-hub?tabs=event-grid-event-schema">Further information on the events published by Azure IoT Hub</a></li>
+</ul>
+
+<h3 id="using-direct-method-invocation">Using Direct Method Invocation</h3>
+
+<p>Azure IoT Hub provides an endpoint for directly invoking methods on a device. This can be compared to live-commands.
+Direct Method Invocation can only be done via HTTP. For authentication SAS has to be used.
+This authentication mechanism, however, is not yet implemented for HTTP Push of Eclipse Ditto
+connections.</p>
+
+<ul>
+ <li><a href="https://docs.microsoft.com/de-de/azure/iot-hub/iot-hub-devguide-direct-methods">Further information on direct method invocations</a></li>
+</ul>
+
+<h3 id="implementing-an-automatic-refresh-mechanism-for-sasl-tokens">Implementing an automatic refresh mechanism for SASL tokens</h3>
+
+<p>The <code class="highlighter-rouge">connectionString</code> provided by an Azure IoT Hub device’s policy could be used to generate and refresh a SASL token.
+This would require a new connection setting, which could store such a <code class="highlighter-rouge">connectionString</code>, and an algorithm, which can
+generate a SAS token out of that string.</p>
+
+<h2 id="getting-started">Getting started</h2>
+
+<p>To get started using Azure IoT Hub as a message broker for Eclipse Ditto, the
+<a href="https://github.com/eclipse/ditto-examples/tree/master/azure/azure-iot-hub-device-simulator">Azure IoT Hub Device Simulator Example</a>
+is a good entry point.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2021-03-31-ssh-tunneling-for-managed-connections.html b/2.0/2021-03-31-ssh-tunneling-for-managed-connections.html
new file mode 100644
index 0000000..04e27dc
--- /dev/null
+++ b/2.0/2021-03-31-ssh-tunneling-for-managed-connections.html
@@ -0,0 +1,421 @@
+<!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="blogarchitectureconnectivity, ">
+<title> Support SSH tunneling for managed connections </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Support SSH tunneling for managed connections">{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/c6d7916bf0fd9cb08b047602bfc4deab?s=135" alt="A photo of Vadim Günther" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.com/VadimGue" target="_blank">Vadim Günther</a>-->
+<!--</span>-->
+<!---->
+
+<article class="post" itemscope itemtype="http://schema.org/BlogPosting">
+
+ <header class="post-header">
+ <h1 class="post-title" itemprop="name headline">Support SSH tunneling for managed connections</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/c6d7916bf0fd9cb08b047602bfc4deab?s=135" alt="A photo of Vadim Günther" 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="https://github.com/VadimGue" target="_blank">Vadim Günther</a> </span></span> on <time datetime="2021-03-31T00:00:00+00:00" itemprop="datePublished">Mar 31, 2021</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>,
+
+
+
+ <a href="tag_architecture.html">architecture</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>
+
+
+
+ <p>With the upcoming release of Eclipse Ditto <strong>version 2.0.0</strong> it will be possible to</p>
+
+<h1 id="ssh-tunneling-for-managed-connections">SSH tunneling for managed connections</h1>
+<p>With the upcoming release of Eclipse Ditto version 2.0.0, managed connections support establishing
+an SSH tunnel, which is then used to connect to the actual target endpoint. This is useful when the target endpoint is
+not directly accessible. Currently, this feature is available for all connection types supported in Ditto, except for
+Kafka 2.x.</p>
+
+<p><img src="images/blog/2021-04-06-ssh-tunnel-for-managed-connections-shema.png" alt="Connection Overview" /></p>
+
+<p>For further information, see <a href="https://tools.ietf.org/html/rfc4254#section-7">Secure Shell (SSH) Connection Protocol, RFC4254</a></p>
+
+<h2 id="setting-up-connections-with-ssh-tunneling-in-ditto">Setting up connections with SSH tunneling in Ditto</h2>
+<p>When setting up a tunneled connection, the configuration must specify the <code class="highlighter-rouge">sshTunnel</code> section, which contains
+the necessary information to establish the SSH port forwarding. For authentication, password and public
+key are supported. Also, host validation using public key fingerprints are supported. The tunnel configuration does not
+affect the other parts of your connection configuration. If the feature is enabled the connection will establish an SSH
+tunnel and afterwards use this tunnel to connect to the desired endpoint. In case you later disable the SSH tunnel
+feature, the payload will be processed directly to the desired endpoint.</p>
+
+<h3 id="basic-authentication">Basic Authentication</h3>
+<p>When using basic authenticating the <code class="highlighter-rouge">sshTunnel</code> configuration should contain the <code class="highlighter-rouge">credentials.type</code> <code class="highlighter-rouge">plain</code>, as
+well as the <code class="highlighter-rouge">username</code> and <code class="highlighter-rouge">password</code> fields:</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">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"tunneled-connection"</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">"uri"</span><span class="p">:</span><span class="w"> </span><span class="s2">"tcp://mqtt.eclipseprojects.io: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="err">...</span><span class="w"> </span><span class="p">}],</span><span class="w">
+ </span><span class="s2">"sshTunnel"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"enabled"</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">"ssh://ssh-host:2222"</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">"plain"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"username"</span><span class="p">:</span><span class="w"> </span><span class="s2">"username"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"password"</span><span class="p">:</span><span class="w"> </span><span class="s2">"password"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"validateHost"</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">"knownHosts"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"MD5:e0:3a:34:1c:68:ed:c6:bc:7c:ca:a8:67:c7:45:2b:19"</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="authentication-with-public-key">Authentication with public key</h3>
+<p>On public key authentication the <code class="highlighter-rouge">credentials.type</code> is <code class="highlighter-rouge">public-key</code>. In addition to the <code class="highlighter-rouge">username</code> the <code class="highlighter-rouge">publicKey</code> and
+<code class="highlighter-rouge">privateKey</code> have to be provided. The public key must be provided as PEM-encoded key in <code class="highlighter-rouge">X.509</code> format. The private
+key must be provided as PEM-encoded key in unencrypted <code class="highlighter-rouge">PKCS8</code> format as specified by <a href="https://tools.ietf.org/html/rfc7468">RFC-7468</a>.</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">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"tunneled-connection"</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">"uri"</span><span class="p">:</span><span class="w"> </span><span class="s2">"tcp://mqtt.eclipseprojects.io: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="err">...</span><span class="w"> </span><span class="p">}],</span><span class="w">
+ </span><span class="s2">"sshTunnel"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"enabled"</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">"ssh://ssh-host:2222"</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">"public-key"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"username"</span><span class="p">:</span><span class="w"> </span><span class="s2">"username"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"publicKey"</span><span class="p">:</span><span class="w"> </span><span class="s2">"-----BEGIN PUBLIC KEY-----</span><span class="se">\n</span><span class="s2">MIIBIjANBgkqhkiG9.....</span><span class="se">\n</span><span class="s2">-----END PUBLIC KEY-----"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"privateKey"</span><span class="p">:</span><span class="w"> </span><span class="s2">"-----BEGIN PRIVATE KEY-----</span><span class="se">\n</span><span class="s2">MIIEvAIBADANBgkqhki....</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">"validateHost"</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">"knownHosts"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"MD5:e0:3a:34:1c:68:ed:c6:bc:7c:ca:a8:67:c7:45:2b:19"</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>The following command can be used to convert a standard OpenSSL key in PKCS1 format to the PKCS8 format accepted by Ditto:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>openssl pkcs8 -topk8 -nocrypt -in client-private.pem.key -out client-private.pem.pk8
+</code></pre></div></div>
+
+<h3 id="host-validation-using-public-key-fingerprints">Host validation using public key fingerprints</h3>
+<p>When <code class="highlighter-rouge">validateHost</code> is enabled, the host public key fingerprints are validated. They can be provided
+in the format the standard command line tool <code class="highlighter-rouge">ssh-keygen</code> produces them. The fingerprints are
+prefixed with an alias of the hash algorithm that was used to calculate the fingerprint. Ditto supports the following
+hash algorithms for public key fingerprints: <code class="highlighter-rouge">MD5</code>, <code class="highlighter-rouge">SHA1</code>, <code class="highlighter-rouge">SHA224</code>, <code class="highlighter-rouge">SHA256</code>, <code class="highlighter-rouge">SHA384</code> and <code class="highlighter-rouge">SHA512</code>. To generate a
+valid fingerprint with an <code class="highlighter-rouge">MD5</code> hash algorithm from the public key, following can be used:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ssh-keygen -lf id_rsa.pub -E md5
+</code></pre></div></div>
+
+<h2 id="feedback">Feedback?</h2>
+
+<p>Please <a href="feedback.html">get in touch</a> if you have feedback or questions regarding this new functionality.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/2021-05-06-release-announcement-200.html b/2.0/2021-05-06-release-announcement-200.html
new file mode 100644
index 0000000..807abd5
--- /dev/null
+++ b/2.0/2021-05-06-release-announcement-200.html
@@ -0,0 +1,382 @@
+<!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 2.0.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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 2.0.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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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 2.0.0</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2021-05-06T00:00:00+00:00" itemprop="datePublished">May 6, 2021</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>Today, ~1.5 years after release <a href="2019-12-12-release-announcement-100.html">1.0.0</a>, the Eclipse Ditto team is happy to
+announce the availability of Eclipse Ditto <a href="https://projects.eclipse.org/projects/iot.ditto/releases/2.0.0">2.0.0</a>.</p>
+
+<p>With the major version 2.0.0 the Ditto team removed technical debt and ended support for APIs which were deprecated
+long ago in order to have a better maintainable codebase. However some awesome new features are included as well.</p>
+
+<h2 id="adoption">Adoption</h2>
+
+<p>Companies are willing to show their adoption of Eclipse Ditto publicly: <a href="https://iot.eclipse.org/adopters/?#iot.ditto">https://iot.eclipse.org/adopters/?#iot.ditto</a></p>
+
+<p>From our various <a href="feedback.html">feedback channels</a> we however know of more adoption.<br />
+If you are making use of Eclipse Ditto, it would be great to show this by adding your company name to that list of
+known adopters.<br />
+In the end, that’s one main way of measuring the success of the project.</p>
+
+<h2 id="changelog">Changelog</h2>
+
+<p>The main improvements and additions of Ditto 2.0.0 are:</p>
+
+<ul>
+ <li>Merge/PATCH updates of digital twins</li>
+ <li>Configurable OpenID Connect / OAuth2.0 claim extraction to be used for authorization</li>
+ <li>Establishing connections to endpoints (via AMQP, MQTT, HTTP) utilizing a Ditto managed SSH tunnel</li>
+ <li>Addition of a DevOps API in order to retrieve all known connections</li>
+ <li>Expiring policy subjects + publishing of announcement message prior to expiry</li>
+ <li>Addition of policy actions in order to inject a policy subject based on a provided JWT</li>
+ <li>Built-in acknowledgement for search updates to have the option of twin updates with strong consistency of the search index</li>
+ <li>Restoring active connection faster after a hard restart of the Ditto cluster via automatic prioritization of connections</li>
+ <li>Support for LastWill/Testament + retain flag for MQTT connections</li>
+</ul>
+
+<p>The step to a major version was done because of the following breaking API changes:</p>
+
+<ul>
+ <li>Removal of “API version 1” (deprecated in <a href="release_notes_110.html#deprecations">Ditto 1.1.0</a>)
+from Ditto’s Java APIs + HTTP API</li>
+ <li>Removal of code in Java APIs marked as <code class="highlighter-rouge">@Deprecated</code></li>
+ <li>Binary incompatible changes to Java APIs</li>
+ <li>Restructuring of Ditto’s Maven modules in order to simplify/ease further development</li>
+</ul>
+
+<p>The following non-functional enhancements are also included:</p>
+
+<ul>
+ <li>Improvement of stability during rolling updates</li>
+ <li>Addition of sharding concept for Ditto internal pub/sub enabling connection of e.g. tens of thousands Websocket Wessions</li>
+ <li>Background cleanup improvements in order to have less impact on DB roundtrip times</li>
+ <li>Update of third party libraries (e.g. Akka)</li>
+ <li>Documentation of deployment via K3S</li>
+</ul>
+
+<p>Please have a look at the <a href="release_notes_200.html">2.0.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>The Ditto JavaScript client release was published on <a href="https://www.npmjs.com/~eclipse_ditto">npmjs.com</a>:</p>
+<ul>
+ <li><a href="https://www.npmjs.com/package/@eclipse-ditto/ditto-javascript-client-dom">@eclipse-ditto/ditto-javascript-client-dom</a></li>
+ <li><a href="https://www.npmjs.com/package/@eclipse-ditto/ditto-javascript-client-node">@eclipse-ditto/ditto-javascript-client-node</a></li>
+</ul>
+
+<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>
+
+<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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/404.html b/2.0/404.html
new file mode 100644
index 0000000..ae8fa4f
--- /dev/null
+++ b/2.0/404.html
@@ -0,0 +1,1782 @@
+<!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=" ">
+<title> Page Not Found • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Page Not Found">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Page Not Found</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>Sorry, but the page you were trying to view does not exist.</p>
+
+<p>Try searching for it or looking at the URL to see if it looks correct.</p>
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/Gemfile_ b/2.0/Gemfile_
new file mode 100644
index 0000000..97a5c41
--- /dev/null
+++ b/2.0/Gemfile_
@@ -0,0 +1,28 @@
+source "https://rubygems.org"
+
+# Hello! This is where you manage which Jekyll version is used to run.
+# When you want to use a different version, change it below, save the
+# file and run `bundle install`. Run Jekyll with `bundle exec`, like so:
+#
+# bundle exec jekyll serve
+#
+# This will help ensure the proper Jekyll version is running.
+# Happy Jekylling!
+gem "jekyll", "~> 3.8.3"
+
+# This is the default theme for new Jekyll sites. You may change this to anything you like.
+
+# If you want to use GitHub Pages, remove the "gem "jekyll"" above and
+# uncomment the line below. To upgrade, run `bundle update github-pages`.
+# gem "github-pages", group: :jekyll_plugins
+
+# If you have any plugins, put them here!
+group :jekyll_plugins do
+ gem "jekyll-sitemap", "~> 1.2.0"
+end
+
+# Windows does not include zoneinfo files, so bundle the tzinfo-data gem
+gem "tzinfo-data", platforms: [:mingw, :mswin, :x64_mingw, :jruby]
+
+# Performance-booster for watching directories on Windows
+gem "wdm", "~> 0.1.0" if Gem.win_platform?
diff --git a/2.0/advanced-data-by-pass.html b/2.0/advanced-data-by-pass.html
new file mode 100644
index 0000000..b87c2de
--- /dev/null
+++ b/2.0/advanced-data-by-pass.html
@@ -0,0 +1,1923 @@
+<!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="advanced, auth, access control, router, content-type, correlation-id, feature, message, payload, thing">
+<title> Data By-Pass Pattern • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Data By-Pass Pattern">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li class="active"><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Data By-Pass Pattern</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>This pattern centers around the idea to delegate the data transmission to external services, by-passing the Ditto cluster,
+while still being able to benefit from Ditto’s <a href="basic-policy.html">policy system</a> and IoT architecture.</p>
+
+<h2 id="context">Context</h2>
+
+<p>You have services exposing their functionality transparently though Ditto’s messaging API as part of your digital twin.
+E.g. a history service providing the actual interface to your timeseries database as part of the things interface such
+that a client may not need to know if the history actually is managed by the thing itself or any other program.
+You use Ditto’s <a href="basic-policy.html">policy system</a> to secure access to your services that way.</p>
+
+<p>Your services provide data in quantities that are not suited for transmission through the Ditto cluster directly,
+because of (de-)serialization costs, round-trip-times etc.</p>
+
+<h2 id="problem">Problem</h2>
+
+<p>You want to query a greater amount of data (e.g. database query result) by issuing a Ditto message to a thing which is
+picked up by a service speaking with you databases. It does not work to just let this service return the result
+as a response to the Ditto message, since the messaging system in the Ditto cluster is not designed for big quantities
+of data and will reject them based on tight quotas. Also the costs due to many (de-)serialization steps are high.</p>
+
+<h2 id="solution">Solution</h2>
+
+<p>The solution consists of the following systems:</p>
+
+<ul>
+ <li><strong>database</strong>: where your bigger chunks of data reside and wait to be delivered / queried</li>
+ <li><strong>database provider mirco-service</strong>: the service managing the database connection and exposing it to clients through
+things messaging API</li>
+ <li><strong>thing</strong>: a digital twin with extended API through a micro-service</li>
+ <li><strong>client</strong>: a client-application trying to receive bigger quantities of data via a things messaging API in the scope
+of that thing and secured via ditto policies</li>
+ <li><strong>high-performance data proxy</strong> (or just proxy): a third-party application proxy sitting in-between the database and
+the provider micro-service managing data delivery</li>
+</ul>
+
+<figure><img class="docimage" src="images/pages/advanced/data-by-pass-architectural-design.jpg" alt="Architectural Design" style="max-width: 800px" /><figcaption>Architectural design of the data by-pass pattern showing all actors and their interactions.</figcaption></figure>
+
+<p>In order for the client-application to retrieve the requested data in a secure and performant way we introduce a
+high-performance proxy (e.g. based on nginx, example below). The proxy will not have any credentials by itself,
+it’s just serving prepared queries on a randomly, hard-to-guess URL with an expiration time of 5 minutes.
+It features an admin API which the micro-service has credentials to access.</p>
+
+<p>The provider micro-service hooks into a twin (e.g. via websockets) and listens for queries.
+If a query arrives it will formulate the query, store it at the high-performance proxy (which might already query the data)
+and return a randomly generated URL to the proxy together with a Location-header as a response to the client-application.
+The client then needs to follow the response in order to retrieve the data from the proxy.</p>
+
+<p>With this approach the access to the database is secured via Ditto <a href="basic-policy.html">policies</a> and in scope of single
+things while the data retrieval happens via a performant proxy application without the Ditto cluster ever seeing those packages.</p>
+
+<p><em>Note: Keep in mind that security in this situation is highly dependent of the micro-service implementation.
+You have to make sure that your implementation uses provided information of ditto properly and that the contents of
+a message do not allow a violation of the policy. E.g. through SQL-Injections.</em></p>
+
+<h2 id="discussion">Discussion</h2>
+
+<p><strong>Benefits</strong>:</p>
+
+<ul>
+ <li>Higher performance compared to using just Ditto</li>
+ <li>The Ditto <a href="basic-policy.html">policy system</a> can be utilized to scope and secure data access from clients to databases/-stores</li>
+</ul>
+
+<p><strong>Drawbacks</strong>:</p>
+
+<ul>
+ <li>A third-party application for the high-performance proxy has to be added and maintained</li>
+ <li>A custom messaging API is necessary in the first place introducing a higher complexity</li>
+ <li>A translation of certain query-languages from messages to the actual databases / applications has to be implemented</li>
+</ul>
+
+<p><strong>Issues</strong>:</p>
+
+<ul>
+ <li>Managing and communicating custom messaging APIs is not natively supported in Ditto, other ways have to be explored to
+keep APIs consistent</li>
+</ul>
+
+<h2 id="policies">Policies</h2>
+
+<p>Policies can be used to restrict access to the provider micro-service and through that eventually to the database using
+restrictions on the <code class="highlighter-rouge">message:/</code> resource.</p>
+
+<p>Let’s assume that the provider micro-service registers via websockets and expects requests to the message-topic
+<code class="highlighter-rouge">/services/history</code>. With the following policy entry we can allow access to this resource:</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">"subjects"</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">"message:/"</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">"revoke"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"READ"</span><span class="p">,</span><span class="w"> </span><span class="s2">"WRITE"</span><span class="p">]</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"message:/inbox/messages/services/history"</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="s2">"READ"</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">"message:/outbox/messages/services/history"</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="s2">"WRITE"</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>
+
+<p>The first resource entry revokes any access to messages for subjects of this type. This is optional. The next entry
+allows the provider micro-service to read messages from the topic <code class="highlighter-rouge">/services/history</code>. Note that we’ve decided to insert
+another “namespace” <code class="highlighter-rouge">/services</code> here to distinguish these messages from other device faced messages. The last section
+than allows the provider micro-service to reply to the received requests with it’s 303 response.</p>
+
+<p>This can also be built against single features. Since features have to be stated explicitly in the policy, this is not
+as general but can provide a more fine-grained access control when using distinct policies for different things,
+or features with same names over multiple things.</p>
+
+<h2 id="proxy-implementations">Proxy Implementations</h2>
+
+<p>The <a href="https://github.com/sourcelair/ceryx">ceryx proxy project</a> was used for the
+<a href="https://github.com/w4tsn/ceryx">PoC (or reference implementation)</a> of this pattern.
+It was enhanced with delegation features which still have to be contributed upstream.
+Have a look at the <a href="https://github.com/w4tsn/ceryx">forks source code</a> or
+the <a href="https://quay.io/repository/w4tsn/ceryx">corresponding container image</a> until then.</p>
+
+<p>The ceryx proxy is a modified nginx with a redis-database to store the randomly generated IDs correlating with prepared queries.
+It is not suited for this use-case on its own so capabilities to store queries (including Authentication) behind
+expiring random URLs was added, but not send upstream yet.</p>
+
+<h2 id="known-uses">Known uses</h2>
+
+<p><strong><a href="https://www.othermo.de">othermo GmbH</a> uses this for a history-service</strong>: The history service connects to Ditto via
+websockets and hooks into things by answering specific <code class="highlighter-rouge">/history</code> messages. The messages API is translated to InfluxDB queries
+which then are stored with a randomly generated URL and expiration of 5 minutes at the high-performance proxy.
+The service then returns the random URL to the client which then follows the 303 to retrieve the actual data.</p>
+
+<p>The messages contain InfluxDB-similar query elements while the query is only constructed at the provider service.
+That’s because the provider service uses the databases specifics like Tags in InfluxDB to assign thingId, policy and
+path information in order to get the stored data into the right scopes and to be able to retrieve the correct sets of data.</p>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_advanced.html" class="btn btn-default navbar-btn cursorNorm" role="button">advanced</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/architecture-overview.html b/2.0/architecture-overview.html
new file mode 100644
index 0000000..ad3fd14
--- /dev/null
+++ b/2.0/architecture-overview.html
@@ -0,0 +1,1835 @@
+<!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="architecture, architecture, overview, component, services">
+<title> Architecture overview • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Architecture overview">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Architecture</a>
+ <ul>
+
+
+
+ <li class="active"><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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Architecture overview</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>The architecture chapter describes the overall architecture of Eclipse Ditto and in detail which sub-components fulfill
+which responsibilities.</p>
+
+<h2 id="top-level-component-view">Top level component view</h2>
+
+<p>This overview shows the Ditto services (components), the externally provided and consumed API endpoints,
+the external dependencies (MongoDB and nginx) and the relations of the services to each other.</p>
+
+<figure><img class="docimage" src="images/pages/architecture/context-overview.png" alt="Ditto services and context" style="max-width: 800px" /><figcaption>Ditto services in blue and context with nginx as reverse proxy and MongoDB</figcaption></figure>
+
+<p>The components have the following tasks:</p>
+
+<ul>
+ <li><a href="architecture-services-policies.html">Policies</a>: persistence of <a href="basic-policy.html">Policies</a></li>
+ <li><a href="architecture-services-things.html">Things</a>: persistence of <a href="basic-thing.html">Things</a> and <a href="basic-feature.html">Features</a></li>
+ <li><a href="architecture-services-things-search.html">Things-Search</a>: tracking changes to <code class="highlighter-rouge">Things</code>, <code class="highlighter-rouge">Features</code>, <code class="highlighter-rouge">Policies</code> and
+updating an optimized search index + executes queries on this search index</li>
+ <li><a href="architecture-services-concierge.html">Concierge</a>: orchestrates and authorizes the backing persistence services</li>
+ <li><a href="architecture-services-gateway.html">Gateway</a>: provides HTTP and WebSocket API</li>
+ <li><a href="architecture-services-connectivity.html">Connectivity</a>:
+sends <a href="protocol-overview.html">Ditto Protocol</a> messages to external message brokers and receives messages from them. <br />
+Supported transport protocols are AMQP 1.0 (e.g. <a href="https://eclipse.org/hono/">Eclipse Hono</a>),
+AMQP 0.9.1 (e.g. RabbitMQ), MQTT 3.1.1 (e.g. <a href="https://www.eclipse.org/mosquitto/">Eclipse Mosquitto</a>), plain HTTP or Apache Kafka 2.x.</li>
+</ul>
+
+<h2 id="components">Components</h2>
+
+<p>Ditto consists of multiple “microservices” as shown in the above component view.</p>
+
+<p>A “microservice” in Ditto is defined as:</p>
+
+<ul>
+ <li>has its own data store which only this microservice may access and write to</li>
+ <li>has an API in form of <a href="basic-signals.html">signals</a> (commands, command responses, events)</li>
+ <li>can be accessed by other services only via the defined <a href="basic-signals.html">signals</a></li>
+</ul>
+
+<h2 id="communication">Communication</h2>
+
+<p>All microservices can communicate asynchronously in a Ditto cluster. Communication is done via
+<a href="https://doc.akka.io/docs/akka/current/general/remoting.html">Akka remoting</a> which means that each service acts as server,
+providing a TCP endpoint, as well as client sending data to other services.</p>
+
+<p>Therefore, it is required that all Ditto microservices can reach each others port <code class="highlighter-rouge">2551</code>.</p>
+
+<p>Another consequence is that all messages which are sent between Ditto microservices are in a way serializable and deserializable.
+All Ditto <a href="basic-signals.html">signals</a> can be serialized from Java objects to JSON representation and deserialized back
+from JSON to Java objects.</p>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_architecture.html" class="btn btn-default navbar-btn cursorNorm" role="button">architecture</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/architecture-services-concierge.html b/2.0/architecture-services-concierge.html
new file mode 100644
index 0000000..21961f6
--- /dev/null
+++ b/2.0/architecture-services-concierge.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="architecture, architecture, service, concierge">
+<title> Concierge service • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Concierge service">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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 class="active"><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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Concierge service</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>The “concierge” service is responsible for <strong>orchestrating</strong> the backing persistence services and for performing
+<strong>authorization</strong> of <a href="basic-signals-command.html">commands</a> and <a href="basic-signals-commandresponse.html">command responses</a>.</p>
+
+<p>It acts as a gatekeeper and entry point for other services providing APIs:</p>
+<ul>
+ <li><a href="architecture-services-gateway.html">gateway</a></li>
+ <li><a href="architecture-services-connectivity.html">connectivity</a></li>
+</ul>
+
+<p>Those services do not need to be aware of authorization and routing of messages in the cluster.</p>
+
+<h2 id="model">Model</h2>
+
+<p>The concierge service has no model by its own, but uses the model of all the services it orchestrates.</p>
+
+<h2 id="signals">Signals</h2>
+
+<p>The concierge service has no signals by its own, but uses the signals of all the services it orchestrates.</p>
+
+<h2 id="persistence">Persistence</h2>
+
+<p>The concierge service uses <a href="https://doc.akka.io/docs/akka/current/persistence.html?language=java">Akka persistence</a> and
+with that <a href="basic-signals.html#architectural-style">Event sourcing</a> in order to persist changes to
+and restore persisted batch commands.</p>
+
+<h2 id="tasks">Tasks</h2>
+
+<ul>
+ <li>accept any <a href="basic-signals-command.html">commands</a>, <a href="basic-signals-commandresponse.html">command responses</a>
+and <a href="basic-signals-event.html">events</a> of all orchestrated services</li>
+ <li>apply <a href="basic-auth.html">authorization</a> to those, reply with authorization failures if the caller had no permission
+to execute a command</li>
+ <li>delegate authorized commands/responses/events to the orchestrated services where they are processed</li>
+</ul>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_architecture.html" class="btn btn-default navbar-btn cursorNorm" role="button">architecture</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/architecture-services-connectivity.html b/2.0/architecture-services-connectivity.html
new file mode 100644
index 0000000..7b3d5fb
--- /dev/null
+++ b/2.0/architecture-services-connectivity.html
@@ -0,0 +1,1835 @@
+<!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="architectureconnectivity, architecture, service, connectivity, amqp, hono">
+<title> Connectivity service • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Connectivity service">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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 class="active"><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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Connectivity service</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>The “connectivity” service enables Ditto to establish and manage client-side connections to external service endpoints.
+You can communicate with your connected things/twins over those connections via <a href="protocol-overview.html">Ditto Protocol</a> messages. The
+connectivity service supports various transport protocols, which are bound to the <a href="protocol-overview.html">Ditto Protocol</a> via specific
+<a href="protocol-bindings.html">Protocol Bindings</a>.</p>
+
+<p>If you don’t have the option to transform your payload to a <a href="protocol-specification-things-messages.html">Ditto Protocol Message</a> on the client-side, the
+connectivity service offers a flexible and customizable <a href="protocol-specification-things-messages.html">payload mapping</a> on top.</p>
+
+<h2 id="model">Model</h2>
+
+<p>The model of the connectivity service is defined around the entity <code class="highlighter-rouge">Connection</code>:</p>
+
+<ul>
+ <li><a href="https://github.com/eclipse/ditto/tree/master/model/connectivity/src/main/java/org/eclipse/ditto/model/connectivity">model</a></li>
+</ul>
+
+<h2 id="signals">Signals</h2>
+
+<p>Other services can communicate with the connectivity service via:</p>
+
+<ul>
+ <li><a href="https://github.com/eclipse/ditto/tree/master/signals/commands/connectivity/src/main/java/org/eclipse/ditto/signals/commands/connectivity">commands</a>:
+containing commands and command responses which are processed by this service</li>
+ <li><a href="https://github.com/eclipse/ditto/tree/master/signals/events/connectivity/src/main/java/org/eclipse/ditto/signals/events/connectivity">events</a>:
+containing events which are emitted when entities managed by this service were modified</li>
+</ul>
+
+<h2 id="persistence">Persistence</h2>
+
+<p>The connectivity service uses <a href="https://doc.akka.io/docs/akka/current/persistence.html?language=java">Akka persistence</a> and
+with that <a href="basic-signals.html#architectural-style">Event sourcing</a> in order to persist changes to
+and restore persisted <a href="basic-connections.html">connections</a>.</p>
+
+<h2 id="tasks">Tasks</h2>
+
+<ul>
+ <li>create/remove connections (by persisting them)</li>
+ <li>connect/disconnect to endpoints</li>
+ <li>restore existing connections upon restart/failover</li>
+ <li>translate incoming <a href="protocol-overview.html">Ditto Protocol</a> messages to <a href="basic-signals-command.html">commands</a>
+and translate <a href="basic-signals-commandresponse.html">command responses</a> back to <a href="protocol-overview.html">Ditto Protocol</a> response messages</li>
+ <li>map custom message protocols to the <a href="protocol-overview.html">Ditto Protocol</a></li>
+</ul>
+
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_architecture.html" class="btn btn-default navbar-btn cursorNorm" role="button">architecture</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/architecture-services-gateway.html b/2.0/architecture-services-gateway.html
new file mode 100644
index 0000000..c98c98b
--- /dev/null
+++ b/2.0/architecture-services-gateway.html
@@ -0,0 +1,1814 @@
+<!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="architecture, architecture, service, gateway">
+<title> Gateway service • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Gateway service">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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 class="active"><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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Gateway service</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>The “gateway” service is responsible for providing Ditto’s <a href="httpapi-overview.html">HTTP</a> +
+<a href="httpapi-protocol-bindings-websocket.html">WebSocket</a> API.</p>
+
+<h2 id="model">Model</h2>
+
+<p>The gateway service has no model by its own, but uses the model of all the services it provides the HTTP + WebSocket API for.</p>
+
+<h2 id="signals">Signals</h2>
+
+<p>The gateway service has no signals by its own, but uses the signals of all the services it provides the HTTP + WebSocket API for.</p>
+
+<h2 id="persistence">Persistence</h2>
+
+<p>The gateway service has no persistence by its own.</p>
+
+<h2 id="tasks">Tasks</h2>
+
+<ul>
+ <li>translate HTTP request to <a href="basic-signals-command.html">commands</a> and translates <a href="basic-signals-commandresponse.html">command responses</a>
+back to HTTP responses</li>
+ <li>translate <a href="protocol-overview.html">Ditto Protocol</a> messages incoming via the <a href="httpapi-protocol-bindings-websocket.html">WebSocket</a>
+to <a href="basic-signals-command.html">commands</a> and translates <a href="basic-signals-commandresponse.html">command responses</a> back
+to <a href="protocol-overview.html">Ditto Protocol</a> response messages</li>
+ <li>accepts <a href="protocol-overview.html">Ditto Protocol</a> messages incoming via the <a href="httpapi-protocol-bindings-cloudevents.html">Cloud Events HTTP Binding</a></li>
+ <li>subscribe for <a href="basic-signals-event.html">events</a> in Ditto cluster and emits <a href="basic-changenotifications.html">change notifications</a>
+via connected <a href="httpapi-protocol-bindings-websocket.html">WebSocket</a> clients or via <a href="httpapi-sse.html">SSEs</a></li>
+</ul>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_architecture.html" class="btn btn-default navbar-btn cursorNorm" role="button">architecture</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/architecture-services-policies.html b/2.0/architecture-services-policies.html
new file mode 100644
index 0000000..a54e309
--- /dev/null
+++ b/2.0/architecture-services-policies.html
@@ -0,0 +1,1814 @@
+<!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="architecture, architecture, service, policies">
+<title> Policies service • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 service">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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 class="active"><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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Policies service</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>The “policies” service takes care of persisting <a href="basic-policy.html">Policies</a>.</p>
+
+<h2 id="model">Model</h2>
+
+<p>The model of the policies service is defined around the entity <code class="highlighter-rouge">Policy</code>:</p>
+
+<ul>
+ <li><a href="https://github.com/eclipse/ditto/tree/master/model/policies/src/main/java/org/eclipse/ditto/model/policies">Policy model</a></li>
+</ul>
+
+<h2 id="signals">Signals</h2>
+
+<p>Other services can communicate with the policies service via:</p>
+
+<ul>
+ <li><a href="https://github.com/eclipse/ditto/tree/master/signals/commands/policies/src/main/java/org/eclipse/ditto/signals/commands/policies">commands</a>:
+containing commands and command responses which are processed by this service</li>
+ <li><a href="https://github.com/eclipse/ditto/tree/master/signals/events/policies/src/main/java/org/eclipse/ditto/signals/events/policies">events</a>:
+containing events which are emitted when entities managed by this service were modified</li>
+</ul>
+
+<h2 id="persistence">Persistence</h2>
+
+<p>The policies service uses <a href="https://doc.akka.io/docs/akka/current/persistence.html?language=java">Akka persistence</a> and
+with that <a href="basic-signals.html#architectural-style">Event sourcing</a> in order to persist changes to<br />
+and restore persisted <a href="basic-policy.html">policies</a>.</p>
+
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_architecture.html" class="btn btn-default navbar-btn cursorNorm" role="button">architecture</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/architecture-services-things-search.html b/2.0/architecture-services-things-search.html
new file mode 100644
index 0000000..7baa2bf
--- /dev/null
+++ b/2.0/architecture-services-things-search.html
@@ -0,0 +1,1858 @@
+<!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="architecturesearch, architecture, service, things-search, search">
+<title> Things-Search service • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Things-Search service">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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 class="active"><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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Things-Search service</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>The “things-search” service takes care of:</p>
+
+<ul>
+ <li>updating an optimized search index of <code class="highlighter-rouge">Things</code> based on the <a href="basic-signals-event.html">events</a> emitted by the
+<a href="architecture-services-things.html">things</a> and <a href="architecture-services-policies.html">policies</a> services when entities
+are changed there</li>
+ <li>executing search queries against the search index in order to find out which <code class="highlighter-rouge">Things</code> match a given search</li>
+</ul>
+
+<h2 id="model">Model</h2>
+
+<p>The things-search service has no model (entity) by its own, but uses the model of <a href="architecture-services-things.html">things</a>
+and <a href="architecture-services-policies.html">policies</a> services.</p>
+
+<p>It however contains a model which can transform an <a href="#" data-toggle="tooltip" data-original-title="Resource Query Language">RQL</a>
+search query into a Java domain model which is defined here:</p>
+
+<ul>
+ <li><a href="https://github.com/eclipse/ditto/tree/master/model/rql/src/main/java/org/eclipse/ditto/model/rql/predicates/ast">rql parser ast</a></li>
+</ul>
+
+<h2 id="signals">Signals</h2>
+
+<p>Other services can communicate with the things-search service via:</p>
+
+<ul>
+ <li><a href="https://github.com/eclipse/ditto/tree/master/signals/commands/thingsearch/src/main/java/org/eclipse/ditto/signals/commands/thingsearch">commands</a>:
+containing commands and command responses which are processed by this service</li>
+</ul>
+
+<h2 id="persistence">Persistence</h2>
+
+<p>The Things-Search service maintains its own persistence in which it stores <code class="highlighter-rouge">Things</code> in an optimized way in order to
+provide a full search on arbitrary <code class="highlighter-rouge">Thing</code> data.</p>
+
+<p>Things-Search creates the following MongoDB collections:</p>
+
+<ul>
+ <li><code class="highlighter-rouge">searchThings</code>: The search index.</li>
+ <li><code class="highlighter-rouge">searchThingsSyncThings</code>: A single-document capped collection containing the instant until which <code class="highlighter-rouge">Thing</code> events are
+indexed for sure; expected to be 30 minutes before the current time.</li>
+ <li><code class="highlighter-rouge">searchThingsSyncPolicies</code>: A single-document capped collection containing the instant until which <code class="highlighter-rouge">Policy</code> events
+are indexed for sure; expected to be 30 minutes before the current time.</li>
+</ul>
+
+<h2 id="migration-from-ditto-090-m1">Migration from Ditto 0.9.0-M1</h2>
+
+<p>The index schema has changed since Ditto version 0.9.0-M1. Data migration is obligatory to upgrade an existing
+installation running Ditto version 0.9.0-M1 or earlier. Expected duration of data migration is 1/60th of the lifetime
+of the Ditto installation.</p>
+
+<ol>
+ <li><em>After</em> stopping the cluster of Ditto 0.9.0-M1, drop unnecessary collections:
+ <div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nx">db</span><span class="p">.</span><span class="nx">getCollection</span><span class="p">(</span><span class="s1">'thingEntities'</span><span class="p">).</span><span class="nx">drop</span><span class="p">();</span>
+<span class="nx">db</span><span class="p">.</span><span class="nx">getCollection</span><span class="p">(</span><span class="s1">'policyBasedSearchIndex'</span><span class="p">).</span><span class="nx">drop</span><span class="p">();</span>
+<span class="nx">db</span><span class="p">.</span><span class="nx">getCollection</span><span class="p">(</span><span class="s1">'thingsSearchSyncStatePolicies'</span><span class="p">).</span><span class="nx">drop</span><span class="p">();</span>
+</code></pre></div> </div>
+ </li>
+ <li><em>Before</em> starting the upgraded Ditto cluster, write into <code class="highlighter-rouge">searchThingsSyncThings</code> the timestamp when the Ditto cluster started for the first time:
+ <div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">var</span> <span class="nx">startingTimestamp</span> <span class="o">=</span> <span class="k">new</span> <span class="nb">Date</span><span class="p">(</span><span class="nx">TIMESTAMP</span><span class="o">-</span><span class="nx">WHEN</span><span class="o">-</span><span class="nx">DITTO</span><span class="o">-</span><span class="nx">CLUSTER</span><span class="o">-</span><span class="nx">STARTED</span><span class="o">-</span><span class="nx">FOR</span><span class="o">-</span><span class="nx">THE</span><span class="o">-</span><span class="nx">FIRST</span><span class="o">-</span><span class="nx">TIME</span><span class="p">);</span> <span class="c1">// e.g. new Date('2019-01-01T00:00:00.000Z')</span>
+<span class="nx">db</span><span class="p">.</span><span class="nx">getCollection</span><span class="p">(</span><span class="s1">'thingsSearchSyncStateThings'</span><span class="p">).</span><span class="nx">renameCollection</span><span class="p">(</span><span class="s1">'searchThingsSyncThings'</span><span class="p">);</span>
+<span class="nx">db</span><span class="p">.</span><span class="nx">getCollection</span><span class="p">(</span><span class="s1">'searchThingsSyncThings'</span><span class="p">).</span><span class="nx">insert</span><span class="p">({</span><span class="s1">'ts'</span><span class="p">:</span><span class="nx">startingTimestamp</span><span class="p">});</span>
+</code></pre></div> </div>
+ </li>
+ <li>Start the upgraded Ditto cluster. All <code class="highlighter-rouge">Thing</code> events persisted after the timestamp in <code class="highlighter-rouge">searchThingsSyncThings</code>
+will be indexed in the background.</li>
+</ol>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_architecture.html" class="btn btn-default navbar-btn cursorNorm" role="button">architecture</a>
+
+
+
+ <a href="tag_search.html" class="btn btn-default navbar-btn cursorNorm" role="button">search</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/architecture-services-things.html b/2.0/architecture-services-things.html
new file mode 100644
index 0000000..82c55a4
--- /dev/null
+++ b/2.0/architecture-services-things.html
@@ -0,0 +1,1814 @@
+<!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="architecture, architecture, service, things">
+<title> Things service • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Things service">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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 class="active"><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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Things service</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>The “things” service takes care of persisting <a href="basic-thing.html">Things</a> and <a href="basic-feature.html">Features</a>.</p>
+
+<h2 id="model">Model</h2>
+
+<p>The model of the things service is defined around the entities <code class="highlighter-rouge">Thing</code> and <code class="highlighter-rouge">Feature</code>:</p>
+
+<ul>
+ <li><a href="https://github.com/eclipse/ditto/tree/master/model/things/src/main/java/org/eclipse/ditto/model/things">Thing model</a></li>
+</ul>
+
+<h2 id="signals">Signals</h2>
+
+<p>Other services can communicate with the things service via:</p>
+
+<ul>
+ <li><a href="https://github.com/eclipse/ditto/tree/master/signals/commands/things/src/main/java/org/eclipse/ditto/signals/commands/things">commands</a>:
+containing commands and command responses which are processed by this service</li>
+ <li><a href="https://github.com/eclipse/ditto/tree/master/signals/events/things/src/main/java/org/eclipse/ditto/signals/events/things">events</a>:
+containing events which are emitted when entities managed by this service were modified</li>
+</ul>
+
+<h2 id="persistence">Persistence</h2>
+
+<p>The things service uses <a href="https://doc.akka.io/docs/akka/current/persistence.html?language=java">Akka persistence</a> and
+with that <a href="basic-signals.html#architectural-style">Event sourcing</a> in order to persist changes to
+and restore persisted <a href="basic-thing.html">things</a>.</p>
+
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_architecture.html" class="btn btn-default navbar-btn cursorNorm" role="button">architecture</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/architecture/DADR-0001-record-architecture-decisions.md b/2.0/architecture/DADR-0001-record-architecture-decisions.md
new file mode 100644
index 0000000..f861c36
--- /dev/null
+++ b/2.0/architecture/DADR-0001-record-architecture-decisions.md
@@ -0,0 +1,24 @@
+# Record architecture decisions
+
+Date: 14.08.2019
+
+## Status
+
+accepted
+
+## Context
+
+We want to record architectural decisions made on the Ditto project to keep track of the motivation behind certain decisions.
+
+## Decision
+
+We will use Architecture Decision Records, as described by Michael Nygard in this
+[article](http://thinkrelevance.com/blog/2011/11/15/documenting-architecture-decisions) and also use the proposed
+ [template](https://github.com/joelparkerhenderson/architecture_decision_record/blob/master/adr_template_by_michael_nygard.md).
+
+## Consequences
+
+From Michael Nygard's article (link above):
+> The motivation behind previous decisions is visible for everyone, present and future. Nobody is left scratching
+> their heads to understand, "What were they thinking?" and the time to change old decisions will be clear from changes
+> in the project's context.
\ No newline at end of file
diff --git a/2.0/architecture/DADR-0002-replace-akka-pubsub-for-event-publishing.md b/2.0/architecture/DADR-0002-replace-akka-pubsub-for-event-publishing.md
new file mode 100644
index 0000000..ca5302c
--- /dev/null
+++ b/2.0/architecture/DADR-0002-replace-akka-pubsub-for-event-publishing.md
@@ -0,0 +1,43 @@
+# Record architecture decisions
+
+Date: 23.08.2019
+
+## Status
+
+accepted
+
+## Context
+
+Up to now Ditto used Akka's distributed publish/subscribe in order to emit e.g. `ThingEvent`s to interested other services:
+
+* gateway
+ * websocket/SSE sessions publishing events
+* connectivity
+ * AMQP 1.0 / AMQP 0.9.1 / MQTT / Kafka sessions publishing events
+* things-search
+ * ThingUpdater updating the search index
+
+That naive approach works, but does not provide *horizontal scalability*:
+
+* each single service instance generally interested in `ThingEvent`s gets all of them, regardless of whether someone is actually interested in them
+* as a result a lot of avoidable JSON deserialization is done
+* when Ditto needs to scale the event publishing horizontally, adding new gateway or connectivity instances will not help scaling the event publishing
+ * still all instances will have to process each `ThingEvent` and discard if not relevant
+
+## Decision
+
+We will implement a custom Ditto pub/sub which
+
+* uses "authorization subjects" as topics when subscribing
+* uses "read subjects" as topics when publishing
+* manages and distributes the active subscriptions via Akka Distributed Data (ddata)
+* emits `ThingEvent`s only to service instances where at least one consumer consumes the event
+
+## Consequences
+
+The event publishing is no longer implemented by a proven and stable Akka feature but lies in our own
+responsibility. This has upsides (we can implement it just the way we need it) as well as downsides
+(we might add bugs which were not).
+
+The consequence for horizontal scalability is that the event publishing should as well - like the rest of Ditto - be
+horizontally scalable.
\ No newline at end of file
diff --git a/2.0/architecture/DADR-0003-do-not-interrupt-threads.md b/2.0/architecture/DADR-0003-do-not-interrupt-threads.md
new file mode 100644
index 0000000..f1f3ded
--- /dev/null
+++ b/2.0/architecture/DADR-0003-do-not-interrupt-threads.md
@@ -0,0 +1,32 @@
+# Do not interrupt threads
+
+Date: 29.08.2019
+
+## Status
+
+accepted
+
+## Context
+
+SonarQube [RSPEC-2142](https://rules.sonarsource.com/java/tag/multi-threading/RSPEC-2142) complains when we catch
+`InterruptedException` and not call `Thread.currentThread().interrupt()` in the catch block.
+
+Simply calling `Thread.currentThread().interrupt()` to silence SonarQube is dangerous. Due to the way JUnit reuses
+threads, a call to `Thread.interrupt()` breaks the build in unpredictable ways, several tests after the actual site of
+interruption.
+
+## Decision
+
+We will ignore [RSPEC-2142](https://rules.sonarsource.com/java/tag/multi-threading/RSPEC-2142).
+
+## Consequences
+
+The best way to deal with `InterruptedException` is not catching it at all.
+Leave it to Akka to handle low-level concurrency errors.
+Use Akka's `CompletionStage` APIs instead of blocking-wait whenever possible.
+Use `CompletableFuture.join()` instead of `CompletableFuture.get()` in tests.
+
+Where blocking-wait cannot be avoided, the actors executing blocking wait should execute in their own dispatcher
+to not starve the actor system of threads. Use
+[PinnedDispatcher](https://doc.akka.io/docs/akka/current/dispatchers.html)
+for example to give each blocking actor its own thread.
diff --git a/2.0/architecture/DADR-0004-signal-enrichment.md b/2.0/architecture/DADR-0004-signal-enrichment.md
new file mode 100644
index 0000000..c3b3895
--- /dev/null
+++ b/2.0/architecture/DADR-0004-signal-enrichment.md
@@ -0,0 +1,66 @@
+# Signal enrichment via "extraFields"
+
+Date: 20.01.2020
+
+## Status
+
+accepted
+
+## Context
+
+Supporting a new feature, the so called [signal enrichment](https://github.com/eclipse/ditto/issues/561), raises a few
+questions towards throughput and scalability impact of that new feature.
+
+In the current architecture, Ditto internally publishes events (as part of the applied "event sourcing" pattern) for
+each change which was done to a `Thing`. This event is the same as the persisted one only containing the actually
+changed fields.
+
+The "signal enrichment" feature shall support defining `extraFields` to be sent out to external event subscribers, e.g.
+being notified about changes via WebSocket, Server Sent Events (SSEs) or connections (AMQP, MQTT, Kafka, ...).
+
+The following alternatives were considered on how to implement that feature:
+
+1. Sending along the complete `Thing` state in each event in the cluster
+ * upside: "tell, don't ask" principle -> would lead to a minimum of required cluster remoting / roundtrips
+ * downside: bigger payload sent around
+ * downside: a lot of deserialization effort for all event consuming services
+ * downside: policy filtering would have to be additionally done somewhere only included data which the `authSubject` is allowed to READ
+ * downside: overall a lot of overhead for probably only few consumers
+2. Enriching the data for sessions/connections which selected `extraFields` for each incoming event
+ * upside: no additional payload for existing events
+ * upside: data is only enriched for sessions/connections really using that feature
+ * upside: policy enforcement/filtering is done by default concierge mechanism for each single request, so is always up-to-date with policy
+ * downside: additional 4 remoting (e.g.: gateway-concierge-things-concierge-gateway) calls for each to be enriched event
+ * delayed event publishing
+ * additional deserialization efforts
+ * potentially asking for the same static values each time
+3. Cache based enriching of the data for sessions/connections which selected `extraFields` for each incoming event
+ * upsides: all upsides of approach 2 except that policy is always up-to-date
+ * upside: mitigating downsides of approach 2 (because of cache the additional roundtrips are reduced or even completely skipped)
+ * downside: cached data as well as policy information might be outdated a configurable amount of time (e.g. 2 minutes)
+
+
+## Decision
+
+We provide 2 different facade implementations providing approach 2 and 3:
+* `org.eclipse.ditto.internal.models.signalenrichment.ByRoundTripSignalEnrichmentFacade`:
+ Round-trip for each to-be-enriched event resulting in a guaranteed up-to-dateness of data and applied policy.
+* `org.eclipse.ditto.internal.models.signalenrichment.CachingSignalEnrichmentFacade`:
+ Using cache for each to-be-enriched event resulting in reduced remoting effort and a time interval where the cache might be out of sync with the current data or policy information.
+ * the implementation uses a cluster-instance wide cache using a cache key consisting of: `thingId, authSubjects, jsonFieldSelector`
+ * the overall size of this cache is configured, by default to `20,000` entries
+ * there is an additional "smart-update" mechanism for cache entries related to enrichment of twin events:
+ in the absence of skipped events, the cache entry can be completely deduced from the twin events triggering
+ enrichment and will stay up-to-date with thing changes (but not with policy changes).
+
+The configured default in Ditto is the `CachingSignalEnrichmentFacade` but may be configured via
+* connectivity service: environment variable `CONNECTIVITY_SIGNAL_ENRICHMENT_PROVIDER`
+* gateway service: environment variable `GATEWAY_SIGNAL_ENRICHMENT_PROVIDER`
+
+## Consequences
+
+When operating Ditto, one has to choose what is more important:
+* guaranteed correctness of the enriched data
+* reasonable clustering costs for enriching data
+
+When using the cache based implementation, the users might experience unexpected enriched "extra fields".
diff --git a/2.0/architecture/DADR-0005-semantic-versioning.md b/2.0/architecture/DADR-0005-semantic-versioning.md
new file mode 100644
index 0000000..0be3b51
--- /dev/null
+++ b/2.0/architecture/DADR-0005-semantic-versioning.md
@@ -0,0 +1,114 @@
+# Semantic versioning
+
+Date: 27.01.2020
+
+* Enhancement of adding `@since` in javadoc: 21.02.2020
+* Adjusted [Modules considered API](#modules-considered-api) with Ditto 2.0 in 05.2021
+
+## Status
+
+accepted
+
+## Context
+
+Eclipse Ditto project exited the incubation phase with release 1.0.0.
+Henceforth, any change to the Ditto API enters a Ditto release according to [semantic versioning](https://semver.org):
+- Incompatible API changes increment major version number (e.g., 1.7.5 -> 2.0.0);
+- Compatible API changes increment minor version number (e.g., 1.2.3 -> 1.3.0);
+- Changes in the implementation without any API change increment patch version number (e.g., 1.0.0 -> 1.0.1).
+
+This document defines what _API compatibility_ means,
+the modules which are considered API and for which semantic versioning holds,
+and the enforcement of semantic versioning.
+
+## Decision
+
+### API compatibility
+
+For Eclipse Ditto, API compatibility means _binary compatibility_ defined by
+the [Java Language Specification, Java SE 8 Edition, chapter 13](https://docs.oracle.com/javase/specs/jls/se8/html/jls-13.html).
+Examples of binary-compatible changes:
+- Adding a top-level interface or class.
+- Making a non-public interface or class public.
+- Adding classes to a class's set of superclasses without introducing circular inheritance.
+- Adding type parameters without changing the signature of existing methods.
+- Renaming type parameters.
+- Deleting private members.
+- Adding enums.
+- Adding abstract methods to interfaces.
+- Adding members to a class that do not collide with any other member in all its subclasses in Ditto.
+- Adding default methods to an interface that do not collide with any other method in all subclasses of the interface
+ in Ditto.
+
+Binary compatibility guarantees that any user code of Ditto does not break on minor version upgrades, provided that
+- the user code does not implement Ditto interfaces, and
+- the user code does not extend Ditto classes.
+
+Inheritance from Ditto classes and interfaces is excluded from API compatibility because Ditto interfaces are often
+defined to hide implementation details from user code. Compatibility for user-defined subclasses, or source
+compatibility, is not a part of Ditto's semantic versioning. Inheriting user classes may break after a minor Ditto
+version upgrade.
+
+### Modules considered API
+
+Public classes, interfaces and their public members of the following modules, and their submodules are considered
+Ditto API. Changes to them must enter Ditto release in accord with semantic versioning.
+Modules not on this list are not considered API; they may contain incompatible changes for any Ditto version change.
+
+```
+ditto-json
+ditto-base-model
+ditto-messages-model
+ditto-jwt-model
+ditto-rql-model
+ditto-rql-query
+ditto-rql-parser
+ditto-policies-model
+ditto-things-model
+ditto-thingsearch-model
+ditto-concierge-model
+ditto-connectivity-model
+ditto-protocol
+ditto-utils
+```
+
+### Javadoc documentation using `@since`
+
+When adding new public visible API (e.g. new interfaces, classes or methods in existing code) in the defined API modules,
+a `@since <version>` javadoc annotation shall be added.
+
+Example:
+```java
+/**
+ * Returns the extra information which enriches the actual value of this change.
+ *
+ * @return the extra data or an empty Optional.
+ * @since 1.1.0
+ */
+Optional<JsonObject> getExtra();
+```
+
+Existing public API without `@since` can be interpreted as `@since 1.0.0` and can be added when adjusting a class.
+
+### Enforcement of semantic versioning
+
+Semantic versioning is enforced through binary compatibility check by `japicmp-maven-plugin`.
+```xml
+<plugin>
+ <groupId>com.github.siom79.japicmp</groupId>
+ <artifactId>japicmp-maven-plugin</artifactId>
+</plugin>
+```
+Deviations of the behavior of `japicmp-maven-plugin` from binary compatibility defined by the Java language
+specification are to be corrected through overrides. If `japicmp-maven-plugin` breaks the build for a branch,
+then a major version increment for the next release is required to merge the branch into Ditto master.
+Check with the whole Ditto team before adding anything to the exclusion list of `japicmp-maven-plugin`.
+
+## Consequences
+
+User code of modules considered API does not break on minor Ditto version upgrade if it does not inherit from Ditto
+classes or interfaces.
+
+User code of modules considered API does not break on patch Ditto version upgrade.
+
+User code of other modules may break on any Ditto version change.
diff --git a/2.0/architecture/DADR-0006-merge-payload.md b/2.0/architecture/DADR-0006-merge-payload.md
new file mode 100644
index 0000000..dafe899
--- /dev/null
+++ b/2.0/architecture/DADR-0006-merge-payload.md
@@ -0,0 +1,26 @@
+# Merge updates on things
+
+Date: 18.01.2021
+
+## Status
+
+accepted
+
+## Context
+
+We want to allow partial or merge updates of things with a single request.
+
+## Decision
+
+A merge request
+
+* uses HTTP `PATCH` method.
+* has payload in _JSON merge patch_ format defined in [RFC-7396](https://tools.ietf.org/html/rfc7396).
+* has the request header `content-type` set to `application/merge-patch+json`.
+
+## Consequences
+
+The merge requests in JSON merge patch format have a structure similar (except `null` values) to the original data
+structure (Thing JSON) which makes them easy and intuitive to use. The JSON merge patch approach was chosen over the
+[JSON Patch](https://tools.ietf.org/html/rfc6902) format, which allows a more fine-grained control over the change
+operations but is also more complex/verbose and less user-friendly.
diff --git a/2.0/basic-acknowledgements.html b/2.0/basic-acknowledgements.html
new file mode 100644
index 0000000..2584ec7
--- /dev/null
+++ b/2.0/basic-acknowledgements.html
@@ -0,0 +1,2451 @@
+<!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, delivery, guarantee">
+<title> Acknowledgements / Quality of Service • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 / Quality of Service">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Acknowledgements / Quality of Service</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>Acknowledgements are a concept in Ditto used to indicate that a
+<a href="#supported-signal-types">supported signal</a> was successfully received or processed by either an
+internal Ditto functionality or an external subscriber of that signal.</p>
+
+<p>Acknowledgements can be seen as (potentially multiple) responses to a single signal like for example a twin command.
+This means that Ditto collects all the <a href="#requesting-acks">requested acknowledgements</a> until the signal is
+successfully processed within a specified timeout interval.</p>
+
+<h2 id="usage-scenario-examples">Usage scenario examples</h2>
+<p>Acknowledgements are useful for accomplishing the following example tasks:</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 it successfully processed an
+<a href="basic-signals-event.html">event</a> which e.g. resulted by a persistence change of Ditto.</li>
+ <li>Provide a QoS (quality of service) guarantee of “at least once” when processing
+messages in an end-to-end manner by e.g. technically acknowledging/settling a processed signal 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="supported-signal-types">Supported signal types</h2>
+<p>For the following signal types it is possible to define that certain acknowledgements are <em>requested</em>.</p>
+<ul>
+ <li><a href="basic-signals-command.html">Commands</a> <em>modifying the state of a twin</em> (Twin commands),</li>
+ <li>Live commands,</li>
+ <li>Live messages.</li>
+</ul>
+
+<h2 id="acknowledgement-labels">Acknowledgement labels</h2>
+<p>A common (matching) label links acknowledgement requests and their corresponding acknowledgements.
+Ditto already uses some labels for its built-in acknowledgement requests.
+Those labels may 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 acknowledgement requests that are automatically fulfilled on certain actions within the Ditto
+cluster:</p>
+<ul>
+ <li><strong>twin-persisted</strong>: For acknowledgement requests of twin modifying commands.
+It is fulfilled when a modifying command has successfully updated the digital twin in Ditto’s persistence.
+It is ignored for commands in the live channel.</li>
+ <li><strong>live-response</strong>: For acknowledgement requests of live commands and live messages.
+It is fulfilled when a subscriber of the live command or message sends a corresponding response.
+It is ignored for commands in the twin channel.</li>
+ <li><strong>search-persisted</strong>: For acknowledgement requests of twin modifying commands.
+It is fulfilled when a modifying command has successfully updated the search index of the digital twin.
+It is ignored for commands in the live channel.</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 supported signal can contain custom acknowledgement requests.
+A subscriber of such a signal can detect a requested acknowledgement via the <code class="highlighter-rouge">"requested-acks"</code> header.
+If the subscriber is in charge of handling a requested acknowledgement it
+<a href="#issuing-acknowledgements">issues an acknowledgement</a>.</p>
+
+<h2 id="acknowledgements-acks">Acknowledgements (ACKs)</h2>
+<p>A single acknowledgement contains the following information:</p>
+<ul>
+ <li>Acknowledgement label (one of the requested labels of the <a href="#requesting-acks">ack requests</a>)</li>
+ <li>Header fields
+ <ul>
+ <li>mandatory: <strong>correlation-id</strong> the same correlation ID as the one of the signal 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">acknowledgement examples</a> section.</p>
+
+<h2 id="requesting-acks">Requesting ACKs</h2>
+<p>With every supported signal there is the option to request acknowledgements.<br />
+Acknowledgement requests are expressed as protocol specific header fields of signals.
+The following sections explain the various ways of requesting acknowledgements.</p>
+
+<p><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>
+
+<h3 id="requesting-acks-via-http">Requesting ACKs 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: <code class="highlighter-rouge">requested-acks: twin-persisted,some-connection-id:my-custom-ack</code>.</li>
+ <li><strong>timeout</strong>: an optional time interval (in ms, s or m) to define how long the HTTP request should wait for
+ acknowledgements and block.
+ Default and maximum value: <code class="highlighter-rouge">60s</code>.<br />
+ Examples: <code class="highlighter-rouge">timeout: 42s</code>, <code class="highlighter-rouge">timeout: 250ms</code>, <code class="highlighter-rouge">timeout: 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 to an HTTP
+request without acknowledgement requests.</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="requesting-acks-via-websocket">Requesting ACKs via WebSocket</h3>
+<p>Together with a received Ditto <a href="basic-signals-command.html">command</a> in <a href="protocol-specification.html">Ditto Protocol</a>,
+<code class="highlighter-rouge">"requested-acks"</code> (as JsonArray of strings) and <code class="highlighter-rouge">"timeout"</code> headers in the
+<a href="protocol-specification.html#headers">Ditto Protocol headers</a> can be included in order to request acknowledgements via
+WebSocket.</p>
+
+<p>The response will be an (aggregating) <a href="protocol-specification-acks.html#acknowledgements-aggregating">acknowledgements</a>
+message.</p>
+
+<h3 id="requesting-acks-via-connections">Requesting ACKs via connections</h3>
+<p>Acknowledgements for Ditto managed <a href="basic-connections.html#sources">connection sources</a> can be requested in 2 ways:</p>
+<ul>
+ <li>specifically for each consumed supported signal as part of
+the <a href="protocol-specification.html#headers">Ditto Protocol headers</a> <code class="highlighter-rouge">"requested-acks"</code> (as JsonArray of strings)</li>
+ <li>by configuring the managed connection source to
+<a href="basic-connections.html#source-acknowledgement-requests">request acknowledgements for all consumed supported signals</a>.</li>
+</ul>
+
+<h4 id="requesting-acks-via-ditto-protocol-message">Requesting ACKs via Ditto Protocol message</h4>
+<p>Together with a received Ditto <a href="basic-signals-command.html">command</a> in <a href="protocol-specification.html">Ditto Protocol</a>,
+<code class="highlighter-rouge">"requested-acks"</code> (as JsonArray of strings) and <code class="highlighter-rouge">"timeout"</code> headers in the
+<a href="protocol-specification.html#headers">Ditto Protocol headers</a> can be included in order to request acknowledgements
+via established connections consuming messages from <a href="basic-connections.html#sources">sources</a>.</p>
+
+<p>The response will be an (aggregating) <a href="protocol-specification-acks.html#acknowledgements-aggregating">acknowledgements</a>
+message.</p>
+
+<h4 id="requesting-acks-via-connection-source-configuration">Requesting ACKs via connection source configuration</h4>
+<p><a href="basic-connections.html#sources">Connection sources</a> can be
+<a href="basic-connections.html#source-acknowledgement-requests">configured to add specific acknowledgement requests</a> for each
+consumed message of the underlying physical connection (e.g. to a message broker).</p>
+
+<p>This can be used in order to ensure that e.g. all messages consumed from a single source should be processed in an
+“at least once” mode (QoS 1).
+E.g. if configured that the <a href="#built-in-acknowledgement-labels">built-in</a> <code class="highlighter-rouge">twin-persisted</code> acknowledgement is requested,
+a received twin-modifying command will only be technically acknowledged to the connection channel if Ditto successfully
+applied and persisted the command.</p>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> These requested acknowledgements will be appended after payload mapping is applied.<br />
+ This means, that in case you decided to split your message into multiple messages, all of these messages will request the same acknowledgements.<br />
+ If this is not what you want to achieve, have a look at <a href="#requesting-acks-via-ditto-protocol-message-in-payload-mapping">how to add acknowledgement requests during payload mapping</a>.</div>
+
+<h4 id="requesting-acks-via-ditto-protocol-message-in-payload-mapping">Requesting ACKs via Ditto Protocol message in payload mapping</h4>
+<p>During inbound payload mapping, you can create one or more Ditto Protocol messages.</p>
+
+<p>If you configured your connection source to add requested acknowledgements to your commands, this will cause all
+produced messages to request the same acknowledgements.<br />
+If you however want to add requested acknowledgements only to some of those created messages, you need to set the
+<code class="highlighter-rouge">"requested-acks"</code> header (as described in
+<a href="#requesting-acks-via-ditto-protocol-message">Requesting ACKs via Ditto Protocol message</a> section) during payload
+mapping for those commands you like to request an acknowledgement.</p>
+
+<h2 id="issuing-acknowledgements">Issuing acknowledgements</h2>
+<p>Acknowledgements are issued by subscribers of events generated by twin-modifying commands, or by subscribers of
+live commands and live messages. In order to issue a single acknowledgement, a
+<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 contained
+in the received twin event, live command or live message.</p>
+
+<p>The labels of issued acknowledgements are globally unique for each subscriber. Before a subscriber is allowed to
+send acknowledgements, it must declare the labels of acknowledgements it sends. Any declared label taken by another
+subscriber causes an appropriate error for each channel that may issue acknowledgements.</p>
+
+<h3 id="issuing-acks-via-http">Issuing ACKs via HTTP</h3>
+<p>It is not possible to issue acknowledgements via HTTP, because it is impossible to subscribe for twin events,
+live commands or live messages via HTTP.</p>
+
+<h3 id="issuing-acks-via-websocket">Issuing ACKs via WebSocket</h3>
+<p>Create and send the <a href="protocol-specification-acks.html#acknowledgement">Ditto Protocol acknowledgement</a> message over an
+established WebSocket in response to a twin event, live command or live message that contains a <code class="highlighter-rouge">"requested-acks"</code>
+header.</p>
+
+<p>Only acknowledgements with declared labels are accepted. To declare acknowledgement labels, set them as the value
+of the query parameter <code class="highlighter-rouge">declared-acks</code> as comma-separated list:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>GET /ws/2?declared-acks=some-connection-id:ack-label-1,my:ack-label-2
+</code></pre></div></div>
+
+<p>The websocket will be closed right after it has been opened if any other another subscriber already declared the same label.<br />
+This means that it is not possible to establish a second websocket connection with the same declared acknowledgements
+before closing the first one.</p>
+
+<div class="alert alert-danger" role="alert"><i class="fa fa-exclamation-circle"></i> <b>Warning:</b> Therefore, it is not recommended relying on the websocket API for high
+ availability scenarios.</div>
+
+<h3 id="issuing-acks-via-connections">Issuing ACKs via connections</h3>
+<p>Requested acknowledgements for Ditto managed <a href="basic-connections.html#targets">connection targets</a> can be issued in 2
+ways:</p>
+
+<ul>
+ <li>specifically for each published twin event, live command or live message by sending a
+<a href="protocol-specification-acks.html#acknowledgement">Ditto Protocol acknowledgement</a> back,
+via a source of the same connection;</li>
+ <li>by configuring the managed connection target to automatically
+<a href="basic-connections.html#target-issued-acknowledgement-label">issue acknowledgements</a> for all published twin events,
+live commands and live messages that request them.</li>
+</ul>
+
+<p>Acknowledgements sent via a source must
+<a href="basic-connections.html#source-declared-acknowledgement-labels">have their labels declared</a>
+in the field <code class="highlighter-rouge">declaredAcks</code> as a JSON array.<br />
+The labels of target-issued acknowledgements are declared automatically.<br />
+Acknowledgement labels of a connection must be prefixed by the connection ID or the <code class="highlighter-rouge">{{connection:id}}</code>
+placeholder followed by a colon, for example <code class="highlighter-rouge">{{connection:id}}:my-custom-ack</code>.</p>
+
+<p>If some source-declared or target-issued acknowledgement labels are taken by a websocket subscriber,
+all acknowledgements sent by the connection are rejected with error until the websocket is closed.</p>
+
+<h4 id="issuing-acks-via-ditto-protocol-acknowledgement-message">Issuing ACKs via Ditto Protocol acknowledgement message</h4>
+<p>Create and send the <a href="protocol-specification-acks.html#acknowledgement">Ditto Protocol acknowledgement</a> message over a<br />
+source of the connection, in response to an event, live command or live message which contained an <code class="highlighter-rouge">"requested-acks"</code>
+header.</p>
+
+<h4 id="issuing-acks-via-connection-target-configuration">Issuing ACKs via connection target configuration</h4>
+<p><a href="basic-connections.html#targets">Connection targets</a> can be configured to
+<a href="basic-connections.html#target-issued-acknowledgement-label">issue certain acknowledgements automatically</a>
+for each twin event, live command or live message published to the underlying physical connection (e.g. to a message
+broker).</p>
+
+<p>This can be used in order to automatically issue technical acknowledgements once an event, live command or live message
+was published to an HTTP endpoint or into a message broker. When this target guarantees having processed the event
+via its protocol (for HTTP for example when a status code <code class="highlighter-rouge">2xx</code> is returned), a successful acknowledgement is created
+and returned to the requester.</p>
+
+<h2 id="quality-of-service">Quality of Service</h2>
+
+<h3 id="qos-0---at-most-once">QoS 0 - at most once</h3>
+<p>By default, Ditto processes all messages/commands processed in an “at most once” (or QoS 0) semantic.
+For many of the use cases in the IoT, QoS 0 is sufficient, e.g. when processing telemetry data of a sensor:
+if one sensor value is not applied to the digital twin there will soon follow the next sensor reading, and the twin will
+be eventually up to date again.</p>
+
+<h3 id="qos-1---at-least-once">QoS 1 - at least once</h3>
+<p>However, there are IoT use cases where it is of upmost importance that a signal is processed “at least once” (or QoS 1),
+e.g. in order to guarantee that it was persisted in the digital twin or that an <a href="basic-signals-event.html">event</a>
+consumer connected to Ditto did successfully receive a <a href="basic-changenotifications.html">notification</a> which resulted
+from a <a href="basic-signals-command.html">command</a> which Ditto received and processed.</p>
+
+<p>The “acknowledgements” concept documented on this page provides means by which supported signals Ditto consumes and
+processes are treated with an “at least once” (or QoS 1) semantic.</p>
+
+<p><a href="protocol-specification-things-create-or-modify.html">Create/modify commands</a> will technically be acknowledged on the
+sent channel (e.g. HTTP or WebSocket or any <a href="basic-connections.html#connection-types">connection type</a>) when it was a
+success.<br />
+If it could not be applied successfully, the signal will be negatively acknowledged.
+The <a href="protocol-specification-acks.html#combined-status-code">status code of the acknowledgement</a> reflects the failure.</p>
+
+<p>Based on the used channel, the acknowledgement will be translated to the capabilities of the command or live message
+channel, e.g. for HTTP an HTTP response will be sent with the outcome as HTTP status (<code class="highlighter-rouge">2xx</code> for a successful
+acknowledgement, and <code class="highlighter-rouge">4xx</code> for a non-successful one) together with additional details as HTTP response.</p>
+
+<h3 id="assure-qos-until-persisted-in-ditto---twin-persisted">Assure QoS until persisted in Ditto - twin-persisted</h3>
+<p>In order to ensure that a <a href="protocol-specification-things-create-or-modify.html">create/modify command</a> resulted in a
+successful update of twin in Ditto’s managed database, <a href="#requesting-acks">request the acknowledgement</a> for
+the <a href="#built-in-acknowledgement-labels">built-in “twin-persisted”</a> acknowledgement label.</p>
+
+<h3 id="assure-qos-until-processing-of-a-live-commandmessage-by-a-subscriber---live-response">Assure QoS until processing of a live command/message by a subscriber - live-response</h3>
+<p>In order to ensure that a live command or live message is processed by a subscriber, set <code class="highlighter-rouge">response-required</code> to true.
+This way the <a href="#built-in-acknowledgement-labels">built-in “live-response” acknowledgement label</a> is <a href="#requesting-acks">automatically requested</a> for the live command/message.
+This acknowledgement request is fulfilled when the subscriber sends a live response or message response.</p>
+
+<h3 id="assure-qos-until-processing-of-a-twin-event-or-live-commandmessage-by-subscribers---custom-label">Assure QoS until processing of a twin event or live command/message by subscribers - custom label</h3>
+<p>In order to ensure that a <a href="protocol-specification-things-create-or-modify.html">create/modify command</a> resulted in an
+event which was consumed by an application integrating with Ditto, or that a live command or live message is consumed
+without any live or message response, <a href="#requesting-acks">request the acknowledgement</a> for a
+<a href="#custom-acknowledgement-labels">custom acknowledgement label</a>.</p>
+
+<h2 id="weak-acknowledgements-wacks">Weak Acknowledgements (WACKs)</h2>
+
+<p>Since there are scenarios where the subscriber of events or live messages has defined an RQL filter or is not allowed to receive an event by a policy, it is not always possible that an acknowledgement can be provided.
+To avoid that a command fails because of a missing acknowledgement for those reasons, we introduced weak acknowledgements.</p>
+
+<p>These weak acknowledgements are issued automatically by ditto, in case a message or an event is filtered by a subscriber which declared to provide one or more of the requested acknowledgements for the command.
+A weak acknowledgement can be identified by checking the header with value <code class="highlighter-rouge">ditto-weak-ack</code>.
+Weak acknowledgements have this header set to <code class="highlighter-rouge">true</code>.</p>
+
+<p>These weak acknowledgements do not cause redelivery of messages consumed by a Connection.</p>
+
+<h2 id="interaction-between-headers">Interaction between headers</h2>
+<p>Three headers control how Ditto responds to a command: <code class="highlighter-rouge">response-required</code>, <code class="highlighter-rouge">requested-acks</code>, <code class="highlighter-rouge">timeout</code>.</p>
+<ul>
+ <li><code class="highlighter-rouge">response-required</code>: <code class="highlighter-rouge">true</code> or <code class="highlighter-rouge">false</code>.<br />
+ It governs whether the user gets a (detailed) reply.<br />
+ In case of a live message or a live command it also has impact on the <code class="highlighter-rouge">requested-acks</code>:
+ <ul>
+ <li>If <code class="highlighter-rouge">response-required</code> is <code class="highlighter-rouge">true</code>, the acknowledgement label <code class="highlighter-rouge">live-response</code> will be added to <code class="highlighter-rouge">requested-acks</code> if not
+present and <code class="highlighter-rouge">requested-acks</code> was not explicitly set to an empty JSON array.<br /></li>
+ <li>If it is <code class="highlighter-rouge">false</code>, the acknowledgement label <code class="highlighter-rouge">live-response</code> will be removed from <code class="highlighter-rouge">requested-acks</code> if present.</li>
+ </ul>
+ </li>
+ <li><code class="highlighter-rouge">requested-acks</code>: JSON array of acknowledgement requests.<br />
+ It determines the content of the response and transport-layer message settlement.</li>
+ <li><code class="highlighter-rouge">timeout</code>: Duration.<br />
+ It governs how long Ditto waits for responses and acknowledgements.</li>
+</ul>
+
+<p>It is considered a client error if <code class="highlighter-rouge">timeout</code> is set to <code class="highlighter-rouge">0s</code> while <code class="highlighter-rouge">response-required</code> is <code class="highlighter-rouge">true</code> or <code class="highlighter-rouge">requested-acks</code> is
+nonempty.</p>
+
+<h3 id="default-header-values">Default header values</h3>
+<p>Ditto set each of the three headers <code class="highlighter-rouge">response-required</code>, <code class="highlighter-rouge">requested-acks</code>, <code class="highlighter-rouge">timeout</code> to a default value according to any
+values of the other two headers set by the user.
+The default values depend only on headers set by the user; they do not depend on each other.
+Setting the default header values this way never produces any combination considered a client error unless the headers
+set by the user already cause a client error.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Header</th>
+ <th>Default value</th>
+ <th>Default value if all three headers are not set</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>response-required</td>
+ <td><code class="highlighter-rouge">false</code> if <code class="highlighter-rouge">timeout</code> is zero or <code class="highlighter-rouge">requested-acks</code> is empty, <code class="highlighter-rouge">true</code> otherwise</td>
+ <td><code class="highlighter-rouge">true</code></td>
+ </tr>
+ <tr>
+ <td>requested-acks</td>
+ <td><code class="highlighter-rouge">empty</code> if <code class="highlighter-rouge">timeout</code> is zero or <code class="highlighter-rouge">response-required</code> is <code class="highlighter-rouge">false</code>, the channel’s default acknowledgement request otherwise</td>
+ <td><code class="highlighter-rouge">["twin-persisted"]</code> for TWIN channel,<br /><code class="highlighter-rouge">["live-response"]</code> for LIVE channel</td>
+ </tr>
+ <tr>
+ <td>timeout</td>
+ <td><code class="highlighter-rouge">60s</code></td>
+ <td><code class="highlighter-rouge">60s</code></td>
+ </tr>
+ </tbody>
+</table>
+
+<p>The following sections show how each Ditto API interprets the three headers.</p>
+
+<h3 id="http">HTTP</h3>
+<p>Since an HTTP response always follows an HTTP request, the header <code class="highlighter-rouge">response-required</code> is interpreted as whether
+the user wants a <em>detailed</em> response.
+If it is set to <code class="highlighter-rouge">false</code>, the HTTP response consists of status line and headers without body, or with a minimal body
+containing other status codes.
+If acknowledgements are requested, the HTTP response is delayed until all requested acknowledgements are received.
+Generally, if a request cannot be answered within the defined timeout, the HTTP response has status code 408.
+A response containing successful acknowledgements (2xx) and at least one failed acknowledgement (4xx) has status code
+424 (failed dependency).
+In this case the status codes of all acknowledgements should be check to determine the one which caused the failure.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>API</th>
+ <th>response-required</th>
+ <th>requested-acks</th>
+ <th>timeout</th>
+ <th>Outcome</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>HTTP</td>
+ <td>false</td>
+ <td>empty</td>
+ <td>zero</td>
+ <td>202 Accepted immediately</td>
+ </tr>
+ <tr>
+ <td>HTTP</td>
+ <td>false</td>
+ <td>empty</td>
+ <td>non-zero</td>
+ <td>202 Accepted immediately</td>
+ </tr>
+ <tr>
+ <td>HTTP</td>
+ <td>false</td>
+ <td>non-empty</td>
+ <td>zero</td>
+ <td>400 Bad Request: timeout may not be zero if acknowledgements are requested</td>
+ </tr>
+ <tr>
+ <td>HTTP</td>
+ <td>false</td>
+ <td>non-empty</td>
+ <td>non-zero</td>
+ <td>202 Accepted after receiving the requested acknowledgements</td>
+ </tr>
+ <tr>
+ <td>HTTP</td>
+ <td>true</td>
+ <td>empty</td>
+ <td>zero</td>
+ <td>400 Bad Request: timeout may not be zero if response is required</td>
+ </tr>
+ <tr>
+ <td>HTTP</td>
+ <td>true</td>
+ <td>empty</td>
+ <td>non-zero</td>
+ <td>Response</td>
+ </tr>
+ <tr>
+ <td>HTTP</td>
+ <td>true</td>
+ <td>non-empty</td>
+ <td>zero</td>
+ <td>400 Bad Request: timeout may not be zero if response is required</td>
+ </tr>
+ <tr>
+ <td>HTTP</td>
+ <td>true</td>
+ <td>non-empty</td>
+ <td>non-zero</td>
+ <td>Aggregated response and acknowledgements</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="websocket">WebSocket</h3>
+<p>In the absence of client errors, a response is sent for a command if and only if <code class="highlighter-rouge">response-required</code> is set to <code class="highlighter-rouge">true</code>.
+Ditto supports no transport-layer message settlement for WebSocket; acknowledgements are only received as text frames.
+Consequently, it is considered a client error to have non-empty <code class="highlighter-rouge">requested-acks</code> while <code class="highlighter-rouge">response-required</code> is set to
+<code class="highlighter-rouge">false</code>.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>API</th>
+ <th>response-required</th>
+ <th>requested-acks</th>
+ <th>timeout</th>
+ <th>Outcome</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>WebSocket</td>
+ <td>false</td>
+ <td>empty</td>
+ <td>zero</td>
+ <td>No response</td>
+ </tr>
+ <tr>
+ <td>WebSocket</td>
+ <td>false</td>
+ <td>empty</td>
+ <td>non-zero</td>
+ <td>No response</td>
+ </tr>
+ <tr>
+ <td>WebSocket</td>
+ <td>false</td>
+ <td>non-empty</td>
+ <td>zero</td>
+ <td>Error: timeout may not be zero if acknowledgements are requested</td>
+ </tr>
+ <tr>
+ <td>WebSocket</td>
+ <td>false</td>
+ <td>non-empty</td>
+ <td>non-zero</td>
+ <td>Error: WebSocket cannot send acknowledgements without a response</td>
+ </tr>
+ <tr>
+ <td>WebSocket</td>
+ <td>true</td>
+ <td>empty</td>
+ <td>zero</td>
+ <td>Error: timeout may not be zero if response is required</td>
+ </tr>
+ <tr>
+ <td>WebSocket</td>
+ <td>true</td>
+ <td>empty</td>
+ <td>non-zero</td>
+ <td>Response</td>
+ </tr>
+ <tr>
+ <td>WebSocket</td>
+ <td>true</td>
+ <td>non-empty</td>
+ <td>zero</td>
+ <td>Error: timeout may not be zero if response is required</td>
+ </tr>
+ <tr>
+ <td>WebSocket</td>
+ <td>true</td>
+ <td>non-empty</td>
+ <td>non-zero</td>
+ <td>Aggregated response and acknowledgements</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="connectivity">Connectivity</h3>
+<p>For any incoming supported signal through a connection source, the header <code class="highlighter-rouge">response-required</code> determines whether a
+response message is published at the reply-target of the source.
+The header <code class="highlighter-rouge">requested-acks</code> determines the transport-layer message settlement and the content of any response message
+published at the reply-target.
+Examples of transport-layer message settlement mechanisms are AMQP 0.9.1 consumer acknowledgement mode, AMQP 1.0
+disposition frames, and MQTT PUBACK/PUBREC/PUBREL messages for incoming PUBLISH with QoS 1 or 2.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>API</th>
+ <th>response-required</th>
+ <th>requested-acks</th>
+ <th>timeout</th>
+ <th>Outcome</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>Connectivity</td>
+ <td>false</td>
+ <td>empty</td>
+ <td>zero</td>
+ <td>Nothing published at reply-target;<br />message settled immediately</td>
+ </tr>
+ <tr>
+ <td>Connectivity</td>
+ <td>false</td>
+ <td>empty</td>
+ <td>non-zero</td>
+ <td>Nothing published at reply-target;<br />message settled immediately</td>
+ </tr>
+ <tr>
+ <td>Connectivity</td>
+ <td>false</td>
+ <td>non-empty</td>
+ <td>zero</td>
+ <td>Error published at reply-target: timeout may not be zero if acknowledgements are requested;<br />message settled negatively</td>
+ </tr>
+ <tr>
+ <td>Connectivity</td>
+ <td>false</td>
+ <td>non-empty</td>
+ <td>non-zero</td>
+ <td>Nothing published at reply-target;<br />message settled after receiving the requested acknowledgements</td>
+ </tr>
+ <tr>
+ <td>Connectivity</td>
+ <td>true</td>
+ <td>empty</td>
+ <td>zero</td>
+ <td>Error published at reply-target: timeout may not be zero when response is required;<br />message settled negatively</td>
+ </tr>
+ <tr>
+ <td>Connectivity</td>
+ <td>true</td>
+ <td>empty</td>
+ <td>non-zero</td>
+ <td>Response published at reply-target;<br />message settled immediately</td>
+ </tr>
+ <tr>
+ <td>Connectivity</td>
+ <td>true</td>
+ <td>non-empty</td>
+ <td>zero</td>
+ <td>Error published at reply-target: timeout may not be zero if response is required;<br />message settled negatively</td>
+ </tr>
+ <tr>
+ <td>Connectivity</td>
+ <td>true</td>
+ <td>non-empty</td>
+ <td>non-zero</td>
+ <td>Aggregated response and acknowledgements published at reply-target;<br />message settled after receiving the requested acknowledgements</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="default-header-values-1">Default header values</h3>
+<p>Ditto set each of the three headers <code class="highlighter-rouge">response-required</code>, <code class="highlighter-rouge">requested-acks</code>, <code class="highlighter-rouge">timeout</code> to a default value according to any
+values of the other two headers set by the user.
+The default values depend only on headers set by the user; they do not depend on each other.
+Setting the default header values this way never produces any combination considered a client error unless the headers
+set by the user already cause a client error.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Header</th>
+ <th>Default value</th>
+ <th>Default value if all three headers are not set</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>response-required</td>
+ <td><code class="highlighter-rouge">false</code> if <code class="highlighter-rouge">timeout</code> is zero, <code class="highlighter-rouge">true</code> otherwise</td>
+ <td><code class="highlighter-rouge">true</code></td>
+ </tr>
+ <tr>
+ <td>requested-acks</td>
+ <td><code class="highlighter-rouge">empty</code> if <code class="highlighter-rouge">timeout</code> is zero or <code class="highlighter-rouge">response-required</code> is <code class="highlighter-rouge">false</code>, the channel’s default acknowledgement request otherwise</td>
+ <td><code class="highlighter-rouge">["twin-persisted"]</code> for TWIN channel,<br /><code class="highlighter-rouge">["live-response"]</code> for LIVE channel</td>
+ </tr>
+ <tr>
+ <td>timeout</td>
+ <td><code class="highlighter-rouge">60s</code></td>
+ <td><code class="highlighter-rouge">60s</code></td>
+ </tr>
+ </tbody>
+</table>
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/basic-apis.html b/2.0/basic-apis.html
new file mode 100644
index 0000000..06d2e39
--- /dev/null
+++ b/2.0/basic-apis.html
@@ -0,0 +1,1905 @@
+<!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, API, HTTP, HTTPS, JWT, REST, websocket, WSS">
+<title> APIs • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="APIs">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li class="active"><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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">APIs</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 provides two ways to interact with:</p>
+
+<ul>
+ <li>A <a href="httpapi-overview.html">REST-like HTTP API</a> with a sophisticated resource layout that allows to create, read,
+update and delete Things and the Thing’s data.</li>
+ <li>A JSON-based <a href="httpapi-protocol-bindings-websocket.html">WebSocket API</a> implementing the
+<a href="protocol-overview.html">Ditto Protocol</a>.</li>
+</ul>
+
+<h2 id="http-api-or-websocket">HTTP API or WebSocket?</h2>
+
+<p>The two ways are <strong>almost equally powerful</strong> and allow the same operations to work with the Thing’s data, send
+messages to Things and receive messages from Things.</p>
+
+<ul>
+ <li>The lightweight REST-like HTTP API can be used
+ <ul>
+ <li>on less powerful devices lacking a Java runtime or supporting other (scripting) languages like JavaScript, Python, C/C++,</li>
+ <li>and for developing Web-based user interfaces.</li>
+ </ul>
+ </li>
+ <li>The WebSocket API proves useful for
+ <ul>
+ <li>gathering data streams from devices or massive data from another message broker,</li>
+ <li>real-time device monitoring,</li>
+ <li>event-driven Web applications,</li>
+ <li>full duplex communication scenarios, etc.</li>
+ </ul>
+ </li>
+</ul>
+
+<h2 id="comparison-by-feature">Comparison by feature</h2>
+
+<table>
+ <thead>
+ <tr>
+ <th>Feature</th>
+ <th>Ditto Protocol over WebSocket</th>
+ <th>REST-like HTTP API</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>Things management</td>
+ <td>✓</td>
+ <td>✓</td>
+ </tr>
+ <tr>
+ <td>Features management</td>
+ <td>✓</td>
+ <td>✓</td>
+ </tr>
+ <tr>
+ <td>Search Things</td>
+ <td>✓</td>
+ <td>✓</td>
+ </tr>
+ <tr>
+ <td>Count Things</td>
+ <td>no</td>
+ <td>✓</td>
+ </tr>
+ <tr>
+ <td>Messages</td>
+ <td>✓</td>
+ <td>✓</td>
+ </tr>
+ <tr>
+ <td>Change notifications</td>
+ <td>✓</td>
+ <td>✓ (SSEs)</td>
+ </tr>
+ <tr>
+ <td>Access control via Policy</td>
+ <td>✓</td>
+ <td>✓ (v2 only)</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="further-aspects-in-which-the-interfaces-differ">Further aspects in which the interfaces differ</h2>
+
+<table>
+ <thead>
+ <tr>
+ <th>Criteria</th>
+ <th>Ditto Protocol over WebSocket</th>
+ <th>REST-like HTTP API</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>Programming language</td>
+ <td>Almost any web-oriented programming language, e.g. Java, JavaScript, .NET</td>
+ <td>Almost any programming language, e.g. Java, JavaScript, NodeJS, .NET, Python, C/C++</td>
+ </tr>
+ <tr>
+ <td>Connection paradigm</td>
+ <td>Connection-oriented with an always open and persistent connection with only one-time handshake overhead for lowest latency and highest throughput</td>
+ <td>Connectionless protocol with lower permanent resource allocation on sporadic transactions</td>
+ </tr>
+ <tr>
+ <td>Channel security</td>
+ <td>WSS: WebSocket over Transport Layer Security</td>
+ <td>HTTPS: HTTP over Transport Layer Security</td>
+ </tr>
+ <tr>
+ <td>Message exchange pattern</td>
+ <td>Non-blocking request - asynchronous response</td>
+ <td>Blocking request - response</td>
+ </tr>
+ <tr>
+ <td>Authentication mechanism</td>
+ <td>User authentication using: HTTP BASIC Authentication, JSON Web Token (JWT) issued OpenID connect provider</td>
+ <td>User authentication using: HTTP BASIC Authentication, JSON Web Token (JWT) issued OpenID connect provider</td>
+ </tr>
+ </tbody>
+</table>
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/basic-auth.html b/2.0/basic-auth.html
new file mode 100644
index 0000000..12ba94f
--- /dev/null
+++ b/2.0/basic-auth.html
@@ -0,0 +1,1867 @@
+<!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, auth, authentication, authorization, policies, policy, sso, single sign on">
+<title> Authentication and authorization • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Authentication and authorization">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li class="active"><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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Authentication and authorization</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>You can integrate your solutions with Ditto</p>
+
+<ul>
+ <li>via the <a href="http-api-doc.html">HTTP API</a> or</li>
+ <li>via WebSocket.</li>
+</ul>
+
+<p>On all APIs Ditto protects functionality and data by using</p>
+
+<ul>
+ <li><strong>Authentication</strong> to make sure the requester is the one he/she claims to be,</li>
+ <li><strong>Authorization</strong> to make sure the requester is allowed to see, use or change the information he wants to access.</li>
+</ul>
+
+<h2 id="authentication">Authentication</h2>
+
+<p>User authentication at the HTTP API</p>
+
+<p>A user who calls the HTTP API can be authenticated using two mechanisms:</p>
+
+<ul>
+ <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 as <a href="installation-operating.html#openid-connect">documented in the installation/operation guide</a>.</li>
+</ul>
+
+<h3 id="authenticated-subjects">Authenticated subjects</h3>
+
+<p>Every request to one of Ditto’s API is done in scope of already authenticated subjects. <br />
+This authentication may be provided via nginx (like mentioned <a href="#authentication">above</a>), a
+<a href="#" data-toggle="tooltip" data-original-title="JSON Web Token (JWT)">JWT</a> or in a connection via the
+configured <code class="highlighter-rouge">authorizationContext</code> in scope of the connection’s <a href="basic-connections.html#authorization">authorization</a>.</p>
+
+<p>For each of the possibilities of authenticating subjects, the <a href="basic-signals-command.html">command</a> or
+<a href="basic-messages.html">message</a> processed by Ditto will contain one or more of the “authenticated subjects” which e.g.
+might be user IDs.</p>
+
+<h3 id="single-sign-on-sso">Single sign-on (SSO)</h3>
+
+<p>By configuring an arbitrary OpenID Connect provider (as mentioned above) it is possible for Ditto to participate in SSO
+for the following browser based requests:</p>
+<ul>
+ <li><a href="httpapi-overview.html">HTTP API</a> invocations
+ <ul>
+ <li>sending along a JWT token as <code class="highlighter-rouge">Authorization</code> header with <code class="highlighter-rouge">Bearer</code> value</li>
+ </ul>
+ </li>
+ <li>Establishing a <a href="httpapi-protocol-bindings-websocket.html">WebSocket</a> connection for bidirectional communication with
+Ditto via <a href="protocol-overview.html">Ditto Protocol</a> JSON messages
+ <ul>
+ <li>sending along a JWT token as <code class="highlighter-rouge">Authorization</code> header with <code class="highlighter-rouge">Bearer</code> value (recommended)</li>
+ <li>sending along a JWT token as query parameter <code class="highlighter-rouge">access_token</code> (use only if the websocket client does not
+ support setting http headers e.g. plain WebSocket API of browsers)</li>
+ </ul>
+ </li>
+ <li>Opening a <a href="httpapi-sse.html">Server sent event</a> connection in order to receive change notifications of twins in the
+browser
+ <ul>
+ <li>passing the <code class="highlighter-rouge">withCredentials: true</code> option when creating the SSE in the browser</li>
+ </ul>
+ </li>
+</ul>
+
+<h2 id="authorization">Authorization</h2>
+
+<p>Authorization is implemented with a <a href="#" data-toggle="tooltip" data-original-title="A Policy enables developers to configure fine-grained access control in an easy way. A specific policy defines who (subject) is granted or revoked permissions (rights) on a specific resource. The resource can be defined as rough or as fine-grained as necessary for the respective use case. ">Policy</a>
+(in API version 2).</p>
+
+<p>Please find details at <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">
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/basic-changenotifications.html b/2.0/basic-changenotifications.html
new file mode 100644
index 0000000..fceeb99
--- /dev/null
+++ b/2.0/basic-changenotifications.html
@@ -0,0 +1,1854 @@
+<!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="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">
+<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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Change notifications">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 class="active"><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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Change notifications</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><a href="basic-signals.html">Signals</a> already described what an <a href="basic-signals-event.html">Event</a> in Ditto is.
+Events are emitted after an entity (either a <strong>digital twin</strong> or an actual device) was changed.</p>
+
+<p>At the Ditto API there are different ways for getting notified of such events:</p>
+<ul>
+ <li>Via the <a href="httpapi-protocol-bindings-websocket.html">WebSocket API</a> a WebSocket client gets all Events the authenticated subject
+(e.g. a user) is <a href="basic-auth.html">authorized</a> to receive as <a href="protocol-overview.html">Ditto Protocol</a> messages.</li>
+ <li>Via <a href="httpapi-sse.html">HTTP SSEs</a> a consumer of the SSE <code class="highlighter-rouge">EventSource</code> gets all Events the authenticated subject
+(e.g. a user) is <a href="basic-auth.html">authorized</a> to receive directly in the format of the changed entity
+(e.g. as <a href="basic-thing.html#model-specification">Thing JSON</a> format).</li>
+ <li>Via an established <a href="basic-connections.html">connection</a> in the <a href="connectivity-overview.html">connectivity</a> service</li>
+</ul>
+
+<h2 id="filtering">Filtering</h2>
+
+<p>In order to not get all of the events an authenticated <a href="basic-auth.html">subject</a> (e.g. a user added in nginx) is allowed
+to see, but to filter for specific criteria, events may be filtered on the Ditto backend side.</p>
+
+<p>The above mentioned different APIs provide their own mechanisms on how to define such filters, but they all share the
+common functionality of based on which information events may be filtered.</p>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> All filters are specified in an URL query format, therefore their values should be URL
+encoded before sending them to the backend. The equal (=) and the ampersand (&) character must be encoded in any RQL
+filter!</div>
+
+<h3 id="by-namespaces">By namespaces</h3>
+
+<p>Filtering may be done based on a namespace name. Each Ditto <a href="basic-thing.html">Thing</a> has an ID containing a namespace
+(see also the conventions for a <a href="basic-thing.html#thing-id">Thing ID</a>).</p>
+
+<p>By providing the <code class="highlighter-rouge">namespaces</code> filter, a comma separated list of which namespaces to include in the result, only Things
+in namespaces of interest are considered and thus only events of these Things are emitted at the API.</p>
+
+<p>For example, one would only subscribe for events occurring in 2 specific namespaces by defining:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>namespaces=org.eclipse.ditto.one,org.eclipse.ditto.two
+</code></pre></div></div>
+
+<h3 id="by-rql-expression">By RQL expression</h3>
+
+<p>If filtering by namespaces it not sufficient, Ditto also allows to provide an <a href="basic-rql.html">RQL expression</a> specifying
+a Thing payload based condition determining which events should be emitted and which don’t.</p>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> This filter is applied on the modified data of a Thing, data which was not changed will
+ not be considered when applying the filter.</div>
+
+<p>This provides the opportunity to formulate filters like the following:</p>
+
+<h4 id="examples">Examples</h4>
+
+<p>Only emit events when attribute “count” was changed to a value greater than 42:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>filter=gt(attributes/count,42)
+</code></pre></div></div>
+
+<p>Only emit events for Things starting with myThing when a feature “lamp” was modified:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>filter=and(like(thingId,"org.eclipse.ditto:myThing*"),exists(features/lamp))
+</code></pre></div></div>
+
+<p>Only emit events when the attribute “manufacturer” was changed to starting with “ACME & Sons”.
+The <code class="highlighter-rouge">&</code> must be escaped in that case:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>filter=like(attributes/manufacturer,"ACME %26 Sons*")
+</code></pre></div></div>
+
+<p>You get the idea of how mighty this becomes by utilizing Ditto’s <a href="basic-rql.html">RQL expressions</a>.</p>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_model.html" class="btn btn-default navbar-btn cursorNorm" role="button">model</a>
+
+
+
+ <a href="tag_rql.html" class="btn btn-default navbar-btn cursorNorm" role="button">rql</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/basic-connections.html b/2.0/basic-connections.html
new file mode 100644
index 0000000..95119a2
--- /dev/null
+++ b/2.0/basic-connections.html
@@ -0,0 +1,2398 @@
+<!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="connectivity, connection, connectivity, mapping, connection, integration, placeholder, qos, at least once, delivery, guarantee">
+<title> Connections • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Connections">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li class="active"><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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Connections</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="connection-model">Connection model</h2>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> To get started with connections right away, consult the
+ <a href="connectivity-manage-connections.html">Manage connections</a> page. </div>
+
+<p>You can integrate your Ditto instance with external messaging services such as
+<a href="https://eclipse.org/hono/">Eclipse Hono</a>, a <a href="https://www.rabbitmq.com/">RabbitMQ</a> broker or an
+<a href="https://kafka.apache.org/">Apache Kafka</a> broker via custom “connections”.</p>
+
+<p>Additionally, you may invoke foreign HTTP endpoints by using the
+<a href="connectivity-protocol-bindings-http.html">HTTP connection type</a>.</p>
+
+<p>A connection represents a communication channel for the exchange of messages between any service and Ditto.
+It requires a transport protocol, which is used to transmit <a href="protocol-overview.html">Ditto Protocol</a> messages.
+Ditto supports one-way and two-way communication over connections. This enables consumer/producer scenarios
+as well as fully-fledged command and response use cases. Nevertheless, those options might be limited by
+the transport protocol or the other endpoint’s capabilities.</p>
+
+<p>All connections are configured and supervised via Ditto’s
+<a href="architecture-services-connectivity.html">Connectivity service</a>. The following model defines the connection itself:</p>
+
+<script src="docson/widget.js" data-schema="../jsonschema/connection.json"></script>
+
+<h3 id="connection-types">Connection types</h3>
+
+<p>The top design priority of this model is to be as generic as possible, while still allowing protocol specific
+customizations and tweaks. This enables the implementations of different customizable connection types, and support
+for custom payload formats. Currently, the following connection types are supported:</p>
+
+<ul>
+ <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>
+
+<p>The <code class="highlighter-rouge">sources</code> and <code class="highlighter-rouge">targets</code> address formats depends on the <code class="highlighter-rouge">connectionType</code> and has therefore <code class="highlighter-rouge">connectionType</code>
+specific limitations. Those are documented with the corresponding protocol bindings.</p>
+
+<h3 id="sources">Sources</h3>
+
+<p>Sources are used to connect to message brokers / external systems in order to consume messages <strong>from them</strong>.</p>
+
+<p>Source messages can be of the following type:</p>
+<ul>
+ <li><a href="basic-signals-command.html">commands</a></li>
+ <li><a href="basic-messages.html">messages</a></li>
+ <li><a href="protocol-twinlive.html">live commands/responses/events</a></li>
+ <li><a href="protocol-specification-acks.html">acknowledgements</a></li>
+</ul>
+
+<p>Sources contain:</p>
+<ul>
+ <li>several addresses (depending on the <a href="#connection-types">connection type</a> those are interpreted differently,
+e.g. as queues, topics, etc.),</li>
+ <li>a consumer count defining how many consumers should be attached to each source address,</li>
+ <li>an authorization context (see <a href="#authorization">authorization</a>) specifying which
+<a href="basic-policy.html#subjects">authorization subject</a> is used to authorize messages from the source,</li>
+ <li>enforcement information that allows filtering the messages that are consumed in this source,</li>
+ <li><a href="basic-acknowledgements.html#requesting-acks">acknowledgement requests</a> this source requires in order
+to ensure QoS 1 (“at least once”) processing of consumed messages before technically acknowledging them to the channel,</li>
+ <li>declared labels of <a href="protocol-specification-acks.html">acknowledgements</a> the source is allowed to send,</li>
+ <li><a href="connectivity-header-mapping.html">header mapping</a> for mapping headers of source messages to internal headers, and</li>
+ <li>a reply-target to configure publication of any responses of incoming commands.</li>
+</ul>
+
+<h4 id="source-enforcement">Source enforcement</h4>
+
+<p>Messages received from external systems are mapped to Ditto internal format, either by applying some custom mapping or
+the default mapping for <a href="protocol-overview.html">Ditto Protocol</a> messages.</p>
+
+<p>During this mapping the digital twin of the device is determined i.e.
+which thing is accessed or modified as a result of the message. By default, no sanity check is done if this target
+thing corresponds to the device that originally sent the message. In some use cases this might be valid, but
+in other scenarios you might want to enforce that a device only sends data to its digital twin.
+Note that this could also be achieved by assigning a specific policy to each device and use <a href="#placeholders">placeholders</a>
+in the authorization subject, but this can get cumbersome to maintain for a large number of devices.</p>
+
+<p>With an enforcement, you can use a single policy for all devices
+and still make sure that a device only modifies its associated digital twin. Enforcement is only feasible if the message
+contains the verified identity of the sending device (e.g. in a message header). This verification has to be done by the
+external system e.g. by properly authenticating the devices and providing the identity in the messages sent to Ditto.</p>
+
+<p>The enforcement configuration consists of two fields:</p>
+<ul>
+ <li><code class="highlighter-rouge">input</code>: Defines where device identity is extracted.</li>
+ <li><code class="highlighter-rouge">filters</code>: Defines the filters that are matched against the input. At least one filter must match the input value,
+otherwise the message is rejected.</li>
+</ul>
+
+<p>The following placeholders are available for the <code class="highlighter-rouge">input</code> field:</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Placeholder</th>
+ <th>Description</th>
+ <th>Example</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><code class="highlighter-rouge">{{ header:<name> }}</code></td>
+ <td>Any header from the message received via the source (case-insensitive).</td>
+ <td><code class="highlighter-rouge">{{header:device_id }}</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">{{ source:address }}</code></td>
+ <td>The address on which the message was received.</td>
+ <td>devices/sensors/temperature1</td>
+ </tr>
+ </tbody>
+</table>
+
+<p>The following placeholders are available for the <code class="highlighter-rouge">filters</code> field:</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Placeholder</th>
+ <th>Description</th>
+ <th>Example</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><code class="highlighter-rouge">{{ thing:id }}</code></td>
+ <td>Full ID composed of ‘‘namespace’’ + ‘’:’’ as a separator + ‘‘name’’</td>
+ <td>eclipse.ditto:thing-42</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">{{ thing:namespace }}</code></td>
+ <td>Namespace (i.e. first part of an ID)</td>
+ <td>eclipse.ditto</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">{{ thing:name }}</code></td>
+ <td>Name (i.e. second part of an ID )</td>
+ <td>thing-42</td>
+ </tr>
+ </tbody>
+</table>
+
+<p>Assuming a device <code class="highlighter-rouge">sensor:temperature1</code> pushes its telemetry data to Ditto which is stored in a thing named
+<code class="highlighter-rouge">sensor:temperature1</code>. The device identity is provided in a header field <code class="highlighter-rouge">device_id</code>. To enforce that the device can
+only send data to the Thing <code class="highlighter-rouge">sensor:temperature1</code> the following enforcement configuration can be used:</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">"addresses"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"telemetry/hono_tenant"</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">"enforcement"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"input"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ header:device_id }}"</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="s2">"{{ thing:id }}"</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>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-acknowledgement-requests">Source acknowledgement requests</h4>
+
+<p>A source can configure, that for each incoming message additional
+<a href="basic-acknowledgements.html#requesting-acks">acknowledgement requests</a> are added.</p>
+
+<p>That is desirable whenever incoming messages should be processed with a higher “quality of service” than the default,
+which is “at most once” (or QoS 0).</p>
+
+<p>In order to process messages from sources with an “at least once” (or QoS 1) semantic, configure the source’s
+<code class="highlighter-rouge">"acknowledgementRequests/includes"</code> to add the
+<a href="basic-acknowledgements.html#built-in-acknowledgement-labels">“twin-persisted”</a> acknowledgement request, which will
+cause that a consumed message over this source will technically be acknowledged, it the twin was
+successfully updated/persisted by Ditto.</p>
+
+<p>How the technical acknowledgment is done is specific for the used <a href="#connection-types">connection type</a> and documented
+in scope of that connection type.</p>
+
+<p>In addition to the <code class="highlighter-rouge">"includes"</code> defining which acknowledgements to request for each incoming message, the optional
+<code class="highlighter-rouge">"filter"</code> holds an <a href="basic-placeholders.html#function-library">fn:filter()</a> function defining when to request
+acknowledgements at all for an incoming message. This filter is applied on both acknowledgements: those
+<a href="basic-acknowledgements.html#requesting-acks-via-ditto-protocol-message">requested in the message</a> and the ones requested
+via the configured <code class="highlighter-rouge">"includes"</code> array.</p>
+
+<p>The JSON for a source with acknowledgement requests could look like this. The <code class="highlighter-rouge">"filter"</code> in the example causes that
+acknowledgements are only requested if the “qos” header was either not present or does not equal <code class="highlighter-rouge">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">"addresses"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"<source>"</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">"headerMapping"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"qos"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ header:qos }}"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"acknowledgementRequests"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"includes"</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="w">
+ </span><span class="s2">"receiver-connection-id:my-custom-ack"</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">"fn:filter(header:qos,'ne',0)"</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>
+
+<h4 id="source-declared-acknowledgement-labels">Source declared acknowledgement labels</h4>
+
+<p>The acknowledgements sent via a source must have their labels declared in the field <code class="highlighter-rouge">declardAcks</code> as a JSON array.<br />
+If the label of an acknowledgement is not in the <code class="highlighter-rouge">declaredAcks</code> array, then the acknowledgement is rejected with
+an error. The declared labels must be prefixed by the connection ID followed by a colon or the
+<code class="highlighter-rouge">{{connection:id}}</code> placeholder followed by a colon. For example:</p>
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><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">"<source>"</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">"declaredAcks"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"{{connection:id}}:my-custom-ack"</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>
+
+<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.
+Mapped headers are added to the headers of the Ditto protocol message obtained by payload mapping.
+The default <a href="connectivity-mapping.html#ditto-mapper">Ditto payload mapper</a> does not retain any external header;
+in this case all Ditto protocol headers come from the header mapping.</p>
+
+<p>The JSON for a source with header mapping 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">"addresses"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"<source>"</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">"headerMapping"</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">"{{ header:message-id }}"</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="w">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h4 id="source-reply-target">Source reply target</h4>
+
+<p>A source may define a reply target to publish the responses of incoming commands.
+For a reply target, the address and header mapping are defined in itself, whereas its payload mapping is inherited
+from the parent source, because a payload mapping definition specifies the transformation for both: incoming and outgoing
+messages.</p>
+
+<p>For example, to publish responses at the target address equal to the <code class="highlighter-rouge">reply-to</code> header of incoming commands,
+define source header mapping and reply target as follows. If an incoming command does not have the <code class="highlighter-rouge">reply-to</code> header,
+then its response is dropped.</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">"headerMapping"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"reply-to"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ header:reply-to }}"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"replyTarget"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"enabled"</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">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ header:reply-to }}"</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>The reply target may contain its own header mapping (<code class="highlighter-rouge">"headerMapping"</code>) in order to map response headers.</p>
+
+<p>In addition, the reply target contains the expected response types (<code class="highlighter-rouge">"expectedResponseTypes"</code>) which should be
+published to the reply target.<br />
+The following reply targets are available to choose from:</p>
+<ul>
+ <li><strong>response</strong>: Send back successful responses (e.g. responses after a Thing was successfully modified,
+but also responses for <a href="basic-signals-command.html#query-commands">query commands</a>).
+Includes positive <a href="protocol-specification-acks.html#acknowledgements-aggregating">acknowledgements</a>.</li>
+ <li><strong>error</strong>: Send back error responses (e.g. thing not modifiable due to lacking permissions)</li>
+ <li><strong>nack</strong>: If negative <a href="protocol-specification-acks.html#acknowledgements-aggregating">acknowledgement</a> responses should be delivered.</li>
+</ul>
+
+<p>This is an example <code class="highlighter-rouge">"replyTarget"</code> containing both header mapping and expected response types:</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">"replyTarget"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"enabled"</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">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ header:reply-to }}"</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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ header:correlation-id }}"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"expectedResponseTypes"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"response"</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">"nack"</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="targets">Targets</h3>
+
+<p>Targets are used to connect to messages brokers / external systems in order to publish messages <strong>to them</strong>.</p>
+
+<p>Target messages can be of the following type:</p>
+<ul>
+ <li><a href="basic-messages.html">Thing messages</a></li>
+ <li><a href="basic-signals-event.html">Thing events</a></li>
+ <li><a href="protocol-twinlive.html">Thing live commands/responses/events</a></li>
+ <li><a href="protocol-specification-policies-announcement.html">Policy announcements</a></li>
+</ul>
+
+<p>Targets contain:</p>
+<ul>
+ <li>one address (that is interpreted differently depending on the <a href="#connection-types">connection type</a>, e.g. as queue, topic, etc.),</li>
+ <li><a href="#target-topics-and-filtering">topics</a> that will be sent to the target,</li>
+ <li>an authorization context (see <a href="#authorization">authorization</a>) specifying which
+<a href="basic-policy.html#subjects">authorization subject</a> is used to authorize messages to the target, and</li>
+ <li><a href="connectivity-header-mapping.html">header mapping</a> to compute external headers from Ditto protocol headers.</li>
+</ul>
+
+<h4 id="target-topics-and-filtering">Target topics and filtering</h4>
+
+<p>Which types of messages should be published to the target address, can be defined via configuration.</p>
+
+<p>In order to only consume specific events like described in <a href="basic-changenotifications.html">change notifications</a>, the
+following parameters can additionally be provided when specifying the <code class="highlighter-rouge">topics</code> of a target:</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Description</th>
+ <th>Topic</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>
+ <tr>
+ <td>Subscribe for <a href="basic-changenotifications.html">Thing events/change notifications</a></td>
+ <td><code class="highlighter-rouge">_/_/things/twin/events</code></td>
+ <td>✔</td>
+ <td>✔</td>
+ </tr>
+ <tr>
+ <td>Subscribe for <a href="basic-messages.html">Thing messages</a></td>
+ <td><code class="highlighter-rouge">_/_/things/live/messages</code></td>
+ <td>✔</td>
+ <td>❌</td>
+ </tr>
+ <tr>
+ <td>Subscribe for <a href="protocol-twinlive.html">Thing live commands</a></td>
+ <td><code class="highlighter-rouge">_/_/things/live/commands</code></td>
+ <td>✔</td>
+ <td>❌</td>
+ </tr>
+ <tr>
+ <td>Subscribe for <a href="protocol-twinlive.html">Thing live events</a></td>
+ <td><code class="highlighter-rouge">_/_/things/live/events</code></td>
+ <td>✔</td>
+ <td>✔</td>
+ </tr>
+ <tr>
+ <td>Subscribe for <a href="protocol-specification-policies-announcement.html">Policy announcements</a></td>
+ <td><code class="highlighter-rouge">_/_/policies/announcements</code></td>
+ <td>✔</td>
+ <td>❌</td>
+ </tr>
+ </tbody>
+</table>
+
+<p>The parameters are specified similar to HTTP query parameters, the first one separated with a <code class="highlighter-rouge">?</code> and all following ones
+with <code class="highlighter-rouge">&</code>. You need to URL-encode the filter values before using them in a configuration.</p>
+
+<p>For example, this way the connection session would register for all events in the namespace <code class="highlighter-rouge">org.eclipse.ditto</code> and which
+would match an attribute “counter” to be greater than 42. Additionally, it would subscribe to messages in the namespace
+<code class="highlighter-rouge">org.eclipse.ditto</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">"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>
+
+<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">Thing 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">Thing 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">Thing 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">Thing live events</a></td>
+ <td><code class="highlighter-rouge">_/_/things/live/events</code></td>
+ <td>✔</td>
+ </tr>
+ <tr>
+ <td>Subscribe for <a href="protocol-specification-policies-announcement.html">Policy announcements</a></td>
+ <td><code class="highlighter-rouge">_/_/policies/announcements</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-issued-acknowledgement-label">Target issued acknowledgement label</h4>
+
+<p>A target can be configured to automatically <a href="basic-acknowledgements.html#issuing-acknowledgements">issue acknowledgements</a>
+for each published/emitted message, once the underlying channel confirmed
+that the message was successfully received.</p>
+
+<p>That is desirable whenever outgoing messages (e.g. <a href="basic-signals-event.html">events</a>) are handled in scope of a command
+sent with an “at least once” (QoS 1) semantic in order to only acknowledge that command, if the event was successfully
+forwarded into another system.</p>
+
+<p>For more details on that topic, please refer to the <a href="basic-acknowledgements.html">acknowledgements</a> section.</p>
+
+<p>Whether an outgoing message is treated as successfully sent or not is specific for the used
+<a href="#connection-types">connection type</a> and documented in scope of that connection type.</p>
+
+<p>The issued acknowledgement label must be prefixed by the connection ID followed by a colon or the
+<code class="highlighter-rouge">{{connection:id}}</code> placeholder followed by a colon.<br />
+The JSON for a target with issued acknowledgement labels could look like this:</p>
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><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">"<target>"</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:inbound-auth-subject"</span><span class="p">],</span><span class="w">
+ </span><span class="s2">"issuedAcknowledgementLabel"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{connection:id}}:my-custom-ack"</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.
+Mapped headers are added to the external headers.
+The default <a href="connectivity-mapping.html#ditto-mapper">Ditto payload mapper</a> does not define any external header;
+in this case, all external headers come from the header mapping.</p>
+
+<p>The JSON for a target with header mapping could 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">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<target>"</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?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:inbound-auth-subject"</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">"message-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ header:correlation-id }}"</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">"subject"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ topic:subject }}"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"reply-to"</span><span class="p">:</span><span class="w"> </span><span class="s2">"all-replies"</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="authorization">Authorization</h3>
+
+<p>A connection is initiated by the connectivity service. This obviates the need for client authorization, because
+Ditto becomes the client in this case. Nevertheless, to access resources within Ditto, the connection must know on
+whose behalf it is acting. This is controlled via the configured <code class="highlighter-rouge">authorizationContext</code>, which holds a list of
+self-assigned authorization subjects. Before a connection can access a Ditto resource, one of its
+<code class="highlighter-rouge">authorizationSubject</code>s must be granted the access rights by the authorization mechanism of a
+<a href="basic-policy.html">Policies</a>.</p>
+
+<p>A connection target can only send data for things to which it has READ rights, as data flows from a thing to a target.
+A connection source can only receive data for things to which it has WRITE rights, as data flows from a source to a thing.</p>
+
+<h3 id="specific-configuration">Specific configuration</h3>
+
+<p>Some <a href="#connection-types">connection types</a> require specific configuration, which is not supported for other connection types.
+Those are put into the <code class="highlighter-rouge">specificConfig</code> field.</p>
+
+<h3 id="payload-mapping">Payload Mapping</h3>
+
+<p>For more information on mapping message payloads see the corresponding <a href="connectivity-mapping.html">Payload Mapping Documentation</a>.</p>
+
+<h2 id="placeholders">Placeholders</h2>
+
+<p>The configuration of a connection allows to use placeholders at certain places. This allows more fine-grained control
+over how messages are consumed or where they are published to. The general syntax of a placeholder is
+<code class="highlighter-rouge">{{ placeholder }}</code>. Have a look at the <a href="basic-placeholders.html">placeholders concept</a> for
+more details on that.</p>
+
+<h3 id="placeholder-for-source-authorization-subjects">Placeholder for source authorization subjects</h3>
+
+<p>Processing the messages received via a source using the <em>same fixed authorization subject</em> may not be
+suitable for every scenario. For example, if you want to declare fine-grained write permissions per device, this would
+not be possible with a fixed global subject. For this use case, we have introduced placeholder substitution for
+authorization subjects of source addresses that are resolved when processing messages from a source.
+Of course, this requires the sender of the
+message to provide necessary information about the original issuer of the message.</p>
+
+<div class="alert alert-warning" role="alert" style=""><i class="fa fa-warning"></i> <b>Important:</b> Only use this kind of placeholder if you trust the source of the message. The value from the header is used as the <strong>authorized subject</strong>.</div>
+
+<p>You can access any header value of the incoming message by using a placeholder like <code class="highlighter-rouge">{{ header:name }}</code>.</p>
+
+<p>Example:</p>
+
+<p>Assuming the messages received from the source <em>telemetry</em> contain a <code class="highlighter-rouge">device_id</code> header (e.g. <em>sensor-123</em>),
+you may configure your source’s authorization subject as follows:</p>
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><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">"auth-subject-placeholder-example"</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">"telemetry"</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">"device:{{ header:device_id }}"</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>The placeholder is then replaced by the value from the message headers and the message is forwarded and processed under
+the subject <em>device:sensor-123</em>.
+In case the header cannot be resolved or the header contains unexpected characters, an exception is thrown, which is sent
+back to the sender as an error message, if a valid <em>reply-to</em> header was provided, otherwise the message is dropped.</p>
+
+<h3 id="placeholder-for-target-addresses">Placeholder for target addresses</h3>
+
+<p>Another use case for placeholders may be to publish twin events or live commands and events to a target address
+containing thing-specific information e.g. you can distribute things from different namespaces to different target addresses.
+You can use the placeholders <code class="highlighter-rouge">{{ thing:id }}</code>, <code class="highlighter-rouge">{{ thing:namespace }}</code>
+and <code class="highlighter-rouge">{{ thing:name }}</code> in the target address for this purpose.
+For a thing with the ID <em>org.eclipse.ditto:device-123</em> these placeholders would be resolved as follows:</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Placeholder</th>
+ <th>Description</th>
+ <th>Resolved value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><code class="highlighter-rouge">thing:id</code></td>
+ <td>Full ID composed of <em>namespace</em> <code class="highlighter-rouge">:</code> (as a separator), and <em>name</em></td>
+ <td><em>org.eclipse.ditto:device-123</em></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">thing:namespace</code></td>
+ <td>Namespace (i.e. first part of an ID)</td>
+ <td><em>org.eclipse.ditto</em></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">thing:name</code></td>
+ <td>Name (i.e. second part of an ID )</td>
+ <td><em>device-123</em></td>
+ </tr>
+ </tbody>
+</table>
+
+<p>Additionally to the placeholders mentioned above, all documented
+<a href="basic-placeholders.html#scope-connections">connection placeholders</a> may be
+used in target addresses. However, if any placeholder in the target address fails to resolve, then the message will be
+dropped.</p>
+
+<p>Example:</p>
+
+<p>Sending live commands and events to a target address that contains the thing’s namespace.</p>
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><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">"target-placeholder-example"</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">"addresses"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"live/{{ thing:namespace }}"</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:auth-subject"</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/live/events"</span><span class="p">,</span><span class="w"> </span><span class="s2">"_/_/things/live/commands"</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="ssh-tunneling">SSH tunneling</h2>
+
+<p>Ditto supports tunneling a connection by establishing an SSH tunnel and using it to connect to the actual endpoint.</p>
+
+<p>See <a href="connectivity-ssh-tunneling.html">SSH tunneling</a> on how to setup and configure SSH tunneling with Ditto.</p>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/basic-enrichment.html b/2.0/basic-enrichment.html
new file mode 100644
index 0000000..c68931e
--- /dev/null
+++ b/2.0/basic-enrichment.html
@@ -0,0 +1,1885 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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>
+
+
+
+
+
+
+
+
+
+ <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 message.</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 the 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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/basic-errors.html b/2.0/basic-errors.html
new file mode 100644
index 0000000..bb883da
--- /dev/null
+++ b/2.0/basic-errors.html
@@ -0,0 +1,1856 @@
+<!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, error, failure, exception, model">
+<title> Errors • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Errors">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li class="active"><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Errors</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>Errors are datatypes containing information about occurred failures which were either
+cause by the user or appeared in the server.</p>
+
+<h2 id="error-model-specification">Error model specification</h2>
+
+<script src="docson/widget.js" data-schema="../jsonschema/error.json"></script>
+
+<h3 id="status">Status</h3>
+
+<p>The “status” uses HTTP status codes semantics (see <a href="https://tools.ietf.org/html/rfc7231#section-6">RFC 7231</a>)
+to indicate whether a specific command has been successfully completed, or not.</p>
+
+<p>These “status” codes can be seen as API/contract which will be always the same for a specific error.<br />
+Use the “status” in order to identify an error, as the additional “error” and “description” might change
+without prior notice.</p>
+
+<h3 id="error">Error</h3>
+
+<p>A Ditto error contains an “error” code which is a string identifier that uniquely identifies the error.</p>
+
+<p>These error codes Ditto provides in addition to the HTTP <strong>status</strong> code are not to be considered as API and must
+therefore not be relied on.<br />
+They might change without prior notice.</p>
+
+<p>Ditto itself uses the following prefixes for its error codes:</p>
+
+<ul>
+ <li><code class="highlighter-rouge">things:</code> - for errors related to <a href="basic-thing.html">things</a></li>
+ <li><code class="highlighter-rouge">policies:</code> - for errors related to <a href="basic-policy.html">policies</a></li>
+ <li><code class="highlighter-rouge">things-search:</code> - for errors related to the <a href="basic-search.html">things search</a></li>
+ <li><code class="highlighter-rouge">acknowledgement:</code> - for errors related to <a href="basic-acknowledgements.html">acknowledgements</a></li>
+ <li><code class="highlighter-rouge">messages:</code> - for errors related to <a href="basic-messages.html">messages</a></li>
+ <li><code class="highlighter-rouge">placeholder:</code> - for errors related to <a href="basic-placeholders.html">placeholders</a></li>
+ <li><code class="highlighter-rouge">jwt:</code> - for errors related to <a href="#" data-toggle="tooltip" data-original-title="JSON Web Token (JWT)">JWT</a> based <a href="basic-auth.html">authentication</a></li>
+ <li><code class="highlighter-rouge">gateway:</code> - for errors produced by the (HTTP/WS) <a href="architecture-services-gateway.html">gateway</a> service</li>
+ <li><code class="highlighter-rouge">connectivity:</code> - for errors produced by the <a href="architecture-services-connectivity.html">connectivity</a> service</li>
+</ul>
+
+<h3 id="message">Message</h3>
+
+<p>The error “message” contains a short message describing the encountered problem in plain english text.</p>
+
+<h3 id="description">Description</h3>
+
+<p>The optional error “description” describes in more detail how the error could be resolved.</p>
+
+<h3 id="href">Href</h3>
+
+<p>The optional href contains a link to Ditto documentation or external resources in order to help to resolve the error.</p>
+
+<h2 id="examples">Examples</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">"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">"things:attribute.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 attribute with key 'unknown-key' on the thing with ID 'org.eclipse.ditto:my-thing' could not be found or the 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 thing and the key of your requested attribute was correct and you have sufficient permissions."</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><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">"messages: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">"Thing ID 'foobar2000' 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></code></pre></div></div>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/basic-feature.html b/2.0/basic-feature.html
new file mode 100644
index 0000000..94df34a
--- /dev/null
+++ b/2.0/basic-feature.html
@@ -0,0 +1,2035 @@
+<!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, definition, properties, desiredProperties, entity, feature, functionblock, informationmodel, model, vorto">
+<title> Feature • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Feature">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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 class="active"><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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Feature</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="feature">Feature</h2>
+
+<p>A Feature is used to manage all data and functionality of a Thing that can be clustered in an outlined technical
+context.</p>
+
+<p>For different contexts or aspects of a Thing different Features can be used which are all belonging to the same Thing
+and do not exist without this Thing.</p>
+
+<h3 id="feature-id">Feature ID</h3>
+<p>Within a Thing each Feature is identified by a unique string - the so called Feature ID.
+A Feature ID often needs to be set in the path of a HTTP request. Due to this fact we strongly recommend to use a
+restricted set of characters (e.g. those for
+<a href="https://www.ietf.org/rfc/rfc3986.txt">Uniform Resource Identifiers (URI)</a>).</p>
+
+<h3 id="feature-properties">Feature properties</h3>
+
+<p>The <strong>data</strong> related to Features is managed in form of a <strong>list of properties</strong>. These properties can be categorized,
+e.g. to manage the status, the configuration or any fault information.
+Feature properties are represented as one JSON object.</p>
+
+<p>Each property itself can be either a simple/scalar value or a complex object; allowed is any JSON value.</p>
+
+<h3 id="feature-desired-properties">Feature desired properties</h3>
+
+<p>Desired properties represent the desired state of the properties. They are a tool to represent the desired target state
+of the properties.
+The <strong>desiredProperties</strong> related to Features are managed in form of a <strong>list of properties</strong>. These desired properties
+can be categorized, e.g. to manage the status, the configuration or any fault information.
+Feature desired properties are represented as one JSON object.</p>
+
+<p>Each desired property itself can be either a simple/scalar value or a complex object; allowed is any JSON value.</p>
+
+<p>Please note however, that besides persisting the desired properties, and indexing the fields for search requests, filtering
+etc. for the time being, Ditto does not implement their further processing. Such functionality will come with future releases.</p>
+
+<h3 id="feature-definition">Feature definition</h3>
+
+<p>Ditto supports specifying a definition for a feature in order to document how a feature’s state is structured
+(in <a href="#feature-properties">properties</a>), and which behavior/capabilities
+(<a href="basic-messages.html">messages related to features</a>) can be expected from such a feature.<br /></p>
+
+<p>A feature’s definition is a list of definition identifiers containing a <em>namespace</em>, <em>name</em> and <em>version</em> separated
+by colons: <code class="highlighter-rouge">namespace:name:version</code>. Thus the <em>definition</em> element can hold even multiple identifiers.</p>
+
+<p>A Definition can be seen as some kind of type for features. The <a href="#feature-properties">properties</a> of a
+feature containing a definition identifier <code class="highlighter-rouge">"org.eclipse.ditto:lamp:1.0.0"</code> can be expected to follow the structure
+described in the <code class="highlighter-rouge">lamp</code> type of namespace <code class="highlighter-rouge">org.eclipse.ditto</code> semantically versioned with version <code class="highlighter-rouge">1.0.0</code>.</p>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Ditto does not contain a type system on its own and does not specify how to describe types.
+ Tooling for editing such structures and type descriptors is provided by <a href="#the-link-to-eclipse-vorto">Eclipse Vorto</a>.</div>
+
+<p>Ditto aims to support contract-based development - by using feature definitions - to ensure validity and
+integrity of <strong>digital twins</strong>.</p>
+
+<div class="alert alert-danger" role="alert"><i class="fa fa-exclamation-circle"></i> <b>Warning:</b> Currently Ditto <strong>does not</strong> ensure that the <code class="highlighter-rouge">properties</code> or
+ <code class="highlighter-rouge">desiredProperties</code> of a feature or its supported
+ messages follow the type defined in the definition.</div>
+
+<h2 id="example">Example</h2>
+
+<p>The following snippet shows a Feature with the ID “arbitrary-feature” and a definition with the sole identifier
+“org.eclipse.ditto:complex-type:1.0.0”:</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">"arbitrary-feature"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:complex-type:1.0.0"</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">"status"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"connected"</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">"complexProperty"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"street"</span><span class="p">:</span><span class="w"> </span><span class="s2">"my street"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"house no"</span><span class="p">:</span><span class="w"> </span><span class="mi">42</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">"desiredProperties"</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="p">{</span><span class="w">
+ </span><span class="s2">"connected"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</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="model-specification">Model specification</h2>
+
+<p>The feature model API version 2:</p>
+
+<h3 id="v2">V2</h3>
+<script src="docson/widget.js" data-schema="../jsonschema/feature_v2.json"></script>
+
+<h2 id="the-link-to-eclipse-vorto">The link to Eclipse Vorto</h2>
+
+<blockquote>
+ <p>Vorto is an open source tool that allows to create and manage technology agnostic, abstract device descriptions,
+so called information models. Information models describe the attributes and the capabilities of real world devices.
+Source: <a href="http://www.eclipse.org/vorto/">http://www.eclipse.org/vorto/</a></p>
+</blockquote>
+
+<p>Ditto’s feature definition may be mapped to the Vorto type system which is defined by so called “information models”
+and “function blocks”:</p>
+<blockquote>
+ <p>Information models represent the capabilities of a particular type of device entirely.
+An information model contains one or more function blocks.</p>
+</blockquote>
+
+<blockquote>
+ <p>A function block provides an abstract view on a device to applications that want to employ the devices’ functionality.
+Thus, it is a consistent, self-contained set of (potentially re-usable) properties and capabilities.</p>
+</blockquote>
+
+<figure><img class="docimage" src="images/pages/basic/ditto-thing-feature-definition-model.png" alt="Feature Definition Model" style="max-width: 250px" /><figcaption>One Thing can have many features. A feature may conform to a definition</figcaption></figure>
+
+<h3 id="mapping-vorto-function-block-elements">Mapping Vorto function block elements</h3>
+
+<p>A Vorto function block consists of different sections defining state and capabilities
+(see also <a href="https://www.eclipse.org/vorto/">Eclipse Vorto’s documentation</a>) of a device
+(in our case of a feature):</p>
+<ul>
+ <li><code class="highlighter-rouge">configuration</code>: Contains one or many configuration properties for the function block.</li>
+ <li><code class="highlighter-rouge">status</code>: Contains one or many status properties for the function block.</li>
+ <li><code class="highlighter-rouge">fault</code>: Contains one or many fault properties for the function block.</li>
+ <li><code class="highlighter-rouge">operations</code>: Contains one or many operations for the function block.</li>
+ <li><code class="highlighter-rouge">events</code>: Contains one or many events for the function block.</li>
+</ul>
+
+<h4 id="function-block-state">Function block state</h4>
+
+<p>The <code class="highlighter-rouge">configuration</code>, <code class="highlighter-rouge">status</code> and <code class="highlighter-rouge">fault</code> sections of a function block define the state of a feature in Ditto.</p>
+
+<p>They are mapped to a corresponding JSON object inside the feature <a href="#feature-properties">properties</a> which gets us
+following JSON structure of a Ditto feature:</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">"feature-id"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"namespace:name:version"</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">"configuration"</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="p">{</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"fault"</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>
+
+<p>The structure below <code class="highlighter-rouge">configuration, status, fault</code> is defined by the custom types of the Vorto function block. As these
+can be simple types as well as complex types, the JSON structure follows the structure of the types.</p>
+
+<h4 id="function-block-capabilities">Function block capabilities</h4>
+
+<p>The <code class="highlighter-rouge">operations</code> and <code class="highlighter-rouge">events</code> sections of a function block define the capabilities or behavior of a Ditto feature.</p>
+
+<p>Both are mapped to feature <a href="basic-messages.html">messages</a> sent “to” or “from” a feature.</p>
+<ul>
+ <li>A message sent <strong>to</strong> a feature is mapped to an <code class="highlighter-rouge">operation</code>.</li>
+ <li>A messages sent <strong>from</strong> a feature is mapped to an <code class="highlighter-rouge">event</code>.</li>
+</ul>
+
+<h3 id="vorto-example">Vorto example</h3>
+
+<div class="alert alert-danger" role="alert"><i class="fa fa-exclamation-circle"></i> <b>Warning:</b> Ditto has not yet included Eclipse Vorto in order to enforce types - the following
+ section can be seen as an <strong>outlook</strong> how Ditto would map Vorto concepts to features.</div>
+
+<p>Here an example for a Vorto Function Block (in Vorto’s custom DSL) with the name <code class="highlighter-rouge">Lamp</code>.
+For the sake of giving an example for events this lamp has some additional capabilities like detecting movement and
+smoke .</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code> namespace com.mycompany.fb
+ version 1.0.0
+ displayname "Lamp"
+ category demo
+ using com.mycompany.fb.Lamp ; 1.0.0
+ using com.mycompany.fb.Color ; 1.2.0
+ functionblock Lamp {
+ configuration {
+ mandatory on as boolean "this defines whether the lamp should be on or off"
+ location as Location "the location of the lamp"
+ }
+
+ status {
+ mandatory on as boolean "the reported on/off state"
+ color as Color "the reported color of the lamp"
+ }
+
+ events {
+ smokeDetected {
+ intensity as float <MIN 0.0, MAX 10.0> "the intensity of the detected smoke"
+ mandatory critical as boolean "whether it is critical or not"
+ }
+
+ movementAlarm {}
+ }
+
+ operations{
+ blink(interval as int, duration as int) returns boolean "lets the Lamp blink in the interval for duration"
+ stopBlinking() returns boolean "stops blinking lets the Lamp"
+ changeColor(newColor as Color) "changes the color of the Lamp"
+ }
+ }
+</code></pre></div></div>
+
+<p>The Vorto function block contains all information required for a feature’s definition identifier in Ditto:</p>
+<ul>
+ <li>namespace: <code class="highlighter-rouge">com.mycompany.fb</code></li>
+ <li>name: <code class="highlighter-rouge">Lamp</code></li>
+ <li>version: <code class="highlighter-rouge">1.0.0</code></li>
+</ul>
+
+<p>A feature containing a definition pointing to such a Vorto function block 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">"lamp"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"com.mycompany.fb:Lamp:1.0.0"</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">"configuration"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"on"</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">"location"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">34.052235</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">-118.243683</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="p">{</span><span class="w">
+ </span><span class="s2">"on"</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">"color"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"red"</span><span class="p">:</span><span class="w"> </span><span class="mi">128</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"green"</span><span class="p">:</span><span class="w"> </span><span class="mi">255</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"blue"</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><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>The capabilities or behavior of this “lamp” feature would be defined as <a href="basic-messages.html">messages</a>:</p>
+<ul>
+ <li>Message with subject <code class="highlighter-rouge">smokeDetected</code> which is sent <code class="highlighter-rouge">FROM</code> a feature containing a JSON payload with an
+ <code class="highlighter-rouge">intensity</code> and whether the detected smoke has reached a <code class="highlighter-rouge">critical</code> mass or not.</li>
+ <li>Message with subject <code class="highlighter-rouge">movementAlarm</code> which is sent <code class="highlighter-rouge">FROM</code> a feature with no payload.</li>
+ <li>Message with subject <code class="highlighter-rouge">blink</code> which is sent <code class="highlighter-rouge">TO</code> a feature containing a JSON payload of an <code class="highlighter-rouge">interval</code>
+ (as JSON number) and a duration (also as JSON number) returning a JSON boolean.</li>
+ <li>Message with subject <code class="highlighter-rouge">stopBlinking</code> which is sent <code class="highlighter-rouge">TO</code> a feature with no payload returning a JSON boolean.</li>
+ <li>Message with subject <code class="highlighter-rouge">changeColor</code> which is sent <code class="highlighter-rouge">TO</code> a feature containing a JSON payload which follows the type
+ <code class="highlighter-rouge">Color</code> defined in another Vorto function block.</li>
+</ul>
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/basic-messages.html b/2.0/basic-messages.html
new file mode 100644
index 0000000..f61d7b4
--- /dev/null
+++ b/2.0/basic-messages.html
@@ -0,0 +1,1913 @@
+<!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, router, content-type, correlation-id, feature, message, payload, thing">
+<title> Messages • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Messages">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-auth.html">Authentication and Authorization</a></li>
+
+
+
+
+
+
+ <li class="active"><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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Messages</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>Messages <em>do not affect</em> the state of a digital twin or an actual device.
+Therefore, Ditto does not handle messages like <a href="basic-signals-command.html">commands</a>: there are no responses which are
+produced by Ditto and no events which are emitted for messages.</p>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Ditto has no knowledge of the payload of messages but merely routes messages between
+ connected devices.</div>
+
+<p>Messages provide the possibility to send something <strong>to</strong> or <strong>from</strong> an actual device using an arbitrary subject/topic.
+They contain a custom payload with a custom content-type, so you can choose what content best
+fits your solution.</p>
+
+<p>Expressed differently, Messages</p>
+<ul>
+ <li><strong>to</strong> devices are operations which should trigger an action on a device (e.g. with a subject <code class="highlighter-rouge">turnOff</code>),</li>
+ <li><strong>from</strong> devices are events/alarms which are emitted by devices (e.g. with a subject <code class="highlighter-rouge">smokeDetected</code>).</li>
+</ul>
+
+<figure><img class="docimage" src="images/pages/basic/ditto-messages.png" alt="Ditto Messages" style="max-width: 600px" /><figcaption>How Ditto acts as router for Messages</figcaption></figure>
+
+<h2 id="characteristics-of-messages">Characteristics of Messages</h2>
+
+<p>Eclipse Ditto is not a message broker and does not want to offer features a message broker does.</p>
+
+<p>It can be seen as a message router which:</p>
+<ul>
+ <li>accepts messages via 2 APIs (<a href="httpapi-messages.html">HTTP</a> and
+<a href="protocol-specification-things-messages.html">Ditto Protocol</a>, e.g. via <a href="httpapi-protocol-bindings-websocket.html">WebSocket binding</a>)</li>
+ <li>checks for <strong>currently connected</strong> interested parties whether they may receive a specific Message
+(performs <a href="basic-auth.html#authorization">authorization checks</a>)</li>
+ <li>
+ <p>routes the Message and reply Messages in between connected clients</p>
+
+ <div class="alert alert-danger" role="alert"><i class="fa fa-exclamation-circle"></i> <b>Warning:</b> Ditto offers no message retention. If a device isn’t connected when a Message should
+ be routed, it will never receive the Message.</div>
+
+ <div class="alert alert-danger" role="alert"><i class="fa fa-exclamation-circle"></i> <b>Warning:</b> Ditto makes no statement about Message QoS. Messages are routed <strong>at most once</strong>.</div>
+
+ <div class="alert alert-danger" role="alert"><i class="fa fa-exclamation-circle"></i> <b>Warning:</b> Ditto does deliver messages only in “fan out” style,
+ if the same credentials are connected twice, both connections will receive Messages if the credential is authorized
+ to read a Message.</div>
+ </li>
+</ul>
+
+<h2 id="elements">Elements</h2>
+
+<p>Ditto messages always have to have at least this elements:</p>
+<ul>
+ <li><strong>Direction</strong>: <em>to</em> / <em>from</em>,</li>
+ <li><strong>Thing ID</strong>: the ID of the <code class="highlighter-rouge">Thing</code> (actual device) which should receive/send the message and</li>
+ <li><strong>Subject</strong>: the custom subject/topic.</li>
+</ul>
+
+<p>Additionally, they can contain more information:</p>
+<ul>
+ <li><strong>Feature ID</strong>: if a message should be addressed to the <a href="basic-feature.html">Feature</a> of a Thing, this specifies
+its ID.</li>
+ <li><strong>content-type</strong>: defines which content-type the optional payload has.</li>
+ <li><strong>correlation-id</strong>: Ditto can route message responses back to the issuer of a message. Therefore, a correlation-id has
+to be present in the message.</li>
+</ul>
+
+<h2 id="payload">Payload</h2>
+
+<p>A message can optionally contain a payload. As Ditto does neither have to understand the message nor its payload, the
+content-type and serialization is arbitrary.</p>
+
+<h2 id="apis">APIs</h2>
+
+<p>Messages can be sent via</p>
+<ul>
+ <li>the <a href="httpapi-protocol-bindings-websocket.html">WebSocket API</a> as <a href="protocol-overview.html">Ditto Protocol</a> messages,</li>
+ <li>the <a href="httpapi-overview.html">HTTP API</a> either as “fire and forget” messages or, when expecting a response, in a
+blocking way at the <a href="http-api-doc.html#/Messages">Messages HTTP API endpoint</a></li>
+</ul>
+
+<p>Messages can, however, be received only via the <a href="httpapi-protocol-bindings-websocket.html">WebSocket API</a> as
+<a href="protocol-overview.html">Ditto Protocol</a> messages.</p>
+
+<h2 id="receiving-messages">Receiving Messages</h2>
+
+<p>To be able to receive Messages for a Thing, you need to have <code class="highlighter-rouge">READ</code> access on that Thing.
+When a Message is sent to or from a Thing, <strong>every</strong> connected WebSocket or
+<a href="basic-connections.html#targets">connection target</a> with the correct access rights will receive the Message.</p>
+
+<p>If there is more than one response to a message received by multiple consumers, only the
+first response will be routed back to the initial issuer of a Message.</p>
+
+<h2 id="sending-messages">Sending Messages</h2>
+
+<p>If you want to send a Message to or from a Thing, you need <code class="highlighter-rouge">WRITE</code> permissions on that Thing.
+Every WebSocket or <a href="basic-connections.html#targets">connection target</a> that is able to receive Messages for the
+Thing (<code class="highlighter-rouge">READ</code> permission), will receive your message.</p>
+
+<h2 id="responding-to-messages">Responding to Messages</h2>
+
+<p>Since messages are stateless there is no <em>direct</em> response to a Message.</p>
+
+<p>For Ditto to be able to route the response of a Message back to the issuer, the
+correlation-ids need to match. E.g. when the sender uses correlation-id <code class="highlighter-rouge">random-aa98s</code>,
+any receiver can reply by using the same correlation-id <code class="highlighter-rouge">random-aa98s</code>.</p>
+
+<h2 id="permissions">Permissions</h2>
+
+<h3 id="api-version-2">API version 2</h3>
+
+<p>Permissions in API version 2 can be defined fine-grained. In order to be able to receive all Messages of a Thing,
+you need <code class="highlighter-rouge">READ</code> permission for the <code class="highlighter-rouge">message:/</code> resource in the used <a href="basic-policy.html#message">Policy</a>.<br />
+There can however be specified that you may only receive specific Messages (with a defined subject), also
+expressed via <a href="basic-policy.html#message">Policy entry</a>.<br />
+The same applies for being able to send Messages, here a <code class="highlighter-rouge">WRITE</code> permission is required either globally for
+all messages via the <code class="highlighter-rouge">message:/</code> resource or only for specific ones.</p>
+
+<p>There is one sole exception, which are <a href="#claim-messages">Claim Messages</a>. You do
+not need the access rights for sending them.</p>
+
+<h2 id="claim-messages">Claim Messages</h2>
+
+<p>A Claim Message is used to gain access to a Thing. For this purpose a Claim Messages has two specifics:</p>
+<ul>
+ <li>the predefined message subject is always <em>claim</em></li>
+ <li>you do not require <code class="highlighter-rouge">WRITE</code> permission to send a Claim Message</li>
+</ul>
+
+<p>Apart from that the Claim Message is handled like a standard Message. It is forwarded to all Ditto Protocol bindings
+that registered for Claim Messages of the specific Thing. The decision whether to grant access (by setting permissions)
+is completely up to the receiver of the Claim Message e.g. after verifying the payload of the Message.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/basic-metadata.html b/2.0/basic-metadata.html
new file mode 100644
index 0000000..28d64a9
--- /dev/null
+++ b/2.0/basic-metadata.html
@@ -0,0 +1,1971 @@
+<!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, metadata, things, model, semantic">
+<title> Thing Metadata • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Thing Metadata">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li class="active"><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Thing Metadata</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>A Thing in Ditto is also able to store Metadata information, e.g. about single
+<a href="basic-feature.html#feature-properties">feature properties</a>, complete features and also <a href="basic-thing.html#attributes">attributes</a>
+or other data stored in a digital twin (<a href="basic-thing.html">thing</a>).</p>
+
+<p>This metadata can contain additionally information which shall not be treated as part of the twin’s value, however may
+be useful to provide some context of the twin’s data.</p>
+
+<p>Metadata has not its own API but can only be updated/set while modifying the state of a twin as a side effect.<br />
+By default, metadata is not returned at API requests, but must be <a href="#reading-metadata-information">asked for explicitly</a>.</p>
+
+<p>An example is the timestamp when the current value of e.g. a feature property was updated for the last time.
+Or the metadata information of a feature property may contain information about its type or its semantics (e.g. a unit
+of measurement).</p>
+
+<h2 id="setting-metadata">Setting Metadata</h2>
+
+<p>Setting arbitrary <code class="highlighter-rouge">Metadata</code> is possible by using the <code class="highlighter-rouge">put-metadata</code> header
+(e.g. for HTTP requests, set it as HTTP header, for Ditto Protocol requests, put it in the <code class="highlighter-rouge">"headers"</code> section of the
+protocol message), see <a href="protocol-specification.html#headers">here for an overview of the available headers</a>.</p>
+
+<p>The value of the <code class="highlighter-rouge">put-metadata</code> is a JSON array containing JSON objects with <code class="highlighter-rouge">"key"</code> and <code class="highlighter-rouge">"value"</code> parts:</p>
+<ul>
+ <li><code class="highlighter-rouge">"key"</code>: describes the hierarchical position in the Thing where the metadata should be placed</li>
+ <li><code class="highlighter-rouge">"value"</code>: is an arbitrary JSON value to set as metadata (could also be a nested JSON object)</li>
+</ul>
+
+<h3 id="example-for-setting-metadata">Example for setting Metadata</h3>
+
+<p>Assume you modify your twin’s lamp color with a call:</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:my-lamp-1"</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">"lamp"</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">"color"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"r"</span><span class="p">:</span><span class="w"> </span><span class="mi">100</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"g"</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">"b"</span><span class="p">:</span><span class="w"> </span><span class="mi">255</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>You want to specify to set metadata which affects all the changed properties (<code class="highlighter-rouge">"r"</code>, <code class="highlighter-rouge">"g"</code> and <code class="highlighter-rouge">"b"</code>) plus some
+extra metadata to only set for the <code class="highlighter-rouge">"r"</code> property.<br />
+The content of the <code class="highlighter-rouge">put-metadata</code> in order to do that 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="p">{</span><span class="w">
+ </span><span class="s2">"key"</span><span class="p">:</span><span class="w"> </span><span class="s2">"*/foo"</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">"bar"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </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">"/features/lamp/properties/color/r"</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">"foo"</span><span class="p">:</span><span class="w"> </span><span class="s2">"bumlux"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"issuedAt"</span><span class="p">:</span><span class="w"> </span><span class="s2">"someTimestamp"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"issuedBy"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"name"</span><span class="p">:</span><span class="s2">"ditto"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"mail"</span><span class="p">:</span><span class="s2">"ditto@mail.com"</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>The resulting Thing JSON including its <code class="highlighter-rouge">_metadata</code> 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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:my-lamp-1"</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">"lamp"</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">"color"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"r"</span><span class="p">:</span><span class="w"> </span><span class="mi">100</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"g"</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">"b"</span><span class="p">:</span><span class="w"> </span><span class="mi">255</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">"_metadata"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"thingId"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"foo"</span><span class="p">:</span><span class="w"> </span><span class="s2">"bar"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"policyId"</span><span class="w"> </span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"foo"</span><span class="p">:</span><span class="w"> </span><span class="s2">"bar"</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">"lamp"</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">"color"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"r"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"foo"</span><span class="p">:</span><span class="w"> </span><span class="s2">"bumlux"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"issuedAt"</span><span class="p">:</span><span class="w"> </span><span class="s2">"someTimestamp"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"issuedBy"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"me"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"mail"</span><span class="p">:</span><span class="w"> </span><span class="s2">"me@mail.com"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"g"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"foo"</span><span class="p">:</span><span class="w"> </span><span class="s2">"bar"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"b"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"foo"</span><span class="p">:</span><span class="w"> </span><span class="s2">"bar"</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>
+
+<h3 id="setting-metadata-to-all-affected-json-leaves">Setting Metadata to all affected JSON leaves</h3>
+
+<p>A special syntax for the key is <code class="highlighter-rouge">*/{key}</code> which means that all affected JSON leaves of the modify operation will
+get the Metadata key <code class="highlighter-rouge">{key}</code> with the given value. So if, for example, only the affected JSON leaves should
+get the timestamp where the changed values were recorded, one would set the <code class="highlighter-rouge">put-metadata</code> header as shown in the
+following 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="p">{</span><span class="w">
+ </span><span class="s2">"key"</span><span class="p">:</span><span class="w"> </span><span class="s2">"*/issuedAt"</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">"someTimestamp"</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="reading-metadata-information">Reading Metadata information</h2>
+
+<p>Metadata of a Thing can be retrieved is by querying a full thing, e.g. via the <a href="http-api-doc.html">HTTP API</a>, and
+specifying an (additional) <a href="httpapi-concepts.html#with-field-selector">field selector</a> <code class="highlighter-rouge">_metadata</code>,
+e.g.: <code class="highlighter-rouge">?fields=thingId,attributes,_metadata</code>.</p>
+
+<h3 id="example-for-reading-metadata">Example for reading Metadata</h3>
+
+<p>For example a <code class="highlighter-rouge">GET</code> request to
+<code class="highlighter-rouge">https://{ditto-instance}/api/2/things/{namespace}:{name}?fields=thingId,policyId,features,_created,_modified,_revision,_metadata</code>
+will yield the Metadata stored for the given Thing, in the following format:</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:my-lamp-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">"..."</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">"lamp"</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">"on"</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">"color"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"r"</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">"g"</span><span class="p">:</span><span class="w"> </span><span class="mi">255</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"b"</span><span class="p">:</span><span class="w"> </span><span class="mi">255</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">"_created"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2020-06-01T10:00:00Z"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"_modified"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2020-06-09T14:30:00Z"</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">42</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="s2">"features"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"lamp"</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">"on"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"issuedAt"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2020-06-09T14:30:00Z"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"color"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"r"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"issuedAt"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2020-06-09T14:15:00Z"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"g"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"issuedAt"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2020-06-09T14:15:00Z"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"b"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"issuedAt"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2020-06-09T14:15:00Z"</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>
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/basic-namespaces-and-names.html b/2.0/basic-namespaces-and-names.html
new file mode 100644
index 0000000..1359f1f
--- /dev/null
+++ b/2.0/basic-namespaces-and-names.html
@@ -0,0 +1,1859 @@
+<!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, namespace, name, id, entity, model, regex">
+<title> Namespaces and Names • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Namespaces and Names">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-feature.html">Feature</a></li>
+
+
+
+
+
+ <li><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li class="active"><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Namespaces and Names</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 uses namespaces and names for the IDs of important entity types like Things or Policies. Due to the fact that
+those IDs often need to be set in the path of HTTP requests, we have restricted the set of allowed characters.</p>
+
+<h2 id="namespace">Namespace</h2>
+
+<p>The namespace must conform to the following notation:</p>
+<ul>
+ <li>must start with a lower- or uppercase character from a-z</li>
+ <li>may use dots (<code class="highlighter-rouge">.</code>) to separate characters</li>
+ <li>a dot must be followed by a lower- or uppercase character from a-z</li>
+ <li>numbers may be used</li>
+ <li>underscore may be used</li>
+</ul>
+
+<p>When writing a Java application, you can use the following regex to validate your namespaces: <br />
+ <code class="highlighter-rouge">(?<ns>|(?:(?:[a-zA-Z]\w*+)(?:\.[a-zA-Z]\w*+)*+))</code>
+ (see <a href="https://github.com/eclipse/ditto/blob/master/model/base/src/main/java/org/eclipse/ditto/model/base/entity/id/RegexPatterns.java">RegexPatterns#NAMESPACE_REGEX</a>).</p>
+
+<p>Examples for valid namespaces:</p>
+<ul>
+ <li><code class="highlighter-rouge">org.eclipse.ditto</code>,</li>
+ <li><code class="highlighter-rouge">com.google</code>,</li>
+ <li><code class="highlighter-rouge">foo.bar_42</code></li>
+</ul>
+
+<h2 id="name">Name</h2>
+
+<p>The name must conform to the following notation:</p>
+<ul>
+ <li>may not be empty</li>
+ <li>may not contain <code class="highlighter-rouge">/</code> (slash)</li>
+ <li>may not contain control characters</li>
+</ul>
+
+<p>When writing a Java application, you can use the following regex to validate your thing name: <br />
+ <code class="highlighter-rouge">(?<name>(?:[[^\\x00-\\x1F\\x7F-\\xFF/]]|%\\p{XDigit}{2})(?:[[^\\x00-\\x1F\\x7F-\\xFF/]$]|%\\p{XDigit}{2})*+)</code>
+ <code class="highlighter-rouge">(!"$%&()=?`*+~'#_-:.;,|<>\{}[]^)</code>
+ (see <a href="https://github.com/eclipse/ditto/blob/master/model/base/src/main/java/org/eclipse/ditto/model/base/entity/id/RegexPatterns.java">RegexPatterns#ENTITY_NAME_REGEX</a>).</p>
+
+<p>Examples for valid names:
+ * <code class="highlighter-rouge">ditto</code>,
+ * <code class="highlighter-rouge">smart-coffee-1</code>,
+ * <code class="highlighter-rouge">foo%2Fbar</code>
+ * <code class="highlighter-rouge">foo bar</code>
+ * <code class="highlighter-rouge">foo+bar%20</code></p>
+
+<h2 id="namespaced-id">Namespaced ID</h2>
+
+<p>A namespaced ID must conform to the following expectations:</p>
+<ul>
+ <li>namespace and name separated by a <code class="highlighter-rouge">:</code> (colon)</li>
+ <li>have a maximum length of 256 characters</li>
+</ul>
+
+<p>When writing a Java application, you can use the following regex to validate your namespaced IDs: <br />
+ <code class="highlighter-rouge">(?<ns>|(?:(?:[a-zA-Z]\\w*+)(?:\\.[a...\\x00-\\x1F\\x7F-\\xFF/]]|%\\p{XDigit}{2})(?:[[^\\x00-\\x1F\\x7F-\\xFF/]$]|%\\p{XDigit}{2})*+)</code>
+ (see <a href="https://github.com/eclipse/ditto/blob/master/model/base/src/main/java/org/eclipse/ditto/model/base/entity/id/RegexPatterns.java">RegexPatterns#ID_REGEX</a>).</p>
+
+<p>Examples for valid IDs:</p>
+<ul>
+ <li><code class="highlighter-rouge">org.eclipse.ditto:smart-coffee-1</code>,</li>
+ <li><code class="highlighter-rouge">foo:bar</code>,</li>
+ <li><code class="highlighter-rouge">org.eclipse.ditto_42:smart-coffeee</code>,</li>
+ <li><code class="highlighter-rouge">org.eclipse:admin-policy</code>,</li>
+ <li><code class="highlighter-rouge">org.eclipse:admin policy</code></li>
+</ul>
+
+<h2 id="encoding-and-decoding">Encoding and decoding</h2>
+
+<p>If hex encoded characters or spaces are used in the Thing name, the protocol dependent de- or encoding must be
+taken into account. If a Thing is created with the ID <code class="highlighter-rouge">eclipse.ditto:foo bar</code> and is to be queried via the HTTP API,
+the space must be encoded accordingly: <code class="highlighter-rouge">GET /things/eclipse.ditto:foo%20bar</code>.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/basic-overview.html b/2.0/basic-overview.html
new file mode 100644
index 0000000..8af3a07
--- /dev/null
+++ b/2.0/basic-overview.html
@@ -0,0 +1,1839 @@
+<!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, basic concepts, overview, thing, feature, domain model, model">
+<title> Basic concepts overview • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Basic concepts overview">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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 class="active"><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Basic concepts overview</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="domain-model">Domain model</h2>
+
+<p>Eclipse Ditto does not claim to know exactly which structure Things in the
+<a href="#" data-toggle="tooltip" data-original-title="Internet of Things">IoT</a> have or should have.<br />
+Its idea is to be as agnostic as possible when it comes to <code class="highlighter-rouge">Thing</code> data.</p>
+
+<p>Nevertheless, two coarse elements are defined in order to structure <code class="highlighter-rouge">Thing</code>s (see also <a href="basic-thing.html">Thing</a>):</p>
+<ul>
+ <li>Attributes: intended for managing static metadata of a <code class="highlighter-rouge">Thing</code> - as JSON object - which does not change frequently.</li>
+ <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-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
+<a href="basic-policy.html">Policies</a>.<br />
+The <code class="highlighter-rouge">Thing</code> only contains a <code class="highlighter-rouge">policyId</code> which links to a Policy containing the authorization information.
+This class diagram shows the structure Ditto requires for <strong>API version 2</strong>:</p>
+
+<figure><img class="docimage" src="images/pages/basic/ditto-class-diagram-v2.png" alt="Ditto Class Diagram" style="max-width: 600px" /><figcaption>Class diagram of Ditto's most basic entities in <b>API version 2.</b></figcaption></figure>
+
+<h3 id="json-format">JSON Format</h3>
+
+<p>In <strong>API version 2</strong> the most minimalistic representation of a Thing is for example the following:</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">"the.namespace:the-thing-id"</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">"the.namespace:the-policy-id"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>Attributes and Features are optional (as also shown in the class diagram above), so in the example JSON above they are
+omitted.</p>
+
+<p>A minimalistic Thing with one attribute, one Feature, and a definition 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">"the.namespace:the-thing-id"</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">"the.namespace:the-policy-id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"digitaltwin:DigitaltwinExample:1.0.0"</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">"transmission"</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">"cur_speed"</span><span class="p">:</span><span class="w"> </span><span class="mi">90</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">
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/basic-placeholders.html b/2.0/basic-placeholders.html
new file mode 100644
index 0000000..d8f87c4
--- /dev/null
+++ b/2.0/basic-placeholders.html
@@ -0,0 +1,2101 @@
+<!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="connectivity, placeholder, function, expression, substring, default, lower, upper">
+<title> Placeholders • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Placeholders">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="basic-apis.html">APIs</a></li>
+
+
+
+
+
+
+ <li><a href="basic-connections.html">Connections</a></li>
+
+
+
+
+
+
+ <li class="active"><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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Placeholders</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="placeholders">Placeholders</h2>
+
+<p>Placeholders may be used at several places in Ditto where something should be resolved by a variable.<br />
+The general syntax of a placeholder is <code class="highlighter-rouge">{{ prefix:name }}</code>.
+Which placeholder values are available depends on the context where the placeholder is used.</p>
+
+<h3 id="scope-entity-creation--modification">Scope: Entity creation / modification</h3>
+
+<p>Whenever creating or modifying <a href="basic-thing.html">things</a> or <a href="basic-policy.html">policies</a>, the following placeholders
+may be used:</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Placeholder</th>
+ <th>Description</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><code class="highlighter-rouge">{{ request:subjectId }}</code></td>
+ <td>the first authenticated subjectId which sent the command / did the request</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="scope-policy-actions">Scope: Policy actions</h3>
+
+<p>In <a href="basic-policy.html#actions">policy actions</a>, the following placeholders are available in general:</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Placeholder</th>
+ <th>Description</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><code class="highlighter-rouge">{{ header:<header-name> }}</code></td>
+ <td>HTTP header values passed along the HTTP action request</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">{{ jwt:<jwt-body-claim> }}</code></td>
+ <td>any standard or custom claims in the body of the authenticated JWT - e.g., <code class="highlighter-rouge">jwt:sub</code> for the JWT “subject”</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">{{ policy-entry:label }}</code></td>
+ <td>label of the policy entry in which the token integration subject is injected</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="scope-connections">Scope: Connections</h3>
+
+<p>In <a href="basic-connections.html">connections</a>, the following placeholders are available in general:</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Placeholder</th>
+ <th>Description</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><code class="highlighter-rouge">{{ entity:id }}</code></td>
+ <td>full ID composed of ‘‘namespace’’ + ‘’:’’ as a separator + ‘‘name’’ for things and policies</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">{{ entity:namespace }}</code></td>
+ <td>Namespace (i.e. first part of an ID) for things and policies</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">{{ entity:name }}</code></td>
+ <td>Name (i.e. second part of an ID ) for things and policies</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">{{ thing:id }}</code></td>
+ <td>full ID composed of ‘‘namespace’’ + ‘’:’’ as a separator + ‘‘name’’</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">{{ thing:namespace }}</code></td>
+ <td>the namespace (i.e. first part of an ID) of the related thing</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">{{ thing:name }}</code></td>
+ <td>the name (i.e. second part of an ID ) of the related thing</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">{{ feature:id }}</code></td>
+ <td>the ID of the feature (only available if the processed signal was related to a feature)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">{{ header:<header-name> }}</code></td>
+ <td>external header value for connection sources, or Ditto protocol header value for targets and reply-targets (both case-insensitive)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">{{ request:subjectId }}</code></td>
+ <td>primary authorization subject of a command, or primary authorization subject that caused an event</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">{{ topic:full }}</code></td>
+ <td>full <a href="protocol-specification-topic.html">Ditto Protocol topic path</a><br />in the form <code class="highlighter-rouge">{namespace}/{entityId}/{group}/</code><br /><code class="highlighter-rouge">{channel}/{criterion}/{action-subject}</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">{{ topic:namespace }}</code></td>
+ <td>Ditto Protocol <a href="protocol-specification-topic.html#namespace">Namespace</a></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">{{ topic:entityId }}</code></td>
+ <td>Deprecated. Use <code class="highlighter-rouge">{{ topic:entityName }}</code> instead.</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">{{ topic:entityName }}</code></td>
+ <td>Ditto Protocol <a href="protocol-specification-topic.html#entity-name">Entity Name</a></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">{{ topic:group }}</code></td>
+ <td>Ditto Protocol <a href="protocol-specification-topic.html#group">Group</a></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">{{ topic:channel }}</code></td>
+ <td>Ditto Protocol <a href="protocol-specification-topic.html#channel">Channel</a></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">{{ topic:criterion }}</code></td>
+ <td>Ditto Protocol <a href="protocol-specification-topic.html#criterion">Criterion</a></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">{{ topic:action }}</code></td>
+ <td>Ditto Protocol <a href="protocol-specification-topic.html#action-optional">Action</a></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">{{ topic:subject }}</code></td>
+ <td>Ditto Protocol <a href="protocol-specification-topic.html#messages-criterion-actions">Subject</a> (for message commands)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">{{ topic:action-subject }}</code></td>
+ <td>either Ditto Protocol <a href="protocol-specification-topic.html#action-optional">Action</a> or <a href="protocol-specification-topic.html#messages-criterion-actions">Subject</a> (for message commands)</td>
+ </tr>
+ </tbody>
+</table>
+
+<h4 id="examples">Examples</h4>
+
+<p>For a topic path with the intention of <a href="protocol-examples-creatething.html">creating a Thing</a>
+<em>org.eclipse.ditto/device-123/things/twin/commands/create</em> these placeholders would be resolved as follows:</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Placeholder</th>
+ <th>Resolved value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><code class="highlighter-rouge">topic:full</code></td>
+ <td><em>org.eclipse.ditto/device-123/things/twin/commands/create</em></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">topic:namespace</code></td>
+ <td><em>org.eclipse.ditto</em></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">topic:entityName</code></td>
+ <td><em>device-123</em></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">topic:group</code></td>
+ <td><em>things</em></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">topic:channel</code></td>
+ <td><em>twin</em></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">topic:criterion</code></td>
+ <td><em>commands</em></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">topic:action</code></td>
+ <td><em>create</em></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">topic:subject</code></td>
+ <td>❌</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">topic:action-subject</code></td>
+ <td><em>create</em></td>
+ </tr>
+ </tbody>
+</table>
+
+<p>For a topic path with the intention of <a href="protocol-specification-things-messages.html#sending-a-message-to-a-thing">sending a message to a Thing</a>
+<em>org.eclipse.ditto/device-123/things/live/messages/hello.world</em> these placeholders are resolved as follows:</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Placeholder</th>
+ <th>Resolved value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><code class="highlighter-rouge">topic:full</code></td>
+ <td><em>org.eclipse.ditto/device-123/things/live/messages/hello.world</em></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">topic:namespace</code></td>
+ <td><em>org.eclipse.ditto</em></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">topic:entityName</code></td>
+ <td><em>device-123</em></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">topic:group</code></td>
+ <td><em>things</em></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">topic:channel</code></td>
+ <td><em>live</em></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">topic:criterion</code></td>
+ <td><em>messages</em></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">topic:action</code></td>
+ <td>❌</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">topic:subject</code></td>
+ <td><em>hello.world</em></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">topic:action-subject</code></td>
+ <td><em>hello.world</em></td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="function-expressions">Function expressions</h2>
+
+<p>Whenever placeholders can be used (e.g. for <a href="basic-connections.html#placeholders">connections</a>), function expressions
+may additionally be specified.</p>
+
+<p>The syntax of such function expressions are specified similar to a UNIX <code class="highlighter-rouge">pipe</code>, e.g.:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>{{ thing:name | fn:substring-before('-') | fn:default('fallback') | fn:upper() }}
+</code></pre></div></div>
+
+<p>The first expression in such a pipeline <strong>must always</strong> be a placeholder to start with, in the example above <code class="highlighter-rouge">thing:name</code>.<br />
+Followed are functions separated by the pipe (<code class="highlighter-rouge">|</code>) symbol - each function in the pipeline receives the value of the
+previous expression (which may also be <code class="highlighter-rouge">empty</code>).</p>
+
+<p>The function either contains no parameters or contains parameters which are either string constants or could also
+be placeholders again.</p>
+
+<h3 id="function-library">Function library</h3>
+
+<p>The following functions are provided by Ditto out of the box:</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Name</th>
+ <th>Signature</th>
+ <th>Description</th>
+ <th>Examples</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><code class="highlighter-rouge">fn:filter</code></td>
+ <td><code class="highlighter-rouge">(String filterValue, String rqlFunction, String comparedValue)</code></td>
+ <td>Removes the result of the previous expression in the pipeline unless the condition specified by the parameters is satisfied.</td>
+ <td><code class="highlighter-rouge">fn:filter(header:response-required,'eq','true')</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">fn:default</code></td>
+ <td><code class="highlighter-rouge">(String defaultValue)</code></td>
+ <td>Provides the passed <code class="highlighter-rouge">defaultValue</code> when the previous expression in a pipeline resolved to <code class="highlighter-rouge">empty</code> (e.g. due to a non-defined <code class="highlighter-rouge">header</code> placeholder key).<br />Another placeholder may be specified which is resolved to a String and inserted as <code class="highlighter-rouge">defaultValue</code>.</td>
+ <td><code class="highlighter-rouge">fn:default('fallback')</code><br /><code class="highlighter-rouge">fn:default("fallback")</code><br /><code class="highlighter-rouge">fn:default(thing:id)</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">fn:substring-before</code></td>
+ <td><code class="highlighter-rouge">(String givenString)</code></td>
+ <td>Parses the result of the previous expression and passes along only the characters <em>before</em> the first occurrence of <code class="highlighter-rouge">givenString</code>.<br />If <code class="highlighter-rouge">givenString</code> is not contained, this function will resolve to <code class="highlighter-rouge">empty</code>.</td>
+ <td><code class="highlighter-rouge">fn:substring-before(':')</code><br /><code class="highlighter-rouge">fn:substring-before(":")</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">fn:substring-after</code></td>
+ <td><code class="highlighter-rouge">(String givenString)</code></td>
+ <td>Parses the result of the previous expression and passes along only the characters <em>after</em> the first occurrence of <code class="highlighter-rouge">givenString</code>.<br />If <code class="highlighter-rouge">givenString</code> is not contained, this function will resolve to <code class="highlighter-rouge">empty</code>.</td>
+ <td><code class="highlighter-rouge">fn:substring-after(':')</code><br /><code class="highlighter-rouge">fn:substring-after(":")</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">fn:lower</code></td>
+ <td><code class="highlighter-rouge">()</code></td>
+ <td>Makes the String result of the previous expression lowercase in total.</td>
+ <td><code class="highlighter-rouge">fn:lower()</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">fn:upper</code></td>
+ <td><code class="highlighter-rouge">()</code></td>
+ <td>Makes the String result of the previous expression uppercase in total.</td>
+ <td><code class="highlighter-rouge">fn:upper()</code></td>
+ </tr>
+ </tbody>
+</table>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/basic-policy.html b/2.0/basic-policy.html
new file mode 100644
index 0000000..0a96162
--- /dev/null
+++ b/2.0/basic-policy.html
@@ -0,0 +1,2365 @@
+<!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, authentication, authorization, auth, policies, policy">
+<title> 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-feature.html">Feature</a></li>
+
+
+
+
+
+ <li class="active"><a href="basic-policy.html">Policy</a></li>
+
+
+
+
+
+ <li><a href="basic-namespaces-and-names.html">Namespaces and Names</a></li>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">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>
+
+
+
+
+
+
+
+
+
+ <p>A Policy enables developers to configure fine-grained access control for Things and other entities easily.</p>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Find the HTTP API reference at <a href="http-api-doc.html?urls.primaryName=api2#/Policies">Policies resources</a>.</div>
+
+<h2 id="authorization-concept">Authorization concept</h2>
+
+<p>A specific policy provides someone (called subject), permission to read and/or write a given resource.</p>
+
+<div class="alert alert-success" role="alert"><i class="fa fa-check-square-o"></i> <b>Tip:</b> Write permission at the policy root resource (i.e. <code class="highlighter-rouge">policy:/</code>) allows to manage the
+ policy itself.<br />Find an <a href="#example">example</a> at the end of the page.</div>
+
+<p>Please note, that in most cases it makes sense to grant read permission in addition to write permission, because
+<em>write does not imply read.</em></p>
+
+<h2 id="model-specification">Model specification</h2>
+
+<script src="docson/widget.js" data-schema="../jsonschema/policy.json"></script>
+
+<h2 id="subjects">Subjects</h2>
+
+<p>Subjects in a policy define <strong>who</strong> gets permissions granted/revoked on the <a href="#which-resources-can-be-controlled">resources</a>
+of a policy entry.<br />
+Each subject ID contains a prefix defining the subject “issuer” (so which party issued the authentication) and an actual
+subject, separated with a colon:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code><subject-issuer>:<subject>
+</code></pre></div></div>
+
+<p>The subject can be one of the following ones:</p>
+<ul>
+ <li><code class="highlighter-rouge">nginx:<nginx-username></code> - when using nginx as
+<a href="installation-operating.html#pre-authentication">pre-authentication provider</a> - by default enabled in the Ditto
+installation’s nginx</li>
+ <li><code class="highlighter-rouge"><other-pre-auth-provider>:<username></code> - when using another custom provider as
+<a href="installation-operating.html#pre-authentication">pre-authentication provider</a> which sets the
+<code class="highlighter-rouge">x-ditto-pre-authenticated</code> HTTP header</li>
+ <li>
+ <p><code class="highlighter-rouge">google:<google-user-id></code> - in general different
+<a href="#" data-toggle="tooltip" data-original-title="JSON Web Token (JWT)">JWT</a> - the currently supported
+are listed in the table:</p>
+
+ <table>
+ <thead>
+ <tr>
+ <th>Prefix</th>
+ <th>Type</th>
+ <th>Description</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>google</td>
+ <td>jwt</td>
+ <td>A <a href="#" data-toggle="tooltip" data-original-title="JSON Web Token (JWT)">JWT</a> issued by Google</td>
+ </tr>
+ </tbody>
+ </table>
+ </li>
+ <li><code class="highlighter-rouge"><custom-openid-connect-provider>:<jwt-sub-claim></code> -
+custom OpenID Connect compliant providers - supported providers are listed at
+<a href="https://openid.net/developers/certified/">OpenID Connect - Certified OpenID Provider Servers and Services</a> -
+<a href="installation-operating.html#openid-connect">can be configured</a> in Ditto defining the prefix in Ditto’s config file.<br />
+The <code class="highlighter-rouge">sub</code> claim from the JWT and the configured provider name are used in the form <code class="highlighter-rouge"><provider>:<jwt-sub-claim></code>.</li>
+</ul>
+
+<h3 id="expiring-policy-subjects">Expiring Policy subjects</h3>
+
+<p>When a Policy subject contains an <code class="highlighter-rouge">"expiry"</code> timestamp (formatted as ISO-8601 string), this subject will get
+automatically deleted once this timestamp was reached.</p>
+
+<p>When providing an <code class="highlighter-rouge">"expiry"</code> for a Policy subject, this timestamp is rounded up:</p>
+<ul>
+ <li>by default to the next full hour</li>
+ <li>this is configurable via the environment variable <code class="highlighter-rouge">POLICY_SUBJECT_EXPIRY_GRANULARITY</code> of the
+<a href="architecture-services-policies.html">policies</a> service which takes a
+<a href="https://github.com/lightbend/config/blob/master/HOCON.md#duration-format">HOCON duration</a>, e.g.:
+ <ul>
+ <li>configured to “1s”: a received “expiry” is rounded up to the next full second</li>
+ <li>configured to “30s”: a received “expiry” is rounded up to the next half minute</li>
+ <li>configured to “1h”: a received “expiry” is rounded up to the next full hour (<strong>default</strong>)</li>
+ <li>configured to “12h”: a received “expiry” is rounded up to the next half day</li>
+ <li>configured to “1d”: a received “expiry” is rounded up to the next full day</li>
+ <li>configured to “15d”: a received “expiry” is rounded up to the next half month</li>
+ </ul>
+ </li>
+</ul>
+
+<p>Once an expired subject is deleted, it will immediately no longer have access to the resources protected by the policy
+it was deleted from.</p>
+
+<h2 id="actions">Actions</h2>
+
+<p>Policy actions are available via Ditto’s <a href="httpapi-overview.html">HTTP API</a> and can be invoked for certain
+<a href="#model-specification">policy entries</a> or for complete policies.</p>
+
+<p>They require neither <code class="highlighter-rouge">READ</code> nor <code class="highlighter-rouge">WRITE</code> permission, but instead a granted <code class="highlighter-rouge">EXECUTE</code> permission on the specific action
+name, e.g. for a single policy entry:</p>
+<ul>
+ <li><code class="highlighter-rouge">policy:/entries/{label}/actions/{actionName}</code></li>
+</ul>
+
+<h3 id="action-activatetokenintegration">Action activateTokenIntegration</h3>
+
+<div class="alert alert-success" role="alert"><i class="fa fa-check-square-o"></i> <b>Tip:</b>
+ Make use of this action in order to copy your existing permissions for a pre-configured connection
+ (e.g. invoking an HTTP webhook) until the expiration time of the JWT the user authenticated
+ with passes.
+</div>
+
+<p>When authenticated using OpenID Connect, it is possible to inject a subject into policies that expires when
+the <a href="#" data-toggle="tooltip" data-original-title="JSON Web Token (JWT)">JWT</a> expires.
+The form of the injected subject (the token integration subject) is configurable globally in the Ditto installation.</p>
+
+<p>A user is authorized to inject the token integration subject when granted the <code class="highlighter-rouge">EXECUTE</code> permission on a policy entry.<br />
+The <code class="highlighter-rouge">WRITE</code> permission is not necessary. To activate or deactivate a token integration subject, send a <code class="highlighter-rouge">POST</code>
+request to the following HTTP routes:</p>
+
+<ul>
+ <li><a href="/http-api-doc.html#/Policies/post_policies__policyId__actions_activateTokenIntegration">POST /api/2/policies/{policyId}/actions/activateTokenIntegration</a><br />
+Injects a new subject <strong>into all matched policy entries</strong> calculated with information extracted from the authenticated
+JWT.
+ <ul>
+ <li>the authenticated token must be granted the <code class="highlighter-rouge">EXECUTE</code> permission to perform the <code class="highlighter-rouge">activateTokenIntegration</code> action</li>
+ <li>one of the subject IDs must be contained in the authenticated token</li>
+ <li>at least one <code class="highlighter-rouge">READ</code> permission to a <code class="highlighter-rouge">thing:/</code> resource path must be granted</li>
+ </ul>
+ </li>
+ <li><a href="/http-api-doc.html#/Policies/post_policies__policyId__actions_deactivateTokenIntegration">POST /api/2/policies/{policyId}/actions/deactivateTokenIntegration</a><br />
+Removes the calculated subject with information extracted from the authenticated JWT <strong>from all matched policy entries</strong>.
+ <ul>
+ <li>the authenticated token must be granted the <code class="highlighter-rouge">EXECUTE</code> permission to perform the <code class="highlighter-rouge">deactivateTokenIntegration</code> action</li>
+ <li>one of the subject IDs must be contained in the authenticated token</li>
+ </ul>
+ </li>
+ <li><a href="/http-api-doc.html#/Policies/post_policies__policyId__entries__label__actions_activateTokenIntegration">POST /api/2/policies/{policyId}/entries/{label}/actions/activateTokenIntegration</a><br />
+Injects the calculated subject <strong>into the policy entry</strong> calculated with information extracted from the authenticated JWT.
+ <ul>
+ <li>the authenticated token must be granted the <code class="highlighter-rouge">EXECUTE</code> permission to perform the <code class="highlighter-rouge">activateTokenIntegration</code> action</li>
+ <li>one of the subject IDs must be contained in the authenticated token</li>
+ <li>at least one <code class="highlighter-rouge">READ</code> permission to a <code class="highlighter-rouge">thing:/</code> resource path must be granted</li>
+ </ul>
+ </li>
+ <li><a href="/http-api-doc.html#/Policies/post_policies__policyId__entries__label__actions_deactivateTokenIntegration">POST /api/2/policies/{policyId}/entries/{label}/actions/deactivateTokenIntegration</a><br />
+Removes the calculated subject with information extracted from the authenticated JWT <strong>from the policy entry</strong>.
+ <ul>
+ <li>the authenticated token must be granted the <code class="highlighter-rouge">EXECUTE</code> permission to perform the <code class="highlighter-rouge">deactivateTokenIntegration</code> action</li>
+ <li>one of the subject IDs must be contained in the authenticated token</li>
+ </ul>
+ </li>
+</ul>
+
+<p>The injected subject pattern is configurable in Ditto and is by default:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>
+integration:{{policy-entry:label}}:{{jwt:aud}}
+
+</code></pre></div></div>
+
+<p>To configure the token integration subject, set the path</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ditto.gateway.authentication.oauth.token-integration-subject
+</code></pre></div></div>
+<p>in <code class="highlighter-rouge">gateway-extension.conf</code>, or set the environment variable <code class="highlighter-rouge">OAUTH_TOKEN_INTEGRATION_SUBJECT</code> for Gateway Service.</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>
+ditto.gateway.authentication.oauth.token-integration-subject =
+ "my-token-integration-issuer:{{policy-entry:label}}:{{jwt:sub}}"
+
+ditto.gateway.authentication.oauth.token-integration-subject =
+ ${?OAUTH_TOKEN_INTEGRATION_SUBJECT}
+
+</code></pre></div></div>
+
+<p>The <a href="basic-placeholders.html">placeholders</a> below are usable as a part of the <code class="highlighter-rouge">activateTokenIntegration</code> configuration:</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Placeholder</th>
+ <th>Description</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><code class="highlighter-rouge">{{ header:<header-name> }}</code></td>
+ <td>HTTP header values passed along the HTTP action request</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">{{ jwt:<jwt-body-claim> }}</code></td>
+ <td>any standard or custom claims in the body of the JWT - e.g., <code class="highlighter-rouge">jwt:sub</code> for the JWT “subject”</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">{{ policy-entry:label }}</code></td>
+ <td>label of the policy entry in which the token integration subject is injected</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="which-resources-can-be-controlled">Which Resources can be controlled?</h2>
+
+<p>A Policy can contain access control definitions for several resources:</p>
+
+<ul>
+ <li><strong>Policy:</strong> Someone who was granted write permission at the policy root resource (i.e. <code class="highlighter-rouge">policy:/</code>) is allowed to
+manage the policy itself.</li>
+ <li><strong>Thing:</strong> The resource can be defined as fine-grained as necessary for the respective use case: e.g. <code class="highlighter-rouge">thing:/</code> as
+top-level resource or on sub-resources such as <code class="highlighter-rouge">thing:/features</code>.
+At runtime, the permissions are propagated down to all Thing sub-entities.
+ <ul>
+ <li>In case you grant read permission on top-level and revoke it at a sub-entity, the subject can read the upper
+part only.</li>
+ <li>In case you omit a subject at top-level but grant permission at a sub-entity, the subject can access the lower
+part only (and the Thing ID).</li>
+ </ul>
+ </li>
+</ul>
+
+<h3 id="policy">Policy</h3>
+
+<p>The Policy resource (addressable as <code class="highlighter-rouge">policy:/</code>) defines the access control for the Policy itself.</p>
+
+<div class="alert alert-success" role="alert"><i class="fa fa-check-square-o"></i> <b>Tip:</b> Please make sure to define at least one user (for which you have the credentials) with
+ top-level <em>read</em> and <em>write</em> permissions on the Policy, otherwise you won’t be able to access/change it.</div>
+
+<table>
+ <thead>
+ <tr>
+ <th>Resource</th>
+ <th>Addressed data, description</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>policy:/</td>
+ <td>The Policy itself (top-level)<br />Applies to the Policy and all of its sub-resources.</td>
+ </tr>
+ <tr>
+ <td>policy:/policyId</td>
+ <td>The Policy’s ID.<br />However, such a reference is <em>not recommended</em> because write is not supported anyway, and read on the ID only, does not provide any benefit.</td>
+ </tr>
+ <tr>
+ <td>policy:/entries</td>
+ <td>Applies to all entries of the Policy.</td>
+ </tr>
+ <tr>
+ <td>policy:/entries/X</td>
+ <td>Applies to all subjects and resources of the specific entry X.</td>
+ </tr>
+ <tr>
+ <td>policy:/entries/X/subjects</td>
+ <td>Applies to all subjects of the specific entry X.</td>
+ </tr>
+ <tr>
+ <td>policy:/entries/X/subjects/Y</td>
+ <td>Applies to subject Y of the specific entry X.</td>
+ </tr>
+ <tr>
+ <td>policy:/entries/X/resources</td>
+ <td>Applies to all resources of the specific entry X.</td>
+ </tr>
+ <tr>
+ <td>policy:/entries/X/resources/Y</td>
+ <td>Applies to resource Y of the specific entry X.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p>The <a href="basic-policy.html#example">Things example at the end of the page</a> also defines access control on the policy
+resource.</p>
+
+<h3 id="thing">Thing</h3>
+
+<p>The Thing resource (addressable as <code class="highlighter-rouge">thing:/</code>) defines the access control for Things.</p>
+
+<p>The access control definitions defined in a Policy’s Thing resource will be applied to all Things referencing this
+Policy.</p>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> In case you want to re-use a policy for various things, please make sure to name the
+ Policy ID differently than the Thing ID.</div>
+
+<table>
+ <thead>
+ <tr>
+ <th>Resource</th>
+ <th>Addressed data, description</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>thing:/</td>
+ <td>The Thing itself (top-level).<br />Applies to the Thing and all of its sub-resources.</td>
+ </tr>
+ <tr>
+ <td>thing:/thingId</td>
+ <td>The Thing’s ID.<br />Not recommended, because write is not supported anyway and read on the ID only does not provide any benefit.</td>
+ </tr>
+ <tr>
+ <td>thing:/policyId</td>
+ <td>Applies to the Policy ID of the Thing, which implicitly defines its access control.<br /><em>Please double-check write permissions on this resource.</em></td>
+ </tr>
+ <tr>
+ <td>thing:/attributes</td>
+ <td>Applies to all attributes of the Thing.</td>
+ </tr>
+ <tr>
+ <td>thing:/attributes/X</td>
+ <td>Applies to the specific attribute X and its sub-paths.<br />X may be a nested path such as tire/pressure.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p>Find a <a href="basic-policy.html#example">Things example at the end of the page.</a></p>
+
+<h3 id="feature">Feature</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Resource</th>
+ <th>Addressed data, description</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>thing:/features</td>
+ <td>Applies to all Features of the Thing.</td>
+ </tr>
+ <tr>
+ <td>thing:/features/X</td>
+ <td>Applies to the Feature with ID X and all its sub-paths.</td>
+ </tr>
+ <tr>
+ <td>thing:/features/X/properties</td>
+ <td>Applies to all properties of the Feature X.</td>
+ </tr>
+ <tr>
+ <td>thing:/features/X/properties/Y</td>
+ <td>Applies to the property with path Y (and its sub-paths) of the Feature with ID X. <br />Y may be a nested path such as tire/pressure.</td>
+ </tr>
+ <tr>
+ <td>thing:/features/X/desiredProperties</td>
+ <td>Applies to all desired properties of the Feature X.</td>
+ </tr>
+ <tr>
+ <td>thing:/features/X/desiredProperties/Y</td>
+ <td>Applies to the desired property with path Y (and its sub-paths) of the Feature with ID X. <br />Y may be a nested path such as tire/pressure.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p>Find a <a href="basic-policy.html#example">Things example at the end of the page.</a></p>
+
+<h3 id="message">Message</h3>
+
+<p>The Message resource (addressable as <code class="highlighter-rouge">message:/</code>) defines the access control for Messages.</p>
+
+<p>The access control definitions defined in a Policy’s Message resource will be applied to all Messages sent to or from
+Things referencing this Policy.</p>
+
+<ul>
+ <li>For sending messages to a Thing or its Features write permission is required</li>
+ <li>For receiving messages from a Thing or its Features read permission is required.</li>
+</ul>
+
+<p>Such permissions can be defined at resources of different granularity.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Resource</th>
+ <th>Addressed data, description</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>message:/</td>
+ <td>All messages (top-level) <br />Applies to all messages sent to or from Things referencing this Policy and all messages sent to or from features of these Things.</td>
+ </tr>
+ <tr>
+ <td>message:/inbox</td>
+ <td>Applies to all messages sent to a specific Thing (or multiple things referencing this Policy)</td>
+ </tr>
+ <tr>
+ <td>message:/inbox/messages/X</td>
+ <td>Applies to all messages on message-subject X, sent to the Things referencing this Policy</td>
+ </tr>
+ <tr>
+ <td>message:/outbox</td>
+ <td>Applies to all messages sent from the Things referencing this Policy</td>
+ </tr>
+ <tr>
+ <td>message:/outbox/messages/X</td>
+ <td>Applies to all messages on message-subject X, sent from the Things referencing this Policy</td>
+ </tr>
+ <tr>
+ <td>message:/features</td>
+ <td>Messages for all Features <br />Applies to all messages sent to or from all Features of Things referencing this Policy</td>
+ </tr>
+ <tr>
+ <td>message:/features/Y</td>
+ <td>Applies to all messages sent to or from Feature Y of the Things referencing this Policy</td>
+ </tr>
+ <tr>
+ <td>message:/features/Y/inbox</td>
+ <td>Applies to all messages sent to Feature Y of the Things referencing this Policy</td>
+ </tr>
+ <tr>
+ <td>message:/features/Y/inbox/messages/X</td>
+ <td>Applies to all messages on message-subject X sent to Feature Y of the Things referencing this Policy</td>
+ </tr>
+ <tr>
+ <td>message:/features/Y/outbox</td>
+ <td>Applies to all messages sent from Feature Y of the Things referencing this Policy</td>
+ </tr>
+ <tr>
+ <td>message:/features/Y/outbox/messages/X</td>
+ <td>Applies to all messages on message-subject X sent from Feature Y of the Things referencing this Policy</td>
+ </tr>
+ </tbody>
+</table>
+
+<div class="alert alert-success" role="alert"><i class="fa fa-check-square-o"></i> <b>Tip:</b> The resources <code class="highlighter-rouge">message:/inbox</code> and <code class="highlighter-rouge">message:/outbox</code> do not address feature-related messages.
+For providing access to feature-related messages, you have to either grant top-level permission (<code class="highlighter-rouge">message:/</code>) or grant permission to the resource <code class="highlighter-rouge">message:/features</code> (or the required sub-resources).</div>
+
+<p>The <a href="basic-policy.html#example">Things example at the end of the page</a> also defines access control on messages.</p>
+
+<h2 id="grant-and-revoke-some-permission">Grant and Revoke some Permission</h2>
+
+<table>
+ <thead>
+ <tr>
+ <th>Change</th>
+ <th>Permission</th>
+ <th>Description</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>grant</td>
+ <td>READ</td>
+ <td>All subjects named in the section are granted <em>read</em> permission on the resources specified in the path, and all nested paths, except they are revoked at a deeper level, or another policy entry (label).</td>
+ </tr>
+ <tr>
+ <td>grant</td>
+ <td>WRITE</td>
+ <td>All subjects named in the section are granted <em>write</em> permission on the resources specified in the path, and all nested paths, except they are revoked at a deeper level, or another policy entry (label).</td>
+ </tr>
+ <tr>
+ <td>grant</td>
+ <td>EXECUTE</td>
+ <td>All subjects named in the section are granted <em>execute</em> permission on the resources specified in the path, and all nested paths, except they are revoked at a deeper level, or another policy entry (label).</td>
+ </tr>
+ <tr>
+ <td>revoke</td>
+ <td>READ</td>
+ <td>All subjects named in the section are <em>prohibited to read</em> on the resources specified in the path, and all nested paths, except they are granted again such permission at a deeper level, or another policy entry (label).</td>
+ </tr>
+ <tr>
+ <td>revoke</td>
+ <td>WRITE</td>
+ <td>All subjects named in the section are <em>prohibited to write</em> on the resources specified in the path, and all nested paths, except they are granted again such permission at a deeper level, or another policy entry (label).</td>
+ </tr>
+ <tr>
+ <td>revoke</td>
+ <td>EXECUTE</td>
+ <td>All subjects named in the section are <em>prohibited to execute</em> on the resources specified in the path, and all nested paths, except they are granted again such permission at a deeper level, or another policy entry (label).</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="tools-for-editing-a-policy">Tools for editing a Policy</h2>
+
+<p>The Policy can be edited with a text editor of your choice.
+Just make sure it is in valid JSON representation, and that at least one valid subject is granted write permission at
+the root resources.</p>
+
+<div class="alert alert-success" role="alert"><i class="fa fa-check-square-o"></i> <b>Tip:</b> The easiest way to create a Policy is to copy the model schema provided at the
+ <a href="http-api-doc.html?urls.primaryName=api2">interactive HTTP API documentation</a> and adapt it to your needs.</div>
+
+<p>In case of fine-grained access on Things, keep an eye on your actual Thing structure to make sure that all paths will be
+granted or revoked the permissions your use case is supposed to support.</p>
+
+<h2 id="example">Example</h2>
+
+<p>Given you need to support the following scenario:</p>
+
+<ul>
+ <li>Owner: The Thing <em>my.namespace:thing-0123</em> is owned by a user. Thus, she needs full access and admin rights for the
+complete Thing.
+In our example her ID is <em>ditto</em></li>
+ <li>Observer of changes at featureX and featureY:
+ <ul>
+ <li>Another application needs to be informed on each change at those features.
+In our example its ID is <em>observer-client</em>.</li>
+ <li>There is a group of users who are allowed to read both features.
+In our example the group ID is <em>some-users</em>.</li>
+ </ul>
+ </li>
+ <li>Privacy: The value of the “city” property at “featureY” is confidential and needs to be “hidden” from the group of
+users.</li>
+</ul>
+
+<figure><img class="docimage" src="images/pages/basic/policy-example.png" alt="Policy Example" /><figcaption>Example Thing with link to a Policy ID</figcaption></figure>
+
+<p>Your Policy then might look like the following:</p>
+
+<figure><img class="docimage" src="images/pages/basic/policy-example-2.png" alt="Policy Example 2" /><figcaption>Example Policy</figcaption></figure>
+
+<p>The correct Policy JSON object notation would be as shown in the following code block.</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">"policyId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"my.namespace:policy-a"</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">"owner"</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">"nginx:ditto"</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">"nginx basic auth user"</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:/"</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="s2">"READ"</span><span class="p">,</span><span class="w"> </span><span class="s2">"WRITE"</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">"policy:/"</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="s2">"READ"</span><span class="p">,</span><span class="w"> </span><span class="s2">"WRITE"</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">"message:/"</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="s2">"READ"</span><span class="p">,</span><span class="w"> </span><span class="s2">"WRITE"</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">"observer"</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">"nginx:observer-client"</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">"technical client"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"nginx:some-users"</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">"a group of users"</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:/features/featureX"</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="s2">"READ"</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">"thing:/features/featureY"</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="s2">"READ"</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">"private"</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">"nginx:some-users"</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">"a group of users"</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:/features/featureX/properties/location/city"</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">"revoke"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"READ"</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>
+
+<p>The Policy can be found:</p>
+
+<ul>
+ <li>Via GET request at <code class="highlighter-rouge">/api/2/policies/<policyId></code>, and</li>
+ <li>Via GET request at <code class="highlighter-rouge">/api/2/things/{thingId}/policyId</code></li>
+ <li>At any Thing itself in its JSON representation.
+It is however not included by default, but can be retrieved by specifying the <code class="highlighter-rouge">/api/2/things/<thingId>?fields=_policy</code>
+query parameter.</li>
+</ul>
+
+<div class="alert alert-success" role="alert"><i class="fa fa-check-square-o"></i> <b>Tip:</b> As soon as a sophisticated policy is described, you will only need to add a further <strong>subject</strong> entry to have for example a new group of users equally empowered as the initial one.</div>
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/basic-rql.html b/2.0/basic-rql.html
new file mode 100644
index 0000000..af06b46
--- /dev/null
+++ b/2.0/basic-rql.html
@@ -0,0 +1,2034 @@
+<!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="rqlprotocol, rql, query, filter, filtering, search">
+<title> RQL expressions • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="RQL expressions">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 class="active"><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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">RQL expressions</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 utilizes a subset of <a href="#" data-toggle="tooltip" data-original-title="Resource Query Language">RQL</a>
+as language for specifying queries.</p>
+
+<p>The <a href="https://github.com/persvr/rql">RQL project page</a> says about it:</p>
+
+<blockquote>
+ <p>Resource Query Language (RQL) is a query language designed for use in URIs with object style data structures. […]<br />
+RQL can be thought as basically a set of nestable named operators which each have a set of arguments.
+RQL is designed to have an extremely simple, but extensible grammar that can be written in a URL friendly query string.</p>
+</blockquote>
+
+<p>An example helps more than a thousand words, so that would be the example of a simple RQL query querying
+for <code class="highlighter-rouge">foo="ditto"</code> and <code class="highlighter-rouge">bar<10</code>:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>and(eq(foo,"ditto"),lt(bar,10))
+</code></pre></div></div>
+
+<p>That query consists of one <a href="#logical-operators">logical operator </a> <a href="#and">“and”</a>,
+two <a href="#relational-operators">relational operators</a> of which each consists of a <a href="#query-property">property</a>
+and a <a href="#query-value">value</a>.</p>
+
+<p>The following sections describe what the RQL syntax is capable of.</p>
+
+<h2 id="rql-filter">RQL filter</h2>
+
+<p>The RQL filter specifies “what” to filter.</p>
+
+<h3 id="query-property">Query property</h3>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code><property> = url-encoded-string
+</code></pre></div></div>
+
+<p>To filter nested properties, Ditto uses the JSON Pointer notation (<a href="https://tools.ietf.org/html/rfc6901">RFC-6901</a>).</p>
+
+<p>The following example shows how to apply a filter for the sub property location of the parent property attributes with
+a forward slash as separator:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>eq(attributes/location,"kitchen")
+</code></pre></div></div>
+
+<h3 id="query-value">Query value</h3>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code><value> = <number>, <string>, true, false, null
+<number> = double, integer
+<string> = ", url-encoded-string, "
+</code></pre></div></div>
+
+<p><strong>Comparison of string values</strong></p>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Comparison operators such as <code class="highlighter-rouge">gt</code>, <code class="highlighter-rouge">ge</code>, <code class="highlighter-rouge">lt</code> and <code class="highlighter-rouge">le</code>, do not support a special
+ “semantics” of string comparison (e.g. regarding alphabetical or lexicographical ordering).<br />
+ However, you can rely on the alphabetical sorting of strings with the same length (e.g. “aaa” < “zzz”) and that the
+ order stays the same over multiple/different filter requests.</div>
+
+<p><strong>Comparison of other data types</strong></p>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Please note that the comparison of other data types is is supported by the API, but it
+ only supports comparison of same data types, and does not do any conversion during comparison.</div>
+
+<h3 id="relational-operators">Relational operators</h3>
+
+<p>The following relational operators are supported.</p>
+
+<h4 id="eq">eq</h4>
+<p>Filter property values equal to <code class="highlighter-rouge"><value></code>.</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>eq(<property>,<value>)
+</code></pre></div></div>
+
+<p><strong>Example - filter things owned by “SID123”</strong></p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>eq(attributes/owner,"SID123")
+</code></pre></div></div>
+
+<h4 id="ne">ne</h4>
+<p>Filter property values not equal to <code class="highlighter-rouge"><value></code>.</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ne(<property>,<value>)
+</code></pre></div></div>
+
+<p><strong>Example - filter things with owner different than “SID123”</strong></p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ne(attributes/owner,"SID123")
+</code></pre></div></div>
+
+<p>The response will contain only things which <strong>do</strong> provide an owner attribute (in this case with value 0 or not SID123).</p>
+
+<h4 id="gt">gt</h4>
+<p>Filter property values greater than a <code class="highlighter-rouge"><value></code>.</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>gt(<property>,<value>)
+</code></pre></div></div>
+
+<p><strong>Example - filter things with thing ID greater than “A000”</strong></p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>gt(thingId,"A000")
+</code></pre></div></div>
+
+<h4 id="ge">ge</h4>
+<p>Filter property values greater than or equal to a <code class="highlighter-rouge"><value></code>.</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ge(<property>,<value>)
+</code></pre></div></div>
+
+<p><strong>Example - filter things with thing ID “A000” or greater</strong></p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ge(thingId,"A000")
+</code></pre></div></div>
+
+<h4 id="lt">lt</h4>
+<p>Filter property values less than a <code class="highlighter-rouge"><value></code>.</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>lt(<property>,<value>)
+</code></pre></div></div>
+
+<p><strong>Example - filter things with thing ID lower than “A000”</strong></p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>lt(thingId,"A000")
+</code></pre></div></div>
+
+<h4 id="le">le</h4>
+<p>Filter property values less than or equal to a <code class="highlighter-rouge"><value></code>.</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>le(<property>,<value>)
+</code></pre></div></div>
+
+<p><strong>Example - filter things with thing ID “A000” or lower</strong></p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>le(thingId,"A000")
+</code></pre></div></div>
+
+<h4 id="in">in</h4>
+<p>Filter property values which contains at least one of the listed <code class="highlighter-rouge"><value></code>s.</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>in(<property>,<value>,<value>, ...)
+</code></pre></div></div>
+
+<p><strong>Example - filter things with thing ID “A000” or “AB00” or “AZ99”</strong></p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>in(thingId,"A000","AB00","AZ99")
+</code></pre></div></div>
+
+<h4 id="like">like</h4>
+<p>Filter property values which are like (similar) a <code class="highlighter-rouge"><value></code>.</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>like(<property>,<value>)
+</code></pre></div></div>
+
+<p><strong>Details concerning the like-operator</strong></p>
+
+<p>The <code class="highlighter-rouge">like</code> operator provides some regular expression capabilities for pattern matching Strings.<br />
+The following expressions are supported:</p>
+<ul>
+ <li>*endswith => match at the end of a specific String.</li>
+ <li>startswith* => match at the beginning of a specific String.</li>
+ <li>*contains* => match if contains a specific String.</li>
+ <li>Th?ng => match for a wildcard character.</li>
+</ul>
+
+<p><strong>Examples</strong></p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>like(attributes/key1,"*known-chars-at-end")
+
+like(attributes/key1,"known-chars-at-start*")
+
+like(attributes/key1,"*known-chars-in-between*")
+
+like(attributes/key1,"just-som?-char?-unkn?wn")
+</code></pre></div></div>
+
+<h4 id="exists">exists</h4>
+<p>Filter property values which exist.</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>exists(<property>)
+</code></pre></div></div>
+
+<p><strong>Example - filter things which have a feature with ID “feature_1”</strong></p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>exists(features/feature_1)
+</code></pre></div></div>
+
+<p><strong>Example - filter lamps which are located in the “living-room”</strong></p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>and(exists(features/lamp),eq(attributes/location,"living-room"))
+</code></pre></div></div>
+
+<h3 id="logical-operators">Logical operators</h3>
+
+<h4 id="and">and</h4>
+<p>Ensure that all given queries match.</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>and(<query>,<query>, ...)
+</code></pre></div></div>
+
+<p><strong>Example - filter things which are located on the “upper floor” in the “living-room”</strong></p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>and(eq(attributes/floor,"upper floor"),eq(attributes/location,"living-room"))
+</code></pre></div></div>
+
+<h4 id="or">or</h4>
+<p>At least one of the given queries match.</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>or(<query>,<query>, ...)
+</code></pre></div></div>
+
+<p><strong>Example - filter all things located on the “upper floor”, and all things with location “living-room”</strong></p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>or(eq(attributes/floor,"upper floor"),eq(attributes/location,"living-room"))
+</code></pre></div></div>
+
+<h4 id="not">not</h4>
+<p>Negates the given query.</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>not(<query>)
+</code></pre></div></div>
+
+<p><strong>Example - filter things whose ID do not start with a common prefix</strong></p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>not(like(thingId,"org.eclipse.ditto:blocked*"))
+</code></pre></div></div>
+
+<h2 id="rql-sorting">RQL sorting</h2>
+
+<p>The RQL sorting part specifies in which order the result should be returned.</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sort(<+|-><property>,<+|-><property>,...)
+</code></pre></div></div>
+
+<ul>
+ <li>Use <strong>+</strong> for an ascending sort order (URL encoded character <strong>%2B</strong>)</li>
+ <li>Use <strong>-</strong> for a descending sort order (URL encoded character <strong>%2D</strong>)</li>
+</ul>
+
+<p><strong>Example - sort the list ascending by the thing ID</strong></p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sort(+thingId)
+</code></pre></div></div>
+
+<p><strong>Example - sort the list ascending by an attribute</strong></p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sort(+attributes/location)
+</code></pre></div></div>
+
+<p><strong>Example - multiple sort options</strong></p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sort(-attributes/location,+thingId)
+</code></pre></div></div>
+
+<p>This expression will sort the list descending by location attribute.<br />
+In case there are multiple things with the same location attribute, these are sorted ascending by their ID.</p>
+
+<h3 id="sorting-of-string-values">Sorting of string values</h3>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Sorting does not support a special “semantics” of string comparison (e.g. regarding
+ alphabetical or lexicographical ordering). However, you can rely on the alphabetical sorting of strings with the
+ same length (e.g. “aaa” < “zzz”) and that the order stays the same over multiple/different filter requests.</div>
+
+<h3 id="sorting-of-other-values">Sorting of other values</h3>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Sorting does not support a special “semantics” of comparison for fields with values of
+ different data types (e.g. numbers vs. strings). However, you can rely on the fact that values of the same type are
+ sorted respectively.</div>
+
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_rql.html" class="btn btn-default navbar-btn cursorNorm" role="button">rql</a>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/basic-search.html b/2.0/basic-search.html
new file mode 100644
index 0000000..57d755c
--- /dev/null
+++ b/2.0/basic-search.html
@@ -0,0 +1,1934 @@
+<!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="searchrql, search, things-search, rql, query">
+<title> Search functionality • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 functionality">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 class="active"><a href="basic-search.html">Search</a></li>
+
+
+
+
+
+
+ <li><a href="basic-acknowledgements.html">Acknowledgements / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Search functionality</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 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>
+
+<p>Ditto’s microservice <a href="architecture-services-things-search.html">things-search</a> automatically consumes all
+<a href="basic-signals-event.html">events</a> which are emitted for changes to <code class="highlighter-rouge">Things</code> and <code class="highlighter-rouge">Policies</code> and updates an for search
+optimized representation of the <code class="highlighter-rouge">Thing</code> data into its own database.</p>
+
+<p>No custom indexes have to be defined as the structure in the database is “flattened” so that all data contained in
+<a href="basic-thing.html">Things</a> can be searched for efficiently.</p>
+
+<h2 id="consistency">Consistency</h2>
+
+<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 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
+will not reflect that change in that instant. The change will most likely be reflected in the search index within
+1-2 seconds. In rare cases the duration until consistency is reached again might be higher.</p>
+
+<p>If it is important to know when a twin modification is reflected in the search index, request the
+<a href="basic-acknowledgements.html#built-in-acknowledgement-labels">built-in acknowledgement</a> <code class="highlighter-rouge">search-persisted</code>
+in the corresponding command.
+Search index update is successful if the status code of <code class="highlighter-rouge">search-persisted</code> in the command response is 204 “no content”.
+Status codes at or above 400 indicate failed search index update due to client or server errors.</p>
+
+<h2 id="search-queries">Search queries</h2>
+
+<p>Queries can be made via Ditto’s APIs (<a href="httpapi-search.html">HTTP</a> or
+<a href="protocol-specification-things-search.html">Ditto Protocol</a> e.g. via <a href="httpapi-protocol-bindings-websocket.html">WebSocket</a>).</p>
+
+<p><strong>Example:</strong> Search for all things located in “living-room”, reorder the list to start with the lowest thing ID as
+the first element, 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: size(5),cursor(CURSOR_ID)
+</code></pre></div></div>
+
+<h2 id="search-count-queries">Search count queries</h2>
+
+<p>The same syntax applies for search count queries - only the <a href="basic-rql.html#rql-sorting">sorting</a> and
+<a href="#rql-paging-deprecated">paging</a> makes no sense here, so there are not necessary to specify.</p>
+
+<h2 id="namespaces">Namespaces</h2>
+
+<p>The Search supports specifying in which <code class="highlighter-rouge">namespaces</code> it should be searched. This may significantly improve the search
+performance when many Things of different namespaces are managed in Ditto’s search index.</p>
+
+<h2 id="rql">RQL</h2>
+
+<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="sorting-and-paging-options">Sorting and paging options</h2>
+
+<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>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>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>cursor(<cursor-id>)
+</code></pre></div></div>
+<p>Starts the search at the position of the cursor with ID <code class="highlighter-rouge"><cursor-id></code>. The cursor ID is obtained from the field
+<code class="highlighter-rouge">cursor</code> of a previous response and marks the <strong>position after the last entry</strong> of the previous search. A response
+includes no cursor if there are no more results.</p>
+
+<p>If a request has a <code class="highlighter-rouge">cursor</code> option, then any included <code class="highlighter-rouge">filter</code> or <code class="highlighter-rouge">sort</code> option may not differ from the original request
+of the cursor. Otherwise, the request is rejected.</p>
+
+<p><strong>Example - return ten items with a cursor</strong></p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>option=size(10),cursor(<cursor-from-previous-result>)
+</code></pre></div></div>
+
+<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#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>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>limit(<offset>,<count>)
+</code></pre></div></div>
+
+<p>Limits the search results to <code class="highlighter-rouge"><count></code> items, starting with the item at index <code class="highlighter-rouge"><offset></code>.</p>
+<ul>
+ <li>if the paging option is not explicitly specified, the <strong>default</strong> value <code class="highlighter-rouge">limit(0,25)</code> is used,
+i.e. the first <code class="highlighter-rouge">25</code> results are returned.</li>
+ <li>the <strong>maximum</strong> allowed count is <code class="highlighter-rouge">200</code>.</li>
+</ul>
+
+<p><strong>Example - return the first ten items</strong></p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>limit(0,10)
+</code></pre></div></div>
+
+<p><strong>Example - return the items 11 to 20</strong></p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>limit(10,10)
+</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
+ because of potential performance degradations.</div>
+
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_search.html" class="btn btn-default navbar-btn cursorNorm" role="button">search</a>
+
+
+
+ <a href="tag_rql.html" class="btn btn-default navbar-btn cursorNorm" role="button">rql</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/basic-signals-announcement.html b/2.0/basic-signals-announcement.html
new file mode 100644
index 0000000..b252faf
--- /dev/null
+++ b/2.0/basic-signals-announcement.html
@@ -0,0 +1,1797 @@
+<!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="signal, announcement, signal">
+<title> Announcement • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Announcement">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li class="active"><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Announcement</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>Announcements are special signals which are published in order to announce something before it actually happens.<br />
+For example, before an <a href="basic-signals-event.html">event</a> is created and published, an announcement could signal that
+the event will happen soon.</p>
+
+<p>Announcements have the following characteristics:</p>
+<ul>
+ <li>they are <strong>not</strong> persisted/appended into any data store</li>
+ <li>they are published to interested and authorized parties via the <a href="httpapi-protocol-bindings-websocket.html">WebSocket API</a>
+as well as <a href="basic-connections.html#targets">connection targets</a> via <a href="basic-changenotifications.html">change notifications</a>.</li>
+</ul>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_signal.html" class="btn btn-default navbar-btn cursorNorm" role="button">signal</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/basic-signals-command.html b/2.0/basic-signals-command.html
new file mode 100644
index 0000000..4e29a1d
--- /dev/null
+++ b/2.0/basic-signals-command.html
@@ -0,0 +1,1813 @@
+<!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="signal, command, modify, query, signal">
+<title> Command • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Command">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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 class="active"><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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Command</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>Commands involve the need to change or retrieve something of a <strong>digital twin</strong> managed by Ditto or an actual device
+connected to Ditto.</p>
+
+<p>Commands always contain an identifier of the entity they address (e.g. a <code class="highlighter-rouge">Thing ID</code>).</p>
+
+<h2 id="modify-commands">Modify Commands</h2>
+
+<p>Commands which modify a <strong>digital twin</strong> or an actual device are grouped as “Modify Commands”.<br />
+In <a href="#" data-toggle="tooltip" data-original-title="Command-Query Responsibility Segregation. A pattern Ditto applies in order to handle commands (ModifyCommands in Ditto) and queries (QueryCommands in Ditto) differently, e.g. by reading queries from memory and persisting commands to a datastore.">CQRS</a> system those are simply
+referred to as <em>commands</em>.</p>
+
+<p>An overview of all Thing related modify commands can be found in the appropriate chapter of the Ditto Protocol:</p>
+<ul>
+ <li><a href="protocol-specification-things-create-or-modify.html">Create/Modify protocol specification</a>,</li>
+ <li><a href="protocol-specification-things-merge.html">Merge protocol specification</a>,</li>
+ <li><a href="protocol-specification-things-delete.html">Delete protocol specification.</a></li>
+</ul>
+
+<h2 id="query-commands">Query Commands</h2>
+
+<p>Commands which only retrieve information about a <strong>digital twin</strong> or an actual device are grouped as “Query Commands”.<br />
+In <a href="#" data-toggle="tooltip" data-original-title="Command-Query Responsibility Segregation. A pattern Ditto applies in order to handle commands (ModifyCommands in Ditto) and queries (QueryCommands in Ditto) differently, e.g. by reading queries from memory and persisting commands to a datastore.">CQRS</a> system those are simply
+referred to as <em>queries</em>.</p>
+
+<p>An overview of all Thing related query commands can be found in the chapter
+<a href="protocol-specification-things-retrieve.html">“Retrieve protocol specification”</a> of the Ditto Protocol.</p>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_signal.html" class="btn btn-default navbar-btn cursorNorm" role="button">signal</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/basic-signals-commandresponse.html b/2.0/basic-signals-commandresponse.html
new file mode 100644
index 0000000..9452d3d
--- /dev/null
+++ b/2.0/basic-signals-commandresponse.html
@@ -0,0 +1,1792 @@
+<!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="signal, signal, commandresponse, response">
+<title> Command response • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Command response">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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 class="active"><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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Command response</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>CommandResponses are the answer to <a href="basic-signals-command.html">Commands</a> and include information about whether the
+intention of changing something via a <code class="highlighter-rouge">ModifyCommand</code> has worked or if there was an <a href="basic-signals-errorresponse.html">Error</a>
+instead.</p>
+
+<p>The CommandResponse of QueryCommands contains the requested information.</p>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_signal.html" class="btn btn-default navbar-btn cursorNorm" role="button">signal</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/basic-signals-errorresponse.html b/2.0/basic-signals-errorresponse.html
new file mode 100644
index 0000000..3f7b55c
--- /dev/null
+++ b/2.0/basic-signals-errorresponse.html
@@ -0,0 +1,1800 @@
+<!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="signal, signal, error, errorresponse, exception, response">
+<title> Error response • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 response">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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 class="active"><a href="basic-signals-errorresponse.html">Error response</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-event.html">Event</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Error response</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>If an issued <a href="basic-signals-command.html">command</a> or <a href="basic-messages.html">message</a> could not be applied, an
+appropriate error response conveys this <a href="basic-errors.html">error</a> information back to the issuer.<br />
+Failure of a command or message can have various reasons, starting from missing permissions to internal server errors
+during processing of the command.</p>
+
+<p>The <a href="protocol-specification-errors.html">Ditto Protocol for Errors</a> defines how error responses look in Ditto Protocol.</p>
+
+<p>An overview of some possible error responses can be found in the examples chapters:</p>
+<ul>
+ <li><a href="protocol-examples-errorresponses.html">Things error response examples</a></li>
+ <li><a href="protocol-examples-policies-errorresponses.html">Policies error response examples</a></li>
+</ul>
+
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_signal.html" class="btn btn-default navbar-btn cursorNorm" role="button">signal</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/basic-signals-event.html b/2.0/basic-signals-event.html
new file mode 100644
index 0000000..5d71006
--- /dev/null
+++ b/2.0/basic-signals-event.html
@@ -0,0 +1,1799 @@
+<!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="signal, event, signal">
+<title> Event • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Event">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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 class="active"><a href="basic-signals-event.html">Event</a></li>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Event</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>Events report that something took place in a <strong>digital twin</strong> in Ditto. Important is the “past tense” here; it took
+already place (it was for example persisted into the data store) and cannot be reversed or stopped.</p>
+
+<p>Events are one of the centerpieces of Ditto:</p>
+<ul>
+ <li>they are persisted/appended into the data store,</li>
+ <li>they are published in the Ditto cluster, so other Ditto back end services can react on them (e.g. in order to update
+the search index) and</li>
+ <li>they are published to interested and authorized parties via the <a href="httpapi-protocol-bindings-websocket.html">WebSocket API</a> as
+well as via <a href="httpapi-sse.html">HTTP Server Sent Events</a> as well as <a href="basic-connections.html#targets">connection targets</a>
+via <a href="basic-changenotifications.html">change notifications</a>.</li>
+</ul>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_signal.html" class="btn btn-default navbar-btn cursorNorm" role="button">signal</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/basic-signals.html b/2.0/basic-signals.html
new file mode 100644
index 0000000..7f35d03
--- /dev/null
+++ b/2.0/basic-signals.html
@@ -0,0 +1,1844 @@
+<!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="signal, command, communication, CQRS, DDD, event, EventSourcing, response, signal">
+<title> Signals • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Signals">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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 class="active"><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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Signals</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 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-errorresponse.html">Error Responses</a>,</li>
+ <li><a href="basic-signals-event.html">Events</a> and</li>
+ <li><a href="basic-signals-announcement.html">Announcements</a>.</li>
+</ul>
+
+<p>Such common functionality is for example that all those have header fields in which they can be for example correlated
+to each other.</p>
+
+<p>Signals are one of the core concepts of Ditto but they mostly are used internally for communication in the Ditto
+cluster.
+Nevertheless it is very helpful to have a basic understanding of what the Signal types are and in which communication
+pattern they occur.</p>
+
+<h2 id="architectural-style">Architectural style</h2>
+
+<p>Ditto uses Commands, Events,
+<a href="#" data-toggle="tooltip" data-original-title="Command-Query Responsibility Segregation. A pattern Ditto applies in order to handle commands (ModifyCommands in Ditto) and queries (QueryCommands in Ditto) differently, e.g. by reading queries from memory and persisting commands to a datastore.">CQRS</a> and EventSourcing.
+<a href="http://cqrs.nu/Faq">This page</a> provides a quite good explanation of the basic concepts on all of those aspects:</p>
+
+<h3 id="command">Command</h3>
+
+<blockquote>
+ <p>People request changes to the domain by sending commands.
+They are named with a verb in the imperative mood plus and may include the aggregate type, for example <code class="highlighter-rouge">ConfirmOrder</code>.
+Unlike an event, a command is not a statement of fact; it’s only a request, and thus may be refused.
+(A typical way to convey refusal is to throw an exception).</p>
+</blockquote>
+
+<h3 id="event">Event</h3>
+
+<blockquote>
+ <p>An event represents something that took place in the domain.
+They are always named with a past-participle verb, such as <code class="highlighter-rouge">OrderConfirmed</code>.
+It’s not unusual but also not required for an event to name an aggregate or entity that it relates to; let the domain
+language be your guide.<br />
+Since an event represents something in the past, it can be considered a statement of fact and used to take decisions in
+other parts of the system.</p>
+</blockquote>
+
+<h2 id="communication-pattern">Communication pattern</h2>
+
+<ol>
+ <li>A <strong>command</strong> is sent to Ditto where it is then processed.</li>
+ <li>Either a <strong>success response</strong> or an <strong>error response</strong> is sent back to the issuer of the <strong>command</strong>.</li>
+ <li>In addition an <strong>event</strong> is both persisted into the datastore and published.<br />
+The event describes that the change was applied to an entity (e.g. a <code class="highlighter-rouge">Thing</code>).<br />
+Interested parties can subscribe for such <strong>events</strong> and follow the evolving entity.</li>
+</ol>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Events caused by commands from a <strong><a href="basic-connections.html">connection</a></strong> or a
+ <a href="httpapi-protocol-bindings-websocket.html">websocket session</a> are not published
+ <strong>to the same origin</strong>. The connection can receive a response, but will not additionally get an event.</div>
+
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_signal.html" class="btn btn-default navbar-btn cursorNorm" role="button">signal</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/basic-thing.html b/2.0/basic-thing.html
new file mode 100644
index 0000000..d678b96
--- /dev/null
+++ b/2.0/basic-thing.html
@@ -0,0 +1,1878 @@
+<!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, entity, feature, model, namespace, thing">
+<title> 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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 class="active"><a href="basic-thing.html">Thing</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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">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>
+
+
+
+
+
+
+
+
+
+ <p>The versatile assets in IoT applications can be managed as Things.</p>
+
+<h2 id="thing">Thing</h2>
+
+<p>Things are very generic entities and are mostly used as a “handle” for multiple features belonging to this Thing.</p>
+
+<p>Examples:</p>
+
+<ul>
+ <li>Physical Device: a lawn mower, a sensor, a vehicle, a lamp.</li>
+ <li>Virtual Device: a room in a house, a virtual power plant spanning multiple power plants, the weather information for
+a specific location collected by various sensors.</li>
+ <li>Transactional entity: a tour of a vehicle (from start until stop), a series of measurements of a machine.</li>
+ <li>Master data entity: a supplier of devices or a service provider for devices, an entity representing a city/region.</li>
+ <li>Anything else - if it can be modeled and managed appropriately by the supported concepts/capabilities.</li>
+</ul>
+
+<h3 id="thing-id">Thing ID</h3>
+
+<p>Unique identifier of a Thing. For choosing custom Thing IDs when creating a Thing, the rules for
+<a href="basic-namespaces-and-names.html#namespaced-id">namespaced IDs</a> apply.</p>
+
+<h3 id="access-control">Access control</h3>
+
+<p>A Thing in API version 2 contains a link to a <a href="basic-policy.html">Policy</a> in form of a <code class="highlighter-rouge">policyId</code>.
+This <a href="#" data-toggle="tooltip" data-original-title="A Policy enables developers to configure fine-grained access control in an easy way. A specific policy defines who (subject) is granted or revoked permissions (rights) on a specific resource. The resource can be defined as rough or as fine-grained as necessary for the respective use case. ">Policy</a> defines which
+authenticated subjects may READ and WRITE the Thing or even parts of it (hierarchically specified).</p>
+
+<h3 id="definition">Definition</h3>
+
+<p>A Thing may contain a definition. The definition can also be used to find Things. The definition is used to link a thing
+to a corresponding model defining the capabilities/features of it, e.g. via an
+<a href="https://www.eclipse.org/vorto/">Eclipse Vorto</a> “information model”.</p>
+
+<h3 id="attributes">Attributes</h3>
+
+<p>Attributes describe the Thing in more detail and can be of any type. Attributes can also be used to find Things.
+Attributes are typically used to model rather static properties at the Thing level. Static means that the values do not
+change as frequently as property values of Features.</p>
+
+<h3 id="features">Features</h3>
+
+<p>A Thing may contain an arbitrary amount of <a href="basic-feature.html">Features</a>.</p>
+
+<figure><img class="docimage" src="images/pages/basic/ditto-thing-feature.png" alt="Thing and Feature" style="max-width: 100px" /><figcaption>One Thing can have
+many Features</figcaption></figure>
+
+<h3 id="metadata">Metadata</h3>
+
+<p>A Thing may contain additional <a href="basic-metadata.html">metadata</a> for all of its attributes and features describing the
+semantics of the data or adding other useful information about the data points of the twin.</p>
+
+<h3 id="model-specification">Model specification</h3>
+
+<h4 id="api-version-2">API version 2</h4>
+
+<script src="docson/widget.js" data-schema="../jsonschema/thing_v2.json"></script>
+
+<h3 id="example">Example</h3>
+
+<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">"the.namespace:theId"</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">"the.namespace:thePolicyId"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:HeatingDevice:2.1.0"</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">"someAttr"</span><span class="p">:</span><span class="w"> </span><span class="mi">32</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="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">"heating-no1"</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">"connected"</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">"complexProperty"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"street"</span><span class="p">:</span><span class="w"> </span><span class="s2">"my street"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"house no"</span><span class="p">:</span><span class="w"> </span><span class="mi">42</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"desiredProperties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"connected"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"switchable"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:Switcher:1.0.0"</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">"on"</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">"lastToggled"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2017-11-15T18:21Z"</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">
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/blog.html b/2.0/blog.html
new file mode 100644
index 0000000..e931f3d
--- /dev/null
+++ b/2.0/blog.html
@@ -0,0 +1,470 @@
+<!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=" news, blog, updates, release notes, announcements">
+<title> Blog • 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="Eclipse 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 class="active"><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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Blog">{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">
+ <div class="post-header">
+ <h1 class="post-title-main">Blog</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+
+
+
+
+
+
+ <div class="home">
+
+ <div class="post-list">
+
+
+
+
+ <h2><a class="post-link" href="2021-05-06-release-announcement-200.html">Announcing Eclipse Ditto Release 2.0.0</a></h2>
+ <span class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2021-05-06T00:00:00+00:00" itemprop="datePublished">May 6, 2021</time> - Tags:
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+ </span>
+
+ <p> Today, ~1.5 years after release 1.0.0, the Eclipse Ditto team is happy to announce the availability of Eclipse Ditto 2.0.0. With the major version 2.0.0 the Ditto team removed technical debt and ended support for APIs which were deprecated long ago in order to have a better maintainable... </p>
+
+
+
+
+
+ <h2><a class="post-link" href="2021-03-31-ssh-tunneling-for-managed-connections.html">Support SSH tunneling for managed connections</a></h2>
+ <span class="post-meta">Published by <img src="https://www.gravatar.com/avatar/c6d7916bf0fd9cb08b047602bfc4deab?s=135" alt="A photo of Vadim Günther" 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/VadimGue" target="_blank">Vadim Günther</a> </span></span> on <time datetime="2021-03-31T00:00:00+00:00" itemprop="datePublished">Mar 31, 2021</time> - Tags:
+
+
+ <a href="tag_blog.html">blog</a>,
+
+
+
+ <a href="tag_architecture.html">architecture</a>,
+
+
+
+ <a href="tag_connectivity.html">connectivity</a>
+
+
+ </span>
+
+ <p> With the upcoming release of Eclipse Ditto version 2.0.0 it will be possible to SSH tunneling for managed connections With the upcoming release of Eclipse Ditto version 2.0.0, managed connections support establishing an SSH tunnel, which is then used to connect to the actual target endpoint. This is useful... </p>
+
+
+
+
+
+ <h2><a class="post-link" href="2021-03-22-azure-iot-hub-integration.html">Use Eclipse Ditto with Azure IoT Hub as message broker</a></h2>
+ <span class="post-meta">Published by <img src="https://www.gravatar.com/avatar/3c657b46dc4d006056091942068f6ad7?s=135" alt="A photo of David Schwilk" 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/derschwilk" target="_blank">David Schwilk</a> </span></span> on <time datetime="2021-03-22T00:00:00+00:00" itemprop="datePublished">Mar 22, 2021</time> - Tags:
+
+
+ <a href="tag_blog.html">blog</a>,
+
+
+
+ <a href="tag_architecture.html">architecture</a>,
+
+
+
+ <a href="tag_connectivity.html">connectivity</a>
+
+
+ </span>
+
+ <p> This blogpost is based upon Eclipse Ditto Version 1.5.0, the Azure IoT Suite as of 2021-03-19 and the azure-iot-device-client version 1.29.2. Connecting devices to Eclipse Ditto via Azure IoT Hub This blog post elaborates on connecting and managing devices in Eclipse Ditto by using the Azure IoT Hub as... </p>
+
+
+
+
+
+ <h2><a class="post-link" href="2021-02-04-merge-feature.html">Support merge functionality for things resources</a></h2>
+ <span class="post-meta">Published by <img src="https://www.gravatar.com/avatar/4125883975796a6f81e380b371438549?s=135" alt="A photo of Stefan Maute" 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/stmaute" target="_blank">Stefan Maute</a> </span></span> on <time datetime="2021-02-04T00:00:00+00:00" itemprop="datePublished">Feb 4, 2021</time> - Tags:
+
+
+ <a href="tag_blog.html">blog</a>,
+
+
+
+ <a href="tag_http.html">http</a>,
+
+
+
+ <a href="tag_protocol.html">protocol</a>
+
+
+ </span>
+
+ <p> With the upcoming release of Eclipse Ditto version 2.0.0 it will be possible to merge existing things and their subresources. Merge functionality for things resources Ditto now supports merging of existing things and all of its subresources with the provided payload in the request. This can be done by... </p>
+
+
+
+
+
+ <h2><a class="post-link" href="2021-01-22-policy-subject-activate-token-integration.html">Policy actions: token based subject activation</a></h2>
+ <span class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2021-01-22T00:00:00+00:00" itemprop="datePublished">Jan 22, 2021</time> - Tags:
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+ </span>
+
+ <p> The upcoming version of Eclipse Ditto 2.0.0 will be enhanced with the ability to alter policies based on policy actions. Policy actions This new concept of Policy actions allows upfront defined modifications to policies without the need for the one invoking the action to have “WRITE” permissions... </p>
+
+
+
+
+
+ <h2><a class="post-link" href="2020-12-10-release-announcement-150.html">Announcing Eclipse Ditto Release 1.5.0</a></h2>
+ <span class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2020-12-10T00:00:00+00:00" itemprop="datePublished">Dec 10, 2020</time> - Tags:
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+ </span>
+
+ <p> Wrapping up this crazy year, the Ditto team is happy to announce the next feature update of Ditto 1.x: Eclipse Ditto 1.5.0 1.5.0 focuses on: Desired properties management (CRUD) Addition of “cloudevents” HTTP endpoint Ditto internal pub/sub supports using a “grouping” concept which improves Ditto’s scalability capabilities Issuing... </p>
+
+
+
+
+
+ <h2><a class="post-link" href="2020-11-16-weak-acknowledgements.html">Weak acknowledgments to decouple signal publishers and subscribers</a></h2>
+ <span class="post-meta">Published by <img src="https://www.gravatar.com/avatar/d923944b6a8c76e411ff838fb19acfa7?s=135" alt="A photo of Yufei Cai" 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/yufei-cai" target="_blank">Yufei Cai</a> </span></span> on <time datetime="2020-11-16T00:00:00+00:00" itemprop="datePublished">Nov 16, 2020</time> - Tags:
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+ </span>
+
+ <p> Motivation Ditto 1.2.0 introduced at-least-once delivery via acknowledgement requests. It increased coupling between the publisher and the subscriber of signals in that the subscriber is no longer at the liberty to filter for signals it is interested in. Instead, the subscriber must consume all signals in... </p>
+
+
+
+
+
+ <h2><a class="post-link" href="2020-11-11-desired-properties.html">Desired Feature Properties</a></h2>
+ <span class="post-meta">Published by <img src="https://www.gravatar.com/avatar/3c657b46dc4d006056091942068f6ad7?s=135" alt="A photo of David Schwilk" 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/derschwilk" target="_blank">David Schwilk</a> </span></span> on <time datetime="2020-11-11T00:00:00+00:00" itemprop="datePublished">Nov 11, 2020</time> - Tags:
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+ </span>
+
+ <p> Desired feature properties added to things model With the upcoming release of Eclipse Ditto version 1.5.0 desired feature properties are introduced to the things model for API versions later than 1. The desired properties for features are added on the same level of the model as the feature... </p>
+
+
+
+
+
+ <h2><a class="post-link" href="2020-10-28-release-announcement-140.html">Announcing Eclipse Ditto Release 1.4.0</a></h2>
+ <span class="post-meta">Published by <img src="https://www.gravatar.com/avatar/d923944b6a8c76e411ff838fb19acfa7?s=135" alt="A photo of Yufei Cai" 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/yufei-cai" target="_blank">Yufei Cai</a> </span></span> on <time datetime="2020-10-28T00:00:00+00:00" itemprop="datePublished">Oct 28, 2020</time> - Tags:
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+ </span>
+
+ <p> Today, the Ditto team is happy to announce the next feature update of Ditto 1.x: Eclipse Ditto 1.4.0 1.4.0 focuses on: Declaration of acknowledgement labels unique to each subscriber Please have a look at the 1.4.0 release notes for a more detailed information on the release.... </p>
+
+
+
+
+
+ <h2><a class="post-link" href="2020-10-23-end-2-end-acknowledgment.html">E2E acknowledgment</a></h2>
+ <span class="post-meta">Published by <img src="https://www.gravatar.com/avatar/d2b4eba8f1c947a3fb94be23d8b82d8b?s=135" alt="A photo of Yannic Klem" 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/Yannic92" target="_blank">Yannic Klem</a> </span></span> on <time datetime="2020-10-23T00:00:00+00:00" itemprop="datePublished">Oct 23, 2020</time> - Tags:
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+ </span>
+
+ <p> E2E acknowledgement using Eclipse Ditto By adding the new acknowledgements feature to Ditto, it is now possible to provide an end to end QoS (quality of service) with level 1. Previously the connectivity service of Ditto did accept all incoming messages immediately as soon as it received... </p>
+
+
+
+ <p><a href="feed.xml" class="btn btn-primary navbar-btn cursorNorm" role="button">RSS Subscribe</a></p>
+
+<hr />
+ <p>See more posts from the <a href="blog_archive.html">Blog Archive</a>. </p>
+
+ </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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/blog_archive.html b/2.0/blog_archive.html
new file mode 100644
index 0000000..09b63c7
--- /dev/null
+++ b/2.0/blog_archive.html
@@ -0,0 +1,596 @@
+<!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=" news, blog, updates, release notes, announcements">
+<title> Blog archive • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Blog archive">{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">
+ <div class="post-header">
+ <h1 class="post-title-main">Blog archive</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+
+
+
+
+
+
+ <div class="home">
+
+ <div class="post-list">
+
+
+ <section id="archive">
+ <h3>This year's posts</h3>
+
+
+ <ul class="this">
+
+ <li><time>06 May</time><a href="2021-05-06-release-announcement-200.html">Announcing Eclipse Ditto Release 2.0.0</a></li>
+
+
+
+
+
+
+ <li><time>31 Mar</time><a href="2021-03-31-ssh-tunneling-for-managed-connections.html">Support SSH tunneling for managed connections</a></li>
+
+
+
+
+
+
+ <li><time>22 Mar</time><a href="2021-03-22-azure-iot-hub-integration.html">Use Eclipse Ditto with Azure IoT Hub as message broker</a></li>
+
+
+
+
+
+
+ <li><time>04 Feb</time><a href="2021-02-04-merge-feature.html">Support merge functionality for things resources</a></li>
+
+
+
+
+
+
+ <li><time>22 Jan</time><a href="2021-01-22-policy-subject-activate-token-integration.html">Policy actions: token based subject activation</a></li>
+
+
+
+
+
+ </ul>
+ <h3>2020</h3>
+ <ul class="past">
+
+
+ <li><time>10 Dec</time><a href="2020-12-10-release-announcement-150.html">Announcing Eclipse Ditto Release 1.5.0</a></li>
+
+
+
+
+
+
+ <li><time>16 Nov</time><a href="2020-11-16-weak-acknowledgements.html">Weak acknowledgments to decouple signal publishers and subscribers</a></li>
+
+
+
+
+
+
+ <li><time>11 Nov</time><a href="2020-11-11-desired-properties.html">Desired Feature Properties</a></li>
+
+
+
+
+
+
+ <li><time>28 Oct</time><a href="2020-10-28-release-announcement-140.html">Announcing Eclipse Ditto Release 1.4.0</a></li>
+
+
+
+
+
+
+ <li><time>23 Oct</time><a href="2020-10-23-end-2-end-acknowledgment.html">E2E acknowledgment</a></li>
+
+
+
+
+
+
+ <li><time>08 Oct</time><a href="2020-10-08-asynchronous-client-creation.html">Asynchronous Client Creation in Ditto Java Client 1.3.0</a></li>
+
+
+
+
+
+
+ <li><time>30 Sep</time><a href="2020-09-30-release-announcement-130.html">Announcing Eclipse Ditto Release 1.3.0</a></li>
+
+
+
+
+
+
+ <li><time>31 Aug</time><a href="2020-08-31-release-announcement-120.html">Announcing Eclipse Ditto Release 1.2.0</a></li>
+
+
+
+
+
+
+ <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>
+
+
+
+
+
+
+ <li><time>04 Nov</time><a href="2019-11-04-milestone-announcement-100-M2.html">Announcing Ditto Milestone 1.0.0-M2</a></li>
+
+
+
+
+
+
+ <li><time>17 Oct</time><a href="2019-10-17-http-connectivity.html">Integration of HTTP endpoints/webhooks</a></li>
+
+
+
+
+
+
+ <li><time>17 Sep</time><a href="2019-09-17-milestone-announcement-100-M1a.html">Announcing Ditto Milestone 1.0.0-M1a</a></li>
+
+
+
+
+
+
+ <li><time>28 Aug</time><a href="2019-08-28-openid-connect.html">Eclipse Ditto now supports OpenID Connect</a></li>
+
+
+
+
+
+
+ <li><time>10 Jul</time><a href="2019-07-10-release-announcement-090.html">Announcing Eclipse Ditto Release 0.9.0</a></li>
+
+
+
+
+
+
+ <li><time>29 Apr</time><a href="2019-04-29-milestone-announcement-090-M2.html">Announcing Ditto Milestone 0.9.0-M2</a></li>
+
+
+
+
+
+
+ <li><time>28 Mar</time><a href="2019-03-28-milestone-announcement-090-M1.html">Announcing Ditto Milestone 0.9.0-M1</a></li>
+
+
+
+
+
+
+ <li><time>13 Mar</time><a href="2019-03-13-kafka-connectivity.html">Connectivity to Apache Kafka in Eclipse Ditto</a></li>
+
+
+
+
+
+ </ul>
+ <h3>2018</h3>
+ <ul class="past">
+
+
+ <li><time>05 Dec</time><a href="2018-12-05-example-command-and-control.html">Using Eclipse Hono's Command&Control with Eclipse Ditto</a></li>
+
+
+
+
+
+
+ <li><time>28 Nov</time><a href="2018-11-28-release-announcement-080.html">Announcing Eclipse Ditto Release 0.8.0</a></li>
+
+
+
+
+
+
+ <li><time>14 Nov</time><a href="2018-11-14-milestone-announcement-080-M3.html">Announcing Ditto Milestone 0.8.0-M3</a></li>
+
+
+
+
+
+
+ <li><time>16 Oct</time><a href="2018-10-16-example-mqtt-bidirectional.html">Example demonstrating connectivity to an MQTT broker</a></li>
+
+
+
+
+
+
+ <li><time>27 Sep</time><a href="2018-09-27-milestone-announcement-080-M2.html">Announcing Ditto Milestone 0.8.0-M2</a></li>
+
+
+
+
+
+
+ <li><time>21 Sep</time><a href="2018-09-21-selective-push-notifications.html">Selective push notifications available</a></li>
+
+
+
+
+
+
+ <li><time>14 Aug</time><a href="2018-08-14-milestone-announcement-080-M1.html">Announcing Ditto Milestone 0.8.0-M1</a></li>
+
+
+
+
+
+
+ <li><time>15 Jun</time><a href="2018-06-15-milestone-announcement-030-M2.html">Announcing Ditto Milestone 0.3.0-M2</a></li>
+
+
+
+
+
+
+ <li><time>02 May</time><a href="2018-05-02-connecting-ditto-hono.html">Connecting Eclipse Ditto to Eclipse Hono</a></li>
+
+
+
+
+
+
+ <li><time>26 Apr</time><a href="2018-04-26-milestone-announcement-030-M1.html">Announcing Ditto Milestone 0.3.0-M1</a></li>
+
+
+
+
+
+
+ <li><time>25 Apr</time><a href="2018-04-25-connectivity-service.html">Ditto's connectivity capabilities are pimped up</a></li>
+
+
+
+
+
+
+ <li><time>08 Feb</time><a href="2018-02-08-feature-definition.html">Introducing Feature Definition</a></li>
+
+
+
+
+
+
+ <li><time>07 Feb</time><a href="2018-02-07-milestone-announcement-020-M1.html">Announcing Ditto Milestone 0.2.0-M1</a></li>
+
+
+
+
+
+
+ <li><time>15 Jan</time><a href="2018-01-15-example-demonstrating-rest-to-websocket.html">Example demonstrating REST and WebSocket API</a></li>
+
+
+
+
+
+
+ <li><time>12 Jan</time><a href="2018-01-12-milestone-announcement-010-M3.html">Announcing Ditto Milestone 0.1.0-M3</a></li>
+
+
+
+
+
+ </ul>
+ <h3>2017</h3>
+ <ul class="past">
+
+
+ <li><time>18 Dec</time><a href="2017-12-18-milestone-announcement-010-M1.html">Announcing Ditto Milestone 0.1.0-M1</a></li>
+
+
+
+
+
+
+ <li><time>10 Nov</time><a href="2017-11-10-welcome-to-ditto.html">Welcome to the Eclipse Ditto project site</a></li>
+
+ </ul>
+ </section>
+ <hr/>
+ </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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/client-sdk-java.html b/2.0/client-sdk-java.html
new file mode 100644
index 0000000..4e4dddb
--- /dev/null
+++ b/2.0/client-sdk-java.html
@@ -0,0 +1,2036 @@
+<!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="client_sdk, ">
+<title> Client SDK Java • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Client SDK Java">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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 class="active"><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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Client SDK Java</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>A client SDK for Java in order to interact with digital twins provided by an Eclipse Ditto backend.</p>
+
+<h2 id="features">Features</h2>
+
+<ul>
+ <li>Digital twin management: CRUD (create, read, update, delete) of Ditto <a href="https://www.eclipse.org/ditto/basic-thing.html">things</a></li>
+ <li><a href="https://www.eclipse.org/ditto/basic-changenotifications.html">Change notifications</a>:
+consume notifications whenever a “watched” digital twin is modified</li>
+ <li>Send/receive <a href="https://www.eclipse.org/ditto/basic-messages.html">messages</a> to/from devices connected via a digital twin</li>
+ <li>Use the <a href="https://www.eclipse.org/ditto/protocol-twinlive.html#live">live channel</a> in order to react on commands directed
+to devices targeting their “live” state</li>
+</ul>
+
+<h2 id="communication-channel">Communication channel</h2>
+
+<p>The Ditto Java client interacts with an Eclipse Ditto backend via Ditto’s
+<a href="https://www.eclipse.org/ditto/httpapi-protocol-bindings-websocket.html">WebSocket</a> sending and receiving messages
+in <a href="https://www.eclipse.org/ditto/protocol-overview.html">Ditto Protocol</a>.</p>
+
+<h2 id="usage">Usage</h2>
+
+<p>Maven coordinates:</p>
+
+<div class="language-xml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt"><dependency></span>
+ <span class="nt"><groupId></span>org.eclipse.ditto<span class="nt"></groupId></span>
+ <span class="nt"><artifactId></span>ditto-client<span class="nt"></artifactId></span>
+ <span class="nt"><version></span>${ditto-client.version}<span class="nt"></version></span>
+<span class="nt"></dependency></span>
+</code></pre></div></div>
+
+<h3 id="instantiate--configure-a-new-ditto-client">Instantiate & configure a new Ditto client</h3>
+
+<p>To configure your Ditto client instance, use the <code class="highlighter-rouge">org.eclipse.ditto.client.configuration</code> package in order to</p>
+<ul>
+ <li>create instances of <code class="highlighter-rouge">AuthenticationProvider</code> and <code class="highlighter-rouge">MessagingProvider</code></li>
+ <li>create a <code class="highlighter-rouge">DisconnectedDittoClient</code> instance</li>
+ <li>obtain a <code class="highlighter-rouge">DittoClient</code> instance asynchronously by calling <code class="highlighter-rouge">.connect()</code></li>
+</ul>
+
+<p>For example:</p>
+
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">ProxyConfiguration</span> <span class="n">proxyConfiguration</span> <span class="o">=</span>
+ <span class="n">ProxyConfiguration</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">proxyHost</span><span class="o">(</span><span class="s">"localhost"</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">proxyPort</span><span class="o">(</span><span class="mi">3128</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">build</span><span class="o">();</span>
+
+<span class="n">AuthenticationProvider</span> <span class="n">authenticationProvider</span> <span class="o">=</span>
+ <span class="n">AuthenticationProviders</span><span class="o">.</span><span class="na">clientCredentials</span><span class="o">(</span><span class="n">ClientCredentialsAuthenticationConfiguration</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">clientId</span><span class="o">(</span><span class="s">"my-oauth-client-id"</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">clientSecret</span><span class="o">(</span><span class="s">"my-oauth-client-secret"</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">scopes</span><span class="o">(</span><span class="s">"offline_access email"</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">tokenEndpoint</span><span class="o">(</span><span class="s">"https://my-oauth-provider/oauth/token"</span><span class="o">)</span>
+ <span class="c1">// optionally configure a proxy server</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">build</span><span class="o">());</span>
+
+<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.eclipseprojects.io"</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>
+ <span class="o">.</span><span class="na">location</span><span class="o">(</span><span class="n">TRUSTSTORE_LOCATION</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">password</span><span class="o">(</span><span class="n">TRUSTSTORE_PASSWORD</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">build</span><span class="o">())</span>
+ <span class="o">.</span><span class="na">build</span><span class="o">(),</span> <span class="n">authenticationProvider</span><span class="o">);</span>
+
+<span class="n">DisconnectedDittoClient</span> <span class="n">disconnectedDittoClient</span> <span class="o">=</span> <span class="n">DittoClients</span><span class="o">.</span><span class="na">newInstance</span><span class="o">(</span><span class="n">messagingProvider</span><span class="o">);</span>
+
+<span class="n">disconnectedDittoClient</span><span class="o">.</span><span class="na">connect</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">thenAccept</span><span class="o">(</span><span class="k">this</span><span class="o">::</span><span class="n">startUsingDittoClient</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">exceptionally</span><span class="o">(</span><span class="n">error</span> <span class="o">-></span> <span class="n">disconnectedDittoClient</span><span class="o">.</span><span class="na">destroy</span><span class="o">());</span>
+
+</code></pre></div></div>
+
+<h3 id="use-the-ditto-client">Use the Ditto client</h3>
+
+<h4 id="manage-twins">Manage twins</h4>
+
+<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">create</span><span class="o">(</span><span class="s">"org.eclipse.ditto:new-thing"</span><span class="o">).</span><span class="na">handle</span><span class="o">((</span><span class="n">createdThing</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">createdThing</span> <span class="o">!=</span> <span class="kc">null</span><span class="o">)</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">"Created new thing: "</span> <span class="o">+</span> <span class="n">createdThing</span><span class="o">);</span>
+ <span class="o">}</span> <span class="k">else</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">"Thing could not be created due to: "</span> <span class="o">+</span> <span class="n">throwable</span><span class="o">.</span><span class="na">getMessage</span><span class="o">());</span>
+ <span class="o">}</span>
+ <span class="k">return</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">putAttribute</span><span class="o">(</span><span class="s">"first-updated-at"</span><span class="o">,</span> <span class="n">OffsetDateTime</span><span class="o">.</span><span class="na">now</span><span class="o">().</span><span class="na">toString</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>
+
+<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>
+ <span class="k">if</span> <span class="o">(</span><span class="n">change</span><span class="o">.</span><span class="na">getAction</span><span class="o">()</span> <span class="o">==</span> <span class="n">ChangeAction</span><span class="o">.</span><span class="na">CREATED</span><span class="o">)</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">"An existing Thing was modified: "</span> <span class="o">+</span> <span class="n">change</span><span class="o">.</span><span class="na">getThing</span><span class="o">());</span>
+ <span class="c1">// perform custom actions ..</span>
+ <span class="o">}</span>
+<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>
+
+<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>
+
+<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">live</span><span class="o">().</span><span class="na">registerForMessage</span><span class="o">(</span><span class="s">"globalMessageHandler"</span><span class="o">,</span> <span class="s">"hello.world"</span><span class="o">,</span> <span class="n">message</span> <span class="o">-></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">"Received Message with subject "</span> <span class="o">+</span> <span class="n">message</span><span class="o">.</span><span class="na">getSubject</span><span class="o">());</span>
+ <span class="n">message</span><span class="o">.</span><span class="na">reply</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">statusCode</span><span class="o">(</span><span class="n">HttpStatusCode</span><span class="o">.</span><span class="na">IM_A_TEAPOT</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">payload</span><span class="o">(</span><span class="s">"Hello, I'm just a Teapot!"</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">send</span><span class="o">();</span>
+<span class="o">});</span>
+</code></pre></div></div>
+
+<p>Send a message with the subject <code class="highlighter-rouge">hello.world</code> to the thing with ID <code class="highlighter-rouge">org.eclipse.ditto:new-thing</code>:</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">live</span><span class="o">().</span><span class="na">forId</span><span class="o">(</span><span class="s">"org.eclipse.ditto:new-thing"</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">message</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">from</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">subject</span><span class="o">(</span><span class="s">"hello.world"</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">payload</span><span class="o">(</span><span class="s">"I am a Teapot"</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">send</span><span class="o">(</span><span class="n">String</span><span class="o">.</span><span class="na">class</span><span class="o">,</span> <span class="o">(</span><span class="n">response</span><span class="o">,</span> <span class="n">throwable</span><span class="o">)</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">"Got response: "</span> <span class="o">+</span> <span class="n">response</span><span class="o">.</span><span class="na">getPayload</span><span class="o">().</span><span class="na">orElse</span><span class="o">(</span><span class="kc">null</span><span class="o">))</span>
+ <span class="o">);</span>
+</code></pre></div></div>
+
+<h4 id="manage-policies">Manage policies</h4>
+
+<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>
+
+<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>
+
+<p><a href="basic-acknowledgements.html#requesting-acks">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>
+ which is configured to connect to the <a href="https://ditto.eclipseprojects.io">Ditto sandbox</a>.</p>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+
+
+ </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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/client-sdk-javascript.html b/2.0/client-sdk-javascript.html
new file mode 100644
index 0000000..99a393c
--- /dev/null
+++ b/2.0/client-sdk-javascript.html
@@ -0,0 +1,1840 @@
+<!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="client_sdk, ">
+<title> Client SDK JavaScript • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Client SDK JavaScript">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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 class="active"><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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Client SDK JavaScript</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>A TypeScript library to facilitate working the the REST-like HTTP API and web socket API of Eclipse Ditto.</p>
+
+<h2 id="how-to-use-it">How to use it</h2>
+<p>Install <code class="highlighter-rouge">@eclipse-ditto/ditto-javascript-client-dom</code> for the DOM (browser) implementation,
+<code class="highlighter-rouge">@eclipse-ditto/ditto-javascript-client-node</code> for the NodeJS implementation, or <code class="highlighter-rouge">@eclipse/ditto-javascript-client-api-ditto</code> for
+the API and build your own client implementation.</p>
+
+<p>More information can be found in the descriptions of the subpackages:</p>
+<ul>
+ <li><a href="https://github.com/eclipse/ditto-clients/blob/master/javascript/lib/api/README.md">@eclipse-ditto/ditto-javascript-client-api</a></li>
+ <li><a href="https://github.com/eclipse/ditto-clients/blob/master/javascript/lib/dom/README.md">@eclipse-ditto/ditto-javascript-client-dom</a></li>
+ <li><a href="https://github.com/eclipse/ditto-clients/blob/master/javascript/lib/node/README.md">@eclipse-ditto/ditto-javascript-client-node</a></li>
+</ul>
+
+<p>All released versions are published on <a href="https://www.npmjs.com/~eclipse_ditto">npmjs.com</a>.</p>
+
+<h2 id="compatibility-with-eclipse-ditto">Compatibility with <a href="https://github.com/eclipse/ditto">Eclipse Ditto</a></h2>
+
+<p>The newest release of the JavaScript client will always try to cover as much API
+functionality of the same Eclipse Ditto major version as possible. There might
+however be missing features for which we would be very happy to accept contributions.</p>
+
+<h2 id="coding">Coding</h2>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>npm install
+npm run build
+npm run lint
+npm test
+# or npm run test:watch
+</code></pre></div></div>
+
+<h2 id="troubleshooting">Troubleshooting</h2>
+<p>If you get strange errors, it would be best cleaning all dependencies and
+starting from the beginning again:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>npm run clean
+# by hand delete node_modules in the root folder, or use a tool like rm, rimraf, etc.
+npm install
+npm run build
+# ...
+</code></pre></div></div>
+<p>It is important to know that during install and build some extra processes
+are triggered by e.g. lerna which will symlink the <code class="highlighter-rouge">api</code> dependency into
+the node_modules of <code class="highlighter-rouge">dom</code> and <code class="highlighter-rouge">node</code> packages.</p>
+
+<h2 id="internals">Internals</h2>
+<p>This project is using <a href="https://github.com/lerna/lerna">lerna</a> to split up the
+client into different packages. This way we can have standalone codeable
+subprojects (<code class="highlighter-rouge">api</code>, <code class="highlighter-rouge">dom</code> and <code class="highlighter-rouge">node</code>) but still are able to control dependencies,
+build processes or release processes globally.</p>
+
+<p>Furthermore we use <a href="https://rollupjs.org/">rollup.js</a> for providing multiple
+module types of the packages, e.g. the <code class="highlighter-rouge">api</code> will be published as IIFE,
+ES Module and CommonJS module.</p>
+
+<p>For automatically generating barrel files, <a href="https://github.com/bencoveney/barrelsby">barrelsby</a>
+is used during the build process.</p>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+
+
+ </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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/client-sdk-overview.html b/2.0/client-sdk-overview.html
new file mode 100644
index 0000000..fcf2e37
--- /dev/null
+++ b/2.0/client-sdk-overview.html
@@ -0,0 +1,1795 @@
+<!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="client_sdk, ">
+<title> Client SDK overview • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Client SDK overview">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Client SDK</a>
+ <ul>
+
+
+
+ <li class="active"><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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Client SDK overview</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>Client SDK for Eclipse Ditto are API implementations in different programming languages.</p>
+
+<p>These SDKs make use of the <a href="protocol-specification.html">Ditto Protocol</a> to exchange messages with Eclipse Ditto.</p>
+
+<p>The following SDKs are supported:</p>
+
+<ul>
+ <li><a href="client-sdk-java.html">Java</a></li>
+ <li><a href="client-sdk-javascript.html">JavaScript</a></li>
+</ul>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+
+
+ </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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/connectivity-header-mapping.html b/2.0/connectivity-header-mapping.html
new file mode 100644
index 0000000..e8ba003
--- /dev/null
+++ b/2.0/connectivity-header-mapping.html
@@ -0,0 +1,1805 @@
+<!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="connectivity, header, mapping, placeholder">
+<title> Header mapping for connections • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Header mapping for connections">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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 class="active"><a href="connectivity-header-mapping.html">Header mapping</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Header mapping for connections</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>When receiving messages from external systems or sending messages to external systems, the external headers of the
+messages can be mapped to and from Ditto protocol headers.</p>
+
+<p>That way the headers can be passed through Ditto, or defined Ditto protocol headers like for example <code class="highlighter-rouge">correlation-id</code>
+may be mapped to a header used for message correlation in the external system.</p>
+
+<p>A header mapping can be defined individually for every source and target of a connection. For examples of a definition
+see <a href="basic-connections.html#source-header-mapping">source header mapping</a>
+and <a href="basic-connections.html#target-header-mapping">target header mapping</a>.</p>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Do not map headers prefixed by ‘ditto-‘. Ditto uses them internally. Setting them in header mapping has no effect.</div>
+
+<h2 id="supported-placeholders">Supported placeholders</h2>
+
+<p>The supported placeholders for header mapping are defined in the
+<a href="basic-placeholders.html#scope-connections">Placeholders - Scope: Connections</a> section.
+If a placeholder fails to resolve for a header value, then that header is not set. Placeholder resolution failure
+does not prevent sending of the message or setting other headers with resolved values.</p>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/connectivity-manage-connections.html b/2.0/connectivity-manage-connections.html
new file mode 100644
index 0000000..3d4a930
--- /dev/null
+++ b/2.0/connectivity-manage-connections.html
@@ -0,0 +1,2136 @@
+<!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="connectivity, ">
+<title> Manage connections • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Manage connections">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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 class="active"><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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Manage connections</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>In order to manage (CRUD) connections in Ditto <a href="installation-operating.html#devops-commands">DevOps commands</a>
+have to be used. There is no separate HTTP API for managing the connections, as this is not a task for a developer
+using the digital twin APIs but more for a “DevOps engineer” creating new connections to external systems.</p>
+
+<p>All connection related piggyback commands use the following HTTP endpoint:</p>
+
+<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>
+
+<ul>
+ <li><a href="#create-connection">create</a></li>
+ <li><a href="#modify-connection">modify</a></li>
+ <li><a href="#retrieve-connection">retrieve</a></li>
+ <li><a href="#delete-connection">delete</a></li>
+</ul>
+
+<h3 id="create-connection">Create connection</h3>
+
+<p>Create a new connection by sending the following DevOps command.</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/connection"</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="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">"connectivity.commands:createConnection"</span><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="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>The content of the connection configuration object is specified in the <a href="basic-connections.html">Connections section</a>.
+For protocol specific examples, consult the <a href="connectivity-protocol-bindings-amqp091.html">AMQP-0.9.1 binding</a>,
+<a href="connectivity-protocol-bindings-amqp10.html">AMQP-1.0 binding</a> or
+<a href="connectivity-protocol-bindings-mqtt.html">MQTT-3.1.1 binding</a> respectively.</p>
+
+<h3 id="modify-connection">Modify connection</h3>
+
+<p>Modify an existing connection by sending the following DevOps command.</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/connection"</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="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">"connectivity.commands:modifyConnection"</span><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="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>The connection with the specified ID needs to be created before one can modify it.</p>
+
+<h3 id="retrieve-connection">Retrieve connection</h3>
+
+<p>The only parameter necessary for retrieving a connection is the <code class="highlighter-rouge">connectionId</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/connection"</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="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">"connectivity.commands:retrieveConnection"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"connectionId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<connectionID>"</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="open-connection">Open connection</h3>
+
+<p>The only parameter necessary for opening a connection is the <code class="highlighter-rouge">connectionId</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/connection"</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="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">"connectivity.commands:openConnection"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"connectionId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<connectionID>"</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="close-connection">Close connection</h3>
+
+<p>The only parameter necessary for closing a connection is the <code class="highlighter-rouge">connectionId</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/connection"</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="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">"connectivity.commands:closeConnection"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"connectionId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<connectionID>"</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="delete-connection">Delete connection</h3>
+
+<p>The only parameter necessary for deleting a connection is the <code class="highlighter-rouge">connectionId</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/connection"</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="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">"connectivity.commands:deleteConnection"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"connectionId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<connectionID>"</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="helper-commands">Helper commands</h2>
+
+<p>The following commands are available to help creating connections and retrieving the status of existing connections:</p>
+
+<ul>
+ <li><a href="#test-connection">test connection</a></li>
+ <li><a href="#retrieve-ids-of-all-connections">retrieve ids of all connections</a></li>
+ <li><a href="#retrieve-connection-status">retrieve connection status</a></li>
+ <li><a href="#retrieve-connection-metrics">retrieve connection metrics</a></li>
+ <li><a href="#reset-connection-metrics">reset connection metrics</a></li>
+ <li><a href="#enable-connection-logs">enable connection logs</a></li>
+ <li><a href="#retrieve-connection-logs">retrieve connection logs</a></li>
+ <li><a href="#reset-connection-logs">reset connection logs</a></li>
+</ul>
+
+<h3 id="test-connection">Test connection</h3>
+
+<p>Run a test connection command before creating a persisted connection to validate the connection configuration. This
+command checks the configuration and establishes a connection to the remote endpoint in order to validate the connection
+credentials. The test connection is closed afterwards and will not be persisted. Analog to
+the <a href="#create-connection">createConnection</a>
+command, it requires a full connection configuration in the piggyback command.</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/connection"</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="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">"connectivity.commands:testConnection"</span><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="err">...</span><span class="w">
+ </span><span class="err">//Define</span><span class="w"> </span><span class="err">connection</span><span class="w"> </span><span class="err">configuration</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="retrieve-ids-of-all-connections">Retrieve ids of all connections</h3>
+
+<p>This command returns the ids of all connections.</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/connectivityRoot/connectionIdsRetrieval/singleton"</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="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">"connectivity.commands:retrieveAllConnectionIds"</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="retrieve-connection-status">Retrieve connection status</h3>
+
+<p>This command returns the connection status by showing if a connection is currently enabled/disabled and if it is
+successfully established. The only parameter necessary for retrieving the connection status is the <code class="highlighter-rouge">connectionId</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/connection"</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="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">"connectivity.commands:retrieveConnectionStatus"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"connectionId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<connectionID>"</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="retrieve-connection-metrics">Retrieve connection metrics</h3>
+
+<p>This command returns the connection metrics showing how many messages have been successfully or failingly <code class="highlighter-rouge">conusmed</code>,
+<code class="highlighter-rouge">filtered</code>, <code class="highlighter-rouge">mapped</code>, <code class="highlighter-rouge">published</code>, <code class="highlighter-rouge">dropped</code>. The metrics are collected and returned in different time intervals:</p>
+<ul>
+ <li>the last minute</li>
+ <li>the last hour</li>
+ <li>the last 24 hours</li>
+</ul>
+
+<p>The only parameter necessary for retrieving the connection metrics is the <code class="highlighter-rouge">connectionId</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/connection"</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="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">"connectivity.commands:retrieveConnectionMetrics"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"connectionId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<connectionID>"</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="reset-connection-metrics">Reset connection metrics</h3>
+
+<p>This command resets the connection metrics - all metrics are set to <code class="highlighter-rouge">0</code> again. The only parameter necessary for
+retrieving the connection metrics is the <code class="highlighter-rouge">connectionId</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/connection"</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="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">"connectivity.commands:resetConnectionMetrics"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"connectionId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<connectionID>"</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="enable-connection-logs">Enable connection logs</h3>
+
+<p>Enables the connection logging feature of a connection for 24 hours. As soon as connection logging is enabled, you will
+be able to <a href="#retrieve-connection-logs">retrieve connection logs</a>. The logs will contain a fixed amount of success and
+failure logs for each source and target of your connection and correlate with the metrics of the connection. This will
+allow you more insight in what goes well, and more importantly, what goes wrong.</p>
+
+<p>The default duration and the maximum amount of logs stored for one connection can be configured in Ditto’s connectivity
+service configuration.</p>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> When creating or opening an connection the logging is enabled per default. This allows
+to log possible errors on connection establishing.</div>
+
+<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/connection"</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="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">"connectivity.commands:enableConnectionLogs"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"connectionId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<connectionID>"</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="retrieve-connection-logs">Retrieve connection logs</h3>
+
+<p>This command will return a list of success and failure log entries containing information on messages processed by the
+connection. The logs have a maximum amount of entries that they can hold. If the connection produces more log entries,
+the older entries will be dropped. So keep in mind that you might miss some of the log entries.</p>
+
+<p>The response will also provide information on how long the logging feature will still be enabled. Since the timer will
+always be reset when retrieving the logs, the timestamp will always be 24 hours from now.</p>
+
+<p>The default duration and the maximum amount of logs stored for one connection can be configured in Ditto’s connectivity
+service configuration.</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/connection"</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="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">"connectivity.commands:retrieveConnectionLogs"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"connectionId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<connectionID>"</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="reset-connection-logs">Reset connection logs</h3>
+
+<p>Clears all currently stored connection logs.</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/connection"</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="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">"connectivity.commands:resetConnectionLogs"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"connectionId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<connectionID>"</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="payload-mapping-configuration">Payload mapping configuration</h2>
+
+<p>To enable a custom <a href="connectivity-mapping.html">payload mapping</a> for a specific source or target of a connection, you
+have to configure a payload mapping definition in the connection configuration object. The following snippet shows an
+example <code class="highlighter-rouge">mappingDefinitions</code>. This configuration must be embedded in the connection configuration as shown in the
+<a href="basic-connections.html">Connections</a> section. These payload mapping definitions are then referenced by its ID
+(the key of the JSON object) in the sources and targets of the connection using the field <code class="highlighter-rouge">payloadMapping</code>. If no
+payload mapping or definition is provided, the <a href="connectivity-mapping.html#ditto-mapper">Ditto message mapping</a>
+is used as the default.</p>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="err">...</span><span class="w">
+ </span><span class="s2">"mappingDefinitions"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"customJs"</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="err">(</span><span class="mi">1</span><span class="err">)</span><span class="w">
+ </span><span class="s2">"mappingEngine"</span><span class="p">:</span><span class="w"> </span><span class="s2">"JavaScript"</span><span class="p">,</span><span class="w">
+ </span><span class="err">//</span><span class="w"> </span><span class="err">(</span><span class="mi">2</span><span class="err">)</span><span class="w">
+ </span><span class="s2">"options"</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="err">(</span><span class="mi">3</span><span class="err">)</span><span class="w">
+ </span><span class="s2">"incomingScript"</span><span class="p">:</span><span class="w"> </span><span class="s2">".."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"outgoingScript"</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="p">}</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="s2">"source"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"payloadMapping"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"customJs"</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="err">...</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<ul>
+ <li>(1) This ID can be used in sources and targets of the connection to reference this payload mapping definition.</li>
+ <li>(2) The <code class="highlighter-rouge">mappingEngine</code> defines the underlying <code class="highlighter-rouge">MessageMapper</code> implementation.</li>
+ <li>(3) The <code class="highlighter-rouge">options</code> are used to configure the mapper instance to your needs.</li>
+</ul>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/connectivity-mapping.html b/2.0/connectivity-mapping.html
new file mode 100644
index 0000000..3a0e08f
--- /dev/null
+++ b/2.0/connectivity-mapping.html
@@ -0,0 +1,2733 @@
+<!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="connectivity, mapping, transformation, payload, javascript">
+<title> Payload mapping in connectivity service • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Payload mapping in connectivity service">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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 class="active"><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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Payload mapping in connectivity service</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"><strong>TL;DR</strong><br />The payload mapping feature in Ditto’s connectivity APIs can be used to
+ transform arbitrary payload consumed via the different supported protocols
+ to <a href="protocol-overview.html">Ditto Protocol</a> messages and vice versa.</div>
+
+<h2 id="motivation">Motivation</h2>
+
+<p>Eclipse Ditto is about providing access to IoT devices via the <a href="intro-digitaltwins.html">digital twin</a> pattern.
+In order to provide structured APIs for different heterogeneous devices Ditto defines a lightweight JSON based
+<a href="basic-overview.html">model</a>.</p>
+
+<p>A <a href="basic-thing.html">Thing</a> might look like in the following 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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"the.namespace:the-thing-id"</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">"the.namespace:the-policy-id"</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">"transmission"</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">"cur_speed"</span><span class="p">:</span><span class="w"> </span><span class="mi">90</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>Devices in the IoT, may they be brownfield devices or newly produced devices, will probably not send their data to the
+cloud in the structure and <a href="protocol-overview.html">protocol</a> Ditto requires.</p>
+
+<p>They should not need to be aware of something like Ditto running in the cloud mirroring them as digital twins.</p>
+
+<p>So for example device payload 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">"val"</span><span class="p">:</span><span class="w"> </span><span class="s2">"23.42 °C"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"ts"</span><span class="p">:</span><span class="w"> </span><span class="mi">1523946112727</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>In case of constrained devices or IoT protocols, even binary payload might be common.</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>0x08BD (hex representation)
+</code></pre></div></div>
+
+<h2 id="builtin-mappers">Builtin mappers</h2>
+
+<p>The following message mappers are included in the Ditto codebase:</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Mapper Alias</th>
+ <th>Description</th>
+ <th>Inbound</th>
+ <th>Outbound</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><a href="#ditto-mapper">Ditto</a></td>
+ <td>Assumes that inbound/outbound messages are already in <a href="protocol-overview.html">Ditto Protocol</a> (JSON) format.</td>
+ <td>✓</td>
+ <td>✓</td>
+ </tr>
+ <tr>
+ <td><a href="#javascript-mapper">JavaScript</a></td>
+ <td>Converts arbitrary messages from and to the <a href="protocol-overview.html">Ditto Protocol</a> format using <strong>custom</strong> JavaScript code executed by Ditto.</td>
+ <td>✓</td>
+ <td>✓</td>
+ </tr>
+ <tr>
+ <td><a href="#normalized-mapper">Normalized</a></td>
+ <td>Transforms the payload of events to a normalized view.</td>
+ <td> </td>
+ <td>✓</td>
+ </tr>
+ <tr>
+ <td><a href="#connectionstatus-mapper">ConnectionStatus</a></td>
+ <td>This mapper handles messages containing <code class="highlighter-rouge">creation-time</code> and <code class="highlighter-rouge">ttd</code> headers by updating a feature of the targeted thing with <a href="basic-feature.html#feature-definition">definition</a> <a href="https://vorto.eclipse.org/#/details/org.eclipse.ditto:ConnectionStatus:1.0.0">ConnectionStatus</a>.</td>
+ <td>✓</td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td><a href="#rawmessage-mapper">RawMessage</a></td>
+ <td>For outgoing message commands and responses, this mapper extracts the payload for publishing directly into the channel. For incoming messages, this mapper wraps them in a configured message command or response envelope.</td>
+ <td>✓</td>
+ <td>✓</td>
+ </tr>
+ <tr>
+ <td><a href="#implicitthingcreation-mapper">ImplicitThingCreation</a></td>
+ <td>This mapper handles messages for which a Thing should be created automatically based on a defined template</td>
+ <td>✓</td>
+ <td> </td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="ditto-mapper">Ditto mapper</h3>
+
+<p>This is the default <a href="protocol-overview.html">Ditto Protocol</a> mapper. If you do not specify any payload mapping this
+ mapper is used to map inbound and outbound messages. The mapper requires no mandatory options, so its alias can
+ be directly used as a mapper reference.</p>
+
+<p>It assumes that received messages are in <a href="protocol-specification.html">Ditto Protocol JSON</a> and emits outgoing messages
+ also in that format.</p>
+
+<h3 id="javascript-mapper">JavaScript mapper</h3>
+
+<p>This mapper may be used whenever any inbound messages are not yet in <a href="protocol-overview.html">Ditto Protocol</a>.
+By using the built in <a href="#javascript-mapping-engine">JavaScript mapping engine</a> (based on Rhino) custom defined
+JavaScript scripts can be executed which are responsible for creating <a href="protocol-specification.html">Ditto Protocol JSON</a>
+message from arbitrary consumed payload.</p>
+
+<p>The same is possible for outbound messages in order to transform <a href="protocol-specification.html">Ditto Protocol JSON</a>
+messages (e.g. events or responses) to arbitrary other formats.</p>
+
+<h4 id="configuration-options">Configuration options</h4>
+
+<ul>
+ <li><code class="highlighter-rouge">incomingScript</code> (required): the mapping script for incoming messages</li>
+ <li><code class="highlighter-rouge">outgoingScript</code> (required): the mapping script for outgoing messages</li>
+ <li><code class="highlighter-rouge">loadBytebufferJS</code> (optional, default: <code class="highlighter-rouge">"false"</code>): whether to load ByteBufferJS library</li>
+ <li><code class="highlighter-rouge">loadLongJS</code> (optional, default: <code class="highlighter-rouge">"false"</code>): whether to load LongJS library</li>
+</ul>
+
+<h3 id="normalized-mapper">Normalized mapper</h3>
+
+<p>This mapper transforms <code class="highlighter-rouge">created</code> and <code class="highlighter-rouge">modified</code> events (other type of messages are dropped) to a normalized view.
+Events are mapped to a nested sparse JSON.</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">"thing/id/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">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/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">"/features/sensors/properties/temperature/indoor/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="mi">42</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>would result in the following normalized JSON representation:</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">"thing:id"</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">"sensors"</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">"temperature"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"indoor"</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="mi">42</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">"_context"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"thing/id/things/twin/events/modified"</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/sensors/properties/temperature/indoor/value"</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/json"</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>The <code class="highlighter-rouge">_context</code> field contains the original message content excluding the <code class="highlighter-rouge">value</code>.</p>
+
+<h4 id="configuration-options-1">Configuration options</h4>
+
+<ul>
+ <li><code class="highlighter-rouge">fields</code> (optional, default: all fields): comma separated list of fields that are contained in the result (see also
+ chapter about <a href="httpapi-concepts.html#with-field-selector">field selectors</a>)</li>
+</ul>
+
+<h3 id="connectionstatus-mapper">ConnectionStatus mapper</h3>
+<p>This mapper transforms the information from the <code class="highlighter-rouge">ttd</code> and <code class="highlighter-rouge">creation-time</code> message headers
+(see Eclipse Hono <a href="https://www.eclipse.org/hono/docs/concepts/device-notifications/">device notifications</a>) into a
+ModifyFeature command that complies with the <a href="https://vorto.eclipse.org/#/details/org.eclipse.ditto:ConnectionStatus:1.0.0">Vorto functionblock</a> <code class="highlighter-rouge">org.eclipse.ditto:ConnectionStatus</code>.</p>
+
+<p>The connectivity state of the device is then represented in a Feature.<br />
+It is mostly used in conjunction with another mapper that transforms the payload e.g.:<br />
+<code class="highlighter-rouge">"payloadMapping": [ "Ditto" , "connectionStatus" ]</code></p>
+
+<p>Example of a resulting <code class="highlighter-rouge">ConnectionStatus</code> feature:</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">"eclipse:ditto"</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">"ConnectionStatus"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:ConnectionStatus:1.0.0"</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">"status"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"readySince"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2019-10-29T14:16:18Z"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"readyUntil"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2019-10-29T14:21:18Z"</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>
+
+<h4 id="configuration-options-2">Configuration options</h4>
+
+<ul>
+ <li><code class="highlighter-rouge">thingId</code> (required): The ID of the Thing that is updated with the connectivity state. It can either be a fixed value
+ or a header placeholder (e.g. <code class="highlighter-rouge">{{ header:device_id }}</code>).</li>
+ <li><code class="highlighter-rouge">featureId</code> (optional, default: <code class="highlighter-rouge">ConnectionStatus</code>): The ID of the Feature that is updated. It can either be a
+ fixed value or resolved from a message header (e.g. <code class="highlighter-rouge">{{ header:feature_id }}</code>).</li>
+</ul>
+
+<h3 id="rawmessage-mapper">RawMessage mapper</h3>
+
+<p>This mapper relates the payload in the <code class="highlighter-rouge">"value"</code> field of message commands and message responses to the payload
+of AMQP, MQTT and Kafka messages and the body of HTTP requests. The encoding of the payload is chosen according to
+the configured content type. The subject, direction, thing ID and feature ID of the envelope for incoming message
+commands and responses need to be configured.</p>
+
+<p>Messages with the Ditto protocol content type <code class="highlighter-rouge">application/vnd.eclipse.ditto+json</code> or signals that are not message
+commands or responses are mapped by the <a href="#ditto-mapper">Ditto mapper</a> instead.</p>
+
+<p>For example, the mapper maps between the feature message command response</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/smartcoffee/things/live/messages/heatUp"</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/octet-stream"</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/water-tank/inbox/messages/heatUp"</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">"AQIDBAUG"</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>
+<p>and an AMQP, MQTT 5, Kafka message with payload or an HTTP request with body of 6 bytes</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>0x01 02 03 04 05 06
+</code></pre></div></div>
+<p>and headers</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>content-type: application/octet-stream
+status: 200
+subject: heatUp
+ditto-message-direction: TO
+ditto-message-thing-id: org.eclipse.ditto:smartcoffee
+ditto-message-feature-id: water-tank
+</code></pre></div></div>
+<p>The headers are lost for connection protocols without application headers such as MQTT 3.</p>
+
+<h4 id="configuration-options-3">Configuration options</h4>
+
+<p>Example configuration:</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">"outgoingContentType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/octet-stream"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"incomingMessageHeaders"</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 | fn:default('application/octet-stream') }}"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"status"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ header:status }}"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"subject"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ header:subject | fn:default('fallback-subject') }}"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"ditto-message-direction"</span><span class="p">:</span><span class="w"> </span><span class="s2">"TO"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"ditto-message-thing-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ header:ditto-message-thing-id | fn:default('ns:fallback-thing') }}"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"ditto-message-feature-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ header:ditto-message-feature-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>
+
+<ul>
+ <li><code class="highlighter-rouge">outgoingContentType</code> (optional): The fallback content-type for outgoing message commands and responses without
+the content-type header. Default to <code class="highlighter-rouge">text/plain; charset=UTF-8</code>.</li>
+ <li><code class="highlighter-rouge">incomingMessageHeaders</code> (optional): A JSON object containing the following headers needed to construct a message
+command or response envelope containing the incoming message as payload in the field <code class="highlighter-rouge">"value"</code>.
+Placeholder expressions reading from the protocol headers of incoming messages may be used.
+ <ul>
+ <li><code class="highlighter-rouge">content-type</code> (optional): The content type with which to encode the incoming message as payload.
+Default to <code class="highlighter-rouge">{{ header:content-type | fn:default('application/octet-stream') }}</code>.
+If resolved to the Ditto protocol content type <code class="highlighter-rouge">application/vnd.eclipse.ditto+json</code>, then the entire payload
+is interpreted as a Ditto protocol message instead.</li>
+ <li><code class="highlighter-rouge">status</code> (optional): Include for message responses. Exclude for message commands. Default to
+<code class="highlighter-rouge">{{ header:status }}</code>.</li>
+ <li><code class="highlighter-rouge">subject</code> (mandatory for MQTT 3): Subject of the message. Default to <code class="highlighter-rouge">{{ header:subject }}</code>.
+ Mapping will fail if not resolvable.</li>
+ <li><code class="highlighter-rouge">ditto-message-direction</code> (optional): The message direction. Default to <code class="highlighter-rouge">TO</code>, which corresponds to <code class="highlighter-rouge">inbox</code> in
+ message commands and responses.</li>
+ <li><code class="highlighter-rouge">ditto-message-thing-id</code> (mandatory for MQTT 3): ID of the thing to send the message command or response to.
+Default to <code class="highlighter-rouge">{{ header:ditto-message-thing-id }}</code>. Mapping will fail if not resolvable.</li>
+ <li><code class="highlighter-rouge">ditto-message-feature-id</code> (optional): Include to send the message or message response to a feature of the thing.
+Exclude to send it to the thing itself. Default to <code class="highlighter-rouge">{{ header:ditto-message-feature-id }}</code>.</li>
+ </ul>
+ </li>
+</ul>
+
+<h3 id="implicitthingcreation-mapper">ImplicitThingCreation Mapper</h3>
+
+<p>This mapper implicitly creates a new thing for an incoming message.</p>
+
+<p>The created thing contains the values defined in the template, configured in the <code class="highlighter-rouge">mappingDefinitions</code> <code class="highlighter-rouge">options</code>.<br /></p>
+
+<h4 id="configuration-options-4">Configuration options</h4>
+
+<ul>
+ <li><code class="highlighter-rouge">thing</code> (required): The values of the thing that is created implicitly. It can either contain fixed values
+ or header placeholders (e.g. <code class="highlighter-rouge">{{ header:device_id }}</code>).</li>
+</ul>
+
+<p>Example of a template defined in <code class="highlighter-rouge">options</code>:</p>
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"thing"</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">"{{ header:device_id }}"</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">"CreatedBy"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ImplicitThingCreation"</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="example-connection-with-multiple-mappers">Example connection with multiple mappers</h2>
+
+<p>The following example connection defines a <code class="highlighter-rouge">ConnectionStatus</code> mapping with the ID <code class="highlighter-rouge">status</code> and references it in a
+ source.<br />
+ Messages received via this source will be mapped by the <code class="highlighter-rouge">Ditto</code> mapping and the <code class="highlighter-rouge">ConnectionStatus</code> mapping.<br />
+ The <code class="highlighter-rouge">Ditto</code> mapping requires no options to be configured, so you can directly use its alias <code class="highlighter-rouge">Ditto</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">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"exampleConnection"</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">"addresses"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"<source>"</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"</span><span class="p">],</span><span class="w">
+ </span><span class="s2">"payloadMapping"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"Ditto"</span><span class="p">,</span><span class="w"> </span><span class="s2">"status"</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">"mappingDefinitions"</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="p">{</span><span class="w">
+ </span><span class="s2">"mappingEngine"</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">"options"</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">"{{ header:device_id }}"</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="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Starting aliases with an uppercase character and IDs with a lowercase character is
+ encouraged to avoid confusion but this is not enforced. </div>
+
+<h2 id="example-connection-with-mapping-conditions">Example connection with mapping conditions</h2>
+
+<p>The following example connection defines <code class="highlighter-rouge">incomingConditions</code> and <code class="highlighter-rouge">outgoingConditions</code>for the ConnectionStatus
+mapping engine.<br />
+Optional incomingConditions are validated before the mapping of inbound messages.<br />
+Optional outgoingConditions are validated before the mapping of outbound messages.<br />
+Conditional Mapping can be achieved by using <a href="basic-placeholders.html#function-expressions">function expressions</a>.
+When multiple incoming or outgoing conditions are set for one <code class="highlighter-rouge">mappingEngine</code>,
+all have to equal true for the mapping to be executed.</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">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"exampleConnection"</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">"addresses"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"<source>"</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"</span><span class="p">],</span><span class="w">
+ </span><span class="s2">"payloadMapping"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"status"</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">"mappingDefinitions"</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="p">{</span><span class="w">
+ </span><span class="s2">"mappingEngine"</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">"incomingConditions"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"sampleCondition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"fn:filter(header:incoming-mapping-required,'eq','true')"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"outgoingConditions"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"sampleCondition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"fn:filter(header:outgoing-mapping-required,'eq','true')"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"options"</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">"{{ header:device_id }}"</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="javascript-mapping-engine">JavaScript mapping engine</h2>
+
+<p>Ditto utilizes the <a href="https://github.com/mozilla/rhino">Rhino</a> JavaScript engine for Java for evaluating the JavaScript
+to apply for mapping payloads.</p>
+
+<p>Using Rhino instead of Nashorn, the newer JavaScript engine shipped with Java, has the benefit that sandboxing can be
+applied in a better way.</p>
+
+<p>Sandboxing of different payload scripts is required as Ditto is intended to be run as cloud service where multiple
+connections to different endpoints are managed for different tenants at the same time. This requires the isolation of
+each single script to avoid interference with other scripts and to protect the JVM executing the script against harmful
+code execution.</p>
+
+<h3 id="constraints">Constraints</h3>
+
+<p>Rhino does not fully support EcmaScript 6. Check which language constructs are supported before using
+them in a mapping function. See <a href="http://mozilla.github.io/rhino/compat/engines.html">http://mozilla.github.io/rhino/compat/engines.html</a>.</p>
+
+<p>Ditto currently includes Rhino version <code class="highlighter-rouge">1.7.11</code> and has the <code class="highlighter-rouge">VERSION_ES6</code> flag enabled.</p>
+
+<h4 id="sandboxing">Sandboxing</h4>
+
+<p>For sandboxing/security reasons following restrictions apply:</p>
+
+<ul>
+ <li>access to Java packages and classes is not possible</li>
+ <li>using <code class="highlighter-rouge">exit</code>, <code class="highlighter-rouge">quit</code>, <code class="highlighter-rouge">print</code>, etc. is not possible</li>
+ <li>file access is not possible</li>
+ <li>doing remote calls (e.g. to foreign web-servers) is not possible</li>
+ <li>programming an endless-loop will terminate the script</li>
+ <li>programming a recursion will terminate the script</li>
+ <li>the file size of the script is limited</li>
+ <li>no foreign JS libraries can be loaded (unless they fit in the file size limit and are included into the mapping script)</li>
+</ul>
+
+<h3 id="helper-libraries">Helper libraries</h3>
+
+<p>In order to work more conveniently with binary payloads, the following libraries may be loaded for payload transformations:</p>
+
+<ul>
+ <li><a href="https://github.com/dcodeIO/bytebuffer.js">bytebuffer.js</a> a ByteBuffer implementation using ArrayBuffers</li>
+ <li><a href="https://github.com/dcodeIO/long.js">long.js</a> for representing a 64-bit two’s-complement integer value</li>
+</ul>
+
+<h3 id="helper-functions">Helper functions</h3>
+
+<p>Ditto comes with a few helper functions, which makes writing the mapping scripts easier. They are available under the
+<code class="highlighter-rouge">Ditto</code> scope:</p>
+
+<div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="cm">/**
+ * Builds a Ditto Protocol message from the passed parameters.
+ * @param {string} namespace - The namespace of the entity in java package notation, e.g.: "org.eclipse.ditto"
+ * @param {string} name - The name of the entity, e.g.: "device"
+ * @param {string} group - The affected group/entity, one of: "things"
+ * @param {string} channel - The channel for the signal, one of: "twin"|"live"
+ * @param {string} criterion - The criterion to apply, one of: "commands"|"events"|"search"|"messages"|"errors"
+ * @param {string} action - The action to perform, one of: "create"|"retrieve"|"modify"|"delete"
+ * @param {string} path - The path which is affected by the message, e.g.: "/attributes"
+ * @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. If setting a status code,
+ * the Ditto Protocol Message will be interpreted as a response (e.g. content will be ignored when using 204).
+ * @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">name</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="k">return</span> <span class="p">{</span>
+ <span class="na">topic</span><span class="p">:</span> <span class="nx">namespace</span> <span class="o">+</span> <span class="s2">"/"</span> <span class="o">+</span> <span class="nx">name</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>
+ <span class="na">path</span><span class="p">:</span> <span class="nx">path</span><span class="p">,</span>
+ <span class="na">headers</span><span class="p">:</span> <span class="nx">dittoHeaders</span><span class="p">,</span>
+ <span class="na">value</span><span class="p">:</span> <span class="nx">value</span><span class="p">,</span>
+ <span class="na">status</span><span class="p">:</span> <span class="nx">status</span><span class="p">,</span>
+ <span class="na">extra</span><span class="p">:</span> <span class="nx">extra</span><span class="p">,</span>
+ <span class="p">};</span>
+<span class="p">}</span>
+
+<span class="cm">/**
+ * Builds an external message from the passed parameters.
+ * @param {Object.<string, string>} headers - The external headers Object containing header values
+ * @param {string} [textPayload] - The external mapped String
+ * @param {ArrayBuffer} [bytePayload] - The external mapped bytes as ArrayBuffer
+ * @param {string} [contentType] - The returned Content-Type
+ * @returns {ExternalMessage} externalMessage -
+ * the mapped external message
+ * or <code>null</code> if the message could/should not be mapped
+ */</span>
+<span class="kd">function</span> <span class="nx">buildExternalMsg</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="k">return</span> <span class="p">{</span>
+ <span class="na">headers</span><span class="p">:</span> <span class="nx">headers</span><span class="p">,</span>
+ <span class="na">textPayload</span><span class="p">:</span> <span class="nx">textPayload</span><span class="p">,</span>
+ <span class="na">bytePayload</span><span class="p">:</span> <span class="nx">bytePayload</span><span class="p">,</span>
+ <span class="na">contentType</span><span class="p">:</span> <span class="nx">contentType</span><span class="p">,</span>
+ <span class="p">};</span>
+<span class="p">}</span>
+
+<span class="cm">/**
+ * Transforms the passed ArrayBuffer to a String interpreting the content of the passed arrayBuffer as unsigned 8
+ * bit integers.
+ *
+ * @param {ArrayBuffer} arrayBuffer the ArrayBuffer to transform to a String
+ * @returns {String} the transformed String
+ */</span>
+<span class="kd">function</span> <span class="nx">arrayBufferToString</span><span class="p">(</span><span class="nx">arrayBuffer</span><span class="p">)</span> <span class="p">{</span>
+
+ <span class="k">return</span> <span class="nb">String</span><span class="p">.</span><span class="nx">fromCharCode</span><span class="p">.</span><span class="nx">apply</span><span class="p">(</span><span class="kc">null</span><span class="p">,</span> <span class="k">new</span> <span class="nb">Uint8Array</span><span class="p">(</span><span class="nx">arrayBuffer</span><span class="p">));</span>
+<span class="p">}</span>
+
+<span class="cm">/**
+ * Transforms the passed String to an ArrayBuffer using unsigned 8 bit integers.
+ *
+ * @param {String} string the String to transform to an ArrayBuffer
+ * @returns {ArrayBuffer} the transformed ArrayBuffer
+ */</span>
+<span class="kd">function</span> <span class="nx">stringToArrayBuffer</span><span class="p">(</span><span class="nx">string</span><span class="p">)</span> <span class="p">{</span>
+
+ <span class="kd">let</span> <span class="nx">buf</span> <span class="o">=</span> <span class="k">new</span> <span class="nb">ArrayBuffer</span><span class="p">(</span><span class="nx">string</span><span class="p">.</span><span class="nx">length</span><span class="p">);</span>
+ <span class="kd">let</span> <span class="nx">bufView</span> <span class="o">=</span> <span class="k">new</span> <span class="nb">Uint8Array</span><span class="p">(</span><span class="nx">buf</span><span class="p">);</span>
+ <span class="k">for</span> <span class="p">(</span><span class="kd">let</span> <span class="nx">i</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="nx">strLen</span><span class="o">=</span><span class="nx">string</span><span class="p">.</span><span class="nx">length</span><span class="p">;</span> <span class="nx">i</span><span class="o"><</span><span class="nx">strLen</span><span class="p">;</span> <span class="nx">i</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span>
+ <span class="nx">bufView</span><span class="p">[</span><span class="nx">i</span><span class="p">]</span> <span class="o">=</span> <span class="nx">string</span><span class="p">.</span><span class="nx">charCodeAt</span><span class="p">(</span><span class="nx">i</span><span class="p">);</span>
+ <span class="p">}</span>
+ <span class="k">return</span> <span class="nx">buf</span><span class="p">;</span>
+<span class="p">}</span>
+
+<span class="cm">/**
+ * Transforms the passed ArrayBuffer to a {ByteBuffer} (from bytebuffer.js library which needs to be loaded).
+ *
+ * @param {ArrayBuffer} arrayBuffer the ArrayBuffer to transform
+ * @returns {ByteBuffer} the transformed ByteBuffer
+ */</span>
+<span class="kd">function</span> <span class="nx">asByteBuffer</span><span class="p">(</span><span class="nx">arrayBuffer</span><span class="p">)</span> <span class="p">{</span>
+
+ <span class="kd">let</span> <span class="nx">byteBuffer</span> <span class="o">=</span> <span class="k">new</span> <span class="nb">ArrayBuffer</span><span class="p">(</span><span class="nx">arrayBuffer</span><span class="p">.</span><span class="nx">byteLength</span><span class="p">);</span>
+ <span class="k">new</span> <span class="nb">Uint8Array</span><span class="p">(</span><span class="nx">byteBuffer</span><span class="p">).</span><span class="kd">set</span><span class="p">(</span><span class="k">new</span> <span class="nb">Uint8Array</span><span class="p">(</span><span class="nx">arrayBuffer</span><span class="p">));</span>
+ <span class="k">return</span> <span class="nx">dcodeIO</span><span class="p">.</span><span class="nx">ByteBuffer</span><span class="p">.</span><span class="nx">wrap</span><span class="p">(</span><span class="nx">byteBuffer</span><span class="p">);</span>
+<span class="p">}</span>
+</code></pre></div></div>
+
+<h3 id="mapping-incoming-messages">Mapping incoming messages</h3>
+
+<p>Incoming external messages can be mapped to Ditto Protocol conform messages by implementing the following JavaScript function:</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="c1">// ### Insert/adapt your mapping logic here.</span>
+ <span class="c1">// Use helper function Ditto.buildDittoProtocolMsg to build Ditto protocol message</span>
+ <span class="c1">// based on incoming payload.</span>
+ <span class="c1">// See https://www.eclipse.org/ditto/connectivity-mapping.html#helper-functions for details.</span>
+ <span class="c1">// ### example code assuming the Ditto protocol content type for incoming messages.</span>
+ <span class="k">if</span> <span class="p">(</span><span class="nx">contentType</span> <span class="o">===</span> <span class="s1">'application/vnd.eclipse.ditto+json'</span><span class="p">)</span> <span class="p">{</span>
+ <span class="c1">// Message is sent as Ditto protocol text payload and can be used directly</span>
+ <span class="k">return</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="p">}</span> <span class="k">else</span> <span class="k">if</span> <span class="p">(</span><span class="nx">contentType</span> <span class="o">===</span> <span class="s1">'application/octet-stream'</span><span class="p">)</span> <span class="p">{</span>
+ <span class="c1">// Message is sent as binary payload; assume Ditto protocol message (JSON).</span>
+ <span class="k">try</span> <span class="p">{</span>
+ <span class="k">return</span> <span class="nx">JSON</span><span class="p">.</span><span class="nx">parse</span><span class="p">(</span><span class="nx">Ditto</span><span class="p">.</span><span class="nx">arrayBufferToString</span><span class="p">(</span><span class="nx">bytePayload</span><span class="p">));</span>
+ <span class="p">}</span> <span class="k">catch</span> <span class="p">(</span><span class="nx">e</span><span class="p">)</span> <span class="p">{</span>
+ <span class="c1">// parsing failed (no JSON document); return null to drop the message</span>
+ <span class="k">return</span> <span class="kc">null</span><span class="p">;</span>
+ <span class="p">}</span>
+ <span class="p">}</span>
+ <span class="c1">// no mapping logic matched; return null to drop the message</span>
+ <span class="k">return</span> <span class="kc">null</span><span class="p">;</span>
+<span class="p">}</span>
+</code></pre></div></div>
+
+<p>The result of the function has to be a JavaScript object in <a href="protocol-overview.html">Ditto Protocol</a> or an array of
+such JavaScript objects. That’s where the helper method <code class="highlighter-rouge">Ditto.buildDittoProtocolMsg</code> is useful: it explicitly
+defines which parameters are required for the Ditto Protocol message.</p>
+
+<h3 id="mapping-outgoing-messages">Mapping outgoing messages</h3>
+
+<p>Outgoing Ditto Protocol messages (e.g. <a href="basic-signals-commandresponse.html">responses</a> or <a href="basic-signals-event.html">events</a>)
+can be mapped to external messages by implementing the following JavaScript function:</p>
+
+<div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="cm">/**
+ * Maps the passed parameters which originated from a Ditto Protocol message to an external message.
+ * @param {string} namespace - The namespace of the entity in java package notation, e.g.: "org.eclipse.ditto"
+ * @param {string} name - The name of the entity, e.g.: "device"
+ * @param {string} channel - The channel for the signal, one of: "twin"|"live"
+ * @param {string} group - The affected group/entity, one of: "things"
+ * @param {string} criterion - The criterion to apply, one of: "commands"|"events"|"search"|"messages"|"errors"
+ * @param {string} action - The action to perform, one of: "create"|"retrieve"|"modify"|"delete"
+ * @param {string} path - The path which is affected by the message, e.g.: "/attributes"
+ * @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. When this field is set,
+ * it indicates that the Ditto Protocol Message contains a response.
+ * @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
+ * <code>null</code> if the message could/should not be mapped
+ */</span>
+<span class="kd">function</span> <span class="nx">mapFromDittoProtocolMsg</span><span class="p">(</span>
+ <span class="nx">namespace</span><span class="p">,</span>
+ <span class="nx">name</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="c1">// ###</span>
+ <span class="c1">// Insert your mapping logic here</span>
+ <span class="c1">// ### example code using the Ditto protocol content type.</span>
+ <span class="kd">let</span> <span class="nx">headers</span> <span class="o">=</span> <span class="nx">dittoHeaders</span><span class="p">;</span>
+ <span class="kd">let</span> <span class="nx">textPayload</span> <span class="o">=</span> <span class="nx">JSON</span><span class="p">.</span><span class="nx">stringify</span><span class="p">(</span><span class="nx">Ditto</span><span class="p">.</span><span class="nx">buildDittoProtocolMsg</span><span class="p">(</span><span class="nx">namespace</span><span class="p">,</span> <span class="nx">name</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="kd">let</span> <span class="nx">bytePayload</span> <span class="o">=</span> <span class="kc">null</span><span class="p">;</span>
+ <span class="kd">let</span> <span class="nx">contentType</span> <span class="o">=</span> <span class="s1">'application/vnd.eclipse.ditto+json'</span><span class="p">;</span>
+ <span class="k">return</span> <span class="nx">Ditto</span><span class="p">.</span><span class="nx">buildExternalMsg</span><span class="p">(</span>
+ <span class="nx">headers</span><span class="p">,</span> <span class="c1">// The external headers Object containing header values</span>
+ <span class="nx">textPayload</span><span class="p">,</span> <span class="c1">// The external mapped String</span>
+ <span class="nx">bytePayload</span><span class="p">,</span> <span class="c1">// The external mapped byte[]</span>
+ <span class="nx">contentType</span> <span class="c1">// The returned Content-Type</span>
+ <span class="p">);</span>
+<span class="p">}</span>
+</code></pre></div></div>
+
+<p>The result of the function has to be a JavaScript object or an array of JavaScript objects with the fields <code class="highlighter-rouge">headers</code>,
+<code class="highlighter-rouge">textPayload</code>, <code class="highlighter-rouge">bytePayload</code> and <code class="highlighter-rouge">contentType</code>. That’s where the helper method <code class="highlighter-rouge">Ditto.buildExternalMsg</code> is useful: it
+explicitly defines which parameters are required for the external message.</p>
+
+<h2 id="javascript-payload-types">JavaScript payload types</h2>
+
+<p>Both, text payloads and byte payloads may be mapped.</p>
+
+<h3 id="text-payloads">Text payloads</h3>
+
+<p>Working with text payloads is as easy as it gets in JavaScript. For example, for the content-type <code class="highlighter-rouge">application/json</code>
+structured data may be processed like this:</p>
+
+<div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">let</span> <span class="nx">value</span><span class="p">;</span>
+<span class="k">if</span> <span class="p">(</span><span class="nx">contentType</span> <span class="o">===</span> <span class="s1">'application/json'</span><span class="p">)</span> <span class="p">{</span>
+ <span class="kd">let</span> <span class="nx">parsedJson</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="nx">value</span> <span class="o">=</span> <span class="nx">parsedJson</span><span class="p">.</span><span class="nx">number1</span> <span class="o">+</span> <span class="nx">parsedJson</span><span class="p">[</span><span class="s1">'sub-field'</span><span class="p">];</span> <span class="c1">// remember to access JSON keys with dashes in a JS special way</span>
+<span class="p">}</span> <span class="k">else</span> <span class="p">{</span>
+ <span class="c1">// a script may decide to not map other content-types than application/json</span>
+ <span class="k">return</span> <span class="kc">null</span><span class="p">;</span>
+<span class="p">}</span>
+<span class="c1">// proceed ...</span>
+</code></pre></div></div>
+
+<h3 id="byte-payloads">Byte payloads</h3>
+
+<p>Working with byte payloads is also possible but does require a little bit of knowledge about JavaScipt’s
+<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer">ArrayBuffer</a>
+<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray">TypedArrays</a> and
+<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView">DataView</a>.</p>
+
+<p>What you get in the mapping scripts is a <code class="highlighter-rouge">bytePayload</code> of type <code class="highlighter-rouge">ArrayBuffer</code> which lets you work on the bytes
+in different ways:</p>
+
+<h4 id="typed-arrays">Typed Arrays</h4>
+
+<blockquote>
+ <p>A TypedArray [is] a view into an ArrayBuffer where every item has the same size and type.<br /> <a href="https://hacks.mozilla.org/2017/01/typedarray-or-dataview-understanding-byte-order/">source</a></p>
+</blockquote>
+
+<p>With TypedArrays you can simply wrap the <code class="highlighter-rouge">bytePayload</code> <code class="highlighter-rouge">ArrayBuffer</code> and work on all the items e.g.
+as unsigned 8-bit integers:</p>
+
+<div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">let</span> <span class="nx">bytes</span> <span class="o">=</span> <span class="k">new</span> <span class="nb">Uint8Array</span><span class="p">(</span><span class="nx">bytePayload</span><span class="p">);</span>
+<span class="nx">bytes</span><span class="p">[</span><span class="mi">0</span><span class="p">];</span> <span class="c1">// access the first byte</span>
+<span class="nx">bytes</span><span class="p">[</span><span class="mi">1</span><span class="p">];</span> <span class="c1">// access the second byte</span>
+</code></pre></div></div>
+
+<h4 id="dataviews">DataViews</h4>
+
+<blockquote>
+ <p>The DataView [is] another view into an ArrayBuffer, but one which allows items of different size and type in the ArrayBuffer.<br /> <a href="https://hacks.mozilla.org/2017/01/typedarray-or-dataview-understanding-byte-order/">source</a></p>
+</blockquote>
+
+<div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">let</span> <span class="nx">view</span> <span class="o">=</span> <span class="k">new</span> <span class="nb">DataView</span><span class="p">(</span><span class="nx">bytePayload</span><span class="p">);</span>
+<span class="nx">view</span><span class="p">.</span><span class="nx">getInt8</span><span class="p">(</span><span class="mi">0</span><span class="p">);</span> <span class="c1">// access a 8-bit signed integer (byte) on offset=0</span>
+<span class="nx">view</span><span class="p">.</span><span class="nx">getUint16</span><span class="p">(</span><span class="mi">1</span><span class="p">);</span> <span class="c1">// access a 16-bit unsigned integer (usigned short) on offset=1</span>
+</code></pre></div></div>
+
+<p>DataViews also allow to <code class="highlighter-rouge">set</code> bytes to an underlying ArrayBuffer conveniently.</p>
+
+<h4 id="bytebufferjs">ByteBuffer.js</h4>
+
+<p>Alternatively, Ditto’s JavaScript transformation may be loaded with the <a href="#helper-libraries">above mentioned</a> libraries,
+e.g. “bytebuffer.js”.<br />
+With <code class="highlighter-rouge">ByteBuffer</code>, the content of an <code class="highlighter-rouge">ArrayBuffer</code> can be accessed in a buffered way:</p>
+
+<div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">let</span> <span class="nx">byteBuf</span> <span class="o">=</span> <span class="nx">Ditto</span><span class="p">.</span><span class="nx">asByteBuffer</span><span class="p">(</span><span class="nx">bytePayload</span><span class="p">);</span>
+<span class="kd">let</span> <span class="nx">numberFromBytes</span> <span class="o">=</span> <span class="nb">parseInt</span><span class="p">(</span><span class="nx">byteBuf</span><span class="p">.</span><span class="nx">toHex</span><span class="p">(),</span> <span class="mi">16</span><span class="p">);</span>
+
+<span class="kd">let</span> <span class="nx">base64encoded</span> <span class="o">=</span> <span class="nx">byteBuf</span><span class="p">.</span><span class="nx">toBase64</span><span class="p">();</span>
+<span class="kd">let</span> <span class="nx">buf</span> <span class="o">=</span> <span class="nx">dcodeIO</span><span class="p">.</span><span class="nx">ByteBuffer</span><span class="p">.</span><span class="nx">fromBase64</span><span class="p">(</span><span class="nx">base64encoded</span><span class="p">);</span>
+
+<span class="nx">buf</span><span class="p">.</span><span class="nx">readInt</span><span class="p">();</span> <span class="c1">// read a 32bit signed integer + advances the offset in the buffer</span>
+<span class="nx">buf</span><span class="p">.</span><span class="nx">readUTF8String</span><span class="p">(</span><span class="mi">4</span><span class="p">);</span> <span class="c1">// read 4 characters of UTF-8 encoded string + advances the offset in the buffer</span>
+<span class="nx">buf</span><span class="p">.</span><span class="nx">remaining</span><span class="p">();</span> <span class="c1">// gets the number of remaining readable bytes in the buffer</span>
+</code></pre></div></div>
+
+<p>Check the <a href="https://github.com/dcodeIO/bytebuffer.js/wiki/API">ByteBuffer API documentation</a> to find out what is possible
+with that helper.</p>
+
+<h2 id="javascript-examples">JavaScript Examples</h2>
+
+<h3 id="text-payload-example">Text payload example</h3>
+
+<p>Let’s assume your device sends telemetry data via <a href="https://www.eclipse.org/hono/">Eclipse Hono’s</a> MQTT adapter
+into the cloud. And that an example payload of your device is:</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">"temp"</span><span class="p">:</span><span class="w"> </span><span class="s2">"23.42 °C"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"hum"</span><span class="p">:</span><span class="w"> </span><span class="mi">78</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"pres"</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="mi">760</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">"mmHg"</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>We want to map a single message of this device containing updates for all 3 values to a Thing in the following structure:</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">"the.namespace:the-thing-id"</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">"the.namespace:the-policy-id"</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="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="mi">760</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="mi">78</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>Therefore, we define following <code class="highlighter-rouge">incoming</code> mapping function:</p>
+
+<div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><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="k">if</span> <span class="p">(</span><span class="nx">contentType</span> <span class="o">!==</span> <span class="s1">'application/json'</span><span class="p">)</span> <span class="p">{</span>
+ <span class="k">return</span> <span class="kc">null</span><span class="p">;</span> <span class="c1">// only handle messages with content-type application/json</span>
+ <span class="p">}</span>
+
+ <span class="kd">let</span> <span class="nx">jsonData</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="kd">let</span> <span class="nx">value</span> <span class="o">=</span> <span class="p">{</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">jsonData</span><span class="p">.</span><span class="nx">temp</span><span class="p">.</span><span class="nx">split</span><span class="p">(</span><span class="s2">" "</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span> <span class="c1">// omit the unit</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">jsonData</span><span class="p">.</span><span class="nx">pres</span><span class="p">.</span><span class="nx">value</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">jsonData</span><span class="p">.</span><span class="nx">hum</span>
+ <span class="p">}</span>
+ <span class="p">}</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'</span><span class="p">,</span> <span class="c1">// in this example always the same</span>
+ <span class="nx">headers</span><span class="p">[</span><span class="s1">'device_id'</span><span class="p">],</span> <span class="c1">// Eclipse Hono sets the authenticated device_id as AMQP 1.0 header</span>
+ <span class="s1">'things'</span><span class="p">,</span> <span class="c1">// we deal with a Thing</span>
+ <span class="s1">'twin'</span><span class="p">,</span> <span class="c1">// we want to update the twin</span>
+ <span class="s1">'commands'</span><span class="p">,</span> <span class="c1">// we want to create a command to update a twin</span>
+ <span class="s1">'modify'</span><span class="p">,</span> <span class="c1">// modify the twin</span>
+ <span class="s1">'/features'</span><span class="p">,</span> <span class="c1">// modify all features at once</span>
+ <span class="nx">headers</span><span class="p">,</span> <span class="c1">// pass through the headers from AMQP 1.0</span>
+ <span class="nx">value</span>
+ <span class="p">);</span>
+<span class="p">}</span>
+</code></pre></div></div>
+
+<p>When your device now sends its payload via the MQTT adapter of Eclipse Hono:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>mosquitto_pub <span class="nt">-u</span> <span class="s1">'sensor1@DEFAULT_TENANT'</span> <span class="nt">-P</span> hono-secret <span class="nt">-t</span> telemetry <span class="nt">-m</span> <span class="s1">'{"temp": "23.42 °C","hum": 78,"pres": {"value": 760,"unit": "mmHg"}}'</span>
+</code></pre></div></div>
+
+<p>Your digital twin is updated by applying the specified script and extracting the relevant values from the passed <code class="highlighter-rouge">textPayload</code>.</p>
+
+<h3 id="bytes-payload-example">Bytes payload example</h3>
+
+<p>For this example, let’s assume your device sends telemetry data via <a href="https://www.eclipse.org/hono/">Eclipse Hono’s</a>
+HTTP adapter into the cloud. An example payload of your device - displayed as hexadecimal - is:</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>0x09EF03F72A
+</code></pre></div></div>
+
+<p>Let us now also assume that</p>
+
+<ul>
+ <li>the first 2 bytes <code class="highlighter-rouge">09 EF</code> represent
+ <ul>
+ <li>the temperature as 16bit signed integer (thus, may also be negative)</li>
+ <li>this is not a float in oder to save space (as float needs at least 32 bit)</li>
+ </ul>
+ </li>
+ <li>the second 2 bytes <code class="highlighter-rouge">03 F7</code> represent the pressure as 16bit signed integer</li>
+ <li>the last byte <code class="highlighter-rouge">2A</code> represents the humidity as 8bit unsigned integer of our device.</li>
+</ul>
+
+<p>We want to map a single message of this device containing updates for all 3 values to a Thing in the following structure:</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">"the.namespace:the-thing-id"</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">"the.namespace:the-policy-id"</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">25.43</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="mi">1015</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="mi">42</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>Therefore, we define following <code class="highlighter-rouge">incoming</code> mapping function:</p>
+
+<div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><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="k">if</span> <span class="p">(</span><span class="nx">contentType</span> <span class="o">!==</span> <span class="s1">'application/octet-stream'</span><span class="p">)</span> <span class="p">{</span>
+ <span class="k">return</span> <span class="kc">null</span><span class="p">;</span> <span class="c1">// only handle messages with content-type application/octet-stream</span>
+ <span class="p">}</span>
+
+ <span class="kd">let</span> <span class="nx">view</span> <span class="o">=</span> <span class="k">new</span> <span class="nb">DataView</span><span class="p">(</span><span class="nx">bytePayload</span><span class="p">);</span>
+
+ <span class="kd">let</span> <span class="nx">value</span> <span class="o">=</span> <span class="p">{</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="c1">// interpret the first 2 bytes (16 bit) as signed int and divide through 100.0:</span>
+ <span class="na">value</span><span class="p">:</span> <span class="nx">view</span><span class="p">.</span><span class="nx">getInt16</span><span class="p">(</span><span class="mi">0</span><span class="p">)</span> <span class="o">/</span> <span class="mf">100.0</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="c1">// interpret the next 2 bytes (16 bit) as signed int:</span>
+ <span class="na">value</span><span class="p">:</span> <span class="nx">view</span><span class="p">.</span><span class="nx">getInt16</span><span class="p">(</span><span class="mi">2</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="c1">// interpret the next 1 bytes (8 bit) as unsigned int:</span>
+ <span class="na">value</span><span class="p">:</span> <span class="nx">view</span><span class="p">.</span><span class="nx">getUint8</span><span class="p">(</span><span class="mi">4</span><span class="p">)</span>
+ <span class="p">}</span>
+ <span class="p">}</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'</span><span class="p">,</span> <span class="c1">// in this example always the same</span>
+ <span class="nx">headers</span><span class="p">[</span><span class="s1">'device_id'</span><span class="p">],</span> <span class="c1">// Eclipse Hono sets the authenticated device_id as AMQP 1.0 header</span>
+ <span class="s1">'things'</span><span class="p">,</span> <span class="c1">// we deal with a Thing</span>
+ <span class="s1">'twin'</span><span class="p">,</span> <span class="c1">// we want to update the twin</span>
+ <span class="s1">'commands'</span><span class="p">,</span> <span class="c1">// we want to create a command to update a twin</span>
+ <span class="s1">'modify'</span><span class="p">,</span> <span class="c1">// modify the twin</span>
+ <span class="s1">'/features'</span><span class="p">,</span> <span class="c1">// modify all features at once</span>
+ <span class="nx">headers</span><span class="p">,</span> <span class="c1">// pass through the headers from AMQP 1.0</span>
+ <span class="nx">value</span>
+ <span class="p">);</span>
+<span class="p">}</span>
+</code></pre></div></div>
+
+<p>When your device now sends its payload via the HTTP adapter of Eclipse Hono:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nb">echo</span> <span class="nt">-e</span> <span class="k">$((</span><span class="m">0</span>x09EF03F72A<span class="k">))</span> | curl <span class="nt">-i</span> <span class="nt">-X</span> POST <span class="nt">-u</span> sensor1@DEFAULT_TENANT:hono-secret <span class="nt">-H</span> <span class="s1">'Content-Type: application/octet-stream'</span> <span class="nt">--data-binary</span> @- http://127.0.0.1:8080/telemetry
+</code></pre></div></div>
+
+<p>Your digital twin is updated by applying the specified script and extracting the relevant values from the passed <code class="highlighter-rouge">bytePayload</code>.</p>
+
+<h2 id="custom-java-based-implementation">Custom Java based implementation</h2>
+
+<p>Beside the JavaScript based mapping - which can be configured/changed at runtime without the need of restarting the
+connectivity service - there is also the possibility to implement a custom Java based mapper.</p>
+
+<p>The interface to be implemented is <code class="highlighter-rouge">org.eclipse.ditto.connectivity.service.mapping.MessageMapper</code> (<a href="https://github.com/eclipse/ditto/blob/master/connectivity/service/mapping/src/main/java/org/eclipse/ditto/connectivity/service/mapping/MessageMapper.java">find the source here</a>)
+with the following signature to implement (this is only for experts, the sources contain JavaDoc):</p>
+
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">interface</span> <span class="nc">MessageMapper</span> <span class="o">{</span>
+
+ <span class="kt">void</span> <span class="nf">configure</span><span class="o">(</span><span class="n">MessageMapperConfiguration</span> <span class="n">configuration</span><span class="o">);</span>
+
+ <span class="n">List</span><span class="o"><</span><span class="n">Adaptable</span><span class="o">></span> <span class="nf">map</span><span class="o">(</span><span class="n">ExternalMessage</span> <span class="n">message</span><span class="o">);</span>
+
+ <span class="n">List</span><span class="o"><</span><span class="n">ExternalMessage</span><span class="o">></span> <span class="nf">map</span><span class="o">(</span><span class="n">Adaptable</span> <span class="n">adaptable</span><span class="o">);</span>
+<span class="o">}</span>
+</code></pre></div></div>
+
+<p>After instantiation of the custom <code class="highlighter-rouge">MessageMapper</code>, the <code class="highlighter-rouge">configure</code> method is called with all the <em>options</em> which were
+provided to the mapper in the <a href="connectivity-manage-connections.html#create-connection">configured connection</a>.
+Use them in order to pass in configurations, thresholds, etc.</p>
+
+<p>Then, simply implement both of the <code class="highlighter-rouge">map</code> methods:</p>
+
+<ul>
+ <li><code class="highlighter-rouge">List<Adaptable> map(ExternalMessage message)</code> maps from an incoming external message to
+ <ul>
+ <li>an empty list of <code class="highlighter-rouge">Adaptable</code>s if the incoming message should be dropped</li>
+ <li>a list of one or many <a href="protocol-overview.html">Ditto Protocol</a> <code class="highlighter-rouge">Adaptable</code>s</li>
+ </ul>
+ </li>
+ <li><code class="highlighter-rouge">List<ExternalMessage> map(Adaptable adaptable)</code> maps from an outgoing <a href="protocol-overview.html">Ditto Protocol</a> <code class="highlighter-rouge">Adaptable</code> to
+ <ul>
+ <li>an empty list of <code class="highlighter-rouge">ExternalMessage</code>s if the outgoing message should be dropped</li>
+ <li>a list of one or many external messages</li>
+ </ul>
+ </li>
+</ul>
+
+<p>In order to use this custom Java based mapper implementation, the following steps are required:</p>
+
+<ul>
+ <li>the implementing Class must be annotated with <code class="highlighter-rouge">@PayloadMapper(alias="customMapper")</code> and define at least one alias</li>
+ <li>if the custom mapper requires mandatory options then specify <code class="highlighter-rouge">@PayloadMapper(alias="customMapper", requiresMandatoryConfiguration=true)</code></li>
+ <li>the Class needs obviously to be on the classpath of the <a href="architecture-services-connectivity.html">connectivity</a> microservice
+in order to be loaded</li>
+ <li>when creating a new connection you have to specify the alias of your mapper as the <code class="highlighter-rouge">mappingEngine</code> in the
+connection’s <code class="highlighter-rouge">mappingDefinitions</code> and reference the ID of your mapper in a source or a target</li>
+</ul>
+
+<div class="alert alert-success" role="alert"><i class="fa fa-check-square-o"></i> <b>Tip:</b> If your mapper does not require any options (<code class="highlighter-rouge">requiresMandatoryConfiguration=false</code>), you can
+ directly reference the alias in a source or a target without first defining it inside <code class="highlighter-rouge">mappingDefinitions</code>.</div>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/connectivity-overview.html b/2.0/connectivity-overview.html
new file mode 100644
index 0000000..12d2651
--- /dev/null
+++ b/2.0/connectivity-overview.html
@@ -0,0 +1,1808 @@
+<!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="connectivity, ">
+<title> Connectivity API overview • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Connectivity API overview">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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 class="active"><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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Connectivity API overview</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>The Connectivity API is a bare management API for Ditto’s <a href="architecture-services-connectivity.html">Connectivity Service</a>.
+It completely depends on <a href="installation-operating.html#devops-commands">DevOps Commands</a> for
+<a href="basic-connections.html">connection</a> management.</p>
+
+<p>Use it to manage client connections to remote systems and to exchange
+<a href="protocol-specification.html">Ditto Protocol</a> messages with those.
+If a remote system is unable to send messages in the necessary format, there is the option
+to configure custom <a href="connectivity-mapping.html">payload mapping logic</a> to adapt to almost any message format and
+encoding.</p>
+
+<p>The following connection types are supported:</p>
+
+<ul>
+ <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>
+
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/connectivity-protocol-bindings-amqp091.html b/2.0/connectivity-protocol-bindings-amqp091.html
new file mode 100644
index 0000000..dc2fe01
--- /dev/null
+++ b/2.0/connectivity-protocol-bindings-amqp091.html
@@ -0,0 +1,1953 @@
+<!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="protocolconnectivityrql, binding, protocol, amqp, amqp091, rabbitmq">
+<title> AMQP 0.9.1 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="AMQP 0.9.1 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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 class="active"><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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">AMQP 0.9.1 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 AMQP 0.9.1 brokers via <a href="#source-format">sources</a> and send messages to AMQP 0.9.1 brokers via
+<a href="#target-format">targets</a>.</p>
+
+<h2 id="content-type">Content-type</h2>
+
+<p>When messages are sent in <a href="protocol-overview.html">Ditto Protocol</a> (as <code class="highlighter-rouge">UTF-8</code> encoded String payload),
+the <code class="highlighter-rouge">content-type</code> of AMQP 0.9.1 messages must be set to:</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>application/vnd.eclipse.ditto+json
+</code></pre></div></div>
+
+<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 AMQP 0.9.1 connection in order to transform the messages.</p>
+
+<h2 id="amqp-091-properties">AMQP 0.9.1 properties</h2>
+
+<p>Supported AMQP 0.9.1 properties which are interpreted in a specific way are:</p>
+
+<ul>
+ <li><code class="highlighter-rouge">content-type</code>: for defining the Ditto Protocol content-type</li>
+ <li><code class="highlighter-rouge">correlation-id</code>: for correlating request messages to responses</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 AMQP 0.9.1 connections:</p>
+
+<h3 id="source-format">Source format</h3>
+
+<p>An AMQP 0.9.1 connection requires the protocol configuration source object to have an <code class="highlighter-rouge">addresses</code> property with a list
+of queue names, and <code class="highlighter-rouge">authorizationContext</code> array that contains the authorization subjects, in whose context
+incoming 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.</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">"addresses"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"<queue_name>"</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="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h4 id="source-acknowledgement-handling">Source acknowledgement handling</h4>
+
+<p>For AMQP 0.9.1 sources, when configuring
+<a href="basic-connections.html#source-acknowledgement-requests">acknowledgement requests</a>, consumed messages from the AMQP 0.9.1
+broker are treated in the following way:</p>
+
+<p>For Ditto acknowledgements with successful <a href="protocol-specification-acks.html#combined-status-code">status</a>:</p>
+<ul>
+ <li>Acknowledges a single AMQP 0.9.1 message with an <code class="highlighter-rouge">Ack</code> message for the received <code class="highlighter-rouge">deliveryTag</code></li>
+</ul>
+
+<p>For Ditto acknowledgements with mixed successful/failed <a href="protocol-specification-acks.html#combined-status-code">status</a>:</p>
+<ul>
+ <li>If some of the aggregated <a href="basic-acknowledgements.html#acknowledgements-acks">acknowledgements</a> require redelivery (e.g. based on a timeout):
+ <ul>
+ <li>Negatively acknowledges the AMQP 0.9.1 message with a <code class="highlighter-rouge">Nack</code> message for the received <code class="highlighter-rouge">deliveryTag</code> and setting <code class="highlighter-rouge">requeue</code> to <code class="highlighter-rouge">true</code></li>
+ </ul>
+ </li>
+ <li>If none of the aggregated <a href="basic-acknowledgements.html#acknowledgements-acks">acknowledgements</a> require redelivery:
+ <ul>
+ <li>Negatively acknowledges the AMQP 0.9.1 message with a <code class="highlighter-rouge">Nack</code> message for the received <code class="highlighter-rouge">deliveryTag</code> and setting <code class="highlighter-rouge">requeue</code> to <code class="highlighter-rouge">false</code> preventing redelivery by the AMQP 0.9.1 broker</li>
+ </ul>
+ </li>
+</ul>
+
+<h3 id="target-format">Target format</h3>
+
+<p>An AMQP 0.9.1 connection requires the protocol configuration target object to have an <code class="highlighter-rouge">address</code> property with a combined
+value of the <code class="highlighter-rouge">exchange_name</code> and <code class="highlighter-rouge">routing_key</code>. 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, which is associated with 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">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<exchange_name>/<routing_key>"</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="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h4 id="target-acknowledgement-handling">Target acknowledgement handling</h4>
+
+<p>For AMQP 0.9.1 targets, when configuring
+<a href="basic-connections.html#target-issued-acknowledgement-label">automatically issued acknowledgement labels</a>, requested
+acknowledgements are produced in the following way:</p>
+
+<p>Once the AMQP 0.9.1 client signals that the message was acknowledged by the AMQP 0.9.1 broker, the following information
+is mapped to the automatically created <a href="protocol-specification-acks.html#acknowledgement">acknowledgement</a>:</p>
+<ul>
+ <li>Acknowledgement.status:
+ <ul>
+ <li>will be <code class="highlighter-rouge">200</code>, if the message was successfully ACKed by the AMQP 0.9.1 broker</li>
+ <li>will be <code class="highlighter-rouge">400</code>, if the AMQP 0.9.1 broker does not support publisher confirms</li>
+ <li>will be <code class="highlighter-rouge">503</code>, if the AMQP 0.9.1 broker negatively confirmed receiving a message</li>
+ </ul>
+ </li>
+ <li>Acknowledgement.value:
+ <ul>
+ <li>will be missing, for status <code class="highlighter-rouge">200</code></li>
+ <li>will contain more information, in case that an error <code class="highlighter-rouge">status</code> was set</li>
+ </ul>
+ </li>
+</ul>
+
+<h3 id="specific-configuration-properties">Specific configuration properties</h3>
+
+<p>There are no specific configuration properties available for this type of connection.</p>
+
+<h2 id="establishing-connecting-to-an-amqp-091-endpoint">Establishing connecting to an AMQP 0.9.1 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 connection configuration to create a new AMQP 0.9.1 connection (e.g. in order to connect to a RabbitMQ):</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">"rabbit-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">"amqp-091"</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">"amqp://user:password@localhost:5672/vhost"</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">"queueName"</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="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">"exchangeName/routingKey"</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="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">
+
+ <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>
+
+
+
+ <a href="tag_rql.html" class="btn btn-default navbar-btn cursorNorm" role="button">rql</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/connectivity-protocol-bindings-amqp10.html b/2.0/connectivity-protocol-bindings-amqp10.html
new file mode 100644
index 0000000..9bcbf72
--- /dev/null
+++ b/2.0/connectivity-protocol-bindings-amqp10.html
@@ -0,0 +1,1999 @@
+<!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="protocolconnectivityrql, binding, protocol, amqp, amqp10">
+<title> AMQP 1.0 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="AMQP 1.0 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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 class="active"><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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">AMQP 1.0 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 AMQP 1.0 endpoints via <a href="#source-format">sources</a> and send messages to AMQP 1.0 endpoints via
+<a href="#target-format">targets</a>.</p>
+
+<h2 id="content-type">Content-type</h2>
+
+<p>When messages are sent in <a href="protocol-overview.html">Ditto Protocol</a> (as <code class="highlighter-rouge">UTF-8</code> encoded String payload),
+the <code class="highlighter-rouge">content-type</code> of AMQP 1.0 messages must be set to:</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>application/vnd.eclipse.ditto+json
+</code></pre></div></div>
+
+<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 AMQP 1.0 connection in order to transform the messages.</p>
+
+<h2 id="amqp-10-properties-and-application-properties">AMQP 1.0 properties and application properties</h2>
+
+<p>When set as external headers by outgoing payload or header mapping, the properties defined by AMQP 1.0 specification are
+set to the corresponding header value. Conversely, the values of AMQP 1.0 properties are available for incoming payload
+and header mapping as external headers. The supported AMQP 1.0 properties are:</p>
+
+<ul>
+ <li><code class="highlighter-rouge">message-id</code></li>
+ <li><code class="highlighter-rouge">user-id</code></li>
+ <li><code class="highlighter-rouge">to</code></li>
+ <li><code class="highlighter-rouge">subject</code></li>
+ <li><code class="highlighter-rouge">reply-to</code></li>
+ <li><code class="highlighter-rouge">correlation-id</code></li>
+ <li><code class="highlighter-rouge">content-type</code></li>
+ <li><code class="highlighter-rouge">absolute-expiry-time</code></li>
+ <li><code class="highlighter-rouge">creation-time</code></li>
+ <li><code class="highlighter-rouge">group-id</code></li>
+ <li><code class="highlighter-rouge">group-sequence</code></li>
+ <li><code class="highlighter-rouge">reply-to-group-id</code></li>
+</ul>
+
+<p>External headers not on this list are mapped to AMQP application properties.
+To set an application property whose name is identical to an AMQP 1.0 property, prefix it by
+<code class="highlighter-rouge">amqp.application.property:</code>. The following <a href="basic-connections.html#target-header-mapping">target header mapping</a> sets
+the application property <code class="highlighter-rouge">to</code> to the value of the Ditto protocol header <code class="highlighter-rouge">reply-to</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">"headerMapping"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"amqp.application.property:to"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ header:reply-to }}"</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>To read an application property whose name is identical to an AMQP 1.0 property, prefix it by
+<code class="highlighter-rouge">amqp.application.property:</code>. The following <a href="basic-connections.html#source-header-mapping">source header mapping</a> sets
+the Ditto protocol header <code class="highlighter-rouge">reply-to</code> to the value of the application property <code class="highlighter-rouge">to</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">"headerMapping"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"reply-to"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ header:amqp.application.property:to }}"</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="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> For now, setting or reading the AMQP 1.0 property ‘content-encoding’ is impossible.</div>
+
+<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 AMQP 1.0 connections:</p>
+
+<h3 id="source-format">Source format</h3>
+
+<p>Any <code class="highlighter-rouge">source</code> item defines an <code class="highlighter-rouge">addresses</code> array of source identifiers (e.g. Eclipse Hono’s
+Telemetry API) to consume messages from,
+and <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.</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">"addresses"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"<source>"</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="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h4 id="source-acknowledgement-handling">Source acknowledgement handling</h4>
+
+<p>For AMQP 1.0 sources, when configuring
+<a href="basic-connections.html#source-acknowledgement-requests">acknowledgement requests</a>, consumed messages from the AMQP 1.0
+endpoint are treated in the following way:</p>
+
+<p>For Ditto acknowledgements with successful <a href="protocol-specification-acks.html#combined-status-code">status</a>:</p>
+<ul>
+ <li>Acknowledges the AMQP 1.0 message with <code class="highlighter-rouge">accepted</code> outcome (see <a href="http://docs.oasis-open.org/amqp/core/v1.0/os/amqp-core-messaging-v1.0-os.html#type-accepted">AMQP 1.0 spec: 3.4.2 Accepted</a>)</li>
+</ul>
+
+<p>For Ditto acknowledgements with mixed successful/failed <a href="protocol-specification-acks.html#combined-status-code">status</a>:</p>
+<ul>
+ <li>If some of the aggregated <a href="basic-acknowledgements.html#acknowledgements-acks">acknowledgements</a> require redelivery (e.g. based on a timeout):
+ <ul>
+ <li>Negatively acknowledges the AMQP 1.0 message with <code class="highlighter-rouge">modified[delivery-failed]</code> outcome (see <a href="http://docs.oasis-open.org/amqp/core/v1.0/os/amqp-core-messaging-v1.0-os.html#type-modified">AMQP 1.0 spec: 3.4.5 Modified</a>)</li>
+ </ul>
+ </li>
+ <li>If none of the aggregated <a href="basic-acknowledgements.html#acknowledgements-acks">acknowledgements</a> require redelivery:
+ <ul>
+ <li>Negatively acknowledges the AMQP 1.0 message with <code class="highlighter-rouge">rejected</code> outcome (see <a href="http://docs.oasis-open.org/amqp/core/v1.0/os/amqp-core-messaging-v1.0-os.html#type-rejected">AMQP 1.0 spec: 3.4.3 Rejected</a>) preventing redelivery by the AMQP 1.0 endpoint</li>
+ </ul>
+ </li>
+</ul>
+
+<h3 id="target-format">Target format</h3>
+
+<p>An AMQP 1.0 connection requires the protocol configuration target object to have an <code class="highlighter-rouge">address</code> property with a source
+identifier. The target address may contain placeholders; see
+<a href="basic-connections.html#placeholder-for-target-addresses">placeholders</a> section for more
+information.</p>
+
+<p>Target addresses for AMQP 1.0 are by default handled as AMQP 1.0 “queues”. There is however the possibility to also
+configure AMQP 1.0 “topics” as well. In fact, the following formats for the <code class="highlighter-rouge">address</code> are
+supported:</p>
+<ul>
+ <li><code class="highlighter-rouge">the-queue-name</code> (when configuring w/o prefix, the <code class="highlighter-rouge">address</code> is handled as “queue”)</li>
+ <li><code class="highlighter-rouge">queue://the-queue-name</code></li>
+ <li><code class="highlighter-rouge">topic://the-topic-name</code></li>
+</ul>
+
+<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>, see
+<a href="basic-connections.html#target-topics-and-filtering">target topics and filtering</a> for more information on that.</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, which is associated with 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">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<target>"</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="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h4 id="target-acknowledgement-handling">Target acknowledgement handling</h4>
+
+<p>For AMQP 1.0 targets, when configuring
+<a href="basic-connections.html#target-issued-acknowledgement-label">automatically issued acknowledgement labels</a>, requested
+acknowledgements are produced in the following way:</p>
+
+<p>Once the AMQP 1.0 client signals that the message was acknowledged by the AMQP 1.0 endpoint, the following information
+is mapped to the automatically created <a href="protocol-specification-acks.html#acknowledgement">acknowledgement</a>:</p>
+
+<ul>
+ <li>Acknowledgement.status:
+ <ul>
+ <li>will be <code class="highlighter-rouge">200</code>, if the message was successfully consumed by the AMQP 1.0 endpoint</li>
+ <li>will be <code class="highlighter-rouge">5xx</code>, if the AMQP 1.0 endpoint failed in consuming the message, retrying sending the message is feasible</li>
+ </ul>
+ </li>
+ <li>Acknowledgement.value:
+ <ul>
+ <li>will be missing, for status <code class="highlighter-rouge">200</code></li>
+ <li>will contain more information, in case that an error <code class="highlighter-rouge">status</code> was set</li>
+ </ul>
+ </li>
+</ul>
+
+<h3 id="specific-configuration-properties">Specific configuration properties</h3>
+
+<p>The specific configuration properties are interpreted as
+<a href="https://qpid.apache.org/releases/qpid-jms-0.40.0/docs/index.html#jms-configuration-options">JMS Configuration options</a>.
+Use these to customize and tweak your connection as needed.</p>
+
+<h2 id="establishing-connecting-to-an-amqp-10-endpoint">Establishing connecting to an AMQP 1.0 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 connection configuration to create a new AMQP 1.0 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">"hono-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">"amqp-10"</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">"amqps://user:password@hono.eclipse.org:5671"</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">"telemetry/FOO"</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="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">"events/twin"</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="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>
+
+
+
+ <a href="tag_rql.html" class="btn btn-default navbar-btn cursorNorm" role="button">rql</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/connectivity-protocol-bindings-http.html b/2.0/connectivity-protocol-bindings-http.html
new file mode 100644
index 0000000..bd85484
--- /dev/null
+++ b/2.0/connectivity-protocol-bindings-http.html
@@ -0,0 +1,2006 @@
+<!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="protocolconnectivityrql, binding, protocol, http">
+<title> HTTP 1.1 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="HTTP 1.1 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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 class="active"><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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">HTTP 1.1 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>Perform HTTP request (with verbs POST, PUT, PATCH) to HTTP endpoints via <a href="#target-format">targets</a>.</p>
+
+<h2 id="specific-connection-configuration">Specific connection configuration</h2>
+
+<p>The common configuration for connections in <a href="basic-connections.html#targets">Connections > Targets</a> applies here
+as well. Following are some specifics for HTTP connections:</p>
+
+<h3 id="source-format">Source format</h3>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> HTTP connections currently don’t support sources - the HTTP integration may only be used for pushing data out.</div>
+
+<h3 id="target-format">Target format</h3>
+
+<p>A HTTP connection requires the protocol configuration target object to have an <code class="highlighter-rouge">address</code> property.
+This property has the following format: <code class="highlighter-rouge"><http_verb>:<http_path></code></p>
+
+<p>The supported HTTP <code class="highlighter-rouge"><http_verb></code> values are:</p>
+<ul>
+ <li>POST</li>
+ <li>PUT</li>
+ <li>PATCH</li>
+</ul>
+
+<p>The specified <code class="highlighter-rouge"><http_path></code> contains the path - including optionally potential query parameters - to be appended to the
+configured <code class="highlighter-rouge">uri</code> of the connection.</p>
+
+<p>The body of the HTTP request is either the outgoing <a href="protocol-specification.html">Ditto Protocol</a> message (e.g. an event)
+or - if a <a href="connectivity-mapping.html">payload mapping</a> was specified in the connection - a transformed body.</p>
+
+<p>The target address may contain placeholders; see
+<a href="basic-connections.html#placeholder-for-target-addresses">placeholders</a> section for more information.</p>
+
+<p>The target may define a <a href="connectivity-header-mapping.html">header mapping</a> specifying which additional HTTP headers to
+send along with the performed HTTP requests.</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>, see
+<a href="basic-connections.html#target-topics-and-filtering">target topics and filtering</a> for more information on that.</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, which is associated with 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">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<http_verb>:<http_path>"</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">"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">"application/json"</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>
+
+<h4 id="target-acknowledgement-handling">Target acknowledgement handling</h4>
+
+<p>For HTTP targets, whenever a message is published to the HTTP endpoint, you have two different options in order to
+acknowledge receiving the message:</p>
+
+<h5 id="explicitly-responding-with-ditto-protocol-acknowledgement-message">Explicitly responding with Ditto Protocol acknowledgement message</h5>
+
+<p>Whenever an HTTP endpoint, which received a message
+<a href="basic-acknowledgements.html#requesting-acks">requesting acknowledgements</a>,
+responds with a <a href="protocol-specification-acks.html#acknowledgement">Ditto Protocol Acknowledgement</a> and sets the
+<code class="highlighter-rouge">Content-Type</code> header of the HTTP response to <code class="highlighter-rouge">application/vnd.eclipse.ditto+json</code>, this received message is treated
+as custom <a href="basic-acknowledgements.html">acknowledgement</a>.</p>
+
+<p>This however is only the case if no
+<a href="basic-connections.html#target-issued-acknowledgement-label">automatically issued acknowledgement label</a> was configured
+for that target (see section below). If such an issued acknowledgement label was configured, this one always gets
+issued instead of a custom sent back Ditto Protocol Acknowledgement.</p>
+
+<h5 id="implicitly-create-acknowledgement-from-http-response">Implicitly create acknowledgement from HTTP response</h5>
+
+<p>When for the target an
+<a href="basic-connections.html#target-issued-acknowledgement-label">automatically issued acknowledgement label</a> was configured
+and the HTTP response was not a Ditto Protocol message (with Content-Type header <code class="highlighter-rouge">application/vnd.eclipse.ditto+json</code>),
+an acknowledgement is produced automatically in the following way:</p>
+
+<p>The HTTP response and following HTTP response information is mapped to the
+automatically created <a href="protocol-specification-acks.html#acknowledgement">acknowledgement</a>:</p>
+<ul>
+ <li><code class="highlighter-rouge">Acknowledgement.headers</code>: the HTTP response headers are added.</li>
+ <li><code class="highlighter-rouge">Acknowledgement.status</code>: the HTTP response status code is used.</li>
+ <li><code class="highlighter-rouge">Acknowledgement.value</code>: the HTTP response body is used - if the response body was of
+<code class="highlighter-rouge">content-type: application/json</code>, the JSON is inlined into the acknowledgement, otherwise the payload is added as
+JSON string.</li>
+</ul>
+
+<h4 id="responding-to-messages">Responding to messages</h4>
+
+<p>For <a href="basic-messages.html">live messages</a> that are published via an HTTP target you have two different options to
+respond to that message:</p>
+
+<h5 id="explicitly-responding-with-ditto-protocol-message-response">Explicitly responding with Ditto Protocol message response</h5>
+
+<p>Whenever an HTTP endpoint, which received a <a href="basic-messages.html">live message</a>,
+responds with a <a href="protocol-specification-things-messages.html#responding-to-a-message">Ditto Protocol Message Response</a>
+and sets the <code class="highlighter-rouge">Content-Type</code> header of the HTTP response to <code class="highlighter-rouge">application/vnd.eclipse.ditto+json</code>, this received message
+is treated as custom <a href="basic-messages.html#responding-to-messages">live message response</a>.</p>
+
+<p>In this case, the <code class="highlighter-rouge">correlation-id</code>, <code class="highlighter-rouge">thing-id</code> and potentially <code class="highlighter-rouge">feature-id</code> of the response have to match the
+message properties to respond to.</p>
+
+<h5 id="implicitly-responding-via-http-response">Implicitly responding via HTTP response</h5>
+
+<p>When for the target an
+<a href="basic-connections.html#target-issued-acknowledgement-label">automatically issued acknowledgement label</a> with the label
+<code class="highlighter-rouge">live-response</code> was configured and the HTTP response was not a Ditto Protocol message
+(with Content-Type header <code class="highlighter-rouge">application/vnd.eclipse.ditto+json</code>), a message response is produced automatically in the
+following way:</p>
+
+<p>The HTTP response and following HTTP response information is mapped to the
+automatically created <a href="protocol-specification-things-messages.html#responding-to-a-message">message response</a>:</p>
+<ul>
+ <li><code class="highlighter-rouge">Message.headers</code>: the HTTP response headers are added.</li>
+ <li><code class="highlighter-rouge">Message.status</code>: the HTTP response status code is used.</li>
+ <li><code class="highlighter-rouge">Message.value</code>: the HTTP response body is used - if the response body was of
+<code class="highlighter-rouge">content-type: application/json</code>, the JSON is inlined into the acknowledgement, otherwise the payload is added as
+JSON string.</li>
+</ul>
+
+<h3 id="specific-configuration-properties">Specific configuration properties</h3>
+
+<p>The specific configuration properties contain the following optional keys:</p>
+<ul>
+ <li><code class="highlighter-rouge">parallelism</code> (optional): Configures how many parallel requests per connection to perform, each takes one outgoing
+TCP connection. Default (if not provided): 1</li>
+</ul>
+
+<h2 id="establishing-connecting-to-an-http-endpoint">Establishing connecting to an HTTP 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 connection configuration to create a new HTTP connection in order to make request to an HTTP endpoint:</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">"http://user:password@localhost:80"</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>
+
+<h3 id="client-certificate-authentication">Client-certificate authentication</h3>
+
+<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">
+
+ <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>
+
+
+
+ <a href="tag_rql.html" class="btn btn-default navbar-btn cursorNorm" role="button">rql</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/connectivity-protocol-bindings-kafka2.html b/2.0/connectivity-protocol-bindings-kafka2.html
new file mode 100644
index 0000000..c35a8fa
--- /dev/null
+++ b/2.0/connectivity-protocol-bindings-kafka2.html
@@ -0,0 +1,1931 @@
+<!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="protocolconnectivityrql, binding, protocol, kafka, kafka2">
+<title> Apache Kafka 2.x 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Apache Kafka 2.x 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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 class="active"><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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Apache Kafka 2.x 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>Send messages to Apache Kafka via <a href="#target-format">targets</a>.</p>
+
+<h2 id="content-type">Content-type</h2>
+
+<p>When Kafka 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="specific-connection-configuration">Specific connection configuration</h2>
+
+<p>The common configuration for connections in <a href="basic-connections.html#targets">Connections > Targets</a> applies here
+as well. Following are some specifics for Apache Kafka 2.x connections:</p>
+
+<h3 id="source-format">Source format</h3>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Connecting to Kafka and consuming from topics via sources is not yet supported by Ditto.</div>
+
+<h3 id="target-format">Target format</h3>
+
+<p>A Kafka 2.x connection requires the protocol configuration target object to have an <code class="highlighter-rouge">address</code> property.
+This property may have different formats:</p>
+
+<ul>
+ <li><code class="highlighter-rouge">topic</code>: Contains a Kafka topic - a partition will be assigned in a round-robin fashion.</li>
+ <li><code class="highlighter-rouge">topic/key</code>: Contains a Kafka topic and a key - Kafka ensures that messages with the same key end up in the same partition.</li>
+ <li><code class="highlighter-rouge">topic#partitionNumber</code>: Contains a Kafka topic and a specific partition number - that partition will be used when sending records.</li>
+</ul>
+
+<p>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>, see
+<a href="basic-connections.html#target-topics-and-filtering">target topics and filtering</a> for more information on that.</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, which is associated with 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">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<kafka_topic>/<kafka_key>"</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="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h4 id="target-acknowledgement-handling">Target acknowledgement handling</h4>
+
+<p>For Kafka targets, when configuring
+<a href="basic-connections.html#target-issued-acknowledgement-label">automatically issued acknowledgement labels</a>, requested
+acknowledgements are produced in the following way:</p>
+
+<p>Once the Kafka client signals that the message was acknowledged by the Kafka broker, the following information is mapped
+to the automatically created <a href="protocol-specification-acks.html#acknowledgement">acknowledement</a>:</p>
+<ul>
+ <li>Acknowledgement.status:
+ <ul>
+ <li>will be <code class="highlighter-rouge">204</code>, if Kafka debug mode was disabled and the message was successfully consumed by Kafka</li>
+ <li>will be <code class="highlighter-rouge">200</code>, if Kafka debug mode was enabled (see <a href="#specific-configuration-properties">specific config</a> <code class="highlighter-rouge">"debugEnabled"</code>) and the message was successfully consumed by Kafka</li>
+ <li>will be <code class="highlighter-rouge">4xx</code>, if Kafka failed to consume the message but retrying sending the message does not make sense</li>
+ <li>will be <code class="highlighter-rouge">5xx</code>, if Kafka failed to consume the message but retrying sending the message is feasible</li>
+ </ul>
+ </li>
+ <li>Acknowledgement.value:
+ <ul>
+ <li>will be missing, if Kafka debug mode (see <a href="#specific-configuration-properties">specific config</a> <code class="highlighter-rouge">"debugEnabled"</code>) was disabled</li>
+ <li>will include the Kafka <code class="highlighter-rouge">RecordMetadata</code> as JsonObject:
+ <ul>
+ <li><code class="highlighter-rouge">timestamp</code> (if present)</li>
+ <li><code class="highlighter-rouge">serializedKeySize</code></li>
+ <li><code class="highlighter-rouge">serializedValueSize</code></li>
+ <li><code class="highlighter-rouge">topic</code></li>
+ <li><code class="highlighter-rouge">partition</code></li>
+ <li><code class="highlighter-rouge">offset</code> (if present)</li>
+ </ul>
+ </li>
+ </ul>
+ </li>
+</ul>
+
+<h3 id="specific-configuration-properties">Specific configuration properties</h3>
+
+<p>The specific configuration properties contain the following keys:</p>
+<ul>
+ <li><code class="highlighter-rouge">bootstrapServers</code> (required): contains a comma separated list of Kafka bootstrap servers to use for connecting to
+(in addition to the still required connection uri)</li>
+ <li><code class="highlighter-rouge">saslMechanism</code> (required if connection uri contains username\/password): contains one of the following SASL mechanisms to use for authentication at Kafka:
+ <ul>
+ <li><code class="highlighter-rouge">plain</code></li>
+ <li><code class="highlighter-rouge">scram-sha-256</code></li>
+ <li><code class="highlighter-rouge">scram-sha-512</code></li>
+ </ul>
+ </li>
+ <li><code class="highlighter-rouge">debugEnabled</code>: determines whether for acknowledgements
+<a href="#target-acknowledgement-handling">automatically issued by Kafka targets</a> additional debug information should be
+included as payload or not - default: <code class="highlighter-rouge">false</code></li>
+</ul>
+
+<h2 id="establishing-connecting-to-an-apache-kafka-endpoint">Establishing connecting to an Apache Kafka 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 connection configuration to create a new Kafka 2.x connection in order to connect to a running Apache Kafka server:</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">"kafka-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">"kafka"</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://user:password@localhost:9092"</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">"bootstrapServers"</span><span class="p">:</span><span class="w"> </span><span class="s2">"localhost:9092,other.host:9092"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"saslMechanism"</span><span class="p">:</span><span class="w"> </span><span class="s2">"plain"</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">"topic/key"</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="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">
+
+ <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>
+
+
+
+ <a href="tag_rql.html" class="btn btn-default navbar-btn cursorNorm" role="button">rql</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/connectivity-protocol-bindings-mqtt.html b/2.0/connectivity-protocol-bindings-mqtt.html
new file mode 100644
index 0000000..dafa671
--- /dev/null
+++ b/2.0/connectivity-protocol-bindings-mqtt.html
@@ -0,0 +1,2183 @@
+<!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">
+<title> MQTT 3.1.1 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 3.1.1 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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 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>
+
+
+
+
+
+
+ <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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">MQTT 3.1.1 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 brokers via <a href="#source-format">sources</a> and send messages to MQTT 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-311-properties">MQTT 3.1.1 properties</h2>
+
+<p>MQTT 3.1.1 messages have no application headers. Transmission-relevant properties are set in the
+<code class="highlighter-rouge">"headers"</code> field as a part of <a href="protocol-specification.html#dittoProtocolEnvelope">Ditto protocol messages</a> in the
+payload.</p>
+
+<p>This property is supported:</p>
+
+<ul>
+ <li><code class="highlighter-rouge">correlation-id</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.</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.</p>
+
+<p>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> may <em>not</em> contain placeholders <code class="highlighter-rouge">{{ header:<header-name> }}</code> as MQTT 3.1.1
+has no application headers.</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; <a href="https://docs.aws.amazon.com/iot/">AWS IoT</a> for example does not
+acknowledge subscriptions with <code class="highlighter-rouge">qos=2</code>.</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>
+
+<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>MQTT 3.1.1 does not support headers in its protocol, however Ditto extracts the following headers from each consumed message:</p>
+<ul>
+ <li><code class="highlighter-rouge">mqtt.topic</code>: contains the MQTT topic on which a message was received</li>
+ <li><code class="highlighter-rouge">mqtt.qos</code>: contains the MQTT QoS value of a received message</li>
+ <li><code class="highlighter-rouge">mqtt.retain</code>: contains the MQTT retain flag of a received message</li>
+</ul>
+
+<p>These headers may be used in a source header mapping, e.g.:</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">"headerMapping"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ header:mqtt.topic }}"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"the-qos"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ header:mqtt.qos }}"</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>
+
+<h4 id="source-acknowledgement-handling">Source acknowledgement handling</h4>
+
+<p>For MQTT 3.1.1 sources, when configuring
+<a href="basic-connections.html#source-acknowledgement-requests">acknowledgement requests</a>, consumed messages from the MQTT 3.1.1
+broker are treated in the following way:</p>
+
+<p>For Ditto acknowledgements with successful <a href="protocol-specification-acks.html#combined-status-code">status</a>:</p>
+<ul>
+ <li>Acknowledges the received MQTT 3.1.1 message</li>
+</ul>
+
+<p>For Ditto acknowledgements with mixed successful/failed <a href="protocol-specification-acks.html#combined-status-code">status</a>:</p>
+<ul>
+ <li>If some of the aggregated <a href="basic-acknowledgements.html#acknowledgements-acks">acknowledgements</a> require redelivery (e.g. based on a timeout):
+ <ul>
+ <li>based on the <a href="#specific-configuration">specificConfig</a> <a href="#reconnectforredelivery">reconnectForDelivery</a> either
+ <ul>
+ <li>closes and reconnects the MQTT connection in order to receive unACKed QoS 1/2 messages again</li>
+ <li>or simply acknowledges the received MQTT 3.1.1 message</li>
+ </ul>
+ </li>
+ </ul>
+ </li>
+ <li>If none of the aggregated <a href="basic-acknowledgements.html#acknowledgements-acks">acknowledgements</a> require redelivery:
+ <ul>
+ <li>acknowledges the received MQTT 3.1.1 message as redelivery does not make sense</li>
+ </ul>
+ </li>
+</ul>
+
+<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, which 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>As MQTT 3.1.1 does not support headers in its protocol, a generic <a href="connectivity-header-mapping.html">header mapping</a> is
+not possible to configure here.</p>
+
+<p>However, if one of the following headers are contained in the header mapping, they are directly applied to the
+published MQTT message:</p>
+<ul>
+ <li><code class="highlighter-rouge">mqtt.topic</code>: overwrites the topic configured for the target</li>
+ <li><code class="highlighter-rouge">mqtt.qos</code>: overwrites the qos level configured for the target</li>
+ <li><code class="highlighter-rouge">mqtt.retain</code>: controls whether the MQTT retain flag is set on the published message</li>
+</ul>
+
+<h4 id="target-acknowledgement-handling">Target acknowledgement handling</h4>
+
+<p>For MQTT 3.1.1 targets, when configuring
+<a href="basic-connections.html#target-issued-acknowledgement-label">automatically issued acknowledgement labels</a>, requested
+acknowledgements are produced in the following way:</p>
+
+<p>Once the MQTT 3.1.1 client signals that the message was acknowledged by the MQTT 3.1.1 broker, the following information
+is mapped to the automatically created <a href="protocol-specification-acks.html#acknowledgement">acknowledgement</a>:</p>
+<ul>
+ <li>Acknowledgement.status:
+ <ul>
+ <li>will be <code class="highlighter-rouge">200</code>, if the message was successfully ACKed by the MQTT 3.1.1 broker or when the target has QoS 0</li>
+ <li>will be <code class="highlighter-rouge">503</code>, if the MQTT 3.1.1 broker ran into an error before an acknowledgement message was received</li>
+ </ul>
+ </li>
+ <li>Acknowledgement.value:
+ <ul>
+ <li>will be missing, for status <code class="highlighter-rouge">200</code></li>
+ <li>will contain more information, in case that an error <code class="highlighter-rouge">status</code> was set</li>
+ </ul>
+ </li>
+</ul>
+
+<h3 id="specific-configuration">Specific Configuration</h3>
+
+<p>The MQTT 3.1.1 binding offers additional <a href="basic-connections.html#specific-configuration">specific configurations</a>
+to apply for the used MQTT client.</p>
+
+<p>Overall example JSON of the MQTT <code class="highlighter-rouge">"specificConfig"</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="p">,</span><span class="w">
+ </span><span class="s2">"reconnectForRedelivery"</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">"cleanSession"</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">"separatePublisherClient"</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">"publisherId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"my-awesome-mqtt-publisher-client-id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"reconnectForRedeliveryDelay"</span><span class="p">:</span><span class="w"> </span><span class="s2">"5s"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"lastWillTopic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"my/last/will/topic"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"lastWillQos"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"lastWillRetain"</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">"lastWillMessage"</span><span class="p">:</span><span class="w"> </span><span class="s2">"my last will message"</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>
+
+<h4 id="clientid">clientId</h4>
+
+<p>Overwrites the default MQTT client id.</p>
+
+<p>Default: not set - the ID of the Ditto <a href="basic-connections.html">connection</a> is used as MQTT client ID.</p>
+
+<h4 id="reconnectforredelivery">reconnectForRedelivery</h4>
+
+<p>Configures that the MQTT connection re-connects whenever a consumed message (via a connection source) with QoS 1
+(“at least once”) or 2 (“exactly once”)
+is processed but cannot be <a href="#source-acknowledgement-handling">acknowledged</a> successfully.<br />
+That causes that the MQTT broker will re-publish the message once the connection reconnected. <br />
+If configured to <code class="highlighter-rouge">false</code>, the MQTT message is simply acknowledged (<code class="highlighter-rouge">PUBACK</code> or <code class="highlighter-rouge">PUBREC</code>, <code class="highlighter-rouge">PUBREL</code>).</p>
+
+<p>Default: <code class="highlighter-rouge">true</code></p>
+
+<p>Handle with care:</p>
+<ul>
+ <li>when set to <code class="highlighter-rouge">true</code>, incoming QoS 0 messages are lost during the reconnection phase</li>
+ <li>when set to <code class="highlighter-rouge">true</code> and there is also an MQTT target configured to publish messages,
+the messages to be published during the reconnection phase are lost
+ <ul>
+ <li>to fix that, configure <code class="highlighter-rouge">"separatePublisherClient"</code> also to <code class="highlighter-rouge">true</code> in order to publish via another MQTT connection</li>
+ </ul>
+ </li>
+ <li>when set to <code class="highlighter-rouge">false</code>, MQTT messages with QoS 1 and 2 could get lost (e.g. during downtime or connection issues)</li>
+</ul>
+
+<h4 id="cleansession">cleanSession</h4>
+
+<p>Configure the MQTT client’s <code class="highlighter-rouge">cleanSession</code> flag.</p>
+
+<p>Default: the negation of <code class="highlighter-rouge">"reconnectForRedelivery"</code></p>
+
+<h4 id="separatepublisherclient">separatePublisherClient</h4>
+
+<p>Configures whether to create a separate physical client and connection to the MQTT broker for publishing messages, or not.
+By default (configured true), a single Ditto connection would open 2 MQTT connections/sessions: one for subscribing
+and one for publishing. If configured to <code class="highlighter-rouge">false</code>, the same MQTT connection/session is used both: for subscribing to
+messages, and for publishing messages.</p>
+
+<p>Default: <code class="highlighter-rouge">true</code></p>
+
+<h4 id="publisherid">publisherId</h4>
+
+<p>Configures a specific MQTT client ID for the case that <code class="highlighter-rouge">"separatePublisherClient"</code> is enabled.</p>
+
+<p>Default:</p>
+<ul>
+ <li>if client ID is configured, <code class="highlighter-rouge">clientId</code> + <code class="highlighter-rouge">"p"</code></li>
+ <li>if no client ID is configured, <code class="highlighter-rouge">connectionId</code> + <code class="highlighter-rouge">"p"</code></li>
+</ul>
+
+<h4 id="reconnectforredeliverydelay">reconnectForRedeliveryDelay</h4>
+
+<p>Configures how long to wait before reconnecting a consumer client for redelivery when <code class="highlighter-rouge">"reconnectForRedelivery"</code>
+and <code class="highlighter-rouge">separatePublisherClient</code> are both enabled. The minimum value is <code class="highlighter-rouge">1s</code>.</p>
+
+<p>Default: <code class="highlighter-rouge">2s</code></p>
+
+<h4 id="keepalive">keepAlive</h4>
+
+<p>Configures the keep alive time interval (in seconds) in which the client sends a ping to the broker
+if no other MQTT packets are sent during this period of time. It is used to determine if the connection is still up.</p>
+
+<p>Default: <code class="highlighter-rouge">60s</code> <a href="https://hivemq.github.io/hivemq-mqtt-client/docs/mqtt-operations/connect/#keep-alive">see here</a></p>
+
+<h4 id="lastwilltopic">lastWillTopic</h4>
+
+<p>Configures the topic which should be used on Last Will. This field is mandatory when Last Will should be enabled.</p>
+
+<h4 id="lastwillqos">lastWillQos</h4>
+
+<p>Configures the QoS which should be used on Last Will:</p>
+<ul>
+ <li><code class="highlighter-rouge">0</code> = QoS 0 (“at most once”)</li>
+ <li><code class="highlighter-rouge">1</code> = QoS 1 (“at least once”)</li>
+ <li><code class="highlighter-rouge">2</code> = QoS 2 (“exactly once”)</li>
+</ul>
+
+<p>Default: <code class="highlighter-rouge">0</code></p>
+
+<h4 id="lastwillretain">lastWillRetain</h4>
+
+<p>Configures if clients which are newly subscribed to the topic chosen in <a href="#lastwilltopic">Last Will topic</a> will
+receive this message immediately after they subscribe.</p>
+
+<p>Default: <code class="highlighter-rouge">false</code></p>
+
+<h4 id="lastwillmessage">lastWillMessage</h4>
+
+<p>Configures the message which should be published when the connection is disconnected ungracefully from the broker.
+The message will be published as UTF8-encoded text on the topic chosen in <a href="#lastwilltopic">Last Will topic</a>.</p>
+
+<p>Default: empty string</p>
+
+<h3 id="configure-last-will-message">Configure Last Will message</h3>
+
+<p>To notify other clients when the connection is disconnected ungracefully the <a href="http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html#_Toc398718028">Last Will feature</a>
+can be used. The message which will be published, is specified in the connection and stored
+in the broker when it connects. The message contains a topic, retained message flag, QoS, and the text payload to be
+published. These can be configured in the <a href="#specific-configuration">Specific Configuration</a> of the connection.
+The last will message is sent as text payload using UTF8 encoding.</p>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> This feature is enabled if the <em>last will topic</em> is set.</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
+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-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">"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, which 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"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/connectivity-protocol-bindings-mqtt5.html b/2.0/connectivity-protocol-bindings-mqtt5.html
new file mode 100644
index 0000000..755ba9e
--- /dev/null
+++ b/2.0/connectivity-protocol-bindings-mqtt5.html
@@ -0,0 +1,2189 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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.</p>
+
+<p>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.
+In addition, Ditto extracts the following headers from each consumed message:</p>
+
+<ul>
+ <li><code class="highlighter-rouge">mqtt.topic</code>: contains the MQTT topic on which a message was received</li>
+ <li><code class="highlighter-rouge">mqtt.qos</code>: contains the MQTT QoS value of a received message</li>
+ <li><code class="highlighter-rouge">mqtt.retain</code>: contains the MQTT retain flag of a received message</li>
+ <li><code class="highlighter-rouge">correlation-id</code>: contains the MQTT 5 “correlation data” value</li>
+ <li><code class="highlighter-rouge">reply-to</code>: contains the MQTT 5 “response topic” value</li>
+ <li><code class="highlighter-rouge">content-type</code>: contains the MQTT 5 “content type” value</li>
+</ul>
+
+<p>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, e.g.:</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">"headerMapping"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ header:mqtt.topic }}"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"the-qos"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ header:mqtt.qos }}"</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">"{{ header:correlation-id }}"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"device-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ header:device-id-user-defined-property }}"</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>
+
+<h4 id="source-acknowledgement-handling">Source acknowledgement handling</h4>
+
+<p>For MQTT 5 sources, when configuring
+<a href="basic-connections.html#source-acknowledgement-requests">acknowledgement requests</a>, consumed messages from the MQTT 5
+broker are treated in the following way:</p>
+
+<p>For Ditto acknowledgements with successful <a href="protocol-specification-acks.html#combined-status-code">status</a>:</p>
+<ul>
+ <li>Acknowledges the received MQTT 5 message</li>
+</ul>
+
+<p>For Ditto acknowledgements with mixed successful/failed <a href="protocol-specification-acks.html#combined-status-code">status</a>:</p>
+<ul>
+ <li>If some of the aggregated <a href="basic-acknowledgements.html#acknowledgements-acks">acknowledgements</a> require redelivery (e.g. based on a timeout):
+ <ul>
+ <li>based on the <a href="#specific-configuration">specificConfig</a> <a href="#reconnectforredelivery">reconnectForDelivery</a> either
+ <ul>
+ <li>closes and reconnects the MQTT connection in order to receive unACKed QoS 1/2 messages again</li>
+ <li>or simply acknowledges the received MQTT 5 message</li>
+ </ul>
+ </li>
+ </ul>
+ </li>
+ <li>If none of the aggregated <a href="basic-acknowledgements.html#acknowledgements-acks">acknowledgements</a> require redelivery:
+ <ul>
+ <li>acknowledges the received MQTT 5 message as redelivery does not make sense</li>
+ </ul>
+ </li>
+</ul>
+
+<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, which 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>The following headers have a special meaning in that the values are applied directly to the published message:</p>
+<ul>
+ <li><code class="highlighter-rouge">mqtt.topic</code>: overwrites the topic configured for the target</li>
+ <li><code class="highlighter-rouge">mqtt.qos</code>: overwrites the qos level configured in the target</li>
+ <li><code class="highlighter-rouge">mqtt.retain</code>: controls whether the MQTT retain flag is set on the published message</li>
+</ul>
+
+<h4 id="target-acknowledgement-handling">Target acknowledgement handling</h4>
+
+<p>For MQTT 5 targets, when configuring
+<a href="basic-connections.html#target-issued-acknowledgement-label">automatically issued acknowledgement labels</a>, requested
+acknowledgements are produced in the following way:</p>
+
+<p>Once the MQTT 5 client signals that the message was acknowledged by the MQTT 5 broker, the following information
+is mapped to the automatically created <a href="protocol-specification-acks.html#acknowledgement">acknowledgement</a>:</p>
+<ul>
+ <li>Acknowledgement.status:
+ <ul>
+ <li>will be <code class="highlighter-rouge">200</code>, if the message was successfully ACKed by the MQTT 5 broker</li>
+ <li>will be <code class="highlighter-rouge">503</code>, if the MQTT 5 broker ran into an error before an acknowledgement message was received</li>
+ </ul>
+ </li>
+ <li>Acknowledgement.value:
+ <ul>
+ <li>will be missing, for status <code class="highlighter-rouge">200</code></li>
+ <li>will contain more information, in case that an error <code class="highlighter-rouge">status</code> was set</li>
+ </ul>
+ </li>
+</ul>
+
+<h3 id="specific-configuration">Specific Configuration</h3>
+
+<p>The MQTT 5 binding offers additional <a href="basic-connections.html#specific-configuration">specific configurations</a>
+to apply for the used MQTT client.</p>
+
+<p>Overall example JSON of the MQTT <code class="highlighter-rouge">"specificConfig"</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="p">,</span><span class="w">
+ </span><span class="s2">"reconnectForRedelivery"</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">"cleanSession"</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">"separatePublisherClient"</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">"publisherId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"my-awesome-mqtt-publisher-client-id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"reconnectForRedeliveryDelay"</span><span class="p">:</span><span class="w"> </span><span class="s2">"5s"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"lastWillTopic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"my/last/will/topic"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"lastWillQos"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"lastWillRetain"</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">"lastWillMessage"</span><span class="p">:</span><span class="w"> </span><span class="s2">"my last will message"</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>
+
+<h4 id="clientid">clientId</h4>
+
+<p>Overwrites the default MQTT client id.</p>
+
+<p>Default: not set - the ID of the Ditto <a href="basic-connections.html">connection</a> is used as MQTT client ID.</p>
+
+<p>If the connection’s <code class="highlighter-rouge">clientCount</code> is 2 or more,
+the ID of each connectivity service instance is appended to the client ID to prevent clients from having the same
+ID. Otherwise the broker will disconnect the already-connected client every time another client with the same
+ID connects.</p>
+
+<h4 id="reconnectforredelivery">reconnectForRedelivery</h4>
+
+<p>Configures that the MQTT connection re-connects whenever a consumed message (via a connection source) with QoS 1
+(“at least once”) 2 (“exactly once”) is processed but cannot be <a href="#source-acknowledgement-handling">acknowledged</a> successfully.<br />
+That causes that the MQTT broker will re-publish the message once the connection reconnected. <br />
+If configured to <code class="highlighter-rouge">false</code>, the MQTT message is simply acknowledged (<code class="highlighter-rouge">PUBACK</code> or <code class="highlighter-rouge">PUBREC</code>, <code class="highlighter-rouge">PUBREL</code>).</p>
+
+<p>Default: <code class="highlighter-rouge">true</code></p>
+
+<p>Handle with care:</p>
+<ul>
+ <li>when set to <code class="highlighter-rouge">true</code>, incoming QoS 0 messages are lost during the reconnection phase</li>
+ <li>when set to <code class="highlighter-rouge">true</code> and there is also an MQTT target configured to publish messages,
+the messages to be published during the reconnection phase are lost
+ <ul>
+ <li>to fix that, configure <code class="highlighter-rouge">"separatePublisherClient"</code> also to <code class="highlighter-rouge">true</code> in order to publish via another MQTT connection</li>
+ </ul>
+ </li>
+ <li>when set to <code class="highlighter-rouge">false</code>, MQTT messages with QoS 1 and 2 could get lost (e.g. during downtime or connection issues)</li>
+</ul>
+
+<h4 id="cleansession">cleanSession</h4>
+
+<p>Configure the MQTT client’s <code class="highlighter-rouge">cleanStart</code> flag. (The flag is called <code class="highlighter-rouge">cleanStart</code> but the option is <code class="highlighter-rouge">cleanSession</code> to
+be consistent with MQTT 3 specific config.)</p>
+
+<p>Default: the negation of <code class="highlighter-rouge">"reconnectForRedelivery"</code></p>
+
+<h4 id="separatepublisherclient">separatePublisherClient</h4>
+
+<p>Configures whether to create a separate physical client and connection to the MQTT broker for publishing messages, or not.
+By default (configured to <code class="highlighter-rouge">true</code>), a single Ditto connection would open 2 MQTT connections/sessions: one for subscribing
+and one for publishing. If configured to <code class="highlighter-rouge">false</code>, the same MQTT connection/session is used both: for subscribing
+to messages, and for publishing messages.</p>
+
+<p>Default: <code class="highlighter-rouge">true</code></p>
+
+<h4 id="publisherid">publisherId</h4>
+
+<p>Configures a specific MQTT client ID for the case that <code class="highlighter-rouge">"separatePublisherClient"</code> is enabled.</p>
+
+<p>Default:</p>
+<ul>
+ <li>if client ID is configured, <code class="highlighter-rouge">clientId</code> + <code class="highlighter-rouge">"p"</code></li>
+ <li>if no client ID is configured, <code class="highlighter-rouge">connectionId</code> + <code class="highlighter-rouge">"p"</code></li>
+</ul>
+
+<h4 id="reconnectforredeliverydelay">reconnectForRedeliveryDelay</h4>
+
+<p>Configures how long to wait before reconnecting a consumer client for redelivery when <code class="highlighter-rouge">"reconnectForRedelivery"</code>
+and <code class="highlighter-rouge">separatePublisherClient</code> are both enabled. The minimum value is <code class="highlighter-rouge">1s</code>.</p>
+
+<p>Default: <code class="highlighter-rouge">2s</code></p>
+
+<h4 id="keepalive">keepAlive</h4>
+
+<p>Configures the keep alive time interval (in seconds) in which the client sends a ping to the broker
+if no other MQTT packets are sent during this period of time. It is used to determine if the connection is still up.</p>
+
+<p>Default: <code class="highlighter-rouge">60s</code> <a href="https://hivemq.github.io/hivemq-mqtt-client/docs/mqtt-operations/connect/#keep-alive">see here</a></p>
+
+<h4 id="lastwilltopic">lastWillTopic</h4>
+
+<p>Configures the topic which should be used on Last Will. This field is mandatory when Last Will should be enabled.</p>
+
+<h4 id="lastwillqos">lastWillQos</h4>
+
+<p>Configures the QoS which should be used on Last Will:</p>
+<ul>
+ <li><code class="highlighter-rouge">0</code> = QoS 0 (“at most once”)</li>
+ <li><code class="highlighter-rouge">1</code> = QoS 1 (“at least once”)</li>
+ <li><code class="highlighter-rouge">2</code> = QoS 2 (“exactly once”)</li>
+</ul>
+
+<p>Default: <code class="highlighter-rouge">0</code></p>
+
+<h4 id="lastwillretain">lastWillRetain</h4>
+
+<p>Configures if clients which are newly subscribed to the topic chosen in <a href="#lastwilltopic">Last Will topic</a> will
+receive this message immediately after they subscribe.</p>
+
+<p>Default: <code class="highlighter-rouge">false</code></p>
+
+<h4 id="lastwillmessage">lastWillMessage</h4>
+
+<p>Configures the message which should be published when the connection is disconnected ungracefully from the broker.
+The message will be published as UTF8-encoded text on the topic chosen in <a href="#lastwilltopic">Last Will topic</a>.</p>
+
+<p>Default: empty string</p>
+
+<h3 id="configure-last-will-message">Configure Last Will message</h3>
+
+<p>To notify other clients when the connection is disconnected ungracefully the <a href="https://docs.oasis-open.org/mqtt/mqtt/v5.0/os/mqtt-v5.0-os.html#_Toc3901033">Last Will feature</a>
+can be used. The message which will be published, is specified in the connection and stored in the broker when it
+connects. The message contains a topic, retained message flag, QoS, and the text payload to be published. These can be
+configured in the <a href="#specific-configuration">Specific Configuration</a> of the connection.</p>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> This feature is enabled if the <em>last will topic</em> is set.</div>
+
+<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, which 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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/connectivity-ssh-tunneling.html b/2.0/connectivity-ssh-tunneling.html
new file mode 100644
index 0000000..9072b21
--- /dev/null
+++ b/2.0/connectivity-ssh-tunneling.html
@@ -0,0 +1,1873 @@
+<!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="connectivity, ssh, tunnel, tunneling, port forwarding">
+<title> SSH tunneling • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="SSH tunneling">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li class="active"><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">SSH tunneling</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="ssh-tunneling">SSH tunneling</h2>
+
+<p>A managed connection supports establishing an SSH tunnel
+(see section TCP/IP Port Forwarding of the
+<a href="https://tools.ietf.org/html/rfc4254#section-7">Secure Shell (SSH) Connection Protocol, RFC4254</a>) which
+is then used to connect to the actual target endpoint.
+This is useful when the target endpoint is not directly accessible but only via SSH. For this purpose the connection
+configuration must specify the <code class="highlighter-rouge">sshTunnel</code> section, which contains the necessary
+information to establish a local SSH port forwarding. The tunneling supports password and public key authentication and
+host validation using public key fingerprints. If the tunnel is enabled the connection will establish an SSH
+tunnel and afterwards use this tunnel to connect to the actual endpoint.</p>
+
+<p>The example below establishes an SSH tunnel via <code class="highlighter-rouge">ssh-host:2222</code> to the remote endpoint
+<code class="highlighter-rouge">tcp://mqtt.eclipseprojects.io:1883</code>, using plain authentication and enabled host validation:</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">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"tunneled-connection"</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">"uri"</span><span class="p">:</span><span class="w"> </span><span class="s2">"tcp://mqtt.eclipseprojects.io: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="err">...</span><span class="w"> </span><span class="p">}],</span><span class="w">
+ </span><span class="s2">"sshTunnel"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"enabled"</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">"ssh://ssh-host:2222"</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">"plain"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"username"</span><span class="p">:</span><span class="w"> </span><span class="s2">"username"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"password"</span><span class="p">:</span><span class="w"> </span><span class="s2">"password"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"validateHost"</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">"knownHosts"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"MD5:e0:3a:34:1c:68:ed:c6:bc:7c:ca:a8:67:c7:45:2b:19"</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="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> When using SSH tunneling, keep in mind that it can have an impact on the transmission
+performance of your connection compared to transmission performance of a direct connection.</div>
+
+<h3 id="public-key-authentication">Public key authentication</h3>
+
+<p>An SSH tunnel can also be authenticated using public key authentication. The credentials provided in the SSH tunnel
+configuration must then be of the type <code class="highlighter-rouge">public-key</code>:</p>
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="err">...</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">"public-key"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"username"</span><span class="p">:</span><span class="w"> </span><span class="s2">"username"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"publicKey"</span><span class="p">:</span><span class="w"> </span><span class="s2">"-----BEGIN PUBLIC KEY-----</span><span class="se">\n</span><span class="s2">MIIBIjANBgkqhkiG9.....</span><span class="se">\n</span><span class="s2">-----END PUBLIC KEY-----"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"privateKey"</span><span class="p">:</span><span class="w"> </span><span class="s2">"-----BEGIN PRIVATE KEY-----</span><span class="se">\n</span><span class="s2">MIIEvAIBADANBgkqhki....</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="err">...</span><span class="w">
+</span></code></pre></div></div>
+
+<p>The public key must be provided as PEM-encoded RSA key in <code class="highlighter-rouge">X.509</code> format.
+The private key must be provided as PEM-encoded RSA key in unencrypted <code class="highlighter-rouge">PKCS8</code> format as specified by
+<a href="https://tools.ietf.org/html/rfc7468">RFC-7468</a>.</p>
+
+<p>The following command can be used to convert a standard OpenSSL key in PKCS1 format to the PKCS8 format accepted by
+Ditto:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>openssl pkcs8 -topk8 -nocrypt -in client-private.pem.key -out client-private.pem.pk8
+</code></pre></div></div>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Ditto does not make any sanity check regarding the provided credentials or the
+provided SSH server, e.g. if the server uses outdated ciphers or insecure keys. So make sure you configure only trusted
+servers that meet your security requirements. As an additional security measure, the user associated with the given
+credentials should only have assigned the least required privileges (i.e. allow only local port forwarding but no
+shell access).</div>
+
+<h3 id="ssh-host-validation">SSH host validation</h3>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> It is highly recommended enabling host validation for productive systems, it should
+only be disabled for testing purposes.</div>
+
+<p>The accepted fingerprints can be provided in the format the standard command line tool <code class="highlighter-rouge">ssh-keygen</code> produces.</p>
+
+<p>Example:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>MD5:e0:3a:34:1c:68:ed:c6:bc:7c:ca:a8:67:c7:45:2b:19
+</code></pre></div></div>
+<p>The fingerprints are prefixed with an alias of the hash algorithm that was used to calculate the fingerprint. Ditto
+supports the following hash algorithms for public key fingerprints: <code class="highlighter-rouge">MD5</code>, <code class="highlighter-rouge">SHA1</code>, <code class="highlighter-rouge">SHA224</code>, <code class="highlighter-rouge">SHA256</code>, <code class="highlighter-rouge">SHA384</code> and <code class="highlighter-rouge">SHA512</code>.</p>
+
+<p>Assuming the file <code class="highlighter-rouge">id_rsa.pub</code> contains the public key the following command produces a valid fingerprint that
+can be used in the SSH tunnel configuration:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ssh-keygen -lf id_rsa.pub -E md5
+</code></pre></div></div>
+<p>Or in case the public key is given in PKCS8 format:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ssh-keygen -lf id_rsa.pub.pkcs8 -m PKCS8 -E md5
+</code></pre></div></div>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/connectivity-tls-certificates.html b/2.0/connectivity-tls-certificates.html
new file mode 100644
index 0000000..a347a69
--- /dev/null
+++ b/2.0/connectivity-tls-certificates.html
@@ -0,0 +1,1903 @@
+<!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="connectivity, security, TLS">
+<title> Certificates for Transport Layer Security • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Certificates for Transport Layer Security">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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 class="active"><a href="connectivity-tls-certificates.html">TLS certificates</a></li>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Certificates for Transport Layer Security</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="verify-server-certificate">Verify server certificate</h2>
+
+<p><em>Server-certificate verification is available for
+<a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1</a>,
+<a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0</a>,
+<a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1</a>,
+<a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5</a>,
+<a href="connectivity-protocol-bindings-http.html">HTTP 1.1</a>, and
+<a href="connectivity-protocol-bindings-kafka2.html">Kafka 2.x</a> connections.</em></p>
+
+<h3 id="connection-configuration">Connection configuration</h3>
+
+<p>Verifying the server identity mitigates the risk of man-in-the-middle attacks.
+To have Ditto check the identity of external message brokers,
+choose a secure transport protocol and set the flag <code class="highlighter-rouge">validateCertificates</code> to <code class="highlighter-rouge">true</code> in your
+<a href="basic-connections.html">connections</a>.</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">"uri"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<secure-transport-protocol>://<host>:<port>/<path>"</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"><trusted certificate></span><span class="se">\n</span><span class="s2">-----END CERTIFICATE-----"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<ul>
+ <li><code class="highlighter-rouge">uri</code>: Choose a secure transport protocol such as <code class="highlighter-rouge">amqps</code> or <code class="highlighter-rouge">ssl</code>.</li>
+ <li><code class="highlighter-rouge">validateCertificates</code>: Must be <code class="highlighter-rouge">true</code>.</li>
+ <li><code class="highlighter-rouge">ca</code>: A string of trusted certificates as <a href="https://en.wikipedia.org/wiki/Privacy-Enhanced_Mail">PEM</a>-encoded <a href="https://en.wikipedia.org/wiki/X.690#DER_encoding">DER</a>. Concatenate multiple certificates as
+ strings to trust all of them. Omit to trust popular certificate authorities.</li>
+</ul>
+
+<h3 id="server-identity-check">Server identity check</h3>
+
+<p>When Ditto opens a secure connection, the external message broker provides a server certificate.
+The server identity is verified directly or indirectly.</p>
+
+<ul>
+ <li>
+ <p><strong>Direct identity verification</strong>:
+The exact server certificate is listed as a trusted certificate in the connection configuration <code class="highlighter-rouge">ca</code>.
+Establishing a TLS session proves that the external message broker possesses the private key matching the server
+certificate.</p>
+ </li>
+ <li>
+ <p><strong>Indirect identity verification via a trusted party</strong>:
+The server certificate is signed by a trusted party, whose certificate is in the connection configuration <code class="highlighter-rouge">ca</code>, and
+the host-component of the connection URI is listed in the server certificate.</p>
+
+ <p>If the host-component is a DNS name, then it should be listed as the common name (CN)
+or a subject alternative name (SAN) of type DNS.</p>
+
+ <p>If the host-component is an IPv4 or IPv6 address, then it should be listed as a subject alternative name (SAN)
+of type IP. Any IP addresses in the common name (CN) are ignored per <a href="https://tools.ietf.org/html/rfc5280">RFC-5280</a>.</p>
+
+ <p>Revocation of individual certificates is <em>not supported</em>. For each certificate in the <code class="highlighter-rouge">ca</code> field, you extend trust to
+<em>all</em> certificates signed by it.</p>
+ </li>
+ <li>
+ <p><strong>Indirect identity verification via public certificate authorities</strong>:
+The server certificate is signed by a generally accepted certificate authority, the host-component
+of the connection URI is listed in the server certificate, and the <code class="highlighter-rouge">ca</code> field is omitted in the connection
+configuration.</p>
+
+ <p>Ditto will try its best to exclude revoked certificates via <a href="https://tools.ietf.org/html/rfc6960">OCSP</a>.</p>
+ </li>
+</ul>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Certificates signed by public CAs get compromised on a daily basis.
+ It is more secure to upload your message broker’s certificate directly even if it was signed
+ by a public CA. Then the Ditto connection trusts only your broker (or rather any holder of the broker’s private key).
+ To minimize unavailability due to certificate expiry, upload both: the current broker certificate and the next
+ certificate as a concatenated string.</div>
+
+<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>
+ and <a href="connectivity-protocol-bindings-http.html">HTTP connections</a> only.</em></p>
+
+<h3 id="connection-configuration-1">Connection configuration</h3>
+
+<p>Configure a client certificate for Ditto in the <code class="highlighter-rouge">credentials</code> field of the connection configuration to authenticate
+Ditto at your message 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">"uri"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<secure-transport-protocol>://<host>:<port>/<path>"</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"><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="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<ul>
+ <li>
+ <p><code class="highlighter-rouge">uri</code>: Choose a secure transport protocol such as <code class="highlighter-rouge">ssl</code>.</p>
+ </li>
+ <li>
+ <p><code class="highlighter-rouge">credentials/type</code>: Must be <code class="highlighter-rouge">client-cert</code>.</p>
+ </li>
+ <li>
+ <p><code class="highlighter-rouge">credentials/cert</code>: The client certificate as <a href="https://en.wikipedia.org/wiki/Privacy-Enhanced_Mail">PEM</a>-encoded <a href="https://en.wikipedia.org/wiki/X.690#DER_encoding">DER</a>.</p>
+ </li>
+ <li>
+ <p><code class="highlighter-rouge">credentials/key</code>: The client private key for Ditto as PEM-encoded <a href="https://tools.ietf.org/html/rfc5208">PKCS8</a> specified by <a href="https://tools.ietf.org/html/rfc7468">RFC-7468</a>;
+the PEM preamble must be <code class="highlighter-rouge">-----BEGIN PRIVATE KEY-----</code>.</p>
+ </li>
+</ul>
+
+<p>As of September 2018, <a href="https://www.openssl.org/">OpenSSL</a> and <a href="https://docs.aws.amazon.com/iot/">AWS IoT</a> generate PKCS1-coded private keys by default, which
+have the PEM preamble <code class="highlighter-rouge">-----BEGIN RSA PRIVATE KEY-----</code>. Ditto will reject these keys. The command below converts a
+PKCS1 key file <code class="highlighter-rouge">client-private.pem.key</code> into a PKCS8 key file <code class="highlighter-rouge">client-private.pem.pk8</code> accepted by Ditto.</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>openssl pkcs8 -topk8 -nocrypt -in client-private.pem.key -out client-private.pem.pk8
+</code></pre></div></div>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/css/boxshadowproperties.css b/2.0/css/boxshadowproperties.css
new file mode 100644
index 0000000..0f2e1e6
--- /dev/null
+++ b/2.0/css/boxshadowproperties.css
@@ -0,0 +1,24 @@
+/* box-shadow fonts return errors with prince, so extracting here to put in web output only */
+
+#search-demo-container ul#results-container {
+ box-shadow: 2px 3px 2px #dedede;
+}
+
+
+hr.shaded {
+ box-shadow: inset 0 6px 6px -6px rgba(0,0,0,0.5);
+}
+
+.videoThumbs img {
+ box-shadow: 2px 2px 1px #f0f0f0;
+}
+
+.box {
+ box-shadow: 2px 2px 4px #dedede;
+}
+
+@media (max-width: 1200px) {
+ .navbar-collapse {
+ box-shadow: inset 0 1px 0 rgba(255,255,255,0.1);
+ }
+}
diff --git a/2.0/css/customstyles.css b/2.0/css/customstyles.css
new file mode 100644
index 0000000..7dc742f
--- /dev/null
+++ b/2.0/css/customstyles.css
@@ -0,0 +1,1378 @@
+body {
+ font-size:16px;
+ font-family: Open Sans, sans-serif;
+ padding-top: 50px; /* Required padding for .navbar-fixed-top. Remove if using .navbar-static-top. Change if height of navigation changes. */
+}
+
+/*
+h1,h2 {
+ font-weight: lighter;
+} */
+.navbar-ditto-home {
+ white-space: nowrap;
+}
+
+a.navbar-ditto-home:hover {
+ color: transparent;
+ text-decoration: none;
+}
+.navbar-ditto-home .ditto-navbar-symbol {
+ padding: 5px;
+ max-height: 3em;
+}
+.navbar-ditto-home .ditto-navbar-symbol-text {
+ max-height: 2em;
+}
+
+.ditto-logo {
+ min-width: 13em;
+ padding-top: 3em;
+ padding-bottom: 2em;
+}
+
+.startpage h1 {
+ color: #3a8c9a;
+ font-size: 2em;
+ padding-bottom: 1em;
+}
+
+.startpage h1 a, .startpage h2 a, .startpage h3 a, .startpage h4 a {
+ /* don't display anchor links at heading on startpage */
+ display: none;
+}
+
+.tagline {
+ text-shadow: 0 0 10px #000;
+ color: #fff;
+}
+
+.img-center {
+ margin: 0 auto;
+}
+
+.text-primary {
+ color: #3a8c9a;
+ /* affects color around images in startpage */
+}
+
+.equal {
+ display: -webkit-flex;
+ display: flex;
+}
+.equal .panel {
+ width: 100%;
+ height: 100%;
+}
+
+.bs-callout {
+ padding: 20px;
+ margin: 20px 0;
+ border: 1px solid #eee;
+ border-left-width: 5px;
+ border-radius: 3px;
+}
+.bs-callout h4 {
+ margin-top: 0;
+ margin-bottom: 5px;
+}
+.bs-callout p:last-child {
+ margin-bottom: 0;
+}
+.bs-callout code {
+ border-radius: 3px;
+}
+.bs-callout+.bs-callout {
+ margin-top: -5px;
+}
+.bs-callout-default {
+ border-left-color: #777;
+}
+.bs-callout-default h4 {
+ color: #777;
+}
+.bs-callout-primary {
+ border-left-color: #3a8c9a;
+}
+.bs-callout-primary h4 {
+ color: #3a8c9a;
+}
+.bs-callout-success {
+ border-left-color: #5cb85c;
+}
+.bs-callout-success h4 {
+ color: #5cb85c;
+}
+.bs-callout-danger {
+ border-left-color: #d9534f;
+}
+.bs-callout-danger h4 {
+ color: #d9534f;
+}
+.bs-callout-warning {
+ border-left-color: #f0ad4e;
+}
+.bs-callout-warning h4 {
+ color: #f0ad4e;
+}
+.bs-callout-info {
+border-left-color: #3a8c9a;
+}
+.bs-callout-info h4 {
+color: #3a8c9a;
+}
+
+
+.gi-2x{font-size: 2em;}
+.gi-3x{font-size: 3em;}
+.gi-4x{font-size: 4em;}
+.gi-5x{font-size: 5em;}
+
+
+
+
+
+.breadcrumb > .active {color: #777 !important;}
+
+/* make room for the nav bar */
+h1[id],
+h2[id],
+h3[id],
+h4[id],
+h5[id],
+h6[id],
+dt[id]{
+padding-top: 60px;
+margin-top: -40px
+}
+
+.post-content img {
+ margin: 12px 0px 3px 0px;
+ width: auto;
+ height: auto;
+ max-width: 100%;
+ max-height: 100%;
+}
+
+.post-content ol li, .post-content ul li {
+ margin: 10px 0px;
+}
+
+.pageSummary {
+ font-size:13px;
+ display:block;
+ margin-bottom:15px;
+ padding-left:20px;
+}
+
+.post-summary {
+ margin-bottom:12px;
+}
+
+.bs-example{
+ margin: 20px;
+}
+
+.breadcrumb li {
+ color: gray;
+}
+
+table:not(.parameters):not(.responses-table):not(.headers):not(.model) {
+ background-color: transparent;
+}
+caption {
+ padding-top: 8px;
+ padding-bottom: 8px;
+ color: #777;
+ text-align: left;
+}
+th {
+ text-align: left;
+}
+table:not(.parameters):not(.responses-table):not(.headers):not(.model) {
+ max-width: 90%;
+ margin-bottom: 20px;
+ border: 1px solid #dedede;
+ font-size: smaller;
+}
+
+table:not(.parameters):not(.responses-table):not(.headers):not(.model) > thead > tr > th,
+table:not(.parameters):not(.responses-table):not(.headers):not(.model) > tbody > tr > th,
+table:not(.parameters):not(.responses-table):not(.headers):not(.model) > tfoot > tr > th,
+table:not(.parameters):not(.responses-table):not(.headers):not(.model) > thead > tr > td,
+table:not(.parameters):not(.responses-table):not(.headers):not(.model) > tbody > tr > td,
+table:not(.parameters):not(.responses-table):not(.headers):not(.model) > tfoot > tr > td {
+ padding: 8px;
+ line-height: 1.42857143;
+ vertical-align: top;
+ border-top: 1px solid #ddd;
+}
+table:not(.parameters):not(.responses-table):not(.headers):not(.model) > thead > tr > th {
+ vertical-align: bottom;
+ border-bottom: 1px solid #ddd;
+ text-transform: none;
+ /*background-color: #8D8D8D;
+ color: white;
+ text-align: left;*/
+}
+table:not(.parameters):not(.responses-table):not(.headers):not(.model) > caption + thead > tr:first-child > th,
+table:not(.parameters):not(.responses-table):not(.headers):not(.model) > colgroup + thead > tr:first-child > th,
+table:not(.parameters):not(.responses-table):not(.headers):not(.model) > thead:first-child > tr:first-child > th,
+table:not(.parameters):not(.responses-table):not(.headers):not(.model) > caption + thead > tr:first-child > td,
+table:not(.parameters):not(.responses-table):not(.headers):not(.model) > colgroup + thead > tr:first-child > td,
+table:not(.parameters):not(.responses-table):not(.headers):not(.model) > thead:first-child > tr:first-child > td {
+ border-top: 0;
+}
+
+table:not(.parameters):not(.responses-table):not(.headers):not(.model) > tbody > tr:nth-of-type(odd) {
+ background-color: #f9f9f9;
+}
+
+table col[class*="col-"] {
+ position: static;
+ display: table-column;
+ float: none;
+}
+table td[class*="col-"],
+table th[class*="col-"] {
+ position: static;
+ display: table-cell;
+ float: none;
+}
+
+table:not(.parameters):not(.responses-table):not(.headers):not(.model) tr td {
+ hyphens: auto;
+}
+
+
+p.external a {
+ text-align:right;
+ font-size:12px;
+ color: #0088cc;
+ display:inline;
+}
+
+#definition-box-container div a.active {
+ font-weight: bold;
+}
+p.post-meta {font-size: 80%; color: #777;}
+
+.entry-date{font-size:14px; line-height:1.71429; margin-bottom:0; text-transform:uppercase;}
+
+/* search area */
+#search-demo-container ul#results-container {
+ list-style: none;
+ font-size: 12px;
+ background-color: white;
+ position: absolute;
+ top: 40px; /* if you change anything about the nav, you'll prob. need to reset the top and left values here.*/
+ left: 20px;
+ z-index: -1;
+ width:223px;
+ border-left: 1px solid #dedede;
+}
+
+
+ul#results-container a {
+ background-color: transparent;
+}
+
+ul#results-container a:hover {
+ color: black;
+}
+
+
+#search-demo-container a:hover {
+ color: black;
+}
+#search-input {
+ padding: .5em;
+ margin-left:15px;
+ width:15em;
+ font-size: 0.8em;
+ -webkit-box-sizing: border-box;
+ -moz-box-sizing: border-box;
+ box-sizing: border-box;
+ margin-top:10px;
+}
+/* end search */
+
+.filter-options {
+ margin-bottom: 20px;
+}
+.filter-options button {
+ margin: 3px;
+}
+
+div#toc ul li {
+ margin: 8px 0px 8px 22px;
+ font-size: 90%;
+ list-style: square;
+}
+div#toc ul {
+ background-color: whitesmoke;
+ padding: 5px;
+ border-radius: 5px;
+ max-width: 300px;
+ color: gray;
+}
+
+div#toc ul li ul {
+ padding-left:8px;
+
+}
+
+div#toc ul li ul li::before {
+ content: "– ";
+}
+
+div#toc >ul::before {
+ content: "Table of Contents";
+ font-weight: 500;
+ color: #555;
+ text-align:center;
+ margin-left:auto;
+ margin-right:auto;
+ width:70px;
+ padding-top:20px;
+ padding-bottom:20px;
+ padding-left:10px;
+}
+
+li.dropdownActive a {
+ font-weight: bold;
+}
+
+
+.post-content a.fa-rss {
+ color: orange;
+}
+
+
+.navbar-inverse .navbar-nav > li > a {
+ background-color: transparent;
+ margin-top:10px;
+}
+
+.post-content .rssfeedLink {
+ color: #248EC2;
+}
+
+footer {
+ font-size: smaller;
+}
+
+/* FAQ page */
+#accordion .panel-heading {
+ font-size: 12px;
+}
+
+a.accordion-toggle, a.accordion-collapsed {
+ font-size: 14px;
+ text-decoration: none;
+}
+
+.nav, .nav ul, .nav li {
+ list-style: none;
+}
+
+.nav ul {
+ padding: 0;
+ /*margin: 0 0 0 18px;*/
+ margin:0px;
+}
+
+.nav {
+ /* padding: 4px;*/
+ padding:0px;
+ margin: 0px;
+}
+
+.nav > li {
+ margin: 1px 0;
+}
+
+.nav > li li {
+ margin: 2px 0;
+}
+
+.nav a {
+ color: #333;
+ display: block;
+ outline: none;
+ /*-webkit-border-radius: 4px;
+ -moz-border-radius: 4px;
+ border-radius: 4px;*/
+ text-decoration: none;
+}
+
+.nav li > a > span {
+ float: right;
+ font-size: 19px;
+ font-weight: bolder;
+}
+
+
+.nav li > a > span:after {
+ content: '\25be';
+}
+.nav li.active > a > span:after {
+ content: '\25b4';
+}
+
+.nav a:hover, .nav li.active > a {
+ background-color: #8D8D8D;
+ color: #f5f5f5;
+}
+
+.nav > li.active > a {
+background-color: #3a8c9a;
+}
+
+.nav li a {
+ font-size: 12px;
+ line-height: 18px;
+ padding: 2px 10px;
+ background-color: #f1f1f1;
+}
+
+.nav > li > a {
+ font-size: 14px;
+ line-height: 20px;
+ padding: 4px 10px;
+}
+
+ul#mysidebar {
+ border-radius:0px;
+}
+
+.nav ul li ul li a {
+ padding-left:40px;
+}
+
+.nav li.thirdlevel > a {
+ color: #248EC2;
+ font-weight:bold;
+ padding-left:20px;
+ background-color: whitesmoke !important;
+}
+
+
+.nav ul li a {
+ background-color: #FAFAFA;
+}
+
+.nav li a {
+ padding-right:10px;
+}
+
+.nav li a:hover {
+ background-color: #8D8D8D;
+}
+
+.nav ul li a {
+ border-top:1px solid whitesmoke;
+ padding-left:20px;
+}
+/* end sidebar */
+
+.navbar-inverse .navbar-nav > .active > a, .navbar-inverse .navbar-nav > .active > a:hover, .navbar-inverse .navbar-nav > .active > a:focus {
+ border-radius:5px;
+}
+
+.navbar-inverse .navbar-nav>.open>a, .navbar-inverse .navbar-nav>.open>a:focus, .navbar-inverse .navbar-nav>.open>a:hover {
+ border-radius: 5px;
+}
+
+span.projectTitle {
+ font-family: Open Sans, sans-serif;
+ font-weight: bold;
+}
+
+.footer {
+}
+
+.footer .quickLinks, .footer .notice {
+ float: left;
+}
+
+.footer .quickLinks {
+ clear: left;
+}
+
+.footer .quickLinks a {
+ float: left;
+ padding-right: 2em;
+}
+.footer .quickLinks a::after {
+ content: none;
+}
+
+.footer .logo img {
+ float: right;
+ max-width: 150px;
+}
+.footer .logo a::after {
+ content: none;
+}
+
+.footerMeta {
+ background-color: whitesmoke;
+ padding: 10px;
+ max-width: 250px;
+ border-radius: 5px;
+ margin-top: 50px;
+ font-style:italic;
+ font-size:12px;
+}
+
+img.screenshotSmall {
+ max-width: 300px;
+}
+
+
+dl dt p {
+ margin-left:20px;
+}
+
+
+dl dd {
+ margin-top:10px;
+ margin-bottom:10px;
+}
+
+dl.dl-horizontal dd {
+ padding-top: 20px;
+}
+
+figcaption {
+
+ padding-bottom:12px;
+ padding-top:6px;
+ max-width: 90%;
+ margin-bottom:20px;
+ font-style: italic;
+ color: gray;
+
+}
+
+.testing {
+ color: orange;
+}
+
+.preference {
+ color: red;
+}
+
+
+table.dataTable thead {
+ background-color: #444;
+}
+table td {
+ hyphens: auto;
+}
+
+section table tr.success {
+ background-color: #dff0d8 !important;
+}
+
+table tr.info {
+ background-color: #d9edf7 !important;
+}
+
+section table tr.warning, table tr.testing, table tr.testing > td.sorting_1 {
+ background-color: #fcf8e3 !important;
+}
+section table tr.danger, table tr.preference, table tr.preference > td.sorting_1 {
+ background-color: #f2dede !important;
+}
+
+.orange {
+ color: orange;
+}
+
+table.profile thead tr th {
+ background-color: #248ec2;
+}
+
+table.request thead tr th {
+ background-color: #696969;
+}
+
+.audienceLabel {
+ margin: 10px;
+ float: right;
+ border:1px solid #dedede;
+ padding:7px;
+}
+
+.prefaceAudienceLabel {
+ color: gray;
+ text-align: center;
+ margin:5px;
+}
+span.myLabel {
+ padding-left:10px;
+ padding-right:10px;
+}
+
+button.cursorNorm {
+ cursor: default;
+}
+
+a.dropdown-toggle, .navbar-inverse .navbar-nav > li > a {
+ margin-left: 10px;
+}
+
+hr.faded {
+ border: 0;
+ height: 1px;
+ background-image: -webkit-linear-gradient(left, rgba(0,0,0,0), rgba(0,0,0,0.75), rgba(0,0,0,0));
+ background-image: -moz-linear-gradient(left, rgba(0,0,0,0), rgba(0,0,0,0.75), rgba(0,0,0,0));
+ background-image: -ms-linear-gradient(left, rgba(0,0,0,0), rgba(0,0,0,0.75), rgba(0,0,0,0));
+ background-image: -o-linear-gradient(left, rgba(0,0,0,0), rgba(0,0,0,0.75), rgba(0,0,0,0));
+}
+
+hr.shaded {
+ height: 1px;
+ border: 0;
+ margin-top: 70px;
+ width: 100%;
+ margin-bottom: 10px;
+}
+
+.fa-6x{font-size:900%;}
+.fa-7x{font-size:1100%;}
+.fa-8x{font-size:1300%;}
+.fa-9x{font-size:1500%;}
+.fa-10x{font-size:1700%;}
+
+i.border {
+ padding: 10px 20px;
+ background-color: whitesmoke;
+}
+
+a[data-toggle] {
+ color: #248EC2;
+}
+
+.summary {
+ font-size:120%;
+ color: #808080;
+ margin:20px 0px 20px 0px;
+ border-left: 5px solid #696969;
+ padding-left: 10px;
+
+}
+
+.summary:before {
+ content: "Summary: ";
+ font-weight: bold;
+}
+
+
+a.fa.fa-envelope-o.mailto {
+ font-weight: 600;
+}
+
+h3 {color: #696969; font-weight:normal; font-size:130%;}
+h4 {color: #808080; font-weight:normal; font-size:120%; font-style:italic;}
+
+.alert, .callout {
+ overflow: hidden;
+}
+
+.nav-tabs > li.active > a, .nav-tabs > li.active > a:hover, .nav-tabs > li.active > a:focus {
+ background-color: #248ec2;
+ color: white;
+}
+
+ol li ol li {list-style-type: lower-alpha;}
+ol li ul li {list-style-type: disc;}
+
+li img {clear:both; }
+
+div#toc ul li ul li {
+ list-style-type: none;
+ margin: 5px 0px 0px 0px;
+}
+
+.tab-content {
+ padding: 15px;
+ background-color: #FAFAFA;
+}
+
+span.tagTitle {font-weight: 500;}
+
+li.activeSeries {
+ font-weight: bold;
+}
+
+.seriesContext .dropdown-menu li.active {
+ font-weight: bold;
+ margin-left: 43px;
+ font-size:18px;
+}
+
+.alert-warning {
+ color: #444;
+}
+
+div.alert code, h2 code {
+ background-color: transparent !important;
+}
+/* without this, the links in these notes aren't visible.*/
+.alert a {
+ text-decoration: underline;
+}
+
+div.tags {padding: 10px 5px;}
+
+.tabLabel {
+ font-weight: normal;
+}
+
+hr {
+ background: #3a8c9a;
+ margin: 30px 0px;
+ width: 90%;
+ margin-left: auto;
+ margin-right: auto;
+}
+
+button.cursorNorm {
+ cursor: pointer;
+}
+
+h2 {
+ font-size:24px;
+ line-height:29px;
+}
+span.otherProgrammingLanguages {
+ font-style: normal;
+}
+
+a[data-toggle="tooltip"] {
+ font-style: italic;
+ cursor: default;
+}
+
+.seriesNext, .seriesContext {
+ margin-top: 15px;
+ margin-bottom: 15px;
+}
+
+.seriescontext ol li {
+ list-style-type: upper-roman;
+}
+
+ol.series li {
+ list-style-type: decimal;
+ margin-left: 40px;
+ padding-left: 0px;
+}
+
+.siteTagline {
+ font-size: 200%;
+ font-weight: bold;
+ color: silver;
+ font-family: monospace;
+ text-align: center;
+ line-height: 10px;
+ margin: 20px 0px;
+ display: block;
+}
+
+
+.versionTagline {
+ text-align: center;
+ margin-bottom: 20px;
+ font-family: courier;
+ color: silver;
+ color: #444;
+ display:block;
+}
+
+.navbar-inverse .navbar-collapse, .navbar-inverse .navbar-form {
+ border-color: #248ec2 !important;
+}
+
+/* important for navigation expanding/collapsing */
+#mysidebar.nav ul {
+ background-color: #FAFAFA;
+}
+#mysidebar.nav ul {
+ display: none;
+}
+#mysidebar.nav li.active > ul {
+ display: block;
+}
+#mysidebar.nav li.open > ul {
+ display: block;
+}
+#mysidebar.nav ul.series li {
+ list-style: decimal;
+ font-size:12px;
+}
+
+.nav ul.series li a:hover {
+ background-color: gray;
+}
+.nav .open>a {
+ border: 0;
+}
+.nav .open>a:hover {
+ background-color: gray;
+}
+.nav ul.series {
+ padding-left: 30px;
+}
+
+.nav ul.series {
+ background-color: #FAFAFA;
+}
+
+.topnavlinks .cc-top {
+ font-size: 15px;
+ font-family: Open Sans, sans-serif;
+}
+
+.cc-color-override-1434350510 {
+ background-color: #f5f5f5 !important;
+ color: #5c7291 !important;
+}
+.cc-color-override-1434350510 .cc-link {
+ color: black !important;
+}
+.cc-color-override-1434350510 .cc-btn.cc-allow {
+ background-color: #3a8c9a !important;
+}
+
+/*
+a.dropdown-toggle.otherProgLangs {
+ color: #f7e68f !important;
+}
+*/
+
+span.muted {color: #666;}
+
+table code {background-color: transparent;}
+
+.highlight .err {
+ color: #a61717;
+ background-color: transparent !important;
+}
+
+table p {
+ margin-top: 12px;
+ margin-bottom: 12px;
+}
+
+pre, table code {
+ white-space: pre-wrap; /* css-3 */
+ white-space: -moz-pre-wrap; /* Mozilla, since 1999 */
+ white-space: -pre-wrap; /* Opera 4-6 */
+ white-space: -o-pre-wrap; /* Opera 7 */
+ word-wrap: break-word; /* Internet Explorer 5.5+ */
+}
+
+pre {
+ margin: 25px 0px;
+}
+
+#json-box-container pre {
+ margin: 0px;
+}
+
+.video-js {
+ margin: 30px 0px;
+}
+
+video {
+ display: block;
+ margin: 30px 0px;
+ border: 1px solid #c0c0c0;
+}
+
+
+p.required, p.dataType {display: block; color: #c0c0c0; font-size: 80%; margin-left:4px;}
+
+dd {margin-left:20px;}
+
+.post-content img.inline {
+ margin:0px;
+ margin-bottom:6px;
+}
+.panel-heading {
+ font-weight: bold;
+}
+
+.note code, .alert code, .warning code, div#toc code, h2 code, h3 code, h4 code {
+ color: inherit;
+ padding: 0px;
+}
+
+.alert {
+ margin-bottom:10px;
+ margin-top:10px;
+}
+
+a.accordion-toggle {
+ font-style: normal;
+}
+
+span.red {
+ color: red;
+ font-family: Monaco, Menlo, Consolas, "Courier New", monospace;
+}
+
+h3.codeExplanation {
+ font-size:18px;
+ font-style:normal;
+ color: black;
+ line-height: 24px;
+}
+
+span.soft {
+ color: #c0c0c0;
+}
+
+.githubEditButton {
+ margin-bottom:7px;
+}
+
+.endpoint {
+ padding: 15px;
+ background-color: #f0f0f0;
+ font-family: courier;
+ font-size: 110%;
+ margin: 20px 0px;
+ color: #444;
+}
+
+.parameter {
+ font-family: courier;
+ color: red !important;
+}
+
+.formBoundary {
+ border: 1px solid gray;
+ padding: 15px;
+ margin: 15px 0px;
+ background-color: whitesmoke;
+}
+
+@media (max-width: 767px) {
+ .navbar-inverse .navbar-nav .open .dropdown-menu > li > a {
+ color: #444;
+ }
+}
+
+@media (max-width: 990px) {
+ #mysidebar {
+ position: relative;
+ }
+}
+
+@media (min-width: 1000px) {
+
+ ul#mysidebar {
+ width: 225px;
+ }
+}
+
+@media (max-width: 900px) {
+
+ ul#mysidebar {
+ max-width: 100%;
+ }
+}
+
+.col-md-9 img {
+ max-width: 100%;
+ max-height: 100%;
+}
+
+
+.post-content img {
+ margin: 12px 0px 3px 0px;
+ width: auto;
+ height: auto;
+ max-width: 100%;
+ max-height: 100%;
+}
+.col-md-9 img {
+ max-width: 100%;
+ max-height: 100%;
+}
+
+
+.post-content img {
+ margin: 12px 0px 3px 0px;
+ width: auto;
+ height: auto;
+ max-width: 100%;
+ max-height: 100%;
+}
+
+.videoThumbs img {
+ float: left;
+ margin:15px 15px 15px 0px;
+ border: 1px solid #dedede;
+}
+
+
+@media only screen and (min-width: 900px), only screen and (min-device-width: 900px) {
+ .col-md-9 img {
+ max-width: 700px;
+ max-height: 700px;
+ }
+}
+
+*:hover > .anchorjs-link {
+ transition: color .25s linear;
+ text-decoration: none;
+}
+
+.kbCaption {
+ color: white;
+ background-color: #444;
+ padding:10px;
+}
+
+/* this part adds an icon after external links, using FontAwesome*/
+a[href^="http://"]:after, a[href^="https://"]:after {
+ content: "\f08e";
+ font-family: FontAwesome;
+ font-weight: normal;
+ font-style: normal;
+ display: inline-block;
+ text-decoration: none;
+ padding-left: 3px;
+}
+
+/* Strip the outbound icon when this class is present */
+a[href].noCrossRef::after,
+a.no_icon:after
+ {
+ content:"" !important;
+ padding-left: 0;
+}
+
+.btn-default {
+ margin-bottom: 10px;
+}
+
+/* algolia search */
+
+.search {
+ text-align: left;
+}
+.search input {
+ font-size: 20px;
+ width: 300px;
+}
+.results {
+ margin: auto;
+ text-align: left;
+}
+.results ul {
+ list-style-type: none;
+ padding: 0;
+}
+
+/* algolia */
+
+div.results {
+ position: absolute;
+ background-color: white;
+ width: 100%;
+}
+
+.post-meta {
+ font-size: 14px;
+ color: #828282;
+}
+
+.post-link {
+ font-size: 30px;
+ color: #3a8c9a;
+}
+
+.post-list p {
+ margin: 10px 0px;
+}
+
+time {
+ margin-right: 10px;
+}
+
+p.post-meta time {
+ margin-right: 0px;
+}
+
+span.label.label-default {
+ background-color: gray;
+}
+
+span.label.label-primary {
+ background-color: #f0ad4e;
+}
+.col-lg-12 .nav li a {background-color: white}
+
+
+.nav li.active > a.subfoldersTitle {
+ background-color: whitesmoke;
+ font-weight: bold;
+ color: black;
+ }
+
+a code {
+ color: #248EC2;
+}
+
+code + a > code {
+ margin-left: -7px;
+}
+
+table th code {
+ color: white;
+}
+
+ol li ul li ol li {
+ list-style: decimal;
+}
+
+ol li ul li ol li ul li{
+ list-style: disc;
+}
+
+.post-content table th {
+ vertical-align: top;
+}
+
+table thead th code.highlighter-rouge {
+ background-color: transparent;
+}
+
+
+.box {
+ padding: 10px;
+ border: 1px solid #888;
+ width: 100px;
+ height: 80px;
+ background-color: #f5f5f5;
+ font-family: Open Sans, sans-serif;
+ font-size: 12px;
+ hyphens: auto;
+ float: left;
+ font-size: 12px;
+}
+
+.box:hover {
+ background-color: #f0f0f0;
+}
+
+#userMap {
+ overflow-x: auto;
+ overflow-y: auto;
+ padding: 20px;
+ min-width: 770px;
+}
+
+#userMap .active {
+ background-color: #d6f5d6;
+ border:1px solid #555;
+ font-weight: bold;
+}
+
+h2.userMapTitle {
+ font-family: Open Sans, sans-serif;
+}
+
+#userMap a:hover {
+ text-decoration: none;
+ }
+
+div.arrow {
+ max-width: 50px;
+ margin-left: 15px;
+ margin-right: 15px;
+ font-size: 20px;
+}
+
+div.content {
+ max-width: 110px
+}
+
+#userMap div.arrow, #userMap div.content {
+ float: left;
+}
+
+.clearfix {
+ clear: both;
+}
+
+
+#userMap div.arrow {
+ position: relative;
+ top: 30px;
+}
+
+.box1 {
+ margin-left:0px;
+}
+
+button.btn.btn-default.btn-lg.modalButton1 {
+ margin-left: -20px;
+}
+
+div.box.box1 {
+ margin-left: -20px;
+}
+
+#userMap .btn-lg {
+ width: 100px;
+ height: 80px;
+
+}
+
+#userMap .complexArrow {
+ font-size: 22px;
+ margin: 0px 10px;
+}
+
+
+#userMap .btn-lg .active {
+ background-color: #d6f5d6;
+}
+
+#userMap .btn-lg {
+ white-space: pre-wrap; /* css-3 */
+ white-space: -moz-pre-wrap; /* Mozilla, since 1999 */
+ white-space: -pre-wrap; /* Opera 4-6 */
+ white-space: -o-pre-wrap; /* Opera 7 */
+ word-wrap: break-word; /* Internet Explorer 5.5+ */
+ font-size: 14px;
+ }
+
+/*
+ * Let's target IE to respect aspect ratios and sizes for img tags containing SVG files
+ *
+ * [1] IE9
+ * [2] IE10+
+ */
+/* 1 */
+.ie9 img[src$=".svg"] {
+ width: 100%;
+}
+/* 2 */
+@media screen and (-ms-high-contrast: active), (-ms-high-contrast: none) {
+ img[src$=".svg"] {
+ width: 100%;
+ }
+}
+
+h4.panel-title {
+ padding-top: 0px;
+ margin-top: 0px;
+}
+
+/*set navbar breakpoint so that it converts to hamburger earlier */
+
+@media (max-width: 1200px) {
+ .navbar-header {
+ float: none;
+ }
+ .navbar-left,.navbar-right {
+ float: none !important;
+ }
+ .navbar-toggle {
+ display: block;
+ }
+ .navbar-collapse {
+ border-top: 1px solid transparent;
+ }
+ .navbar-fixed-top {
+ top: 0;
+ border-width: 0 0 1px;
+ }
+ .navbar-collapse.collapse {
+ display: none!important;
+ max-height: inherit;
+ }
+ .navbar-collapse.collapse .navbar-nav {
+ /*margin-top: 0;*/
+ }
+ .navbar-collapse.collapse .navbar-nav > li > a{
+ line-height: inherit;
+ }
+ .navbar-nav {
+ float: none!important;
+ margin-top: 7.5px;
+ }
+ .navbar-nav>li {
+ float: none;
+ }
+ .navbar-nav>li>a {
+ padding-top: 10px;
+ padding-bottom: 10px;
+ }
+ .navbar-collapse.collapse.in {
+ display:block !important;
+ overflow: hidden;
+ }
+}
+
+@media print {
+ footer, #tg-sb-sidebar, .incubation-logo {
+ display: none !important;
+ }
+}
+
+.highlight.who {
+ margin-left: 0;
+ margin-right: 0;
+ text-align: center;
+ background-color: #3a8c9a;
+ color: #fff;
+ padding-bottom: 60px;
+}
+.highlight.who h2 {
+ font-size: 2.5em;
+ line-height: 1.5em;
+ color: #fff;
+ margin-top: 0.5em;
+ margin-bottom: 1em;
+}
+.highlight.who a {
+ color: #fff;
+}
+.highlight.who img {
+ width: 60%;
+ max-width: 250px;
+ height: 100%;
+}
+
+.highlight.who a::after {
+ content: none;
+}
+
+.highlight.who ul.user-logos {
+ display: flex ;
+ flex-flow: row wrap;
+ padding: 0;
+}
+
+.highlight.who ul.user-logos > li {
+ flex: 1 1 33%; /* 3 logos per line */
+ padding-bottom: 2em;
+ list-style: none;
+}
+
+.highlight.who p {
+ padding-top: 2em;
+ font-size: 1.2em;
+}
+.highlight.who p a {
+ text-decoration: underline;
+}
diff --git a/2.0/css/modern-business.css b/2.0/css/modern-business.css
new file mode 100644
index 0000000..c3b0885
--- /dev/null
+++ b/2.0/css/modern-business.css
@@ -0,0 +1,89 @@
+/*!
+ * Start Bootstrap - Modern Business HTML Template (http://startbootstrap.com)
+ * Code licensed under the Apache License v2.0.
+ * For details, see http://www.apache.org/licenses/LICENSE-2.0.
+ */
+
+/* Global Styles */
+
+html,
+body {
+ height: 100%;
+}
+
+.img-portfolio {
+ margin-bottom: 30px;
+}
+
+.img-hover:hover {
+ opacity: 0.8;
+}
+
+/* Home Page Carousel */
+
+header.carousel {
+ height: 50%;
+}
+
+header.carousel .item,
+header.carousel .item.active,
+header.carousel .carousel-inner {
+ height: 100%;
+}
+
+header.carousel .fill {
+ width: 100%;
+ height: 100%;
+ background-position: center;
+ background-size: cover;
+}
+
+/* 404 Page Styles */
+
+.error-404 {
+ font-size: 100px;
+}
+
+/* Pricing Page Styles */
+
+.price {
+ display: block;
+ font-size: 50px;
+ line-height: 50px;
+}
+
+.price sup {
+ top: -20px;
+ left: 2px;
+ font-size: 20px;
+}
+
+.period {
+ display: block;
+ font-style: italic;
+}
+
+/* Footer Styles */
+
+footer {
+ margin: 20px 0;
+}
+
+/* Responsive Styles */
+
+@media(max-width:991px) {
+ .client-img,
+ .img-related {
+ margin-bottom: 30px;
+ }
+}
+
+@media(max-width:767px) {
+ .img-portfolio {
+ margin-bottom: 15px;
+ }
+
+ header.carousel .carousel {
+ height: 70%;
+ }
+}
diff --git a/2.0/css/printstyles.css b/2.0/css/printstyles.css
new file mode 100644
index 0000000..747f069
--- /dev/null
+++ b/2.0/css/printstyles.css
@@ -0,0 +1,156 @@
+body {
+ font-size:14px;
+}
+.nav ul li a {border-top:0px; background-color:transparent; color: #808080; }
+#navig a[href] {color: #595959 !important;}
+table .table {max-width:650px;}
+
+#navig li.sectionHead {font-weight: bold; font-size: 18px; color: #595959 !important; }
+#navig li {font-weight: normal; }
+
+#navig a[href]::after { content: leader(".") target-counter(attr(href), page); }
+
+a[href]::after {
+ content: " (page " target-counter(attr(href), page) ")"
+}
+
+a[href^="http:"]::after, a[href^="https:"]::after {
+ content: "";
+}
+
+a[href] {
+ color: blue !important;
+}
+a[href*="mailto"]::after, a[data-toggle="tooltip"]::after, a[href].noCrossRef::after {
+ content: "";
+}
+
+
+@page {
+ margin: 60pt 90pt 60pt 90pt;
+ font-family: sans-serif;
+ font-style:none;
+ color: gray;
+
+}
+
+.printTitle {
+ line-height:30pt;
+ font-size:27pt;
+ font-weight: bold;
+ letter-spacing: -.5px;
+ margin-bottom:25px;
+}
+
+.printSubtitle {
+ font-size: 19pt;
+ color: #cccccc !important;
+ font-family: "Grotesque MT Light";
+ line-height: 22pt;
+ letter-spacing: -.5px;
+ margin-bottom:20px;
+}
+.printTitleArea hr {
+ color: #999999 !important;
+ height: 2px;
+ width: 100%;
+}
+
+.printTitleImage {
+ max-width:300px;
+ margin-bottom:200px;
+}
+
+
+.printTitleImage {
+ max-width: 250px;
+}
+
+#navig {
+ /*page-break-before: always;*/
+}
+
+.copyrightBoilerplate {
+ page-break-before:always;
+ font-size:14px;
+}
+
+.lastGeneratedDate {
+ font-style: italic;
+ font-size:14px;
+ color: gray;
+}
+
+.alert a {
+ text-decoration: none !important;
+}
+
+
+body.title { page: title }
+
+@page title {
+ @top-left {
+ content: " ";
+ }
+ @top-right {
+ content: " "
+ }
+ @bottom-right {
+ content: " ";
+ }
+ @bottom-left {
+ content: " ";
+ }
+}
+
+body.frontmatter { page: frontmatter }
+body.frontmatter {counter-reset: page 1}
+
+
+@page frontmatter {
+ @top-left {
+ content: prince-script(guideName);
+ }
+ @top-right {
+ content: prince-script(datestamp);
+ }
+ @bottom-right {
+ content: counter(page, lower-roman);
+ }
+ @bottom-left {
+ content: "youremail@domain.com"; }
+}
+
+body.first_page {counter-reset: page 1}
+
+h1 { string-set: doctitle content() }
+
+@page {
+ @top-left {
+ content: string(doctitle);
+ font-size: 11px;
+ font-style: italic;
+ }
+ @top-right {
+ content: prince-script(datestamp);
+ font-size: 11px;
+ }
+
+ @bottom-right {
+ content: "Page " counter(page);
+ font-size: 11px;
+ }
+ @bottom-left {
+ content: prince-script(guideName);
+ font-size: 11px;
+ }
+}
+.alert {
+ background-color: #fafafa !important;
+ border-color: #dedede !important;
+ color: black;
+}
+
+pre {
+ background-color: #fafafa;
+}
diff --git a/2.0/css/swagger.css b/2.0/css/swagger.css
new file mode 100644
index 0000000..a478ff8
--- /dev/null
+++ b/2.0/css/swagger.css
@@ -0,0 +1,52 @@
+#swagger-ui .swagger-ui .wrapper {
+ /*max-width: 100%;*/
+}
+
+#swagger-ui .swagger-ui .wrapper p {
+ margin: 0;
+}
+#swagger-ui .swagger-ui .wrapper h2, #swagger-ui .swagger-ui .wrapper h3, #swagger-ui .swagger-ui .wrapper h4 {
+ font-weight: bold;
+ font-style: inherit;
+}
+
+#swagger-ui .swagger-ui.swagger-container .topbar {
+ background: none;
+}
+
+#swagger-ui .swagger-ui.swagger-container .topbar .topbar-wrapper a {
+ display: block;
+}
+
+#swagger-ui .swagger-ui.swagger-container .topbar .topbar-wrapper img {
+ display: none;
+}
+
+#swagger-ui .swagger-ui.swagger-container .topbar .topbar-wrapper select {
+ background-color: #ffffff;
+ border-color: black;
+}
+#swagger-ui .swagger-ui.swagger-container .topbar .topbar-wrapper .select-label {
+ color: #3b4151;
+}
+
+#swagger-ui .swagger-ui.swagger-container .scheme-container {
+ padding-top: 0;
+ padding-bottom: 15px;
+}
+
+#swagger-ui .information-container pre {
+ overflow: unset;
+ background: none;
+ border: 0;
+ padding: 0;
+ margin: 0;
+}
+
+#swagger-ui .information-container .info a {
+ display: inline-block;
+}
+
+#swagger-ui .information-container .info a > span {
+ display: none;
+}
diff --git a/2.0/css/syntax.css b/2.0/css/syntax.css
new file mode 100644
index 0000000..b1adf05
--- /dev/null
+++ b/2.0/css/syntax.css
@@ -0,0 +1,60 @@
+.highlight { background: #ffffff; }
+.highlight .c { color: #999988; font-style: italic } /* Comment */
+.highlight .err { color: #a61717; background-color: #e3d2d2 } /* Error */
+.highlight .k { font-weight: bold } /* Keyword */
+.highlight .o { font-weight: bold } /* Operator */
+.highlight .cm { color: #999988; font-style: italic } /* Comment.Multiline */
+.highlight .cp { color: #999999; font-weight: bold } /* Comment.Preproc */
+.highlight .c1 { color: #999988; font-style: italic } /* Comment.Single */
+.highlight .cs { color: #999999; font-weight: bold; font-style: italic } /* Comment.Special */
+.highlight .gd { color: #000000; background-color: #ffdddd } /* Generic.Deleted */
+.highlight .gd .x { color: #000000; background-color: #ffaaaa } /* Generic.Deleted.Specific */
+.highlight .ge { font-style: italic } /* Generic.Emph */
+.highlight .gr { color: #aa0000 } /* Generic.Error */
+.highlight .gh { color: #999999 } /* Generic.Heading */
+.highlight .gi { color: #000000; background-color: #ddffdd } /* Generic.Inserted */
+.highlight .gi .x { color: #000000; background-color: #aaffaa } /* Generic.Inserted.Specific */
+.highlight .go { color: #888888 } /* Generic.Output */
+.highlight .gp { color: #555555 } /* Generic.Prompt */
+.highlight .gs { font-weight: bold } /* Generic.Strong */
+.highlight .gu { color: #aaaaaa } /* Generic.Subheading */
+.highlight .gt { color: #aa0000 } /* Generic.Traceback */
+.highlight .kc { font-weight: bold } /* Keyword.Constant */
+.highlight .kd { font-weight: bold } /* Keyword.Declaration */
+.highlight .kp { font-weight: bold } /* Keyword.Pseudo */
+.highlight .kr { font-weight: bold } /* Keyword.Reserved */
+.highlight .kt { color: #445588; font-weight: bold } /* Keyword.Type */
+.highlight .m { color: #009999 } /* Literal.Number */
+.highlight .s { color: #3a8c9a } /* Literal.String */
+.highlight .na { color: #008080 } /* Name.Attribute */
+.highlight .nb { color: #0086B3 } /* Name.Builtin */
+.highlight .nc { color: #445588; font-weight: bold } /* Name.Class */
+.highlight .no { color: #008080 } /* Name.Constant */
+.highlight .ni { color: #800080 } /* Name.Entity */
+.highlight .ne { color: #990000; font-weight: bold } /* Name.Exception */
+.highlight .nf { color: #990000; font-weight: bold } /* Name.Function */
+.highlight .nn { color: #555555 } /* Name.Namespace */
+.highlight .nt { color: #000080 } /* Name.Tag */
+.highlight .nv { color: #008080 } /* Name.Variable */
+.highlight .ow { font-weight: bold } /* Operator.Word */
+.highlight .w { color: #bbbbbb } /* Text.Whitespace */
+.highlight .mf { color: #009999 } /* Literal.Number.Float */
+.highlight .mh { color: #009999 } /* Literal.Number.Hex */
+.highlight .mi { color: #009999 } /* Literal.Number.Integer */
+.highlight .mo { color: #009999 } /* Literal.Number.Oct */
+.highlight .sb { color: #0088cc } /* Literal.String.Backtick */
+.highlight .sc { color: #0088cc } /* Literal.String.Char */
+.highlight .sd { color: #0088cc } /* Literal.String.Doc */
+.highlight .s2 { color: #0088cc } /* Literal.String.Double */
+.highlight .se { color: #0088cc } /* Literal.String.Escape */
+.highlight .sh { color: #0088cc } /* Literal.String.Heredoc */
+.highlight .si { color: #0088cc } /* Literal.String.Interpol */
+.highlight .sx { color: #0088cc } /* Literal.String.Other */
+.highlight .sr { color: #0088cc } /* Literal.String.Regex */
+.highlight .s1 { color: #0088cc } /* Literal.String.Single */
+.highlight .ss { color: #0088cc } /* Literal.String.Symbol */
+.highlight .bp { color: #999999 } /* Name.Builtin.Pseudo */
+.highlight .vc { color: #008080 } /* Name.Variable.Class */
+.highlight .vg { color: #008080 } /* Name.Variable.Global */
+.highlight .vi { color: #008080 } /* Name.Variable.Instance */
+.highlight .il { color: #009999 } /* Literal.Number.Integer.Long */
diff --git a/2.0/css/theme-blue.css b/2.0/css/theme-blue.css
new file mode 100644
index 0000000..759417a
--- /dev/null
+++ b/2.0/css/theme-blue.css
@@ -0,0 +1,120 @@
+.summary {
+ color: #808080;
+ border-left: 5px solid #696969;
+ font-size:16px;
+}
+
+
+h3 {color: #696969; }
+h4 {color: #808080; }
+
+.nav-tabs > li.active > a, .nav-tabs > li.active > a:hover, .nav-tabs > li.active > a:focus {
+ background-color: #248ec2;
+ color: white;
+}
+
+.nav > li.active > a {
+ background-color: #347DBE;
+}
+
+.nav > li > a:hover {
+ background-color: #248ec2;
+}
+
+div.navbar-collapse .dropdown-menu > li > a:hover {
+ background-color: #347DBE;
+}
+
+.nav li.thirdlevel > a {
+ background-color: #FAFAFA !important;
+ color: #248EC2;
+ font-weight: bold;
+}
+
+a[data-toggle="tooltip"] {
+ color: #649345;
+ font-style: italic;
+ cursor: default;
+}
+
+.navbar-inverse {
+ background-color: #347DBE;
+ border-color: #015CAE;
+}
+.navbar-inverse .navbar-nav>li>a, .navbar-inverse .navbar-brand {
+ color: white;
+}
+
+.navbar-inverse .navbar-nav>li>a:hover, a.fa.fa-home.fa-lg.navbar-brand:hover {
+ color: #f0f0f0;
+}
+
+a.navbar-brand:hover {
+ color: #f0f0f0;
+}
+
+.navbar-inverse .navbar-nav > .open > a, .navbar-inverse .navbar-nav > .open > a:hover, .navbar-inverse .navbar-nav > .open > a:focus {
+ color: #015CAE;
+}
+
+.navbar-inverse .navbar-nav > .open > a, .navbar-inverse .navbar-nav > .open > a:hover, .navbar-inverse .navbar-nav > .open > a:focus {
+ background-color: #015CAE;
+ color: #ffffff;
+}
+
+.navbar-inverse .navbar-collapse, .navbar-inverse .navbar-form {
+ border-color: #248ec2 !important;
+}
+
+.btn-primary {
+ color: #ffffff;
+ background-color: #347DBE;
+ border-color: #347DBE;
+}
+
+.navbar-inverse .navbar-nav > .active > a, .navbar-inverse .navbar-nav > .active > a:hover, .navbar-inverse .navbar-nav > .active > a:focus {
+ background-color: #347DBE;
+}
+
+.btn-primary:hover,
+.btn-primary:focus,
+.btn-primary:active,
+.btn-primary.active,
+.open .dropdown-toggle.btn-primary {
+ background-color: #248ec2;
+ border-color: #347DBE;
+}
+
+.printTitle {
+ color: #015CAE !important;
+}
+
+body.print h1 {color: #015CAE !important; font-size:28px !important;}
+body.print h2 {color: #595959 !important; font-size:20px !important;}
+body.print h3 {color: #E50E51 !important; font-size:14px !important;}
+body.print h4 {color: #679DCE !important; font-size:14px; font-style: italic !important;}
+
+.anchorjs-link:hover {
+ color: #216f9b;
+}
+
+div.sidebarTitle {
+ color: #015CAE;
+}
+
+li.sidebarTitle {
+ margin-top:20px;
+ font-weight:normal;
+ font-size:130%;
+ margin-bottom:10px;
+ margin-left: 5px;
+
+}
+
+.navbar-inverse .navbar-toggle:focus, .navbar-inverse .navbar-toggle:hover {
+ background-color: #015CAE;
+}
+
+.navbar-inverse .navbar-toggle {
+ border-color: #015CAE;
+}
diff --git a/2.0/css/theme-ditto.css b/2.0/css/theme-ditto.css
new file mode 100644
index 0000000..2a1f0a7
--- /dev/null
+++ b/2.0/css/theme-ditto.css
@@ -0,0 +1,209 @@
+.summary {
+ color: #808080;
+ border-left: 5px solid #696969;
+ font-size:16px;
+}
+
+h2 {color: #3a8c9a; }
+h4 {color: #3a8c9a; }
+
+a {color: #3a8c9a;}
+code {
+ color: #3a8c9a;
+ background-color: #f5f5f5;}
+hr {color: #3a8c9a;}
+
+.nav-tabs > li.active > a, .nav-tabs > li.active > a:hover, .nav-tabs > li.active > a:focus {
+ background-color: #248ec2;
+ color: white;
+}
+
+.nav > li.active > a {
+ background-color: #3a8c9a;
+}
+
+.nav > li > a:hover {
+ background-color: #248ec2;
+}
+
+div.navbar-collapse .dropdown-menu > li > a:hover {
+ background-color: #3a8c9a;
+}
+
+.nav li.thirdlevel > a {
+ background-color: #FAFAFA !important;
+ color: #248EC2;
+ font-weight: bold;
+}
+
+a[data-toggle="tooltip"] {
+ color: #649345;
+ font-style: italic;
+ cursor: default;
+}
+
+.navbar-inverse {
+ background-color: #3a8c9a;
+ border-color: #3a8c9a;
+}
+.navbar-inverse .navbar-nav>li>a, .navbar-inverse .navbar-brand {
+ color: white;
+}
+
+.navbar-inverse .navbar-nav>li>a:hover, a.fa.fa-home.fa-lg.navbar-brand:hover {
+ color: #f0f0f0;
+}
+
+a.navbar-brand:hover {
+ color: #f0f0f0;
+}
+
+.navbar-inverse .navbar-nav > .open > a, .navbar-inverse .navbar-nav > .open > a:hover, .navbar-inverse .navbar-nav > .open > a:focus {
+ color: #015CAE;
+}
+
+.navbar-inverse .navbar-nav > .open > a, .navbar-inverse .navbar-nav > .open > a:hover, .navbar-inverse .navbar-nav > .open > a:focus {
+ background-color: #015CAE;
+ color: #ffffff;
+}
+
+.navbar-inverse .navbar-collapse, .navbar-inverse .navbar-form {
+ border-color: #000000 !important;
+}
+
+.btn-primary {
+ color: #ffffff;
+ background-color: #3a8c9a;
+ border-color: #3a8c9a;
+}
+
+.navbar-inverse .navbar-nav > .active > a, .navbar-inverse .navbar-nav > .active > a:hover, .navbar-inverse .navbar-nav > .active > a:focus {
+ background-color: #3a8c9a;
+}
+
+.btn-primary:hover,
+.btn-primary:focus,
+.btn-primary:active,
+.btn-primary.active,
+.open .dropdown-toggle.btn-primary {
+ background-color: #000000;
+ border-color: #3a8c9a;
+}
+
+.printTitle {
+ color: #3a8c9a !important;
+}
+
+body.print h1 {color: #3a8c9a !important; font-size:28px !important;}
+body.print h2 {color: #3a8c9a !important; font-size:20px !important;}
+body.print h3 {color: #3a8c9a !important; font-size:14px !important;}
+body.print h4 {color: #3a8c9a !important; font-size:14px; font-style: italic !important;}
+
+.anchorjs-link:hover {
+ color: #216f9b;
+}
+
+div.sidebarTitle {
+ color: #015CAE;
+}
+
+li.sidebarTitle {
+ margin-top:20px;
+ font-weight:normal;
+ font-size:130%;
+ margin-bottom:10px;
+ margin-left: 5px;
+}
+
+li.sidebarTitle label {
+ font-weight:normal;
+}
+
+li.sidebarTitle .select-wrapper {
+
+}
+
+li.sidebarTitle .select-wrapper select {
+ background-color: #3a8c9a;
+ color: white;
+ padding: 8px;
+ width: 100%;
+ border: none;
+ font-size: 20px;
+ box-shadow: 0 5px 25px rgba(0, 0, 0, 0.2);
+ -webkit-appearance: none;
+ -moz-appearance: none;
+ appearance: none;
+ outline: none;
+}
+
+li.sidebarTitle .select-wrapper::before {
+ content: "\f13a";
+ font-family: FontAwesome;
+ position: absolute;
+ right: 0;
+ width: 20%;
+ text-align: center;
+ font-size: 28px;
+ line-height: 45px;
+ color: rgba(255, 255, 255, 0.5);
+ background-color: rgba(255, 255, 255, 0.1);
+ pointer-events: none;
+}
+
+li.sidebarTitle .select-wrapper::before {
+ color: rgba(255, 255, 255, 0.6);
+ background-color: rgba(255, 255, 255, 0.2);
+}
+
+li.sidebarTitle .select-wrapper select option {
+ padding: 30px;
+}
+
+.navbar-inverse .navbar-toggle:focus, .navbar-inverse .navbar-toggle:hover {
+ background-color: #000000;
+}
+
+.navbar-inverse .navbar-toggle {
+ border-color: #ffffff;
+}
+
+ul.nav.navbar-nav.navbar-right img {
+ height: 20px;
+ padding-right: 5px;
+}
+
+/* info , tip box with icon - warning stays red*/
+.alert-info {
+ color: #3a8c9a;
+ background-color: white;
+ border-color: #3a8c9a;
+}
+
+.alert-success {
+ color: #3a8c9a;
+ background-color: white;
+ border-color: #3a8c9a;
+}
+
+.info-container .row .panel .panel-body {
+ height: 12em;
+}
+
+@media (max-width: 1199px) {
+ .info-container .row .panel .panel-body {
+ height: 14em;
+ }
+}
+
+@media (max-width: 990px) {
+ .info-container .row .panel .panel-body {
+ height: 12em;
+ }
+}
+
+@media (max-width: 767px) {
+ .info-container .row .panel .panel-body {
+ height: auto;
+ }
+}
diff --git a/2.0/css/theme-green.css b/2.0/css/theme-green.css
new file mode 100644
index 0000000..162e6a3
--- /dev/null
+++ b/2.0/css/theme-green.css
@@ -0,0 +1,110 @@
+.summary {
+ color: #808080;
+ border-left: 5px solid #E50E51;
+ font-size:16px;
+}
+
+
+h3 {color: #E50E51; }
+h4 {color: #808080; }
+
+.nav-tabs > li.active > a, .nav-tabs > li.active > a:hover, .nav-tabs > li.active > a:focus {
+ background-color: #248ec2;
+ color: white;
+}
+
+.nav > li.active > a {
+ background-color: #72ac4a;
+}
+
+.nav > li > a:hover {
+ background-color: #72ac4a;
+}
+
+div.navbar-collapse .dropdown-menu > li > a:hover {
+ background-color: #72ac4a;
+}
+
+.navbar-inverse .navbar-nav>li>a, .navbar-inverse .navbar-brand {
+ color: white;
+}
+
+.navbar-inverse .navbar-nav>li>a:hover, a.fa.fa-home.fa-lg.navbar-brand:hover {
+ color: #f0f0f0;
+}
+
+.nav li.thirdlevel > a {
+ background-color: #FAFAFA !important;
+ color: #72ac4a;
+ font-weight: bold;
+}
+
+a[data-toggle="tooltip"] {
+ color: #649345;
+ font-style: italic;
+ cursor: default;
+}
+
+.navbar-inverse {
+ background-color: #72ac4a;
+ border-color: #5b893c;
+}
+
+.navbar-inverse .navbar-nav > .open > a, .navbar-inverse .navbar-nav > .open > a:hover, .navbar-inverse .navbar-nav > .open > a:focus {
+ color: #5b893c;
+}
+
+.navbar-inverse .navbar-nav > .open > a, .navbar-inverse .navbar-nav > .open > a:hover, .navbar-inverse .navbar-nav > .open > a:focus {
+ background-color: #5b893c;
+ color: #ffffff;
+}
+
+/* not sure if using this ...*/
+.navbar-inverse .navbar-collapse, .navbar-inverse .navbar-form {
+ border-color: #72ac4a !important;
+}
+
+.btn-primary {
+ color: #ffffff;
+ background-color: #5b893c;
+ border-color: #5b893c;
+}
+
+.btn-primary:hover,
+.btn-primary:focus,
+.btn-primary:active,
+.btn-primary.active,
+.open .dropdown-toggle.btn-primary {
+ background-color: #72ac4a;
+ border-color: #5b893c;
+}
+
+.printTitle {
+ color: #5b893c !important;
+}
+
+body.print h1 {color: #5b893c !important; font-size:28px;}
+body.print h2 {color: #595959 !important; font-size:24px;}
+body.print h3 {color: #E50E51 !important; font-size:14px;}
+body.print h4 {color: #679DCE !important; font-size:14px; font-style: italic;}
+
+.anchorjs-link:hover {
+ color: #4f7233;
+}
+
+div.sidebarTitle {
+ color: #E50E51;
+}
+
+li.sidebarTitle {
+ margin-top:20px;
+ font-weight:normal;
+ font-size:130%;
+ color: #696969;
+ margin-bottom:10px;
+ margin-left: 5px;
+}
+
+.navbar-inverse .navbar-toggle:focus, .navbar-inverse .navbar-toggle:hover {
+ background-color: #E50E51;
+}
diff --git a/2.0/docson/LICENSE b/2.0/docson/LICENSE
new file mode 100644
index 0000000..e06d208
--- /dev/null
+++ b/2.0/docson/LICENSE
@@ -0,0 +1,202 @@
+Apache License
+ Version 2.0, January 2004
+ http://www.apache.org/licenses/
+
+ TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+ 1. Definitions.
+
+ "License" shall mean the terms and conditions for use, reproduction,
+ and distribution as defined by Sections 1 through 9 of this document.
+
+ "Licensor" shall mean the copyright owner or entity authorized by
+ the copyright owner that is granting the License.
+
+ "Legal Entity" shall mean the union of the acting entity and all
+ other entities that control, are controlled by, or are under common
+ control with that entity. For the purposes of this definition,
+ "control" means (i) the power, direct or indirect, to cause the
+ direction or management of such entity, whether by contract or
+ otherwise, or (ii) ownership of fifty percent (50%) or more of the
+ outstanding shares, or (iii) beneficial ownership of such entity.
+
+ "You" (or "Your") shall mean an individual or Legal Entity
+ exercising permissions granted by this License.
+
+ "Source" form shall mean the preferred form for making modifications,
+ including but not limited to software source code, documentation
+ source, and configuration files.
+
+ "Object" form shall mean any form resulting from mechanical
+ transformation or translation of a Source form, including but
+ not limited to compiled object code, generated documentation,
+ and conversions to other media types.
+
+ "Work" shall mean the work of authorship, whether in Source or
+ Object form, made available under the License, as indicated by a
+ copyright notice that is included in or attached to the work
+ (an example is provided in the Appendix below).
+
+ "Derivative Works" shall mean any work, whether in Source or Object
+ form, that is based on (or derived from) the Work and for which the
+ editorial revisions, annotations, elaborations, or other modifications
+ represent, as a whole, an original work of authorship. For the purposes
+ of this License, Derivative Works shall not include works that remain
+ separable from, or merely link (or bind by name) to the interfaces of,
+ the Work and Derivative Works thereof.
+
+ "Contribution" shall mean any work of authorship, including
+ the original version of the Work and any modifications or additions
+ to that Work or Derivative Works thereof, that is intentionally
+ submitted to Licensor for inclusion in the Work by the copyright owner
+ or by an individual or Legal Entity authorized to submit on behalf of
+ the copyright owner. For the purposes of this definition, "submitted"
+ means any form of electronic, verbal, or written communication sent
+ to the Licensor or its representatives, including but not limited to
+ communication on electronic mailing lists, source code control systems,
+ and issue tracking systems that are managed by, or on behalf of, the
+ Licensor for the purpose of discussing and improving the Work, but
+ excluding communication that is conspicuously marked or otherwise
+ designated in writing by the copyright owner as "Not a Contribution."
+
+ "Contributor" shall mean Licensor and any individual or Legal Entity
+ on behalf of whom a Contribution has been received by Licensor and
+ subsequently incorporated within the Work.
+
+ 2. Grant of Copyright License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ copyright license to reproduce, prepare Derivative Works of,
+ publicly display, publicly perform, sublicense, and distribute the
+ Work and such Derivative Works in Source or Object form.
+
+ 3. Grant of Patent License. Subject to the terms and conditions of
+ this License, each Contributor hereby grants to You a perpetual,
+ worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+ (except as stated in this section) patent license to make, have made,
+ use, offer to sell, sell, import, and otherwise transfer the Work,
+ where such license applies only to those patent claims licensable
+ by such Contributor that are necessarily infringed by their
+ Contribution(s) alone or by combination of their Contribution(s)
+ with the Work to which such Contribution(s) was submitted. If You
+ institute patent litigation against any entity (including a
+ cross-claim or counterclaim in a lawsuit) alleging that the Work
+ or a Contribution incorporated within the Work constitutes direct
+ or contributory patent infringement, then any patent licenses
+ granted to You under this License for that Work shall terminate
+ as of the date such litigation is filed.
+
+ 4. Redistribution. You may reproduce and distribute copies of the
+ Work or Derivative Works thereof in any medium, with or without
+ modifications, and in Source or Object form, provided that You
+ meet the following conditions:
+
+ (a) You must give any other recipients of the Work or
+ Derivative Works a copy of this License; and
+
+ (b) You must cause any modified files to carry prominent notices
+ stating that You changed the files; and
+
+ (c) You must retain, in the Source form of any Derivative Works
+ that You distribute, all copyright, patent, trademark, and
+ attribution notices from the Source form of the Work,
+ excluding those notices that do not pertain to any part of
+ the Derivative Works; and
+
+ (d) If the Work includes a "NOTICE" text file as part of its
+ distribution, then any Derivative Works that You distribute must
+ include a readable copy of the attribution notices contained
+ within such NOTICE file, excluding those notices that do not
+ pertain to any part of the Derivative Works, in at least one
+ of the following places: within a NOTICE text file distributed
+ as part of the Derivative Works; within the Source form or
+ documentation, if provided along with the Derivative Works; or,
+ within a display generated by the Derivative Works, if and
+ wherever such third-party notices normally appear. The contents
+ of the NOTICE file are for informational purposes only and
+ do not modify the License. You may add Your own attribution
+ notices within Derivative Works that You distribute, alongside
+ or as an addendum to the NOTICE text from the Work, provided
+ that such additional attribution notices cannot be construed
+ as modifying the License.
+
+ You may add Your own copyright statement to Your modifications and
+ may provide additional or different license terms and conditions
+ for use, reproduction, or distribution of Your modifications, or
+ for any such Derivative Works as a whole, provided Your use,
+ reproduction, and distribution of the Work otherwise complies with
+ the conditions stated in this License.
+
+ 5. Submission of Contributions. Unless You explicitly state otherwise,
+ any Contribution intentionally submitted for inclusion in the Work
+ by You to the Licensor shall be under the terms and conditions of
+ this License, without any additional terms or conditions.
+ Notwithstanding the above, nothing herein shall supersede or modify
+ the terms of any separate license agreement you may have executed
+ with Licensor regarding such Contributions.
+
+ 6. Trademarks. This License does not grant permission to use the trade
+ names, trademarks, service marks, or product names of the Licensor,
+ except as required for reasonable and customary use in describing the
+ origin of the Work and reproducing the content of the NOTICE file.
+
+ 7. Disclaimer of Warranty. Unless required by applicable law or
+ agreed to in writing, Licensor provides the Work (and each
+ Contributor provides its Contributions) on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+ implied, including, without limitation, any warranties or conditions
+ of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+ PARTICULAR PURPOSE. You are solely responsible for determining the
+ appropriateness of using or redistributing the Work and assume any
+ risks associated with Your exercise of permissions under this License.
+
+ 8. Limitation of Liability. In no event and under no legal theory,
+ whether in tort (including negligence), contract, or otherwise,
+ unless required by applicable law (such as deliberate and grossly
+ negligent acts) or agreed to in writing, shall any Contributor be
+ liable to You for damages, including any direct, indirect, special,
+ incidental, or consequential damages of any character arising as a
+ result of this License or out of the use or inability to use the
+ Work (including but not limited to damages for loss of goodwill,
+ work stoppage, computer failure or malfunction, or any and all
+ other commercial damages or losses), even if such Contributor
+ has been advised of the possibility of such damages.
+
+ 9. Accepting Warranty or Additional Liability. While redistributing
+ the Work or Derivative Works thereof, You may choose to offer,
+ and charge a fee for, acceptance of support, warranty, indemnity,
+ or other liability obligations and/or rights consistent with this
+ License. However, in accepting such obligations, You may act only
+ on Your own behalf and on Your sole responsibility, not on behalf
+ of any other Contributor, and only if You agree to indemnify,
+ defend, and hold each Contributor harmless for any liability
+ incurred by, or claims asserted against, such Contributor by reason
+ of your accepting any such warranty or additional liability.
+
+ END OF TERMS AND CONDITIONS
+
+ APPENDIX: How to apply the Apache License to your work.
+
+ To apply the Apache License to your work, attach the following
+ boilerplate notice, with the fields enclosed by brackets "{}"
+ replaced with your own identifying information. (Don't include
+ the brackets!) The text should be enclosed in the appropriate
+ comment syntax for the file format. We also recommend that a
+ file or class name and description of purpose be included on the
+ same "printed page" as the copyright notice for easier
+ identification within third-party archives.
+
+ Copyright {yyyy} {name of copyright owner}
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+
diff --git a/2.0/docson/README.md b/2.0/docson/README.md
new file mode 100644
index 0000000..2b1de69
--- /dev/null
+++ b/2.0/docson/README.md
@@ -0,0 +1,114 @@
+<p align='right'>A <a href="http://www.swisspush.org">swisspush</a> project <a href="http://www.swisspush.org" border=0><img align="top" src='https://1.gravatar.com/avatar/cf7292487846085732baf808def5685a?s=32'></a></p>
+Docson
+======
+
+Documentation for your JSON types.
+
+Give Docson a JSON schema and it will generate a [beautiful documentation](http://lbovet.github.io/docson/index.html#/docson/examples/example.json).
+
+## Features
+* [JSON schema](http://json-schema.org/) v4 keywords.
+* Runs entirely in the browser.
+* Render schema descriptions with markdown
+
+## Installation
+
+* Place the Docson distribution on the web server serving the schemas (to avoid cross-origin issues).
+
+## Usage
+
+* Open [index.html](http://lbovet.github.io/docson/index.html) and enter the schema path in the form field.
+* Or give the schema path directly as hash parameter: [index.html#/docson/examples/example.json](http://lbovet.github.io/docson/index.html#/docson/examples/example.json)
+
+Note that you can refer to a sub-schema by adding a json-pointer path as 'dollar-parameter': [index.html#/docson/examples/example.json$items](http://lbovet.github.io/docson/index.html#/docson/examples/example.json$items)
+
+## Typson
+
+You can directly reference your JSON types defined as TypeScript interfaces. If the path ends with `.ts`, Docson will use [Typson](https://github.com/lbovet/typson) to convert the Type Scripts to schema in order to generate the documentation.
+
+For example, [index.html#/typson/example/invoice/line.ts$InvoiceLine](http://lbovet.github.io/docson/index.html#/typson/example/invoice/line.ts$InvoiceLine) is the documentation of [line.ts](https://github.com/lbovet/typson/blob/master/example/invoice/line.ts).
+
+You need to install [Typson](https://github.com/lbovet/typson) by yourself on your server. It must be in a directory named `typson` located at the same level as the `docson` directory.
+
+## Widget
+
+To include a Docson schema documentations on any page (wiki, ...) without worrying about messing up with javascript libraries and cross-origin issues:
+
+* Install Docson somewhere as described above.
+* Place the following `script` tags in the including page, nothing else is needed:
+
+```
+<script src="http://somewhere/path-to-docson/widget.js" data-schema="/path-to-schema">
+</script>
+```
+
+See the [widget example](http://jsfiddle.net/3kXu2/3/) on jsfiddle.
+
+## Swagger
+
+You can adapt [Swagger UI](https://github.com/wordnik/swagger-ui) to display Docson-generated model documentation instead of the builtin signatures.
+
+See how it looks like in the [Swagger Docson example](http://lbovet.github.io/swagger-ui/dist/index.html)
+
+In Swagger UI's `index.html`, include the [Swagger integration script after other script tags](https://github.com/lbovet/swagger-ui/blob/3f37722b03db6c48cc2a8460df26dda5f4d6f8e4/src/main/html/index.html#L19):
+```
+ <script src='/path-to-docson/docson-swagger.js' type='text/javascript'></script>
+```
+
+Also, you will need a patched version of [Swagger Client](https://github.com/lbovet/swagger-js/blob/models-exposed/lib/swagger.js) so that the raw json-schema model is visible from Docson. Either replace the `swagger.js` file in your Swagger UI disctribution or take it directly from github by replacing
+
+```
+ <script src='/lib/swagger.js' type='text/javascript'></script>
+```
+
+with
+
+```
+ <script src='https://raw2.github.com/lbovet/swagger-js/models-exposed/lib/swagger.js' type='text/javascript'></script>
+```
+
+For a better layout of parameter models, you may [want to change the width of some elements](https://github.com/lbovet/swagger-ui/blob/3f37722b03db6c48cc2a8460df26dda5f4d6f8e4/src/main/html/index.html#L20-L27):
+
+```
+ <style>
+ .swagger-ui-wrap {
+ max-width: 1200px;
+ }
+ .swagger-ui-wrap .body-textarea {
+ width: 200px;
+ }
+ </style>
+```
+
+## Integration
+
+You can also integrate Docson in your application and use its javascript API:
+
+```javascript
+docson.doc(element, schema, ref)
+```
+
+* `element` is the element which will host the documentation. Either a DOM element (id or object) or jQuery element.
+* `schema` is the URI or path to the schema or a string containing the schema source itself.
+* `ref` is an optional json-pointer path to a sub-schema.
+
+Examples:
+* [Simple integration example](http://lbovet.github.io/docson/examples/example.html)
+* [See it in action](http://lbovet.github.io/typson-demo/) with its buddy [typson](https://github.com/lbovet/typson).
+
+## Limitations
+
+* Mixing unrelated keywords can lead to unexpected results.
+
+Not implemented:
+* Non-primitive values in enums and default values
+* dependencies, additionalItems, patternProperties
+
+## Development
+
+* [All tests](http://lbovet.github.io/docson/tests/test.html)
+
+Please pull-request your failing schemas in the `tests/` folder and open an issue describing the expected result.
+
+[](https://bitdeli.com/free "Bitdeli Badge")
+
diff --git a/2.0/docson/bower.json b/2.0/docson/bower.json
new file mode 100644
index 0000000..847e758
--- /dev/null
+++ b/2.0/docson/bower.json
@@ -0,0 +1,25 @@
+{
+ "name": "docson",
+ "main": "docson.js",
+ "version": "0.1.0",
+ "homepage": "https://github.com/lbovet/docson",
+ "authors": [
+ "Laurent Bovet <laurent.bovet@windmaster.ch>"
+ ],
+ "description": "Documentation for your JSON types",
+ "moduleType": [
+ "amd"
+ ],
+ "keywords": [
+ "docson",
+ "json"
+ ],
+ "license": "http://www.apache.org/licenses/LICENSE-2.0",
+ "ignore": [
+ "**/.*",
+ "node_modules",
+ "bower_components",
+ "test",
+ "tests"
+ ]
+}
diff --git a/2.0/docson/css/docson.css b/2.0/docson/css/docson.css
new file mode 100644
index 0000000..f780de1
--- /dev/null
+++ b/2.0/docson/css/docson.css
@@ -0,0 +1,476 @@
+/*
+ * Copyright 2013 Laurent Bovet <laurent.bovet@windmaster.ch>
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+.docson {
+ font-family: Open Sans, sans-serif;
+ font-size: 13px;
+ padding: 6px 6px 6px 6px;
+}
+
+.docson .box {
+ position: relative;
+ float: left;
+ background-color:rgba(255, 255, 255, 0.2);
+ border: 1px solid lightgrey;
+ border-radius: 4px;
+ -moz-border-radius: 4px;
+ -webkit-border-radius: 4px;
+ padding-bottom: 10px;
+ -moz-box-shadow: 1px 1px 1px darkgray;
+ -webkit-box-shadow: 1px 1px 1px darkgray;
+ box-shadow: 1px 1px 1px darkgray;
+}
+
+.docson .expand-button {
+ position: absolute;
+ margin-top: 15px;
+ padding: 2px;
+ right: 2px;
+ float: right;
+ width: 18px;
+ text-align: center;
+ cursor: pointer;
+ font-weight: bold;
+ font-family: "Lucida Console", Monaco, monospace;
+ font-size: 15px;
+ color: darkgray;
+ display: none;
+}
+
+.docson .source-button {
+ position: absolute;
+ padding: 2px;
+ margin-top: 3px;
+ right: 2px;
+ width: 18px;
+ text-align: center;
+ cursor: pointer;
+ font-weight: bold;
+ font-family: "Lucida Console", Monaco, monospace;
+ font-size: 10px;
+ color: darkgray;
+ display: none;
+}
+
+.docson .box-header {
+ padding: 6px;
+ border-top-left-radius: 4px;
+ border-top-right-radius: 4px;
+ border-bottom: 1px solid lightgrey;
+ background: whitesmoke;
+ /* background: -webkit-linear-gradient(ghostwhite, whitesmoke, whitesmoke, gainsboro);
+ background: -moz-linear-gradient(ghostwhite, whitesmoke, whitesmoke, gainsboro);*/
+}
+
+.docson .box-name {
+ color: darkblue;
+ padding: 5px 40px 2px 3px;
+ float: left;
+}
+
+.docson .title {
+ margin-top: -3px;
+ font-size: 120%;
+}
+
+.docson .link {
+ text-decoration: underline;
+}
+
+.docson .box-description {
+ color: dimgray;
+ float: left;
+ max-width: 600px;
+}
+
+.docson .end {
+ clear: both;
+}
+
+.docson .error {
+ color: red;
+}
+
+.docson .box-body {
+ padding-left: 10px;
+ padding-right: 28px;
+ clear: both;
+}
+
+.docson .box-1 {
+ background: whitesmoke;/*
+ background: -webkit-linear-gradient(ghostwhite, whitesmoke, whitesmoke, gainsboro);
+ background: -moz-linear-gradient(ghostwhite, whitesmoke, whitesmoke, gainsboro);*/
+}
+
+.docson .box-2 {
+ background: beige;
+ background: -webkit-linear-gradient(white, beige, beige, gainsboro);
+ background: -moz-linear-gradient(white, beige, beige, gainsboro);
+}
+
+.docson .box-3 {
+ background: azure;
+ background: -webkit-linear-gradient(white, azure, azure, gainsboro);
+ background: -moz-linear-gradient(white, azure, azure, gainsboro);
+}
+
+.docson .box-4 {
+ background: mistyrose;
+ background: -webkit-linear-gradient(white, mistyrose, mistyrose, gainsboro);
+ background: -moz-linear-gradient(white, mistyrose, mistyrose, gainsboro);
+}
+
+.docson .box-5 {
+ background: #ddffee;
+ background: -webkit-linear-gradient(white, #ddffee, #ddffee, gainsboro);
+ background: -moz-linear-gradient(white, #ddffee, #ddffee, gainsboro);
+}
+
+.docson .box-6 {
+ background: ghostwhite;
+ background: -webkit-linear-gradient(white, ghostwhite, ghostwhite, gainsboro);
+ background: -moz-linear-gradient(white, ghostwhite, ghostwhite, gainsboro);
+}
+
+.docson .box-7 {
+ background: lavenderblush;
+ background: -webkit-linear-gradient(white, lavenderblush, lavenderblush, gainsboro);
+ background: -moz-linear-gradient(white, lavenderblush, lavenderblush, gainsboro);
+}
+
+.docson .box-8 {
+ background: aliceblue;
+ background: -webkit-linear-gradient(white, aliceblue, aliceblue, gainsboro);
+ background: -moz-linear-gradient(white, aliceblue, aliceblue, gainsboro);
+}
+
+.docson .signature {
+ padding-top: 5px;
+ clear: left;
+}
+
+.docson .signature-header {
+ padding-top: 3px;
+ height: 20px;
+ line-height: 24px;
+}
+
+.docson .property-name {
+ float: left;
+ font-family: "Lucida Console", Monaco, monospace;
+ min-width: 130px;
+}
+
+.docson .required {
+ font-weight: bold;
+}
+
+.docson .type-keyword {
+ font-size: 80%;
+ color: dimgray;
+}
+
+.docson .type-pattern {
+ font-size: 80%;
+ color: darkolivegreen;
+}
+
+.docson .type-enum {
+ color: purple;
+ font-family: "Lucida Console", Monaco, monospace;
+ font-size: 90%;
+ padding-left: 2px;
+}
+
+.docson .type-default {
+ color: darkslategrey;
+ font-family: "Lucida Console", Monaco, monospace;
+}
+
+.docson .signature-type {
+ padding-left: 6px;
+ float: left;
+ min-width: 160px;
+ max-width: 320px;
+}
+
+.docson .signature-type-any {
+ font-style: italic;
+}
+
+.docson .signature-type-string {
+ color: green;
+}
+
+.docson .signature-type-number {
+ color: blue;
+}
+
+.docson .signature-type-integer {
+ color: blueviolet;
+}
+
+.docson .signature-type-boolean {
+ color: orangered;
+}
+
+.docson .signature-type-null {
+ font-family: "Lucida Console", Monaco, monospace;
+ color: red;
+}
+
+.docson .signature-type-date-time {
+ color: #224466;
+}
+
+.docson .signature-type-email {
+ color: cornflowerblue;
+}
+
+.docson .signature-type-hostname {
+ color: darkolivegreen;
+}
+
+.docson .signature-type-ipv6 {
+ color: darkslateblue;
+}
+
+.docson .signature-type-ipv4 {
+ color: indigo;
+}
+
+.docson .signature-type-uri {
+ color: saddlebrown;
+}
+
+.docson .signature-button {
+ cursor: pointer;
+ padding: 4px;
+ border-radius: 4px;
+ border: 1px solid lightgrey;
+ -moz-border-radius: 4px;
+}
+
+.docson .signature-type-ref {
+ color: darkblue;
+}
+
+.docson .signature-type-expanded {
+ padding: 5px 3px 3px 5px;
+ vertical-align: -1px;
+ opacity: 0.6;
+ -moz-box-shadow: inset 1px 1px 1px darkgray;
+ -webkit-box-shadow: inset 1px 1px 1px darkgray;
+ box-shadow: inset 1px 1px 1px darkgray;
+}
+
+.docson .signature-description {
+ padding-left: 6px;
+ padding-bottom: 3px;
+ color: dimgray;
+ float: left;
+ max-width: 600px;
+}
+
+.docson .signature-box-container {
+ clear: both;
+}
+
+.docson .box-container {
+ float: left;
+ padding-top: 4px;
+ padding-left: 8px;
+ display: none;
+}
+
+.docson .button {
+ -webkit-touch-callout: none;
+ -webkit-user-select: none;
+ -khtml-user-select: none;
+ -moz-user-select: none;
+ -ms-user-select: none;
+ user-select: none;
+}
+
+.docson .button:hover {
+ color: darkred;
+}
+
+@media all and (min-width: 20px) and (max-width: 500px) {
+ .docson .property-name {
+ min-width: 0px;
+ }
+ .docson .signature-type {
+ min-width: 0px;
+ }
+ .docson .source {
+ width: 100%;
+ }
+ .docson .box-container, .box {
+ width: 100%;
+ }
+}
+
+.docson .desc {
+ padding-left: 6px;
+ line-height: 17px;
+}
+
+.docson .desc p {
+ margin: 0;
+ margin-top: 3px;
+}
+
+.docson .desc code {
+ color: purple;
+ font-size: 90%;
+}
+
+
+.docson .desc table {
+ margin-top: 4px;
+ margin-bottom: 4px;
+ border-collapse:collapse;
+}
+
+.docson .desc th {
+ padding: 0px;
+ font-size: 80%;
+ font-weight: normal;
+ background: rgba(231, 231, 231, 0.5);
+}
+
+.docson .desc table,
+.docson .desc th,
+.docson .desc td {
+ border: 1px solid lightgrey;
+}
+
+.docson .desc tr > td {
+ padding: 2px 6px 2px 6px;
+}
+
+.docson .desc h1 {
+ font-size: 120%;
+ margin-top: 0px;
+ margin-bottom: 3px;
+}
+
+.docson .desc h2 {
+ font-size: 115%;
+ margin-top: 0px;
+ margin-bottom: 3px;
+}
+
+.docson .desc h3 {
+ font-size: 110%;
+ margin-top: 0px;
+ margin-bottom: 3px;
+}
+
+.docson .desc h4 {
+ font-size: 100%;
+ margin-top: 0px;
+ margin-bottom: 3px;
+}
+
+.docson .desc pre {
+ border: 1px solid lightgray;
+ border-radius: 4px;
+ -webkit-border-radius: 4px;
+ -moz-border-radius: 4px;
+ padding: 4px;
+ margin: 3px 0px;
+}
+
+.docson .desc ul {
+ padding-left: 16px;
+ margin: 3px 0px;
+}
+
+.docson .desc ol {
+ padding-left: 16px;
+ margin: 3px 0px;
+}
+
+.docson .desc blockquote {
+ margin: 3px 0px 3px 10px;
+ padding-left: 6px;
+ border-left: 1px solid lightgray;
+}
+
+.docson .desc img {
+ vertical-align: middle;
+}
+
+.docson .desc hr {
+ border: 0;
+ height: 1px;
+ background: lightgrey;
+ color: lightgrey;
+ width: 50%;
+}
+
+.docson .source {
+ display: none;
+ padding-left: 16px;
+ padding-right: 30px;
+}
+
+.docson .json, .json-schema {
+ font-family: "Lucida Console", Monaco, monospace;
+}
+
+.docson .json-punctuation {
+ font-weight: bold;
+}
+
+.docson .json-null, .json-true, .json-false {
+ font-weight: bold;
+}
+
+.docson .json-true {
+ color: #080;
+}
+
+.docson .json-false {
+ color: #800;
+}
+
+.docson .json-object-key {
+ color: #246;
+}
+
+.docson .json-keyword {
+ font-weight: bold;
+ color: #036;
+}
+
+.docson .json-number {
+ font-weight: bold;
+ color: #660;
+}
+
+.docson .json-string {
+ color: #800;
+}
+
+.docson .json-schema-map > .json-object-key {
+ color: #080;
+ font-style: italic;
+}
+
diff --git a/2.0/docson/docson-swagger.js b/2.0/docson/docson-swagger.js
new file mode 100644
index 0000000..80ffaaf
--- /dev/null
+++ b/2.0/docson/docson-swagger.js
@@ -0,0 +1,67 @@
+/*
+ * Copyright 2013 Laurent Bovet <laurent.bovet@windmaster.ch>
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+var allDefinitions;
+var counter = 0;
+
+function createDoc(definitions, type) {
+ counter++;
+ var docson = "/docson/index.html";
+ if(!allDefinitions) {
+ allDefinitions = {};
+ function receiveMessage(event) {
+ if (event.data.id && event.data.id == "docson") {
+ var frame = $("#docson-"+event.data.url.split("$")[2]);
+ if (event.data.action == "resized") {
+ frame.get(0).width = event.data.width + 18;
+ frame.get(0).height = event.data.height + 36;
+ frame.parents("td").width(event.data.width + 24)
+ }
+ if (event.data.action == "ready") {
+ frame.get(0).contentWindow.postMessage({ id: "docson", action: "load", definitions: allDefinitions, type: event.data.url.split("$")[1]}, "*");
+ }
+ }
+ }
+ window.addEventListener("message", receiveMessage, false);
+ }
+ $.extend(allDefinitions, definitions);
+ return "<iframe class='docson-frame' id='docson-" + counter + "' style='padding: 0; border: 0; width:100%; background: transparent' src='" + docson + "#$" + type + "$"+counter+"'></iframe>"
+}
+
+SwaggerOperation.prototype.getSignature = function(type, models) {
+ var collectionType, isPrimitive;
+ if(this.isCollectionType) {
+ collectionType = this.isCollectionType(type);
+ } else {
+ collectionType = this.isListType(type);
+ }
+ isPrimitive = ((collectionType != null) && models[collectionType]) || (models[type] != null) ? false : true;
+ if (isPrimitive) {
+ return type;
+ } else {
+ if (collectionType != null) {
+ return "<p class='stronger'>" + type + "</p>" + createDoc(this.resource.rawModels, collectionType);
+ } else {
+ return createDoc(this.resource.rawModels, type);
+ }
+ }
+};
+
+$(document).on("click", ".toggleOperation", function() {
+ $(this).parents(".operations").find(".docson-frame").each(function(k, frame) {
+ frame.contentWindow.postMessage({id: "docson", action: "resize"}, "*");
+ });
+});
diff --git a/2.0/docson/docson.js b/2.0/docson/docson.js
new file mode 100644
index 0000000..93d7d09
--- /dev/null
+++ b/2.0/docson/docson.js
@@ -0,0 +1,512 @@
+/*
+ * Copyright 2013 Laurent Bovet <laurent.bovet@windmaster.ch>
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+var docson = docson || {};
+
+docson.templateBaseUrl="templates";
+
+define(["lib/jquery", "lib/handlebars", "lib/highlight", "lib/jsonpointer", "lib/marked", "lib/traverse"], function(jquery, handlebars, highlight, jsonpointer, marked) {
+
+ var ready = $.Deferred();
+ var boxTemplate;
+ var signatureTemplate;
+ var source;
+ var stack = [];
+ var boxes=[];
+
+ Handlebars.registerHelper('scope', function(schema, options) {
+ var result;
+ boxes.push([]);
+ if(schema && (schema.id || schema.root)) {
+ stack.push( schema );
+ result = options.fn(this);
+ stack.pop();
+ } else {
+ result = options.fn(this);
+ }
+ boxes.pop();
+ return result;
+ });
+
+ Handlebars.registerHelper('source', function(schema) {
+ delete schema.root;
+ delete schema.__boxId;
+ delete schema.__name;
+ delete schema.__ref;
+ return JSON.stringify(schema, null, 2);
+ });
+
+ Handlebars.registerHelper('desc', function(schema) {
+ var description = schema.description;
+
+ if( !description ) return "";
+ var text = description;
+ if(marked) {
+ marked.setOptions({gfm: true, breaks: true})
+ return new Handlebars.SafeString(marked(text));
+ } else {
+ return text;
+ }
+ });
+
+ Handlebars.registerHelper('equals', function(lvalue, rvalue, options) {
+ if (arguments.length < 3)
+ throw new Error("Handlebars Helper equals needs 2 parameters");
+ if( lvalue!=rvalue ) {
+ return options.inverse(this);
+ } else {
+ return options.fn(this);
+ }
+ });
+
+ Handlebars.registerHelper('contains', function(arr, item, options) {;
+ if(arr && arr instanceof Array && arr.indexOf(item) != -1) {
+ return options.fn(this);
+ }
+ });
+
+ Handlebars.registerHelper('primitive', function(schema, options) {
+ if(schema.type && schema.type != "object" && schema.type != "array" || schema.enum) {
+ return withType(this, options, true)
+ }
+ });
+
+ Handlebars.registerHelper('exists', function(value, options) {
+ if(value !== undefined) {
+ value = value === null ? "null": value;
+ value = value === true ? "true": value;
+ value = value === false ? "false": value;
+ value = typeof value === "object" ? JSON.stringify(value): value;
+ this.__default = value;
+ var result = options.fn(this);
+ delete this.__default;
+ return result;
+ }
+ });
+
+ Handlebars.registerHelper('range', function(from, to, replFrom, replTo, exclFrom, exclTo, sep) {
+ var result = "";
+ if(from !== undefined || to !== undefined) {
+ result += exclFrom ? "]" : "[";
+ result += from !== undefined ? from : replFrom;
+ if( (from || replFrom) !== (to || replTo)) {
+ result += (from !== undefined || replFrom !== null) && (to !== undefined || replTo !== null) ? sep : "";
+ result += to !== undefined ? to : replTo;
+ }
+ result += exclTo ? "[" : "]";
+ return result;
+ }
+ });
+
+ var sub = function(schema) {
+ return schema.type == "array" || schema.allOf || schema.anyOf || schema.oneOf || schema.not;
+ }
+
+ Handlebars.registerHelper('sub', function(schema, options) {
+ if(sub(schema) || (schema.type && schema.type != "object" && schema.type != "array") || schema.enum) {
+ return options.fn(this);
+ }
+ });
+
+ Handlebars.registerHelper('main', function(schema, options) {
+ if(!sub(schema)) {
+ return options.fn(this);
+ }
+ });
+
+ var simpleSchema = function(schema) {
+ var result = schema.description===undefined && schema.title===undefined && schema.id===undefined;
+ result &= schema.properties===undefined;
+ return result;
+ };
+
+ Handlebars.registerHelper('simple', function(schema, options) {
+ if(simpleSchema(schema) && !schema.$ref) {
+ return withType(schema, options, true);
+ }
+ });
+
+ var withType = function(schema, options, hideAny) {
+ schema.__type = schema.type;
+ if(!schema.type && !hideAny) {
+ schema.__type="any";
+ }
+ if(schema.format) {
+ schema.__type=schema.format;
+ }
+ if( (schema.__type == "any" || schema.__type == "object") && schema.title) {
+ schema.__type = schema.title;
+ }
+ var result = options.fn(schema);
+ delete schema.__type;
+ return result;
+ }
+
+ Handlebars.registerHelper('complex', function(schema, options) {
+ if(!simpleSchema(schema) && !schema.$ref || schema.properties) {
+ return withType(schema, options);
+ }
+ });
+
+ Handlebars.registerHelper('enum', function(schema) {
+ if(schema.enum) {
+ return (schema.enum.length > 1) ? "enum": "constant";
+ }
+ });
+
+ Handlebars.registerHelper('obj', function(schema, options) {
+ if(schema.properties || schema.type == "object") {
+ return withType(schema, options);
+ }
+ });
+
+ var pushBox = function(schema) {
+ boxes[boxes.length-1].push(schema);
+ }
+
+ Handlebars.registerHelper('box', function(schema, options) {
+ if(schema) {
+ pushBox(schema);
+ return options.fn(schema);
+ }
+ });
+
+ Handlebars.registerHelper('boxId', function() {
+ return boxes[boxes.length-1].length
+ });
+
+ Handlebars.registerHelper('boxes', function(options) {
+ var result="";
+ $.each(boxes[boxes.length-1], function(k, box) {
+ box.__boxId = k+1;
+ result=result+options.fn(box);
+ });
+ boxes[boxes.length-1] = []
+ return result;
+ });
+
+ var resolveIdRef = function(ref) {
+ if(stack) {
+ var i;
+ for(i=stack.length-1; i>=0; i--) {
+ if(stack[i][ref]) {
+ return stack[i][ref];
+ }
+ }
+ }
+ return null;
+ }
+
+ var resolvePointerRef = function(ref) {
+ var root = stack[1];
+ if(ref=="#") {
+ return root;
+ }
+ try {
+ return jsonpointer.get(stack[1], ref);
+ } catch(e) {
+ console.log(e);
+ return null;
+ }
+ }
+
+ var resolveRef = function(ref) {
+ if(ref.indexOf("#") == 0) {
+ return resolvePointerRef(ref);
+ } else {
+ return resolveIdRef(ref);
+ }
+ }
+
+ var getName = function(schema) {
+ if(!schema) {
+ return "<error>";
+ }
+ var name = schema.title;
+ name = !name && schema.id ? schema.id: name;
+ name = !name ? schema.__name: name;
+ return name;
+ }
+
+ Handlebars.registerHelper('name', function(schema, options) {
+ schema.__name = getName(schema);
+ if(schema.__name) {
+ return options.fn(schema);
+ }
+ });
+
+ var refName = function(ref) {
+ var name = getName(resolveRef(ref));
+ if(!name) {
+ if(ref == "#") {
+ name = "<root>";
+ } else {
+ name = ref.replace("#", "/")
+ }
+ }
+ var segments = name.split("/");
+ name = segments[segments.length-1];
+ return name;
+ }
+
+ function renderSchema(schema) {
+ if(stack.indexOf(schema) == -1) { // avoid recursion
+ stack.push(schema);
+ var ret = new Handlebars.SafeString(boxTemplate(schema));
+ stack.pop();
+ return ret;
+ } else {
+ return new Handlebars.SafeString(boxTemplate({"description": "_circular reference_"}));
+ }
+ }
+
+ Handlebars.registerHelper('ref', function(schema, options) {
+ if(schema.$ref) {
+ var target = resolveRef(schema.$ref);
+ if(target) {
+ target.__name = refName(schema.$ref);
+ target.__ref = schema.$ref.replace("#", "");
+ }
+ var result;
+ if(target) {
+ result = options.fn(target);
+ } else {
+ result = new Handlebars.SafeString("<span class='signature-type-ref'>"+schema.$ref+"</span>");
+ }
+ if(target) {
+ delete target.__ref;
+ }
+ return result;
+ }
+ });
+
+ Handlebars.registerHelper('schema', function(schema) {
+ return renderSchema(schema);
+ });
+
+ Handlebars.registerHelper('signature', function(schema, keyword, schemas) {
+ if(!schemas) {
+ schemas = []
+ }
+ schemas = schemas instanceof Array ? schemas : [schemas];
+ return new Handlebars.SafeString(signatureTemplate({ schema: schema, keyword: keyword, schemas: schemas}));
+ });
+
+ Handlebars.registerHelper('l', function(context) {
+ console.log(context);
+ });
+
+ function init() {
+ $.when( $.get(docson.templateBaseUrl+"/box.html").done(function(content) {
+ source = content
+ boxTemplate = Handlebars.compile(source);
+ }), $.get(docson.templateBaseUrl+"/signature.html").done(function(content) {
+ source = content
+ signatureTemplate = Handlebars.compile(source);
+ })).always(function() {
+ ready.resolve();
+ });
+ };
+
+ docson.doc = function(element, schema, ref, baseUrl) {
+ var d = $.Deferred();
+ if(baseUrl === undefined) baseUrl='';
+ init();
+ ready.done(function() {
+ if(typeof element == "string") {
+ element = $("#"+element);
+ }
+ if(typeof schema == "string") {
+ schema = JSON.parse(schema);
+ }
+
+ var refsPromise = $.Deferred().resolve().promise();
+ var refs = {};
+
+
+ var renderBox = function() {
+ stack.push(refs);
+ var target = schema;
+ if(ref) {
+ ref = ref[0] !== '/' ? '/'+ref : ref;
+ target = jsonpointer.get(schema, ref);
+ stack.push( schema );
+ }
+ target.root = true;
+ target.__ref = "<root>";
+ var html = boxTemplate(target);
+
+ if(ref) {
+ stack.pop();
+ }
+ stack.pop();
+
+ element.addClass("docson").html(html);
+
+ var resizeHandler = element.get(0).onresize;
+ function resized() {
+ if(resizeHandler) {
+ var box = element.find(".box").first();
+ element.get(0).onresize(box.outerWidth(), box.outerHeight());
+ }
+ }
+ element.get(0).resized = resized;
+ resized();
+
+ if(highlight) {
+ element.find(".json-schema").each(function(k, schemaElement) {
+ highlight.highlightSchema(schemaElement);
+ });
+ }
+ element.find(".box-title").each(function() {
+ var ref = $(this).attr("ref");
+ if(ref) {
+ if(window.location.href.indexOf("docson/index.html") > -1) {
+ $(this).find(".box-name").css("cursor", "pointer").attr("title", "Open in new window")
+ .hover(
+ function(){ $(this).addClass('link') },
+ function(){ $(this).removeClass('link') })
+ .click(function() {
+ var url = window.location.href+"$$expand";
+ if(ref !=="<root>") {
+ url = url.replace(/(docson\/index.html#[^\$]*).*/, "$1$"+ref+"$$expand");
+ }
+ var w;
+ function receiveMessage(event) {
+ if (event.data.id && event.data.id == "docson" && event.data.action == "ready") {
+ w.postMessage({ id: "docson", action: "load", definitions: schema, type: event.data.url.split("$")[1], expand: true}, "*");
+ }
+ }
+ window.addEventListener("message", receiveMessage, false);
+ w = window.open(url, "_blank");
+ });
+ }
+ }
+ });
+ element.find(".box").mouseenter(function() {
+ $(this).children(".source-button").fadeIn(300);
+ $(this).children(".box-body").children(".expand-button").fadeIn(300);
+ });
+ element.find(".box").mouseleave(function() {
+ $(this).children(".source-button").fadeOut(300);
+ $(this).children(".box-body").children(".expand-button").fadeOut(300);
+ });
+ element.find(".signature-type-expandable").click(function() {
+ var boxId = $(this).attr("boxid");
+ $(this).toggleClass("signature-type-expanded");
+ $(this).parent().parent().parent().children(".signature-box-container").
+ children("[boxid='"+boxId+"']").toggle(resizeHandler ? 0 : 300);
+ resized();
+ });
+ element.find(".expand-button").click(function() {
+ if($(this).attr("expanded")) {
+ $(this).parent().parent().find(".expand-button").html(" + ").attr("title", "Expand all");
+ $(this).parent().parent().find(".signature-type-expandable").removeClass("signature-type-expanded");
+ $(this).parent().parent().find(".box-container").hide( resizeHandler ? 0 : 300);
+ $(this).parent().parent().find(".expand-button").removeAttr("expanded");
+ resized();
+ } else {
+ $(this).parent().parent().find(".expand-button").html(" - ").attr("title", "Collapse all");
+ $(this).parent().parent().find(".signature-type-expandable").addClass("signature-type-expanded");
+ $(this).parent().parent().find(".box-container").show(resizeHandler ? 0 : 300);
+ $(this).parent().parent().find(".expand-button").attr("expanded", true);
+ resized();
+ }
+ });
+ element.find(".source-button").click(function() {
+ $(this).parent().children(".box-body").toggle();
+ $(this).parent().children(".source").toggle();
+ resized();
+ });
+ };
+
+ var resolveRefsReentrant = function(schema){
+ traverse(schema).forEach(function(item) {
+ // Fix Swagger weird generation for array.
+ if(item && item.$ref == "array") {
+ delete item.$ref;
+ item.type ="array";
+ }
+
+ // Fetch external schema
+ if(this.key === "$ref") {
+ var external = false;
+ //Local meaning local to this server, but not in this file.
+ var local = false;
+ if((/^https?:\/\//).test(item)) {
+ external = true;
+ }
+ else if((/^[^#]/).test(item)) {
+ local = true;
+ } else if(item.indexOf('#') > 0) {
+ //Internal reference
+ //Turning relative refs to absolute ones
+ external = true;
+ item = baseUrl + item;
+ this.update(item);
+ }
+ if(external){
+ //External reference, fetch it.
+ var segments = item.split("#");
+ refs[item] = null;
+ var p = $.get(segments[0]).then(function(content) {
+ if(typeof content != "object") {
+ try {
+ content = JSON.parse(content);
+ } catch(e) {
+ console.error("Unable to parse "+segments[0], e);
+ }
+ }
+ if(content) {
+ refs[item] = content;
+ renderBox();
+ resolveRefsReentrant(content);
+ }
+ });
+ }
+ else if(local) {
+ //Local to this server, fetch relative
+ var segments = item.split("#");
+ refs[item] = null;
+ var p = $.get(baseUrl + segments[0]).then(function(content) {
+ if(typeof content != "object") {
+ try {
+ content = JSON.parse(content);
+ } catch(e) {
+ console.error("Unable to parse "+segments[0], e);
+ }
+ }
+ if(content) {
+ refs[item] = content;
+ renderBox();
+ resolveRefsReentrant(content);
+ }
+ });
+ }
+ }
+ });
+ };
+
+ resolveRefsReentrant(schema);
+ renderBox();
+
+ d.resolve();
+ })
+ return d.promise();
+ }
+
+ return docson;
+});
diff --git a/2.0/docson/index.html b/2.0/docson/index.html
new file mode 100644
index 0000000..b0fe0d0
--- /dev/null
+++ b/2.0/docson/index.html
@@ -0,0 +1,154 @@
+<!DOCTYPE html>
+<!--
+ ~ Copyright 2013 Laurent Bovet <laurent.bovet@windmaster.ch>
+ ~
+ ~ Licensed under the Apache License, Version 2.0 (the "License");
+ ~ you may not use this file except in compliance with the License.
+ ~ You may obtain a copy of the License at
+ ~
+ ~ http://www.apache.org/licenses/LICENSE-2.0
+ ~
+ ~ Unless required by applicable law or agreed to in writing, software
+ ~ distributed under the License is distributed on an "AS IS" BASIS,
+ ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ ~ See the License for the specific language governing permissions and
+ ~ limitations under the License.
+ -->
+<html>
+<head>
+ <meta charset="utf-8">
+ <link rel="stylesheet" href="css/docson.css">
+ <script src="lib/require.js"></script>
+ <script>
+ require(["docson", "lib/jquery"], function(docson) {
+ $(function () {
+ var embedded = window.parent !== window;
+ if (embedded) {
+ $("body").addClass("embedded");
+ $("doc").addClass("embedded");
+ $("#form").hide();
+ }
+ $("#url").keypress(function (event) {
+ if (event.keyCode == 13) {
+ window.location.hash = $(this).val();
+ }
+ });
+ $(window).on('hashchange', function () {
+ update();
+ });
+ update();
+ var url;
+ function update() {
+ if (window.location.hash) {
+ $("#form").hide();
+ url = decodeURIComponent(window.location.hash.substring(1));
+ var segments = url.split("$");
+ if(segments[0]) {
+ function render(schema) {
+ try {
+ docson.doc("doc", schema, segments[1], segments[0].replace(/\/[^\/]*\/?$/, '/')).done(function() {
+ maybeExpand(segments);
+ });
+ } catch (e) {
+ error("Could not parse schema: " + e.message + "<pre>" + $('<pre/>').text(schema).html() + "</pre>");
+ }
+ }
+
+ if(/\.ts$/.test(segments[0])) {
+ require.config( { baseUrl: "../typson" } );
+ require(["lib/typson-schema"], function(typson) {
+ typson.definitions(segments[0]).done(render);
+ });
+ } else {
+ $.get(segments[0])
+ .done(render)
+ .fail(function (xhr, status, err) {
+ error("Could not load " + segments[0].replace(/[\u00A0-\u9999<>\&]/gim, function(i) {
+ return '&#'+i.charCodeAt(0)+';';
+ }) + ": " + status + " " + err);
+ });
+ }
+ }
+ function receiveMessage(event) {
+ console.log(">", event)
+ if(event.data.id && event.data.id == "docson") {
+ if(event.data.type) {
+ try {
+ docson.doc("doc", event.data.definitions, event.data.type).done(function() {
+ maybeExpand(segments);
+ });
+ } catch (e) {
+ error("Could not parse schema: " + e.message + "<pre>" + $('<pre/>').text(event.data.definitions).html() + "</pre>");
+ }
+ }
+ if(event.data.action == "resize") {
+ $("#doc").get(0).resized();
+ }
+ if(event.data.font) {
+ console.log(event.data.font)
+ $("#doc").css("font-family", event.data.font);
+ }
+ }
+ }
+ window.addEventListener("message", receiveMessage, false);
+ var host = window.opener || window.parent;
+ host.postMessage( { id: "docson", action: "ready", url: url}, "*");
+ } else {
+ $("#doc").empty();
+ $("#form").show();
+ }
+ }
+
+ function maybeExpand(segments) {
+ if(segments.indexOf("expand") >0 ) {
+ $("#doc").find(".expand-button").html(" - ").attr("title", "Collapse all");
+ $("#doc").find(".signature-type-expandable").addClass("signature-type-expanded");
+ $("#doc").find(".box-container").show();
+ $("#doc").find(".expand-button").attr("expanded", true);
+ }
+ }
+
+ function error(message) {
+ $("#form").show();
+ $("#doc").html($("<div/>").addClass("error")
+ .html(message));
+ }
+
+ var doc = $('#doc').get(0);
+ if(embedded) {
+ doc.onresize = function(width, height) {
+ window.parent.postMessage( { id: "docson", action: "resized", url: url, width: width, height: height}, "*");
+ }
+ }
+ });
+ });
+ </script>
+ <style>
+ body {
+ font-family: Open Sans, sans-serif;
+ }
+
+ #form {
+ display: none;
+ }
+
+ #form input[type=text] {
+ border-radius: 6px;
+ -moz-border-radius: 6px;
+ -webkit-border-radius: 6px;
+ }
+
+ .embedded {
+ margin: 0px;
+ padding: 0px;
+ }
+ </style>
+</head>
+<body>
+<div id="form">
+ Please enter a schema URL:
+ <input type="text" id="url" size="60">
+</div>
+<div id="doc"></div>
+</body>
+</html>
diff --git a/2.0/docson/lib/handlebars.js b/2.0/docson/lib/handlebars.js
new file mode 100644
index 0000000..ba71792
--- /dev/null
+++ b/2.0/docson/lib/handlebars.js
@@ -0,0 +1,2595 @@
+/*!
+
+ handlebars v1.1.2
+
+Copyright (C) 2011 by Yehuda Katz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+@license
+*/
+var Handlebars = (function() {
+// handlebars/safe-string.js
+var __module4__ = (function() {
+ "use strict";
+ var __exports__;
+ // Build out our basic SafeString type
+ function SafeString(string) {
+ this.string = string;
+ }
+
+ SafeString.prototype.toString = function() {
+ return "" + this.string;
+ };
+
+ __exports__ = SafeString;
+ return __exports__;
+})();
+
+// handlebars/utils.js
+var __module3__ = (function(__dependency1__) {
+ "use strict";
+ var __exports__ = {};
+ var SafeString = __dependency1__;
+
+ var escape = {
+ "&": "&",
+ "<": "<",
+ ">": ">",
+ '"': """,
+ "'": "'",
+ "`": "`"
+ };
+
+ var badChars = /[&<>"'`]/g;
+ var possible = /[&<>"'`]/;
+
+ function escapeChar(chr) {
+ return escape[chr] || "&";
+ }
+
+ function extend(obj, value) {
+ for(var key in value) {
+ if(value.hasOwnProperty(key)) {
+ obj[key] = value[key];
+ }
+ }
+ }
+
+ __exports__.extend = extend;var toString = Object.prototype.toString;
+ __exports__.toString = toString;
+ // Sourced from lodash
+ // https://github.com/bestiejs/lodash/blob/master/LICENSE.txt
+ var isFunction = function(value) {
+ return typeof value === 'function';
+ };
+ // fallback for older versions of Chrome and Safari
+ if (isFunction(/x/)) {
+ isFunction = function(value) {
+ return typeof value === 'function' && toString.call(value) === '[object Function]';
+ };
+ }
+ var isFunction;
+ __exports__.isFunction = isFunction;
+ var isArray = Array.isArray || function(value) {
+ return (value && typeof value === 'object') ? toString.call(value) === '[object Array]' : false;
+ };
+ __exports__.isArray = isArray;
+
+ function escapeExpression(string) {
+ // don't escape SafeStrings, since they're already safe
+ if (string instanceof SafeString) {
+ return string.toString();
+ } else if (!string && string !== 0) {
+ return "";
+ }
+
+ // Force a string conversion as this will be done by the append regardless and
+ // the regex test will do this transparently behind the scenes, causing issues if
+ // an object's to string has escaped characters in it.
+ string = "" + string;
+
+ if(!possible.test(string)) { return string; }
+ return string.replace(badChars, escapeChar);
+ }
+
+ __exports__.escapeExpression = escapeExpression;function isEmpty(value) {
+ if (!value && value !== 0) {
+ return true;
+ } else if (isArray(value) && value.length === 0) {
+ return true;
+ } else {
+ return false;
+ }
+ }
+
+ __exports__.isEmpty = isEmpty;
+ return __exports__;
+})(__module4__);
+
+// handlebars/exception.js
+var __module5__ = (function() {
+ "use strict";
+ var __exports__;
+
+ var errorProps = ['description', 'fileName', 'lineNumber', 'message', 'name', 'number', 'stack'];
+
+ function Exception(/* message */) {
+ var tmp = Error.prototype.constructor.apply(this, arguments);
+
+ // Unfortunately errors are not enumerable in Chrome (at least), so `for prop in tmp` doesn't work.
+ for (var idx = 0; idx < errorProps.length; idx++) {
+ this[errorProps[idx]] = tmp[errorProps[idx]];
+ }
+ }
+
+ Exception.prototype = new Error();
+
+ __exports__ = Exception;
+ return __exports__;
+})();
+
+// handlebars/base.js
+var __module2__ = (function(__dependency1__, __dependency2__) {
+ "use strict";
+ var __exports__ = {};
+ /*globals Exception, Utils */
+ var Utils = __dependency1__;
+ var Exception = __dependency2__;
+
+ var VERSION = "1.1.2";
+ __exports__.VERSION = VERSION;var COMPILER_REVISION = 4;
+ __exports__.COMPILER_REVISION = COMPILER_REVISION;
+ var REVISION_CHANGES = {
+ 1: '<= 1.0.rc.2', // 1.0.rc.2 is actually rev2 but doesn't report it
+ 2: '== 1.0.0-rc.3',
+ 3: '== 1.0.0-rc.4',
+ 4: '>= 1.0.0'
+ };
+ __exports__.REVISION_CHANGES = REVISION_CHANGES;
+ var isArray = Utils.isArray,
+ isFunction = Utils.isFunction,
+ toString = Utils.toString,
+ objectType = '[object Object]';
+
+ function HandlebarsEnvironment(helpers, partials) {
+ this.helpers = helpers || {};
+ this.partials = partials || {};
+
+ registerDefaultHelpers(this);
+ }
+
+ __exports__.HandlebarsEnvironment = HandlebarsEnvironment;HandlebarsEnvironment.prototype = {
+ constructor: HandlebarsEnvironment,
+
+ logger: logger,
+ log: log,
+
+ registerHelper: function(name, fn, inverse) {
+ if (toString.call(name) === objectType) {
+ if (inverse || fn) { throw new Exception('Arg not supported with multiple helpers'); }
+ Utils.extend(this.helpers, name);
+ } else {
+ if (inverse) { fn.not = inverse; }
+ this.helpers[name] = fn;
+ }
+ },
+
+ registerPartial: function(name, str) {
+ if (toString.call(name) === objectType) {
+ Utils.extend(this.partials, name);
+ } else {
+ this.partials[name] = str;
+ }
+ }
+ };
+
+ function registerDefaultHelpers(instance) {
+ instance.registerHelper('helperMissing', function(arg) {
+ if(arguments.length === 2) {
+ return undefined;
+ } else {
+ throw new Error("Missing helper: '" + arg + "'");
+ }
+ });
+
+ instance.registerHelper('blockHelperMissing', function(context, options) {
+ var inverse = options.inverse || function() {}, fn = options.fn;
+
+ if (isFunction(context)) { context = context.call(this); }
+
+ if(context === true) {
+ return fn(this);
+ } else if(context === false || context == null) {
+ return inverse(this);
+ } else if (isArray(context)) {
+ if(context.length > 0) {
+ return instance.helpers.each(context, options);
+ } else {
+ return inverse(this);
+ }
+ } else {
+ return fn(context);
+ }
+ });
+
+ instance.registerHelper('each', function(context, options) {
+ var fn = options.fn, inverse = options.inverse;
+ var i = 0, ret = "", data;
+
+ if (isFunction(context)) { context = context.call(this); }
+
+ if (options.data) {
+ data = createFrame(options.data);
+ }
+
+ if(context && typeof context === 'object') {
+ if (isArray(context)) {
+ for(var j = context.length; i<j; i++) {
+ if (data) {
+ data.index = i;
+ data.first = (i === 0)
+ data.last = (i === (context.length-1));
+ }
+ ret = ret + fn(context[i], { data: data });
+ }
+ } else {
+ for(var key in context) {
+ if(context.hasOwnProperty(key)) {
+ if(data) { data.key = key; }
+ ret = ret + fn(context[key], {data: data});
+ i++;
+ }
+ }
+ }
+ }
+
+ if(i === 0){
+ ret = inverse(this);
+ }
+
+ return ret;
+ });
+
+ instance.registerHelper('if', function(conditional, options) {
+ if (isFunction(conditional)) { conditional = conditional.call(this); }
+
+ // Default behavior is to render the positive path if the value is truthy and not empty.
+ // The `includeZero` option may be set to treat the condtional as purely not empty based on the
+ // behavior of isEmpty. Effectively this determines if 0 is handled by the positive path or negative.
+ if ((!options.hash.includeZero && !conditional) || Utils.isEmpty(conditional)) {
+ return options.inverse(this);
+ } else {
+ return options.fn(this);
+ }
+ });
+
+ instance.registerHelper('unless', function(conditional, options) {
+ return instance.helpers['if'].call(this, conditional, {fn: options.inverse, inverse: options.fn, hash: options.hash});
+ });
+
+ instance.registerHelper('with', function(context, options) {
+ if (isFunction(context)) { context = context.call(this); }
+
+ if (!Utils.isEmpty(context)) return options.fn(context);
+ });
+
+ instance.registerHelper('log', function(context, options) {
+ var level = options.data && options.data.level != null ? parseInt(options.data.level, 10) : 1;
+ instance.log(level, context);
+ });
+ }
+
+ var logger = {
+ methodMap: { 0: 'debug', 1: 'info', 2: 'warn', 3: 'error' },
+
+ // State enum
+ DEBUG: 0,
+ INFO: 1,
+ WARN: 2,
+ ERROR: 3,
+ level: 3,
+
+ // can be overridden in the host environment
+ log: function(level, obj) {
+ if (logger.level <= level) {
+ var method = logger.methodMap[level];
+ if (typeof console !== 'undefined' && console[method]) {
+ console[method].call(console, obj);
+ }
+ }
+ }
+ };
+ __exports__.logger = logger;
+ function log(level, obj) { logger.log(level, obj); }
+
+ __exports__.log = log;var createFrame = function(object) {
+ var obj = {};
+ Utils.extend(obj, object);
+ return obj;
+ };
+ __exports__.createFrame = createFrame;
+ return __exports__;
+})(__module3__, __module5__);
+
+// handlebars/runtime.js
+var __module6__ = (function(__dependency1__, __dependency2__, __dependency3__) {
+ "use strict";
+ var __exports__ = {};
+ /*global Utils */
+ var Utils = __dependency1__;
+ var Exception = __dependency2__;
+ var COMPILER_REVISION = __dependency3__.COMPILER_REVISION;
+ var REVISION_CHANGES = __dependency3__.REVISION_CHANGES;
+
+ function checkRevision(compilerInfo) {
+ var compilerRevision = compilerInfo && compilerInfo[0] || 1,
+ currentRevision = COMPILER_REVISION;
+
+ if (compilerRevision !== currentRevision) {
+ if (compilerRevision < currentRevision) {
+ var runtimeVersions = REVISION_CHANGES[currentRevision],
+ compilerVersions = REVISION_CHANGES[compilerRevision];
+ throw new Error("Template was precompiled with an older version of Handlebars than the current runtime. "+
+ "Please update your precompiler to a newer version ("+runtimeVersions+") or downgrade your runtime to an older version ("+compilerVersions+").");
+ } else {
+ // Use the embedded version info since the runtime doesn't know about this revision yet
+ throw new Error("Template was precompiled with a newer version of Handlebars than the current runtime. "+
+ "Please update your runtime to a newer version ("+compilerInfo[1]+").");
+ }
+ }
+ }
+
+ // TODO: Remove this line and break up compilePartial
+
+ function template(templateSpec, env) {
+ if (!env) {
+ throw new Error("No environment passed to template");
+ }
+
+ var invokePartialWrapper;
+ if (env.compile) {
+ invokePartialWrapper = function(partial, name, context, helpers, partials, data) {
+ // TODO : Check this for all inputs and the options handling (partial flag, etc). This feels
+ // like there should be a common exec path
+ var result = invokePartial.apply(this, arguments);
+ if (result) { return result; }
+
+ var options = { helpers: helpers, partials: partials, data: data };
+ partials[name] = env.compile(partial, { data: data !== undefined }, env);
+ return partials[name](context, options);
+ };
+ } else {
+ invokePartialWrapper = function(partial, name /* , context, helpers, partials, data */) {
+ var result = invokePartial.apply(this, arguments);
+ if (result) { return result; }
+ throw new Exception("The partial " + name + " could not be compiled when running in runtime-only mode");
+ };
+ }
+
+ // Just add water
+ var container = {
+ escapeExpression: Utils.escapeExpression,
+ invokePartial: invokePartialWrapper,
+ programs: [],
+ program: function(i, fn, data) {
+ var programWrapper = this.programs[i];
+ if(data) {
+ programWrapper = program(i, fn, data);
+ } else if (!programWrapper) {
+ programWrapper = this.programs[i] = program(i, fn);
+ }
+ return programWrapper;
+ },
+ merge: function(param, common) {
+ var ret = param || common;
+
+ if (param && common && (param !== common)) {
+ ret = {};
+ Utils.extend(ret, common);
+ Utils.extend(ret, param);
+ }
+ return ret;
+ },
+ programWithDepth: programWithDepth,
+ noop: noop,
+ compilerInfo: null
+ };
+
+ return function(context, options) {
+ options = options || {};
+ var namespace = options.partial ? options : env,
+ helpers,
+ partials;
+
+ if (!options.partial) {
+ helpers = options.helpers;
+ partials = options.partials;
+ }
+ var result = templateSpec.call(
+ container,
+ namespace, context,
+ helpers,
+ partials,
+ options.data);
+
+ if (!options.partial) {
+ checkRevision(container.compilerInfo);
+ }
+
+ return result;
+ };
+ }
+
+ __exports__.template = template;function programWithDepth(i, fn, data /*, $depth */) {
+ var args = Array.prototype.slice.call(arguments, 3);
+
+ var prog = function(context, options) {
+ options = options || {};
+
+ return fn.apply(this, [context, options.data || data].concat(args));
+ };
+ prog.program = i;
+ prog.depth = args.length;
+ return prog;
+ }
+
+ __exports__.programWithDepth = programWithDepth;function program(i, fn, data) {
+ var prog = function(context, options) {
+ options = options || {};
+
+ return fn(context, options.data || data);
+ };
+ prog.program = i;
+ prog.depth = 0;
+ return prog;
+ }
+
+ __exports__.program = program;function invokePartial(partial, name, context, helpers, partials, data) {
+ var options = { partial: true, helpers: helpers, partials: partials, data: data };
+
+ if(partial === undefined) {
+ throw new Exception("The partial " + name + " could not be found");
+ } else if(partial instanceof Function) {
+ return partial(context, options);
+ }
+ }
+
+ __exports__.invokePartial = invokePartial;function noop() { return ""; }
+
+ __exports__.noop = noop;
+ return __exports__;
+})(__module3__, __module5__, __module2__);
+
+// handlebars.runtime.js
+var __module1__ = (function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__) {
+ "use strict";
+ var __exports__;
+ var base = __dependency1__;
+
+ // Each of these augment the Handlebars object. No need to setup here.
+ // (This is done to easily share code between commonjs and browse envs)
+ var SafeString = __dependency2__;
+ var Exception = __dependency3__;
+ var Utils = __dependency4__;
+ var runtime = __dependency5__;
+
+ // For compatibility and usage outside of module systems, make the Handlebars object a namespace
+ var create = function() {
+ var hb = new base.HandlebarsEnvironment();
+
+ Utils.extend(hb, base);
+ hb.SafeString = SafeString;
+ hb.Exception = Exception;
+ hb.Utils = Utils;
+
+ hb.VM = runtime;
+ hb.template = function(spec) {
+ return runtime.template(spec, hb);
+ };
+
+ return hb;
+ };
+
+ var Handlebars = create();
+ Handlebars.create = create;
+
+ __exports__ = Handlebars;
+ return __exports__;
+})(__module2__, __module4__, __module5__, __module3__, __module6__);
+
+// handlebars/compiler/ast.js
+var __module7__ = (function(__dependency1__) {
+ "use strict";
+ var __exports__ = {};
+ var Exception = __dependency1__;
+
+ function ProgramNode(statements, inverseStrip, inverse) {
+ this.type = "program";
+ this.statements = statements;
+ this.strip = {};
+
+ if(inverse) {
+ this.inverse = new ProgramNode(inverse, inverseStrip);
+ this.strip.right = inverseStrip.left;
+ } else if (inverseStrip) {
+ this.strip.left = inverseStrip.right;
+ }
+ }
+
+ __exports__.ProgramNode = ProgramNode;function MustacheNode(rawParams, hash, open, strip) {
+ this.type = "mustache";
+ this.hash = hash;
+ this.strip = strip;
+
+ var escapeFlag = open[3] || open[2];
+ this.escaped = escapeFlag !== '{' && escapeFlag !== '&';
+
+ var id = this.id = rawParams[0];
+ var params = this.params = rawParams.slice(1);
+
+ // a mustache is an eligible helper if:
+ // * its id is simple (a single part, not `this` or `..`)
+ var eligibleHelper = this.eligibleHelper = id.isSimple;
+
+ // a mustache is definitely a helper if:
+ // * it is an eligible helper, and
+ // * it has at least one parameter or hash segment
+ this.isHelper = eligibleHelper && (params.length || hash);
+
+ // if a mustache is an eligible helper but not a definite
+ // helper, it is ambiguous, and will be resolved in a later
+ // pass or at runtime.
+ }
+
+ __exports__.MustacheNode = MustacheNode;function PartialNode(partialName, context, strip) {
+ this.type = "partial";
+ this.partialName = partialName;
+ this.context = context;
+ this.strip = strip;
+ }
+
+ __exports__.PartialNode = PartialNode;function BlockNode(mustache, program, inverse, close) {
+ if(mustache.id.original !== close.path.original) {
+ throw new Exception(mustache.id.original + " doesn't match " + close.path.original);
+ }
+
+ this.type = "block";
+ this.mustache = mustache;
+ this.program = program;
+ this.inverse = inverse;
+
+ this.strip = {
+ left: mustache.strip.left,
+ right: close.strip.right
+ };
+
+ (program || inverse).strip.left = mustache.strip.right;
+ (inverse || program).strip.right = close.strip.left;
+
+ if (inverse && !program) {
+ this.isInverse = true;
+ }
+ }
+
+ __exports__.BlockNode = BlockNode;function ContentNode(string) {
+ this.type = "content";
+ this.string = string;
+ }
+
+ __exports__.ContentNode = ContentNode;function HashNode(pairs) {
+ this.type = "hash";
+ this.pairs = pairs;
+ }
+
+ __exports__.HashNode = HashNode;function IdNode(parts) {
+ this.type = "ID";
+
+ var original = "",
+ dig = [],
+ depth = 0;
+
+ for(var i=0,l=parts.length; i<l; i++) {
+ var part = parts[i].part;
+ original += (parts[i].separator || '') + part;
+
+ if (part === ".." || part === "." || part === "this") {
+ if (dig.length > 0) { throw new Exception("Invalid path: " + original); }
+ else if (part === "..") { depth++; }
+ else { this.isScoped = true; }
+ }
+ else { dig.push(part); }
+ }
+
+ this.original = original;
+ this.parts = dig;
+ this.string = dig.join('.');
+ this.depth = depth;
+
+ // an ID is simple if it only has one part, and that part is not
+ // `..` or `this`.
+ this.isSimple = parts.length === 1 && !this.isScoped && depth === 0;
+
+ this.stringModeValue = this.string;
+ }
+
+ __exports__.IdNode = IdNode;function PartialNameNode(name) {
+ this.type = "PARTIAL_NAME";
+ this.name = name.original;
+ }
+
+ __exports__.PartialNameNode = PartialNameNode;function DataNode(id) {
+ this.type = "DATA";
+ this.id = id;
+ }
+
+ __exports__.DataNode = DataNode;function StringNode(string) {
+ this.type = "STRING";
+ this.original =
+ this.string =
+ this.stringModeValue = string;
+ }
+
+ __exports__.StringNode = StringNode;function IntegerNode(integer) {
+ this.type = "INTEGER";
+ this.original =
+ this.integer = integer;
+ this.stringModeValue = Number(integer);
+ }
+
+ __exports__.IntegerNode = IntegerNode;function BooleanNode(bool) {
+ this.type = "BOOLEAN";
+ this.bool = bool;
+ this.stringModeValue = bool === "true";
+ }
+
+ __exports__.BooleanNode = BooleanNode;function CommentNode(comment) {
+ this.type = "comment";
+ this.comment = comment;
+ }
+
+ __exports__.CommentNode = CommentNode;
+ return __exports__;
+})(__module5__);
+
+// handlebars/compiler/parser.js
+var __module9__ = (function() {
+ "use strict";
+ var __exports__;
+ /* Jison generated parser */
+ var handlebars = (function(){
+ var parser = {trace: function trace() { },
+ yy: {},
+ symbols_: {"error":2,"root":3,"statements":4,"EOF":5,"program":6,"simpleInverse":7,"statement":8,"openInverse":9,"closeBlock":10,"openBlock":11,"mustache":12,"partial":13,"CONTENT":14,"COMMENT":15,"OPEN_BLOCK":16,"inMustache":17,"CLOSE":18,"OPEN_INVERSE":19,"OPEN_ENDBLOCK":20,"path":21,"OPEN":22,"OPEN_UNESCAPED":23,"CLOSE_UNESCAPED":24,"OPEN_PARTIAL":25,"partialName":26,"partial_option0":27,"inMustache_repetition0":28,"inMustache_option0":29,"dataName":30,"param":31,"STRING":32,"INTEGER":33,"BOOLEAN":34,"hash":35,"hash_repetition_plus0":36,"hashSegment":37,"ID":38,"EQUALS":39,"DATA":40,"pathSegments":41,"SEP":42,"$accept":0,"$end":1},
+ terminals_: {2:"error",5:"EOF",14:"CONTENT",15:"COMMENT",16:"OPEN_BLOCK",18:"CLOSE",19:"OPEN_INVERSE",20:"OPEN_ENDBLOCK",22:"OPEN",23:"OPEN_UNESCAPED",24:"CLOSE_UNESCAPED",25:"OPEN_PARTIAL",32:"STRING",33:"INTEGER",34:"BOOLEAN",38:"ID",39:"EQUALS",40:"DATA",42:"SEP"},
+ productions_: [0,[3,2],[3,1],[6,2],[6,3],[6,2],[6,1],[6,1],[6,0],[4,1],[4,2],[8,3],[8,3],[8,1],[8,1],[8,1],[8,1],[11,3],[9,3],[10,3],[12,3],[12,3],[13,4],[7,2],[17,3],[17,1],[31,1],[31,1],[31,1],[31,1],[31,1],[35,1],[37,3],[26,1],[26,1],[26,1],[30,2],[21,1],[41,3],[41,1],[27,0],[27,1],[28,0],[28,2],[29,0],[29,1],[36,1],[36,2]],
+ performAction: function anonymous(yytext,yyleng,yylineno,yy,yystate,$$,_$) {
+
+ var $0 = $$.length - 1;
+ switch (yystate) {
+ case 1: return new yy.ProgramNode($$[$0-1]);
+ break;
+ case 2: return new yy.ProgramNode([]);
+ break;
+ case 3:this.$ = new yy.ProgramNode([], $$[$0-1], $$[$0]);
+ break;
+ case 4:this.$ = new yy.ProgramNode($$[$0-2], $$[$0-1], $$[$0]);
+ break;
+ case 5:this.$ = new yy.ProgramNode($$[$0-1], $$[$0], []);
+ break;
+ case 6:this.$ = new yy.ProgramNode($$[$0]);
+ break;
+ case 7:this.$ = new yy.ProgramNode([]);
+ break;
+ case 8:this.$ = new yy.ProgramNode([]);
+ break;
+ case 9:this.$ = [$$[$0]];
+ break;
+ case 10: $$[$0-1].push($$[$0]); this.$ = $$[$0-1];
+ break;
+ case 11:this.$ = new yy.BlockNode($$[$0-2], $$[$0-1].inverse, $$[$0-1], $$[$0]);
+ break;
+ case 12:this.$ = new yy.BlockNode($$[$0-2], $$[$0-1], $$[$0-1].inverse, $$[$0]);
+ break;
+ case 13:this.$ = $$[$0];
+ break;
+ case 14:this.$ = $$[$0];
+ break;
+ case 15:this.$ = new yy.ContentNode($$[$0]);
+ break;
+ case 16:this.$ = new yy.CommentNode($$[$0]);
+ break;
+ case 17:this.$ = new yy.MustacheNode($$[$0-1][0], $$[$0-1][1], $$[$0-2], stripFlags($$[$0-2], $$[$0]));
+ break;
+ case 18:this.$ = new yy.MustacheNode($$[$0-1][0], $$[$0-1][1], $$[$0-2], stripFlags($$[$0-2], $$[$0]));
+ break;
+ case 19:this.$ = {path: $$[$0-1], strip: stripFlags($$[$0-2], $$[$0])};
+ break;
+ case 20:this.$ = new yy.MustacheNode($$[$0-1][0], $$[$0-1][1], $$[$0-2], stripFlags($$[$0-2], $$[$0]));
+ break;
+ case 21:this.$ = new yy.MustacheNode($$[$0-1][0], $$[$0-1][1], $$[$0-2], stripFlags($$[$0-2], $$[$0]));
+ break;
+ case 22:this.$ = new yy.PartialNode($$[$0-2], $$[$0-1], stripFlags($$[$0-3], $$[$0]));
+ break;
+ case 23:this.$ = stripFlags($$[$0-1], $$[$0]);
+ break;
+ case 24:this.$ = [[$$[$0-2]].concat($$[$0-1]), $$[$0]];
+ break;
+ case 25:this.$ = [[$$[$0]], null];
+ break;
+ case 26:this.$ = $$[$0];
+ break;
+ case 27:this.$ = new yy.StringNode($$[$0]);
+ break;
+ case 28:this.$ = new yy.IntegerNode($$[$0]);
+ break;
+ case 29:this.$ = new yy.BooleanNode($$[$0]);
+ break;
+ case 30:this.$ = $$[$0];
+ break;
+ case 31:this.$ = new yy.HashNode($$[$0]);
+ break;
+ case 32:this.$ = [$$[$0-2], $$[$0]];
+ break;
+ case 33:this.$ = new yy.PartialNameNode($$[$0]);
+ break;
+ case 34:this.$ = new yy.PartialNameNode(new yy.StringNode($$[$0]));
+ break;
+ case 35:this.$ = new yy.PartialNameNode(new yy.IntegerNode($$[$0]));
+ break;
+ case 36:this.$ = new yy.DataNode($$[$0]);
+ break;
+ case 37:this.$ = new yy.IdNode($$[$0]);
+ break;
+ case 38: $$[$0-2].push({part: $$[$0], separator: $$[$0-1]}); this.$ = $$[$0-2];
+ break;
+ case 39:this.$ = [{part: $$[$0]}];
+ break;
+ case 42:this.$ = [];
+ break;
+ case 43:$$[$0-1].push($$[$0]);
+ break;
+ case 46:this.$ = [$$[$0]];
+ break;
+ case 47:$$[$0-1].push($$[$0]);
+ break;
+ }
+ },
+ table: [{3:1,4:2,5:[1,3],8:4,9:5,11:6,12:7,13:8,14:[1,9],15:[1,10],16:[1,12],19:[1,11],22:[1,13],23:[1,14],25:[1,15]},{1:[3]},{5:[1,16],8:17,9:5,11:6,12:7,13:8,14:[1,9],15:[1,10],16:[1,12],19:[1,11],22:[1,13],23:[1,14],25:[1,15]},{1:[2,2]},{5:[2,9],14:[2,9],15:[2,9],16:[2,9],19:[2,9],20:[2,9],22:[2,9],23:[2,9],25:[2,9]},{4:20,6:18,7:19,8:4,9:5,11:6,12:7,13:8,14:[1,9],15:[1,10],16:[1,12],19:[1,21],20:[2,8],22:[1,13],23:[1,14],25:[1,15]},{4:20,6:22,7:19,8:4,9:5,11:6,12:7,13:8,14:[1,9],15:[1,10],16:[1,12],19:[1,21],20:[2,8],22:[1,13],23:[1,14],25:[1,15]},{5:[2,13],14:[2,13],15:[2,13],16:[2,13],19:[2,13],20:[2,13],22:[2,13],23:[2,13],25:[2,13]},{5:[2,14],14:[2,14],15:[2,14],16:[2,14],19:[2,14],20:[2,14],22:[2,14],23:[2,14],25:[2,14]},{5:[2,15],14:[2,15],15:[2,15],16:[2,15],19:[2,15],20:[2,15],22:[2,15],23:[2,15],25:[2,15]},{5:[2,16],14:[2,16],15:[2,16],16:[2,16],19:[2,16],20:[2,16],22:[2,16],23:[2,16],25:[2,16]},{17:23,21:24,30:25,38:[1,28],40:[1,27],41:26},{17:29,21:24,30:25,38:[1,28],40:[1,27],41:26},{17:30,21:24,30:25,38:[1,28],40:[1,27],41:26},{17:31,21:24,30:25,38:[1,28],40:[1,27],41:26},{21:33,26:32,32:[1,34],33:[1,35],38:[1,28],41:26},{1:[2,1]},{5:[2,10],14:[2,10],15:[2,10],16:[2,10],19:[2,10],20:[2,10],22:[2,10],23:[2,10],25:[2,10]},{10:36,20:[1,37]},{4:38,8:4,9:5,11:6,12:7,13:8,14:[1,9],15:[1,10],16:[1,12],19:[1,11],20:[2,7],22:[1,13],23:[1,14],25:[1,15]},{7:39,8:17,9:5,11:6,12:7,13:8,14:[1,9],15:[1,10],16:[1,12],19:[1,21],20:[2,6],22:[1,13],23:[1,14],25:[1,15]},{17:23,18:[1,40],21:24,30:25,38:[1,28],40:[1,27],41:26},{10:41,20:[1,37]},{18:[1,42]},{18:[2,42],24:[2,42],28:43,32:[2,42],33:[2,42],34:[2,42],38:[2,42],40:[2,42]},{18:[2,25],24:[2,25]},{18:[2,37],24:[2,37],32:[2,37],33:[2,37],34:[2,37],38:[2,37],40:[2,37],42:[1,44]},{21:45,38:[1,28],41:26},{18:[2,39],24:[2,39],32:[2,39],33:[2,39],34:[2,39],38:[2,39],40:[2,39],42:[2,39]},{18:[1,46]},{18:[1,47]},{24:[1,48]},{18:[2,40],21:50,27:49,38:[1,28],41:26},{18:[2,33],38:[2,33]},{18:[2,34],38:[2,34]},{18:[2,35],38:[2,35]},{5:[2,11],14:[2,11],15:[2,11],16:[2,11],19:[2,11],20:[2,11],22:[2,11],23:[2,11],25:[2,11]},{21:51,38:[1,28],41:26},{8:17,9:5,11:6,12:7,13:8,14:[1,9],15:[1,10],16:[1,12],19:[1,11],20:[2,3],22:[1,13],23:[1,14],25:[1,15]},{4:52,8:4,9:5,11:6,12:7,13:8,14:[1,9],15:[1,10],16:[1,12],19:[1,11],20:[2,5],22:[1,13],23:[1,14],25:[1,15]},{14:[2,23],15:[2,23],16:[2,23],19:[2,23],20:[2,23],22:[2,23],23:[2,23],25:[2,23]},{5:[2,12],14:[2,12],15:[2,12],16:[2,12],19:[2,12],20:[2,12],22:[2,12],23:[2,12],25:[2,12]},{14:[2,18],15:[2,18],16:[2,18],19:[2,18],20:[2,18],22:[2,18],23:[2,18],25:[2,18]},{18:[2,44],21:56,24:[2,44],29:53,30:60,31:54,32:[1,57],33:[1,58],34:[1,59],35:55,36:61,37:62,38:[1,63],40:[1,27],41:26},{38:[1,64]},{18:[2,36],24:[2,36],32:[2,36],33:[2,36],34:[2,36],38:[2,36],40:[2,36]},{14:[2,17],15:[2,17],16:[2,17],19:[2,17],20:[2,17],22:[2,17],23:[2,17],25:[2,17]},{5:[2,20],14:[2,20],15:[2,20],16:[2,20],19:[2,20],20:[2,20],22:[2,20],23:[2,20],25:[2,20]},{5:[2,21],14:[2,21],15:[2,21],16:[2,21],19:[2,21],20:[2,21],22:[2,21],23:[2,21],25:[2,21]},{18:[1,65]},{18:[2,41]},{18:[1,66]},{8:17,9:5,11:6,12:7,13:8,14:[1,9],15:[1,10],16:[1,12],19:[1,11],20:[2,4],22:[1,13],23:[1,14],25:[1,15]},{18:[2,24],24:[2,24]},{18:[2,43],24:[2,43],32:[2,43],33:[2,43],34:[2,43],38:[2,43],40:[2,43]},{18:[2,45],24:[2,45]},{18:[2,26],24:[2,26],32:[2,26],33:[2,26],34:[2,26],38:[2,26],40:[2,26]},{18:[2,27],24:[2,27],32:[2,27],33:[2,27],34:[2,27],38:[2,27],40:[2,27]},{18:[2,28],24:[2,28],32:[2,28],33:[2,28],34:[2,28],38:[2,28],40:[2,28]},{18:[2,29],24:[2,29],32:[2,29],33:[2,29],34:[2,29],38:[2,29],40:[2,29]},{18:[2,30],24:[2,30],32:[2,30],33:[2,30],34:[2,30],38:[2,30],40:[2,30]},{18:[2,31],24:[2,31],37:67,38:[1,68]},{18:[2,46],24:[2,46],38:[2,46]},{18:[2,39],24:[2,39],32:[2,39],33:[2,39],34:[2,39],38:[2,39],39:[1,69],40:[2,39],42:[2,39]},{18:[2,38],24:[2,38],32:[2,38],33:[2,38],34:[2,38],38:[2,38],40:[2,38],42:[2,38]},{5:[2,22],14:[2,22],15:[2,22],16:[2,22],19:[2,22],20:[2,22],22:[2,22],23:[2,22],25:[2,22]},{5:[2,19],14:[2,19],15:[2,19],16:[2,19],19:[2,19],20:[2,19],22:[2,19],23:[2,19],25:[2,19]},{18:[2,47],24:[2,47],38:[2,47]},{39:[1,69]},{21:56,30:60,31:70,32:[1,57],33:[1,58],34:[1,59],38:[1,28],40:[1,27],41:26},{18:[2,32],24:[2,32],38:[2,32]}],
+ defaultActions: {3:[2,2],16:[2,1],50:[2,41]},
+ parseError: function parseError(str, hash) {
+ throw new Error(str);
+ },
+ parse: function parse(input) {
+ var self = this, stack = [0], vstack = [null], lstack = [], table = this.table, yytext = "", yylineno = 0, yyleng = 0, recovering = 0, TERROR = 2, EOF = 1;
+ this.lexer.setInput(input);
+ this.lexer.yy = this.yy;
+ this.yy.lexer = this.lexer;
+ this.yy.parser = this;
+ if (typeof this.lexer.yylloc == "undefined")
+ this.lexer.yylloc = {};
+ var yyloc = this.lexer.yylloc;
+ lstack.push(yyloc);
+ var ranges = this.lexer.options && this.lexer.options.ranges;
+ if (typeof this.yy.parseError === "function")
+ this.parseError = this.yy.parseError;
+ function popStack(n) {
+ stack.length = stack.length - 2 * n;
+ vstack.length = vstack.length - n;
+ lstack.length = lstack.length - n;
+ }
+ function lex() {
+ var token;
+ token = self.lexer.lex() || 1;
+ if (typeof token !== "number") {
+ token = self.symbols_[token] || token;
+ }
+ return token;
+ }
+ var symbol, preErrorSymbol, state, action, a, r, yyval = {}, p, len, newState, expected;
+ while (true) {
+ state = stack[stack.length - 1];
+ if (this.defaultActions[state]) {
+ action = this.defaultActions[state];
+ } else {
+ if (symbol === null || typeof symbol == "undefined") {
+ symbol = lex();
+ }
+ action = table[state] && table[state][symbol];
+ }
+ if (typeof action === "undefined" || !action.length || !action[0]) {
+ var errStr = "";
+ if (!recovering) {
+ expected = [];
+ for (p in table[state])
+ if (this.terminals_[p] && p > 2) {
+ expected.push("'" + this.terminals_[p] + "'");
+ }
+ if (this.lexer.showPosition) {
+ errStr = "Parse error on line " + (yylineno + 1) + ":\n" + this.lexer.showPosition() + "\nExpecting " + expected.join(", ") + ", got '" + (this.terminals_[symbol] || symbol) + "'";
+ } else {
+ errStr = "Parse error on line " + (yylineno + 1) + ": Unexpected " + (symbol == 1?"end of input":"'" + (this.terminals_[symbol] || symbol) + "'");
+ }
+ this.parseError(errStr, {text: this.lexer.match, token: this.terminals_[symbol] || symbol, line: this.lexer.yylineno, loc: yyloc, expected: expected});
+ }
+ }
+ if (action[0] instanceof Array && action.length > 1) {
+ throw new Error("Parse Error: multiple actions possible at state: " + state + ", token: " + symbol);
+ }
+ switch (action[0]) {
+ case 1:
+ stack.push(symbol);
+ vstack.push(this.lexer.yytext);
+ lstack.push(this.lexer.yylloc);
+ stack.push(action[1]);
+ symbol = null;
+ if (!preErrorSymbol) {
+ yyleng = this.lexer.yyleng;
+ yytext = this.lexer.yytext;
+ yylineno = this.lexer.yylineno;
+ yyloc = this.lexer.yylloc;
+ if (recovering > 0)
+ recovering--;
+ } else {
+ symbol = preErrorSymbol;
+ preErrorSymbol = null;
+ }
+ break;
+ case 2:
+ len = this.productions_[action[1]][1];
+ yyval.$ = vstack[vstack.length - len];
+ yyval._$ = {first_line: lstack[lstack.length - (len || 1)].first_line, last_line: lstack[lstack.length - 1].last_line, first_column: lstack[lstack.length - (len || 1)].first_column, last_column: lstack[lstack.length - 1].last_column};
+ if (ranges) {
+ yyval._$.range = [lstack[lstack.length - (len || 1)].range[0], lstack[lstack.length - 1].range[1]];
+ }
+ r = this.performAction.call(yyval, yytext, yyleng, yylineno, this.yy, action[1], vstack, lstack);
+ if (typeof r !== "undefined") {
+ return r;
+ }
+ if (len) {
+ stack = stack.slice(0, -1 * len * 2);
+ vstack = vstack.slice(0, -1 * len);
+ lstack = lstack.slice(0, -1 * len);
+ }
+ stack.push(this.productions_[action[1]][0]);
+ vstack.push(yyval.$);
+ lstack.push(yyval._$);
+ newState = table[stack[stack.length - 2]][stack[stack.length - 1]];
+ stack.push(newState);
+ break;
+ case 3:
+ return true;
+ }
+ }
+ return true;
+ }
+ };
+
+
+ function stripFlags(open, close) {
+ return {
+ left: open[2] === '~',
+ right: close[0] === '~' || close[1] === '~'
+ };
+ }
+
+ /* Jison generated lexer */
+ var lexer = (function(){
+ var lexer = ({EOF:1,
+ parseError:function parseError(str, hash) {
+ if (this.yy.parser) {
+ this.yy.parser.parseError(str, hash);
+ } else {
+ throw new Error(str);
+ }
+ },
+ setInput:function (input) {
+ this._input = input;
+ this._more = this._less = this.done = false;
+ this.yylineno = this.yyleng = 0;
+ this.yytext = this.matched = this.match = '';
+ this.conditionStack = ['INITIAL'];
+ this.yylloc = {first_line:1,first_column:0,last_line:1,last_column:0};
+ if (this.options.ranges) this.yylloc.range = [0,0];
+ this.offset = 0;
+ return this;
+ },
+ input:function () {
+ var ch = this._input[0];
+ this.yytext += ch;
+ this.yyleng++;
+ this.offset++;
+ this.match += ch;
+ this.matched += ch;
+ var lines = ch.match(/(?:\r\n?|\n).*/g);
+ if (lines) {
+ this.yylineno++;
+ this.yylloc.last_line++;
+ } else {
+ this.yylloc.last_column++;
+ }
+ if (this.options.ranges) this.yylloc.range[1]++;
+
+ this._input = this._input.slice(1);
+ return ch;
+ },
+ unput:function (ch) {
+ var len = ch.length;
+ var lines = ch.split(/(?:\r\n?|\n)/g);
+
+ this._input = ch + this._input;
+ this.yytext = this.yytext.substr(0, this.yytext.length-len-1);
+ //this.yyleng -= len;
+ this.offset -= len;
+ var oldLines = this.match.split(/(?:\r\n?|\n)/g);
+ this.match = this.match.substr(0, this.match.length-1);
+ this.matched = this.matched.substr(0, this.matched.length-1);
+
+ if (lines.length-1) this.yylineno -= lines.length-1;
+ var r = this.yylloc.range;
+
+ this.yylloc = {first_line: this.yylloc.first_line,
+ last_line: this.yylineno+1,
+ first_column: this.yylloc.first_column,
+ last_column: lines ?
+ (lines.length === oldLines.length ? this.yylloc.first_column : 0) + oldLines[oldLines.length - lines.length].length - lines[0].length:
+ this.yylloc.first_column - len
+ };
+
+ if (this.options.ranges) {
+ this.yylloc.range = [r[0], r[0] + this.yyleng - len];
+ }
+ return this;
+ },
+ more:function () {
+ this._more = true;
+ return this;
+ },
+ less:function (n) {
+ this.unput(this.match.slice(n));
+ },
+ pastInput:function () {
+ var past = this.matched.substr(0, this.matched.length - this.match.length);
+ return (past.length > 20 ? '...':'') + past.substr(-20).replace(/\n/g, "");
+ },
+ upcomingInput:function () {
+ var next = this.match;
+ if (next.length < 20) {
+ next += this._input.substr(0, 20-next.length);
+ }
+ return (next.substr(0,20)+(next.length > 20 ? '...':'')).replace(/\n/g, "");
+ },
+ showPosition:function () {
+ var pre = this.pastInput();
+ var c = new Array(pre.length + 1).join("-");
+ return pre + this.upcomingInput() + "\n" + c+"^";
+ },
+ next:function () {
+ if (this.done) {
+ return this.EOF;
+ }
+ if (!this._input) this.done = true;
+
+ var token,
+ match,
+ tempMatch,
+ index,
+ col,
+ lines;
+ if (!this._more) {
+ this.yytext = '';
+ this.match = '';
+ }
+ var rules = this._currentRules();
+ for (var i=0;i < rules.length; i++) {
+ tempMatch = this._input.match(this.rules[rules[i]]);
+ if (tempMatch && (!match || tempMatch[0].length > match[0].length)) {
+ match = tempMatch;
+ index = i;
+ if (!this.options.flex) break;
+ }
+ }
+ if (match) {
+ lines = match[0].match(/(?:\r\n?|\n).*/g);
+ if (lines) this.yylineno += lines.length;
+ this.yylloc = {first_line: this.yylloc.last_line,
+ last_line: this.yylineno+1,
+ first_column: this.yylloc.last_column,
+ last_column: lines ? lines[lines.length-1].length-lines[lines.length-1].match(/\r?\n?/)[0].length : this.yylloc.last_column + match[0].length};
+ this.yytext += match[0];
+ this.match += match[0];
+ this.matches = match;
+ this.yyleng = this.yytext.length;
+ if (this.options.ranges) {
+ this.yylloc.range = [this.offset, this.offset += this.yyleng];
+ }
+ this._more = false;
+ this._input = this._input.slice(match[0].length);
+ this.matched += match[0];
+ token = this.performAction.call(this, this.yy, this, rules[index],this.conditionStack[this.conditionStack.length-1]);
+ if (this.done && this._input) this.done = false;
+ if (token) return token;
+ else return;
+ }
+ if (this._input === "") {
+ return this.EOF;
+ } else {
+ return this.parseError('Lexical error on line '+(this.yylineno+1)+'. Unrecognized text.\n'+this.showPosition(),
+ {text: "", token: null, line: this.yylineno});
+ }
+ },
+ lex:function lex() {
+ var r = this.next();
+ if (typeof r !== 'undefined') {
+ return r;
+ } else {
+ return this.lex();
+ }
+ },
+ begin:function begin(condition) {
+ this.conditionStack.push(condition);
+ },
+ popState:function popState() {
+ return this.conditionStack.pop();
+ },
+ _currentRules:function _currentRules() {
+ return this.conditions[this.conditionStack[this.conditionStack.length-1]].rules;
+ },
+ topState:function () {
+ return this.conditionStack[this.conditionStack.length-2];
+ },
+ pushState:function begin(condition) {
+ this.begin(condition);
+ }});
+ lexer.options = {};
+ lexer.performAction = function anonymous(yy,yy_,$avoiding_name_collisions,YY_START) {
+
+
+ function strip(start, end) {
+ return yy_.yytext = yy_.yytext.substr(start, yy_.yyleng-end);
+ }
+
+
+ var YYSTATE=YY_START
+ switch($avoiding_name_collisions) {
+ case 0:
+ if(yy_.yytext.slice(-2) === "\\\\") {
+ strip(0,1);
+ this.begin("mu");
+ } else if(yy_.yytext.slice(-1) === "\\") {
+ strip(0,1);
+ this.begin("emu");
+ } else {
+ this.begin("mu");
+ }
+ if(yy_.yytext) return 14;
+
+ break;
+ case 1:return 14;
+ break;
+ case 2:
+ if(yy_.yytext.slice(-1) !== "\\") this.popState();
+ if(yy_.yytext.slice(-1) === "\\") strip(0,1);
+ return 14;
+
+ break;
+ case 3:strip(0,4); this.popState(); return 15;
+ break;
+ case 4:return 25;
+ break;
+ case 5:return 16;
+ break;
+ case 6:return 20;
+ break;
+ case 7:return 19;
+ break;
+ case 8:return 19;
+ break;
+ case 9:return 23;
+ break;
+ case 10:return 22;
+ break;
+ case 11:this.popState(); this.begin('com');
+ break;
+ case 12:strip(3,5); this.popState(); return 15;
+ break;
+ case 13:return 22;
+ break;
+ case 14:return 39;
+ break;
+ case 15:return 38;
+ break;
+ case 16:return 38;
+ break;
+ case 17:return 42;
+ break;
+ case 18:/*ignore whitespace*/
+ break;
+ case 19:this.popState(); return 24;
+ break;
+ case 20:this.popState(); return 18;
+ break;
+ case 21:yy_.yytext = strip(1,2).replace(/\\"/g,'"'); return 32;
+ break;
+ case 22:yy_.yytext = strip(1,2).replace(/\\'/g,"'"); return 32;
+ break;
+ case 23:return 40;
+ break;
+ case 24:return 34;
+ break;
+ case 25:return 34;
+ break;
+ case 26:return 33;
+ break;
+ case 27:return 38;
+ break;
+ case 28:yy_.yytext = strip(1,2); return 38;
+ break;
+ case 29:return 'INVALID';
+ break;
+ case 30:return 5;
+ break;
+ }
+ };
+ lexer.rules = [/^(?:[^\x00]*?(?=(\{\{)))/,/^(?:[^\x00]+)/,/^(?:[^\x00]{2,}?(?=(\{\{|$)))/,/^(?:[\s\S]*?--\}\})/,/^(?:\{\{(~)?>)/,/^(?:\{\{(~)?#)/,/^(?:\{\{(~)?\/)/,/^(?:\{\{(~)?\^)/,/^(?:\{\{(~)?\s*else\b)/,/^(?:\{\{(~)?\{)/,/^(?:\{\{(~)?&)/,/^(?:\{\{!--)/,/^(?:\{\{![\s\S]*?\}\})/,/^(?:\{\{(~)?)/,/^(?:=)/,/^(?:\.\.)/,/^(?:\.(?=([=~}\s\/.])))/,/^(?:[\/.])/,/^(?:\s+)/,/^(?:\}(~)?\}\})/,/^(?:(~)?\}\})/,/^(?:"(\\["]|[^"])*")/,/^(?:'(\\[']|[^'])*')/,/^(?:@)/,/^(?:true(?=([~}\s])))/,/^(?:false(?=([~}\s])))/,/^(?:-?[0-9]+(?=([~}\s])))/,/^(?:([^\s!"#%-,\.\/;->@\[-\^`\{-~]+(?=([=~}\s\/.]))))/,/^(?:\[[^\]]*\])/,/^(?:.)/,/^(?:$)/];
+ lexer.conditions = {"mu":{"rules":[4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27,28,29,30],"inclusive":false},"emu":{"rules":[2],"inclusive":false},"com":{"rules":[3],"inclusive":false},"INITIAL":{"rules":[0,1,30],"inclusive":true}};
+ return lexer;})()
+ parser.lexer = lexer;
+ function Parser () { this.yy = {}; }Parser.prototype = parser;parser.Parser = Parser;
+ return new Parser;
+ })();__exports__ = handlebars;
+ return __exports__;
+})();
+
+// handlebars/compiler/base.js
+var __module8__ = (function(__dependency1__, __dependency2__) {
+ "use strict";
+ var __exports__ = {};
+ var parser = __dependency1__;
+ var AST = __dependency2__;
+
+ __exports__.parser = parser;
+
+ function parse(input) {
+ // Just return if an already-compile AST was passed in.
+ if(input.constructor === AST.ProgramNode) { return input; }
+
+ parser.yy = AST;
+ return parser.parse(input);
+ }
+
+ __exports__.parse = parse;
+ return __exports__;
+})(__module9__, __module7__);
+
+// handlebars/compiler/javascript-compiler.js
+var __module11__ = (function(__dependency1__) {
+ "use strict";
+ var __exports__;
+ var COMPILER_REVISION = __dependency1__.COMPILER_REVISION;
+ var REVISION_CHANGES = __dependency1__.REVISION_CHANGES;
+ var log = __dependency1__.log;
+
+ function Literal(value) {
+ this.value = value;
+ }
+
+ function JavaScriptCompiler() {}
+
+ JavaScriptCompiler.prototype = {
+ // PUBLIC API: You can override these methods in a subclass to provide
+ // alternative compiled forms for name lookup and buffering semantics
+ nameLookup: function(parent, name /* , type*/) {
+ var wrap,
+ ret;
+ if (parent.indexOf('depth') === 0) {
+ wrap = true;
+ }
+
+ if (/^[0-9]+$/.test(name)) {
+ ret = parent + "[" + name + "]";
+ } else if (JavaScriptCompiler.isValidJavaScriptVariableName(name)) {
+ ret = parent + "." + name;
+ }
+ else {
+ ret = parent + "['" + name + "']";
+ }
+
+ if (wrap) {
+ return '(' + parent + ' && ' + ret + ')';
+ } else {
+ return ret;
+ }
+ },
+
+ appendToBuffer: function(string) {
+ if (this.environment.isSimple) {
+ return "return " + string + ";";
+ } else {
+ return {
+ appendToBuffer: true,
+ content: string,
+ toString: function() { return "buffer += " + string + ";"; }
+ };
+ }
+ },
+
+ initializeBuffer: function() {
+ return this.quotedString("");
+ },
+
+ namespace: "Handlebars",
+ // END PUBLIC API
+
+ compile: function(environment, options, context, asObject) {
+ this.environment = environment;
+ this.options = options || {};
+
+ log('debug', this.environment.disassemble() + "\n\n");
+
+ this.name = this.environment.name;
+ this.isChild = !!context;
+ this.context = context || {
+ programs: [],
+ environments: [],
+ aliases: { }
+ };
+
+ this.preamble();
+
+ this.stackSlot = 0;
+ this.stackVars = [];
+ this.registers = { list: [] };
+ this.compileStack = [];
+ this.inlineStack = [];
+
+ this.compileChildren(environment, options);
+
+ var opcodes = environment.opcodes, opcode;
+
+ this.i = 0;
+
+ for(var l=opcodes.length; this.i<l; this.i++) {
+ opcode = opcodes[this.i];
+
+ if(opcode.opcode === 'DECLARE') {
+ this[opcode.name] = opcode.value;
+ } else {
+ this[opcode.opcode].apply(this, opcode.args);
+ }
+
+ // Reset the stripNext flag if it was not set by this operation.
+ if (opcode.opcode !== this.stripNext) {
+ this.stripNext = false;
+ }
+ }
+
+ // Flush any trailing content that might be pending.
+ this.pushSource('');
+
+ return this.createFunctionContext(asObject);
+ },
+
+ preamble: function() {
+ var out = [];
+
+ if (!this.isChild) {
+ var namespace = this.namespace;
+
+ var copies = "helpers = this.merge(helpers, " + namespace + ".helpers);";
+ if (this.environment.usePartial) { copies = copies + " partials = this.merge(partials, " + namespace + ".partials);"; }
+ if (this.options.data) { copies = copies + " data = data || {};"; }
+ out.push(copies);
+ } else {
+ out.push('');
+ }
+
+ if (!this.environment.isSimple) {
+ out.push(", buffer = " + this.initializeBuffer());
+ } else {
+ out.push("");
+ }
+
+ // track the last context pushed into place to allow skipping the
+ // getContext opcode when it would be a noop
+ this.lastContext = 0;
+ this.source = out;
+ },
+
+ createFunctionContext: function(asObject) {
+ var locals = this.stackVars.concat(this.registers.list);
+
+ if(locals.length > 0) {
+ this.source[1] = this.source[1] + ", " + locals.join(", ");
+ }
+
+ // Generate minimizer alias mappings
+ if (!this.isChild) {
+ for (var alias in this.context.aliases) {
+ if (this.context.aliases.hasOwnProperty(alias)) {
+ this.source[1] = this.source[1] + ', ' + alias + '=' + this.context.aliases[alias];
+ }
+ }
+ }
+
+ if (this.source[1]) {
+ this.source[1] = "var " + this.source[1].substring(2) + ";";
+ }
+
+ // Merge children
+ if (!this.isChild) {
+ this.source[1] += '\n' + this.context.programs.join('\n') + '\n';
+ }
+
+ if (!this.environment.isSimple) {
+ this.pushSource("return buffer;");
+ }
+
+ var params = this.isChild ? ["depth0", "data"] : ["Handlebars", "depth0", "helpers", "partials", "data"];
+
+ for(var i=0, l=this.environment.depths.list.length; i<l; i++) {
+ params.push("depth" + this.environment.depths.list[i]);
+ }
+
+ // Perform a second pass over the output to merge content when possible
+ var source = this.mergeSource();
+
+ if (!this.isChild) {
+ var revision = COMPILER_REVISION,
+ versions = REVISION_CHANGES[revision];
+ source = "this.compilerInfo = ["+revision+",'"+versions+"'];\n"+source;
+ }
+
+ if (asObject) {
+ params.push(source);
+
+ return Function.apply(this, params);
+ } else {
+ var functionSource = 'function ' + (this.name || '') + '(' + params.join(',') + ') {\n ' + source + '}';
+ log('debug', functionSource + "\n\n");
+ return functionSource;
+ }
+ },
+ mergeSource: function() {
+ // WARN: We are not handling the case where buffer is still populated as the source should
+ // not have buffer append operations as their final action.
+ var source = '',
+ buffer;
+ for (var i = 0, len = this.source.length; i < len; i++) {
+ var line = this.source[i];
+ if (line.appendToBuffer) {
+ if (buffer) {
+ buffer = buffer + '\n + ' + line.content;
+ } else {
+ buffer = line.content;
+ }
+ } else {
+ if (buffer) {
+ source += 'buffer += ' + buffer + ';\n ';
+ buffer = undefined;
+ }
+ source += line + '\n ';
+ }
+ }
+ return source;
+ },
+
+ // [blockValue]
+ //
+ // On stack, before: hash, inverse, program, value
+ // On stack, after: return value of blockHelperMissing
+ //
+ // The purpose of this opcode is to take a block of the form
+ // `{{#foo}}...{{/foo}}`, resolve the value of `foo`, and
+ // replace it on the stack with the result of properly
+ // invoking blockHelperMissing.
+ blockValue: function() {
+ this.context.aliases.blockHelperMissing = 'helpers.blockHelperMissing';
+
+ var params = ["depth0"];
+ this.setupParams(0, params);
+
+ this.replaceStack(function(current) {
+ params.splice(1, 0, current);
+ return "blockHelperMissing.call(" + params.join(", ") + ")";
+ });
+ },
+
+ // [ambiguousBlockValue]
+ //
+ // On stack, before: hash, inverse, program, value
+ // Compiler value, before: lastHelper=value of last found helper, if any
+ // On stack, after, if no lastHelper: same as [blockValue]
+ // On stack, after, if lastHelper: value
+ ambiguousBlockValue: function() {
+ this.context.aliases.blockHelperMissing = 'helpers.blockHelperMissing';
+
+ var params = ["depth0"];
+ this.setupParams(0, params);
+
+ var current = this.topStack();
+ params.splice(1, 0, current);
+
+ // Use the options value generated from the invocation
+ params[params.length-1] = 'options';
+
+ this.pushSource("if (!" + this.lastHelper + ") { " + current + " = blockHelperMissing.call(" + params.join(", ") + "); }");
+ },
+
+ // [appendContent]
+ //
+ // On stack, before: ...
+ // On stack, after: ...
+ //
+ // Appends the string value of `content` to the current buffer
+ appendContent: function(content) {
+ if (this.pendingContent) {
+ content = this.pendingContent + content;
+ }
+ if (this.stripNext) {
+ content = content.replace(/^\s+/, '');
+ }
+
+ this.pendingContent = content;
+ },
+
+ // [strip]
+ //
+ // On stack, before: ...
+ // On stack, after: ...
+ //
+ // Removes any trailing whitespace from the prior content node and flags
+ // the next operation for stripping if it is a content node.
+ strip: function() {
+ if (this.pendingContent) {
+ this.pendingContent = this.pendingContent.replace(/\s+$/, '');
+ }
+ this.stripNext = 'strip';
+ },
+
+ // [append]
+ //
+ // On stack, before: value, ...
+ // On stack, after: ...
+ //
+ // Coerces `value` to a String and appends it to the current buffer.
+ //
+ // If `value` is truthy, or 0, it is coerced into a string and appended
+ // Otherwise, the empty string is appended
+ append: function() {
+ // Force anything that is inlined onto the stack so we don't have duplication
+ // when we examine local
+ this.flushInline();
+ var local = this.popStack();
+ this.pushSource("if(" + local + " || " + local + " === 0) { " + this.appendToBuffer(local) + " }");
+ if (this.environment.isSimple) {
+ this.pushSource("else { " + this.appendToBuffer("''") + " }");
+ }
+ },
+
+ // [appendEscaped]
+ //
+ // On stack, before: value, ...
+ // On stack, after: ...
+ //
+ // Escape `value` and append it to the buffer
+ appendEscaped: function() {
+ this.context.aliases.escapeExpression = 'this.escapeExpression';
+
+ this.pushSource(this.appendToBuffer("escapeExpression(" + this.popStack() + ")"));
+ },
+
+ // [getContext]
+ //
+ // On stack, before: ...
+ // On stack, after: ...
+ // Compiler value, after: lastContext=depth
+ //
+ // Set the value of the `lastContext` compiler value to the depth
+ getContext: function(depth) {
+ if(this.lastContext !== depth) {
+ this.lastContext = depth;
+ }
+ },
+
+ // [lookupOnContext]
+ //
+ // On stack, before: ...
+ // On stack, after: currentContext[name], ...
+ //
+ // Looks up the value of `name` on the current context and pushes
+ // it onto the stack.
+ lookupOnContext: function(name) {
+ this.push(this.nameLookup('depth' + this.lastContext, name, 'context'));
+ },
+
+ // [pushContext]
+ //
+ // On stack, before: ...
+ // On stack, after: currentContext, ...
+ //
+ // Pushes the value of the current context onto the stack.
+ pushContext: function() {
+ this.pushStackLiteral('depth' + this.lastContext);
+ },
+
+ // [resolvePossibleLambda]
+ //
+ // On stack, before: value, ...
+ // On stack, after: resolved value, ...
+ //
+ // If the `value` is a lambda, replace it on the stack by
+ // the return value of the lambda
+ resolvePossibleLambda: function() {
+ this.context.aliases.functionType = '"function"';
+
+ this.replaceStack(function(current) {
+ return "typeof " + current + " === functionType ? " + current + ".apply(depth0) : " + current;
+ });
+ },
+
+ // [lookup]
+ //
+ // On stack, before: value, ...
+ // On stack, after: value[name], ...
+ //
+ // Replace the value on the stack with the result of looking
+ // up `name` on `value`
+ lookup: function(name) {
+ this.replaceStack(function(current) {
+ return current + " == null || " + current + " === false ? " + current + " : " + this.nameLookup(current, name, 'context');
+ });
+ },
+
+ // [lookupData]
+ //
+ // On stack, before: ...
+ // On stack, after: data, ...
+ //
+ // Push the data lookup operator
+ lookupData: function() {
+ this.push('data');
+ },
+
+ // [pushStringParam]
+ //
+ // On stack, before: ...
+ // On stack, after: string, currentContext, ...
+ //
+ // This opcode is designed for use in string mode, which
+ // provides the string value of a parameter along with its
+ // depth rather than resolving it immediately.
+ pushStringParam: function(string, type) {
+ this.pushStackLiteral('depth' + this.lastContext);
+
+ this.pushString(type);
+
+ if (typeof string === 'string') {
+ this.pushString(string);
+ } else {
+ this.pushStackLiteral(string);
+ }
+ },
+
+ emptyHash: function() {
+ this.pushStackLiteral('{}');
+
+ if (this.options.stringParams) {
+ this.register('hashTypes', '{}');
+ this.register('hashContexts', '{}');
+ }
+ },
+ pushHash: function() {
+ this.hash = {values: [], types: [], contexts: []};
+ },
+ popHash: function() {
+ var hash = this.hash;
+ this.hash = undefined;
+
+ if (this.options.stringParams) {
+ this.register('hashContexts', '{' + hash.contexts.join(',') + '}');
+ this.register('hashTypes', '{' + hash.types.join(',') + '}');
+ }
+ this.push('{\n ' + hash.values.join(',\n ') + '\n }');
+ },
+
+ // [pushString]
+ //
+ // On stack, before: ...
+ // On stack, after: quotedString(string), ...
+ //
+ // Push a quoted version of `string` onto the stack
+ pushString: function(string) {
+ this.pushStackLiteral(this.quotedString(string));
+ },
+
+ // [push]
+ //
+ // On stack, before: ...
+ // On stack, after: expr, ...
+ //
+ // Push an expression onto the stack
+ push: function(expr) {
+ this.inlineStack.push(expr);
+ return expr;
+ },
+
+ // [pushLiteral]
+ //
+ // On stack, before: ...
+ // On stack, after: value, ...
+ //
+ // Pushes a value onto the stack. This operation prevents
+ // the compiler from creating a temporary variable to hold
+ // it.
+ pushLiteral: function(value) {
+ this.pushStackLiteral(value);
+ },
+
+ // [pushProgram]
+ //
+ // On stack, before: ...
+ // On stack, after: program(guid), ...
+ //
+ // Push a program expression onto the stack. This takes
+ // a compile-time guid and converts it into a runtime-accessible
+ // expression.
+ pushProgram: function(guid) {
+ if (guid != null) {
+ this.pushStackLiteral(this.programExpression(guid));
+ } else {
+ this.pushStackLiteral(null);
+ }
+ },
+
+ // [invokeHelper]
+ //
+ // On stack, before: hash, inverse, program, params..., ...
+ // On stack, after: result of helper invocation
+ //
+ // Pops off the helper's parameters, invokes the helper,
+ // and pushes the helper's return value onto the stack.
+ //
+ // If the helper is not found, `helperMissing` is called.
+ invokeHelper: function(paramSize, name) {
+ this.context.aliases.helperMissing = 'helpers.helperMissing';
+
+ var helper = this.lastHelper = this.setupHelper(paramSize, name, true);
+ var nonHelper = this.nameLookup('depth' + this.lastContext, name, 'context');
+
+ this.push(helper.name + ' || ' + nonHelper);
+ this.replaceStack(function(name) {
+ return name + ' ? ' + name + '.call(' +
+ helper.callParams + ") " + ": helperMissing.call(" +
+ helper.helperMissingParams + ")";
+ });
+ },
+
+ // [invokeKnownHelper]
+ //
+ // On stack, before: hash, inverse, program, params..., ...
+ // On stack, after: result of helper invocation
+ //
+ // This operation is used when the helper is known to exist,
+ // so a `helperMissing` fallback is not required.
+ invokeKnownHelper: function(paramSize, name) {
+ var helper = this.setupHelper(paramSize, name);
+ this.push(helper.name + ".call(" + helper.callParams + ")");
+ },
+
+ // [invokeAmbiguous]
+ //
+ // On stack, before: hash, inverse, program, params..., ...
+ // On stack, after: result of disambiguation
+ //
+ // This operation is used when an expression like `{{foo}}`
+ // is provided, but we don't know at compile-time whether it
+ // is a helper or a path.
+ //
+ // This operation emits more code than the other options,
+ // and can be avoided by passing the `knownHelpers` and
+ // `knownHelpersOnly` flags at compile-time.
+ invokeAmbiguous: function(name, helperCall) {
+ this.context.aliases.functionType = '"function"';
+
+ this.pushStackLiteral('{}'); // Hash value
+ var helper = this.setupHelper(0, name, helperCall);
+
+ var helperName = this.lastHelper = this.nameLookup('helpers', name, 'helper');
+
+ var nonHelper = this.nameLookup('depth' + this.lastContext, name, 'context');
+ var nextStack = this.nextStack();
+
+ this.pushSource('if (' + nextStack + ' = ' + helperName + ') { ' + nextStack + ' = ' + nextStack + '.call(' + helper.callParams + '); }');
+ this.pushSource('else { ' + nextStack + ' = ' + nonHelper + '; ' + nextStack + ' = typeof ' + nextStack + ' === functionType ? ' + nextStack + '.call(' + helper.callParams + ') : ' + nextStack + '; }');
+ },
+
+ // [invokePartial]
+ //
+ // On stack, before: context, ...
+ // On stack after: result of partial invocation
+ //
+ // This operation pops off a context, invokes a partial with that context,
+ // and pushes the result of the invocation back.
+ invokePartial: function(name) {
+ var params = [this.nameLookup('partials', name, 'partial'), "'" + name + "'", this.popStack(), "helpers", "partials"];
+
+ if (this.options.data) {
+ params.push("data");
+ }
+
+ this.context.aliases.self = "this";
+ this.push("self.invokePartial(" + params.join(", ") + ")");
+ },
+
+ // [assignToHash]
+ //
+ // On stack, before: value, hash, ...
+ // On stack, after: hash, ...
+ //
+ // Pops a value and hash off the stack, assigns `hash[key] = value`
+ // and pushes the hash back onto the stack.
+ assignToHash: function(key) {
+ var value = this.popStack(),
+ context,
+ type;
+
+ if (this.options.stringParams) {
+ type = this.popStack();
+ context = this.popStack();
+ }
+
+ var hash = this.hash;
+ if (context) {
+ hash.contexts.push("'" + key + "': " + context);
+ }
+ if (type) {
+ hash.types.push("'" + key + "': " + type);
+ }
+ hash.values.push("'" + key + "': (" + value + ")");
+ },
+
+ // HELPERS
+
+ compiler: JavaScriptCompiler,
+
+ compileChildren: function(environment, options) {
+ var children = environment.children, child, compiler;
+
+ for(var i=0, l=children.length; i<l; i++) {
+ child = children[i];
+ compiler = new this.compiler();
+
+ var index = this.matchExistingProgram(child);
+
+ if (index == null) {
+ this.context.programs.push(''); // Placeholder to prevent name conflicts for nested children
+ index = this.context.programs.length;
+ child.index = index;
+ child.name = 'program' + index;
+ this.context.programs[index] = compiler.compile(child, options, this.context);
+ this.context.environments[index] = child;
+ } else {
+ child.index = index;
+ child.name = 'program' + index;
+ }
+ }
+ },
+ matchExistingProgram: function(child) {
+ for (var i = 0, len = this.context.environments.length; i < len; i++) {
+ var environment = this.context.environments[i];
+ if (environment && environment.equals(child)) {
+ return i;
+ }
+ }
+ },
+
+ programExpression: function(guid) {
+ this.context.aliases.self = "this";
+
+ if(guid == null) {
+ return "self.noop";
+ }
+
+ var child = this.environment.children[guid],
+ depths = child.depths.list, depth;
+
+ var programParams = [child.index, child.name, "data"];
+
+ for(var i=0, l = depths.length; i<l; i++) {
+ depth = depths[i];
+
+ if(depth === 1) { programParams.push("depth0"); }
+ else { programParams.push("depth" + (depth - 1)); }
+ }
+
+ return (depths.length === 0 ? "self.program(" : "self.programWithDepth(") + programParams.join(", ") + ")";
+ },
+
+ register: function(name, val) {
+ this.useRegister(name);
+ this.pushSource(name + " = " + val + ";");
+ },
+
+ useRegister: function(name) {
+ if(!this.registers[name]) {
+ this.registers[name] = true;
+ this.registers.list.push(name);
+ }
+ },
+
+ pushStackLiteral: function(item) {
+ return this.push(new Literal(item));
+ },
+
+ pushSource: function(source) {
+ if (this.pendingContent) {
+ this.source.push(this.appendToBuffer(this.quotedString(this.pendingContent)));
+ this.pendingContent = undefined;
+ }
+
+ if (source) {
+ this.source.push(source);
+ }
+ },
+
+ pushStack: function(item) {
+ this.flushInline();
+
+ var stack = this.incrStack();
+ if (item) {
+ this.pushSource(stack + " = " + item + ";");
+ }
+ this.compileStack.push(stack);
+ return stack;
+ },
+
+ replaceStack: function(callback) {
+ var prefix = '',
+ inline = this.isInline(),
+ stack;
+
+ // If we are currently inline then we want to merge the inline statement into the
+ // replacement statement via ','
+ if (inline) {
+ var top = this.popStack(true);
+
+ if (top instanceof Literal) {
+ // Literals do not need to be inlined
+ stack = top.value;
+ } else {
+ // Get or create the current stack name for use by the inline
+ var name = this.stackSlot ? this.topStackName() : this.incrStack();
+
+ prefix = '(' + this.push(name) + ' = ' + top + '),';
+ stack = this.topStack();
+ }
+ } else {
+ stack = this.topStack();
+ }
+
+ var item = callback.call(this, stack);
+
+ if (inline) {
+ if (this.inlineStack.length || this.compileStack.length) {
+ this.popStack();
+ }
+ this.push('(' + prefix + item + ')');
+ } else {
+ // Prevent modification of the context depth variable. Through replaceStack
+ if (!/^stack/.test(stack)) {
+ stack = this.nextStack();
+ }
+
+ this.pushSource(stack + " = (" + prefix + item + ");");
+ }
+ return stack;
+ },
+
+ nextStack: function() {
+ return this.pushStack();
+ },
+
+ incrStack: function() {
+ this.stackSlot++;
+ if(this.stackSlot > this.stackVars.length) { this.stackVars.push("stack" + this.stackSlot); }
+ return this.topStackName();
+ },
+ topStackName: function() {
+ return "stack" + this.stackSlot;
+ },
+ flushInline: function() {
+ var inlineStack = this.inlineStack;
+ if (inlineStack.length) {
+ this.inlineStack = [];
+ for (var i = 0, len = inlineStack.length; i < len; i++) {
+ var entry = inlineStack[i];
+ if (entry instanceof Literal) {
+ this.compileStack.push(entry);
+ } else {
+ this.pushStack(entry);
+ }
+ }
+ }
+ },
+ isInline: function() {
+ return this.inlineStack.length;
+ },
+
+ popStack: function(wrapped) {
+ var inline = this.isInline(),
+ item = (inline ? this.inlineStack : this.compileStack).pop();
+
+ if (!wrapped && (item instanceof Literal)) {
+ return item.value;
+ } else {
+ if (!inline) {
+ this.stackSlot--;
+ }
+ return item;
+ }
+ },
+
+ topStack: function(wrapped) {
+ var stack = (this.isInline() ? this.inlineStack : this.compileStack),
+ item = stack[stack.length - 1];
+
+ if (!wrapped && (item instanceof Literal)) {
+ return item.value;
+ } else {
+ return item;
+ }
+ },
+
+ quotedString: function(str) {
+ return '"' + str
+ .replace(/\\/g, '\\\\')
+ .replace(/"/g, '\\"')
+ .replace(/\n/g, '\\n')
+ .replace(/\r/g, '\\r')
+ .replace(/\u2028/g, '\\u2028') // Per Ecma-262 7.3 + 7.8.4
+ .replace(/\u2029/g, '\\u2029') + '"';
+ },
+
+ setupHelper: function(paramSize, name, missingParams) {
+ var params = [];
+ this.setupParams(paramSize, params, missingParams);
+ var foundHelper = this.nameLookup('helpers', name, 'helper');
+
+ return {
+ params: params,
+ name: foundHelper,
+ callParams: ["depth0"].concat(params).join(", "),
+ helperMissingParams: missingParams && ["depth0", this.quotedString(name)].concat(params).join(", ")
+ };
+ },
+
+ // the params and contexts arguments are passed in arrays
+ // to fill in
+ setupParams: function(paramSize, params, useRegister) {
+ var options = [], contexts = [], types = [], param, inverse, program;
+
+ options.push("hash:" + this.popStack());
+
+ inverse = this.popStack();
+ program = this.popStack();
+
+ // Avoid setting fn and inverse if neither are set. This allows
+ // helpers to do a check for `if (options.fn)`
+ if (program || inverse) {
+ if (!program) {
+ this.context.aliases.self = "this";
+ program = "self.noop";
+ }
+
+ if (!inverse) {
+ this.context.aliases.self = "this";
+ inverse = "self.noop";
+ }
+
+ options.push("inverse:" + inverse);
+ options.push("fn:" + program);
+ }
+
+ for(var i=0; i<paramSize; i++) {
+ param = this.popStack();
+ params.push(param);
+
+ if(this.options.stringParams) {
+ types.push(this.popStack());
+ contexts.push(this.popStack());
+ }
+ }
+
+ if (this.options.stringParams) {
+ options.push("contexts:[" + contexts.join(",") + "]");
+ options.push("types:[" + types.join(",") + "]");
+ options.push("hashContexts:hashContexts");
+ options.push("hashTypes:hashTypes");
+ }
+
+ if(this.options.data) {
+ options.push("data:data");
+ }
+
+ options = "{" + options.join(",") + "}";
+ if (useRegister) {
+ this.register('options', options);
+ params.push('options');
+ } else {
+ params.push(options);
+ }
+ return params.join(", ");
+ }
+ };
+
+ var reservedWords = (
+ "break else new var" +
+ " case finally return void" +
+ " catch for switch while" +
+ " continue function this with" +
+ " default if throw" +
+ " delete in try" +
+ " do instanceof typeof" +
+ " abstract enum int short" +
+ " boolean export interface static" +
+ " byte extends long super" +
+ " char final native synchronized" +
+ " class float package throws" +
+ " const goto private transient" +
+ " debugger implements protected volatile" +
+ " double import public let yield"
+ ).split(" ");
+
+ var compilerWords = JavaScriptCompiler.RESERVED_WORDS = {};
+
+ for(var i=0, l=reservedWords.length; i<l; i++) {
+ compilerWords[reservedWords[i]] = true;
+ }
+
+ JavaScriptCompiler.isValidJavaScriptVariableName = function(name) {
+ if(!JavaScriptCompiler.RESERVED_WORDS[name] && /^[a-zA-Z_$][0-9a-zA-Z_$]+$/.test(name)) {
+ return true;
+ }
+ return false;
+ };
+
+ __exports__ = JavaScriptCompiler;
+ return __exports__;
+})(__module2__);
+
+// handlebars/compiler/compiler.js
+var __module10__ = (function(__dependency1__, __dependency2__, __dependency3__, __dependency4__) {
+ "use strict";
+ var __exports__ = {};
+ var Exception = __dependency1__;
+ var parse = __dependency2__.parse;
+ var JavaScriptCompiler = __dependency3__;
+ var AST = __dependency4__;
+
+ function Compiler() {}
+
+ __exports__.Compiler = Compiler;// the foundHelper register will disambiguate helper lookup from finding a
+ // function in a context. This is necessary for mustache compatibility, which
+ // requires that context functions in blocks are evaluated by blockHelperMissing,
+ // and then proceed as if the resulting value was provided to blockHelperMissing.
+
+ Compiler.prototype = {
+ compiler: Compiler,
+
+ disassemble: function() {
+ var opcodes = this.opcodes, opcode, out = [], params, param;
+
+ for (var i=0, l=opcodes.length; i<l; i++) {
+ opcode = opcodes[i];
+
+ if (opcode.opcode === 'DECLARE') {
+ out.push("DECLARE " + opcode.name + "=" + opcode.value);
+ } else {
+ params = [];
+ for (var j=0; j<opcode.args.length; j++) {
+ param = opcode.args[j];
+ if (typeof param === "string") {
+ param = "\"" + param.replace("\n", "\\n") + "\"";
+ }
+ params.push(param);
+ }
+ out.push(opcode.opcode + " " + params.join(" "));
+ }
+ }
+
+ return out.join("\n");
+ },
+
+ equals: function(other) {
+ var len = this.opcodes.length;
+ if (other.opcodes.length !== len) {
+ return false;
+ }
+
+ for (var i = 0; i < len; i++) {
+ var opcode = this.opcodes[i],
+ otherOpcode = other.opcodes[i];
+ if (opcode.opcode !== otherOpcode.opcode || opcode.args.length !== otherOpcode.args.length) {
+ return false;
+ }
+ for (var j = 0; j < opcode.args.length; j++) {
+ if (opcode.args[j] !== otherOpcode.args[j]) {
+ return false;
+ }
+ }
+ }
+
+ len = this.children.length;
+ if (other.children.length !== len) {
+ return false;
+ }
+ for (i = 0; i < len; i++) {
+ if (!this.children[i].equals(other.children[i])) {
+ return false;
+ }
+ }
+
+ return true;
+ },
+
+ guid: 0,
+
+ compile: function(program, options) {
+ this.opcodes = [];
+ this.children = [];
+ this.depths = {list: []};
+ this.options = options;
+
+ // These changes will propagate to the other compiler components
+ var knownHelpers = this.options.knownHelpers;
+ this.options.knownHelpers = {
+ 'helperMissing': true,
+ 'blockHelperMissing': true,
+ 'each': true,
+ 'if': true,
+ 'unless': true,
+ 'with': true,
+ 'log': true
+ };
+ if (knownHelpers) {
+ for (var name in knownHelpers) {
+ this.options.knownHelpers[name] = knownHelpers[name];
+ }
+ }
+
+ return this.accept(program);
+ },
+
+ accept: function(node) {
+ var strip = node.strip || {},
+ ret;
+ if (strip.left) {
+ this.opcode('strip');
+ }
+
+ ret = this[node.type](node);
+
+ if (strip.right) {
+ this.opcode('strip');
+ }
+
+ return ret;
+ },
+
+ program: function(program) {
+ var statements = program.statements;
+
+ for(var i=0, l=statements.length; i<l; i++) {
+ this.accept(statements[i]);
+ }
+ this.isSimple = l === 1;
+
+ this.depths.list = this.depths.list.sort(function(a, b) {
+ return a - b;
+ });
+
+ return this;
+ },
+
+ compileProgram: function(program) {
+ var result = new this.compiler().compile(program, this.options);
+ var guid = this.guid++, depth;
+
+ this.usePartial = this.usePartial || result.usePartial;
+
+ this.children[guid] = result;
+
+ for(var i=0, l=result.depths.list.length; i<l; i++) {
+ depth = result.depths.list[i];
+
+ if(depth < 2) { continue; }
+ else { this.addDepth(depth - 1); }
+ }
+
+ return guid;
+ },
+
+ block: function(block) {
+ var mustache = block.mustache,
+ program = block.program,
+ inverse = block.inverse;
+
+ if (program) {
+ program = this.compileProgram(program);
+ }
+
+ if (inverse) {
+ inverse = this.compileProgram(inverse);
+ }
+
+ var type = this.classifyMustache(mustache);
+
+ if (type === "helper") {
+ this.helperMustache(mustache, program, inverse);
+ } else if (type === "simple") {
+ this.simpleMustache(mustache);
+
+ // now that the simple mustache is resolved, we need to
+ // evaluate it by executing `blockHelperMissing`
+ this.opcode('pushProgram', program);
+ this.opcode('pushProgram', inverse);
+ this.opcode('emptyHash');
+ this.opcode('blockValue');
+ } else {
+ this.ambiguousMustache(mustache, program, inverse);
+
+ // now that the simple mustache is resolved, we need to
+ // evaluate it by executing `blockHelperMissing`
+ this.opcode('pushProgram', program);
+ this.opcode('pushProgram', inverse);
+ this.opcode('emptyHash');
+ this.opcode('ambiguousBlockValue');
+ }
+
+ this.opcode('append');
+ },
+
+ hash: function(hash) {
+ var pairs = hash.pairs, pair, val;
+
+ this.opcode('pushHash');
+
+ for(var i=0, l=pairs.length; i<l; i++) {
+ pair = pairs[i];
+ val = pair[1];
+
+ if (this.options.stringParams) {
+ if(val.depth) {
+ this.addDepth(val.depth);
+ }
+ this.opcode('getContext', val.depth || 0);
+ this.opcode('pushStringParam', val.stringModeValue, val.type);
+ } else {
+ this.accept(val);
+ }
+
+ this.opcode('assignToHash', pair[0]);
+ }
+ this.opcode('popHash');
+ },
+
+ partial: function(partial) {
+ var partialName = partial.partialName;
+ this.usePartial = true;
+
+ if(partial.context) {
+ this.ID(partial.context);
+ } else {
+ this.opcode('push', 'depth0');
+ }
+
+ this.opcode('invokePartial', partialName.name);
+ this.opcode('append');
+ },
+
+ content: function(content) {
+ this.opcode('appendContent', content.string);
+ },
+
+ mustache: function(mustache) {
+ var options = this.options;
+ var type = this.classifyMustache(mustache);
+
+ if (type === "simple") {
+ this.simpleMustache(mustache);
+ } else if (type === "helper") {
+ this.helperMustache(mustache);
+ } else {
+ this.ambiguousMustache(mustache);
+ }
+
+ if(mustache.escaped && !options.noEscape) {
+ this.opcode('appendEscaped');
+ } else {
+ this.opcode('append');
+ }
+ },
+
+ ambiguousMustache: function(mustache, program, inverse) {
+ var id = mustache.id,
+ name = id.parts[0],
+ isBlock = program != null || inverse != null;
+
+ this.opcode('getContext', id.depth);
+
+ this.opcode('pushProgram', program);
+ this.opcode('pushProgram', inverse);
+
+ this.opcode('invokeAmbiguous', name, isBlock);
+ },
+
+ simpleMustache: function(mustache) {
+ var id = mustache.id;
+
+ if (id.type === 'DATA') {
+ this.DATA(id);
+ } else if (id.parts.length) {
+ this.ID(id);
+ } else {
+ // Simplified ID for `this`
+ this.addDepth(id.depth);
+ this.opcode('getContext', id.depth);
+ this.opcode('pushContext');
+ }
+
+ this.opcode('resolvePossibleLambda');
+ },
+
+ helperMustache: function(mustache, program, inverse) {
+ var params = this.setupFullMustacheParams(mustache, program, inverse),
+ name = mustache.id.parts[0];
+
+ if (this.options.knownHelpers[name]) {
+ this.opcode('invokeKnownHelper', params.length, name);
+ } else if (this.options.knownHelpersOnly) {
+ throw new Error("You specified knownHelpersOnly, but used the unknown helper " + name);
+ } else {
+ this.opcode('invokeHelper', params.length, name);
+ }
+ },
+
+ ID: function(id) {
+ this.addDepth(id.depth);
+ this.opcode('getContext', id.depth);
+
+ var name = id.parts[0];
+ if (!name) {
+ this.opcode('pushContext');
+ } else {
+ this.opcode('lookupOnContext', id.parts[0]);
+ }
+
+ for(var i=1, l=id.parts.length; i<l; i++) {
+ this.opcode('lookup', id.parts[i]);
+ }
+ },
+
+ DATA: function(data) {
+ this.options.data = true;
+ if (data.id.isScoped || data.id.depth) {
+ throw new Exception('Scoped data references are not supported: ' + data.original);
+ }
+
+ this.opcode('lookupData');
+ var parts = data.id.parts;
+ for(var i=0, l=parts.length; i<l; i++) {
+ this.opcode('lookup', parts[i]);
+ }
+ },
+
+ STRING: function(string) {
+ this.opcode('pushString', string.string);
+ },
+
+ INTEGER: function(integer) {
+ this.opcode('pushLiteral', integer.integer);
+ },
+
+ BOOLEAN: function(bool) {
+ this.opcode('pushLiteral', bool.bool);
+ },
+
+ comment: function() {},
+
+ // HELPERS
+ opcode: function(name) {
+ this.opcodes.push({ opcode: name, args: [].slice.call(arguments, 1) });
+ },
+
+ declare: function(name, value) {
+ this.opcodes.push({ opcode: 'DECLARE', name: name, value: value });
+ },
+
+ addDepth: function(depth) {
+ if(isNaN(depth)) { throw new Error("EWOT"); }
+ if(depth === 0) { return; }
+
+ if(!this.depths[depth]) {
+ this.depths[depth] = true;
+ this.depths.list.push(depth);
+ }
+ },
+
+ classifyMustache: function(mustache) {
+ var isHelper = mustache.isHelper;
+ var isEligible = mustache.eligibleHelper;
+ var options = this.options;
+
+ // if ambiguous, we can possibly resolve the ambiguity now
+ if (isEligible && !isHelper) {
+ var name = mustache.id.parts[0];
+
+ if (options.knownHelpers[name]) {
+ isHelper = true;
+ } else if (options.knownHelpersOnly) {
+ isEligible = false;
+ }
+ }
+
+ if (isHelper) { return "helper"; }
+ else if (isEligible) { return "ambiguous"; }
+ else { return "simple"; }
+ },
+
+ pushParams: function(params) {
+ var i = params.length, param;
+
+ while(i--) {
+ param = params[i];
+
+ if(this.options.stringParams) {
+ if(param.depth) {
+ this.addDepth(param.depth);
+ }
+
+ this.opcode('getContext', param.depth || 0);
+ this.opcode('pushStringParam', param.stringModeValue, param.type);
+ } else {
+ this[param.type](param);
+ }
+ }
+ },
+
+ setupMustacheParams: function(mustache) {
+ var params = mustache.params;
+ this.pushParams(params);
+
+ if(mustache.hash) {
+ this.hash(mustache.hash);
+ } else {
+ this.opcode('emptyHash');
+ }
+
+ return params;
+ },
+
+ // this will replace setupMustacheParams when we're done
+ setupFullMustacheParams: function(mustache, program, inverse) {
+ var params = mustache.params;
+ this.pushParams(params);
+
+ this.opcode('pushProgram', program);
+ this.opcode('pushProgram', inverse);
+
+ if(mustache.hash) {
+ this.hash(mustache.hash);
+ } else {
+ this.opcode('emptyHash');
+ }
+
+ return params;
+ }
+ };
+
+ function precompile(input, options) {
+ if (input == null || (typeof input !== 'string' && input.constructor !== AST.ProgramNode)) {
+ throw new Exception("You must pass a string or Handlebars AST to Handlebars.precompile. You passed " + input);
+ }
+
+ options = options || {};
+ if (!('data' in options)) {
+ options.data = true;
+ }
+
+ var ast = parse(input);
+ var environment = new Compiler().compile(ast, options);
+ return new JavaScriptCompiler().compile(environment, options);
+ }
+
+ __exports__.precompile = precompile;function compile(input, options, env) {
+ if (input == null || (typeof input !== 'string' && input.constructor !== AST.ProgramNode)) {
+ throw new Exception("You must pass a string or Handlebars AST to Handlebars.compile. You passed " + input);
+ }
+
+ options = options || {};
+
+ if (!('data' in options)) {
+ options.data = true;
+ }
+
+ var compiled;
+
+ function compileInput() {
+ var ast = parse(input);
+ var environment = new Compiler().compile(ast, options);
+ var templateSpec = new JavaScriptCompiler().compile(environment, options, undefined, true);
+ return env.template(templateSpec);
+ }
+
+ // Template is only compiled on first use and cached after that point.
+ return function(context, options) {
+ if (!compiled) {
+ compiled = compileInput();
+ }
+ return compiled.call(this, context, options);
+ };
+ }
+
+ __exports__.compile = compile;
+ return __exports__;
+})(__module5__, __module8__, __module11__, __module7__);
+
+// handlebars.js
+var __module0__ = (function(__dependency1__, __dependency2__, __dependency3__, __dependency4__, __dependency5__) {
+ "use strict";
+ var __exports__;
+ var Handlebars = __dependency1__;
+
+ // Compiler imports
+ var AST = __dependency2__;
+ var Parser = __dependency3__.parser;
+ var parse = __dependency3__.parse;
+ var Compiler = __dependency4__.Compiler;
+ var compile = __dependency4__.compile;
+ var precompile = __dependency4__.precompile;
+ var JavaScriptCompiler = __dependency5__;
+
+ var _create = Handlebars.create;
+ var create = function() {
+ var hb = _create();
+
+ hb.compile = function(input, options) {
+ return compile(input, options, hb);
+ };
+ hb.precompile = precompile;
+
+ hb.AST = AST;
+ hb.Compiler = Compiler;
+ hb.JavaScriptCompiler = JavaScriptCompiler;
+ hb.Parser = Parser;
+ hb.parse = parse;
+
+ return hb;
+ };
+
+ Handlebars = create();
+ Handlebars.create = create;
+
+ __exports__ = Handlebars;
+ return __exports__;
+})(__module1__, __module7__, __module8__, __module10__, __module11__);
+
+ return __module0__;
+})();
diff --git a/2.0/docson/lib/highlight.js b/2.0/docson/lib/highlight.js
new file mode 100644
index 0000000..6a266ad
--- /dev/null
+++ b/2.0/docson/lib/highlight.js
@@ -0,0 +1,302 @@
+
+/*
+ * Copyright 2013 Geraint Luff <http://geraintluff.github.io/tv4/>
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+define(function() {
+
+ var highlight = {};
+
+ var REGEX = {
+ whitespace: /^([ \r\n\t]| )*/,
+ number: /^-?[0-9]+(\.[0-9]+)?([eE][+\-]?[0-9]+)?/
+ };
+
+ function Highlighter(stringData) {
+ this.remaining = stringData;
+ this.html = "";
+ }
+ Highlighter.prototype = {
+ unshift: function (next) {
+ this.remaining = next + this.remaining;
+ },
+ next: function () {
+ this.whitespace();
+ return this.nextCharacter();
+ },
+ nextCharacter: function () {
+ if (this.remaining.length == 0) {
+ throw new Error("Unexpected end of input");
+ }
+ if (this.remaining[0] == "&") {
+ var endIndex = this.remaining.indexOf(";") + 1;
+ if (endIndex == -1) {
+ endIndex = 1;
+ }
+ var result = this.remaining.substring(0, endIndex);
+ this.remaining = this.remaining.substring(endIndex);
+ return result;
+ }
+ var result = this.remaining[0];
+ this.remaining = this.remaining.substring(1);
+ return result;
+ },
+ whitespace: function () {
+ var ws = this.remaining.match(REGEX.whitespace)[0];
+ this.html += ws;
+ this.remaining = this.remaining.substring(ws.length);
+ },
+ highlightJson: function (keywords) {
+ if (keywords != undefined) {
+ this.html += keywords.wrapper[0];
+ }
+ this.whitespace();
+ var next = this.next();
+ if (next == "{") {
+ this.highlightObject(keywords);
+ } else if (next == '[') {
+ this.highlightArray(keywords);
+ } else if (next == '"' || next == """) {
+ this.highlightString();
+ } else if ((next + this.remaining).match(REGEX.number)) {
+ var numberString = (next + this.remaining).match(REGEX.number)[0];
+ this.html += '<span class="json-number">' + numberString + '</span>';
+ this.remaining = this.remaining.substring(numberString.length - 1);
+ } else if (next == "n" && this.remaining.substring(0, 3) == "ull") {
+ this.remaining = this.remaining.substring(3);
+ this.html += '<span class="json-null">null</span>';
+ } else if (next == "t" && this.remaining.substring(0, 3) == "rue") {
+ this.remaining = this.remaining.substring(3);
+ this.html += '<span class="json-true">true</span>';
+ } else if (next == "f" && this.remaining.substring(0, 4) == "alse") {
+ this.remaining = this.remaining.substring(4);
+ this.html += '<span class="json-false">false</span>';
+ } else {
+ this.html += next;
+ this.highlightJson(keywords);
+ }
+ if (keywords != undefined) {
+ this.html += keywords.wrapper[1];
+ }
+ },
+ highlightObject: function (keywords) {
+ this.html += '<span class="json-punctuation">{</span>';
+ var next = this.next();
+ while (next != "}") {
+ if (next == '"' || next == """) {
+ var keyHtml = "";
+ next = this.next();
+ while (next != '"' && next != '"') {
+ if (next == "\\") {
+ keyHtml += next;
+ next = this.nextCharacter();
+ }
+ keyHtml += next;
+ next = this.next();
+ }
+ if (keywords != undefined && keywords.isKeyword(keyHtml)) {
+ this.html += '<span class="json-keyword">"'
+ + keyHtml
+ + '"</span>';
+ } else {
+ this.html += '<span class="json-object-key">"'
+ + keyHtml
+ + '"</span>';
+ }
+ next = this.next();
+ while (next != ":") {
+ this.html += next;
+ next = this.next();
+ }
+ this.html += '<span class="json-punctuation">:</span>';
+ var nextKeywords = null;
+ if (keywords != undefined) {
+ nextKeywords = keywords.forKey(keyHtml);
+ }
+ this.highlightJson(nextKeywords);
+ next = this.next();
+ if (next == ",") {
+ this.html += '<span class="json-punctuation">,</span>';
+ next = this.next();
+ continue;
+ } else while (next != "}") {
+ this.html += next;
+ next = this.next();
+ }
+ } else {
+ this.html += next;
+ next = this.next();
+ }
+ }
+ this.html += '<span class="json-punctuation">}</span>';
+ },
+ highlightArray: function (keywords) {
+ this.html += '<span class="json-punctuation">[</span>';
+ var next = this.next();
+ var i = 0;
+ while (next != "]") {
+ this.unshift(next);
+ this.highlightJson(keywords != undefined ? keywords.forItem(i) : null);
+ next = this.next();
+ if (next == ",") {
+ this.html += '<span class="json-punctuation">,</span>';
+ next = this.next();
+ i++;
+ continue;
+ } else while (next != "]") {
+ this.html += next;
+ next = this.next();
+ }
+ }
+ this.html += '<span class="json-punctuation">]</span>';
+ },
+ highlightString: function () {
+ this.html += '<span class="json-punctuation">"</span><span class="json-string">';
+ next = this.next();
+ while (next != '"' && next != '"') {
+ if (next == "\\") {
+ this.html += next;
+ next = this.nextCharacter();
+ }
+ this.html += next;
+ next = this.next();
+ }
+ this.html += '</span><span class="json-punctuation">"</span>';
+ }
+ };
+
+ function KeywordMap() {
+ }
+ KeywordMap.prototype = {
+ wrapper: ["<span>", "</span>"],
+ keywords: {},
+ isKeyword: function (keyHtml) {
+ return this.keywords[keyHtml] !== undefined;
+ },
+ forKey: function (keyHtml) {
+ return this.keywords[keyHtml];
+ },
+ forItem: function (keyHtml) {
+ return null;
+ }
+ };
+ var schema = new KeywordMap();
+ var schemaMedia = new KeywordMap();
+ var mapToSchemas = new KeywordMap();
+ var links = new KeywordMap();
+ schema.keywords = {
+ // from v3
+ type: null,
+ properties: mapToSchemas,
+ patternProperties: mapToSchemas,
+ additionalProperties: schema,
+ items: schema,
+ additionalItems: schema,
+ required: null,
+ dependencies: mapToSchemas,
+ minimum: null,
+ maximum: null,
+ exclusiveMinimum: null,
+ exclusiveMaximum: null,
+ minItems: null,
+ maxItems: null,
+ uniqueItems: null,
+ pattern: null,
+ minLength: null,
+ maxLength: null,
+ "enum": null,
+ "default": null,
+ title: null,
+ description: null,
+ format: null,
+ divisibleBy: null,
+ disallow: schema,
+ "extends": schema,
+ "id": null,
+ "$ref": null,
+ "$schema": null,
+ // from v4 core
+ multipleOf: null,
+ maxProperties: null,
+ minProperties: null,
+ allOf: schema,
+ anyOf: schema,
+ oneOf: schema,
+ not: schema,
+ definitions: mapToSchemas,
+ // from v4 hyper-schema
+ media: schemaMedia,
+ links: links,
+ pathStart: null,
+ fragmentResolution: null
+ };
+ schema.forItem = function () {
+ return schema;
+ };
+ schemaMedia.keywords = {
+ binaryEncoding: null,
+ type: null
+ };
+ mapToSchemas.wrapper = ['<span class="json-schema-map">', '</span>'];
+ mapToSchemas.forKey = function () {
+ return schema;
+ };
+ links.keywords = {
+ rel: null,
+ href:null,
+ method: null,
+ encType: null,
+ pathStart: null,
+ schema: schema,
+ targetSchema: schema
+ };
+ links.forItem = function () {
+ return links;
+ };
+
+ function highlightElement(element, keywords) {
+ var highlighter = new Highlighter(element.innerHTML);
+ try {
+ highlighter.highlightJson(keywords);
+ } catch (e) {
+ throw e;
+ }
+ element.innerHTML = highlighter.html + highlighter.remaining;
+ }
+
+ if (document.getElementsByClassName == undefined) {
+ document.getElementsByClassName = function(className)
+ {
+ var hasClassName = new RegExp("(?:^|\\s)" + className + "(?:$|\\s)");
+ var allElements = document.getElementsByTagName("*");
+ var results = [];
+
+ var element;
+ for (var i = 0; (element = allElements[i]) != null; i++) {
+ var elementClass = element.className;
+ if (elementClass && elementClass.indexOf(className) != -1 && hasClassName.test(elementClass))
+ results.push(element);
+ }
+
+ return results;
+ }
+ }
+
+ highlight.highlightSchema = function(element) {
+ highlightElement(element, schema);
+ }
+
+ return highlight;
+});
diff --git a/2.0/docson/lib/jquery.js b/2.0/docson/lib/jquery.js
new file mode 100644
index 0000000..da41706
--- /dev/null
+++ b/2.0/docson/lib/jquery.js
@@ -0,0 +1,6 @@
+/*! jQuery v1.10.2 | (c) 2005, 2013 jQuery Foundation, Inc. | jquery.org/license
+//@ sourceMappingURL=jquery-1.10.2.min.map
+*/
+(function(e,t){var n,r,i=typeof t,o=e.location,a=e.document,s=a.documentElement,l=e.jQuery,u=e.$,c={},p=[],f="1.10.2",d=p.concat,h=p.push,g=p.slice,m=p.indexOf,y=c.toString,v=c.hasOwnProperty,b=f.trim,x=function(e,t){return new x.fn.init(e,t,r)},w=/[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/.source,T=/\S+/g,C=/^[\s\uFEFF\xA0]+|[\s\uFEFF\xA0]+$/g,N=/^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]*))$/,k=/^<(\w+)\s*\/?>(?:<\/\1>|)$/,E=/^[\],:{}\s]*$/,S=/(?:^|:|,)(?:\s*\[)+/g,A=/\\(?:["\\\/bfnrt]|u[\da-fA-F]{4})/g,j=/"[^"\\\r\n]*"|true|false|null|-?(?:\d+\.|)\d+(?:[eE][+-]?\d+|)/g,D=/^-ms-/,L=/-([\da-z])/gi,H=function(e,t){return t.toUpperCase()},q=function(e){(a.addEventListener||"load"===e.type||"complete"===a.readyState)&&(_(),x.ready())},_=function(){a.addEventListener?(a.removeEventListener("DOMContentLoaded",q,!1),e.removeEventListener("load",q,!1)):(a.detachEvent("onreadystatechange",q),e.detachEvent("onload",q))};x.fn=x.prototype={jquery:f,constructor:x,init:function(e,n,r){var i,o;if(!e)return this;if("string"==typeof e){if(i="<"===e.charAt(0)&&">"===e.charAt(e.length-1)&&e.length>=3?[null,e,null]:N.exec(e),!i||!i[1]&&n)return!n||n.jquery?(n||r).find(e):this.constructor(n).find(e);if(i[1]){if(n=n instanceof x?n[0]:n,x.merge(this,x.parseHTML(i[1],n&&n.nodeType?n.ownerDocument||n:a,!0)),k.test(i[1])&&x.isPlainObject(n))for(i in n)x.isFunction(this[i])?this[i](n[i]):this.attr(i,n[i]);return this}if(o=a.getElementById(i[2]),o&&o.parentNode){if(o.id!==i[2])return r.find(e);this.length=1,this[0]=o}return this.context=a,this.selector=e,this}return e.nodeType?(this.context=this[0]=e,this.length=1,this):x.isFunction(e)?r.ready(e):(e.selector!==t&&(this.selector=e.selector,this.context=e.context),x.makeArray(e,this))},selector:"",length:0,toArray:function(){return g.call(this)},get:function(e){return null==e?this.toArray():0>e?this[this.length+e]:this[e]},pushStack:function(e){var t=x.merge(this.constructor(),e);return t.prevObject=this,t.context=this.context,t},each:function(e,t){return x.each(this,e,t)},ready:function(e){return x.ready.promise().done(e),this},slice:function(){return this.pushStack(g.apply(this,arguments))},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},eq:function(e){var t=this.length,n=+e+(0>e?t:0);return this.pushStack(n>=0&&t>n?[this[n]]:[])},map:function(e){return this.pushStack(x.map(this,function(t,n){return e.call(t,n,t)}))},end:function(){return this.prevObject||this.constructor(null)},push:h,sort:[].sort,splice:[].splice},x.fn.init.prototype=x.fn,x.extend=x.fn.extend=function(){var e,n,r,i,o,a,s=arguments[0]||{},l=1,u=arguments.length,c=!1;for("boolean"==typeof s&&(c=s,s=arguments[1]||{},l=2),"object"==typeof s||x.isFunction(s)||(s={}),u===l&&(s=this,--l);u>l;l++)if(null!=(o=arguments[l]))for(i in o)e=s[i],r=o[i],s!==r&&(c&&r&&(x.isPlainObject(r)||(n=x.isArray(r)))?(n?(n=!1,a=e&&x.isArray(e)?e:[]):a=e&&x.isPlainObject(e)?e:{},s[i]=x.extend(c,a,r)):r!==t&&(s[i]=r));return s},x.extend({expando:"jQuery"+(f+Math.random()).replace(/\D/g,""),noConflict:function(t){return e.$===x&&(e.$=u),t&&e.jQuery===x&&(e.jQuery=l),x},isReady:!1,readyWait:1,holdReady:function(e){e?x.readyWait++:x.ready(!0)},ready:function(e){if(e===!0?!--x.readyWait:!x.isReady){if(!a.body)return setTimeout(x.ready);x.isReady=!0,e!==!0&&--x.readyWait>0||(n.resolveWith(a,[x]),x.fn.trigger&&x(a).trigger("ready").off("ready"))}},isFunction:function(e){return"function"===x.type(e)},isArray:Array.isArray||function(e){return"array"===x.type(e)},isWindow:function(e){return null!=e&&e==e.window},isNumeric:function(e){return!isNaN(parseFloat(e))&&isFinite(e)},type:function(e){return null==e?e+"":"object"==typeof e||"function"==typeof e?c[y.call(e)]||"object":typeof e},isPlainObject:function(e){var n;if(!e||"object"!==x.type(e)||e.nodeType||x.isWindow(e))return!1;try{if(e.constructor&&!v.call(e,"constructor")&&!v.call(e.constructor.prototype,"isPrototypeOf"))return!1}catch(r){return!1}if(x.support.ownLast)for(n in e)return v.call(e,n);for(n in e);return n===t||v.call(e,n)},isEmptyObject:function(e){var t;for(t in e)return!1;return!0},error:function(e){throw Error(e)},parseHTML:function(e,t,n){if(!e||"string"!=typeof e)return null;"boolean"==typeof t&&(n=t,t=!1),t=t||a;var r=k.exec(e),i=!n&&[];return r?[t.createElement(r[1])]:(r=x.buildFragment([e],t,i),i&&x(i).remove(),x.merge([],r.childNodes))},parseJSON:function(n){return e.JSON&&e.JSON.parse?e.JSON.parse(n):null===n?n:"string"==typeof n&&(n=x.trim(n),n&&E.test(n.replace(A,"@").replace(j,"]").replace(S,"")))?Function("return "+n)():(x.error("Invalid JSON: "+n),t)},parseXML:function(n){var r,i;if(!n||"string"!=typeof n)return null;try{e.DOMParser?(i=new DOMParser,r=i.parseFromString(n,"text/xml")):(r=new ActiveXObject("Microsoft.XMLDOM"),r.async="false",r.loadXML(n))}catch(o){r=t}return r&&r.documentElement&&!r.getElementsByTagName("parsererror").length||x.error("Invalid XML: "+n),r},noop:function(){},globalEval:function(t){t&&x.trim(t)&&(e.execScript||function(t){e.eval.call(e,t)})(t)},camelCase:function(e){return e.replace(D,"ms-").replace(L,H)},nodeName:function(e,t){return e.nodeName&&e.nodeName.toLowerCase()===t.toLowerCase()},each:function(e,t,n){var r,i=0,o=e.length,a=M(e);if(n){if(a){for(;o>i;i++)if(r=t.apply(e[i],n),r===!1)break}else for(i in e)if(r=t.apply(e[i],n),r===!1)break}else if(a){for(;o>i;i++)if(r=t.call(e[i],i,e[i]),r===!1)break}else for(i in e)if(r=t.call(e[i],i,e[i]),r===!1)break;return e},trim:b&&!b.call("\ufeff\u00a0")?function(e){return null==e?"":b.call(e)}:function(e){return null==e?"":(e+"").replace(C,"")},makeArray:function(e,t){var n=t||[];return null!=e&&(M(Object(e))?x.merge(n,"string"==typeof e?[e]:e):h.call(n,e)),n},inArray:function(e,t,n){var r;if(t){if(m)return m.call(t,e,n);for(r=t.length,n=n?0>n?Math.max(0,r+n):n:0;r>n;n++)if(n in t&&t[n]===e)return n}return-1},merge:function(e,n){var r=n.length,i=e.length,o=0;if("number"==typeof r)for(;r>o;o++)e[i++]=n[o];else while(n[o]!==t)e[i++]=n[o++];return e.length=i,e},grep:function(e,t,n){var r,i=[],o=0,a=e.length;for(n=!!n;a>o;o++)r=!!t(e[o],o),n!==r&&i.push(e[o]);return i},map:function(e,t,n){var r,i=0,o=e.length,a=M(e),s=[];if(a)for(;o>i;i++)r=t(e[i],i,n),null!=r&&(s[s.length]=r);else for(i in e)r=t(e[i],i,n),null!=r&&(s[s.length]=r);return d.apply([],s)},guid:1,proxy:function(e,n){var r,i,o;return"string"==typeof n&&(o=e[n],n=e,e=o),x.isFunction(e)?(r=g.call(arguments,2),i=function(){return e.apply(n||this,r.concat(g.call(arguments)))},i.guid=e.guid=e.guid||x.guid++,i):t},access:function(e,n,r,i,o,a,s){var l=0,u=e.length,c=null==r;if("object"===x.type(r)){o=!0;for(l in r)x.access(e,n,l,r[l],!0,a,s)}else if(i!==t&&(o=!0,x.isFunction(i)||(s=!0),c&&(s?(n.call(e,i),n=null):(c=n,n=function(e,t,n){return c.call(x(e),n)})),n))for(;u>l;l++)n(e[l],r,s?i:i.call(e[l],l,n(e[l],r)));return o?e:c?n.call(e):u?n(e[0],r):a},now:function(){return(new Date).getTime()},swap:function(e,t,n,r){var i,o,a={};for(o in t)a[o]=e.style[o],e.style[o]=t[o];i=n.apply(e,r||[]);for(o in t)e.style[o]=a[o];return i}}),x.ready.promise=function(t){if(!n)if(n=x.Deferred(),"complete"===a.readyState)setTimeout(x.ready);else if(a.addEventListener)a.addEventListener("DOMContentLoaded",q,!1),e.addEventListener("load",q,!1);else{a.attachEvent("onreadystatechange",q),e.attachEvent("onload",q);var r=!1;try{r=null==e.frameElement&&a.documentElement}catch(i){}r&&r.doScroll&&function o(){if(!x.isReady){try{r.doScroll("left")}catch(e){return setTimeout(o,50)}_(),x.ready()}}()}return n.promise(t)},x.each("Boolean Number String Function Array Date RegExp Object Error".split(" "),function(e,t){c["[object "+t+"]"]=t.toLowerCase()});function M(e){var t=e.length,n=x.type(e);return x.isWindow(e)?!1:1===e.nodeType&&t?!0:"array"===n||"function"!==n&&(0===t||"number"==typeof t&&t>0&&t-1 in e)}r=x(a),function(e,t){var n,r,i,o,a,s,l,u,c,p,f,d,h,g,m,y,v,b="sizzle"+-new Date,w=e.document,T=0,C=0,N=st(),k=st(),E=st(),S=!1,A=function(e,t){return e===t?(S=!0,0):0},j=typeof t,D=1<<31,L={}.hasOwnProperty,H=[],q=H.pop,_=H.push,M=H.push,O=H.slice,F=H.indexOf||function(e){var t=0,n=this.length;for(;n>t;t++)if(this[t]===e)return t;return-1},B="checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|ismap|loop|multiple|open|readonly|required|scoped",P="[\\x20\\t\\r\\n\\f]",R="(?:\\\\.|[\\w-]|[^\\x00-\\xa0])+",W=R.replace("w","w#"),$="\\["+P+"*("+R+")"+P+"*(?:([*^$|!~]?=)"+P+"*(?:(['\"])((?:\\\\.|[^\\\\])*?)\\3|("+W+")|)|)"+P+"*\\]",I=":("+R+")(?:\\(((['\"])((?:\\\\.|[^\\\\])*?)\\3|((?:\\\\.|[^\\\\()[\\]]|"+$.replace(3,8)+")*)|.*)\\)|)",z=RegExp("^"+P+"+|((?:^|[^\\\\])(?:\\\\.)*)"+P+"+$","g"),X=RegExp("^"+P+"*,"+P+"*"),U=RegExp("^"+P+"*([>+~]|"+P+")"+P+"*"),V=RegExp(P+"*[+~]"),Y=RegExp("="+P+"*([^\\]'\"]*)"+P+"*\\]","g"),J=RegExp(I),G=RegExp("^"+W+"$"),Q={ID:RegExp("^#("+R+")"),CLASS:RegExp("^\\.("+R+")"),TAG:RegExp("^("+R.replace("w","w*")+")"),ATTR:RegExp("^"+$),PSEUDO:RegExp("^"+I),CHILD:RegExp("^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\("+P+"*(even|odd|(([+-]|)(\\d*)n|)"+P+"*(?:([+-]|)"+P+"*(\\d+)|))"+P+"*\\)|)","i"),bool:RegExp("^(?:"+B+")$","i"),needsContext:RegExp("^"+P+"*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\("+P+"*((?:-\\d)?\\d*)"+P+"*\\)|)(?=[^-]|$)","i")},K=/^[^{]+\{\s*\[native \w/,Z=/^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/,et=/^(?:input|select|textarea|button)$/i,tt=/^h\d$/i,nt=/'|\\/g,rt=RegExp("\\\\([\\da-f]{1,6}"+P+"?|("+P+")|.)","ig"),it=function(e,t,n){var r="0x"+t-65536;return r!==r||n?t:0>r?String.fromCharCode(r+65536):String.fromCharCode(55296|r>>10,56320|1023&r)};try{M.apply(H=O.call(w.childNodes),w.childNodes),H[w.childNodes.length].nodeType}catch(ot){M={apply:H.length?function(e,t){_.apply(e,O.call(t))}:function(e,t){var n=e.length,r=0;while(e[n++]=t[r++]);e.length=n-1}}}function at(e,t,n,i){var o,a,s,l,u,c,d,m,y,x;if((t?t.ownerDocument||t:w)!==f&&p(t),t=t||f,n=n||[],!e||"string"!=typeof e)return n;if(1!==(l=t.nodeType)&&9!==l)return[];if(h&&!i){if(o=Z.exec(e))if(s=o[1]){if(9===l){if(a=t.getElementById(s),!a||!a.parentNode)return n;if(a.id===s)return n.push(a),n}else if(t.ownerDocument&&(a=t.ownerDocument.getElementById(s))&&v(t,a)&&a.id===s)return n.push(a),n}else{if(o[2])return M.apply(n,t.getElementsByTagName(e)),n;if((s=o[3])&&r.getElementsByClassName&&t.getElementsByClassName)return M.apply(n,t.getElementsByClassName(s)),n}if(r.qsa&&(!g||!g.test(e))){if(m=d=b,y=t,x=9===l&&e,1===l&&"object"!==t.nodeName.toLowerCase()){c=mt(e),(d=t.getAttribute("id"))?m=d.replace(nt,"\\$&"):t.setAttribute("id",m),m="[id='"+m+"'] ",u=c.length;while(u--)c[u]=m+yt(c[u]);y=V.test(e)&&t.parentNode||t,x=c.join(",")}if(x)try{return M.apply(n,y.querySelectorAll(x)),n}catch(T){}finally{d||t.removeAttribute("id")}}}return kt(e.replace(z,"$1"),t,n,i)}function st(){var e=[];function t(n,r){return e.push(n+=" ")>o.cacheLength&&delete t[e.shift()],t[n]=r}return t}function lt(e){return e[b]=!0,e}function ut(e){var t=f.createElement("div");try{return!!e(t)}catch(n){return!1}finally{t.parentNode&&t.parentNode.removeChild(t),t=null}}function ct(e,t){var n=e.split("|"),r=e.length;while(r--)o.attrHandle[n[r]]=t}function pt(e,t){var n=t&&e,r=n&&1===e.nodeType&&1===t.nodeType&&(~t.sourceIndex||D)-(~e.sourceIndex||D);if(r)return r;if(n)while(n=n.nextSibling)if(n===t)return-1;return e?1:-1}function ft(e){return function(t){var n=t.nodeName.toLowerCase();return"input"===n&&t.type===e}}function dt(e){return function(t){var n=t.nodeName.toLowerCase();return("input"===n||"button"===n)&&t.type===e}}function ht(e){return lt(function(t){return t=+t,lt(function(n,r){var i,o=e([],n.length,t),a=o.length;while(a--)n[i=o[a]]&&(n[i]=!(r[i]=n[i]))})})}s=at.isXML=function(e){var t=e&&(e.ownerDocument||e).documentElement;return t?"HTML"!==t.nodeName:!1},r=at.support={},p=at.setDocument=function(e){var n=e?e.ownerDocument||e:w,i=n.defaultView;return n!==f&&9===n.nodeType&&n.documentElement?(f=n,d=n.documentElement,h=!s(n),i&&i.attachEvent&&i!==i.top&&i.attachEvent("onbeforeunload",function(){p()}),r.attributes=ut(function(e){return e.className="i",!e.getAttribute("className")}),r.getElementsByTagName=ut(function(e){return e.appendChild(n.createComment("")),!e.getElementsByTagName("*").length}),r.getElementsByClassName=ut(function(e){return e.innerHTML="<div class='a'></div><div class='a i'></div>",e.firstChild.className="i",2===e.getElementsByClassName("i").length}),r.getById=ut(function(e){return d.appendChild(e).id=b,!n.getElementsByName||!n.getElementsByName(b).length}),r.getById?(o.find.ID=function(e,t){if(typeof t.getElementById!==j&&h){var n=t.getElementById(e);return n&&n.parentNode?[n]:[]}},o.filter.ID=function(e){var t=e.replace(rt,it);return function(e){return e.getAttribute("id")===t}}):(delete o.find.ID,o.filter.ID=function(e){var t=e.replace(rt,it);return function(e){var n=typeof e.getAttributeNode!==j&&e.getAttributeNode("id");return n&&n.value===t}}),o.find.TAG=r.getElementsByTagName?function(e,n){return typeof n.getElementsByTagName!==j?n.getElementsByTagName(e):t}:function(e,t){var n,r=[],i=0,o=t.getElementsByTagName(e);if("*"===e){while(n=o[i++])1===n.nodeType&&r.push(n);return r}return o},o.find.CLASS=r.getElementsByClassName&&function(e,n){return typeof n.getElementsByClassName!==j&&h?n.getElementsByClassName(e):t},m=[],g=[],(r.qsa=K.test(n.querySelectorAll))&&(ut(function(e){e.innerHTML="<select><option selected=''></option></select>",e.querySelectorAll("[selected]").length||g.push("\\["+P+"*(?:value|"+B+")"),e.querySelectorAll(":checked").length||g.push(":checked")}),ut(function(e){var t=n.createElement("input");t.setAttribute("type","hidden"),e.appendChild(t).setAttribute("t",""),e.querySelectorAll("[t^='']").length&&g.push("[*^$]="+P+"*(?:''|\"\")"),e.querySelectorAll(":enabled").length||g.push(":enabled",":disabled"),e.querySelectorAll("*,:x"),g.push(",.*:")})),(r.matchesSelector=K.test(y=d.webkitMatchesSelector||d.mozMatchesSelector||d.oMatchesSelector||d.msMatchesSelector))&&ut(function(e){r.disconnectedMatch=y.call(e,"div"),y.call(e,"[s!='']:x"),m.push("!=",I)}),g=g.length&&RegExp(g.join("|")),m=m.length&&RegExp(m.join("|")),v=K.test(d.contains)||d.compareDocumentPosition?function(e,t){var n=9===e.nodeType?e.documentElement:e,r=t&&t.parentNode;return e===r||!(!r||1!==r.nodeType||!(n.contains?n.contains(r):e.compareDocumentPosition&&16&e.compareDocumentPosition(r)))}:function(e,t){if(t)while(t=t.parentNode)if(t===e)return!0;return!1},A=d.compareDocumentPosition?function(e,t){if(e===t)return S=!0,0;var i=t.compareDocumentPosition&&e.compareDocumentPosition&&e.compareDocumentPosition(t);return i?1&i||!r.sortDetached&&t.compareDocumentPosition(e)===i?e===n||v(w,e)?-1:t===n||v(w,t)?1:c?F.call(c,e)-F.call(c,t):0:4&i?-1:1:e.compareDocumentPosition?-1:1}:function(e,t){var r,i=0,o=e.parentNode,a=t.parentNode,s=[e],l=[t];if(e===t)return S=!0,0;if(!o||!a)return e===n?-1:t===n?1:o?-1:a?1:c?F.call(c,e)-F.call(c,t):0;if(o===a)return pt(e,t);r=e;while(r=r.parentNode)s.unshift(r);r=t;while(r=r.parentNode)l.unshift(r);while(s[i]===l[i])i++;return i?pt(s[i],l[i]):s[i]===w?-1:l[i]===w?1:0},n):f},at.matches=function(e,t){return at(e,null,null,t)},at.matchesSelector=function(e,t){if((e.ownerDocument||e)!==f&&p(e),t=t.replace(Y,"='$1']"),!(!r.matchesSelector||!h||m&&m.test(t)||g&&g.test(t)))try{var n=y.call(e,t);if(n||r.disconnectedMatch||e.document&&11!==e.document.nodeType)return n}catch(i){}return at(t,f,null,[e]).length>0},at.contains=function(e,t){return(e.ownerDocument||e)!==f&&p(e),v(e,t)},at.attr=function(e,n){(e.ownerDocument||e)!==f&&p(e);var i=o.attrHandle[n.toLowerCase()],a=i&&L.call(o.attrHandle,n.toLowerCase())?i(e,n,!h):t;return a===t?r.attributes||!h?e.getAttribute(n):(a=e.getAttributeNode(n))&&a.specified?a.value:null:a},at.error=function(e){throw Error("Syntax error, unrecognized expression: "+e)},at.uniqueSort=function(e){var t,n=[],i=0,o=0;if(S=!r.detectDuplicates,c=!r.sortStable&&e.slice(0),e.sort(A),S){while(t=e[o++])t===e[o]&&(i=n.push(o));while(i--)e.splice(n[i],1)}return e},a=at.getText=function(e){var t,n="",r=0,i=e.nodeType;if(i){if(1===i||9===i||11===i){if("string"==typeof e.textContent)return e.textContent;for(e=e.firstChild;e;e=e.nextSibling)n+=a(e)}else if(3===i||4===i)return e.nodeValue}else for(;t=e[r];r++)n+=a(t);return n},o=at.selectors={cacheLength:50,createPseudo:lt,match:Q,attrHandle:{},find:{},relative:{">":{dir:"parentNode",first:!0}," ":{dir:"parentNode"},"+":{dir:"previousSibling",first:!0},"~":{dir:"previousSibling"}},preFilter:{ATTR:function(e){return e[1]=e[1].replace(rt,it),e[3]=(e[4]||e[5]||"").replace(rt,it),"~="===e[2]&&(e[3]=" "+e[3]+" "),e.slice(0,4)},CHILD:function(e){return e[1]=e[1].toLowerCase(),"nth"===e[1].slice(0,3)?(e[3]||at.error(e[0]),e[4]=+(e[4]?e[5]+(e[6]||1):2*("even"===e[3]||"odd"===e[3])),e[5]=+(e[7]+e[8]||"odd"===e[3])):e[3]&&at.error(e[0]),e},PSEUDO:function(e){var n,r=!e[5]&&e[2];return Q.CHILD.test(e[0])?null:(e[3]&&e[4]!==t?e[2]=e[4]:r&&J.test(r)&&(n=mt(r,!0))&&(n=r.indexOf(")",r.length-n)-r.length)&&(e[0]=e[0].slice(0,n),e[2]=r.slice(0,n)),e.slice(0,3))}},filter:{TAG:function(e){var t=e.replace(rt,it).toLowerCase();return"*"===e?function(){return!0}:function(e){return e.nodeName&&e.nodeName.toLowerCase()===t}},CLASS:function(e){var t=N[e+" "];return t||(t=RegExp("(^|"+P+")"+e+"("+P+"|$)"))&&N(e,function(e){return t.test("string"==typeof e.className&&e.className||typeof e.getAttribute!==j&&e.getAttribute("class")||"")})},ATTR:function(e,t,n){return function(r){var i=at.attr(r,e);return null==i?"!="===t:t?(i+="","="===t?i===n:"!="===t?i!==n:"^="===t?n&&0===i.indexOf(n):"*="===t?n&&i.indexOf(n)>-1:"$="===t?n&&i.slice(-n.length)===n:"~="===t?(" "+i+" ").indexOf(n)>-1:"|="===t?i===n||i.slice(0,n.length+1)===n+"-":!1):!0}},CHILD:function(e,t,n,r,i){var o="nth"!==e.slice(0,3),a="last"!==e.slice(-4),s="of-type"===t;return 1===r&&0===i?function(e){return!!e.parentNode}:function(t,n,l){var u,c,p,f,d,h,g=o!==a?"nextSibling":"previousSibling",m=t.parentNode,y=s&&t.nodeName.toLowerCase(),v=!l&&!s;if(m){if(o){while(g){p=t;while(p=p[g])if(s?p.nodeName.toLowerCase()===y:1===p.nodeType)return!1;h=g="only"===e&&!h&&"nextSibling"}return!0}if(h=[a?m.firstChild:m.lastChild],a&&v){c=m[b]||(m[b]={}),u=c[e]||[],d=u[0]===T&&u[1],f=u[0]===T&&u[2],p=d&&m.childNodes[d];while(p=++d&&p&&p[g]||(f=d=0)||h.pop())if(1===p.nodeType&&++f&&p===t){c[e]=[T,d,f];break}}else if(v&&(u=(t[b]||(t[b]={}))[e])&&u[0]===T)f=u[1];else while(p=++d&&p&&p[g]||(f=d=0)||h.pop())if((s?p.nodeName.toLowerCase()===y:1===p.nodeType)&&++f&&(v&&((p[b]||(p[b]={}))[e]=[T,f]),p===t))break;return f-=i,f===r||0===f%r&&f/r>=0}}},PSEUDO:function(e,t){var n,r=o.pseudos[e]||o.setFilters[e.toLowerCase()]||at.error("unsupported pseudo: "+e);return r[b]?r(t):r.length>1?(n=[e,e,"",t],o.setFilters.hasOwnProperty(e.toLowerCase())?lt(function(e,n){var i,o=r(e,t),a=o.length;while(a--)i=F.call(e,o[a]),e[i]=!(n[i]=o[a])}):function(e){return r(e,0,n)}):r}},pseudos:{not:lt(function(e){var t=[],n=[],r=l(e.replace(z,"$1"));return r[b]?lt(function(e,t,n,i){var o,a=r(e,null,i,[]),s=e.length;while(s--)(o=a[s])&&(e[s]=!(t[s]=o))}):function(e,i,o){return t[0]=e,r(t,null,o,n),!n.pop()}}),has:lt(function(e){return function(t){return at(e,t).length>0}}),contains:lt(function(e){return function(t){return(t.textContent||t.innerText||a(t)).indexOf(e)>-1}}),lang:lt(function(e){return G.test(e||"")||at.error("unsupported lang: "+e),e=e.replace(rt,it).toLowerCase(),function(t){var n;do if(n=h?t.lang:t.getAttribute("xml:lang")||t.getAttribute("lang"))return n=n.toLowerCase(),n===e||0===n.indexOf(e+"-");while((t=t.parentNode)&&1===t.nodeType);return!1}}),target:function(t){var n=e.location&&e.location.hash;return n&&n.slice(1)===t.id},root:function(e){return e===d},focus:function(e){return e===f.activeElement&&(!f.hasFocus||f.hasFocus())&&!!(e.type||e.href||~e.tabIndex)},enabled:function(e){return e.disabled===!1},disabled:function(e){return e.disabled===!0},checked:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&!!e.checked||"option"===t&&!!e.selected},selected:function(e){return e.parentNode&&e.parentNode.selectedIndex,e.selected===!0},empty:function(e){for(e=e.firstChild;e;e=e.nextSibling)if(e.nodeName>"@"||3===e.nodeType||4===e.nodeType)return!1;return!0},parent:function(e){return!o.pseudos.empty(e)},header:function(e){return tt.test(e.nodeName)},input:function(e){return et.test(e.nodeName)},button:function(e){var t=e.nodeName.toLowerCase();return"input"===t&&"button"===e.type||"button"===t},text:function(e){var t;return"input"===e.nodeName.toLowerCase()&&"text"===e.type&&(null==(t=e.getAttribute("type"))||t.toLowerCase()===e.type)},first:ht(function(){return[0]}),last:ht(function(e,t){return[t-1]}),eq:ht(function(e,t,n){return[0>n?n+t:n]}),even:ht(function(e,t){var n=0;for(;t>n;n+=2)e.push(n);return e}),odd:ht(function(e,t){var n=1;for(;t>n;n+=2)e.push(n);return e}),lt:ht(function(e,t,n){var r=0>n?n+t:n;for(;--r>=0;)e.push(r);return e}),gt:ht(function(e,t,n){var r=0>n?n+t:n;for(;t>++r;)e.push(r);return e})}},o.pseudos.nth=o.pseudos.eq;for(n in{radio:!0,checkbox:!0,file:!0,password:!0,image:!0})o.pseudos[n]=ft(n);for(n in{submit:!0,reset:!0})o.pseudos[n]=dt(n);function gt(){}gt.prototype=o.filters=o.pseudos,o.setFilters=new gt;function mt(e,t){var n,r,i,a,s,l,u,c=k[e+" "];if(c)return t?0:c.slice(0);s=e,l=[],u=o.preFilter;while(s){(!n||(r=X.exec(s)))&&(r&&(s=s.slice(r[0].length)||s),l.push(i=[])),n=!1,(r=U.exec(s))&&(n=r.shift(),i.push({value:n,type:r[0].replace(z," ")}),s=s.slice(n.length));for(a in o.filter)!(r=Q[a].exec(s))||u[a]&&!(r=u[a](r))||(n=r.shift(),i.push({value:n,type:a,matches:r}),s=s.slice(n.length));if(!n)break}return t?s.length:s?at.error(e):k(e,l).slice(0)}function yt(e){var t=0,n=e.length,r="";for(;n>t;t++)r+=e[t].value;return r}function vt(e,t,n){var r=t.dir,o=n&&"parentNode"===r,a=C++;return t.first?function(t,n,i){while(t=t[r])if(1===t.nodeType||o)return e(t,n,i)}:function(t,n,s){var l,u,c,p=T+" "+a;if(s){while(t=t[r])if((1===t.nodeType||o)&&e(t,n,s))return!0}else while(t=t[r])if(1===t.nodeType||o)if(c=t[b]||(t[b]={}),(u=c[r])&&u[0]===p){if((l=u[1])===!0||l===i)return l===!0}else if(u=c[r]=[p],u[1]=e(t,n,s)||i,u[1]===!0)return!0}}function bt(e){return e.length>1?function(t,n,r){var i=e.length;while(i--)if(!e[i](t,n,r))return!1;return!0}:e[0]}function xt(e,t,n,r,i){var o,a=[],s=0,l=e.length,u=null!=t;for(;l>s;s++)(o=e[s])&&(!n||n(o,r,i))&&(a.push(o),u&&t.push(s));return a}function wt(e,t,n,r,i,o){return r&&!r[b]&&(r=wt(r)),i&&!i[b]&&(i=wt(i,o)),lt(function(o,a,s,l){var u,c,p,f=[],d=[],h=a.length,g=o||Nt(t||"*",s.nodeType?[s]:s,[]),m=!e||!o&&t?g:xt(g,f,e,s,l),y=n?i||(o?e:h||r)?[]:a:m;if(n&&n(m,y,s,l),r){u=xt(y,d),r(u,[],s,l),c=u.length;while(c--)(p=u[c])&&(y[d[c]]=!(m[d[c]]=p))}if(o){if(i||e){if(i){u=[],c=y.length;while(c--)(p=y[c])&&u.push(m[c]=p);i(null,y=[],u,l)}c=y.length;while(c--)(p=y[c])&&(u=i?F.call(o,p):f[c])>-1&&(o[u]=!(a[u]=p))}}else y=xt(y===a?y.splice(h,y.length):y),i?i(null,a,y,l):M.apply(a,y)})}function Tt(e){var t,n,r,i=e.length,a=o.relative[e[0].type],s=a||o.relative[" "],l=a?1:0,c=vt(function(e){return e===t},s,!0),p=vt(function(e){return F.call(t,e)>-1},s,!0),f=[function(e,n,r){return!a&&(r||n!==u)||((t=n).nodeType?c(e,n,r):p(e,n,r))}];for(;i>l;l++)if(n=o.relative[e[l].type])f=[vt(bt(f),n)];else{if(n=o.filter[e[l].type].apply(null,e[l].matches),n[b]){for(r=++l;i>r;r++)if(o.relative[e[r].type])break;return wt(l>1&&bt(f),l>1&&yt(e.slice(0,l-1).concat({value:" "===e[l-2].type?"*":""})).replace(z,"$1"),n,r>l&&Tt(e.slice(l,r)),i>r&&Tt(e=e.slice(r)),i>r&&yt(e))}f.push(n)}return bt(f)}function Ct(e,t){var n=0,r=t.length>0,a=e.length>0,s=function(s,l,c,p,d){var h,g,m,y=[],v=0,b="0",x=s&&[],w=null!=d,C=u,N=s||a&&o.find.TAG("*",d&&l.parentNode||l),k=T+=null==C?1:Math.random()||.1;for(w&&(u=l!==f&&l,i=n);null!=(h=N[b]);b++){if(a&&h){g=0;while(m=e[g++])if(m(h,l,c)){p.push(h);break}w&&(T=k,i=++n)}r&&((h=!m&&h)&&v--,s&&x.push(h))}if(v+=b,r&&b!==v){g=0;while(m=t[g++])m(x,y,l,c);if(s){if(v>0)while(b--)x[b]||y[b]||(y[b]=q.call(p));y=xt(y)}M.apply(p,y),w&&!s&&y.length>0&&v+t.length>1&&at.uniqueSort(p)}return w&&(T=k,u=C),x};return r?lt(s):s}l=at.compile=function(e,t){var n,r=[],i=[],o=E[e+" "];if(!o){t||(t=mt(e)),n=t.length;while(n--)o=Tt(t[n]),o[b]?r.push(o):i.push(o);o=E(e,Ct(i,r))}return o};function Nt(e,t,n){var r=0,i=t.length;for(;i>r;r++)at(e,t[r],n);return n}function kt(e,t,n,i){var a,s,u,c,p,f=mt(e);if(!i&&1===f.length){if(s=f[0]=f[0].slice(0),s.length>2&&"ID"===(u=s[0]).type&&r.getById&&9===t.nodeType&&h&&o.relative[s[1].type]){if(t=(o.find.ID(u.matches[0].replace(rt,it),t)||[])[0],!t)return n;e=e.slice(s.shift().value.length)}a=Q.needsContext.test(e)?0:s.length;while(a--){if(u=s[a],o.relative[c=u.type])break;if((p=o.find[c])&&(i=p(u.matches[0].replace(rt,it),V.test(s[0].type)&&t.parentNode||t))){if(s.splice(a,1),e=i.length&&yt(s),!e)return M.apply(n,i),n;break}}}return l(e,f)(i,t,!h,n,V.test(e)),n}r.sortStable=b.split("").sort(A).join("")===b,r.detectDuplicates=S,p(),r.sortDetached=ut(function(e){return 1&e.compareDocumentPosition(f.createElement("div"))}),ut(function(e){return e.innerHTML="<a href='#'></a>","#"===e.firstChild.getAttribute("href")})||ct("type|href|height|width",function(e,n,r){return r?t:e.getAttribute(n,"type"===n.toLowerCase()?1:2)}),r.attributes&&ut(function(e){return e.innerHTML="<input/>",e.firstChild.setAttribute("value",""),""===e.firstChild.getAttribute("value")})||ct("value",function(e,n,r){return r||"input"!==e.nodeName.toLowerCase()?t:e.defaultValue}),ut(function(e){return null==e.getAttribute("disabled")})||ct(B,function(e,n,r){var i;return r?t:(i=e.getAttributeNode(n))&&i.specified?i.value:e[n]===!0?n.toLowerCase():null}),x.find=at,x.expr=at.selectors,x.expr[":"]=x.expr.pseudos,x.unique=at.uniqueSort,x.text=at.getText,x.isXMLDoc=at.isXML,x.contains=at.contains}(e);var O={};function F(e){var t=O[e]={};return x.each(e.match(T)||[],function(e,n){t[n]=!0}),t}x.Callbacks=function(e){e="string"==typeof e?O[e]||F(e):x.extend({},e);var n,r,i,o,a,s,l=[],u=!e.once&&[],c=function(t){for(r=e.memory&&t,i=!0,a=s||0,s=0,o=l.length,n=!0;l&&o>a;a++)if(l[a].apply(t[0],t[1])===!1&&e.stopOnFalse){r=!1;break}n=!1,l&&(u?u.length&&c(u.shift()):r?l=[]:p.disable())},p={add:function(){if(l){var t=l.length;(function i(t){x.each(t,function(t,n){var r=x.type(n);"function"===r?e.unique&&p.has(n)||l.push(n):n&&n.length&&"string"!==r&&i(n)})})(arguments),n?o=l.length:r&&(s=t,c(r))}return this},remove:function(){return l&&x.each(arguments,function(e,t){var r;while((r=x.inArray(t,l,r))>-1)l.splice(r,1),n&&(o>=r&&o--,a>=r&&a--)}),this},has:function(e){return e?x.inArray(e,l)>-1:!(!l||!l.length)},empty:function(){return l=[],o=0,this},disable:function(){return l=u=r=t,this},disabled:function(){return!l},lock:function(){return u=t,r||p.disable(),this},locked:function(){return!u},fireWith:function(e,t){return!l||i&&!u||(t=t||[],t=[e,t.slice?t.slice():t],n?u.push(t):c(t)),this},fire:function(){return p.fireWith(this,arguments),this},fired:function(){return!!i}};return p},x.extend({Deferred:function(e){var t=[["resolve","done",x.Callbacks("once memory"),"resolved"],["reject","fail",x.Callbacks("once memory"),"rejected"],["notify","progress",x.Callbacks("memory")]],n="pending",r={state:function(){return n},always:function(){return i.done(arguments).fail(arguments),this},then:function(){var e=arguments;return x.Deferred(function(n){x.each(t,function(t,o){var a=o[0],s=x.isFunction(e[t])&&e[t];i[o[1]](function(){var e=s&&s.apply(this,arguments);e&&x.isFunction(e.promise)?e.promise().done(n.resolve).fail(n.reject).progress(n.notify):n[a+"With"](this===r?n.promise():this,s?[e]:arguments)})}),e=null}).promise()},promise:function(e){return null!=e?x.extend(e,r):r}},i={};return r.pipe=r.then,x.each(t,function(e,o){var a=o[2],s=o[3];r[o[1]]=a.add,s&&a.add(function(){n=s},t[1^e][2].disable,t[2][2].lock),i[o[0]]=function(){return i[o[0]+"With"](this===i?r:this,arguments),this},i[o[0]+"With"]=a.fireWith}),r.promise(i),e&&e.call(i,i),i},when:function(e){var t=0,n=g.call(arguments),r=n.length,i=1!==r||e&&x.isFunction(e.promise)?r:0,o=1===i?e:x.Deferred(),a=function(e,t,n){return function(r){t[e]=this,n[e]=arguments.length>1?g.call(arguments):r,n===s?o.notifyWith(t,n):--i||o.resolveWith(t,n)}},s,l,u;if(r>1)for(s=Array(r),l=Array(r),u=Array(r);r>t;t++)n[t]&&x.isFunction(n[t].promise)?n[t].promise().done(a(t,u,n)).fail(o.reject).progress(a(t,l,s)):--i;return i||o.resolveWith(u,n),o.promise()}}),x.support=function(t){var n,r,o,s,l,u,c,p,f,d=a.createElement("div");if(d.setAttribute("className","t"),d.innerHTML=" <link/><table></table><a href='/a'>a</a><input type='checkbox'/>",n=d.getElementsByTagName("*")||[],r=d.getElementsByTagName("a")[0],!r||!r.style||!n.length)return t;s=a.createElement("select"),u=s.appendChild(a.createElement("option")),o=d.getElementsByTagName("input")[0],r.style.cssText="top:1px;float:left;opacity:.5",t.getSetAttribute="t"!==d.className,t.leadingWhitespace=3===d.firstChild.nodeType,t.tbody=!d.getElementsByTagName("tbody").length,t.htmlSerialize=!!d.getElementsByTagName("link").length,t.style=/top/.test(r.getAttribute("style")),t.hrefNormalized="/a"===r.getAttribute("href"),t.opacity=/^0.5/.test(r.style.opacity),t.cssFloat=!!r.style.cssFloat,t.checkOn=!!o.value,t.optSelected=u.selected,t.enctype=!!a.createElement("form").enctype,t.html5Clone="<:nav></:nav>"!==a.createElement("nav").cloneNode(!0).outerHTML,t.inlineBlockNeedsLayout=!1,t.shrinkWrapBlocks=!1,t.pixelPosition=!1,t.deleteExpando=!0,t.noCloneEvent=!0,t.reliableMarginRight=!0,t.boxSizingReliable=!0,o.checked=!0,t.noCloneChecked=o.cloneNode(!0).checked,s.disabled=!0,t.optDisabled=!u.disabled;try{delete d.test}catch(h){t.deleteExpando=!1}o=a.createElement("input"),o.setAttribute("value",""),t.input=""===o.getAttribute("value"),o.value="t",o.setAttribute("type","radio"),t.radioValue="t"===o.value,o.setAttribute("checked","t"),o.setAttribute("name","t"),l=a.createDocumentFragment(),l.appendChild(o),t.appendChecked=o.checked,t.checkClone=l.cloneNode(!0).cloneNode(!0).lastChild.checked,d.attachEvent&&(d.attachEvent("onclick",function(){t.noCloneEvent=!1}),d.cloneNode(!0).click());for(f in{submit:!0,change:!0,focusin:!0})d.setAttribute(c="on"+f,"t"),t[f+"Bubbles"]=c in e||d.attributes[c].expando===!1;d.style.backgroundClip="content-box",d.cloneNode(!0).style.backgroundClip="",t.clearCloneStyle="content-box"===d.style.backgroundClip;for(f in x(t))break;return t.ownLast="0"!==f,x(function(){var n,r,o,s="padding:0;margin:0;border:0;display:block;box-sizing:content-box;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;",l=a.getElementsByTagName("body")[0];l&&(n=a.createElement("div"),n.style.cssText="border:0;width:0;height:0;position:absolute;top:0;left:-9999px;margin-top:1px",l.appendChild(n).appendChild(d),d.innerHTML="<table><tr><td></td><td>t</td></tr></table>",o=d.getElementsByTagName("td"),o[0].style.cssText="padding:0;margin:0;border:0;display:none",p=0===o[0].offsetHeight,o[0].style.display="",o[1].style.display="none",t.reliableHiddenOffsets=p&&0===o[0].offsetHeight,d.innerHTML="",d.style.cssText="box-sizing:border-box;-moz-box-sizing:border-box;-webkit-box-sizing:border-box;padding:1px;border:1px;display:block;width:4px;margin-top:1%;position:absolute;top:1%;",x.swap(l,null!=l.style.zoom?{zoom:1}:{},function(){t.boxSizing=4===d.offsetWidth}),e.getComputedStyle&&(t.pixelPosition="1%"!==(e.getComputedStyle(d,null)||{}).top,t.boxSizingReliable="4px"===(e.getComputedStyle(d,null)||{width:"4px"}).width,r=d.appendChild(a.createElement("div")),r.style.cssText=d.style.cssText=s,r.style.marginRight=r.style.width="0",d.style.width="1px",t.reliableMarginRight=!parseFloat((e.getComputedStyle(r,null)||{}).marginRight)),typeof d.style.zoom!==i&&(d.innerHTML="",d.style.cssText=s+"width:1px;padding:1px;display:inline;zoom:1",t.inlineBlockNeedsLayout=3===d.offsetWidth,d.style.display="block",d.innerHTML="<div></div>",d.firstChild.style.width="5px",t.shrinkWrapBlocks=3!==d.offsetWidth,t.inlineBlockNeedsLayout&&(l.style.zoom=1)),l.removeChild(n),n=d=o=r=null)}),n=s=l=u=r=o=null,t
+}({});var B=/(?:\{[\s\S]*\}|\[[\s\S]*\])$/,P=/([A-Z])/g;function R(e,n,r,i){if(x.acceptData(e)){var o,a,s=x.expando,l=e.nodeType,u=l?x.cache:e,c=l?e[s]:e[s]&&s;if(c&&u[c]&&(i||u[c].data)||r!==t||"string"!=typeof n)return c||(c=l?e[s]=p.pop()||x.guid++:s),u[c]||(u[c]=l?{}:{toJSON:x.noop}),("object"==typeof n||"function"==typeof n)&&(i?u[c]=x.extend(u[c],n):u[c].data=x.extend(u[c].data,n)),a=u[c],i||(a.data||(a.data={}),a=a.data),r!==t&&(a[x.camelCase(n)]=r),"string"==typeof n?(o=a[n],null==o&&(o=a[x.camelCase(n)])):o=a,o}}function W(e,t,n){if(x.acceptData(e)){var r,i,o=e.nodeType,a=o?x.cache:e,s=o?e[x.expando]:x.expando;if(a[s]){if(t&&(r=n?a[s]:a[s].data)){x.isArray(t)?t=t.concat(x.map(t,x.camelCase)):t in r?t=[t]:(t=x.camelCase(t),t=t in r?[t]:t.split(" ")),i=t.length;while(i--)delete r[t[i]];if(n?!I(r):!x.isEmptyObject(r))return}(n||(delete a[s].data,I(a[s])))&&(o?x.cleanData([e],!0):x.support.deleteExpando||a!=a.window?delete a[s]:a[s]=null)}}}x.extend({cache:{},noData:{applet:!0,embed:!0,object:"clsid:D27CDB6E-AE6D-11cf-96B8-444553540000"},hasData:function(e){return e=e.nodeType?x.cache[e[x.expando]]:e[x.expando],!!e&&!I(e)},data:function(e,t,n){return R(e,t,n)},removeData:function(e,t){return W(e,t)},_data:function(e,t,n){return R(e,t,n,!0)},_removeData:function(e,t){return W(e,t,!0)},acceptData:function(e){if(e.nodeType&&1!==e.nodeType&&9!==e.nodeType)return!1;var t=e.nodeName&&x.noData[e.nodeName.toLowerCase()];return!t||t!==!0&&e.getAttribute("classid")===t}}),x.fn.extend({data:function(e,n){var r,i,o=null,a=0,s=this[0];if(e===t){if(this.length&&(o=x.data(s),1===s.nodeType&&!x._data(s,"parsedAttrs"))){for(r=s.attributes;r.length>a;a++)i=r[a].name,0===i.indexOf("data-")&&(i=x.camelCase(i.slice(5)),$(s,i,o[i]));x._data(s,"parsedAttrs",!0)}return o}return"object"==typeof e?this.each(function(){x.data(this,e)}):arguments.length>1?this.each(function(){x.data(this,e,n)}):s?$(s,e,x.data(s,e)):null},removeData:function(e){return this.each(function(){x.removeData(this,e)})}});function $(e,n,r){if(r===t&&1===e.nodeType){var i="data-"+n.replace(P,"-$1").toLowerCase();if(r=e.getAttribute(i),"string"==typeof r){try{r="true"===r?!0:"false"===r?!1:"null"===r?null:+r+""===r?+r:B.test(r)?x.parseJSON(r):r}catch(o){}x.data(e,n,r)}else r=t}return r}function I(e){var t;for(t in e)if(("data"!==t||!x.isEmptyObject(e[t]))&&"toJSON"!==t)return!1;return!0}x.extend({queue:function(e,n,r){var i;return e?(n=(n||"fx")+"queue",i=x._data(e,n),r&&(!i||x.isArray(r)?i=x._data(e,n,x.makeArray(r)):i.push(r)),i||[]):t},dequeue:function(e,t){t=t||"fx";var n=x.queue(e,t),r=n.length,i=n.shift(),o=x._queueHooks(e,t),a=function(){x.dequeue(e,t)};"inprogress"===i&&(i=n.shift(),r--),i&&("fx"===t&&n.unshift("inprogress"),delete o.stop,i.call(e,a,o)),!r&&o&&o.empty.fire()},_queueHooks:function(e,t){var n=t+"queueHooks";return x._data(e,n)||x._data(e,n,{empty:x.Callbacks("once memory").add(function(){x._removeData(e,t+"queue"),x._removeData(e,n)})})}}),x.fn.extend({queue:function(e,n){var r=2;return"string"!=typeof e&&(n=e,e="fx",r--),r>arguments.length?x.queue(this[0],e):n===t?this:this.each(function(){var t=x.queue(this,e,n);x._queueHooks(this,e),"fx"===e&&"inprogress"!==t[0]&&x.dequeue(this,e)})},dequeue:function(e){return this.each(function(){x.dequeue(this,e)})},delay:function(e,t){return e=x.fx?x.fx.speeds[e]||e:e,t=t||"fx",this.queue(t,function(t,n){var r=setTimeout(t,e);n.stop=function(){clearTimeout(r)}})},clearQueue:function(e){return this.queue(e||"fx",[])},promise:function(e,n){var r,i=1,o=x.Deferred(),a=this,s=this.length,l=function(){--i||o.resolveWith(a,[a])};"string"!=typeof e&&(n=e,e=t),e=e||"fx";while(s--)r=x._data(a[s],e+"queueHooks"),r&&r.empty&&(i++,r.empty.add(l));return l(),o.promise(n)}});var z,X,U=/[\t\r\n\f]/g,V=/\r/g,Y=/^(?:input|select|textarea|button|object)$/i,J=/^(?:a|area)$/i,G=/^(?:checked|selected)$/i,Q=x.support.getSetAttribute,K=x.support.input;x.fn.extend({attr:function(e,t){return x.access(this,x.attr,e,t,arguments.length>1)},removeAttr:function(e){return this.each(function(){x.removeAttr(this,e)})},prop:function(e,t){return x.access(this,x.prop,e,t,arguments.length>1)},removeProp:function(e){return e=x.propFix[e]||e,this.each(function(){try{this[e]=t,delete this[e]}catch(n){}})},addClass:function(e){var t,n,r,i,o,a=0,s=this.length,l="string"==typeof e&&e;if(x.isFunction(e))return this.each(function(t){x(this).addClass(e.call(this,t,this.className))});if(l)for(t=(e||"").match(T)||[];s>a;a++)if(n=this[a],r=1===n.nodeType&&(n.className?(" "+n.className+" ").replace(U," "):" ")){o=0;while(i=t[o++])0>r.indexOf(" "+i+" ")&&(r+=i+" ");n.className=x.trim(r)}return this},removeClass:function(e){var t,n,r,i,o,a=0,s=this.length,l=0===arguments.length||"string"==typeof e&&e;if(x.isFunction(e))return this.each(function(t){x(this).removeClass(e.call(this,t,this.className))});if(l)for(t=(e||"").match(T)||[];s>a;a++)if(n=this[a],r=1===n.nodeType&&(n.className?(" "+n.className+" ").replace(U," "):"")){o=0;while(i=t[o++])while(r.indexOf(" "+i+" ")>=0)r=r.replace(" "+i+" "," ");n.className=e?x.trim(r):""}return this},toggleClass:function(e,t){var n=typeof e;return"boolean"==typeof t&&"string"===n?t?this.addClass(e):this.removeClass(e):x.isFunction(e)?this.each(function(n){x(this).toggleClass(e.call(this,n,this.className,t),t)}):this.each(function(){if("string"===n){var t,r=0,o=x(this),a=e.match(T)||[];while(t=a[r++])o.hasClass(t)?o.removeClass(t):o.addClass(t)}else(n===i||"boolean"===n)&&(this.className&&x._data(this,"__className__",this.className),this.className=this.className||e===!1?"":x._data(this,"__className__")||"")})},hasClass:function(e){var t=" "+e+" ",n=0,r=this.length;for(;r>n;n++)if(1===this[n].nodeType&&(" "+this[n].className+" ").replace(U," ").indexOf(t)>=0)return!0;return!1},val:function(e){var n,r,i,o=this[0];{if(arguments.length)return i=x.isFunction(e),this.each(function(n){var o;1===this.nodeType&&(o=i?e.call(this,n,x(this).val()):e,null==o?o="":"number"==typeof o?o+="":x.isArray(o)&&(o=x.map(o,function(e){return null==e?"":e+""})),r=x.valHooks[this.type]||x.valHooks[this.nodeName.toLowerCase()],r&&"set"in r&&r.set(this,o,"value")!==t||(this.value=o))});if(o)return r=x.valHooks[o.type]||x.valHooks[o.nodeName.toLowerCase()],r&&"get"in r&&(n=r.get(o,"value"))!==t?n:(n=o.value,"string"==typeof n?n.replace(V,""):null==n?"":n)}}}),x.extend({valHooks:{option:{get:function(e){var t=x.find.attr(e,"value");return null!=t?t:e.text}},select:{get:function(e){var t,n,r=e.options,i=e.selectedIndex,o="select-one"===e.type||0>i,a=o?null:[],s=o?i+1:r.length,l=0>i?s:o?i:0;for(;s>l;l++)if(n=r[l],!(!n.selected&&l!==i||(x.support.optDisabled?n.disabled:null!==n.getAttribute("disabled"))||n.parentNode.disabled&&x.nodeName(n.parentNode,"optgroup"))){if(t=x(n).val(),o)return t;a.push(t)}return a},set:function(e,t){var n,r,i=e.options,o=x.makeArray(t),a=i.length;while(a--)r=i[a],(r.selected=x.inArray(x(r).val(),o)>=0)&&(n=!0);return n||(e.selectedIndex=-1),o}}},attr:function(e,n,r){var o,a,s=e.nodeType;if(e&&3!==s&&8!==s&&2!==s)return typeof e.getAttribute===i?x.prop(e,n,r):(1===s&&x.isXMLDoc(e)||(n=n.toLowerCase(),o=x.attrHooks[n]||(x.expr.match.bool.test(n)?X:z)),r===t?o&&"get"in o&&null!==(a=o.get(e,n))?a:(a=x.find.attr(e,n),null==a?t:a):null!==r?o&&"set"in o&&(a=o.set(e,r,n))!==t?a:(e.setAttribute(n,r+""),r):(x.removeAttr(e,n),t))},removeAttr:function(e,t){var n,r,i=0,o=t&&t.match(T);if(o&&1===e.nodeType)while(n=o[i++])r=x.propFix[n]||n,x.expr.match.bool.test(n)?K&&Q||!G.test(n)?e[r]=!1:e[x.camelCase("default-"+n)]=e[r]=!1:x.attr(e,n,""),e.removeAttribute(Q?n:r)},attrHooks:{type:{set:function(e,t){if(!x.support.radioValue&&"radio"===t&&x.nodeName(e,"input")){var n=e.value;return e.setAttribute("type",t),n&&(e.value=n),t}}}},propFix:{"for":"htmlFor","class":"className"},prop:function(e,n,r){var i,o,a,s=e.nodeType;if(e&&3!==s&&8!==s&&2!==s)return a=1!==s||!x.isXMLDoc(e),a&&(n=x.propFix[n]||n,o=x.propHooks[n]),r!==t?o&&"set"in o&&(i=o.set(e,r,n))!==t?i:e[n]=r:o&&"get"in o&&null!==(i=o.get(e,n))?i:e[n]},propHooks:{tabIndex:{get:function(e){var t=x.find.attr(e,"tabindex");return t?parseInt(t,10):Y.test(e.nodeName)||J.test(e.nodeName)&&e.href?0:-1}}}}),X={set:function(e,t,n){return t===!1?x.removeAttr(e,n):K&&Q||!G.test(n)?e.setAttribute(!Q&&x.propFix[n]||n,n):e[x.camelCase("default-"+n)]=e[n]=!0,n}},x.each(x.expr.match.bool.source.match(/\w+/g),function(e,n){var r=x.expr.attrHandle[n]||x.find.attr;x.expr.attrHandle[n]=K&&Q||!G.test(n)?function(e,n,i){var o=x.expr.attrHandle[n],a=i?t:(x.expr.attrHandle[n]=t)!=r(e,n,i)?n.toLowerCase():null;return x.expr.attrHandle[n]=o,a}:function(e,n,r){return r?t:e[x.camelCase("default-"+n)]?n.toLowerCase():null}}),K&&Q||(x.attrHooks.value={set:function(e,n,r){return x.nodeName(e,"input")?(e.defaultValue=n,t):z&&z.set(e,n,r)}}),Q||(z={set:function(e,n,r){var i=e.getAttributeNode(r);return i||e.setAttributeNode(i=e.ownerDocument.createAttribute(r)),i.value=n+="","value"===r||n===e.getAttribute(r)?n:t}},x.expr.attrHandle.id=x.expr.attrHandle.name=x.expr.attrHandle.coords=function(e,n,r){var i;return r?t:(i=e.getAttributeNode(n))&&""!==i.value?i.value:null},x.valHooks.button={get:function(e,n){var r=e.getAttributeNode(n);return r&&r.specified?r.value:t},set:z.set},x.attrHooks.contenteditable={set:function(e,t,n){z.set(e,""===t?!1:t,n)}},x.each(["width","height"],function(e,n){x.attrHooks[n]={set:function(e,r){return""===r?(e.setAttribute(n,"auto"),r):t}}})),x.support.hrefNormalized||x.each(["href","src"],function(e,t){x.propHooks[t]={get:function(e){return e.getAttribute(t,4)}}}),x.support.style||(x.attrHooks.style={get:function(e){return e.style.cssText||t},set:function(e,t){return e.style.cssText=t+""}}),x.support.optSelected||(x.propHooks.selected={get:function(e){var t=e.parentNode;return t&&(t.selectedIndex,t.parentNode&&t.parentNode.selectedIndex),null}}),x.each(["tabIndex","readOnly","maxLength","cellSpacing","cellPadding","rowSpan","colSpan","useMap","frameBorder","contentEditable"],function(){x.propFix[this.toLowerCase()]=this}),x.support.enctype||(x.propFix.enctype="encoding"),x.each(["radio","checkbox"],function(){x.valHooks[this]={set:function(e,n){return x.isArray(n)?e.checked=x.inArray(x(e).val(),n)>=0:t}},x.support.checkOn||(x.valHooks[this].get=function(e){return null===e.getAttribute("value")?"on":e.value})});var Z=/^(?:input|select|textarea)$/i,et=/^key/,tt=/^(?:mouse|contextmenu)|click/,nt=/^(?:focusinfocus|focusoutblur)$/,rt=/^([^.]*)(?:\.(.+)|)$/;function it(){return!0}function ot(){return!1}function at(){try{return a.activeElement}catch(e){}}x.event={global:{},add:function(e,n,r,o,a){var s,l,u,c,p,f,d,h,g,m,y,v=x._data(e);if(v){r.handler&&(c=r,r=c.handler,a=c.selector),r.guid||(r.guid=x.guid++),(l=v.events)||(l=v.events={}),(f=v.handle)||(f=v.handle=function(e){return typeof x===i||e&&x.event.triggered===e.type?t:x.event.dispatch.apply(f.elem,arguments)},f.elem=e),n=(n||"").match(T)||[""],u=n.length;while(u--)s=rt.exec(n[u])||[],g=y=s[1],m=(s[2]||"").split(".").sort(),g&&(p=x.event.special[g]||{},g=(a?p.delegateType:p.bindType)||g,p=x.event.special[g]||{},d=x.extend({type:g,origType:y,data:o,handler:r,guid:r.guid,selector:a,needsContext:a&&x.expr.match.needsContext.test(a),namespace:m.join(".")},c),(h=l[g])||(h=l[g]=[],h.delegateCount=0,p.setup&&p.setup.call(e,o,m,f)!==!1||(e.addEventListener?e.addEventListener(g,f,!1):e.attachEvent&&e.attachEvent("on"+g,f))),p.add&&(p.add.call(e,d),d.handler.guid||(d.handler.guid=r.guid)),a?h.splice(h.delegateCount++,0,d):h.push(d),x.event.global[g]=!0);e=null}},remove:function(e,t,n,r,i){var o,a,s,l,u,c,p,f,d,h,g,m=x.hasData(e)&&x._data(e);if(m&&(c=m.events)){t=(t||"").match(T)||[""],u=t.length;while(u--)if(s=rt.exec(t[u])||[],d=g=s[1],h=(s[2]||"").split(".").sort(),d){p=x.event.special[d]||{},d=(r?p.delegateType:p.bindType)||d,f=c[d]||[],s=s[2]&&RegExp("(^|\\.)"+h.join("\\.(?:.*\\.|)")+"(\\.|$)"),l=o=f.length;while(o--)a=f[o],!i&&g!==a.origType||n&&n.guid!==a.guid||s&&!s.test(a.namespace)||r&&r!==a.selector&&("**"!==r||!a.selector)||(f.splice(o,1),a.selector&&f.delegateCount--,p.remove&&p.remove.call(e,a));l&&!f.length&&(p.teardown&&p.teardown.call(e,h,m.handle)!==!1||x.removeEvent(e,d,m.handle),delete c[d])}else for(d in c)x.event.remove(e,d+t[u],n,r,!0);x.isEmptyObject(c)&&(delete m.handle,x._removeData(e,"events"))}},trigger:function(n,r,i,o){var s,l,u,c,p,f,d,h=[i||a],g=v.call(n,"type")?n.type:n,m=v.call(n,"namespace")?n.namespace.split("."):[];if(u=f=i=i||a,3!==i.nodeType&&8!==i.nodeType&&!nt.test(g+x.event.triggered)&&(g.indexOf(".")>=0&&(m=g.split("."),g=m.shift(),m.sort()),l=0>g.indexOf(":")&&"on"+g,n=n[x.expando]?n:new x.Event(g,"object"==typeof n&&n),n.isTrigger=o?2:3,n.namespace=m.join("."),n.namespace_re=n.namespace?RegExp("(^|\\.)"+m.join("\\.(?:.*\\.|)")+"(\\.|$)"):null,n.result=t,n.target||(n.target=i),r=null==r?[n]:x.makeArray(r,[n]),p=x.event.special[g]||{},o||!p.trigger||p.trigger.apply(i,r)!==!1)){if(!o&&!p.noBubble&&!x.isWindow(i)){for(c=p.delegateType||g,nt.test(c+g)||(u=u.parentNode);u;u=u.parentNode)h.push(u),f=u;f===(i.ownerDocument||a)&&h.push(f.defaultView||f.parentWindow||e)}d=0;while((u=h[d++])&&!n.isPropagationStopped())n.type=d>1?c:p.bindType||g,s=(x._data(u,"events")||{})[n.type]&&x._data(u,"handle"),s&&s.apply(u,r),s=l&&u[l],s&&x.acceptData(u)&&s.apply&&s.apply(u,r)===!1&&n.preventDefault();if(n.type=g,!o&&!n.isDefaultPrevented()&&(!p._default||p._default.apply(h.pop(),r)===!1)&&x.acceptData(i)&&l&&i[g]&&!x.isWindow(i)){f=i[l],f&&(i[l]=null),x.event.triggered=g;try{i[g]()}catch(y){}x.event.triggered=t,f&&(i[l]=f)}return n.result}},dispatch:function(e){e=x.event.fix(e);var n,r,i,o,a,s=[],l=g.call(arguments),u=(x._data(this,"events")||{})[e.type]||[],c=x.event.special[e.type]||{};if(l[0]=e,e.delegateTarget=this,!c.preDispatch||c.preDispatch.call(this,e)!==!1){s=x.event.handlers.call(this,e,u),n=0;while((o=s[n++])&&!e.isPropagationStopped()){e.currentTarget=o.elem,a=0;while((i=o.handlers[a++])&&!e.isImmediatePropagationStopped())(!e.namespace_re||e.namespace_re.test(i.namespace))&&(e.handleObj=i,e.data=i.data,r=((x.event.special[i.origType]||{}).handle||i.handler).apply(o.elem,l),r!==t&&(e.result=r)===!1&&(e.preventDefault(),e.stopPropagation()))}return c.postDispatch&&c.postDispatch.call(this,e),e.result}},handlers:function(e,n){var r,i,o,a,s=[],l=n.delegateCount,u=e.target;if(l&&u.nodeType&&(!e.button||"click"!==e.type))for(;u!=this;u=u.parentNode||this)if(1===u.nodeType&&(u.disabled!==!0||"click"!==e.type)){for(o=[],a=0;l>a;a++)i=n[a],r=i.selector+" ",o[r]===t&&(o[r]=i.needsContext?x(r,this).index(u)>=0:x.find(r,this,null,[u]).length),o[r]&&o.push(i);o.length&&s.push({elem:u,handlers:o})}return n.length>l&&s.push({elem:this,handlers:n.slice(l)}),s},fix:function(e){if(e[x.expando])return e;var t,n,r,i=e.type,o=e,s=this.fixHooks[i];s||(this.fixHooks[i]=s=tt.test(i)?this.mouseHooks:et.test(i)?this.keyHooks:{}),r=s.props?this.props.concat(s.props):this.props,e=new x.Event(o),t=r.length;while(t--)n=r[t],e[n]=o[n];return e.target||(e.target=o.srcElement||a),3===e.target.nodeType&&(e.target=e.target.parentNode),e.metaKey=!!e.metaKey,s.filter?s.filter(e,o):e},props:"altKey bubbles cancelable ctrlKey currentTarget eventPhase metaKey relatedTarget shiftKey target timeStamp view which".split(" "),fixHooks:{},keyHooks:{props:"char charCode key keyCode".split(" "),filter:function(e,t){return null==e.which&&(e.which=null!=t.charCode?t.charCode:t.keyCode),e}},mouseHooks:{props:"button buttons clientX clientY fromElement offsetX offsetY pageX pageY screenX screenY toElement".split(" "),filter:function(e,n){var r,i,o,s=n.button,l=n.fromElement;return null==e.pageX&&null!=n.clientX&&(i=e.target.ownerDocument||a,o=i.documentElement,r=i.body,e.pageX=n.clientX+(o&&o.scrollLeft||r&&r.scrollLeft||0)-(o&&o.clientLeft||r&&r.clientLeft||0),e.pageY=n.clientY+(o&&o.scrollTop||r&&r.scrollTop||0)-(o&&o.clientTop||r&&r.clientTop||0)),!e.relatedTarget&&l&&(e.relatedTarget=l===e.target?n.toElement:l),e.which||s===t||(e.which=1&s?1:2&s?3:4&s?2:0),e}},special:{load:{noBubble:!0},focus:{trigger:function(){if(this!==at()&&this.focus)try{return this.focus(),!1}catch(e){}},delegateType:"focusin"},blur:{trigger:function(){return this===at()&&this.blur?(this.blur(),!1):t},delegateType:"focusout"},click:{trigger:function(){return x.nodeName(this,"input")&&"checkbox"===this.type&&this.click?(this.click(),!1):t},_default:function(e){return x.nodeName(e.target,"a")}},beforeunload:{postDispatch:function(e){e.result!==t&&(e.originalEvent.returnValue=e.result)}}},simulate:function(e,t,n,r){var i=x.extend(new x.Event,n,{type:e,isSimulated:!0,originalEvent:{}});r?x.event.trigger(i,null,t):x.event.dispatch.call(t,i),i.isDefaultPrevented()&&n.preventDefault()}},x.removeEvent=a.removeEventListener?function(e,t,n){e.removeEventListener&&e.removeEventListener(t,n,!1)}:function(e,t,n){var r="on"+t;e.detachEvent&&(typeof e[r]===i&&(e[r]=null),e.detachEvent(r,n))},x.Event=function(e,n){return this instanceof x.Event?(e&&e.type?(this.originalEvent=e,this.type=e.type,this.isDefaultPrevented=e.defaultPrevented||e.returnValue===!1||e.getPreventDefault&&e.getPreventDefault()?it:ot):this.type=e,n&&x.extend(this,n),this.timeStamp=e&&e.timeStamp||x.now(),this[x.expando]=!0,t):new x.Event(e,n)},x.Event.prototype={isDefaultPrevented:ot,isPropagationStopped:ot,isImmediatePropagationStopped:ot,preventDefault:function(){var e=this.originalEvent;this.isDefaultPrevented=it,e&&(e.preventDefault?e.preventDefault():e.returnValue=!1)},stopPropagation:function(){var e=this.originalEvent;this.isPropagationStopped=it,e&&(e.stopPropagation&&e.stopPropagation(),e.cancelBubble=!0)},stopImmediatePropagation:function(){this.isImmediatePropagationStopped=it,this.stopPropagation()}},x.each({mouseenter:"mouseover",mouseleave:"mouseout"},function(e,t){x.event.special[e]={delegateType:t,bindType:t,handle:function(e){var n,r=this,i=e.relatedTarget,o=e.handleObj;return(!i||i!==r&&!x.contains(r,i))&&(e.type=o.origType,n=o.handler.apply(this,arguments),e.type=t),n}}}),x.support.submitBubbles||(x.event.special.submit={setup:function(){return x.nodeName(this,"form")?!1:(x.event.add(this,"click._submit keypress._submit",function(e){var n=e.target,r=x.nodeName(n,"input")||x.nodeName(n,"button")?n.form:t;r&&!x._data(r,"submitBubbles")&&(x.event.add(r,"submit._submit",function(e){e._submit_bubble=!0}),x._data(r,"submitBubbles",!0))}),t)},postDispatch:function(e){e._submit_bubble&&(delete e._submit_bubble,this.parentNode&&!e.isTrigger&&x.event.simulate("submit",this.parentNode,e,!0))},teardown:function(){return x.nodeName(this,"form")?!1:(x.event.remove(this,"._submit"),t)}}),x.support.changeBubbles||(x.event.special.change={setup:function(){return Z.test(this.nodeName)?(("checkbox"===this.type||"radio"===this.type)&&(x.event.add(this,"propertychange._change",function(e){"checked"===e.originalEvent.propertyName&&(this._just_changed=!0)}),x.event.add(this,"click._change",function(e){this._just_changed&&!e.isTrigger&&(this._just_changed=!1),x.event.simulate("change",this,e,!0)})),!1):(x.event.add(this,"beforeactivate._change",function(e){var t=e.target;Z.test(t.nodeName)&&!x._data(t,"changeBubbles")&&(x.event.add(t,"change._change",function(e){!this.parentNode||e.isSimulated||e.isTrigger||x.event.simulate("change",this.parentNode,e,!0)}),x._data(t,"changeBubbles",!0))}),t)},handle:function(e){var n=e.target;return this!==n||e.isSimulated||e.isTrigger||"radio"!==n.type&&"checkbox"!==n.type?e.handleObj.handler.apply(this,arguments):t},teardown:function(){return x.event.remove(this,"._change"),!Z.test(this.nodeName)}}),x.support.focusinBubbles||x.each({focus:"focusin",blur:"focusout"},function(e,t){var n=0,r=function(e){x.event.simulate(t,e.target,x.event.fix(e),!0)};x.event.special[t]={setup:function(){0===n++&&a.addEventListener(e,r,!0)},teardown:function(){0===--n&&a.removeEventListener(e,r,!0)}}}),x.fn.extend({on:function(e,n,r,i,o){var a,s;if("object"==typeof e){"string"!=typeof n&&(r=r||n,n=t);for(a in e)this.on(a,n,r,e[a],o);return this}if(null==r&&null==i?(i=n,r=n=t):null==i&&("string"==typeof n?(i=r,r=t):(i=r,r=n,n=t)),i===!1)i=ot;else if(!i)return this;return 1===o&&(s=i,i=function(e){return x().off(e),s.apply(this,arguments)},i.guid=s.guid||(s.guid=x.guid++)),this.each(function(){x.event.add(this,e,i,r,n)})},one:function(e,t,n,r){return this.on(e,t,n,r,1)},off:function(e,n,r){var i,o;if(e&&e.preventDefault&&e.handleObj)return i=e.handleObj,x(e.delegateTarget).off(i.namespace?i.origType+"."+i.namespace:i.origType,i.selector,i.handler),this;if("object"==typeof e){for(o in e)this.off(o,n,e[o]);return this}return(n===!1||"function"==typeof n)&&(r=n,n=t),r===!1&&(r=ot),this.each(function(){x.event.remove(this,e,r,n)})},trigger:function(e,t){return this.each(function(){x.event.trigger(e,t,this)})},triggerHandler:function(e,n){var r=this[0];return r?x.event.trigger(e,n,r,!0):t}});var st=/^.[^:#\[\.,]*$/,lt=/^(?:parents|prev(?:Until|All))/,ut=x.expr.match.needsContext,ct={children:!0,contents:!0,next:!0,prev:!0};x.fn.extend({find:function(e){var t,n=[],r=this,i=r.length;if("string"!=typeof e)return this.pushStack(x(e).filter(function(){for(t=0;i>t;t++)if(x.contains(r[t],this))return!0}));for(t=0;i>t;t++)x.find(e,r[t],n);return n=this.pushStack(i>1?x.unique(n):n),n.selector=this.selector?this.selector+" "+e:e,n},has:function(e){var t,n=x(e,this),r=n.length;return this.filter(function(){for(t=0;r>t;t++)if(x.contains(this,n[t]))return!0})},not:function(e){return this.pushStack(ft(this,e||[],!0))},filter:function(e){return this.pushStack(ft(this,e||[],!1))},is:function(e){return!!ft(this,"string"==typeof e&&ut.test(e)?x(e):e||[],!1).length},closest:function(e,t){var n,r=0,i=this.length,o=[],a=ut.test(e)||"string"!=typeof e?x(e,t||this.context):0;for(;i>r;r++)for(n=this[r];n&&n!==t;n=n.parentNode)if(11>n.nodeType&&(a?a.index(n)>-1:1===n.nodeType&&x.find.matchesSelector(n,e))){n=o.push(n);break}return this.pushStack(o.length>1?x.unique(o):o)},index:function(e){return e?"string"==typeof e?x.inArray(this[0],x(e)):x.inArray(e.jquery?e[0]:e,this):this[0]&&this[0].parentNode?this.first().prevAll().length:-1},add:function(e,t){var n="string"==typeof e?x(e,t):x.makeArray(e&&e.nodeType?[e]:e),r=x.merge(this.get(),n);return this.pushStack(x.unique(r))},addBack:function(e){return this.add(null==e?this.prevObject:this.prevObject.filter(e))}});function pt(e,t){do e=e[t];while(e&&1!==e.nodeType);return e}x.each({parent:function(e){var t=e.parentNode;return t&&11!==t.nodeType?t:null},parents:function(e){return x.dir(e,"parentNode")},parentsUntil:function(e,t,n){return x.dir(e,"parentNode",n)},next:function(e){return pt(e,"nextSibling")},prev:function(e){return pt(e,"previousSibling")},nextAll:function(e){return x.dir(e,"nextSibling")},prevAll:function(e){return x.dir(e,"previousSibling")},nextUntil:function(e,t,n){return x.dir(e,"nextSibling",n)},prevUntil:function(e,t,n){return x.dir(e,"previousSibling",n)},siblings:function(e){return x.sibling((e.parentNode||{}).firstChild,e)},children:function(e){return x.sibling(e.firstChild)},contents:function(e){return x.nodeName(e,"iframe")?e.contentDocument||e.contentWindow.document:x.merge([],e.childNodes)}},function(e,t){x.fn[e]=function(n,r){var i=x.map(this,t,n);return"Until"!==e.slice(-5)&&(r=n),r&&"string"==typeof r&&(i=x.filter(r,i)),this.length>1&&(ct[e]||(i=x.unique(i)),lt.test(e)&&(i=i.reverse())),this.pushStack(i)}}),x.extend({filter:function(e,t,n){var r=t[0];return n&&(e=":not("+e+")"),1===t.length&&1===r.nodeType?x.find.matchesSelector(r,e)?[r]:[]:x.find.matches(e,x.grep(t,function(e){return 1===e.nodeType}))},dir:function(e,n,r){var i=[],o=e[n];while(o&&9!==o.nodeType&&(r===t||1!==o.nodeType||!x(o).is(r)))1===o.nodeType&&i.push(o),o=o[n];return i},sibling:function(e,t){var n=[];for(;e;e=e.nextSibling)1===e.nodeType&&e!==t&&n.push(e);return n}});function ft(e,t,n){if(x.isFunction(t))return x.grep(e,function(e,r){return!!t.call(e,r,e)!==n});if(t.nodeType)return x.grep(e,function(e){return e===t!==n});if("string"==typeof t){if(st.test(t))return x.filter(t,e,n);t=x.filter(t,e)}return x.grep(e,function(e){return x.inArray(e,t)>=0!==n})}function dt(e){var t=ht.split("|"),n=e.createDocumentFragment();if(n.createElement)while(t.length)n.createElement(t.pop());return n}var ht="abbr|article|aside|audio|bdi|canvas|data|datalist|details|figcaption|figure|footer|header|hgroup|mark|meter|nav|output|progress|section|summary|time|video",gt=/ jQuery\d+="(?:null|\d+)"/g,mt=RegExp("<(?:"+ht+")[\\s/>]","i"),yt=/^\s+/,vt=/<(?!area|br|col|embed|hr|img|input|link|meta|param)(([\w:]+)[^>]*)\/>/gi,bt=/<([\w:]+)/,xt=/<tbody/i,wt=/<|&#?\w+;/,Tt=/<(?:script|style|link)/i,Ct=/^(?:checkbox|radio)$/i,Nt=/checked\s*(?:[^=]|=\s*.checked.)/i,kt=/^$|\/(?:java|ecma)script/i,Et=/^true\/(.*)/,St=/^\s*<!(?:\[CDATA\[|--)|(?:\]\]|--)>\s*$/g,At={option:[1,"<select multiple='multiple'>","</select>"],legend:[1,"<fieldset>","</fieldset>"],area:[1,"<map>","</map>"],param:[1,"<object>","</object>"],thead:[1,"<table>","</table>"],tr:[2,"<table><tbody>","</tbody></table>"],col:[2,"<table><tbody></tbody><colgroup>","</colgroup></table>"],td:[3,"<table><tbody><tr>","</tr></tbody></table>"],_default:x.support.htmlSerialize?[0,"",""]:[1,"X<div>","</div>"]},jt=dt(a),Dt=jt.appendChild(a.createElement("div"));At.optgroup=At.option,At.tbody=At.tfoot=At.colgroup=At.caption=At.thead,At.th=At.td,x.fn.extend({text:function(e){return x.access(this,function(e){return e===t?x.text(this):this.empty().append((this[0]&&this[0].ownerDocument||a).createTextNode(e))},null,e,arguments.length)},append:function(){return this.domManip(arguments,function(e){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var t=Lt(this,e);t.appendChild(e)}})},prepend:function(){return this.domManip(arguments,function(e){if(1===this.nodeType||11===this.nodeType||9===this.nodeType){var t=Lt(this,e);t.insertBefore(e,t.firstChild)}})},before:function(){return this.domManip(arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this)})},after:function(){return this.domManip(arguments,function(e){this.parentNode&&this.parentNode.insertBefore(e,this.nextSibling)})},remove:function(e,t){var n,r=e?x.filter(e,this):this,i=0;for(;null!=(n=r[i]);i++)t||1!==n.nodeType||x.cleanData(Ft(n)),n.parentNode&&(t&&x.contains(n.ownerDocument,n)&&_t(Ft(n,"script")),n.parentNode.removeChild(n));return this},empty:function(){var e,t=0;for(;null!=(e=this[t]);t++){1===e.nodeType&&x.cleanData(Ft(e,!1));while(e.firstChild)e.removeChild(e.firstChild);e.options&&x.nodeName(e,"select")&&(e.options.length=0)}return this},clone:function(e,t){return e=null==e?!1:e,t=null==t?e:t,this.map(function(){return x.clone(this,e,t)})},html:function(e){return x.access(this,function(e){var n=this[0]||{},r=0,i=this.length;if(e===t)return 1===n.nodeType?n.innerHTML.replace(gt,""):t;if(!("string"!=typeof e||Tt.test(e)||!x.support.htmlSerialize&&mt.test(e)||!x.support.leadingWhitespace&&yt.test(e)||At[(bt.exec(e)||["",""])[1].toLowerCase()])){e=e.replace(vt,"<$1></$2>");try{for(;i>r;r++)n=this[r]||{},1===n.nodeType&&(x.cleanData(Ft(n,!1)),n.innerHTML=e);n=0}catch(o){}}n&&this.empty().append(e)},null,e,arguments.length)},replaceWith:function(){var e=x.map(this,function(e){return[e.nextSibling,e.parentNode]}),t=0;return this.domManip(arguments,function(n){var r=e[t++],i=e[t++];i&&(r&&r.parentNode!==i&&(r=this.nextSibling),x(this).remove(),i.insertBefore(n,r))},!0),t?this:this.remove()},detach:function(e){return this.remove(e,!0)},domManip:function(e,t,n){e=d.apply([],e);var r,i,o,a,s,l,u=0,c=this.length,p=this,f=c-1,h=e[0],g=x.isFunction(h);if(g||!(1>=c||"string"!=typeof h||x.support.checkClone)&&Nt.test(h))return this.each(function(r){var i=p.eq(r);g&&(e[0]=h.call(this,r,i.html())),i.domManip(e,t,n)});if(c&&(l=x.buildFragment(e,this[0].ownerDocument,!1,!n&&this),r=l.firstChild,1===l.childNodes.length&&(l=r),r)){for(a=x.map(Ft(l,"script"),Ht),o=a.length;c>u;u++)i=l,u!==f&&(i=x.clone(i,!0,!0),o&&x.merge(a,Ft(i,"script"))),t.call(this[u],i,u);if(o)for(s=a[a.length-1].ownerDocument,x.map(a,qt),u=0;o>u;u++)i=a[u],kt.test(i.type||"")&&!x._data(i,"globalEval")&&x.contains(s,i)&&(i.src?x._evalUrl(i.src):x.globalEval((i.text||i.textContent||i.innerHTML||"").replace(St,"")));l=r=null}return this}});function Lt(e,t){return x.nodeName(e,"table")&&x.nodeName(1===t.nodeType?t:t.firstChild,"tr")?e.getElementsByTagName("tbody")[0]||e.appendChild(e.ownerDocument.createElement("tbody")):e}function Ht(e){return e.type=(null!==x.find.attr(e,"type"))+"/"+e.type,e}function qt(e){var t=Et.exec(e.type);return t?e.type=t[1]:e.removeAttribute("type"),e}function _t(e,t){var n,r=0;for(;null!=(n=e[r]);r++)x._data(n,"globalEval",!t||x._data(t[r],"globalEval"))}function Mt(e,t){if(1===t.nodeType&&x.hasData(e)){var n,r,i,o=x._data(e),a=x._data(t,o),s=o.events;if(s){delete a.handle,a.events={};for(n in s)for(r=0,i=s[n].length;i>r;r++)x.event.add(t,n,s[n][r])}a.data&&(a.data=x.extend({},a.data))}}function Ot(e,t){var n,r,i;if(1===t.nodeType){if(n=t.nodeName.toLowerCase(),!x.support.noCloneEvent&&t[x.expando]){i=x._data(t);for(r in i.events)x.removeEvent(t,r,i.handle);t.removeAttribute(x.expando)}"script"===n&&t.text!==e.text?(Ht(t).text=e.text,qt(t)):"object"===n?(t.parentNode&&(t.outerHTML=e.outerHTML),x.support.html5Clone&&e.innerHTML&&!x.trim(t.innerHTML)&&(t.innerHTML=e.innerHTML)):"input"===n&&Ct.test(e.type)?(t.defaultChecked=t.checked=e.checked,t.value!==e.value&&(t.value=e.value)):"option"===n?t.defaultSelected=t.selected=e.defaultSelected:("input"===n||"textarea"===n)&&(t.defaultValue=e.defaultValue)}}x.each({appendTo:"append",prependTo:"prepend",insertBefore:"before",insertAfter:"after",replaceAll:"replaceWith"},function(e,t){x.fn[e]=function(e){var n,r=0,i=[],o=x(e),a=o.length-1;for(;a>=r;r++)n=r===a?this:this.clone(!0),x(o[r])[t](n),h.apply(i,n.get());return this.pushStack(i)}});function Ft(e,n){var r,o,a=0,s=typeof e.getElementsByTagName!==i?e.getElementsByTagName(n||"*"):typeof e.querySelectorAll!==i?e.querySelectorAll(n||"*"):t;if(!s)for(s=[],r=e.childNodes||e;null!=(o=r[a]);a++)!n||x.nodeName(o,n)?s.push(o):x.merge(s,Ft(o,n));return n===t||n&&x.nodeName(e,n)?x.merge([e],s):s}function Bt(e){Ct.test(e.type)&&(e.defaultChecked=e.checked)}x.extend({clone:function(e,t,n){var r,i,o,a,s,l=x.contains(e.ownerDocument,e);if(x.support.html5Clone||x.isXMLDoc(e)||!mt.test("<"+e.nodeName+">")?o=e.cloneNode(!0):(Dt.innerHTML=e.outerHTML,Dt.removeChild(o=Dt.firstChild)),!(x.support.noCloneEvent&&x.support.noCloneChecked||1!==e.nodeType&&11!==e.nodeType||x.isXMLDoc(e)))for(r=Ft(o),s=Ft(e),a=0;null!=(i=s[a]);++a)r[a]&&Ot(i,r[a]);if(t)if(n)for(s=s||Ft(e),r=r||Ft(o),a=0;null!=(i=s[a]);a++)Mt(i,r[a]);else Mt(e,o);return r=Ft(o,"script"),r.length>0&&_t(r,!l&&Ft(e,"script")),r=s=i=null,o},buildFragment:function(e,t,n,r){var i,o,a,s,l,u,c,p=e.length,f=dt(t),d=[],h=0;for(;p>h;h++)if(o=e[h],o||0===o)if("object"===x.type(o))x.merge(d,o.nodeType?[o]:o);else if(wt.test(o)){s=s||f.appendChild(t.createElement("div")),l=(bt.exec(o)||["",""])[1].toLowerCase(),c=At[l]||At._default,s.innerHTML=c[1]+o.replace(vt,"<$1></$2>")+c[2],i=c[0];while(i--)s=s.lastChild;if(!x.support.leadingWhitespace&&yt.test(o)&&d.push(t.createTextNode(yt.exec(o)[0])),!x.support.tbody){o="table"!==l||xt.test(o)?"<table>"!==c[1]||xt.test(o)?0:s:s.firstChild,i=o&&o.childNodes.length;while(i--)x.nodeName(u=o.childNodes[i],"tbody")&&!u.childNodes.length&&o.removeChild(u)}x.merge(d,s.childNodes),s.textContent="";while(s.firstChild)s.removeChild(s.firstChild);s=f.lastChild}else d.push(t.createTextNode(o));s&&f.removeChild(s),x.support.appendChecked||x.grep(Ft(d,"input"),Bt),h=0;while(o=d[h++])if((!r||-1===x.inArray(o,r))&&(a=x.contains(o.ownerDocument,o),s=Ft(f.appendChild(o),"script"),a&&_t(s),n)){i=0;while(o=s[i++])kt.test(o.type||"")&&n.push(o)}return s=null,f},cleanData:function(e,t){var n,r,o,a,s=0,l=x.expando,u=x.cache,c=x.support.deleteExpando,f=x.event.special;for(;null!=(n=e[s]);s++)if((t||x.acceptData(n))&&(o=n[l],a=o&&u[o])){if(a.events)for(r in a.events)f[r]?x.event.remove(n,r):x.removeEvent(n,r,a.handle);
+u[o]&&(delete u[o],c?delete n[l]:typeof n.removeAttribute!==i?n.removeAttribute(l):n[l]=null,p.push(o))}},_evalUrl:function(e){return x.ajax({url:e,type:"GET",dataType:"script",async:!1,global:!1,"throws":!0})}}),x.fn.extend({wrapAll:function(e){if(x.isFunction(e))return this.each(function(t){x(this).wrapAll(e.call(this,t))});if(this[0]){var t=x(e,this[0].ownerDocument).eq(0).clone(!0);this[0].parentNode&&t.insertBefore(this[0]),t.map(function(){var e=this;while(e.firstChild&&1===e.firstChild.nodeType)e=e.firstChild;return e}).append(this)}return this},wrapInner:function(e){return x.isFunction(e)?this.each(function(t){x(this).wrapInner(e.call(this,t))}):this.each(function(){var t=x(this),n=t.contents();n.length?n.wrapAll(e):t.append(e)})},wrap:function(e){var t=x.isFunction(e);return this.each(function(n){x(this).wrapAll(t?e.call(this,n):e)})},unwrap:function(){return this.parent().each(function(){x.nodeName(this,"body")||x(this).replaceWith(this.childNodes)}).end()}});var Pt,Rt,Wt,$t=/alpha\([^)]*\)/i,It=/opacity\s*=\s*([^)]*)/,zt=/^(top|right|bottom|left)$/,Xt=/^(none|table(?!-c[ea]).+)/,Ut=/^margin/,Vt=RegExp("^("+w+")(.*)$","i"),Yt=RegExp("^("+w+")(?!px)[a-z%]+$","i"),Jt=RegExp("^([+-])=("+w+")","i"),Gt={BODY:"block"},Qt={position:"absolute",visibility:"hidden",display:"block"},Kt={letterSpacing:0,fontWeight:400},Zt=["Top","Right","Bottom","Left"],en=["Webkit","O","Moz","ms"];function tn(e,t){if(t in e)return t;var n=t.charAt(0).toUpperCase()+t.slice(1),r=t,i=en.length;while(i--)if(t=en[i]+n,t in e)return t;return r}function nn(e,t){return e=t||e,"none"===x.css(e,"display")||!x.contains(e.ownerDocument,e)}function rn(e,t){var n,r,i,o=[],a=0,s=e.length;for(;s>a;a++)r=e[a],r.style&&(o[a]=x._data(r,"olddisplay"),n=r.style.display,t?(o[a]||"none"!==n||(r.style.display=""),""===r.style.display&&nn(r)&&(o[a]=x._data(r,"olddisplay",ln(r.nodeName)))):o[a]||(i=nn(r),(n&&"none"!==n||!i)&&x._data(r,"olddisplay",i?n:x.css(r,"display"))));for(a=0;s>a;a++)r=e[a],r.style&&(t&&"none"!==r.style.display&&""!==r.style.display||(r.style.display=t?o[a]||"":"none"));return e}x.fn.extend({css:function(e,n){return x.access(this,function(e,n,r){var i,o,a={},s=0;if(x.isArray(n)){for(o=Rt(e),i=n.length;i>s;s++)a[n[s]]=x.css(e,n[s],!1,o);return a}return r!==t?x.style(e,n,r):x.css(e,n)},e,n,arguments.length>1)},show:function(){return rn(this,!0)},hide:function(){return rn(this)},toggle:function(e){return"boolean"==typeof e?e?this.show():this.hide():this.each(function(){nn(this)?x(this).show():x(this).hide()})}}),x.extend({cssHooks:{opacity:{get:function(e,t){if(t){var n=Wt(e,"opacity");return""===n?"1":n}}}},cssNumber:{columnCount:!0,fillOpacity:!0,fontWeight:!0,lineHeight:!0,opacity:!0,order:!0,orphans:!0,widows:!0,zIndex:!0,zoom:!0},cssProps:{"float":x.support.cssFloat?"cssFloat":"styleFloat"},style:function(e,n,r,i){if(e&&3!==e.nodeType&&8!==e.nodeType&&e.style){var o,a,s,l=x.camelCase(n),u=e.style;if(n=x.cssProps[l]||(x.cssProps[l]=tn(u,l)),s=x.cssHooks[n]||x.cssHooks[l],r===t)return s&&"get"in s&&(o=s.get(e,!1,i))!==t?o:u[n];if(a=typeof r,"string"===a&&(o=Jt.exec(r))&&(r=(o[1]+1)*o[2]+parseFloat(x.css(e,n)),a="number"),!(null==r||"number"===a&&isNaN(r)||("number"!==a||x.cssNumber[l]||(r+="px"),x.support.clearCloneStyle||""!==r||0!==n.indexOf("background")||(u[n]="inherit"),s&&"set"in s&&(r=s.set(e,r,i))===t)))try{u[n]=r}catch(c){}}},css:function(e,n,r,i){var o,a,s,l=x.camelCase(n);return n=x.cssProps[l]||(x.cssProps[l]=tn(e.style,l)),s=x.cssHooks[n]||x.cssHooks[l],s&&"get"in s&&(a=s.get(e,!0,r)),a===t&&(a=Wt(e,n,i)),"normal"===a&&n in Kt&&(a=Kt[n]),""===r||r?(o=parseFloat(a),r===!0||x.isNumeric(o)?o||0:a):a}}),e.getComputedStyle?(Rt=function(t){return e.getComputedStyle(t,null)},Wt=function(e,n,r){var i,o,a,s=r||Rt(e),l=s?s.getPropertyValue(n)||s[n]:t,u=e.style;return s&&(""!==l||x.contains(e.ownerDocument,e)||(l=x.style(e,n)),Yt.test(l)&&Ut.test(n)&&(i=u.width,o=u.minWidth,a=u.maxWidth,u.minWidth=u.maxWidth=u.width=l,l=s.width,u.width=i,u.minWidth=o,u.maxWidth=a)),l}):a.documentElement.currentStyle&&(Rt=function(e){return e.currentStyle},Wt=function(e,n,r){var i,o,a,s=r||Rt(e),l=s?s[n]:t,u=e.style;return null==l&&u&&u[n]&&(l=u[n]),Yt.test(l)&&!zt.test(n)&&(i=u.left,o=e.runtimeStyle,a=o&&o.left,a&&(o.left=e.currentStyle.left),u.left="fontSize"===n?"1em":l,l=u.pixelLeft+"px",u.left=i,a&&(o.left=a)),""===l?"auto":l});function on(e,t,n){var r=Vt.exec(t);return r?Math.max(0,r[1]-(n||0))+(r[2]||"px"):t}function an(e,t,n,r,i){var o=n===(r?"border":"content")?4:"width"===t?1:0,a=0;for(;4>o;o+=2)"margin"===n&&(a+=x.css(e,n+Zt[o],!0,i)),r?("content"===n&&(a-=x.css(e,"padding"+Zt[o],!0,i)),"margin"!==n&&(a-=x.css(e,"border"+Zt[o]+"Width",!0,i))):(a+=x.css(e,"padding"+Zt[o],!0,i),"padding"!==n&&(a+=x.css(e,"border"+Zt[o]+"Width",!0,i)));return a}function sn(e,t,n){var r=!0,i="width"===t?e.offsetWidth:e.offsetHeight,o=Rt(e),a=x.support.boxSizing&&"border-box"===x.css(e,"boxSizing",!1,o);if(0>=i||null==i){if(i=Wt(e,t,o),(0>i||null==i)&&(i=e.style[t]),Yt.test(i))return i;r=a&&(x.support.boxSizingReliable||i===e.style[t]),i=parseFloat(i)||0}return i+an(e,t,n||(a?"border":"content"),r,o)+"px"}function ln(e){var t=a,n=Gt[e];return n||(n=un(e,t),"none"!==n&&n||(Pt=(Pt||x("<iframe frameborder='0' width='0' height='0'/>").css("cssText","display:block !important")).appendTo(t.documentElement),t=(Pt[0].contentWindow||Pt[0].contentDocument).document,t.write("<!doctype html><html><body>"),t.close(),n=un(e,t),Pt.detach()),Gt[e]=n),n}function un(e,t){var n=x(t.createElement(e)).appendTo(t.body),r=x.css(n[0],"display");return n.remove(),r}x.each(["height","width"],function(e,n){x.cssHooks[n]={get:function(e,r,i){return r?0===e.offsetWidth&&Xt.test(x.css(e,"display"))?x.swap(e,Qt,function(){return sn(e,n,i)}):sn(e,n,i):t},set:function(e,t,r){var i=r&&Rt(e);return on(e,t,r?an(e,n,r,x.support.boxSizing&&"border-box"===x.css(e,"boxSizing",!1,i),i):0)}}}),x.support.opacity||(x.cssHooks.opacity={get:function(e,t){return It.test((t&&e.currentStyle?e.currentStyle.filter:e.style.filter)||"")?.01*parseFloat(RegExp.$1)+"":t?"1":""},set:function(e,t){var n=e.style,r=e.currentStyle,i=x.isNumeric(t)?"alpha(opacity="+100*t+")":"",o=r&&r.filter||n.filter||"";n.zoom=1,(t>=1||""===t)&&""===x.trim(o.replace($t,""))&&n.removeAttribute&&(n.removeAttribute("filter"),""===t||r&&!r.filter)||(n.filter=$t.test(o)?o.replace($t,i):o+" "+i)}}),x(function(){x.support.reliableMarginRight||(x.cssHooks.marginRight={get:function(e,n){return n?x.swap(e,{display:"inline-block"},Wt,[e,"marginRight"]):t}}),!x.support.pixelPosition&&x.fn.position&&x.each(["top","left"],function(e,n){x.cssHooks[n]={get:function(e,r){return r?(r=Wt(e,n),Yt.test(r)?x(e).position()[n]+"px":r):t}}})}),x.expr&&x.expr.filters&&(x.expr.filters.hidden=function(e){return 0>=e.offsetWidth&&0>=e.offsetHeight||!x.support.reliableHiddenOffsets&&"none"===(e.style&&e.style.display||x.css(e,"display"))},x.expr.filters.visible=function(e){return!x.expr.filters.hidden(e)}),x.each({margin:"",padding:"",border:"Width"},function(e,t){x.cssHooks[e+t]={expand:function(n){var r=0,i={},o="string"==typeof n?n.split(" "):[n];for(;4>r;r++)i[e+Zt[r]+t]=o[r]||o[r-2]||o[0];return i}},Ut.test(e)||(x.cssHooks[e+t].set=on)});var cn=/%20/g,pn=/\[\]$/,fn=/\r?\n/g,dn=/^(?:submit|button|image|reset|file)$/i,hn=/^(?:input|select|textarea|keygen)/i;x.fn.extend({serialize:function(){return x.param(this.serializeArray())},serializeArray:function(){return this.map(function(){var e=x.prop(this,"elements");return e?x.makeArray(e):this}).filter(function(){var e=this.type;return this.name&&!x(this).is(":disabled")&&hn.test(this.nodeName)&&!dn.test(e)&&(this.checked||!Ct.test(e))}).map(function(e,t){var n=x(this).val();return null==n?null:x.isArray(n)?x.map(n,function(e){return{name:t.name,value:e.replace(fn,"\r\n")}}):{name:t.name,value:n.replace(fn,"\r\n")}}).get()}}),x.param=function(e,n){var r,i=[],o=function(e,t){t=x.isFunction(t)?t():null==t?"":t,i[i.length]=encodeURIComponent(e)+"="+encodeURIComponent(t)};if(n===t&&(n=x.ajaxSettings&&x.ajaxSettings.traditional),x.isArray(e)||e.jquery&&!x.isPlainObject(e))x.each(e,function(){o(this.name,this.value)});else for(r in e)gn(r,e[r],n,o);return i.join("&").replace(cn,"+")};function gn(e,t,n,r){var i;if(x.isArray(t))x.each(t,function(t,i){n||pn.test(e)?r(e,i):gn(e+"["+("object"==typeof i?t:"")+"]",i,n,r)});else if(n||"object"!==x.type(t))r(e,t);else for(i in t)gn(e+"["+i+"]",t[i],n,r)}x.each("blur focus focusin focusout load resize scroll unload click dblclick mousedown mouseup mousemove mouseover mouseout mouseenter mouseleave change select submit keydown keypress keyup error contextmenu".split(" "),function(e,t){x.fn[t]=function(e,n){return arguments.length>0?this.on(t,null,e,n):this.trigger(t)}}),x.fn.extend({hover:function(e,t){return this.mouseenter(e).mouseleave(t||e)},bind:function(e,t,n){return this.on(e,null,t,n)},unbind:function(e,t){return this.off(e,null,t)},delegate:function(e,t,n,r){return this.on(t,e,n,r)},undelegate:function(e,t,n){return 1===arguments.length?this.off(e,"**"):this.off(t,e||"**",n)}});var mn,yn,vn=x.now(),bn=/\?/,xn=/#.*$/,wn=/([?&])_=[^&]*/,Tn=/^(.*?):[ \t]*([^\r\n]*)\r?$/gm,Cn=/^(?:about|app|app-storage|.+-extension|file|res|widget):$/,Nn=/^(?:GET|HEAD)$/,kn=/^\/\//,En=/^([\w.+-]+:)(?:\/\/([^\/?#:]*)(?::(\d+)|)|)/,Sn=x.fn.load,An={},jn={},Dn="*/".concat("*");try{yn=o.href}catch(Ln){yn=a.createElement("a"),yn.href="",yn=yn.href}mn=En.exec(yn.toLowerCase())||[];function Hn(e){return function(t,n){"string"!=typeof t&&(n=t,t="*");var r,i=0,o=t.toLowerCase().match(T)||[];if(x.isFunction(n))while(r=o[i++])"+"===r[0]?(r=r.slice(1)||"*",(e[r]=e[r]||[]).unshift(n)):(e[r]=e[r]||[]).push(n)}}function qn(e,n,r,i){var o={},a=e===jn;function s(l){var u;return o[l]=!0,x.each(e[l]||[],function(e,l){var c=l(n,r,i);return"string"!=typeof c||a||o[c]?a?!(u=c):t:(n.dataTypes.unshift(c),s(c),!1)}),u}return s(n.dataTypes[0])||!o["*"]&&s("*")}function _n(e,n){var r,i,o=x.ajaxSettings.flatOptions||{};for(i in n)n[i]!==t&&((o[i]?e:r||(r={}))[i]=n[i]);return r&&x.extend(!0,e,r),e}x.fn.load=function(e,n,r){if("string"!=typeof e&&Sn)return Sn.apply(this,arguments);var i,o,a,s=this,l=e.indexOf(" ");return l>=0&&(i=e.slice(l,e.length),e=e.slice(0,l)),x.isFunction(n)?(r=n,n=t):n&&"object"==typeof n&&(a="POST"),s.length>0&&x.ajax({url:e,type:a,dataType:"html",data:n}).done(function(e){o=arguments,s.html(i?x("<div>").append(x.parseHTML(e)).find(i):e)}).complete(r&&function(e,t){s.each(r,o||[e.responseText,t,e])}),this},x.each(["ajaxStart","ajaxStop","ajaxComplete","ajaxError","ajaxSuccess","ajaxSend"],function(e,t){x.fn[t]=function(e){return this.on(t,e)}}),x.extend({active:0,lastModified:{},etag:{},ajaxSettings:{url:yn,type:"GET",isLocal:Cn.test(mn[1]),global:!0,processData:!0,async:!0,contentType:"application/x-www-form-urlencoded; charset=UTF-8",accepts:{"*":Dn,text:"text/plain",html:"text/html",xml:"application/xml, text/xml",json:"application/json, text/javascript"},contents:{xml:/xml/,html:/html/,json:/json/},responseFields:{xml:"responseXML",text:"responseText",json:"responseJSON"},converters:{"* text":String,"text html":!0,"text json":x.parseJSON,"text xml":x.parseXML},flatOptions:{url:!0,context:!0}},ajaxSetup:function(e,t){return t?_n(_n(e,x.ajaxSettings),t):_n(x.ajaxSettings,e)},ajaxPrefilter:Hn(An),ajaxTransport:Hn(jn),ajax:function(e,n){"object"==typeof e&&(n=e,e=t),n=n||{};var r,i,o,a,s,l,u,c,p=x.ajaxSetup({},n),f=p.context||p,d=p.context&&(f.nodeType||f.jquery)?x(f):x.event,h=x.Deferred(),g=x.Callbacks("once memory"),m=p.statusCode||{},y={},v={},b=0,w="canceled",C={readyState:0,getResponseHeader:function(e){var t;if(2===b){if(!c){c={};while(t=Tn.exec(a))c[t[1].toLowerCase()]=t[2]}t=c[e.toLowerCase()]}return null==t?null:t},getAllResponseHeaders:function(){return 2===b?a:null},setRequestHeader:function(e,t){var n=e.toLowerCase();return b||(e=v[n]=v[n]||e,y[e]=t),this},overrideMimeType:function(e){return b||(p.mimeType=e),this},statusCode:function(e){var t;if(e)if(2>b)for(t in e)m[t]=[m[t],e[t]];else C.always(e[C.status]);return this},abort:function(e){var t=e||w;return u&&u.abort(t),k(0,t),this}};if(h.promise(C).complete=g.add,C.success=C.done,C.error=C.fail,p.url=((e||p.url||yn)+"").replace(xn,"").replace(kn,mn[1]+"//"),p.type=n.method||n.type||p.method||p.type,p.dataTypes=x.trim(p.dataType||"*").toLowerCase().match(T)||[""],null==p.crossDomain&&(r=En.exec(p.url.toLowerCase()),p.crossDomain=!(!r||r[1]===mn[1]&&r[2]===mn[2]&&(r[3]||("http:"===r[1]?"80":"443"))===(mn[3]||("http:"===mn[1]?"80":"443")))),p.data&&p.processData&&"string"!=typeof p.data&&(p.data=x.param(p.data,p.traditional)),qn(An,p,n,C),2===b)return C;l=p.global,l&&0===x.active++&&x.event.trigger("ajaxStart"),p.type=p.type.toUpperCase(),p.hasContent=!Nn.test(p.type),o=p.url,p.hasContent||(p.data&&(o=p.url+=(bn.test(o)?"&":"?")+p.data,delete p.data),p.cache===!1&&(p.url=wn.test(o)?o.replace(wn,"$1_="+vn++):o+(bn.test(o)?"&":"?")+"_="+vn++)),p.ifModified&&(x.lastModified[o]&&C.setRequestHeader("If-Modified-Since",x.lastModified[o]),x.etag[o]&&C.setRequestHeader("If-None-Match",x.etag[o])),(p.data&&p.hasContent&&p.contentType!==!1||n.contentType)&&C.setRequestHeader("Content-Type",p.contentType),C.setRequestHeader("Accept",p.dataTypes[0]&&p.accepts[p.dataTypes[0]]?p.accepts[p.dataTypes[0]]+("*"!==p.dataTypes[0]?", "+Dn+"; q=0.01":""):p.accepts["*"]);for(i in p.headers)C.setRequestHeader(i,p.headers[i]);if(p.beforeSend&&(p.beforeSend.call(f,C,p)===!1||2===b))return C.abort();w="abort";for(i in{success:1,error:1,complete:1})C[i](p[i]);if(u=qn(jn,p,n,C)){C.readyState=1,l&&d.trigger("ajaxSend",[C,p]),p.async&&p.timeout>0&&(s=setTimeout(function(){C.abort("timeout")},p.timeout));try{b=1,u.send(y,k)}catch(N){if(!(2>b))throw N;k(-1,N)}}else k(-1,"No Transport");function k(e,n,r,i){var c,y,v,w,T,N=n;2!==b&&(b=2,s&&clearTimeout(s),u=t,a=i||"",C.readyState=e>0?4:0,c=e>=200&&300>e||304===e,r&&(w=Mn(p,C,r)),w=On(p,w,C,c),c?(p.ifModified&&(T=C.getResponseHeader("Last-Modified"),T&&(x.lastModified[o]=T),T=C.getResponseHeader("etag"),T&&(x.etag[o]=T)),204===e||"HEAD"===p.type?N="nocontent":304===e?N="notmodified":(N=w.state,y=w.data,v=w.error,c=!v)):(v=N,(e||!N)&&(N="error",0>e&&(e=0))),C.status=e,C.statusText=(n||N)+"",c?h.resolveWith(f,[y,N,C]):h.rejectWith(f,[C,N,v]),C.statusCode(m),m=t,l&&d.trigger(c?"ajaxSuccess":"ajaxError",[C,p,c?y:v]),g.fireWith(f,[C,N]),l&&(d.trigger("ajaxComplete",[C,p]),--x.active||x.event.trigger("ajaxStop")))}return C},getJSON:function(e,t,n){return x.get(e,t,n,"json")},getScript:function(e,n){return x.get(e,t,n,"script")}}),x.each(["get","post"],function(e,n){x[n]=function(e,r,i,o){return x.isFunction(r)&&(o=o||i,i=r,r=t),x.ajax({url:e,type:n,dataType:o,data:r,success:i})}});function Mn(e,n,r){var i,o,a,s,l=e.contents,u=e.dataTypes;while("*"===u[0])u.shift(),o===t&&(o=e.mimeType||n.getResponseHeader("Content-Type"));if(o)for(s in l)if(l[s]&&l[s].test(o)){u.unshift(s);break}if(u[0]in r)a=u[0];else{for(s in r){if(!u[0]||e.converters[s+" "+u[0]]){a=s;break}i||(i=s)}a=a||i}return a?(a!==u[0]&&u.unshift(a),r[a]):t}function On(e,t,n,r){var i,o,a,s,l,u={},c=e.dataTypes.slice();if(c[1])for(a in e.converters)u[a.toLowerCase()]=e.converters[a];o=c.shift();while(o)if(e.responseFields[o]&&(n[e.responseFields[o]]=t),!l&&r&&e.dataFilter&&(t=e.dataFilter(t,e.dataType)),l=o,o=c.shift())if("*"===o)o=l;else if("*"!==l&&l!==o){if(a=u[l+" "+o]||u["* "+o],!a)for(i in u)if(s=i.split(" "),s[1]===o&&(a=u[l+" "+s[0]]||u["* "+s[0]])){a===!0?a=u[i]:u[i]!==!0&&(o=s[0],c.unshift(s[1]));break}if(a!==!0)if(a&&e["throws"])t=a(t);else try{t=a(t)}catch(p){return{state:"parsererror",error:a?p:"No conversion from "+l+" to "+o}}}return{state:"success",data:t}}x.ajaxSetup({accepts:{script:"text/javascript, application/javascript, application/ecmascript, application/x-ecmascript"},contents:{script:/(?:java|ecma)script/},converters:{"text script":function(e){return x.globalEval(e),e}}}),x.ajaxPrefilter("script",function(e){e.cache===t&&(e.cache=!1),e.crossDomain&&(e.type="GET",e.global=!1)}),x.ajaxTransport("script",function(e){if(e.crossDomain){var n,r=a.head||x("head")[0]||a.documentElement;return{send:function(t,i){n=a.createElement("script"),n.async=!0,e.scriptCharset&&(n.charset=e.scriptCharset),n.src=e.url,n.onload=n.onreadystatechange=function(e,t){(t||!n.readyState||/loaded|complete/.test(n.readyState))&&(n.onload=n.onreadystatechange=null,n.parentNode&&n.parentNode.removeChild(n),n=null,t||i(200,"success"))},r.insertBefore(n,r.firstChild)},abort:function(){n&&n.onload(t,!0)}}}});var Fn=[],Bn=/(=)\?(?=&|$)|\?\?/;x.ajaxSetup({jsonp:"callback",jsonpCallback:function(){var e=Fn.pop()||x.expando+"_"+vn++;return this[e]=!0,e}}),x.ajaxPrefilter("json jsonp",function(n,r,i){var o,a,s,l=n.jsonp!==!1&&(Bn.test(n.url)?"url":"string"==typeof n.data&&!(n.contentType||"").indexOf("application/x-www-form-urlencoded")&&Bn.test(n.data)&&"data");return l||"jsonp"===n.dataTypes[0]?(o=n.jsonpCallback=x.isFunction(n.jsonpCallback)?n.jsonpCallback():n.jsonpCallback,l?n[l]=n[l].replace(Bn,"$1"+o):n.jsonp!==!1&&(n.url+=(bn.test(n.url)?"&":"?")+n.jsonp+"="+o),n.converters["script json"]=function(){return s||x.error(o+" was not called"),s[0]},n.dataTypes[0]="json",a=e[o],e[o]=function(){s=arguments},i.always(function(){e[o]=a,n[o]&&(n.jsonpCallback=r.jsonpCallback,Fn.push(o)),s&&x.isFunction(a)&&a(s[0]),s=a=t}),"script"):t});var Pn,Rn,Wn=0,$n=e.ActiveXObject&&function(){var e;for(e in Pn)Pn[e](t,!0)};function In(){try{return new e.XMLHttpRequest}catch(t){}}function zn(){try{return new e.ActiveXObject("Microsoft.XMLHTTP")}catch(t){}}x.ajaxSettings.xhr=e.ActiveXObject?function(){return!this.isLocal&&In()||zn()}:In,Rn=x.ajaxSettings.xhr(),x.support.cors=!!Rn&&"withCredentials"in Rn,Rn=x.support.ajax=!!Rn,Rn&&x.ajaxTransport(function(n){if(!n.crossDomain||x.support.cors){var r;return{send:function(i,o){var a,s,l=n.xhr();if(n.username?l.open(n.type,n.url,n.async,n.username,n.password):l.open(n.type,n.url,n.async),n.xhrFields)for(s in n.xhrFields)l[s]=n.xhrFields[s];n.mimeType&&l.overrideMimeType&&l.overrideMimeType(n.mimeType),n.crossDomain||i["X-Requested-With"]||(i["X-Requested-With"]="XMLHttpRequest");try{for(s in i)l.setRequestHeader(s,i[s])}catch(u){}l.send(n.hasContent&&n.data||null),r=function(e,i){var s,u,c,p;try{if(r&&(i||4===l.readyState))if(r=t,a&&(l.onreadystatechange=x.noop,$n&&delete Pn[a]),i)4!==l.readyState&&l.abort();else{p={},s=l.status,u=l.getAllResponseHeaders(),"string"==typeof l.responseText&&(p.text=l.responseText);try{c=l.statusText}catch(f){c=""}s||!n.isLocal||n.crossDomain?1223===s&&(s=204):s=p.text?200:404}}catch(d){i||o(-1,d)}p&&o(s,c,p,u)},n.async?4===l.readyState?setTimeout(r):(a=++Wn,$n&&(Pn||(Pn={},x(e).unload($n)),Pn[a]=r),l.onreadystatechange=r):r()},abort:function(){r&&r(t,!0)}}}});var Xn,Un,Vn=/^(?:toggle|show|hide)$/,Yn=RegExp("^(?:([+-])=|)("+w+")([a-z%]*)$","i"),Jn=/queueHooks$/,Gn=[nr],Qn={"*":[function(e,t){var n=this.createTween(e,t),r=n.cur(),i=Yn.exec(t),o=i&&i[3]||(x.cssNumber[e]?"":"px"),a=(x.cssNumber[e]||"px"!==o&&+r)&&Yn.exec(x.css(n.elem,e)),s=1,l=20;if(a&&a[3]!==o){o=o||a[3],i=i||[],a=+r||1;do s=s||".5",a/=s,x.style(n.elem,e,a+o);while(s!==(s=n.cur()/r)&&1!==s&&--l)}return i&&(a=n.start=+a||+r||0,n.unit=o,n.end=i[1]?a+(i[1]+1)*i[2]:+i[2]),n}]};function Kn(){return setTimeout(function(){Xn=t}),Xn=x.now()}function Zn(e,t,n){var r,i=(Qn[t]||[]).concat(Qn["*"]),o=0,a=i.length;for(;a>o;o++)if(r=i[o].call(n,t,e))return r}function er(e,t,n){var r,i,o=0,a=Gn.length,s=x.Deferred().always(function(){delete l.elem}),l=function(){if(i)return!1;var t=Xn||Kn(),n=Math.max(0,u.startTime+u.duration-t),r=n/u.duration||0,o=1-r,a=0,l=u.tweens.length;for(;l>a;a++)u.tweens[a].run(o);return s.notifyWith(e,[u,o,n]),1>o&&l?n:(s.resolveWith(e,[u]),!1)},u=s.promise({elem:e,props:x.extend({},t),opts:x.extend(!0,{specialEasing:{}},n),originalProperties:t,originalOptions:n,startTime:Xn||Kn(),duration:n.duration,tweens:[],createTween:function(t,n){var r=x.Tween(e,u.opts,t,n,u.opts.specialEasing[t]||u.opts.easing);return u.tweens.push(r),r},stop:function(t){var n=0,r=t?u.tweens.length:0;if(i)return this;for(i=!0;r>n;n++)u.tweens[n].run(1);return t?s.resolveWith(e,[u,t]):s.rejectWith(e,[u,t]),this}}),c=u.props;for(tr(c,u.opts.specialEasing);a>o;o++)if(r=Gn[o].call(u,e,c,u.opts))return r;return x.map(c,Zn,u),x.isFunction(u.opts.start)&&u.opts.start.call(e,u),x.fx.timer(x.extend(l,{elem:e,anim:u,queue:u.opts.queue})),u.progress(u.opts.progress).done(u.opts.done,u.opts.complete).fail(u.opts.fail).always(u.opts.always)}function tr(e,t){var n,r,i,o,a;for(n in e)if(r=x.camelCase(n),i=t[r],o=e[n],x.isArray(o)&&(i=o[1],o=e[n]=o[0]),n!==r&&(e[r]=o,delete e[n]),a=x.cssHooks[r],a&&"expand"in a){o=a.expand(o),delete e[r];for(n in o)n in e||(e[n]=o[n],t[n]=i)}else t[r]=i}x.Animation=x.extend(er,{tweener:function(e,t){x.isFunction(e)?(t=e,e=["*"]):e=e.split(" ");var n,r=0,i=e.length;for(;i>r;r++)n=e[r],Qn[n]=Qn[n]||[],Qn[n].unshift(t)},prefilter:function(e,t){t?Gn.unshift(e):Gn.push(e)}});function nr(e,t,n){var r,i,o,a,s,l,u=this,c={},p=e.style,f=e.nodeType&&nn(e),d=x._data(e,"fxshow");n.queue||(s=x._queueHooks(e,"fx"),null==s.unqueued&&(s.unqueued=0,l=s.empty.fire,s.empty.fire=function(){s.unqueued||l()}),s.unqueued++,u.always(function(){u.always(function(){s.unqueued--,x.queue(e,"fx").length||s.empty.fire()})})),1===e.nodeType&&("height"in t||"width"in t)&&(n.overflow=[p.overflow,p.overflowX,p.overflowY],"inline"===x.css(e,"display")&&"none"===x.css(e,"float")&&(x.support.inlineBlockNeedsLayout&&"inline"!==ln(e.nodeName)?p.zoom=1:p.display="inline-block")),n.overflow&&(p.overflow="hidden",x.support.shrinkWrapBlocks||u.always(function(){p.overflow=n.overflow[0],p.overflowX=n.overflow[1],p.overflowY=n.overflow[2]}));for(r in t)if(i=t[r],Vn.exec(i)){if(delete t[r],o=o||"toggle"===i,i===(f?"hide":"show"))continue;c[r]=d&&d[r]||x.style(e,r)}if(!x.isEmptyObject(c)){d?"hidden"in d&&(f=d.hidden):d=x._data(e,"fxshow",{}),o&&(d.hidden=!f),f?x(e).show():u.done(function(){x(e).hide()}),u.done(function(){var t;x._removeData(e,"fxshow");for(t in c)x.style(e,t,c[t])});for(r in c)a=Zn(f?d[r]:0,r,u),r in d||(d[r]=a.start,f&&(a.end=a.start,a.start="width"===r||"height"===r?1:0))}}function rr(e,t,n,r,i){return new rr.prototype.init(e,t,n,r,i)}x.Tween=rr,rr.prototype={constructor:rr,init:function(e,t,n,r,i,o){this.elem=e,this.prop=n,this.easing=i||"swing",this.options=t,this.start=this.now=this.cur(),this.end=r,this.unit=o||(x.cssNumber[n]?"":"px")},cur:function(){var e=rr.propHooks[this.prop];return e&&e.get?e.get(this):rr.propHooks._default.get(this)},run:function(e){var t,n=rr.propHooks[this.prop];return this.pos=t=this.options.duration?x.easing[this.easing](e,this.options.duration*e,0,1,this.options.duration):e,this.now=(this.end-this.start)*t+this.start,this.options.step&&this.options.step.call(this.elem,this.now,this),n&&n.set?n.set(this):rr.propHooks._default.set(this),this}},rr.prototype.init.prototype=rr.prototype,rr.propHooks={_default:{get:function(e){var t;return null==e.elem[e.prop]||e.elem.style&&null!=e.elem.style[e.prop]?(t=x.css(e.elem,e.prop,""),t&&"auto"!==t?t:0):e.elem[e.prop]},set:function(e){x.fx.step[e.prop]?x.fx.step[e.prop](e):e.elem.style&&(null!=e.elem.style[x.cssProps[e.prop]]||x.cssHooks[e.prop])?x.style(e.elem,e.prop,e.now+e.unit):e.elem[e.prop]=e.now}}},rr.propHooks.scrollTop=rr.propHooks.scrollLeft={set:function(e){e.elem.nodeType&&e.elem.parentNode&&(e.elem[e.prop]=e.now)}},x.each(["toggle","show","hide"],function(e,t){var n=x.fn[t];x.fn[t]=function(e,r,i){return null==e||"boolean"==typeof e?n.apply(this,arguments):this.animate(ir(t,!0),e,r,i)}}),x.fn.extend({fadeTo:function(e,t,n,r){return this.filter(nn).css("opacity",0).show().end().animate({opacity:t},e,n,r)},animate:function(e,t,n,r){var i=x.isEmptyObject(e),o=x.speed(t,n,r),a=function(){var t=er(this,x.extend({},e),o);(i||x._data(this,"finish"))&&t.stop(!0)};return a.finish=a,i||o.queue===!1?this.each(a):this.queue(o.queue,a)},stop:function(e,n,r){var i=function(e){var t=e.stop;delete e.stop,t(r)};return"string"!=typeof e&&(r=n,n=e,e=t),n&&e!==!1&&this.queue(e||"fx",[]),this.each(function(){var t=!0,n=null!=e&&e+"queueHooks",o=x.timers,a=x._data(this);if(n)a[n]&&a[n].stop&&i(a[n]);else for(n in a)a[n]&&a[n].stop&&Jn.test(n)&&i(a[n]);for(n=o.length;n--;)o[n].elem!==this||null!=e&&o[n].queue!==e||(o[n].anim.stop(r),t=!1,o.splice(n,1));(t||!r)&&x.dequeue(this,e)})},finish:function(e){return e!==!1&&(e=e||"fx"),this.each(function(){var t,n=x._data(this),r=n[e+"queue"],i=n[e+"queueHooks"],o=x.timers,a=r?r.length:0;for(n.finish=!0,x.queue(this,e,[]),i&&i.stop&&i.stop.call(this,!0),t=o.length;t--;)o[t].elem===this&&o[t].queue===e&&(o[t].anim.stop(!0),o.splice(t,1));for(t=0;a>t;t++)r[t]&&r[t].finish&&r[t].finish.call(this);delete n.finish})}});function ir(e,t){var n,r={height:e},i=0;for(t=t?1:0;4>i;i+=2-t)n=Zt[i],r["margin"+n]=r["padding"+n]=e;return t&&(r.opacity=r.width=e),r}x.each({slideDown:ir("show"),slideUp:ir("hide"),slideToggle:ir("toggle"),fadeIn:{opacity:"show"},fadeOut:{opacity:"hide"},fadeToggle:{opacity:"toggle"}},function(e,t){x.fn[e]=function(e,n,r){return this.animate(t,e,n,r)}}),x.speed=function(e,t,n){var r=e&&"object"==typeof e?x.extend({},e):{complete:n||!n&&t||x.isFunction(e)&&e,duration:e,easing:n&&t||t&&!x.isFunction(t)&&t};return r.duration=x.fx.off?0:"number"==typeof r.duration?r.duration:r.duration in x.fx.speeds?x.fx.speeds[r.duration]:x.fx.speeds._default,(null==r.queue||r.queue===!0)&&(r.queue="fx"),r.old=r.complete,r.complete=function(){x.isFunction(r.old)&&r.old.call(this),r.queue&&x.dequeue(this,r.queue)},r},x.easing={linear:function(e){return e},swing:function(e){return.5-Math.cos(e*Math.PI)/2}},x.timers=[],x.fx=rr.prototype.init,x.fx.tick=function(){var e,n=x.timers,r=0;for(Xn=x.now();n.length>r;r++)e=n[r],e()||n[r]!==e||n.splice(r--,1);n.length||x.fx.stop(),Xn=t},x.fx.timer=function(e){e()&&x.timers.push(e)&&x.fx.start()},x.fx.interval=13,x.fx.start=function(){Un||(Un=setInterval(x.fx.tick,x.fx.interval))},x.fx.stop=function(){clearInterval(Un),Un=null},x.fx.speeds={slow:600,fast:200,_default:400},x.fx.step={},x.expr&&x.expr.filters&&(x.expr.filters.animated=function(e){return x.grep(x.timers,function(t){return e===t.elem}).length}),x.fn.offset=function(e){if(arguments.length)return e===t?this:this.each(function(t){x.offset.setOffset(this,e,t)});var n,r,o={top:0,left:0},a=this[0],s=a&&a.ownerDocument;if(s)return n=s.documentElement,x.contains(n,a)?(typeof a.getBoundingClientRect!==i&&(o=a.getBoundingClientRect()),r=or(s),{top:o.top+(r.pageYOffset||n.scrollTop)-(n.clientTop||0),left:o.left+(r.pageXOffset||n.scrollLeft)-(n.clientLeft||0)}):o},x.offset={setOffset:function(e,t,n){var r=x.css(e,"position");"static"===r&&(e.style.position="relative");var i=x(e),o=i.offset(),a=x.css(e,"top"),s=x.css(e,"left"),l=("absolute"===r||"fixed"===r)&&x.inArray("auto",[a,s])>-1,u={},c={},p,f;l?(c=i.position(),p=c.top,f=c.left):(p=parseFloat(a)||0,f=parseFloat(s)||0),x.isFunction(t)&&(t=t.call(e,n,o)),null!=t.top&&(u.top=t.top-o.top+p),null!=t.left&&(u.left=t.left-o.left+f),"using"in t?t.using.call(e,u):i.css(u)}},x.fn.extend({position:function(){if(this[0]){var e,t,n={top:0,left:0},r=this[0];return"fixed"===x.css(r,"position")?t=r.getBoundingClientRect():(e=this.offsetParent(),t=this.offset(),x.nodeName(e[0],"html")||(n=e.offset()),n.top+=x.css(e[0],"borderTopWidth",!0),n.left+=x.css(e[0],"borderLeftWidth",!0)),{top:t.top-n.top-x.css(r,"marginTop",!0),left:t.left-n.left-x.css(r,"marginLeft",!0)}}},offsetParent:function(){return this.map(function(){var e=this.offsetParent||s;while(e&&!x.nodeName(e,"html")&&"static"===x.css(e,"position"))e=e.offsetParent;return e||s})}}),x.each({scrollLeft:"pageXOffset",scrollTop:"pageYOffset"},function(e,n){var r=/Y/.test(n);x.fn[e]=function(i){return x.access(this,function(e,i,o){var a=or(e);return o===t?a?n in a?a[n]:a.document.documentElement[i]:e[i]:(a?a.scrollTo(r?x(a).scrollLeft():o,r?o:x(a).scrollTop()):e[i]=o,t)},e,i,arguments.length,null)}});function or(e){return x.isWindow(e)?e:9===e.nodeType?e.defaultView||e.parentWindow:!1}x.each({Height:"height",Width:"width"},function(e,n){x.each({padding:"inner"+e,content:n,"":"outer"+e},function(r,i){x.fn[i]=function(i,o){var a=arguments.length&&(r||"boolean"!=typeof i),s=r||(i===!0||o===!0?"margin":"border");return x.access(this,function(n,r,i){var o;return x.isWindow(n)?n.document.documentElement["client"+e]:9===n.nodeType?(o=n.documentElement,Math.max(n.body["scroll"+e],o["scroll"+e],n.body["offset"+e],o["offset"+e],o["client"+e])):i===t?x.css(n,r,s):x.style(n,r,i,s)},n,a?i:t,a,null)}})}),x.fn.size=function(){return this.length},x.fn.andSelf=x.fn.addBack,"object"==typeof module&&module&&"object"==typeof module.exports?module.exports=x:(e.jQuery=e.$=x,"function"==typeof define&&define.amd&&define("jquery",[],function(){return x}))})(window);
diff --git a/2.0/docson/lib/jsonpointer.js b/2.0/docson/lib/jsonpointer.js
new file mode 100644
index 0000000..3a662e7
--- /dev/null
+++ b/2.0/docson/lib/jsonpointer.js
@@ -0,0 +1,343 @@
+/**
+ * @author Alexey Kuzmin <alex.s.kuzmin@gmail.com>
+ * @fileoverview JavaScript implementation of JSON Pointer.
+ * @see http://tools.ietf.org/html/rfc6901
+ */
+
+
+
+;(function() {
+ 'use strict';
+
+ /**
+ * List of special characters and their escape sequences.
+ * Special characters will be unescaped in order they are listed.
+ * Section 3 of spec.
+ * @type {Array.<Array.<string>>}
+ * @const
+ */
+ var SPECIAL_CHARACTERS = [
+ ['/', '~1'],
+ ['~', '~0']
+ ];
+
+
+ /**
+ * Tokens' separator in JSON pointer string.
+ * Section 3 of spec.
+ * @type {string}
+ * @const
+ */
+ var TOKENS_SEPARATOR = '/';
+
+
+ /**
+ * Prefix for error messages.
+ * @type {string}
+ * @const
+ */
+ var ERROR_MESSAGE_PREFIX = 'JSON Pointer: ';
+
+
+ /**
+ * Validates non-empty pointer string.
+ * @type {RegExp}
+ * @const
+ */
+ var NON_EMPTY_POINTER_REGEXP = /(\/[^\/]*)+/;
+
+
+ /**
+ * List of error messages.
+ * Please keep it in alphabetical order.
+ * @enum {string}
+ */
+ var ErrorMessage = {
+ HYPHEN_IS_NOT_SUPPORTED_IN_ARRAY_CONTEXT:
+ 'Implementation does not support "-" token for arrays.',
+ INVALID_DOCUMENT: 'JSON document is not valid.',
+ INVALID_DOCUMENT_TYPE: 'JSON document must be a string or object.',
+ INVALID_POINTER: 'Pointer is not valid.',
+ NON_NUMBER_TOKEN_IN_ARRAY_CONTEXT:
+ 'Non-number tokens cannot be used in array context.',
+ TOKEN_WITH_LEADING_ZERO_IN_ARRAY_CONTEXT:
+ 'Token with leading zero cannot be used in array context.'
+ };
+
+
+ /**
+ * Returns |target| object's value pointed by |opt_pointer|, returns undefined
+ * if |opt_pointer| points to non-existing value.
+ * If pointer is not provided, validates first argument and returns
+ * evaluator function that takes pointer as argument.
+ * @param {(string|Object|Array)} target Evaluation target.
+ * @param {string=} opt_pointer JSON Pointer string.
+ * @returns {*} Some value.
+ */
+ function getPointedValue(target, opt_pointer) {
+ // .get() method implementation.
+
+ // First argument must be either string or object.
+ if (isString(target)) {
+
+ // If string it must be valid JSON document.
+ try {
+ // Let's try to parse it as JSON.
+ target = JSON.parse(target);
+ }
+ catch (e) {
+ // If parsing failed, an exception will be thrown.
+ throw getError(ErrorMessage.INVALID_DOCUMENT);
+ }
+ }
+ else if (!isObject(target)) {
+ // If not object or string, an exception will be thrown.
+ throw getError(ErrorMessage.INVALID_DOCUMENT_TYPE);
+ }
+
+ // |target| is already parsed, let's create evaluator function for it.
+ var evaluator = createPointerEvaluator(target);
+
+ if (isUndefined(opt_pointer)) {
+ // If pointer was not provided, return evaluator function.
+ return evaluator;
+ }
+ else {
+ // If pointer is provided, return evaluation result.
+ return evaluator(opt_pointer);
+ }
+ }
+
+
+ /**
+ * Returns function that takes JSON Pointer as single argument
+ * and evaluates it in given |target| context.
+ * Returned function throws an exception if pointer is not valid
+ * or any error occurs during evaluation.
+ * @param {*} target Evaluation target.
+ * @returns {Function}
+ */
+ function createPointerEvaluator(target) {
+
+ // Use cache to store already received values.
+ var cache = {};
+
+ return function(pointer) {
+
+ if (!isValidJSONPointer(pointer)) {
+ // If it's not, an exception will be thrown.
+ throw getError(ErrorMessage.INVALID_POINTER);
+ }
+
+ // First, look up in the cache.
+ if (cache.hasOwnProperty(pointer)) {
+ // If cache entry exists, return it's value.
+ return cache[pointer];
+ }
+
+ // Now, when all arguments are valid, we can start evaluation.
+ // First of all, let's convert JSON pointer string to tokens list.
+ var tokensList = parsePointer(pointer);
+ var token;
+ var value = target;
+
+ // Evaluation will be continued till tokens list is not empty
+ // and returned value is not an undefined.
+ while (!isUndefined(value) && !isUndefined(token = tokensList.pop())) {
+ // Let's evaluate token in current context.
+ // `getValue()` might throw an exception, but we won't handle it.
+ value = getValue(value, token);
+ }
+
+ // Pointer evaluation is done, save value in the cache and return it.
+ cache[pointer] = value;
+ return value;
+ };
+ }
+
+
+ /**
+ * Returns true if given |pointer| is valid, returns false otherwise.
+ * @param {!string} pointer
+ * @returns {boolean} Whether pointer is valid.
+ */
+ function isValidJSONPointer(pointer) {
+ // Validates JSON pointer string.
+
+ if (!isString(pointer)) {
+ // If it's not a string, it obviously is not valid.
+ return false;
+ }
+
+ if ('' === pointer) {
+ // If it is string and is an empty string, it's valid.
+ return true;
+ }
+
+ // If it is non-empty string, it must match spec defined format.
+ // Check Section 3 of specification for concrete syntax.
+ return NON_EMPTY_POINTER_REGEXP.test(pointer);
+ }
+
+
+ /**
+ * Returns tokens list for given |pointer|. List is reversed, e.g.
+ * '/simple/path' -> ['path', 'simple']
+ * @param {!string} pointer JSON pointer string.
+ * @returns {Array} List of tokens.
+ */
+ function parsePointer(pointer) {
+ // Converts JSON pointer string into tokens list.
+
+ // Let's split pointer string by tokens' separator character.
+ // Also we will reverse resulting array to simplify it's further usage.
+ var tokens = pointer.split(TOKENS_SEPARATOR).reverse();
+
+ // Last item in resulting array is always an empty string,
+ // we don't need it, let's remove it.
+ tokens.pop();
+
+ // Now tokens' array is ready to use, let's return it.
+ return tokens;
+ }
+
+
+ /**
+ * Decodes all escape sequences in given |rawReferenceToken|.
+ * @param {!string} rawReferenceToken
+ * @returns {string} Unescaped reference token.
+ */
+ function unescapeReferenceToken(rawReferenceToken) {
+ // Unescapes reference token. See Section 3 of specification.
+
+ var referenceToken = rawReferenceToken;
+ var character;
+ var escapeSequence;
+ var replaceRegExp;
+
+ // Order of unescaping does matter.
+ // That's why an array is used here and not hash.
+ SPECIAL_CHARACTERS.forEach(function(pair) {
+ character = pair[0];
+ escapeSequence = pair[1];
+ replaceRegExp = new RegExp(escapeSequence, 'g');
+ referenceToken = referenceToken.replace(replaceRegExp, character);
+ });
+
+ return referenceToken;
+ }
+
+
+ /**
+ * Returns value pointed by |token| in evaluation |context|.
+ * Throws an exception if any error occurs.
+ * @param {*} context Current evaluation context.
+ * @param {!string} token Unescaped reference token.
+ * @returns {*} Some value or undefined if value if not found.
+ */
+ function getValue(context, token) {
+ // Reference token evaluation. See Section 4 of spec.
+
+ // First of all we should unescape all special characters in token.
+ token = unescapeReferenceToken(token);
+
+ // Further actions depend of context of evaluation.
+
+ if (isArray(context)) {
+ // In array context there are more strict requirements
+ // for token value.
+
+ if ('-' === token) {
+ // Token cannot be a "-" character,
+ // it has no sense in current implementation.
+ throw getError(ErrorMessage.HYPHEN_IS_NOT_SUPPORTED_IN_ARRAY_CONTEXT);
+ }
+ if (!isNumber(token)) {
+ // Token cannot be non-number.
+ throw getError(ErrorMessage.NON_NUMBER_TOKEN_IN_ARRAY_CONTEXT);
+ }
+ if (token.length > 1 && '0' === token[0]) {
+ // Token cannot be non-zero number with leading zero.
+ throw getError(ErrorMessage.TOKEN_WITH_LEADING_ZERO_IN_ARRAY_CONTEXT);
+ }
+ // If all conditions are met, simply return element
+ // with token's value index.
+ // It might be undefined, but it's ok.
+ return context[token];
+ }
+
+ if (isObject(context)) {
+ // In object context we can simply return element w/ key equal to token.
+ // It might be undefined, but it's ok.
+ return context[token];
+ }
+
+ // If context is not an array or an object,
+ // token evaluation is not possible.
+ // This is the expected situation and so we won't throw an error,
+ // undefined value is perfectly suitable here.
+ return;
+ }
+
+
+ /**
+ * Returns Error instance for throwing.
+ * @param {string} message Error message.
+ * @returns {Error}
+ */
+ function getError(message) {
+ return new Error(ERROR_MESSAGE_PREFIX + message);
+ }
+
+
+ function isObject(o) {
+ return 'object' === typeof o && null !== o;
+ }
+
+
+ function isArray(a) {
+ return Array.isArray(a);
+ }
+
+
+ function isNumber(n) {
+ return !isNaN(Number(n));
+ }
+
+
+ function isString(s) {
+ return 'string' === typeof s || s instanceof String;
+ }
+
+
+ function isUndefined(v) {
+ return 'undefined' === typeof v;
+ }
+
+
+ // Let's expose API to the world.
+
+ var jsonpointer = {
+ get: getPointedValue
+ };
+
+ if ('object' === typeof exports) {
+ // If `exports` is an object, we are in Node.js context.
+ // We are supposed to act as Node.js package.
+ module.exports = jsonpointer;
+ } else if ('function' === typeof define && define.amd) {
+ // If there is global function `define()` and `define.amd` is defined,
+ // we are supposed to act as AMD module.
+ define(function() {
+ return jsonpointer;
+ });
+ } else {
+ // Last resort.
+ // Let's create global `jsonpointer` object.
+ this.jsonpointer = jsonpointer;
+ }
+
+}).call((function() {
+ 'use strict';
+ return (typeof window !== 'undefined' ? window : global);
+})());
diff --git a/2.0/docson/lib/marked.js b/2.0/docson/lib/marked.js
new file mode 100644
index 0000000..da025bd
--- /dev/null
+++ b/2.0/docson/lib/marked.js
@@ -0,0 +1,1194 @@
+/*
+ * Copyright 2013 Laurent Bovet <laurent.bovet@windmaster.ch>
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+;(function() {
+
+ /**
+ * Block-Level Grammar
+ */
+
+ var block = {
+ newline: /^\n+/,
+ code: /^( {4}[^\n]+\n*)+/,
+ fences: noop,
+ hr: /^( *[-*_]){3,} *(?:\n+|$)/,
+ heading: /^ *(#{1,6}) *([^\n]+?) *#* *(?:\n+|$)/,
+ nptable: noop,
+ lheading: /^([^\n]+)\n *(=|-){2,} *(?:\n+|$)/,
+ blockquote: /^( *>[^\n]+(\n[^\n]+)*\n*)+/,
+ list: /^( *)(bull) [\s\S]+?(?:hr|\n{2,}(?! )(?!\1bull )\n*|\s*$)/,
+ html: /^ *(?:comment|closed|closing) *(?:\n{2,}|\s*$)/,
+ def: /^ *\[([^\]]+)\]: *<?([^\s>]+)>?(?: +["(]([^\n]+)[")])? *(?:\n+|$)/,
+ table: noop,
+ paragraph: /^((?:[^\n]+\n?(?!hr|heading|lheading|blockquote|tag|def))+)\n*/,
+ text: /^[^\n]+/
+ };
+
+ block.bullet = /(?:[*+-]|\d+\.)/;
+ block.item = /^( *)(bull) [^\n]*(?:\n(?!\1bull )[^\n]*)*/;
+ block.item = replace(block.item, 'gm')
+ (/bull/g, block.bullet)
+ ();
+
+ block.list = replace(block.list)
+ (/bull/g, block.bullet)
+ ('hr', /\n+(?=(?: *[-*_]){3,} *(?:\n+|$))/)
+ ();
+
+ block._tag = '(?!(?:'
+ + 'a|em|strong|small|s|cite|q|dfn|abbr|data|time|code'
+ + '|var|samp|kbd|sub|sup|i|b|u|mark|ruby|rt|rp|bdi|bdo'
+ + '|span|br|wbr|ins|del|img)\\b)\\w+(?!:/|@)\\b';
+
+ block.html = replace(block.html)
+ ('comment', /<!--[\s\S]*?-->/)
+ ('closed', /<(tag)[\s\S]+?<\/\1>/)
+ ('closing', /<tag(?:"[^"]*"|'[^']*'|[^'">])*?>/)
+ (/tag/g, block._tag)
+ ();
+
+ block.paragraph = replace(block.paragraph)
+ ('hr', block.hr)
+ ('heading', block.heading)
+ ('lheading', block.lheading)
+ ('blockquote', block.blockquote)
+ ('tag', '<' + block._tag)
+ ('def', block.def)
+ ();
+
+ /**
+ * Normal Block Grammar
+ */
+
+ block.normal = merge({}, block);
+
+ /**
+ * GFM Block Grammar
+ */
+
+ block.gfm = merge({}, block.normal, {
+ fences: /^ *(`{3,}|~{3,}) *(\S+)? *\n([\s\S]+?)\s*\1 *(?:\n+|$)/,
+ paragraph: /^/
+ });
+
+ block.gfm.paragraph = replace(block.paragraph)
+ ('(?!', '(?!'
+ + block.gfm.fences.source.replace('\\1', '\\2') + '|'
+ + block.list.source.replace('\\1', '\\3') + '|')
+ ();
+
+ /**
+ * GFM + Tables Block Grammar
+ */
+
+ block.tables = merge({}, block.gfm, {
+ nptable: /^ *(\S.*\|.*)\n *([-:]+ *\|[-| :]*)\n((?:.*\|.*(?:\n|$))*)\n*/,
+ table: /^ *\|(.+)\n *\|( *[-:]+[-| :]*)\n((?: *\|.*(?:\n|$))*)\n*/
+ });
+
+ /**
+ * Block Lexer
+ */
+
+ function Lexer(options) {
+ this.tokens = [];
+ this.tokens.links = {};
+ this.options = options || marked.defaults;
+ this.rules = block.normal;
+
+ if (this.options.gfm) {
+ if (this.options.tables) {
+ this.rules = block.tables;
+ } else {
+ this.rules = block.gfm;
+ }
+ }
+ }
+
+ /**
+ * Expose Block Rules
+ */
+
+ Lexer.rules = block;
+
+ /**
+ * Static Lex Method
+ */
+
+ Lexer.lex = function(src, options) {
+ var lexer = new Lexer(options);
+ return lexer.lex(src);
+ };
+
+ /**
+ * Preprocessing
+ */
+
+ Lexer.prototype.lex = function(src) {
+ src = src
+ .replace(/\r\n|\r/g, '\n')
+ .replace(/\t/g, ' ')
+ .replace(/\u00a0/g, ' ')
+ .replace(/\u2424/g, '\n');
+
+ return this.token(src, true);
+ };
+
+ /**
+ * Lexing
+ */
+
+ Lexer.prototype.token = function(src, top) {
+ var src = src.replace(/^ +$/gm, '')
+ , next
+ , loose
+ , cap
+ , bull
+ , b
+ , item
+ , space
+ , i
+ , l;
+
+ while (src) {
+ // newline
+ if (cap = this.rules.newline.exec(src)) {
+ src = src.substring(cap[0].length);
+ if (cap[0].length > 1) {
+ this.tokens.push({
+ type: 'space'
+ });
+ }
+ }
+
+ // code
+ if (cap = this.rules.code.exec(src)) {
+ src = src.substring(cap[0].length);
+ cap = cap[0].replace(/^ {4}/gm, '');
+ this.tokens.push({
+ type: 'code',
+ text: !this.options.pedantic
+ ? cap.replace(/\n+$/, '')
+ : cap
+ });
+ continue;
+ }
+
+ // fences (gfm)
+ if (cap = this.rules.fences.exec(src)) {
+ src = src.substring(cap[0].length);
+ this.tokens.push({
+ type: 'code',
+ lang: cap[2],
+ text: cap[3]
+ });
+ continue;
+ }
+
+ // heading
+ if (cap = this.rules.heading.exec(src)) {
+ src = src.substring(cap[0].length);
+ this.tokens.push({
+ type: 'heading',
+ depth: cap[1].length,
+ text: cap[2]
+ });
+ continue;
+ }
+
+ // table no leading pipe (gfm)
+ if (top && (cap = this.rules.nptable.exec(src))) {
+ src = src.substring(cap[0].length);
+
+ item = {
+ type: 'table',
+ header: cap[1].replace(/^ *| *\| *$/g, '').split(/ *\| */),
+ align: cap[2].replace(/^ *|\| *$/g, '').split(/ *\| */),
+ cells: cap[3].replace(/\n$/, '').split('\n')
+ };
+
+ for (i = 0; i < item.align.length; i++) {
+ if (/^ *-+: *$/.test(item.align[i])) {
+ item.align[i] = 'right';
+ } else if (/^ *:-+: *$/.test(item.align[i])) {
+ item.align[i] = 'center';
+ } else if (/^ *:-+ *$/.test(item.align[i])) {
+ item.align[i] = 'left';
+ } else {
+ item.align[i] = null;
+ }
+ }
+
+ for (i = 0; i < item.cells.length; i++) {
+ item.cells[i] = item.cells[i].split(/ *\| */);
+ }
+
+ this.tokens.push(item);
+
+ continue;
+ }
+
+ // lheading
+ if (cap = this.rules.lheading.exec(src)) {
+ src = src.substring(cap[0].length);
+ this.tokens.push({
+ type: 'heading',
+ depth: cap[2] === '=' ? 1 : 2,
+ text: cap[1]
+ });
+ continue;
+ }
+
+ // hr
+ if (cap = this.rules.hr.exec(src)) {
+ src = src.substring(cap[0].length);
+ this.tokens.push({
+ type: 'hr'
+ });
+ continue;
+ }
+
+ // blockquote
+ if (cap = this.rules.blockquote.exec(src)) {
+ src = src.substring(cap[0].length);
+
+ this.tokens.push({
+ type: 'blockquote_start'
+ });
+
+ cap = cap[0].replace(/^ *> ?/gm, '');
+
+ // Pass `top` to keep the current
+ // "toplevel" state. This is exactly
+ // how markdown.pl works.
+ this.token(cap, top);
+
+ this.tokens.push({
+ type: 'blockquote_end'
+ });
+
+ continue;
+ }
+
+ // list
+ if (cap = this.rules.list.exec(src)) {
+ src = src.substring(cap[0].length);
+ bull = cap[2];
+
+ this.tokens.push({
+ type: 'list_start',
+ ordered: bull.length > 1
+ });
+
+ // Get each top-level item.
+ cap = cap[0].match(this.rules.item);
+
+ next = false;
+ l = cap.length;
+ i = 0;
+
+ for (; i < l; i++) {
+ item = cap[i];
+
+ // Remove the list item's bullet
+ // so it is seen as the next token.
+ space = item.length;
+ item = item.replace(/^ *([*+-]|\d+\.) +/, '');
+
+ // Outdent whatever the
+ // list item contains. Hacky.
+ if (~item.indexOf('\n ')) {
+ space -= item.length;
+ item = !this.options.pedantic
+ ? item.replace(new RegExp('^ {1,' + space + '}', 'gm'), '')
+ : item.replace(/^ {1,4}/gm, '');
+ }
+
+ // Determine whether the next list item belongs here.
+ // Backpedal if it does not belong in this list.
+ if (this.options.smartLists && i !== l - 1) {
+ b = block.bullet.exec(cap[i + 1])[0];
+ if (bull !== b && !(bull.length > 1 && b.length > 1)) {
+ src = cap.slice(i + 1).join('\n') + src;
+ i = l - 1;
+ }
+ }
+
+ // Determine whether item is loose or not.
+ // Use: /(^|\n)(?! )[^\n]+\n\n(?!\s*$)/
+ // for discount behavior.
+ loose = next || /\n\n(?!\s*$)/.test(item);
+ if (i !== l - 1) {
+ next = item.charAt(item.length - 1) === '\n';
+ if (!loose) loose = next;
+ }
+
+ this.tokens.push({
+ type: loose
+ ? 'loose_item_start'
+ : 'list_item_start'
+ });
+
+ // Recurse.
+ this.token(item, false);
+
+ this.tokens.push({
+ type: 'list_item_end'
+ });
+ }
+
+ this.tokens.push({
+ type: 'list_end'
+ });
+
+ continue;
+ }
+
+ // html
+ if (cap = this.rules.html.exec(src)) {
+ src = src.substring(cap[0].length);
+ this.tokens.push({
+ type: this.options.sanitize
+ ? 'paragraph'
+ : 'html',
+ pre: cap[1] === 'pre' || cap[1] === 'script' || cap[1] === 'style',
+ text: cap[0]
+ });
+ continue;
+ }
+
+ // def
+ if (top && (cap = this.rules.def.exec(src))) {
+ src = src.substring(cap[0].length);
+ this.tokens.links[cap[1].toLowerCase()] = {
+ href: cap[2],
+ title: cap[3]
+ };
+ continue;
+ }
+
+ // table (gfm)
+ if (top && (cap = this.rules.table.exec(src))) {
+ src = src.substring(cap[0].length);
+
+ item = {
+ type: 'table',
+ header: cap[1].replace(/^ *| *\| *$/g, '').split(/ *\| */),
+ align: cap[2].replace(/^ *|\| *$/g, '').split(/ *\| */),
+ cells: cap[3].replace(/(?: *\| *)?\n$/, '').split('\n')
+ };
+
+ for (i = 0; i < item.align.length; i++) {
+ if (/^ *-+: *$/.test(item.align[i])) {
+ item.align[i] = 'right';
+ } else if (/^ *:-+: *$/.test(item.align[i])) {
+ item.align[i] = 'center';
+ } else if (/^ *:-+ *$/.test(item.align[i])) {
+ item.align[i] = 'left';
+ } else {
+ item.align[i] = null;
+ }
+ }
+
+ for (i = 0; i < item.cells.length; i++) {
+ item.cells[i] = item.cells[i]
+ .replace(/^ *\| *| *\| *$/g, '')
+ .split(/ *\| */);
+ }
+
+ this.tokens.push(item);
+
+ continue;
+ }
+
+ // top-level paragraph
+ if (top && (cap = this.rules.paragraph.exec(src))) {
+ src = src.substring(cap[0].length);
+ this.tokens.push({
+ type: 'paragraph',
+ text: cap[1].charAt(cap[1].length - 1) === '\n'
+ ? cap[1].slice(0, -1)
+ : cap[1]
+ });
+ continue;
+ }
+
+ // text
+ if (cap = this.rules.text.exec(src)) {
+ // Top-level should never reach here.
+ src = src.substring(cap[0].length);
+ this.tokens.push({
+ type: 'text',
+ text: cap[0]
+ });
+ continue;
+ }
+
+ if (src) {
+ throw new
+ Error('Infinite loop on byte: ' + src.charCodeAt(0));
+ }
+ }
+
+ return this.tokens;
+ };
+
+ /**
+ * Inline-Level Grammar
+ */
+
+ var inline = {
+ escape: /^\\([\\`*{}\[\]()#+\-.!_>])/,
+ autolink: /^<([^ >]+(@|:\/)[^ >]+)>/,
+ url: noop,
+ tag: /^<!--[\s\S]*?-->|^<\/?\w+(?:"[^"]*"|'[^']*'|[^'">])*?>/,
+ link: /^!?\[(inside)\]\(href\)/,
+ reflink: /^!?\[(inside)\]\s*\[([^\]]*)\]/,
+ nolink: /^!?\[((?:\[[^\]]*\]|[^\[\]])*)\]/,
+ strong: /^__([\s\S]+?)__(?!_)|^\*\*([\s\S]+?)\*\*(?!\*)/,
+ em: /^\b_((?:__|[\s\S])+?)_\b|^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,
+ code: /^(`+)\s*([\s\S]*?[^`])\s*\1(?!`)/,
+ br: /^ {2,}\n(?!\s*$)/,
+ del: noop,
+ text: /^[\s\S]+?(?=[\\<!\[_*`]| {2,}\n|$)/
+ };
+
+ inline._inside = /(?:\[[^\]]*\]|[^\[\]]|\](?=[^\[]*\]))*/;
+ inline._href = /\s*<?([\s\S]*?)>?(?:\s+['"]([\s\S]*?)['"])?\s*/;
+
+ inline.link = replace(inline.link)
+ ('inside', inline._inside)
+ ('href', inline._href)
+ ();
+
+ inline.reflink = replace(inline.reflink)
+ ('inside', inline._inside)
+ ();
+
+ /**
+ * Normal Inline Grammar
+ */
+
+ inline.normal = merge({}, inline);
+
+ /**
+ * Pedantic Inline Grammar
+ */
+
+ inline.pedantic = merge({}, inline.normal, {
+ strong: /^__(?=\S)([\s\S]*?\S)__(?!_)|^\*\*(?=\S)([\s\S]*?\S)\*\*(?!\*)/,
+ em: /^_(?=\S)([\s\S]*?\S)_(?!_)|^\*(?=\S)([\s\S]*?\S)\*(?!\*)/
+ });
+
+ /**
+ * GFM Inline Grammar
+ */
+
+ inline.gfm = merge({}, inline.normal, {
+ escape: replace(inline.escape)('])', '~|])')(),
+ url: /^(https?:\/\/[^\s<]+[^<.,:;"')\]\s])/,
+ del: /^~~(?=\S)([\s\S]*?\S)~~/,
+ text: replace(inline.text)
+ (']|', '~]|')
+ ('|', '|https?://|')
+ ()
+ });
+
+ /**
+ * GFM + Line Breaks Inline Grammar
+ */
+
+ inline.breaks = merge({}, inline.gfm, {
+ br: replace(inline.br)('{2,}', '*')(),
+ text: replace(inline.gfm.text)('{2,}', '*')()
+ });
+
+ /**
+ * Inline Lexer & Compiler
+ */
+
+ function InlineLexer(links, options) {
+ this.options = options || marked.defaults;
+ this.links = links;
+ this.rules = inline.normal;
+ this.renderer = this.options.renderer || new Renderer;
+
+ if (!this.links) {
+ throw new
+ Error('Tokens array requires a `links` property.');
+ }
+
+ if (this.options.gfm) {
+ if (this.options.breaks) {
+ this.rules = inline.breaks;
+ } else {
+ this.rules = inline.gfm;
+ }
+ } else if (this.options.pedantic) {
+ this.rules = inline.pedantic;
+ }
+ }
+
+ /**
+ * Expose Inline Rules
+ */
+
+ InlineLexer.rules = inline;
+
+ /**
+ * Static Lexing/Compiling Method
+ */
+
+ InlineLexer.output = function(src, links, options) {
+ var inline = new InlineLexer(links, options);
+ return inline.output(src);
+ };
+
+ /**
+ * Lexing/Compiling
+ */
+
+ InlineLexer.prototype.output = function(src) {
+ var out = ''
+ , link
+ , text
+ , href
+ , cap;
+
+ while (src) {
+ // escape
+ if (cap = this.rules.escape.exec(src)) {
+ src = src.substring(cap[0].length);
+ out += cap[1];
+ continue;
+ }
+
+ // autolink
+ if (cap = this.rules.autolink.exec(src)) {
+ src = src.substring(cap[0].length);
+ if (cap[2] === '@') {
+ text = cap[1].charAt(6) === ':'
+ ? this.mangle(cap[1].substring(7))
+ : this.mangle(cap[1]);
+ href = this.mangle('mailto:') + text;
+ } else {
+ text = escape(cap[1]);
+ href = text;
+ }
+ out += this.renderer.link(href, null, text);
+ continue;
+ }
+
+ // url (gfm)
+ if (cap = this.rules.url.exec(src)) {
+ src = src.substring(cap[0].length);
+ text = escape(cap[1]);
+ href = text;
+ out += this.renderer.link(href, null, text);
+ continue;
+ }
+
+ // tag
+ if (cap = this.rules.tag.exec(src)) {
+ src = src.substring(cap[0].length);
+ out += this.options.sanitize
+ ? escape(cap[0])
+ : cap[0];
+ continue;
+ }
+
+ // link
+ if (cap = this.rules.link.exec(src)) {
+ src = src.substring(cap[0].length);
+ out += this.outputLink(cap, {
+ href: cap[2],
+ title: cap[3]
+ });
+ continue;
+ }
+
+ // reflink, nolink
+ if ((cap = this.rules.reflink.exec(src))
+ || (cap = this.rules.nolink.exec(src))) {
+ src = src.substring(cap[0].length);
+ link = (cap[2] || cap[1]).replace(/\s+/g, ' ');
+ link = this.links[link.toLowerCase()];
+ if (!link || !link.href) {
+ out += cap[0].charAt(0);
+ src = cap[0].substring(1) + src;
+ continue;
+ }
+ out += this.outputLink(cap, link);
+ continue;
+ }
+
+ // strong
+ if (cap = this.rules.strong.exec(src)) {
+ src = src.substring(cap[0].length);
+ out += this.renderer.strong(this.output(cap[2] || cap[1]));
+ continue;
+ }
+
+ // em
+ if (cap = this.rules.em.exec(src)) {
+ src = src.substring(cap[0].length);
+ out += this.renderer.em(this.output(cap[2] || cap[1]));
+ continue;
+ }
+
+ // code
+ if (cap = this.rules.code.exec(src)) {
+ src = src.substring(cap[0].length);
+ out += this.renderer.codespan(escape(cap[2], true));
+ continue;
+ }
+
+ // br
+ if (cap = this.rules.br.exec(src)) {
+ src = src.substring(cap[0].length);
+ out += this.renderer.br();
+ continue;
+ }
+
+ // del (gfm)
+ if (cap = this.rules.del.exec(src)) {
+ src = src.substring(cap[0].length);
+ out += this.renderer.del(this.output(cap[1]));
+ continue;
+ }
+
+ // text
+ if (cap = this.rules.text.exec(src)) {
+ src = src.substring(cap[0].length);
+ out += escape(this.smartypants(cap[0]));
+ continue;
+ }
+
+ if (src) {
+ throw new
+ Error('Infinite loop on byte: ' + src.charCodeAt(0));
+ }
+ }
+
+ return out;
+ };
+
+ /**
+ * Compile Link
+ */
+
+ InlineLexer.prototype.outputLink = function(cap, link) {
+ var href = escape(link.href)
+ , title = link.title ? escape(link.title) : null;
+
+ if (cap[0].charAt(0) !== '!') {
+ return this.renderer.link(href, title, this.output(cap[1]));
+ } else {
+ return this.renderer.image(href, title, escape(cap[1]));
+ }
+ };
+
+ /**
+ * Smartypants Transformations
+ */
+
+ InlineLexer.prototype.smartypants = function(text) {
+ if (!this.options.smartypants) return text;
+ return text
+ // em-dashes
+ .replace(/--/g, '\u2014')
+ // opening singles
+ .replace(/(^|[-\u2014/(\[{"\s])'/g, '$1\u2018')
+ // closing singles & apostrophes
+ .replace(/'/g, '\u2019')
+ // opening doubles
+ .replace(/(^|[-\u2014/(\[{\u2018\s])"/g, '$1\u201c')
+ // closing doubles
+ .replace(/"/g, '\u201d')
+ // ellipses
+ .replace(/\.{3}/g, '\u2026');
+ };
+
+ /**
+ * Mangle Links
+ */
+
+ InlineLexer.prototype.mangle = function(text) {
+ var out = ''
+ , l = text.length
+ , i = 0
+ , ch;
+
+ for (; i < l; i++) {
+ ch = text.charCodeAt(i);
+ if (Math.random() > 0.5) {
+ ch = 'x' + ch.toString(16);
+ }
+ out += '&#' + ch + ';';
+ }
+
+ return out;
+ };
+
+ /**
+ * Renderer
+ */
+
+ function Renderer() {}
+
+ Renderer.prototype.code = function(code, lang) {
+ if (!lang) {
+ return '<pre><code>'
+ + escape(code, true)
+ + '\n</code></pre>';
+ }
+
+ return '<pre><code class="'
+ + 'lang-'
+ + lang
+ + '">'
+ + escape(code)
+ + '\n</code></pre>\n';
+ };
+
+ Renderer.prototype.blockquote = function(quote) {
+ return '<blockquote>\n' + quote + '</blockquote>\n';
+ };
+
+ Renderer.prototype.html = function(html) {
+ return html;
+ };
+
+ Renderer.prototype.heading = function(text, level, raw, options) {
+ return '<h'
+ + level
+ + '>'
+ + text
+ + '</h'
+ + level
+ + '>\n';
+ };
+
+ Renderer.prototype.hr = function() {
+ return '<hr>\n';
+ };
+
+ Renderer.prototype.list = function(body, ordered) {
+ var type = ordered ? 'ol' : 'ul';
+ return '<' + type + '>\n' + body + '</' + type + '>\n';
+ };
+
+ Renderer.prototype.listitem = function(text) {
+ return '<li>' + text + '</li>\n';
+ };
+
+ Renderer.prototype.paragraph = function(text) {
+ return '<p>' + text + '</p>\n';
+ };
+
+ Renderer.prototype.table = function(header, body) {
+ return '<table>\n'
+ + '<thead>\n'
+ + header
+ + '</thead>\n'
+ + '<tbody>\n'
+ + body
+ + '</tbody>\n'
+ + '</table>\n';
+ };
+
+ Renderer.prototype.tablerow = function(content) {
+ return '<tr>\n' + content + '</tr>\n';
+ };
+
+ Renderer.prototype.tablecell = function(content, flags) {
+ var type = flags.header ? 'th' : 'td';
+ var tag = flags.align
+ ? '<' + type + ' style="text-align:' + flags.align + '">'
+ : '<' + type + '>';
+ return tag + content + '</' + type + '>\n';
+ };
+
+// span level renderer
+ Renderer.prototype.strong = function(text) {
+ return '<strong>' + text + '</strong>';
+ };
+
+ Renderer.prototype.em = function(text) {
+ return '<em>' + text + '</em>';
+ };
+
+ Renderer.prototype.codespan = function(text) {
+ return '<code>' + text + '</code>';
+ };
+
+ Renderer.prototype.br = function() {
+ return '<br>';
+ };
+
+ Renderer.prototype.del = function(text) {
+ return '<del>' + text + '</del>';
+ };
+
+ Renderer.prototype.link = function(href, title, text) {
+ var out = '<a href="' + href + '"';
+ if (title) {
+ out += ' title="' + title + '"';
+ }
+ out += '>' + text + '</a>';
+ return out;
+ };
+
+ Renderer.prototype.image = function(href, title, text) {
+ var out = '<img src="' + href + '" alt="' + text + '"';
+ if (title) {
+ out += ' title="' + title + '"';
+ }
+ out += '>';
+ return out;
+ };
+
+ /**
+ * Parsing & Compiling
+ */
+
+ function Parser(options) {
+ this.tokens = [];
+ this.token = null;
+ this.options = options || marked.defaults;
+ this.options.renderer = this.options.renderer || new Renderer;
+ this.renderer = this.options.renderer;
+ }
+
+ /**
+ * Static Parse Method
+ */
+
+ Parser.parse = function(src, options, renderer) {
+ var parser = new Parser(options, renderer);
+ return parser.parse(src);
+ };
+
+ /**
+ * Parse Loop
+ */
+
+ Parser.prototype.parse = function(src) {
+ this.inline = new InlineLexer(src.links, this.options, this.renderer);
+ this.tokens = src.reverse();
+
+ var out = '';
+ while (this.next()) {
+ out += this.tok();
+ }
+
+ return out;
+ };
+
+ /**
+ * Next Token
+ */
+
+ Parser.prototype.next = function() {
+ return this.token = this.tokens.pop();
+ };
+
+ /**
+ * Preview Next Token
+ */
+
+ Parser.prototype.peek = function() {
+ return this.tokens[this.tokens.length - 1] || 0;
+ };
+
+ /**
+ * Parse Text Tokens
+ */
+
+ Parser.prototype.parseText = function() {
+ var body = this.token.text;
+
+ while (this.peek().type === 'text') {
+ body += '\n' + this.next().text;
+ }
+
+ return this.inline.output(body);
+ };
+
+ /**
+ * Parse Current Token
+ */
+
+ Parser.prototype.tok = function() {
+ switch (this.token.type) {
+ case 'space': {
+ return '';
+ }
+ case 'hr': {
+ return this.renderer.hr();
+ }
+ case 'heading': {
+ return this.renderer.heading(
+ this.inline.output(this.token.text),
+ this.token.depth
+ );
+ }
+ case 'code': {
+ return this.renderer.code(this.token.text, this.token.lang);
+ }
+ case 'table': {
+ var header = ''
+ , body = ''
+ , i
+ , row
+ , cell
+ , flags
+ , j;
+
+ // header
+ cell = '';
+ for (i = 0; i < this.token.header.length; i++) {
+ flags = { header: true, align: this.token.align[i] };
+ cell += this.renderer.tablecell(
+ this.inline.output(this.token.header[i]),
+ { header: true, align: this.token.align[i] }
+ );
+ }
+ header += this.renderer.tablerow(cell);
+
+ for (i = 0; i < this.token.cells.length; i++) {
+ row = this.token.cells[i];
+
+ cell = '';
+ for (j = 0; j < row.length; j++) {
+ cell += this.renderer.tablecell(
+ this.inline.output(row[j]),
+ { header: false, align: this.token.align[j] }
+ );
+ }
+
+ body += this.renderer.tablerow(cell);
+ }
+ return this.renderer.table(header, body);
+ }
+ case 'blockquote_start': {
+ var body = '';
+
+ while (this.next().type !== 'blockquote_end') {
+ body += this.tok();
+ }
+
+ return this.renderer.blockquote(body);
+ }
+ case 'list_start': {
+ var body = ''
+ , ordered = this.token.ordered;
+
+ while (this.next().type !== 'list_end') {
+ body += this.tok();
+ }
+
+ return this.renderer.list(body, ordered);
+ }
+ case 'list_item_start': {
+ var body = '';
+
+ while (this.next().type !== 'list_item_end') {
+ body += this.token.type === 'text'
+ ? this.parseText()
+ : this.tok();
+ }
+
+ return this.renderer.listitem(body);
+ }
+ case 'loose_item_start': {
+ var body = '';
+
+ while (this.next().type !== 'list_item_end') {
+ body += this.tok();
+ }
+
+ return this.renderer.listitem(body);
+ }
+ case 'html': {
+ var html = !this.token.pre && !this.options.pedantic
+ ? this.inline.output(this.token.text)
+ : this.token.text;
+ return this.renderer.html(html);
+ }
+ case 'paragraph': {
+ return this.renderer.paragraph(this.inline.output(this.token.text));
+ }
+ case 'text': {
+ return this.renderer.paragraph(this.parseText());
+ }
+ }
+ };
+
+ /**
+ * Helpers
+ */
+
+ function escape(html, encode) {
+ return html
+ .replace(!encode ? /&(?!#?\w+;)/g : /&/g, '&')
+ .replace(/</g, '<')
+ .replace(/>/g, '>')
+ .replace(/"/g, '"')
+ .replace(/'/g, ''');
+ }
+
+ function replace(regex, opt) {
+ regex = regex.source;
+ opt = opt || '';
+ return function self(name, val) {
+ if (!name) return new RegExp(regex, opt);
+ val = val.source || val;
+ val = val.replace(/(^|[^\[])\^/g, '$1');
+ regex = regex.replace(name, val);
+ return self;
+ };
+ }
+
+ function noop() {}
+ noop.exec = noop;
+
+ function merge(obj) {
+ var i = 1
+ , target
+ , key;
+
+ for (; i < arguments.length; i++) {
+ target = arguments[i];
+ for (key in target) {
+ if (Object.prototype.hasOwnProperty.call(target, key)) {
+ obj[key] = target[key];
+ }
+ }
+ }
+
+ return obj;
+ }
+
+
+ /**
+ * Marked
+ */
+
+ function marked(src, opt, callback) {
+ if (callback || typeof opt === 'function') {
+ if (!callback) {
+ callback = opt;
+ opt = null;
+ }
+
+ opt = merge({}, marked.defaults, opt || {});
+
+ var highlight = opt.highlight
+ , tokens
+ , pending
+ , i = 0;
+
+ try {
+ tokens = Lexer.lex(src, opt)
+ } catch (e) {
+ return callback(e);
+ }
+
+ pending = tokens.length;
+
+ var done = function() {
+ var out, err;
+
+ try {
+ out = Parser.parse(tokens, opt);
+ } catch (e) {
+ err = e;
+ }
+
+ opt.highlight = highlight;
+
+ return err
+ ? callback(err)
+ : callback(null, out);
+ };
+
+ return done();
+ }
+ try {
+ if (opt) opt = merge({}, marked.defaults, opt);
+ return Parser.parse(Lexer.lex(src, opt), opt);
+ } catch (e) {
+ e.message += '\nPlease report this to https://github.com/chjj/marked.';
+ if ((opt || marked.defaults).silent) {
+ return '<p>An error occured:</p><pre>'
+ + escape(e.message + '', true)
+ + '</pre>';
+ }
+ throw e;
+ }
+ }
+
+ /**
+ * Options
+ */
+
+ marked.options =
+ marked.setOptions = function(opt) {
+ merge(marked.defaults, opt);
+ return marked;
+ };
+
+ marked.defaults = {
+ gfm: true,
+ tables: true,
+ breaks: false,
+ pedantic: false,
+ sanitize: false,
+ smartLists: false,
+ silent: false,
+ smartypants: false,
+ renderer: new Renderer
+ };
+
+ /**
+ * Expose
+ */
+
+ marked.Parser = Parser;
+ marked.parser = Parser.parse;
+
+ marked.Renderer = Renderer;
+
+ marked.Lexer = Lexer;
+ marked.lexer = Lexer.lex;
+
+ marked.InlineLexer = InlineLexer;
+ marked.inlineLexer = InlineLexer.output;
+
+ marked.parse = marked;
+
+ if (typeof exports === 'object') {
+ module.exports = marked;
+ } else if (typeof define === 'function' && define.amd) {
+ define(function() { return marked; });
+ } else {
+ this.marked = marked;
+ }
+
+}).call(function() {
+ return this || (typeof window !== 'undefined' ? window : global);
+ }());
diff --git a/2.0/docson/lib/require.js b/2.0/docson/lib/require.js
new file mode 100644
index 0000000..ee9999f
--- /dev/null
+++ b/2.0/docson/lib/require.js
@@ -0,0 +1,36 @@
+/*
+ RequireJS 2.1.9 Copyright (c) 2010-2012, The Dojo Foundation All Rights Reserved.
+ Available via the MIT or new BSD license.
+ see: http://github.com/jrburke/requirejs for details
+*/
+var requirejs,require,define;
+(function(Z){function H(b){return"[object Function]"===L.call(b)}function I(b){return"[object Array]"===L.call(b)}function y(b,c){if(b){var e;for(e=0;e<b.length&&(!b[e]||!c(b[e],e,b));e+=1);}}function M(b,c){if(b){var e;for(e=b.length-1;-1<e&&(!b[e]||!c(b[e],e,b));e-=1);}}function t(b,c){return ga.call(b,c)}function l(b,c){return t(b,c)&&b[c]}function F(b,c){for(var e in b)if(t(b,e)&&c(b[e],e))break}function Q(b,c,e,h){c&&F(c,function(c,j){if(e||!t(b,j))h&&"string"!==typeof c?(b[j]||(b[j]={}),Q(b[j],
+c,e,h)):b[j]=c});return b}function u(b,c){return function(){return c.apply(b,arguments)}}function aa(b){throw b;}function ba(b){if(!b)return b;var c=Z;y(b.split("."),function(b){c=c[b]});return c}function A(b,c,e,h){c=Error(c+"\nhttp://requirejs.org/docs/errors.html#"+b);c.requireType=b;c.requireModules=h;e&&(c.originalError=e);return c}function ha(b){function c(a,f,b){var d,m,c,g,e,h,j,i=f&&f.split("/");d=i;var n=k.map,p=n&&n["*"];if(a&&"."===a.charAt(0))if(f){d=l(k.pkgs,f)?i=[f]:i.slice(0,i.length-
+1);f=a=d.concat(a.split("/"));for(d=0;f[d];d+=1)if(m=f[d],"."===m)f.splice(d,1),d-=1;else if(".."===m)if(1===d&&(".."===f[2]||".."===f[0]))break;else 0<d&&(f.splice(d-1,2),d-=2);d=l(k.pkgs,f=a[0]);a=a.join("/");d&&a===f+"/"+d.main&&(a=f)}else 0===a.indexOf("./")&&(a=a.substring(2));if(b&&n&&(i||p)){f=a.split("/");for(d=f.length;0<d;d-=1){c=f.slice(0,d).join("/");if(i)for(m=i.length;0<m;m-=1)if(b=l(n,i.slice(0,m).join("/")))if(b=l(b,c)){g=b;e=d;break}if(g)break;!h&&(p&&l(p,c))&&(h=l(p,c),j=d)}!g&&
+h&&(g=h,e=j);g&&(f.splice(0,e,g),a=f.join("/"))}return a}function e(a){z&&y(document.getElementsByTagName("script"),function(f){if(f.getAttribute("data-requiremodule")===a&&f.getAttribute("data-requirecontext")===i.contextName)return f.parentNode.removeChild(f),!0})}function h(a){var f=l(k.paths,a);if(f&&I(f)&&1<f.length)return f.shift(),i.require.undef(a),i.require([a]),!0}function $(a){var f,b=a?a.indexOf("!"):-1;-1<b&&(f=a.substring(0,b),a=a.substring(b+1,a.length));return[f,a]}function n(a,f,
+b,d){var m,B,g=null,e=f?f.name:null,h=a,j=!0,k="";a||(j=!1,a="_@r"+(L+=1));a=$(a);g=a[0];a=a[1];g&&(g=c(g,e,d),B=l(r,g));a&&(g?k=B&&B.normalize?B.normalize(a,function(a){return c(a,e,d)}):c(a,e,d):(k=c(a,e,d),a=$(k),g=a[0],k=a[1],b=!0,m=i.nameToUrl(k)));b=g&&!B&&!b?"_unnormalized"+(M+=1):"";return{prefix:g,name:k,parentMap:f,unnormalized:!!b,url:m,originalName:h,isDefine:j,id:(g?g+"!"+k:k)+b}}function q(a){var f=a.id,b=l(p,f);b||(b=p[f]=new i.Module(a));return b}function s(a,f,b){var d=a.id,m=l(p,
+d);if(t(r,d)&&(!m||m.defineEmitComplete))"defined"===f&&b(r[d]);else if(m=q(a),m.error&&"error"===f)b(m.error);else m.on(f,b)}function v(a,f){var b=a.requireModules,d=!1;if(f)f(a);else if(y(b,function(f){if(f=l(p,f))f.error=a,f.events.error&&(d=!0,f.emit("error",a))}),!d)j.onError(a)}function w(){R.length&&(ia.apply(G,[G.length-1,0].concat(R)),R=[])}function x(a){delete p[a];delete T[a]}function E(a,f,b){var d=a.map.id;a.error?a.emit("error",a.error):(f[d]=!0,y(a.depMaps,function(d,c){var g=d.id,
+e=l(p,g);e&&(!a.depMatched[c]&&!b[g])&&(l(f,g)?(a.defineDep(c,r[g]),a.check()):E(e,f,b))}),b[d]=!0)}function C(){var a,f,b,d,m=(b=1E3*k.waitSeconds)&&i.startTime+b<(new Date).getTime(),c=[],g=[],j=!1,l=!0;if(!U){U=!0;F(T,function(b){a=b.map;f=a.id;if(b.enabled&&(a.isDefine||g.push(b),!b.error))if(!b.inited&&m)h(f)?j=d=!0:(c.push(f),e(f));else if(!b.inited&&(b.fetched&&a.isDefine)&&(j=!0,!a.prefix))return l=!1});if(m&&c.length)return b=A("timeout","Load timeout for modules: "+c,null,c),b.contextName=
+i.contextName,v(b);l&&y(g,function(a){E(a,{},{})});if((!m||d)&&j)if((z||da)&&!V)V=setTimeout(function(){V=0;C()},50);U=!1}}function D(a){t(r,a[0])||q(n(a[0],null,!0)).init(a[1],a[2])}function J(a){var a=a.currentTarget||a.srcElement,b=i.onScriptLoad;a.detachEvent&&!W?a.detachEvent("onreadystatechange",b):a.removeEventListener("load",b,!1);b=i.onScriptError;(!a.detachEvent||W)&&a.removeEventListener("error",b,!1);return{node:a,id:a&&a.getAttribute("data-requiremodule")}}function K(){var a;for(w();G.length;){a=
+G.shift();if(null===a[0])return v(A("mismatch","Mismatched anonymous define() module: "+a[a.length-1]));D(a)}}var U,X,i,N,V,k={waitSeconds:7,baseUrl:"./",paths:{},pkgs:{},shim:{},config:{}},p={},T={},Y={},G=[],r={},S={},L=1,M=1;N={require:function(a){return a.require?a.require:a.require=i.makeRequire(a.map)},exports:function(a){a.usingExports=!0;if(a.map.isDefine)return a.exports?a.exports:a.exports=r[a.map.id]={}},module:function(a){return a.module?a.module:a.module={id:a.map.id,uri:a.map.url,config:function(){var b=
+l(k.pkgs,a.map.id);return(b?l(k.config,a.map.id+"/"+b.main):l(k.config,a.map.id))||{}},exports:r[a.map.id]}}};X=function(a){this.events=l(Y,a.id)||{};this.map=a;this.shim=l(k.shim,a.id);this.depExports=[];this.depMaps=[];this.depMatched=[];this.pluginMaps={};this.depCount=0};X.prototype={init:function(a,b,c,d){d=d||{};if(!this.inited){this.factory=b;if(c)this.on("error",c);else this.events.error&&(c=u(this,function(a){this.emit("error",a)}));this.depMaps=a&&a.slice(0);this.errback=c;this.inited=!0;
+this.ignore=d.ignore;d.enabled||this.enabled?this.enable():this.check()}},defineDep:function(a,b){this.depMatched[a]||(this.depMatched[a]=!0,this.depCount-=1,this.depExports[a]=b)},fetch:function(){if(!this.fetched){this.fetched=!0;i.startTime=(new Date).getTime();var a=this.map;if(this.shim)i.makeRequire(this.map,{enableBuildCallback:!0})(this.shim.deps||[],u(this,function(){return a.prefix?this.callPlugin():this.load()}));else return a.prefix?this.callPlugin():this.load()}},load:function(){var a=
+this.map.url;S[a]||(S[a]=!0,i.load(this.map.id,a))},check:function(){if(this.enabled&&!this.enabling){var a,b,c=this.map.id;b=this.depExports;var d=this.exports,m=this.factory;if(this.inited)if(this.error)this.emit("error",this.error);else{if(!this.defining){this.defining=!0;if(1>this.depCount&&!this.defined){if(H(m)){if(this.events.error&&this.map.isDefine||j.onError!==aa)try{d=i.execCb(c,m,b,d)}catch(e){a=e}else d=i.execCb(c,m,b,d);this.map.isDefine&&((b=this.module)&&void 0!==b.exports&&b.exports!==
+this.exports?d=b.exports:void 0===d&&this.usingExports&&(d=this.exports));if(a)return a.requireMap=this.map,a.requireModules=this.map.isDefine?[this.map.id]:null,a.requireType=this.map.isDefine?"define":"require",v(this.error=a)}else d=m;this.exports=d;if(this.map.isDefine&&!this.ignore&&(r[c]=d,j.onResourceLoad))j.onResourceLoad(i,this.map,this.depMaps);x(c);this.defined=!0}this.defining=!1;this.defined&&!this.defineEmitted&&(this.defineEmitted=!0,this.emit("defined",this.exports),this.defineEmitComplete=
+!0)}}else this.fetch()}},callPlugin:function(){var a=this.map,b=a.id,e=n(a.prefix);this.depMaps.push(e);s(e,"defined",u(this,function(d){var m,e;e=this.map.name;var g=this.map.parentMap?this.map.parentMap.name:null,h=i.makeRequire(a.parentMap,{enableBuildCallback:!0});if(this.map.unnormalized){if(d.normalize&&(e=d.normalize(e,function(a){return c(a,g,!0)})||""),d=n(a.prefix+"!"+e,this.map.parentMap),s(d,"defined",u(this,function(a){this.init([],function(){return a},null,{enabled:!0,ignore:!0})})),
+e=l(p,d.id)){this.depMaps.push(d);if(this.events.error)e.on("error",u(this,function(a){this.emit("error",a)}));e.enable()}}else m=u(this,function(a){this.init([],function(){return a},null,{enabled:!0})}),m.error=u(this,function(a){this.inited=!0;this.error=a;a.requireModules=[b];F(p,function(a){0===a.map.id.indexOf(b+"_unnormalized")&&x(a.map.id)});v(a)}),m.fromText=u(this,function(d,c){var e=a.name,g=n(e),B=O;c&&(d=c);B&&(O=!1);q(g);t(k.config,b)&&(k.config[e]=k.config[b]);try{j.exec(d)}catch(ca){return v(A("fromtexteval",
+"fromText eval for "+b+" failed: "+ca,ca,[b]))}B&&(O=!0);this.depMaps.push(g);i.completeLoad(e);h([e],m)}),d.load(a.name,h,m,k)}));i.enable(e,this);this.pluginMaps[e.id]=e},enable:function(){T[this.map.id]=this;this.enabling=this.enabled=!0;y(this.depMaps,u(this,function(a,b){var c,d;if("string"===typeof a){a=n(a,this.map.isDefine?this.map:this.map.parentMap,!1,!this.skipMap);this.depMaps[b]=a;if(c=l(N,a.id)){this.depExports[b]=c(this);return}this.depCount+=1;s(a,"defined",u(this,function(a){this.defineDep(b,
+a);this.check()}));this.errback&&s(a,"error",u(this,this.errback))}c=a.id;d=p[c];!t(N,c)&&(d&&!d.enabled)&&i.enable(a,this)}));F(this.pluginMaps,u(this,function(a){var b=l(p,a.id);b&&!b.enabled&&i.enable(a,this)}));this.enabling=!1;this.check()},on:function(a,b){var c=this.events[a];c||(c=this.events[a]=[]);c.push(b)},emit:function(a,b){y(this.events[a],function(a){a(b)});"error"===a&&delete this.events[a]}};i={config:k,contextName:b,registry:p,defined:r,urlFetched:S,defQueue:G,Module:X,makeModuleMap:n,
+nextTick:j.nextTick,onError:v,configure:function(a){a.baseUrl&&"/"!==a.baseUrl.charAt(a.baseUrl.length-1)&&(a.baseUrl+="/");var b=k.pkgs,c=k.shim,d={paths:!0,config:!0,map:!0};F(a,function(a,b){d[b]?"map"===b?(k.map||(k.map={}),Q(k[b],a,!0,!0)):Q(k[b],a,!0):k[b]=a});a.shim&&(F(a.shim,function(a,b){I(a)&&(a={deps:a});if((a.exports||a.init)&&!a.exportsFn)a.exportsFn=i.makeShimExports(a);c[b]=a}),k.shim=c);a.packages&&(y(a.packages,function(a){a="string"===typeof a?{name:a}:a;b[a.name]={name:a.name,
+location:a.location||a.name,main:(a.main||"main").replace(ja,"").replace(ea,"")}}),k.pkgs=b);F(p,function(a,b){!a.inited&&!a.map.unnormalized&&(a.map=n(b))});if(a.deps||a.callback)i.require(a.deps||[],a.callback)},makeShimExports:function(a){return function(){var b;a.init&&(b=a.init.apply(Z,arguments));return b||a.exports&&ba(a.exports)}},makeRequire:function(a,f){function h(d,c,e){var g,k;f.enableBuildCallback&&(c&&H(c))&&(c.__requireJsBuild=!0);if("string"===typeof d){if(H(c))return v(A("requireargs",
+"Invalid require call"),e);if(a&&t(N,d))return N[d](p[a.id]);if(j.get)return j.get(i,d,a,h);g=n(d,a,!1,!0);g=g.id;return!t(r,g)?v(A("notloaded",'Module name "'+g+'" has not been loaded yet for context: '+b+(a?"":". Use require([])"))):r[g]}K();i.nextTick(function(){K();k=q(n(null,a));k.skipMap=f.skipMap;k.init(d,c,e,{enabled:!0});C()});return h}f=f||{};Q(h,{isBrowser:z,toUrl:function(b){var f,e=b.lastIndexOf("."),g=b.split("/")[0];if(-1!==e&&(!("."===g||".."===g)||1<e))f=b.substring(e,b.length),b=
+b.substring(0,e);return i.nameToUrl(c(b,a&&a.id,!0),f,!0)},defined:function(b){return t(r,n(b,a,!1,!0).id)},specified:function(b){b=n(b,a,!1,!0).id;return t(r,b)||t(p,b)}});a||(h.undef=function(b){w();var c=n(b,a,!0),f=l(p,b);e(b);delete r[b];delete S[c.url];delete Y[b];f&&(f.events.defined&&(Y[b]=f.events),x(b))});return h},enable:function(a){l(p,a.id)&&q(a).enable()},completeLoad:function(a){var b,c,d=l(k.shim,a)||{},e=d.exports;for(w();G.length;){c=G.shift();if(null===c[0]){c[0]=a;if(b)break;b=
+!0}else c[0]===a&&(b=!0);D(c)}c=l(p,a);if(!b&&!t(r,a)&&c&&!c.inited){if(k.enforceDefine&&(!e||!ba(e)))return h(a)?void 0:v(A("nodefine","No define call for "+a,null,[a]));D([a,d.deps||[],d.exportsFn])}C()},nameToUrl:function(a,b,c){var d,e,h,g,i,n;if(j.jsExtRegExp.test(a))g=a+(b||"");else{d=k.paths;e=k.pkgs;g=a.split("/");for(i=g.length;0<i;i-=1)if(n=g.slice(0,i).join("/"),h=l(e,n),n=l(d,n)){I(n)&&(n=n[0]);g.splice(0,i,n);break}else if(h){a=a===h.name?h.location+"/"+h.main:h.location;g.splice(0,i,
+a);break}g=g.join("/");g+=b||(/^data\:|\?/.test(g)||c?"":".js");g=("/"===g.charAt(0)||g.match(/^[\w\+\.\-]+:/)?"":k.baseUrl)+g}return k.urlArgs?g+((-1===g.indexOf("?")?"?":"&")+k.urlArgs):g},load:function(a,b){j.load(i,a,b)},execCb:function(a,b,c,d){return b.apply(d,c)},onScriptLoad:function(a){if("load"===a.type||ka.test((a.currentTarget||a.srcElement).readyState))P=null,a=J(a),i.completeLoad(a.id)},onScriptError:function(a){var b=J(a);if(!h(b.id))return v(A("scripterror","Script error for: "+b.id,
+a,[b.id]))}};i.require=i.makeRequire();return i}var j,w,x,C,J,D,P,K,q,fa,la=/(\/\*([\s\S]*?)\*\/|([^:]|^)\/\/(.*)$)/mg,ma=/[^.]\s*require\s*\(\s*["']([^'"\s]+)["']\s*\)/g,ea=/\.js$/,ja=/^\.\//;w=Object.prototype;var L=w.toString,ga=w.hasOwnProperty,ia=Array.prototype.splice,z=!!("undefined"!==typeof window&&"undefined"!==typeof navigator&&window.document),da=!z&&"undefined"!==typeof importScripts,ka=z&&"PLAYSTATION 3"===navigator.platform?/^complete$/:/^(complete|loaded)$/,W="undefined"!==typeof opera&&
+"[object Opera]"===opera.toString(),E={},s={},R=[],O=!1;if("undefined"===typeof define){if("undefined"!==typeof requirejs){if(H(requirejs))return;s=requirejs;requirejs=void 0}"undefined"!==typeof require&&!H(require)&&(s=require,require=void 0);j=requirejs=function(b,c,e,h){var q,n="_";!I(b)&&"string"!==typeof b&&(q=b,I(c)?(b=c,c=e,e=h):b=[]);q&&q.context&&(n=q.context);(h=l(E,n))||(h=E[n]=j.s.newContext(n));q&&h.configure(q);return h.require(b,c,e)};j.config=function(b){return j(b)};j.nextTick="undefined"!==
+typeof setTimeout?function(b){setTimeout(b,4)}:function(b){b()};require||(require=j);j.version="2.1.9";j.jsExtRegExp=/^\/|:|\?|\.js$/;j.isBrowser=z;w=j.s={contexts:E,newContext:ha};j({});y(["toUrl","undef","defined","specified"],function(b){j[b]=function(){var c=E._;return c.require[b].apply(c,arguments)}});if(z&&(x=w.head=document.getElementsByTagName("head")[0],C=document.getElementsByTagName("base")[0]))x=w.head=C.parentNode;j.onError=aa;j.createNode=function(b){var c=b.xhtml?document.createElementNS("http://www.w3.org/1999/xhtml",
+"html:script"):document.createElement("script");c.type=b.scriptType||"text/javascript";c.charset="utf-8";c.async=!0;return c};j.load=function(b,c,e){var h=b&&b.config||{};if(z)return h=j.createNode(h,c,e),h.setAttribute("data-requirecontext",b.contextName),h.setAttribute("data-requiremodule",c),h.attachEvent&&!(h.attachEvent.toString&&0>h.attachEvent.toString().indexOf("[native code"))&&!W?(O=!0,h.attachEvent("onreadystatechange",b.onScriptLoad)):(h.addEventListener("load",b.onScriptLoad,!1),h.addEventListener("error",
+b.onScriptError,!1)),h.src=e,K=h,C?x.insertBefore(h,C):x.appendChild(h),K=null,h;if(da)try{importScripts(e),b.completeLoad(c)}catch(l){b.onError(A("importscripts","importScripts failed for "+c+" at "+e,l,[c]))}};z&&!s.skipDataMain&&M(document.getElementsByTagName("script"),function(b){x||(x=b.parentNode);if(J=b.getAttribute("data-main"))return q=J,s.baseUrl||(D=q.split("/"),q=D.pop(),fa=D.length?D.join("/")+"/":"./",s.baseUrl=fa),q=q.replace(ea,""),j.jsExtRegExp.test(q)&&(q=J),s.deps=s.deps?s.deps.concat(q):
+[q],!0});define=function(b,c,e){var h,j;"string"!==typeof b&&(e=c,c=b,b=null);I(c)||(e=c,c=null);!c&&H(e)&&(c=[],e.length&&(e.toString().replace(la,"").replace(ma,function(b,e){c.push(e)}),c=(1===e.length?["require"]:["require","exports","module"]).concat(c)));if(O){if(!(h=K))P&&"interactive"===P.readyState||M(document.getElementsByTagName("script"),function(b){if("interactive"===b.readyState)return P=b}),h=P;h&&(b||(b=h.getAttribute("data-requiremodule")),j=E[h.getAttribute("data-requirecontext")])}(j?
+j.defQueue:R).push([b,c,e])};define.amd={jQuery:!0};j.exec=function(b){return eval(b)};j(s)}})(this);
diff --git a/2.0/docson/lib/traverse.js b/2.0/docson/lib/traverse.js
new file mode 100644
index 0000000..bd2f937
--- /dev/null
+++ b/2.0/docson/lib/traverse.js
@@ -0,0 +1,345 @@
+/*
+ Copyright 2010 James Halliday (mail@substack.net)
+
+ This project is free software released under the MIT/X11 license:
+ http://www.opensource.org/licenses/mit-license.php
+
+ Copyright 2010 James Halliday (mail@substack.net)
+
+ Permission is hereby granted, free of charge, to any person obtaining a copy
+ of this software and associated documentation files (the "Software"), to deal
+ in the Software without restriction, including without limitation the rights
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ copies of the Software, and to permit persons to whom the Software is
+ furnished to do so, subject to the following conditions:
+
+ The above copyright notice and this permission notice shall be included in
+ all copies or substantial portions of the Software.
+
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+ THE SOFTWARE.
+ */
+
+var traverse;
+
+(function(){
+ traverse = function (obj) {
+ return new Traverse(obj);
+ };
+
+ function Traverse (obj) {
+ this.value = obj;
+ }
+
+ Traverse.prototype.get = function (ps) {
+ var node = this.value;
+ for (var i = 0; i < ps.length; i ++) {
+ var key = ps[i];
+ if (!node || !hasOwnProperty.call(node, key)) {
+ node = undefined;
+ break;
+ }
+ node = node[key];
+ }
+ return node;
+ };
+
+ Traverse.prototype.has = function (ps) {
+ var node = this.value;
+ for (var i = 0; i < ps.length; i ++) {
+ var key = ps[i];
+ if (!node || !hasOwnProperty.call(node, key)) {
+ return false;
+ }
+ node = node[key];
+ }
+ return true;
+ };
+
+ Traverse.prototype.set = function (ps, value) {
+ var node = this.value;
+ for (var i = 0; i < ps.length - 1; i ++) {
+ var key = ps[i];
+ if (!hasOwnProperty.call(node, key)) node[key] = {};
+ node = node[key];
+ }
+ node[ps[i]] = value;
+ return value;
+ };
+
+ Traverse.prototype.map = function (cb) {
+ return walk(this.value, cb, true);
+ };
+
+ Traverse.prototype.forEach = function (cb) {
+ this.value = walk(this.value, cb, false);
+ return this.value;
+ };
+
+ Traverse.prototype.reduce = function (cb, init) {
+ var skip = arguments.length === 1;
+ var acc = skip ? this.value : init;
+ this.forEach(function (x) {
+ if (!this.isRoot || !skip) {
+ acc = cb.call(this, acc, x);
+ }
+ });
+ return acc;
+ };
+
+ Traverse.prototype.paths = function () {
+ var acc = [];
+ this.forEach(function (x) {
+ acc.push(this.path);
+ });
+ return acc;
+ };
+
+ Traverse.prototype.nodes = function () {
+ var acc = [];
+ this.forEach(function (x) {
+ acc.push(this.node);
+ });
+ return acc;
+ };
+
+ Traverse.prototype.clone = function () {
+ var parents = [], nodes = [];
+
+ return (function clone (src) {
+ for (var i = 0; i < parents.length; i++) {
+ if (parents[i] === src) {
+ return nodes[i];
+ }
+ }
+
+ if (typeof src === 'object' && src !== null) {
+ var dst = copy(src);
+
+ parents.push(src);
+ nodes.push(dst);
+
+ forEach(objectKeys(src), function (key) {
+ dst[key] = clone(src[key]);
+ });
+
+ parents.pop();
+ nodes.pop();
+ return dst;
+ }
+ else {
+ return src;
+ }
+ })(this.value);
+ };
+
+ function walk (root, cb, immutable) {
+ var path = [];
+ var parents = [];
+ var alive = true;
+
+ return (function walker (node_) {
+ var node = immutable ? copy(node_) : node_;
+ var modifiers = {};
+
+ var keepGoing = true;
+
+ var state = {
+ node : node,
+ node_ : node_,
+ path : [].concat(path),
+ parent : parents[parents.length - 1],
+ parents : parents,
+ key : path.slice(-1)[0],
+ isRoot : path.length === 0,
+ level : path.length,
+ circular : null,
+ update : function (x, stopHere) {
+ if (!state.isRoot) {
+ state.parent.node[state.key] = x;
+ }
+ state.node = x;
+ if (stopHere) keepGoing = false;
+ },
+ 'delete' : function (stopHere) {
+ delete state.parent.node[state.key];
+ if (stopHere) keepGoing = false;
+ },
+ remove : function (stopHere) {
+ if (isArray(state.parent.node)) {
+ state.parent.node.splice(state.key, 1);
+ }
+ else {
+ delete state.parent.node[state.key];
+ }
+ if (stopHere) keepGoing = false;
+ },
+ keys : null,
+ before : function (f) { modifiers.before = f },
+ after : function (f) { modifiers.after = f },
+ pre : function (f) { modifiers.pre = f },
+ post : function (f) { modifiers.post = f },
+ stop : function () { alive = false },
+ block : function () { keepGoing = false }
+ };
+
+ if (!alive) return state;
+
+ function updateState() {
+ if (typeof state.node === 'object' && state.node !== null) {
+ if (!state.keys || state.node_ !== state.node) {
+ state.keys = objectKeys(state.node)
+ }
+
+ state.isLeaf = state.keys.length == 0;
+
+ for (var i = 0; i < parents.length; i++) {
+ if (parents[i].node_ === node_) {
+ state.circular = parents[i];
+ break;
+ }
+ }
+ }
+ else {
+ state.isLeaf = true;
+ state.keys = null;
+ }
+
+ state.notLeaf = !state.isLeaf;
+ state.notRoot = !state.isRoot;
+ }
+
+ updateState();
+
+ // use return values to update if defined
+ var ret = cb.call(state, state.node);
+ if (ret !== undefined && state.update) state.update(ret);
+
+ if (modifiers.before) modifiers.before.call(state, state.node);
+
+ if (!keepGoing) return state;
+
+ if (typeof state.node == 'object'
+ && state.node !== null && !state.circular) {
+ parents.push(state);
+
+ updateState();
+
+ forEach(state.keys, function (key, i) {
+ path.push(key);
+
+ if (modifiers.pre) modifiers.pre.call(state, state.node[key], key);
+
+ var child = walker(state.node[key]);
+ if (immutable && hasOwnProperty.call(state.node, key)) {
+ state.node[key] = child.node;
+ }
+
+ child.isLast = i == state.keys.length - 1;
+ child.isFirst = i == 0;
+
+ if (modifiers.post) modifiers.post.call(state, child);
+
+ path.pop();
+ });
+ parents.pop();
+ }
+
+ if (modifiers.after) modifiers.after.call(state, state.node);
+
+ return state;
+ })(root).node;
+ }
+
+ function copy (src) {
+ if (typeof src === 'object' && src !== null) {
+ var dst;
+
+ if (isArray(src)) {
+ dst = [];
+ }
+ else if (isDate(src)) {
+ dst = new Date(src.getTime ? src.getTime() : src);
+ }
+ else if (isRegExp(src)) {
+ dst = new RegExp(src);
+ }
+ else if (isError(src)) {
+ dst = { message: src.message };
+ }
+ else if (isBoolean(src)) {
+ dst = new Boolean(src);
+ }
+ else if (isNumber(src)) {
+ dst = new Number(src);
+ }
+ else if (isString(src)) {
+ dst = new String(src);
+ }
+ else if (Object.create && Object.getPrototypeOf) {
+ dst = Object.create(Object.getPrototypeOf(src));
+ }
+ else if (src.constructor === Object) {
+ dst = {};
+ }
+ else {
+ var proto =
+ (src.constructor && src.constructor.prototype)
+ || src.__proto__
+ || {}
+ ;
+ var T = function () {};
+ T.prototype = proto;
+ dst = new T;
+ }
+
+ forEach(objectKeys(src), function (key) {
+ dst[key] = src[key];
+ });
+ return dst;
+ }
+ else return src;
+ }
+
+ var objectKeys = Object.keys || function keys (obj) {
+ var res = [];
+ for (var key in obj) res.push(key)
+ return res;
+ };
+
+ function toS (obj) { return Object.prototype.toString.call(obj) }
+ function isDate (obj) { return toS(obj) === '[object Date]' }
+ function isRegExp (obj) { return toS(obj) === '[object RegExp]' }
+ function isError (obj) { return toS(obj) === '[object Error]' }
+ function isBoolean (obj) { return toS(obj) === '[object Boolean]' }
+ function isNumber (obj) { return toS(obj) === '[object Number]' }
+ function isString (obj) { return toS(obj) === '[object String]' }
+
+ var isArray = Array.isArray || function isArray (xs) {
+ return Object.prototype.toString.call(xs) === '[object Array]';
+ };
+
+ var forEach = function (xs, fn) {
+ if (xs.forEach) return xs.forEach(fn)
+ else for (var i = 0; i < xs.length; i++) {
+ fn(xs[i], i, xs);
+ }
+ };
+
+ forEach(objectKeys(Traverse.prototype), function (key) {
+ traverse[key] = function (obj) {
+ var args = [].slice.call(arguments, 1);
+ var t = new Traverse(obj);
+ return t[key].apply(t, args);
+ };
+ });
+
+ var hasOwnProperty = Object.hasOwnProperty || function (obj, key) {
+ return key in obj;
+ };
+})();
diff --git a/2.0/docson/templates/box.html b/2.0/docson/templates/box.html
new file mode 100644
index 0000000..c39369d
--- /dev/null
+++ b/2.0/docson/templates/box.html
@@ -0,0 +1,157 @@
+{{!
+ Copyright 2013 Laurent Bovet (laurent.bovet@windmaster.ch)
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+}}
+{{#scope this}}
+ <div class="box">
+ <div class="box-header box-{{__boxId}}">
+ <div class="box-title" ref="{{__ref}}">
+ {{#name this}}<div class="box-name {{#if root}}title{{/if}}">{{__name}}</div>{{/name}}
+ <div class="box-description desc">{{desc this}}</div>
+ <div class="end"></div>
+ </div>
+ </div>
+ <div class="source-button button" title="Source">{}</div>
+ <div class="box-body">
+ <div class="expand-button button" title="Expand all">+</div>
+ {{#sub this}}
+ <div class="signature">
+ <div class="signature-header">
+ <div class="signature-type">
+ {{#primitive this}}
+ {{signature this null this}}
+ {{/primitive}}
+ {{#equals type "array"}}
+ {{signature this "array" items}}
+ {{/equals}}
+ {{#if allOf}}
+ {{signature this "all of" allOf}}
+ {{/if}}
+ {{#if anyOf}}
+ {{signature this "any of" anyOf}}
+ {{/if}}
+ {{#if oneOf}}
+ {{signature this "one of" oneOf}}
+ {{/if}}
+ {{#if not}}
+ {{signature this "not" not}}
+ {{/if}}
+ </div>
+ </div>
+ <div class="signature-box-container">
+ {{#boxes}}
+ <div class="box-container" boxid="{{__boxId}}">
+ {{schema this}}
+ </div>
+ {{/boxes}}
+ </div>
+ </div>
+ {{/sub}}
+ {{#if properties}}
+ {{#each properties}}
+ <div class="signature">
+ <div class="signature-header">
+ <div class="property-name {{#contains ../required @key}}required{{/contains}}">{{@key}}</div>
+ <div class="signature-type">
+ {{#main this}}
+ {{signature this null this}}
+ {{/main}}
+ {{#equals type "array"}}
+ {{signature this "array" items}}
+ {{/equals}}
+ {{#if allOf}}
+ {{signature this "all of" allOf}}
+ {{/if}}
+ {{#if anyOf}}
+ {{signature this "any of" anyOf}}
+ {{/if}}
+ {{#if oneOf}}
+ {{signature this "one of" oneOf}}
+ {{/if}}
+ {{#if additionalProperties}}
+ {{signature this "map" additionalProperties}}
+ {{/if}}
+ {{#if not}}
+ {{signature this "not" not}}
+ {{/if}}
+ </div>
+ <div class="signature-description desc">{{desc this}}</div>
+ </div>
+ <div class="signature-box-container">
+ {{#boxes}}
+ <div class="box-container" boxid="{{__boxId}}">
+ {{schema this}}
+ </div>
+ {{/boxes}}
+ </div>
+ </div>
+ {{/each}}
+ {{/if}}
+
+ {{#if patternProperties}}
+ {{#each patternProperties}}
+ <div class="signature">
+ <div class="signature-header">
+ <div class="property-name type-pattern">{{@key}}</div>
+ <div class="signature-type">
+ {{#main this}}
+ {{signature this null this}}
+ {{/main}}
+ {{#equals type "array"}}
+ {{signature this "array" items}}
+ {{/equals}}
+ {{#if allOf}}
+ {{signature this "all of" allOf}}
+ {{/if}}
+ {{#if anyOf}}
+ {{signature this "any of" anyOf}}
+ {{/if}}
+ {{#if oneOf}}
+ {{signature this "one of" oneOf}}
+ {{/if}}
+ {{#if not}}
+ {{signature this "not" not}}
+ {{/if}}
+ </div>
+ <div class="signature-description desc">{{desc this}}</div>
+ </div>
+ <div class="signature-box-container">
+ {{#boxes}}
+ <div class="box-container" boxid="{{__boxId}}">
+ {{schema this}}
+ </div>
+ {{/boxes}}
+ </div>
+ </div>
+ {{/each}}
+ {{/if}}
+
+ {{#if additionalProperties}}
+ <div class="signature">
+ <div class="signature-header">
+ <div class="property-name type-pattern">additional</div>
+ <div class="signature-type">
+ {{schema ../additionalProperties}}
+ </div>
+ </div>
+ </div>
+ {{/if}}
+ </div>
+ <div class="source">
+ <pre class="json-schema">
+{{source this}}</pre>
+ </div>
+</div>
+<div class="end"/>
+{{/scope}}
diff --git a/2.0/docson/templates/signature.html b/2.0/docson/templates/signature.html
new file mode 100644
index 0000000..8412dbc
--- /dev/null
+++ b/2.0/docson/templates/signature.html
@@ -0,0 +1,86 @@
+{{!
+ Copyright 2013 Laurent Bovet (laurent.bovet@windmaster.ch)
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+}}
+{{#if keyword}}
+ <span class="type-keyword">{{keyword}}{{range schema.minItems schema.maxItems 0 "" false false ".."}}</span>
+ {{#each schemas}}
+ <span class="type-keyword">{{enum this}}</span>
+ {{#simple this}}
+ <span class="signature-type-{{__type}}">
+ {{__type}}
+ </span>
+ <span class="type-keyword">
+ {{range minLength maxLength "" "" false false ".."}}{{range minimum maximum "-∞" "∞" exclusiveMinimum exclusiveMaximum ";"}}
+ </span>
+ {{/simple}}
+ {{#complex this}}
+ {{#box this}}
+ <span boxid="{{boxId}}" class="box-{{boxId}} signature-type-{{__type}} signature-button signature-type-expandable button">{{__type}}</span>
+ {{/box}}
+ {{/complex}}
+ {{#ref this}}
+ {{#box this}}
+ <span boxid="{{boxId}}" class="box-{{boxId}} signature-type-ref signature-button signature-type-expandable button">{{__name}}</span>
+ {{/box}}
+ {{/ref}}
+ {{#if pattern}}
+ <span class="type-pattern">/{{pattern}}/</span>
+ {{/if}}
+ {{#if enum}}
+ {{#each enum}}
+ <span class="type-enum">{{this}}</span>
+ {{/each}}
+ {{/if}}
+ {{#exists default}}
+ <span class="type-keyword">default</span>
+ <span class="type-default">{{__default}}</span>
+ {{/exists}}
+ {{/each}}
+{{/if}}
+{{#unless keyword}}
+ {{#each schemas}}
+ <span class="type-keyword">{{enum this}}</span>
+ {{#primitive this}}
+ <span class="signature-type-{{__type}}">
+ {{__type}}
+ </span>
+ <span class="type-keyword">
+ {{range minLength maxLength "" "" false false ".."}}{{range minimum maximum "-∞" "∞" exclusiveMinimum exclusiveMaximum ";"}}
+ </span>
+ {{/primitive}}
+ {{#ref this}}
+ {{#box this}}
+ <span boxid="{{boxId}}" class="box-{{boxId}} signature-type-ref signature-button signature-type-expandable button">{{__name}}</span>
+ {{/box}}
+ {{/ref}}
+ {{#obj this}}
+ {{#box this}}
+ <span boxid="{{boxId}}" class="box-{{boxId}} signature-type-{{__type}} signature-button signature-type-expandable button">{{__type}}</span>
+ {{/box}}
+ {{/obj}}
+ {{#if pattern}}
+ <span class="type-pattern">/{{pattern}}/</span>
+ {{/if}}
+ {{#if enum}}
+ {{#each enum}}
+ <span class="type-enum">{{this}}</span>
+ {{/each}}
+ {{/if}}
+ {{#exists default}}
+ <span class="type-keyword">default</span>
+ <span class="type-default">{{__default}}</span>
+ {{/exists}}
+ {{/each}}
+{{/unless}}
diff --git a/2.0/docson/widget.js b/2.0/docson/widget.js
new file mode 100644
index 0000000..4c5c0a8
--- /dev/null
+++ b/2.0/docson/widget.js
@@ -0,0 +1,48 @@
+/*
+ * Copyright 2013 Laurent Bovet <laurent.bovet@windmaster.ch>
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+var scripts = document.getElementsByTagName('script');
+var script = scripts[ scripts.length - 1 ];
+
+if (script.attributes["data-schema"]) {
+ var docson;
+ if (script.attributes["data-docson"]) {
+ docson = script.attributes["data-docson"].value;
+ } else {
+ docson = script.src.replace("widget.js", "index.html");
+ }
+ document.write("<iframe id='" + script.attributes["data-schema"].value +
+ "' style='padding: 0; border: 0; width:100%; background: transparent' src='" +
+ docson + "#" +
+ script.attributes["data-schema"].value + "'></iframe>");
+ function receiveMessage(event) {
+ console.log("<", event)
+ if (event.data.id && event.data.id == "docson") {
+ var frame = document.getElementById(event.data.url);
+ if(event.data.action == "resized") {
+ frame.height = event.data.height + 18;
+ }
+ if(event.data.action == "ready") {
+ console.log(frame.parentNode)
+ frame.contentWindow.postMessage({ id: "docson", font: window.getComputedStyle(frame.parentNode).fontFamily}, "*");
+ }
+ }
+
+ }
+ window.addEventListener("message", receiveMessage, false);
+} else {
+ alert("<p style='color:red'>Missing data-schema (url to schema)</p>")
+}
diff --git a/2.0/feed.xml b/2.0/feed.xml
new file mode 100644
index 0000000..a9a00b0
--- /dev/null
+++ b/2.0/feed.xml
@@ -0,0 +1,1609 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+ <channel>
+ <title>Eclipse Ditto Blog</title>
+ <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>Thu, 06 May 2021 12:03:56 +0000</pubDate>
+ <lastBuildDate>Thu, 06 May 2021 12:03:56 +0000</lastBuildDate>
+ <generator>Jekyll v3.6.2</generator>
+
+ <item>
+ <title>Announcing Eclipse Ditto Release 2.0.0</title>
+ <description><p>Today, ~1.5 years after release <a href="2019-12-12-release-announcement-100.html">1.0.0</a>, the Eclipse Ditto team is happy to
+announce the availability of Eclipse Ditto <a href="https://projects.eclipse.org/projects/iot.ditto/releases/2.0.0">2.0.0</a>.</p>
+
+<p>With the major version 2.0.0 the Ditto team removed technical debt and ended support for APIs which were deprecated
+long ago in order to have a better maintainable codebase. However some awesome new features are included as well.</p>
+
+<h2 id="adoption">Adoption</h2>
+
+<p>Companies are willing to show their adoption of Eclipse Ditto publicly: <a href="https://iot.eclipse.org/adopters/?#iot.ditto">https://iot.eclipse.org/adopters/?#iot.ditto</a></p>
+
+<p>From our various <a href="feedback.html">feedback channels</a> we however know of more adoption.<br />
+If you are making use of Eclipse Ditto, it would be great to show this by adding your company name to that list of
+known adopters.<br />
+In the end, that’s one main way of measuring the success of the project.</p>
+
+<h2 id="changelog">Changelog</h2>
+
+<p>The main improvements and additions of Ditto 2.0.0 are:</p>
+
+<ul>
+ <li>Merge/PATCH updates of digital twins</li>
+ <li>Configurable OpenID Connect / OAuth2.0 claim extraction to be used for authorization</li>
+ <li>Establishing connections to endpoints (via AMQP, MQTT, HTTP) utilizing a Ditto managed SSH tunnel</li>
+ <li>Addition of a DevOps API in order to retrieve all known connections</li>
+ <li>Expiring policy subjects + publishing of announcement message prior to expiry</li>
+ <li>Addition of policy actions in order to inject a policy subject based on a provided JWT</li>
+ <li>Built-in acknowledgement for search updates to have the option of twin updates with strong consistency of the search index</li>
+ <li>Restoring active connection faster after a hard restart of the Ditto cluster via automatic prioritization of connections</li>
+ <li>Support for LastWill/Testament + retain flag for MQTT connections</li>
+</ul>
+
+<p>The step to a major version was done because of the following breaking API changes:</p>
+
+<ul>
+ <li>Removal of “API version 1” (deprecated in <a href="release_notes_110.html#deprecations">Ditto 1.1.0</a>)
+from Ditto’s Java APIs + HTTP API</li>
+ <li>Removal of code in Java APIs marked as <code class="highlighter-rouge">@Deprecated</code></li>
+ <li>Binary incompatible changes to Java APIs</li>
+ <li>Restructuring of Ditto’s Maven modules in order to simplify/ease further development</li>
+</ul>
+
+<p>The following non-functional enhancements are also included:</p>
+
+<ul>
+ <li>Improvement of stability during rolling updates</li>
+ <li>Addition of sharding concept for Ditto internal pub/sub enabling connection of e.g. tens of thousands Websocket Wessions</li>
+ <li>Background cleanup improvements in order to have less impact on DB roundtrip times</li>
+ <li>Update of third party libraries (e.g. Akka)</li>
+ <li>Documentation of deployment via K3S</li>
+</ul>
+
+<p>Please have a look at the <a href="release_notes_200.html">2.0.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>The Ditto JavaScript client release was published on <a href="https://www.npmjs.com/~eclipse_ditto">npmjs.com</a>:</p>
+<ul>
+ <li><a href="https://www.npmjs.com/package/@eclipse-ditto/ditto-javascript-client-dom">@eclipse-ditto/ditto-javascript-client-dom</a></li>
+ <li><a href="https://www.npmjs.com/package/@eclipse-ditto/ditto-javascript-client-node">@eclipse-ditto/ditto-javascript-client-node</a></li>
+</ul>
+
+<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>
+
+<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>
+</description>
+ <pubDate>Thu, 06 May 2021 00:00:00 +0000</pubDate>
+ <link>https://www.eclipse.org/ditto/2021-05-06-release-announcement-200.html</link>
+ <guid isPermaLink="true">https://www.eclipse.org/ditto/2021-05-06-release-announcement-200.html</guid>
+
+ <category>blog</category>
+
+
+ </item>
+
+ <item>
+ <title>Support SSH tunneling for managed connections</title>
+ <description><p>With the upcoming release of Eclipse Ditto <strong>version 2.0.0</strong> it will be possible to</p>
+
+<h1 id="ssh-tunneling-for-managed-connections">SSH tunneling for managed connections</h1>
+<p>With the upcoming release of Eclipse Ditto version 2.0.0, managed connections support establishing
+an SSH tunnel, which is then used to connect to the actual target endpoint. This is useful when the target endpoint is
+not directly accessible. Currently, this feature is available for all connection types supported in Ditto, except for
+Kafka 2.x.</p>
+
+<p><img src="images/blog/2021-04-06-ssh-tunnel-for-managed-connections-shema.png" alt="Connection Overview" /></p>
+
+<p>For further information, see <a href="https://tools.ietf.org/html/rfc4254#section-7">Secure Shell (SSH) Connection Protocol, RFC4254</a></p>
+
+<h2 id="setting-up-connections-with-ssh-tunneling-in-ditto">Setting up connections with SSH tunneling in Ditto</h2>
+<p>When setting up a tunneled connection, the configuration must specify the <code class="highlighter-rouge">sshTunnel</code> section, which contains
+the necessary information to establish the SSH port forwarding. For authentication, password and public
+key are supported. Also, host validation using public key fingerprints are supported. The tunnel configuration does not
+affect the other parts of your connection configuration. If the feature is enabled the connection will establish an SSH
+tunnel and afterwards use this tunnel to connect to the desired endpoint. In case you later disable the SSH tunnel
+feature, the payload will be processed directly to the desired endpoint.</p>
+
+<h3 id="basic-authentication">Basic Authentication</h3>
+<p>When using basic authenticating the <code class="highlighter-rouge">sshTunnel</code> configuration should contain the <code class="highlighter-rouge">credentials.type</code> <code class="highlighter-rouge">plain</code>, as
+well as the <code class="highlighter-rouge">username</code> and <code class="highlighter-rouge">password</code> fields:</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">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"tunneled-connection"</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">"uri"</span><span class="p">:</span><span class="w"> </span><span class="s2">"tcp://mqtt.eclipseprojects.io: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="err">...</span><span class="w"> </span><span class="p">}],</span><span class="w">
+ </span><span class="s2">"sshTunnel"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"enabled"</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">"ssh://ssh-host:2222"</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">"plain"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"username"</span><span class="p">:</span><span class="w"> </span><span class="s2">"username"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"password"</span><span class="p">:</span><span class="w"> </span><span class="s2">"password"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"validateHost"</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">"knownHosts"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"MD5:e0:3a:34:1c:68:ed:c6:bc:7c:ca:a8:67:c7:45:2b:19"</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="authentication-with-public-key">Authentication with public key</h3>
+<p>On public key authentication the <code class="highlighter-rouge">credentials.type</code> is <code class="highlighter-rouge">public-key</code>. In addition to the <code class="highlighter-rouge">username</code> the <code class="highlighter-rouge">publicKey</code> and
+<code class="highlighter-rouge">privateKey</code> have to be provided. The public key must be provided as PEM-encoded key in <code class="highlighter-rouge">X.509</code> format. The private
+key must be provided as PEM-encoded key in unencrypted <code class="highlighter-rouge">PKCS8</code> format as specified by <a href="https://tools.ietf.org/html/rfc7468">RFC-7468</a>.</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">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"tunneled-connection"</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">"uri"</span><span class="p">:</span><span class="w"> </span><span class="s2">"tcp://mqtt.eclipseprojects.io: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="err">...</span><span class="w"> </span><span class="p">}],</span><span class="w">
+ </span><span class="s2">"sshTunnel"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"enabled"</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">"ssh://ssh-host:2222"</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">"public-key"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"username"</span><span class="p">:</span><span class="w"> </span><span class="s2">"username"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"publicKey"</span><span class="p">:</span><span class="w"> </span><span class="s2">"-----BEGIN PUBLIC KEY-----</span><span class="se">\n</span><span class="s2">MIIBIjANBgkqhkiG9.....</span><span class="se">\n</span><span class="s2">-----END PUBLIC KEY-----"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"privateKey"</span><span class="p">:</span><span class="w"> </span><span class="s2">"-----BEGIN PRIVATE KEY-----</span><span class="se">\n</span><span class="s2">MIIEvAIBADANBgkqhki....</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">"validateHost"</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">"knownHosts"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"MD5:e0:3a:34:1c:68:ed:c6:bc:7c:ca:a8:67:c7:45:2b:19"</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>The following command can be used to convert a standard OpenSSL key in PKCS1 format to the PKCS8 format accepted by Ditto:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>openssl pkcs8 -topk8 -nocrypt -in client-private.pem.key -out client-private.pem.pk8
+</code></pre></div></div>
+
+<h3 id="host-validation-using-public-key-fingerprints">Host validation using public key fingerprints</h3>
+<p>When <code class="highlighter-rouge">validateHost</code> is enabled, the host public key fingerprints are validated. They can be provided
+in the format the standard command line tool <code class="highlighter-rouge">ssh-keygen</code> produces them. The fingerprints are
+prefixed with an alias of the hash algorithm that was used to calculate the fingerprint. Ditto supports the following
+hash algorithms for public key fingerprints: <code class="highlighter-rouge">MD5</code>, <code class="highlighter-rouge">SHA1</code>, <code class="highlighter-rouge">SHA224</code>, <code class="highlighter-rouge">SHA256</code>, <code class="highlighter-rouge">SHA384</code> and <code class="highlighter-rouge">SHA512</code>. To generate a
+valid fingerprint with an <code class="highlighter-rouge">MD5</code> hash algorithm from the public key, following can be used:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ssh-keygen -lf id_rsa.pub -E md5
+</code></pre></div></div>
+
+<h2 id="feedback">Feedback?</h2>
+
+<p>Please <a href="feedback.html">get in touch</a> if you have feedback or questions regarding this new functionality.</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>
+</description>
+ <pubDate>Wed, 31 Mar 2021 00:00:00 +0000</pubDate>
+ <link>https://www.eclipse.org/ditto/2021-03-31-ssh-tunneling-for-managed-connections.html</link>
+ <guid isPermaLink="true">https://www.eclipse.org/ditto/2021-03-31-ssh-tunneling-for-managed-connections.html</guid>
+
+ <category>blog</category>
+
+ <category>architecture</category>
+
+ <category>connectivity</category>
+
+
+ </item>
+
+ <item>
+ <title>Use Eclipse Ditto with Azure IoT Hub as message broker</title>
+ <description><p>This blogpost is based upon Eclipse Ditto Version <strong>1.5.0</strong>, the Azure IoT Suite as of
+<strong>2021-03-19</strong> and the azure-iot-device-client version <strong>1.29.2</strong>.</p>
+
+<h1 id="connecting-devices-to-eclipse-ditto-via-azure-iot-hub">Connecting devices to Eclipse Ditto via Azure IoT Hub</h1>
+<p>This blog post elaborates on connecting and managing devices in Eclipse Ditto by using the Azure IoT Hub
+as a message broker.</p>
+
+<p><img src="images/blog/2021-03-22-azure-iot-hub-integration-overview.png" alt="Connection Overview" /></p>
+
+<p>The basic functionality that can be used at the time of creating this blogpost are:</p>
+
+<ul>
+ <li>[D2C] Sending telemetry data from the device to update its Ditto digital-twin representation.</li>
+ <li>[D2C] Same ID enforcement based on the Azure IoT Hub device-id to prevent spoofing other digital-twins.</li>
+ <li>[C2D] Sending live-messages to the device.</li>
+ <li>[D2C] Sending feedback to live messages to the service.</li>
+</ul>
+
+<h2 id="setting-up-connections-in-ditto">Setting up connections in Ditto</h2>
+<p>The features described above will work with an “out-of-the-box” Azure IoT Hub subscription,
+so no additional configuration is needed in the IoT Hub. In order to connect Ditto to the IoT Hub you have to set up
+two AMQP 1.0 connections. One for receiving telemetry data, the other for sending live-messages and receiving
+live-message feedback.</p>
+
+<h3 id="telemetry-connection">Telemetry Connection</h3>
+
+<p>This connection subscribes to telemetry messages, published by the Azure IoT Hub built-in “Event Hub like” endpoint.</p>
+
+<p>Adding an enforcement for the <code class="highlighter-rouge">{{ thing:id }}</code> based on the <code class="highlighter-rouge">{{ header:iothub-connection-device-id }}</code> prevents
+applying a digital-twin update to the twin of another device (Device Spoofing).</p>
+
+<p>To establish this connection the placeholders below have to be substituted by:</p>
+
+<ul>
+ <li>
+ <p><code class="highlighter-rouge">{{userName}}</code>: The <code class="highlighter-rouge">SharedAccessKeyName</code> in your Event Hub-compatible endpoint (i.e. service).</p>
+ </li>
+ <li>
+ <p><code class="highlighter-rouge">{{password}}</code>: The <code class="highlighter-rouge">SharedAccessKey</code> in your Event Hub-compatible endpoint.</p>
+ </li>
+ <li>
+ <p><code class="highlighter-rouge">{{endpoint}}</code>: The <code class="highlighter-rouge">Endpoint</code> in your Event Hub-compatible endpoint (Cut leading “sb://” and trailing slash,
+e.g.. ihsuprodblres055dednamespace.servicebus.windows.net).</p>
+ </li>
+ <li>
+ <p><code class="highlighter-rouge">{{entityPath}}</code>: The <code class="highlighter-rouge">EntitiyPath</code> in your Event Hub-compatible endpoint (e.g.. hubname-8584619-2e72252706).</p>
+ </li>
+</ul>
+
+<p><em>Note: You can use the “service” IoT Hub policy instead of the “iothubowner” policy, since this is more restricitve,
+and represents the actual use of Ditto as a northbound service.</em></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">"azure-example-connection-telemetry"</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">"amqp-10"</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">false</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">"amqps://{{userName}}:{{password}}@{{endpoint}}:5671"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"source"</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">"{{entityPath}}/ConsumerGroups/$Default/Partitions/0"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"{{entityPath}}/ConsumerGroups/$Default/Partitions/1"</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"</span><span class="p">],</span><span class="w">
+ </span><span class="s2">"enforcement"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"input"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ header:iothub-connection-device-id }}"</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="s2">"{{ thing:id }}"</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>
+<ul>
+ <li>
+ <p><a href="https://www.eclipse.org/ditto/connectivity-manage-connections.html">Further information on creating connections</a></p>
+ </li>
+ <li>
+ <p><a href="https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-devguide-messages-d2c">Further information on D2C messaging capabilities of Azure IoT Hub</a></p>
+ </li>
+ <li>
+ <p><a href="https://docs.microsoft.com/de-de/azure/iot-hub/iot-hub-devguide-messages-read-builtin">Further information on the built-in “event-hub like” endpoint of Azure IoT Hub</a></p>
+ </li>
+</ul>
+
+<h3 id="message-connection">Message connection</h3>
+
+<p>This connection enables forwarding live messages to the Azure IoT Hub (which forwards it to the device)
+and receiving feedback to these live-messages from the device.</p>
+
+<p>Adding the header-mapping <code class="highlighter-rouge">"message_id": "{{header:correlation-id}}"</code> enables Azure IoT Hub to correlate messages.
+Adding the header-mapping <code class="highlighter-rouge">"to": "/devices/{{ header:ditto-message-thing-id }}/messages/deviceInbound"</code> is
+necessary for correct message routing by Azure IoT Hub. The header <code class="highlighter-rouge">ditto-message-thing-id</code> will be set as a
+default header by Ditto.</p>
+
+<p>To establish this connection the placeholders below have to be substituted:</p>
+
+<ul>
+ <li>
+ <p><code class="highlighter-rouge">{{userName}}</code>: The name of the chosen IoT Hub policy + “@sas.root.” + the name of your IoT Hub
+(i.e. service@sas.root.my-hub).</p>
+ </li>
+ <li>
+ <p><code class="highlighter-rouge">{{hostName}}</code>: The Hostname of your IoT Hub (i.e. my-hub.azure-devices.net).</p>
+ </li>
+ <li>
+ <p><code class="highlighter-rouge">{{encodedSasToken}}</code>: An URL encoded SAS token. Information on how to generate a token can be found at
+<a href="https://docs.microsoft.com/en-us/cli/azure/ext/azure-iot/iot/hub?view=azure-cli-latest#ext_azure_iot_az_iot_hub_generate_sas_token">az iot hub generate-sas-token.</a>
+The generated token has to be additionally URL encoded (browser console -&gt; <code class="highlighter-rouge">encodeURI('{{generatedToken}}')</code>).</p>
+ </li>
+</ul>
+
+<p><em>Note: The generated SAS token has a maximum TTL of 365 days, so the token has to be changed to a newly generated before expiry.
+Otherwise, the connection tries to reconnect or closes automatically, when <code class="highlighter-rouge">failoverEnabled</code> is set to <code class="highlighter-rouge">false</code>.</em></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">"azure-example-connection-messages"</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">"amqp-10"</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">false</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">"amqps://{{userName}}:{{encodedSasToken}}@{{hostName}}:5671"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"target"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="p">{</span><span class="s2">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/messages/devicebound"</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/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"</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">"message_id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{header:correlation-id}}"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"to"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/devices/{{ header:ditto-message-thing-id }}/messages/deviceInbound"</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><strong>The java azure-iot-device-client currently can not be used to receive messages with JSON as body.
+Thus, the messages’ payload has to be byte-encoded.</strong></p>
+
+<p>This can be achieved by configuring an outgoing JavaScript payload mapper in the message connection:</p>
+<div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">function</span> <span class="nx">mapFromDittoProtocolMsg</span><span class="p">(</span>
+ <span class="nx">namespace</span><span class="p">,</span>
+ <span class="nx">name</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">headers</span> <span class="o">=</span> <span class="nx">dittoHeaders</span><span class="p">;</span>
+ <span class="kd">let</span> <span class="nx">textPayload</span> <span class="o">=</span> <span class="kc">null</span><span class="p">;</span>
+ <span class="kd">let</span> <span class="nx">bytePayload</span> <span class="o">=</span> <span class="nx">Ditto</span><span class="p">.</span><span class="nx">stringToArrayBuffer</span><span class="p">(</span><span class="nx">Ditto</span><span class="p">.</span><span class="nx">buildDittoProtocolMsg</span><span class="p">(</span><span class="nx">namespace</span><span class="p">,</span> <span class="nx">name</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">toString</span><span class="p">());</span>
+ <span class="kd">let</span> <span class="nx">contentType</span> <span class="o">=</span> <span class="s1">'application/octet-stream'</span><span class="p">;</span>
+
+ <span class="k">return</span> <span class="nx">Ditto</span><span class="p">.</span><span class="nx">buildExternalMsg</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>
+</code></pre></div></div>
+
+<ul>
+ <li>
+ <p><a href="https://www.eclipse.org/ditto/connectivity-manage-connections.html">Further information on creating connections</a></p>
+ </li>
+ <li>
+ <p><a href="https://www.eclipse.org/ditto/connectivity-mapping.html">Further information on payload-mapping</a></p>
+ </li>
+ <li>
+ <p><a href="https://docs.microsoft.com/de-de/azure/iot-hub/iot-hub-devguide-messages-c2d">Further information on C2D messaging capabilities of Azure IoT Hub</a></p>
+ </li>
+</ul>
+
+<h2 id="possible-improvements">Possible improvements</h2>
+
+<p>Some features of Ditto could be used in combination with Azure IoT Hub with some adjustments. These include:</p>
+
+<ul>
+ <li>Using the <code class="highlighter-rouge">ImplicitThingCreationMapper</code> to implicitly create a new thing when a new device is registered in Azure IoT Hub.</li>
+ <li>Using the ConnectionStatusMapper to update the ConnectionStatus of things, when their devices disconnect from Azure IoT Hub.</li>
+ <li>[C2D] Directly invoke methods on the device (Direct Method Invocation).</li>
+</ul>
+
+<h3 id="using-the-implicitthingcreation-and-connectionstatus-features-based-on-azure-iot-hub-events">Using the ImplicitThingCreation and ConnectionStatus features based on Azure IoT Hub events</h3>
+
+<p>Azure IoT Hub has the possibility to publish events for status changes of device connections and the creation/removal of new devices.
+These events are published via an Azure EventGrid to another chosen Azure application.
+By publishing these events to an Azure Event Hub, a Ditto AMQP connection can subscribe for them.</p>
+
+<p>The payload-mappers for <code class="highlighter-rouge">ImplicitThingCreation</code> and <code class="highlighter-rouge">ConnectionStatus</code> could be adjusted to handle such event messages and
+create new things or update the <code class="highlighter-rouge">ConnectionStatus</code> feature depending on the received messages.</p>
+
+<ul>
+ <li><a href="https://docs.microsoft.com/de-de/azure/event-grid/event-schema-iot-hub?tabs=event-grid-event-schema">Further information on the events published by Azure IoT Hub</a></li>
+</ul>
+
+<h3 id="using-direct-method-invocation">Using Direct Method Invocation</h3>
+
+<p>Azure IoT Hub provides an endpoint for directly invoking methods on a device. This can be compared to live-commands.
+Direct Method Invocation can only be done via HTTP. For authentication SAS has to be used.
+This authentication mechanism, however, is not yet implemented for HTTP Push of Eclipse Ditto
+connections.</p>
+
+<ul>
+ <li><a href="https://docs.microsoft.com/de-de/azure/iot-hub/iot-hub-devguide-direct-methods">Further information on direct method invocations</a></li>
+</ul>
+
+<h3 id="implementing-an-automatic-refresh-mechanism-for-sasl-tokens">Implementing an automatic refresh mechanism for SASL tokens</h3>
+
+<p>The <code class="highlighter-rouge">connectionString</code> provided by an Azure IoT Hub device’s policy could be used to generate and refresh a SASL token.
+This would require a new connection setting, which could store such a <code class="highlighter-rouge">connectionString</code>, and an algorithm, which can
+generate a SAS token out of that string.</p>
+
+<h2 id="getting-started">Getting started</h2>
+
+<p>To get started using Azure IoT Hub as a message broker for Eclipse Ditto, the
+<a href="https://github.com/eclipse/ditto-examples/tree/master/azure/azure-iot-hub-device-simulator">Azure IoT Hub Device Simulator Example</a>
+is a good entry point.</p>
+</description>
+ <pubDate>Mon, 22 Mar 2021 00:00:00 +0000</pubDate>
+ <link>https://www.eclipse.org/ditto/2021-03-22-azure-iot-hub-integration.html</link>
+ <guid isPermaLink="true">https://www.eclipse.org/ditto/2021-03-22-azure-iot-hub-integration.html</guid>
+
+ <category>blog</category>
+
+ <category>architecture</category>
+
+ <category>connectivity</category>
+
+
+ </item>
+
+ <item>
+ <title>Support merge functionality for things resources</title>
+ <description><p>With the upcoming release of Eclipse Ditto <strong>version 2.0.0</strong> it will be possible to merge existing things and their subresources.</p>
+
+<h2 id="merge-functionality-for-things-resources">Merge functionality for things resources</h2>
+<p>Ditto now supports merging of existing things and all of its subresources with the provided payload in the request.
+This can be done by using the HTTP API with the PATCH method, via the Ditto protocol, and also by using the Ditto Java Client.
+For all three ways there is an example provided in this blog post.</p>
+
+<p>In contrast to the already existing PUT resource, this new functionality <strong>allows partial updates</strong> on a thing and all its subresources.
+To get more into detail, from now on it is possible to add or update attributes, and a feature property at the same time,
+without overwriting the complete thing. Another use case might be to update several feature properties within a single request
+and let all other parts of the thing untouched.</p>
+
+<p>Ditto uses the <a href="https://tools.ietf.org/html/rfc7396">JSON Merge Patch</a> semantics to merge the request body
+with the existing thing. In short, a JSON merge patch resembles the original JSON structure of a thing, and
+the fields provided in the patch are added, updated, or deleted in the existing thing.</p>
+
+<p>Please be aware that <code class="highlighter-rouge">null</code> values have a special meaning when applying a merge patch. A <code class="highlighter-rouge">null</code> value indicates
+the removal of existing fields in the updated thing.
+For more details and examples, please refer to <a href="https://tools.ietf.org/html/rfc7396">RFC-7396</a>.</p>
+
+<h3 id="permissions-to-merge-things-and-things-subresources">Permissions to merge things and things subresources</h3>
+<p>In order to execute such a merge operation, the authorized subject needs to have WRITE permission at all resources
+that should change by the merge. Consequently, if the permission is missing for some part of the merge,
+the merge is rejected and <strong>not</strong> applied at all.</p>
+
+<h2 id="examples">Examples</h2>
+
+<p>To demonstrate the new merge feature, we assume that the following thing already exists:</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">"com.acme:coffeebrewer"</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:coffeebrewer-policy"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:coffeebrewer:0.1.0"</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 demo corp."</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">"Berlin, main floor"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"serialno"</span><span class="p">:</span><span class="w"> </span><span class="s2">"42"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"model"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Speaking coffee machine"</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">"coffee-brewer"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"com.acme:coffeebrewer:0.1.0"</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">"brewed-coffees"</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="s2">"water-tank"</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">"configuration"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"smartMode"</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">"brewingTemp"</span><span class="p">:</span><span class="w"> </span><span class="mi">87</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"tempToHold"</span><span class="p">:</span><span class="w"> </span><span class="mi">44</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"timeoutSeconds"</span><span class="p">:</span><span class="w"> </span><span class="mi">6000</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="p">{</span><span class="w">
+ </span><span class="s2">"waterAmount"</span><span class="p">:</span><span class="w"> </span><span class="mi">731</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">44</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>
+
+<h3 id="permissions-to-execute-the-example">Permissions to execute the example</h3>
+<p>For this example, the authorized subject needs to have unrestricted WRITE permissions on all affected paths
+of the JSON merge patch: <em>attributes/manufacturingYear</em>, <em>features/water-tank/properties/configuration/smartMode</em>, and
+<em>features/water-tank/properties/configuration/tempToHold</em>.
+The WRITE permission must not be revoked on any level further down the hierarchy.
+Consequently, it is also sufficient for the authorized subject to have unrestricted WRITE permission at root level or
+unrestricted WRITE permission at /attributes and /features etc.</p>
+
+<p>The following subparts will show how to use the merge feature via the HTTP API, the Ditto protocol
+and the Ditto Java Client.</p>
+
+<h3 id="merge-via-http-api">Merge via HTTP API</h3>
+<p>An existing thing can be merged via the HTTP API using the <em>PATCH</em> method with the following request body.
+Notice that this request will add the “manufacturingYear” to the attributes, update the “tempToHold” to 50 and
+delete the “smartMode” key from the feature property “water-tank”.</p>
+
+<p>The <code class="highlighter-rouge">Content-Type</code> header for this request must be <em>application/merge-patch+json</em>.</p>
+
+<p>PATCH /things/com.acme:coffeebrewer</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">"attributes"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"manufacturingYear"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2020"</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">"water-tank"</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">"configuration"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"smartMode"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"tempToHold"</span><span class="p">:</span><span class="w"> </span><span class="mi">50</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>After the request was successfully performed the thing will 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">"com.acme:coffeebrewer"</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:coffeebrewer-policy"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:coffeebrewer:0.1.0"</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 demo corp."</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"manufacturingYear"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2020"</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">"Berlin, main floor"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"serialno"</span><span class="p">:</span><span class="w"> </span><span class="s2">"42"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"model"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Speaking coffee machine"</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">"coffee-brewer"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"com.acme:coffeebrewer:0.1.0"</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">"brewed-coffees"</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="s2">"water-tank"</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">"configuration"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"brewingTemp"</span><span class="p">:</span><span class="w"> </span><span class="mi">87</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"tempToHold"</span><span class="p">:</span><span class="w"> </span><span class="mi">50</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"timeoutSeconds"</span><span class="p">:</span><span class="w"> </span><span class="mi">6000</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="p">{</span><span class="w">
+ </span><span class="s2">"waterAmount"</span><span class="p">:</span><span class="w"> </span><span class="mi">731</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">44</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>It is also possible to apply the <em>PATCH</em> method to all subresources of a thing, e.g. merging only the attributes of a thing. <br />
+Check out the newly added <em>PATCH</em> resources in our <a href="http-api-doc.html">HTTP API</a>.</p>
+
+<h3 id="merge-via-ditto-protocol">Merge via Ditto protocol</h3>
+<p>It is also possible to merge the existing thing via the Ditto protocol.
+Applying the following Ditto merge command to the existing thing will lead to the same result as in the above HTTP 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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/coffeebrewer/things/twin/commands/merge"</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/merge-patch+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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:coffeebrewer"</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">"manufacturingYear"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2020"</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">"water-tank"</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">"configuration"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"smartMode"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"tempToHold"</span><span class="p">:</span><span class="w"> </span><span class="mi">50</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>
+
+<p>Another Ditto protocol example to merge a feature property:</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/coffeebrewer/things/twin/commands/merge"</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/merge-patch+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">"/features/coffee-brewer/properties/brewed-coffees"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">42</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h3 id="using-the-ditto-client-to-merge-things">Using the ditto-client to merge things</h3>
+<p>The merge functionality is also supported via the <a href="client-sdk-java.html">Ditto Java Client</a>
+with the upcoming (<strong>Ditto Java Client version 2.0.0</strong>).</p>
+
+<p>Example for merging a thing with the Ditto Java Client:</p>
+
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">final</span> <span class="n">String</span> <span class="n">THING_ID</span> <span class="o">=</span> <span class="s">"com.acme:coffeebrewer"</span><span class="o">;</span>
+<span class="kd">final</span> <span class="n">String</span> <span class="n">FEATURE_ID</span> <span class="o">=</span> <span class="s">"water-tank"</span><span class="o">;</span>
+<span class="kd">final</span> <span class="n">JsonPointer</span> <span class="n">ATTRIBUTE_KEY</span> <span class="o">=</span> <span class="n">JsonFactory</span><span class="o">.</span><span class="na">newPointer</span><span class="o">(</span><span class="s">"manufacturingYear"</span><span class="o">);</span>
+<span class="kd">final</span> <span class="n">String</span> <span class="n">ATTRIBUTE_VALUE</span> <span class="o">=</span> <span class="s">"2020"</span><span class="o">;</span>
+<span class="kd">final</span> <span class="n">Feature</span> <span class="n">FEATURE</span> <span class="o">=</span> <span class="n">ThingsModelFactory</span><span class="o">.</span><span class="na">newFeatureBuilder</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">withId</span><span class="o">(</span><span class="n">FEATURE_ID</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">properties</span><span class="o">(</span><span class="n">ThingsModelFactory</span><span class="o">.</span><span class="na">newFeaturePropertiesBuilder</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">set</span><span class="o">(</span><span class="s">"smartMode"</span><span class="o">,</span> <span class="kc">false</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">set</span><span class="o">(</span><span class="s">"tempToHold"</span><span class="o">,</span> <span class="mi">50</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">build</span><span class="o">())</span>
+ <span class="o">.</span><span class="na">build</span><span class="o">();</span>
+
+<span class="kd">final</span> <span class="n">Thing</span> <span class="n">THING</span> <span class="o">=</span> <span class="n">ThingsModelFactory</span><span class="o">.</span><span class="na">newThingBuilder</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">setId</span><span class="o">(</span><span class="n">THING_ID</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">setAttribute</span><span class="o">(</span><span class="n">ATTRIBUTE_KEY_NEW</span><span class="o">,</span> <span class="n">JsonFactory</span><span class="o">.</span><span class="na">newValue</span><span class="o">(</span><span class="n">ATTRIBUTE_VALUE</span><span class="o">))</span>
+ <span class="o">.</span><span class="na">setFeature</span><span class="o">(</span><span class="n">FEATURE</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">build</span><span class="o">();</span>
+
+<span class="c1">// initialize the ditto-client</span>
+<span class="kd">final</span> <span class="n">DittoClient</span> <span class="n">dittoClient</span> <span class="o">=</span> <span class="o">...</span> <span class="o">;</span>
+
+<span class="n">dittoClient</span><span class="o">.</span><span class="na">twin</span><span class="o">().</span><span class="na">merge</span><span class="o">(</span><span class="n">THING_ID</span><span class="o">,</span> <span class="n">THING</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">whenComplete</span><span class="o">(((</span><span class="n">adaptable</span><span class="o">,</span> <span class="n">throwable</span><span class="o">)</span> <span class="o">-&gt;</span> <span class="o">{</span>
+ <span class="k">if</span> <span class="o">(</span><span class="n">throwable</span> <span class="o">!=</span> <span class="kc">null</span><span class="o">)</span> <span class="o">{</span>
+ <span class="n">LOGGER</span><span class="o">.</span><span class="na">error</span><span class="o">(</span><span class="s">"Received error while sending MergeThing: '{}' "</span><span class="o">,</span> <span class="n">throwable</span><span class="o">.</span><span class="na">toString</span><span class="o">());</span>
+ <span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
+ <span class="n">LOGGER</span><span class="o">.</span><span class="na">info</span><span class="o">(</span><span class="s">"Received response for MergeThing: '{}'"</span><span class="o">,</span> <span class="n">adaptable</span><span class="o">);</span>
+ <span class="o">}</span>
+ <span class="o">}));</span>
+</code></pre></div></div>
+
+<p>After running this code snippet, the existing thing should look like the above result for the HTTP example.</p>
+
+<p>More examples for merging an attribute, all attributes and a feature property via Ditto Java Client.</p>
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">// initialize the ditto-client</span>
+<span class="kd">final</span> <span class="n">DittoClient</span> <span class="n">dittoClient</span> <span class="o">=</span> <span class="o">...</span> <span class="o">;</span>
+
+ <span class="c1">// merge attribute</span>
+ <span class="n">dittoClient</span><span class="o">.</span><span class="na">twin</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">forId</span><span class="o">(</span><span class="s">"com.acme:coffeebrewer"</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">mergeAttribute</span><span class="o">(</span><span class="s">"manufacturingYear"</span><span class="o">,</span> <span class="s">"2021"</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">whenComplete</span><span class="o">(...);</span>
+
+ <span class="c1">// merge attributes</span>
+ <span class="n">dittoClient</span><span class="o">.</span><span class="na">twin</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">forId</span><span class="o">(</span><span class="s">"com.acme:coffeebrewer"</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">mergeAttributes</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="na">set</span><span class="o">(</span><span class="s">"manufacturingYear"</span><span class="o">,</span> <span class="s">"2021"</span><span class="o">).</span><span class="na">build</span><span class="o">())</span>
+ <span class="o">.</span><span class="na">whenComplete</span><span class="o">(...);</span>
+
+ <span class="c1">// merge feature property</span>
+ <span class="n">dittoClient</span><span class="o">.</span><span class="na">twin</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">forFeature</span><span class="o">(</span><span class="s">"com.acme:coffeebrewer"</span><span class="o">,</span> <span class="s">"water-tank"</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">mergeProperty</span><span class="o">(</span><span class="s">"configuration/smartMode"</span><span class="o">,</span> <span class="kc">false</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">whenComplete</span><span class="o">(...);</span>
+</code></pre></div></div>
+
+<h2 id="merge-events">Merge events</h2>
+<p>In this section we want to cover the new <code class="highlighter-rouge">ThingMerged</code> event which will be emitted after successfully applying an <code class="highlighter-rouge">MergeThing</code> command.
+For every HTTP request or Ditto protocol message which performs a merge operation on a thing there will be sent out
+exactly one <code class="highlighter-rouge">ThingMerged</code> event. This event contains the <strong>path</strong> and the <strong>value</strong> of the merge operation.
+The <strong>path</strong> describes on which level of the thing the <strong>value</strong> was merged.</p>
+
+<h3 id="merge-event-example">Merge event example</h3>
+<p>Let’s assume we want to patch/merge multiple feature properties at once.
+PATCH /things/com.acme:coffeebrewer/features</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">"coffee-brewer"</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">"brewed-coffees"</span><span class="p">:</span><span class="w"> </span><span class="mi">10</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"water-tank"</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">"configuration"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"smartMode"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"tempToHold"</span><span class="p">:</span><span class="w"> </span><span class="mi">30</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>The following <code class="highlighter-rouge">ThingMerged</code> event is emitted:</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/coffeebrewer/things/twin/events/merged"</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/merge-patch+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">"/features"</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">"coffee-brewer"</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">"brewed-coffees"</span><span class="p">:</span><span class="w"> </span><span class="mi">10</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"water-tank"</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">"configuration"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"smartMode"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"tempToHold"</span><span class="p">:</span><span class="w"> </span><span class="mi">30</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">"revision"</span><span class="p">:</span><span class="w"> </span><span class="mi">42</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"timestamp"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2021-02-04T09:42:39Z"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="feedback">Feedback?</h2>
+
+<p>Please <a href="feedback.html">get in touch</a> if you have feedback or questions towards this new functionality.</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>
+
+</description>
+ <pubDate>Thu, 04 Feb 2021 00:00:00 +0000</pubDate>
+ <link>https://www.eclipse.org/ditto/2021-02-04-merge-feature.html</link>
+ <guid isPermaLink="true">https://www.eclipse.org/ditto/2021-02-04-merge-feature.html</guid>
+
+ <category>blog</category>
+
+ <category>http</category>
+
+ <category>protocol</category>
+
+
+ </item>
+
+ <item>
+ <title>Policy actions: token based subject activation</title>
+ <description><p>The upcoming version of Eclipse Ditto <strong>2.0.0</strong> will be enhanced with the ability to
+<a href="basic-policy.html#actions">alter policies based on policy actions</a>.</p>
+
+<h2 id="policy-actions">Policy actions</h2>
+
+<p>This new concept of <a href="basic-policy.html#actions">Policy actions</a> allows upfront defined modifications to policies without
+the need for the one invoking the action to have “WRITE” permissions granted on the policy.</p>
+
+<h2 id="token-based-activation-of-subject">Token based activation of subject</h2>
+
+<p>Together with the concept of actions, a first action named
+<a href="basic-policy.html#action-activatetokenintegration"><code class="highlighter-rouge">activateTokenIntegration</code></a> is added.<br />
+This action</p>
+<ul>
+ <li>only works when using <a href="#" data-toggle="tooltip" data-original-title="JSON Web Token (JWT)">JWT</a>
+based authentication issued by Google or other OpenID Connect providers as
+<a href="installation-operating.html#openid-connect">documented in the installation/operation guide</a></li>
+ <li>checks whether the <a href="basic-auth.html#authenticated-subjects">authenticated subjects</a> which invoked the action have the
+permission to <code class="highlighter-rouge">EXECUTE</code> the action on a policy entry</li>
+ <li>checks whether the <a href="basic-auth.html#authenticated-subjects">authenticated subjects</a> which invoked the action have at
+least some kind of <code class="highlighter-rouge">READ</code> permission to any <code class="highlighter-rouge">thing:/</code> resource in a policy entry</li>
+</ul>
+
+<p>When all the conditions were met for a policy entry, the action will inject a new <a href="basic-policy.html#subjects">subject</a>
+into the matched policy entry which by default (the
+<a href="basic-policy.html#action-activatetokenintegration">pattern is configurable</a>) is the following.
+This syntax uses <a href="basic-placeholders.html">placeholders</a> in order to extract information from the authenticated JWT and
+the policy entry:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>
+integration:{{policy-entry:label}}:{{jwt:aud}}
+
+</code></pre></div></div>
+
+<p>The value of the injected subject will contain the <a href="basic-policy.html#expiring-policy-subjects">expiry</a> timestamp
+copied from the JWT <code class="highlighter-rouge">"exp"</code> (the expiration time of the token) claim.</p>
+
+<h2 id="example-use-case">Example use case</h2>
+
+<p>Assuming that you have configured a custom OpenID Connect provider <code class="highlighter-rouge">some-openid-connect-provider</code> as
+<a href="installation-operating.html#openid-connect">documented in the installation/operation guide</a>:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ditto.gateway.authentication {
+ oauth {
+ openid-connect-issuers = {
+ some-openid-connect-provider = "https://some-openid-connect-provider.com"
+ }
+ }
+}
+</code></pre></div></div>
+
+<p>Let’s describe our scenario:</p>
+<ul>
+ <li>It is required to enable that a Ditto <a href="basic-connections.html">connection</a> (e.g. an
+<a href="connectivity-protocol-bindings-http.html">HTTP connection</a> invoking an HTTP webhook) shall receive events whenever
+the temperature of a twin is modified</li>
+ <li>For security reasons however, the webhook shall not receive events longer than the expiration time of the JWT which
+was used in order to activate the webhook</li>
+ <li>The webhook can be extended by invoking the action again before the “expiry” time was reached</li>
+</ul>
+
+<p>The underlying <a href="basic-policy.html">policy</a> shall be the following one:</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">"policyId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"my.namespace:policy-a"</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">"owner"</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">"some-openid-connect-provider:some-admin-id"</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">"authenticated via OpenID connect provider &lt;some-openid-connect-provider&gt;"</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:/"</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="s2">"READ"</span><span class="p">,</span><span class="w"> </span><span class="s2">"WRITE"</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">"policy:/"</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="s2">"READ"</span><span class="p">,</span><span class="w"> </span><span class="s2">"WRITE"</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">"temperature-observer"</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">"some-openid-connect-provider:some-user-id"</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">"authenticated via OpenID connect provider &lt;some-openid-connect-provider&gt;"</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:/features/temperature"</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="s2">"READ"</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">"policy:/entries/temperature-observer/actions/activateTokenIntegration"</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="s2">"EXECUTE"</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>
+
+<p>The policy entry <code class="highlighter-rouge">"temperature-observer"</code> above describes that:</p>
+<ul>
+ <li>the user “some-user-id” may <code class="highlighter-rouge">READ</code> the <code class="highlighter-rouge">"temperature"</code> feature of things using this policy</li>
+ <li>is allowed to <code class="highlighter-rouge">EXECUTE</code> the <code class="highlighter-rouge">activateTokenIntegration</code> action in order to inject a subject derived from his provided
+JWT</li>
+</ul>
+
+<p>Let’s assume that the authenticated JWT used for executing the action contained the following claims:</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">"iss"</span><span class="p">:</span><span class="w"> </span><span class="s2">"https://some-openid-connect-provider.com"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"sub"</span><span class="p">:</span><span class="w"> </span><span class="s2">"some-user-id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"exp"</span><span class="p">:</span><span class="w"> </span><span class="mi">1622802633</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"aud"</span><span class="p">:</span><span class="w"> </span><span class="s2">"some-specific-audience-0815"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>The “exp” field contains the token expiry timestamp (seconds since epoch) and resolves to:
+<code class="highlighter-rouge">Friday, June 4, 2021 10:30:33 AM</code>.</p>
+
+<p>Once the HTTP API
+<a href="/http-api-doc.html#/Policies/post_policies__policyId__entries__label__actions_activateTokenIntegration">POST /api/2/policies/{policyId}/entries/{label}/actions/activateTokenIntegration</a>, with <code class="highlighter-rouge">policyId=my.namespace:policy-a</code> and <code class="highlighter-rouge">label=temperature-observer</code>,<br />
+is invoked (without any payload), a new subject will be injected when the
+<a href="basic-policy.html#action-activatetokenintegration">described prerequisites</a> were enforced successfully.</p>
+
+<p>As a simplification, all possible policy entries may be injected with the subject by invoking the top level action<br />
+<a href="/http-api-doc.html#/Policies/post_policies__policyId__actions_activateTokenIntegration">POST /api/2/policies/{policyId}/actions/activateTokenIntegration</a>, with <code class="highlighter-rouge">policyId=my.namespace:policy-a</code>.</p>
+
+<p>The value of the injected subject will contain the expiration timestamp from the JWT, so the injected policy subject
+<code class="highlighter-rouge">integration:temperature-observer:some-specific-audience-0815</code> will result in a modified policy:</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">"policyId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"my.namespace:policy-a"</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">"owner"</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="err">unchanged</span><span class="w"> </span><span class="err">...</span><span class="w"> </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"temperature-observer"</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">"some-openid-connect-provider:some-user-id"</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">"authenticated via OpenID connect provider &lt;some-openid-connect-provider&gt;"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"integration:temperature-observer:some-specific-audience-0815"</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">"added via action &lt;activateTokenIntegration&gt;"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"expiry"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2021-06-04T10:30:33Z"</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:/features/temperature"</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="s2">"READ"</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">"policy:/entries/temperature-observer/actions/activateTokenIntegration"</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="s2">"EXECUTE"</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>
+
+<p>When we now have a
+managed HTTP connection which <a href="basic-connections.html#authorization">configures the <code class="highlighter-rouge">authorizationContext</code></a> to include
+the subject <code class="highlighter-rouge">integration:temperature-observer:some-specific-audience-0815</code> for a
+<a href="basic-connections.html#targets">connection target</a>, this connection is allowed to publish changes to the temperature of
+all things using the above policy until the <code class="highlighter-rouge">"expiry"</code> timestamp was reached.<br />
+Afterwards, publishing changes automatically stops, unless the action is invoked again with a JWT having a longer “exp”
+time prolonging the injected policy subject.</p>
+
+<h2 id="feedback">Feedback?</h2>
+
+<p>Please <a href="feedback.html">get in touch</a> if you have feedback or questions towards this new token based subject activation
+for policies.<br />
+Or do you have other use cases in mind you might be able to solve with this feature? Please let us know.</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>
+</description>
+ <pubDate>Fri, 22 Jan 2021 00:00:00 +0000</pubDate>
+ <link>https://www.eclipse.org/ditto/2021-01-22-policy-subject-activate-token-integration.html</link>
+ <guid isPermaLink="true">https://www.eclipse.org/ditto/2021-01-22-policy-subject-activate-token-integration.html</guid>
+
+ <category>blog</category>
+
+
+ </item>
+
+ <item>
+ <title>Announcing Eclipse Ditto Release 1.5.0</title>
+ <description><p>Wrapping up this crazy year, the Ditto team is happy to announce the next feature update of Ditto <code class="highlighter-rouge">1.x</code>:
+<strong>Eclipse Ditto 1.5.0</strong></p>
+
+<p>1.5.0 focuses on:</p>
+
+<ul>
+ <li>Desired properties management (CRUD)</li>
+ <li>Addition of “cloudevents” HTTP endpoint</li>
+ <li>Ditto internal pub/sub supports using a “grouping” concept which improves Ditto’s scalability capabilities</li>
+ <li>Issuing “weak Acknowledgements” when a command requesting acks was filtered out by Ditto (improvement of “at least once” delivery scenarios)</li>
+ <li>Feature ID may be used in header mappings of connections</li>
+</ul>
+
+<p>Please have a look at the <a href="release_notes_150.html">1.5.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>
+</description>
+ <pubDate>Thu, 10 Dec 2020 00:00:00 +0000</pubDate>
+ <link>https://www.eclipse.org/ditto/2020-12-10-release-announcement-150.html</link>
+ <guid isPermaLink="true">https://www.eclipse.org/ditto/2020-12-10-release-announcement-150.html</guid>
+
+ <category>blog</category>
+
+
+ </item>
+
+ <item>
+ <title>Weak acknowledgments to decouple signal publishers and subscribers</title>
+ <description><h2 id="motivation">Motivation</h2>
+
+<p><a href="2020-08-31-release-announcement-120.html">Ditto 1.2.0</a> introduced at-least-once delivery via
+<a href="basic-acknowledgements.html">acknowledgement requests</a>.<br />
+It increased coupling between the publisher and the subscriber of signals in that the subscriber is no longer at the
+liberty to filter for signals it is interested in. Instead, the subscriber must consume all signals in order to
+fulfill acknowledgement requests and prevent endless redelivery.</p>
+
+<p>To combat the problem,
+<a href="2020-10-28-release-announcement-140.html">Ditto 1.4.0</a> made acknowledgement labels unique and introduced the requirement
+to manage <a href="basic-acknowledgements.html#issuing-acknowledgements"><em>declared acknowledgements</em></a>, identifying of each
+subscriber.<br />
+It is now possible for Ditto to issue
+<a href="basic-acknowledgements.html#weak-acknowledgements-wacks"><em>weak acknowledgements</em></a> on behalf of the subscriber
+whenever it decides to not consume a signal. That allows subscribers to configure RQL and namespace filters freely
+without causing any futile redelivery.</p>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Weak acknowledgements are available since Ditto 1.5.0.</div>
+
+<h2 id="what-it-is">What it is</h2>
+
+<p>A <a href="basic-acknowledgements.html#weak-acknowledgements-wacks"><em>weak acknowledgement</em></a> is issued by Ditto for any
+<a href="basic-acknowledgements.html#requesting-acks">acknowledgement request</a> that will not be fulfilled now or ever without
+configuration change.<br />
+A weak acknowledgement is identified by the header <code class="highlighter-rouge">ditto-weak-ack: true</code>.</p>
+
+<p>The status code of weak acknowledgements is <code class="highlighter-rouge">200 OK</code>; it signifies that any redelivery is not to be made on their
+account.</p>
+
+<p>A weak acknowledgement may look like this in Ditto protocol:</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/xdk_53/things/twin/acks/my-mqtt-connection:my-mqtt-topic"</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">"ditto-weak-ack"</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">"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">"Acknowledgement was issued automatically, because the subscriber is not authorized to receive the signal."</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>
+
+<h2 id="how-it-works">How it works</h2>
+
+<p>Since Ditto 1.4.0, subscribers of <em>twin events</em> or <em>live signals</em> are required to declare unique acknowledgement labels
+they are allowed to send. The labels of acknowledgement requests are then identifying the intended subscribers.<br />
+If the intended subscriber exists but does not receive the signal for non-transient reasons, Ditto issues
+a weak acknowledgement for that subscriber.<br />
+Such reasons may be:</p>
+<ul>
+ <li>The intended subscriber <strong>is not authorized</strong> to receive the signal by policy;</li>
+ <li>The intended subscriber did not subscribe for the signal type (<em>twin event, live command, live event or live message</em>);</li>
+ <li>The intended subscriber filtered the signal out by its <a href="basic-changenotifications.html#filtering">namespace or RQL filter</a>;</li>
+ <li>The intended subscriber dropped the signal because its <a href="connectivity-mapping.html">payload mapper</a> produced nothing.</li>
+</ul>
+
+<h2 id="limitation">Limitation</h2>
+
+<p>The distributed nature of cluster pub/sub means that weak acknowledgements are not always issued correctly.<br />
+They are only <em>eventually correct</em> in the sense that some time after a change to the publisher-subscriber pair,
+the issued weak acknowledgements will reflect the change.<br />
+Such changes include:</p>
+<ul>
+ <li>Opening and closing of Websocket or other connections acting as the subscriber;</li>
+ <li>Subscribing and unsubscribing for different signal types via Websocket;</li>
+ <li>Modification of connections via the <a href="connectivity-manage-connections.html">connectivity API</a>;</li>
+ <li>Migration of a connection from one Ditto cluster member to another due to load balancing.</li>
+</ul>
+
+<h2 id="feedback">Feedback?</h2>
+
+<p>Please <a href="feedback.html">get in touch</a> if you have feedback or questions towards this new concept of weak
+acknowledgements.</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>
+</description>
+ <pubDate>Mon, 16 Nov 2020 00:00:00 +0000</pubDate>
+ <link>https://www.eclipse.org/ditto/2020-11-16-weak-acknowledgements.html</link>
+ <guid isPermaLink="true">https://www.eclipse.org/ditto/2020-11-16-weak-acknowledgements.html</guid>
+
+ <category>blog</category>
+
+
+ </item>
+
+ <item>
+ <title>Desired Feature Properties</title>
+ <description><h2 id="desired-feature-properties-added-to-things-model">Desired feature properties added to things model</h2>
+<p>With the upcoming release of Eclipse Ditto <strong>version 1.5.0</strong>
+<a href="basic-feature.html#feature-desired-properties">desired feature properties</a> are introduced to the things model for
+<strong>API versions later than 1</strong>. The <em>desired properties</em> for features are added on the same level of the model as
+the feature properties and can reflect for example feature property updates ,which are intended, but not yet applied.</p>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Further logics for desired feature properties might be implemented in future Ditto
+ versions.</div>
+
+<p>A fully-fledged JSON representation of a feature with desired properties is shown below:</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">"lamp"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"com.mycompany.fb:Lamp:1.0.0"</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">"configuration"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"on"</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">"location"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">34.052235</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">-118.243683</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="p">{</span><span class="w">
+ </span><span class="s2">"on"</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">"color"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"red"</span><span class="p">:</span><span class="w"> </span><span class="mi">128</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"green"</span><span class="p">:</span><span class="w"> </span><span class="mi">255</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"blue"</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><span class="s2">"desiredProperties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"configuration"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"on"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</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="operations-on-desired-feature-properties">Operations on desired feature properties</h2>
+
+<ul>
+ <li><strong>CRUD operations</strong>
+ <ul>
+ <li>You can create multiple desired properties of a feature or just single ones.</li>
+ <li>You can retrieve all desired properties of a feature or just single ones.</li>
+ <li>You can modify all desired properties of a feature or just single ones.</li>
+ <li>You can delete all desired properties of a feature or just single ones.</li>
+ </ul>
+ </li>
+ <li><strong>Search</strong>
+ <ul>
+ <li>You can <a href="httpapi-search.html">search</a> for things with specific desired properties with <a href="basic-rql.html">RQL-functions</a>.</li>
+ <li>You can search for things, which have <a href="basic-rql.html#exists">existent</a> desired properties for a feature.</li>
+ </ul>
+ </li>
+ <li><strong>Get notified on changes</strong>
+ <ul>
+ <li>You can <a href="basic-signals-event.html">receive events</a> for changes done to the desired properties of things
+you’re authorized to read.</li>
+ <li>You can <a href="basic-enrichment.html">enrich</a> and <a href="basic-changenotifications.html#filtering">filter</a> the
+ events you want to receive, for changes done to the desired properties.</li>
+ </ul>
+ </li>
+</ul>
+
+<h3 id="executing-crud-operations-on-desired-feature-properties">Executing CRUD operations on desired feature properties</h3>
+<p>CRUD operations can be executed either via the <a href="httpapi-concepts.html">Ditto HTTP API</a> <strong>versions later than 1</strong> or via
+<a href="protocol-overview.html">ditto-protocol</a> messages.</p>
+
+<p><em>Possible CRUD operations for desired feature properties via ditto-protocol</em>:</p>
+
+<ul>
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve all desired properties of a feature via ditto-protocol</a></li>
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired property of a feature via ditto-protocol</a></li>
+ <li><a href="protocol-examples-modifydesiredproperties.html">Create/Modify all desired properties of a feature via ditto-protocol</a></li>
+ <li><a href="protocol-examples-modifydesiredproperty.html">Create/Modify a single desired property of a feature via ditto-protocol</a></li>
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete all desired properties of a feature via ditto-protocol</a></li>
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired property of a feature via ditto-protocol</a></li>
+</ul>
+
+<h3 id="using-the-ditto-client-to-manage-desired-feature-properties">Using the ditto-client to manage desired feature properties</h3>
+<p>The desired feature properties can also be retrieved, modified and deleted via the <a href="client-sdk-java.html">Ditto Java Client</a>.
+With the upcoming (<strong>Ditto Java Client version 1.5.0</strong>), no special CRUD operations for
+desired feature properties are implemented in the client. Thus, the operations have to be executed via creating
+<strong>ditto-protocol messages</strong> manually in the client.</p>
+
+<p>Example for creating/modifying desired feature properties of a thing via the ditto-client:</p>
+
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">final</span> <span class="n">Adaptable</span> <span class="n">modifyFeatureDesiredProperties</span> <span class="o">=</span>
+ <span class="n">Adaptable</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span><span class="n">TopicPath</span><span class="o">.</span><span class="na">newBuilder</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">"com.mycompany.fb:Car:1.0.0"</span><span class="o">))</span>
+ <span class="o">.</span><span class="na">things</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">twin</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">commands</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">modify</span><span class="o">()</span>
+ <span class="o">.</span><span class="na">build</span><span class="o">())</span>
+ <span class="o">.</span><span class="na">withPayload</span><span class="o">(</span><span class="n">Payload</span><span class="o">.</span><span class="na">newBuilder</span><span class="o">(</span>
+ <span class="n">JsonPointer</span><span class="o">.</span><span class="na">of</span><span class="o">(</span><span class="s">"/features/lamp/desiredProperties"</span><span class="o">))</span>
+ <span class="o">.</span><span class="na">withValue</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="na">set</span><span class="o">(</span><span class="s">"on"</span><span class="o">,</span> <span class="kc">false</span><span class="o">).</span><span class="na">build</span><span class="o">())</span>
+ <span class="o">.</span><span class="na">build</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">sendDittoProtocol</span><span class="o">(</span><span class="n">modifyFeatureDesiredProperties</span><span class="o">).</span><span class="na">whenComplete</span><span class="o">(((</span><span class="n">adaptable</span><span class="o">,</span> <span class="n">throwable</span><span class="o">)</span> <span class="o">-&gt;</span> <span class="o">{</span>
+ <span class="k">if</span> <span class="o">(</span><span class="n">throwable</span> <span class="o">!=</span> <span class="kc">null</span><span class="o">)</span> <span class="o">{</span>
+ <span class="n">LOGGER</span><span class="o">.</span><span class="na">error</span><span class="o">(</span><span class="s">"Received error while sending ModifyFeatureDesiredProperties: '{}' "</span><span class="o">,</span>
+ <span class="n">throwable</span><span class="o">.</span><span class="na">toString</span><span class="o">());</span>
+ <span class="o">}</span> <span class="k">else</span> <span class="o">{</span>
+ <span class="n">LOGGER</span><span class="o">.</span><span class="na">info</span><span class="o">(</span><span class="s">"Received response for ModifyFeatureDesiredProperties: '{}'"</span><span class="o">,</span> <span class="n">adaptable</span><span class="o">);</span>
+ <span class="o">}</span>
+ <span class="o">}));</span>
+</code></pre></div></div>
+
+<h2 id="feedback">Feedback?</h2>
+
+<p>Please <a href="feedback.html">get in touch</a> if you have feedback or questions towards this new concept of desired properties.</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>
+</description>
+ <pubDate>Wed, 11 Nov 2020 00:00:00 +0000</pubDate>
+ <link>https://www.eclipse.org/ditto/2020-11-11-desired-properties.html</link>
+ <guid isPermaLink="true">https://www.eclipse.org/ditto/2020-11-11-desired-properties.html</guid>
+
+ <category>blog</category>
+
+
+ </item>
+
+ <item>
+ <title>Announcing Eclipse Ditto Release 1.4.0</title>
+ <description><p>Today, the Ditto team is happy to announce the next feature update of Ditto <code class="highlighter-rouge">1.x</code>: <strong>Eclipse Ditto 1.4.0</strong></p>
+
+<p>1.4.0 focuses on:</p>
+
+<ul>
+ <li>Declaration of acknowledgement labels unique to each subscriber</li>
+</ul>
+
+<p>Please have a look at the <a href="release_notes_140.html">1.4.0 release notes</a> for a more detailed information on the release.</p>
+
+<p>Also, some bugs were fixed which are not backported to Ditto 1.3.0 - it is recommended to update to Ditto 1.4.0 right
+away and skip 1.3.0.</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>
+</description>
+ <pubDate>Wed, 28 Oct 2020 00:00:00 +0000</pubDate>
+ <link>https://www.eclipse.org/ditto/2020-10-28-release-announcement-140.html</link>
+ <guid isPermaLink="true">https://www.eclipse.org/ditto/2020-10-28-release-announcement-140.html</guid>
+
+ <category>blog</category>
+
+
+ </item>
+
+ <item>
+ <title>E2E acknowledgment</title>
+ <description><h2 id="e2e-acknowledgement-using-eclipse-ditto">E2E acknowledgement using Eclipse Ditto</h2>
+
+<p>By adding the new <a href="basic-acknowledgements.html">acknowledgements feature</a> to Ditto, it is now possible to provide an end to end QoS (quality of service) with level 1.
+Previously the <a href="architecture-services-connectivity.html">connectivity service</a> of Ditto did accept all incoming messages immediately as soon as it received the message.</p>
+
+<p>This behaviour can now be controlled by a Ditto header called <a href="basic-acknowledgements.html#requesting-acks"><code class="highlighter-rouge">requested-acks</code></a>.</p>
+
+<p>In this blog post I will provide a few examples for how to use this new feature in the following scenarios:</p>
+
+<ol>
+ <li>Device publishes a change of its state and doesn’t care about whether the event regarding this change will be received by any subscriber or not.<br />
+This is the <a href="#scenario-1---fire-and-forget">fire and forget</a> scenario.</li>
+ <li>Device publishes a change of its state and wants to be sure it is persisted in Ditto.<br />
+This is the <a href="#scenario-2---processed-in-ditto">processed in Ditto</a> scenario.</li>
+ <li>Device publishes a change of its state and wants to be sure an application connected to Eclipse Ditto will receive the event regarding this change of the state.<br />
+This is the <a href="#scenario-3---notification-scenario">notification</a> scenario.</li>
+ <li>Device publishes a change of its state and wants to be notified when a subscriber was not able to receive the event regarding this change.<br />
+This is the <a href="#scenario-4---tracked-notification-scenario">tracked notification</a> scenario.</li>
+ <li>Device sends a live message and wants to be sure that it will eventually receive a response.<br />
+This is the <a href="#scenario-5---long-running-live-message-scenario">long running live message</a> scenario.</li>
+ <li>Device sends a live message and wants to either receive the response within a given timeout or never.<br />
+This is the <a href="#scenario-6---asking-for-required-information-scenario">asking for required information</a> scenario.</li>
+</ol>
+
+<h2 id="scenarios">Scenarios</h2>
+
+<p>The following scenarios all share the same context:</p>
+<ul>
+ <li>a device sends data/messages via a device connectivity layer (e.g. <a href="https://eclipse.org/hono/">Eclipse Hono</a> or an MQTT broker) to Ditto</li>
+ <li>Ditto’s <a href="architecture-services-connectivity.html">connectivity service</a>
+ <ul>
+ <li>consumes the <a href="protocol-specification.html">Ditto Protocol</a> message</li>
+ <li>forwards the message into the Ditto cluster to be processed</li>
+ <li>is responsible for technically acknowledging/settling the consumed message at the device connectivity layer / broker
+ <ul>
+ <li>the strategy of when this is done and with which outcome is handled by the Ditto headers mentioned in the scenarios</li>
+ </ul>
+ </li>
+ </ul>
+ </li>
+</ul>
+
+<p>Although all scenarios are based on the device sending something (e.g. telemetry data or a message), the
+E2E acknowledgement can also be used the other way around when e.g. a backend application sends something to a device.</p>
+
+<h3 id="scenario-1---fire-and-forget">Scenario 1 - Fire and Forget</h3>
+
+<p>This is the simplest scenario of all, since the change can be published in a fire and forget semantics.</p>
+
+<p>In this scenario the device will send the modification command containing the headers:</p>
+<ul>
+ <li><code class="highlighter-rouge">response-required=false</code></li>
+ <li><code class="highlighter-rouge">requested-acks=[]</code></li>
+</ul>
+
+<p>Example <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/my-thing/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">"response-required"</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">"requested-acks"</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">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/features/lightSwitch/properties/status"</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">"on"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>For this case the connectivity service will immediately acknowledge the incoming message at the messaging system and then continues to process the command.</p>
+
+<p>It doesn’t matter if the command could be processed successfully or if any subscriber received an event for this change.</p>
+
+<h3 id="scenario-2---processed-in-ditto">Scenario 2 - Processed in Ditto</h3>
+
+<p>For this scenario the device wants to be sure its change will be properly persisted in Ditto.</p>
+
+<p>The command needs to define the following headers:</p>
+<ul>
+ <li><code class="highlighter-rouge">response-required=false</code></li>
+ <li><code class="highlighter-rouge">requested-acks=["twin-persisted"]</code></li>
+</ul>
+
+<p>Example <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/my-thing/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">"response-required"</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">"requested-acks"</span><span class="p">:</span><span class="w"> </span><span class="p">[</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">"path"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/features/lightSwitch/properties/status"</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">"on"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>For this case the connectivity service will wait until the modification will be properly persisted in Ditto before acknowledging the incoming message at the messaging system.</p>
+
+<p>If the device published this command for example via an AMQP broker (with a QoS 1 “at least once” semantic),
+this will cause the broker to redeliver the command to Ditto if the acknowledgment fails.<br />
+Please be aware that a redelivery will only be requested for the following error status codes:</p>
+<ul>
+ <li><code class="highlighter-rouge">408</code> (Request timed out)</li>
+ <li><code class="highlighter-rouge">424</code> (Dependency Failure)</li>
+ <li>All kinds of <code class="highlighter-rouge">5xx</code> status codes</li>
+</ul>
+
+<p>In this scenario it does matter if the command could be processed successfully, but it’s still not relevant if any subscriber received an event for this change.</p>
+
+<h3 id="scenario-3---notification-scenario">Scenario 3 - Notification scenario</h3>
+
+<p>For this scenario the device wants to be sure another system will be notified about the change of its state.</p>
+
+<p>This could be for example an alarming system which wants to be sure a backend application receives the information that the alarm was triggered.</p>
+
+<p>A prerequisite for this is that any kind of connection exists that publishes the event to the backend application and declares a user defined acknowledgement label.
+This can be a <a href="httpapi-protocol-bindings-websocket.html">WebSocket session</a> or any kind of Ditto Connection types which can be found <a href="connectivity-overview.html">here</a>.</p>
+
+<p>For this example we expect the event to be forwarded by an <a href="connectivity-protocol-bindings-http.html">HTTP connection</a>
+which declared the following acknowledgement label as
+<a href="basic-connections.html#target-issued-acknowledgement-label">issued acknowledgement of the target</a>: <code class="highlighter-rouge">d45d4522-142e-4057-ae87-8969343a3ddc:backend-processed</code>.</p>
+
+<p>The UUID prefix in this case is the ID of the HTTP connection and the<code class="highlighter-rouge">backend-process</code> part is a custom label, defined by the user.</p>
+
+<p>The command needs to define the following headers:</p>
+<ul>
+ <li><code class="highlighter-rouge">response-required=false</code></li>
+ <li><code class="highlighter-rouge">requested-acks=["d45d4522-142e-4057-ae87-8969343a3ddc:backend-processed"]</code></li>
+ <li><code class="highlighter-rouge">timeout=30s</code> (optional. Default is 10s.)</li>
+</ul>
+
+<p>Example <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/my-thing/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">"response-required"</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">"requested-acks"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"d45d4522-142e-4057-ae87-8969343a3ddc:backend-processed"</span><span class="p">],</span><span class="w">
+ </span><span class="s2">"timeout"</span><span class="p">:</span><span class="w"> </span><span class="s2">"30s"</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/alarm/properties/status"</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">"on"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>For this case the connectivity service will wait until the HTTP request, which forwards the event regarding the thing change,
+will be finished before acknowledging the incoming message at the messaging system.</p>
+
+<p>The status code of the HTTP response will in this case determine if the message will be acknowledged successfully or not and if a redelivery will be requested or not.<br />
+All kinds of <code class="highlighter-rouge">2xx</code> status codes will lead to a successful acknowledgement at the messaging system.<br />
+All other status codes will lead to a failed acknowledgement at the messaging system and for the following status codes a redelivery will be requested:</p>
+<ul>
+ <li><code class="highlighter-rouge">408</code> (Request timed out)</li>
+ <li><code class="highlighter-rouge">424</code> (Dependency Failure)</li>
+ <li>All kinds of <code class="highlighter-rouge">5xx</code> status codes</li>
+</ul>
+
+<p>In this scenario it is ensured a specified subscriber will receive an event for this change.</p>
+
+<h3 id="scenario-4---tracked-notification-scenario">Scenario 4 - Tracked notification scenario</h3>
+
+<p>For this scenario the device wants to know when a system could not be notified about the change of its state.</p>
+
+<p>This could be for example an alarming system which wants to be sure a backend application receives the information,
+or if not: tries to send an SMS as notification.</p>
+
+<p>This scenario is mostly like scenario 3, but needs to set the <code class="highlighter-rouge">response-required</code> header to <code class="highlighter-rouge">true</code> and it’s required
+to <a href="basic-connections.html#source-reply-target">configure the reply-target of the source</a> to also expect “nack” responses.</p>
+
+<p>Example <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/my-thing/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">"response-required"</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">"requested-acks"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"d45d4522-142e-4057-ae87-8969343a3ddc:backend-processed"</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/alarm/properties/status"</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">"on"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>In this case the device will receive an acknowledgement response containing the status code and payload of the response of the backend application.<br />
+Based on this the device can decide how to handle the situation.<br />
+It is suggested to publish the modification command with QoS 0 (“at most once” semantics) in this case because the
+device handles the result of the E2E acknowledgement. With QoS 1 (“at least once” semantics) brokers would usually redeliver the message to Ditto.</p>
+
+<p>If the HTTP endpoint of the backend application responds with the following response:</p>
+
+<p>headers:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>"content-type": "application/json"
+</code></pre></div></div>
+
+<p>body:</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">"errorCode"</span><span class="p">:</span><span class="w"> </span><span class="s2">"notification.smartphone.failed"</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">"Could not notify smartphone."</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>status code: <code class="highlighter-rouge">424</code></p>
+
+<p>The response received at the device 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">"org.eclipse.ditto/my-thing/things/twin/acks/d45d4522-142e-4057-ae87-8969343a3ddc:backend-processed"</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">"response-required"</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">"requested-acks"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"d45d4522-142e-4057-ae87-8969343a3ddc:backend-processed"</span><span class="p">],</span><span class="w">
+ </span><span class="s2">"timeout"</span><span class="p">:</span><span class="w"> </span><span class="s2">"30s"</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/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">"errorCode"</span><span class="p">:</span><span class="w"> </span><span class="s2">"notification.smartphone.failed"</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">"Could not notify smartphone."</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">424</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h3 id="scenario-5---long-running-live-message-scenario">Scenario 5 - Long running live message scenario</h3>
+
+<p>For this scenario the device is going to ask for an information which it needs eventually.</p>
+
+<p>Let’s say the device asks for the endpoint where it should download the new firmware from.<br />
+It’s not required that this response arrives within a given time. It’s just required to eventually arrive at the device
+and after it was received the device can signal the user, that it is ready to download the firmware.</p>
+
+<p>The headers of the live message should have the following values:</p>
+<ul>
+ <li><code class="highlighter-rouge">response-required=true</code></li>
+ <li><code class="highlighter-rouge">requested-acks=["live-response"]</code></li>
+</ul>
+
+<p>Example <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/my-thing/things/live/messages/firmware"</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">"response-required"</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">"requested-acks"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"live-response"</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">"text/plain"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"timeout"</span><span class="p">:</span><span class="w"> </span><span class="s2">"5s"</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">"/outbox/messages/firmware"</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">"firmware.url.query"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>By requesting the acknowledgement <code class="highlighter-rouge">live-response</code> the connectivity service will wait until the response for the live message arrived
+for 5s before acknowledging the incoming message at the broker and will request a redelivery if the response did not arrive within this timeout.</p>
+
+<p>This will repeat until either the broker discards the message or the response arrives in the specified timeout.
+That way it is guaranteed that the device will eventually receive the response.</p>
+
+<h3 id="scenario-6---asking-for-required-information-scenario">Scenario 6 - Asking for required information scenario</h3>
+
+<p>For this scenario the device is going to ask for an information which it needs right now to proceed with its current task.</p>
+
+<p>Let’s say the device asks if it should allow a car with a license plate it detected to drive on the property by opening the barrier.
+It could be possible to ask for that information, so the barrier opens automatically, but providing a fallback mechanism
+like entering a code directly at the device if this response does not arrive within time.</p>
+
+<p>The headers of the live message should have the following values:</p>
+<ul>
+ <li><code class="highlighter-rouge">response-required=true</code></li>
+ <li><code class="highlighter-rouge">requested-acks=[]</code></li>
+</ul>
+
+<p>Example <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/my-thing/things/live/messages/car-enter"</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">"response-required"</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">"requested-acks"</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">"text/plain"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"timeout"</span><span class="p">:</span><span class="w"> </span><span class="s2">"5s"</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">"/outbox/messages/car-enter"</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">"FN IB 1337"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>By requesting explicitly not requesting any acknowledgement but still requiring a response, the connectivity service will
+immediately acknowledge the incoming message at the broker. The device will then either receive the response within the specified timeout or never.
+So the device can provide its alternative options to open the barrier after 5 seconds.</p>
+
+<h2 id="we-embrace-your-feedback">We embrace your feedback</h2>
+
+<p>I hope I could demonstrate the power of the new acknowledgement feature properly and could make it clear how it can be used.
+Maybe you did recognize some of your use cases in the given examples or maybe you have another use case which can or cannot be solved by this feature.</p>
+
+<p>We would love to get your <a href="feedback.html">feedback</a>.</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>
+</description>
+ <pubDate>Fri, 23 Oct 2020 00:00:00 +0000</pubDate>
+ <link>https://www.eclipse.org/ditto/2020-10-23-end-2-end-acknowledgment.html</link>
+ <guid isPermaLink="true">https://www.eclipse.org/ditto/2020-10-23-end-2-end-acknowledgment.html</guid>
+
+ <category>blog</category>
+
+
+ </item>
+
+ </channel>
+</rss>
diff --git a/2.0/feedback.html b/2.0/feedback.html
new file mode 100644
index 0000000..ecc9c43
--- /dev/null
+++ b/2.0/feedback.html
@@ -0,0 +1,1799 @@
+<!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="getting_startedtroubleshooting, bugtracker, chat, contact, feedback, forum, github, gitter, mailing-list, questions, support, troubleshooting">
+<title> Feedback • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Feedback">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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 class="active"><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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Feedback</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>You have following possibilities in order to get support or give feedback:</p>
+
+<ul>
+ <li>Join the chat at <a href="https://gitter.im/eclipse/ditto?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge">https://gitter.im/eclipse/ditto</a> for questions</li>
+ <li>As your question on <a href="https://stackoverflow.com/questions/tagged/eclipse-ditto">StackOverflow</a></li>
+ <li>send a message to the <a href="https://dev.eclipse.org/mailman/listinfo/ditto-dev">mailing-list</a></li>
+ <li>create a <a href="https://github.com/eclipse/ditto/issues">GitHub issue</a></li>
+</ul>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_getting_started.html" class="btn btn-default navbar-btn cursorNorm" role="button">getting_started</a>
+
+
+
+ <a href="tag_troubleshooting.html" class="btn btn-default navbar-btn cursorNorm" role="button">troubleshooting</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/files/migration_mongodb_0.8.0-M2_0.8.0-M3.js b/2.0/files/migration_mongodb_0.8.0-M2_0.8.0-M3.js
new file mode 100644
index 0000000..c40ffd4
--- /dev/null
+++ b/2.0/files/migration_mongodb_0.8.0-M2_0.8.0-M3.js
@@ -0,0 +1,16 @@
+const policiesBasedSearchIndex = db.getCollection('policiesBasedSearchIndex');
+policiesBasedSearchIndex.find().forEach(function (entry) {
+ const id = entry._id;
+ const splittedId = id.split(':');
+ if (splittedId.length === 3) {
+ const thingId = `${splittedId[0]}:${ splittedId[1]}`;
+
+ policiesBasedSearchIndex.updateOne(
+ {'_id': id},
+ {$set: {'_thingId': thingId}}
+ );
+ } else {
+ print(
+ `Cannot migrate entry with id ${id}, as it seems to contain extra colons in its thingId, features or attributes.`);
+ }
+});
diff --git a/2.0/files/migration_mongodb_1.0.0.js b/2.0/files/migration_mongodb_1.0.0.js
new file mode 100644
index 0000000..e2be0b4
--- /dev/null
+++ b/2.0/files/migration_mongodb_1.0.0.js
@@ -0,0 +1,236 @@
+/**
+ * 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.
+ */
+
+const THINGS_JOURNAL = 'things_journal';
+const THINGS_SNAPS = 'things_snaps';
+const POLICIES_JOURNAL = 'policies_journal';
+const POLICIES_SNAPS = 'policies_snaps';
+
+function reduceStep(key, values) {
+ return values;
+}
+
+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() {
+ migrateThingsOrPolicies(POLICIES_JOURNAL, POLICIES_SNAPS);
+}
+
+function migrateThings() {
+ migrateThingsOrPolicies(THINGS_JOURNAL, THINGS_SNAPS);
+}
+
+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/2.0/glossary.html b/2.0/glossary.html
new file mode 100644
index 0000000..2cc7ba7
--- /dev/null
+++ b/2.0/glossary.html
@@ -0,0 +1,1795 @@
+<!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="getting_started, definitions, glossaries, terms">
+<title> Glossary • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Glossary">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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 class="active"><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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Glossary</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+
+
+
+
+
+
+
+
+
+ <h2 id="common-terms">Common terms</h2>
+
+<dl>
+ <dt>IoT</dt>
+ <dd>Internet of Things</dd>
+ <dt>IIoT</dt>
+ <dd>Industrial Internet of Things - also known as ‘Industry 4.0’</dd>
+ <dt>CQRS</dt>
+ <dd>Command-Query Responsibility Segregation. A pattern Ditto applies in order to handle commands (ModifyCommands in Ditto) and queries (QueryCommands in Ditto) differently, e.g. by reading queries from memory and persisting commands to a datastore.</dd>
+ <dt>RQL</dt>
+ <dd>Resource Query Language</dd>
+ <dt>SSE</dt>
+ <dd>Server Sent Events - one way messaging/push from a HTTP server to a consuming client (e.g. a browser).</dd>
+</dl>
+
+<h2 id="ditto-specific-terms">Ditto specific terms</h2>
+
+<dl>
+ <dt>Asset</dt>
+ <dd>An asset can be anything from a tangible and physical device to the more intangible such as the reputation of a company. In our context we define an asset as any item, entity, application or even system of applications that can be registered at Eclipse Ditto using the <code class="highlighter-rouge">Thing</code> concept.</dd>
+ <dt>Thing</dt>
+ <dd>A Thing is a generic entity and is mostly used to cluster multiple Features and manage the access to the data and functionality the Thing represents. A Thing may have additional metadata (Attributes) that describes the Thing in more detail.</dd>
+ <dt>Policy</dt>
+ <dd>A Policy enables developers to configure fine-grained access control in an easy way. A specific policy defines who (subject) is granted or revoked permissions (rights) on a specific resource. The resource can be defined as rough or as fine-grained as necessary for the respective use case.</dd>
+ <dt>Attributes</dt>
+ <dd>Attributes describe the Thing in more detail and can be of any type. Attributes can be used to find Things. Attributes are typically used to model rather static properties at the Thing level. Static means that the values do not change as frequently as property values of Features.</dd>
+ <dt>Feature</dt>
+ <dd>A Feature clusters a set of coherent Properties and has an optional Feature definition.</dd>
+ <dt>Feature properties and desiredProperties</dt>
+ <dd>A feature may consist of a distinct set of properties, which are functional or logically coherent. The feature properties can represent: <em>properties</em> (e.g. values as reported by a physical device) or <em>desiredProperties</em> (e.g. values set via a remote management UI, aiming to trigger the device integration layer to change the device configuration). Each property itself can be either a simple scalar value or a complex object. Allowed is any JSON object.</dd>
+</dl>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_getting_started.html" class="btn btn-default navbar-btn cursorNorm" role="button">getting_started</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/google459c4cca88b3ce46.html b/2.0/google459c4cca88b3ce46.html
new file mode 100644
index 0000000..a8934f3
--- /dev/null
+++ b/2.0/google459c4cca88b3ce46.html
@@ -0,0 +1 @@
+google-site-verification: google459c4cca88b3ce46.html
diff --git a/2.0/http-api-doc.html b/2.0/http-api-doc.html
new file mode 100644
index 0000000..4759a67
--- /dev/null
+++ b/2.0/http-api-doc.html
@@ -0,0 +1,282 @@
+<!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="Contains the HTTP API documentation of Eclipse Ditto.">
+<meta name="keywords" content=" HTTP, REST, documentation, swagger, openapi">
+<title> HTTP API • 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>
+
+
+ <link rel="stylesheet" type="text/css" href="https://cdnjs.cloudflare.com/ajax/libs/swagger-ui/3.20.5/swagger-ui.css" >
+ <link rel="stylesheet" type="text/css" href="css/swagger.css" >
+ <style>
+ html
+ {
+ box-sizing: border-box;
+ overflow: -moz-scrollbars-vertical;
+ overflow-y: scroll;
+ }
+ *,
+ *:before,
+ *:after
+ {
+ box-sizing: inherit;
+ }
+ </style>
+</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="Eclipse 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 class="active"><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="HTTP API">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+
+<!-- Page Content -->
+<div id="swagger-ui">
+</div>
+
+<div style="width: 100%; max-width: 1460px; margin: 0 auto; padding: 0 20px;">
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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>
+
+<script src="https://cdnjs.cloudflare.com/ajax/libs/swagger-ui/3.20.5/swagger-ui-bundle.js"> </script>
+<script src="https://cdnjs.cloudflare.com/ajax/libs/swagger-ui/3.20.5/swagger-ui-standalone-preset.js"> </script>
+<script>
+ window.onload = function() {
+
+ // Build a system
+ window.ui = SwaggerUIBundle({
+ urls: [
+ {url: "openapi/ditto-api-2.yml", name:"Ditto API v2"}
+ ],
+ "urls.primaryName": "Ditto API v2",
+ validatorUrl: null,
+ docExpansion: "none",
+ dom_id: '#swagger-ui',
+ deepLinking: true,
+ presets: [
+ SwaggerUIBundle.presets.apis,
+ SwaggerUIStandalonePreset
+ ],
+ plugins: [
+ SwaggerUIBundle.plugins.DownloadUrl
+ ],
+ layout: "StandaloneLayout",
+ onComplete: function () {
+ ui.preauthorizeBasic("NginxBasic", "ditto", "ditto");
+ }
+ });
+ }
+</script>
+
+
+</body>
+</html>
diff --git a/2.0/httpapi-concepts.html b/2.0/httpapi-concepts.html
new file mode 100644
index 0000000..b522a10
--- /dev/null
+++ b/2.0/httpapi-concepts.html
@@ -0,0 +1,2429 @@
+<!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="http, http, api, concepts, partial, conditional, optimistic locking, ETag, If-Match, If-None-Match">
+<title> HTTP API concepts • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="HTTP API concepts">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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 class="active"><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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">HTTP API concepts</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’s <a href="http-api-doc.html">HTTP API</a> follows some concepts which are documented on this page.</p>
+
+<p>The entry point into the HTTP API is:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/<apiVersion>
+</code></pre></div></div>
+
+<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 only provides API version <code class="highlighter-rouge">2</code>.<br />
+API version 1 was deprecated and deleted as of Ditto version 2.0.0</p>
+
+<p>The API version is a promise that no HTTP resources (the static ones defined by Ditto itself) are modified in an
+incompatible/breaking way. As the HTTP resources reflect the JSON structure of the <code class="highlighter-rouge">Thing</code> entity, that also applies
+for this entity.</p>
+
+<p>In API 2 the <code class="highlighter-rouge">Thing</code> structure contains a <a href="basic-policy.html">Policy</a> where the authorization information is
+managed.</p>
+
+<h2 id="endpoints">Endpoints</h2>
+
+<p>In the HTTP API, some endpoints are static and can be seen as the “schema” of Ditto. They are in sync with the JSON
+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-2">API version 2</h3>
+
+<p>In API version 2, a <code class="highlighter-rouge">Thing</code> contains a <code class="highlighter-rouge">policyId</code>, which points to a <code class="highlighter-rouge">Policy</code> managed as another entity.
+Its API endpoint is <code class="highlighter-rouge">/policies</code>.</p>
+
+<h4 id="things-in-api-2"><code class="highlighter-rouge">/things</code> in API 2</h4>
+
+<p>The base endpoint for accessing and working with <code class="highlighter-rouge">Things</code>.<br />
+A <code class="highlighter-rouge">Thing</code> in API 2 has the following JSON structure:</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">"{thingId}"</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">"{policyId}"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{definition}"</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="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="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>This maps to the following HTTP API endpoints:</p>
+
+<ul>
+ <li><code class="highlighter-rouge">/things/{thingId}</code>: accessing a complete specific thing</li>
+ <li><code class="highlighter-rouge">/things/{thingId}/policyId</code>: accessing the policy ID of the specific thing</li>
+ <li><code class="highlighter-rouge">/things/{thingId}/definition</code>: accessing the definition of the specific thing</li>
+ <li><code class="highlighter-rouge">/things/{thingId}/attributes</code>: accessing the attributes of the specific thing</li>
+ <li><code class="highlighter-rouge">/things/{thingId}/features</code>: accessing the features of the specific thing</li>
+</ul>
+
+<h4 id="things-in-api-2---dynamic-part"><code class="highlighter-rouge">/things</code> in API 2 - dynamic part</h4>
+
+<p>Additionally to that “static part” of the HTTP API which is defined by Ditto, the API is dynamically enhanced by the
+JSON structure of the Thing.<br /></p>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> This automatically turns each small aspect of a <strong>digital twin</strong> into an API endpoint.</div>
+
+<p>For example for a <code class="highlighter-rouge">Thing</code> with following 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">"{thingId}"</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">"{policyId}"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{definition}"</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">
+ </span><span class="s2">"some"</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">"serialNo"</span><span class="p">:</span><span class="w"> </span><span class="mi">4711</span><span class="w">
+ </span><span class="p">}</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">"lamp"</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">"on"</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">"color"</span><span class="p">:</span><span class="w"> </span><span class="s2">"blue"</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>The following additional API endpoints are automatically available:</p>
+
+<ul>
+ <li><code class="highlighter-rouge">/things/{thingId}/attributes/manufacturer</code>: accessing the attribute <code class="highlighter-rouge">manufacturer</code> of the specific thing</li>
+ <li><code class="highlighter-rouge">/things/{thingId}/attributes/complex</code>: accessing the attribute <code class="highlighter-rouge">complex</code> of the specific thing</li>
+ <li><code class="highlighter-rouge">/things/{thingId}/attributes/complex/some</code>: accessing the attribute <code class="highlighter-rouge">complex/some</code> of the specific thing</li>
+ <li><code class="highlighter-rouge">/things/{thingId}/attributes/complex/serialNo</code>: accessing the attribute <code class="highlighter-rouge">complex/serialNo</code> of the specific thing</li>
+ <li><code class="highlighter-rouge">/things/{thingId}/features/lamp</code>: accessing the feature <code class="highlighter-rouge">lamp</code> of the specific thing</li>
+ <li><code class="highlighter-rouge">/things/{thingId}/features/lamp/properties</code>: accessing all properties of the feature <code class="highlighter-rouge">lamp</code> of the specific thing</li>
+ <li><code class="highlighter-rouge">/things/{thingId}/features/lamp/properties/on</code>: accessing the <code class="highlighter-rouge">on</code> property of the feature <code class="highlighter-rouge">lamp</code> of the specific
+thing</li>
+ <li><code class="highlighter-rouge">/things/{thingId}/features/lamp/properties/color</code>: accessing the <code class="highlighter-rouge">color</code> properties of the feature <code class="highlighter-rouge">lamp</code> of the
+specific thing</li>
+</ul>
+
+<h4 id="policies-in-api-2"><code class="highlighter-rouge">/policies</code> in API 2</h4>
+
+<p>The base endpoint for accessing and working with <code class="highlighter-rouge">Policies</code>.<br />
+A <code class="highlighter-rouge">Policy</code> in API 2 has the following JSON structure:</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">"policyId"</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">"entries"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"{entryLabel-1}"</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">"{subjectId1}"</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">"resources"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"{resource1}"</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>
+
+<p>This maps to the following HTTP API endpoints:</p>
+
+<ul>
+ <li><code class="highlighter-rouge">/policies/{policyId}</code>: accessing complete <code class="highlighter-rouge">Policy</code></li>
+ <li><code class="highlighter-rouge">/policies/{policyId}/entries</code>: accessing the <code class="highlighter-rouge">Policy</code> entries</li>
+ <li><code class="highlighter-rouge">/policies/{policyId}/entries/{entryLabel-1}</code>: accessing a single <code class="highlighter-rouge">Policy</code> entry with the label <code class="highlighter-rouge">{entryLabel-1}</code></li>
+ <li><code class="highlighter-rouge">/policies/{policyId}/entries/{entryLabel-1}/subjects</code>: accessing the subjects of a single <code class="highlighter-rouge">Policy</code> entry with the
+label <code class="highlighter-rouge">{entryLabel-1}</code></li>
+ <li><code class="highlighter-rouge">/policies/{policyId}/entries/{entryLabel-1}/resources</code>: accessing the resources of a single <code class="highlighter-rouge">Policy</code> entry with the
+label <code class="highlighter-rouge">{entryLabel-1}</code></li>
+</ul>
+
+<h2 id="partial-updates">Partial updates</h2>
+
+<p>As a benefit of the above mentioned mechanism that an API is automatically available based on the JSON structure, the
+“partial update” pattern can be applied when modifying data.</p>
+
+<p>The benefit of this is a reduction in payload to be transferred. Further, it is beneficial because other parts of the
+<code class="highlighter-rouge">Thing</code> are not overwritten with a potentially outdated value - only the actually changed data part can be modified.</p>
+
+<p>So instead of modifying a complete <code class="highlighter-rouge">Thing</code> only a specific part is affected.</p>
+
+<p>Given, the <code class="highlighter-rouge">on</code> property of <code class="highlighter-rouge">lamp</code> should be changed to <code class="highlighter-rouge">true</code>.</p>
+
+<p>Instead of<br />
+<br />
+<code class="highlighter-rouge">PUT .../things/{thingId}</code> with the complete payload:</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">"{thingId}"</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">"{policyId}"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{definition}"</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">
+ </span><span class="s2">"some"</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">"serialNo"</span><span class="p">:</span><span class="w"> </span><span class="mi">4711</span><span class="w">
+ </span><span class="p">}</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">"lamp"</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">"on"</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">"color"</span><span class="p">:</span><span class="w"> </span><span class="s2">"blue"</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>we can use a smarter request<br /><code class="highlighter-rouge">PUT .../things/{thingId}/features/lamp/properties/on</code> with a minimal payload:</p>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kc">true</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="partial-requests">Partial requests</h2>
+
+<p>Similar to the partial updates from above, the HTTP API can also be used to retrieve a single value instead of a
+complete <code class="highlighter-rouge">Thing</code>.</p>
+
+<p>Again, the benefit is a reduction in response payload and that the caller can directly use the returned data value
+(for example expect it to be a <code class="highlighter-rouge">boolean</code> and treat it accordingly).</p>
+
+<p>For example, we can request<br /><code class="highlighter-rouge">GET .../things/{thingId}/features/lamp/properties/on</code> and get as response:</p>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kc">true</span><span class="w">
+</span></code></pre></div></div>
+
+<h3 id="with-field-selector">With field selector</h3>
+
+<p>A further mechanism in the API for partial requests is using a so-called field selector. This is useful when the JSON
+structure of the <code class="highlighter-rouge">Thing</code> or other entity should be kept intact, but not all information is relevant.</p>
+
+<p>The field selector is passed as a HTTP query parameter <code class="highlighter-rouge">fields</code> and contains a comma separated list of fields to include
+in the response.</p>
+
+<p>Given, you have the following Thing:</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">"{thingId}"</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">"{policyId}"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{definition}"</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">
+ </span><span class="s2">"some"</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">"serialNo"</span><span class="p">:</span><span class="w"> </span><span class="mi">4711</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"misc"</span><span class="p">:</span><span class="w"> </span><span class="s2">"foo"</span><span class="w">
+ </span><span class="p">}</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">"lamp"</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">"on"</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">"color"</span><span class="p">:</span><span class="w"> </span><span class="s2">"blue"</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>
+
+<h4 id="field-selector-examples">Field selector examples</h4>
+
+<p>The following <code class="highlighter-rouge">GET</code> request examples with field selectors show how you can retrieve only the parts of a thing which you
+are interested in:</p>
+
+<p><code class="highlighter-rouge">GET .../things/{thingId}?fields=attributes</code><br />
+Response:</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">"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">
+ </span><span class="s2">"some"</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">"serialNo"</span><span class="p">:</span><span class="w"> </span><span class="mi">4711</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"misc"</span><span class="p">:</span><span class="w"> </span><span class="s2">"foo"</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><code class="highlighter-rouge">GET .../things/{thingId}?fields=attributes/manufacturer</code><br />
+Response:</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">"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="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">GET .../things/{thingId}?fields=attributes/complex/serialNo</code><br />
+Response:</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">"attributes"</span><span class="p">:</span><span class="w"> </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">
+ </span><span class="s2">"serialNo"</span><span class="p">:</span><span class="w"> </span><span class="mi">4711</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><code class="highlighter-rouge">GET .../things/{thingId}?fields=attributes/complex/some,attributes/complex/serialNo</code><br />
+Response:</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">"attributes"</span><span class="p">:</span><span class="w"> </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">
+ </span><span class="s2">"some"</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">"serialNo"</span><span class="p">:</span><span class="w"> </span><span class="mi">4711</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><code class="highlighter-rouge">GET .../things/{thingId}?fields=attributes/complex(some,serialNo)</code><br />
+Response:</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">"attributes"</span><span class="p">:</span><span class="w"> </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">
+ </span><span class="s2">"some"</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">"serialNo"</span><span class="p">:</span><span class="w"> </span><span class="mi">4711</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><code class="highlighter-rouge">GET .../things/{thingId}?fields=attributes/complex/misc,features/lamp/properties/on</code><br />
+Response:</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">"attributes"</span><span class="p">:</span><span class="w"> </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">
+ </span><span class="s2">"misc"</span><span class="p">:</span><span class="w"> </span><span class="s2">"foo"</span><span class="w">
+ </span><span class="p">}</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">"lamp"</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">"on"</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="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="merge-updates">Merge updates</h2>
+
+<p>Merge updates can be used to update multiple parts of a Thing <em>in a single request</em> e.g. multiple properties of
+different features or a feature property and an attribute value. Merge updates are applied by using the HTTP
+<code class="highlighter-rouge">PATCH</code> method with the payload in <a href="https://tools.ietf.org/html/rfc7396">JSON merge patch (RFC-7396)</a> format. The
+content-type of the request must be set to <code class="highlighter-rouge">application/merge-patch+json</code>.</p>
+
+<p><a href="https://tools.ietf.org/html/rfc7396">RFC-7396</a> specifies how a set of modifications is applied to an existing JSON
+document:</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>A JSON merge patch document describes changes to be made to a target JSON document using a syntax that closely
+mimics the document being modified. Recipients of a merge patch document determine the exact set of changes being
+requested by comparing the content of the provided patch against the current content of the target document.
+If the provided merge patch contains members that do not appear within the target, those members are added. If the
+target does contain the member, the value is replaced. Null values in the merge patch are given special meaning to
+indicate the removal of existing values in the target.
+</code></pre></div></div>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Please note the special meaning of <code class="highlighter-rouge">null</code> values. When using <code class="highlighter-rouge">PATCH</code> a <code class="highlighter-rouge">null</code> value is
+interpreted as delete in contrast to <code class="highlighter-rouge">PUT</code> requests where <code class="highlighter-rouge">null</code> values have no special meaning. </div>
+
+<p>Like <code class="highlighter-rouge">PUT</code> requests, <code class="highlighter-rouge">PATCH</code> requests can be applied at any level of the JSON structure of a thing, e.g. patching a
+complete thing at root level or patching a single property value at property level.</p>
+
+<h3 id="permissions-required-for-merge-update">Permissions required for merge update</h3>
+
+<p>To successfully execute merge update the authorized subject needs to have <em>WRITE</em> permission on <em>all</em> resources
+affected by the provided JSON merge patch. If the permission is missing for one of the affected resources the whole
+merge patch is <em>rejected</em>, i.e. the merge update is executed as a whole or not at all.</p>
+
+<h3 id="merge-update-example">Merge update example</h3>
+
+<p>Given an existing thing with the JSON structure:</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">"{thingId}"</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">"{policyId}"</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="p">{</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">47.682170</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">9.386372</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"serialNo"</span><span class="p">:</span><span class="w"> </span><span class="s2">"0000000"</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">25.43</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">"°C"</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">1013.25</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">"hPa"</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>Assuming a single request should:</p>
+
+<ul>
+ <li>add the <code class="highlighter-rouge">manufacturer</code> attribute</li>
+ <li>update the existing <code class="highlighter-rouge">serialNo</code> attribute to the value of <code class="highlighter-rouge">23091861</code></li>
+ <li>remove the existing <code class="highlighter-rouge">location</code> attribute</li>
+ <li>set the existing property <code class="highlighter-rouge">value</code> of feature <code class="highlighter-rouge">temperature</code> to the value of <code class="highlighter-rouge">26.89</code></li>
+ <li>remove the existing property <code class="highlighter-rouge">unit</code> of feature <code class="highlighter-rouge">pressure</code></li>
+ <li>add a new feature <code class="highlighter-rouge">humidity</code></li>
+</ul>
+
+<p>This can be achieved using a <code class="highlighter-rouge">PATCH .../things/{thingId}</code> with the request payload of</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">"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="kc">null</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">"Bosch"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"serialNo"</span><span class="p">:</span><span class="w"> </span><span class="s2">"23091861"</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">26.89</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">"unit"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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="mi">55</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">"%"</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>The resulting JSON representation of the updated thing after applying the <code class="highlighter-rouge">PATCH</code> is:</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">"{thingId}"</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">"{policyId}"</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">"Bosch"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"serialNo"</span><span class="p">:</span><span class="w"> </span><span class="s2">"23091861"</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">26.89</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">"°C"</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="mi">1015</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="mi">55</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">"%"</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="conditional-requests">Conditional Requests</h2>
+
+<p>The HTTP API for <code class="highlighter-rouge">Things</code> and <code class="highlighter-rouge">Policies</code> partially supports <code class="highlighter-rouge">Conditional Requests</code> as defined
+in <a href="https://tools.ietf.org/html/rfc7232">RFC-7232</a>.</p>
+
+<h3 id="etag">ETag</h3>
+
+<p>A successful response on a <code class="highlighter-rouge">thing</code> or <code class="highlighter-rouge">policy</code> resource provides an <code class="highlighter-rouge">ETag</code> header.</p>
+
+<ul>
+ <li>For read responses, it contains the current entity-tag of the resource.</li>
+ <li>For write responses, it contains the entity-tag after successful write.</li>
+</ul>
+
+<p>The <code class="highlighter-rouge">ETag</code> has a different format for top-level resources and sub-resources.</p>
+
+<ul>
+ <li>Top-level resources (e.g. <code class="highlighter-rouge">.../things/{thingId}</code>): The entity-tag contains the revision of the entity which is
+addressed by the resource in the format <code class="highlighter-rouge">"rev:<revision>"</code>, e.g. <code class="highlighter-rouge">"rev:2"</code>.</li>
+ <li>Sub-resources (e.g. <code class="highlighter-rouge">.../things/{thingId}/features/{featureId}</code>): The entity-tag contains a hash of the current value
+of the addressed sub-resource in the format <code class="highlighter-rouge">"hash:<calculated-hash>"</code>, e.g.
+<code class="highlighter-rouge">"hash:87192253740"</code>. Note that this format may change in the future.</li>
+</ul>
+
+<h3 id="conditional-headers">Conditional Headers</h3>
+
+<p>The following request headers can be used to issue a conditional request:</p>
+
+<ul>
+ <li><code class="highlighter-rouge">If-Match</code>:
+ <ul>
+ <li>Read or write the resource only
+ <ul>
+ <li>if the current entity-tag matches at least one of the entity-tags provided in this header</li>
+ <li>or if the header is <code class="highlighter-rouge">*</code> and the entity exists</li>
+ </ul>
+ </li>
+ <li>The response will be:
+ <ul>
+ <li>in case of a match, the same response as if the header wouldn’t have been specified</li>
+ <li>in case of no match, status <code class="highlighter-rouge">412 (Precondition Failed)</code> with an error response containing detail information
+and the current entity-tag of the resource as <code class="highlighter-rouge">ETag</code> header</li>
+ </ul>
+ </li>
+ </ul>
+ </li>
+ <li><code class="highlighter-rouge">If-None-Match</code>:
+ <ul>
+ <li>Read or write the resource only
+ <ul>
+ <li>if the current entity-tag does not match any one of the entity-tags provided in this header</li>
+ <li>or if the header is <code class="highlighter-rouge">*</code> and the entity does not exist</li>
+ </ul>
+ </li>
+ <li>The response will be:
+ <ul>
+ <li>in case of no match, the same response as if the header wouldn’t have been specified</li>
+ <li>in case of a match:
+ <ul>
+ <li>for write requests, status <code class="highlighter-rouge">412 (Precondition Failed)</code> with an error response containing detail
+information and the current entity-tag of the resource as <code class="highlighter-rouge">ETag</code> header</li>
+ <li>for read requests, status <code class="highlighter-rouge">304 (Not Modified)</code> without response body, with the current entity-tag of the
+resource as <code class="highlighter-rouge">ETag</code> header</li>
+ </ul>
+ </li>
+ </ul>
+ </li>
+ </ul>
+ </li>
+</ul>
+
+<p>Note that the Ditto HTTP API always provides a <code class="highlighter-rouge">strong</code> entity-tag in the <code class="highlighter-rouge">ETag</code> header, thus you will never receive a
+<code class="highlighter-rouge">weak</code> entity-tag (see <a href="https://tools.ietf.org/html/rfc7232#section-2.1">RFC-7232 Section 2.1</a>). If you convert this
+strong entity-tag to a weak entity-tag and use it in a Conditional Header, Ditto will handle it according to RFC-7232.
+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 also be
+applied on any sub-resource in the same way.</p>
+
+<h4 id="create-write-only-if-the-resource-does-not-exist">Create: Write only if the resource does not exist</h4>
+
+<p>The following example request shows, how you can make sure that a <code class="highlighter-rouge">PUT</code> request does not overwrite existing data, i.e.
+how you can enforce that the Thing can only be created by the request.</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>PUT .../things/{thingId}
+If-None-Match: *
+</code></pre></div></div>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
+ </span><span class="s2">"policyId"</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">"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 crop"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"otherData"</span><span class="p">:</span><span class="w"> </span><span class="mi">4711</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>You will get one of the following responses:</p>
+
+<ul>
+ <li><code class="highlighter-rouge">201 (Created)</code> in case the creation was successful, i.e. the Thing did not yet exist.</li>
+ <li><code class="highlighter-rouge">412 (Precondition Failed)</code> in case the creation failed, i.e. a Thing with the exactly same <code class="highlighter-rouge">{thingId}</code> already
+exists.</li>
+</ul>
+
+<h4 id="update-write-only-if-the-resource-already-exists">Update: Write only if the resource already exists</h4>
+
+<p>The following example request shows how you can make sure that a <code class="highlighter-rouge">PUT</code> request does not create the resource, i.e. how
+you can enforce that the Thing can only be updated by the request, but you do not generate a duplicate by mistake.</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>PUT .../things/{thingId}
+If-Match: *
+</code></pre></div></div>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><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 crop"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"otherData"</span><span class="p">:</span><span class="w"> </span><span class="mi">4711</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>You will get one of the following responses:</p>
+
+<ul>
+ <li><code class="highlighter-rouge">204 (No Content)</code> in case the update was successful, i.e. the Thing already existed.</li>
+ <li><code class="highlighter-rouge">412 (Precondition Failed)</code> in case the update failed, i.e. the Thing does not yet exist.</li>
+</ul>
+
+<h4 id="optimistic-locking">Optimistic Locking</h4>
+
+<p>First, <code class="highlighter-rouge">GET</code> the Thing in order to retrieve both: the current data and the entity-tag:</p>
+
+<p><code class="highlighter-rouge">GET .../things/{thingId}</code>:</p>
+
+<p>Response:</p>
+
+<p><code class="highlighter-rouge">ETag: "rev:2"</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">"thingId"</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">"policyId"</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">"definition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{definition}"</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 crop"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"otherData"</span><span class="p">:</span><span class="w"> </span><span class="mi">4711</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>Assume that you have detected the typo in the manufacturer attribute (“ACME crop”) and want to fix this with a top-level
+Thing PUT. You want to make sure, that no one else has modified the Thing in the meantime, because otherwise his changes
+would be lost. (You could also achieve this with a PUT on the concrete attribute, but for this example we assume that
+you want to use a top-level Thing PUT.)</p>
+
+<p><code class="highlighter-rouge">PUT</code> the Thing with the changed data and the entity-tag from the preceding <code class="highlighter-rouge">GET</code> response in the <code class="highlighter-rouge">If-Match</code> header.</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>PUT .../things/{thingId}
+If-Match: "rev:2"
+</code></pre></div></div>
+
+<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><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">"otherData"</span><span class="p">:</span><span class="w"> </span><span class="mi">4711</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>You will get one of the following responses:</p>
+
+<ul>
+ <li><code class="highlighter-rouge">204 (No Content)</code> in case the update was successful, i.e. no one else has changed the Thing in the meantime.</li>
+ <li><code class="highlighter-rouge">412 (Precondition Failed)</code> in case the update was not successful, i.e. the Thing has been changed by someone else in
+the meantime.</li>
+</ul>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_http.html" class="btn btn-default navbar-btn cursorNorm" role="button">http</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/httpapi-messages.html b/2.0/httpapi-messages.html
new file mode 100644
index 0000000..da7e8e7
--- /dev/null
+++ b/2.0/httpapi-messages.html
@@ -0,0 +1,1883 @@
+<!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="http, http, api, messages, thing">
+<title> HTTP API Messages • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="HTTP API Messages">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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 class="active"><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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">HTTP API Messages</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>The HTTP API allows sending Messages <strong>to</strong> and <strong>from</strong> Things and its Features.
+To dive into the basic concepts of the Messages functionality, please have a look
+at the <a href="basic-messages.html">Messages page</a>.</p>
+
+<div class="alert alert-success" role="alert"><i class="fa fa-check-square-o"></i> <b>Tip:</b> Check out the <a href="protocol-specification-things-messages.html">WebSocket Messages API</a>
+if you also need to <em>receive</em> or <em>reply</em> to Messages.</div>
+
+<p>This page gives you a quick hands-on introduction to the HTTP Messages API. To learn
+about the parameters, constraints, possible responses, etc. move over to the
+<a href="http-api-doc.html#/Messages">HTTP API Documentation</a>.</p>
+
+<h2 id="using-the-http-messages-api">Using the HTTP Messages API</h2>
+
+<p>The following parts contain examples on how to send to and from Things and Features.
+For the examples we will use some kind of smart coffee machine with the id <em>smartcoffee</em>.</p>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Don’t forget to replace the Authorization header
+and the host when trying out the examples. Also make sure the Thing, you are sending
+Messages to, is existing.</div>
+
+<p>The examples use <code class="highlighter-rouge">cURL</code> for the HTTP requests. You can of course choose
+whatever tool you prefer to work with.</p>
+
+<h3 id="sending-a-message-to-a-thing">Sending a Message to a Thing</h3>
+
+<p>A message is always sent <strong>to</strong> the <strong>inbox</strong> of the receiving entity.
+Let us view a simple Message that asks our Thing <em>smartcoffee</em> how it is feeling
+today:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">--request</span> POST <span class="se">\</span>
+ <span class="nt">--url</span> http://localhost:8080/api/2/things/org.eclipse.ditto:smartcoffee/inbox/messages/ask <span class="se">\</span>
+ <span class="nt">--header</span> <span class="s1">'content-type: text/plain'</span> <span class="se">\</span>
+ <span class="nt">--header</span> <span class="s1">'Authorization: Basic ZGl0dG86ZGl0dG8='</span> <span class="se">\</span>
+ <span class="nt">--data</span> <span class="s1">'Hey, how are you?'</span>
+</code></pre></div></div>
+
+<p>Notice we are sending the Message to the <em>inbox</em> of our Thing <em>org.eclipse.ditto:smartcoffee</em>.
+The subject of the Message is <em>‘ask’</em> and contains plain text as content.
+Short after, we would receive a response from smartcoffee:</p>
+
+<div class="language-text highlighter-rouge"><div class="highlight"><pre class="highlight"><code>I do not know, since i am only a coffee machine.
+</code></pre></div></div>
+
+<p>But what would happen if smartcoffee was offline or for some other reason
+could not respond to our Message? This would cause the HTTP-Request to end
+in a timeout. This is especially annoying when sending a Message for which
+we don’t expect a response.</p>
+
+<p>This is why Ditto introduced the <code class="highlighter-rouge">timeout</code> query parameter to the requests.
+With it, you can specify how long Ditto should wait for a response
+before closing the HTTP request with a timeout:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">--request</span> POST <span class="se">\</span>
+ <span class="nt">--url</span> http://localhost:8080/api/2/things/org.eclipse.ditto:smartcoffee/inbox/messages/ask.question?timeout<span class="o">=</span>0 <span class="se">\</span>
+ <span class="nt">--header</span> <span class="s1">'content-type: text/plain'</span> <span class="se">\</span>
+ <span class="nt">--header</span> <span class="s1">'Authorization: Basic ZGl0dG86ZGl0dG8='</span> <span class="se">\</span>
+ <span class="nt">--data</span> <span class="s1">'Hey, how are you?'</span>
+</code></pre></div></div>
+
+<p>You will instantly receive a <code class="highlighter-rouge">202 Accepted</code> from Ditto instead of the
+<code class="highlighter-rouge">408 Request Timeout</code> response.</p>
+
+<p>With the <code class="highlighter-rouge">timeout</code> query parameter you can also choose a different timeout than the
+default one provided by Ditto.</p>
+
+<div class="alert alert-success" role="alert"><i class="fa fa-check-square-o"></i> <b>Tip:</b> Use the <code class="highlighter-rouge">timeout</code> query parameter to specify what timeout
+you expect for your Messages. A timeout of <em>zero</em> will instantly return a response, whilst
+other positive values change how long Ditto will wait for an answer before responding to you.</div>
+
+<h3 id="sending-a-message-to-a-feature">Sending a Message to a Feature</h3>
+
+<p>Sending a Message to a Feature works just about the same way as sending it to a Thing.
+The only difference is the URL to which you will need to send the Message. See
+how we can ask the <em>water-tank</em> Feature of our Thing <em>smartcoffee</em> to heat up:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">--request</span> POST <span class="se">\</span>
+ <span class="nt">--url</span> http://localhost:8080/api/2/things/org.eclipse.ditto:smartcoffee/features/water-tank/inbox/messages/action <span class="se">\</span>
+ <span class="nt">--header</span> <span class="s1">'content-type: text/plain'</span> <span class="se">\</span>
+ <span class="nt">--header</span> <span class="s1">'Authorization: Basic ZGl0dG86ZGl0dG8='</span> <span class="se">\</span>
+ <span class="nt">--data</span> <span class="s1">'heatUp'</span>
+</code></pre></div></div>
+
+<h3 id="sending-a-message-from-a-thing-or-feature">Sending a Message from a Thing or Feature</h3>
+
+<p>Sending a Message <strong>from</strong> a Thing or Feature works just as you would expect.
+Simply replace the <em>inbox</em> path of the URI with <em>outbox</em>. Think again of our
+Thing smartcoffee, which needs to inform about something:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">--request</span> POST <span class="se">\</span>
+ <span class="nt">--url</span> http://localhost:8080/api/2/things/org.eclipse.ditto:smartcoffee/outbox/messages/inform <span class="se">\</span>
+ <span class="nt">--header</span> <span class="s1">'correlation-id: an-unique-string-for-this-message'</span> <span class="se">\</span>
+ <span class="nt">--header</span> <span class="s1">'content-type: text/plain'</span> <span class="se">\</span>
+ <span class="nt">--header</span> <span class="s1">'Authorization: Basic ZGl0dG86ZGl0dG8='</span> <span class="se">\</span>
+ <span class="nt">--data</span> <span class="s1">'No one used me for half an hour now. I am going to shutdown soon.'</span>
+</code></pre></div></div>
+
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_http.html" class="btn btn-default navbar-btn cursorNorm" role="button">http</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/httpapi-overview.html b/2.0/httpapi-overview.html
new file mode 100644
index 0000000..6fa2b97
--- /dev/null
+++ b/2.0/httpapi-overview.html
@@ -0,0 +1,1804 @@
+<!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="http, api, http, overview, REST">
+<title> HTTP API overview • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="HTTP API overview">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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 class="active"><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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">HTTP API overview</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’s HTTP API is documented separately in the <a href="http-api-doc.html">HTTP API Doc</a>.</p>
+
+<p>There you can explore the two different API versions (the difference is described in the
+<a href="basic-overview.html">Basic Overview</a>).</p>
+
+<p>Ditto does not provide a fully compliant RESTful API in the
+<a href="https://www.ics.uci.edu/~fielding/pubs/dissertation/rest_arch_style.htm">academic sense</a> as it does not include
+hyperlinks in the HTTP responses.
+It however tries to follow the other best practices.</p>
+
+<p>If you have any feedback on how to improve at that point, Ditto’s developer team is <a href="feedback.html">eager to learn</a>.</p>
+
+<h2 id="content-type">Content Type</h2>
+
+<p>Currently, the content-type <code class="highlighter-rouge">application/json</code> is supported for all REST resources except the <em>PATCH</em> resource.
+There the content-type has to be <code class="highlighter-rouge">application/merge-patch+json</code>.</p>
+
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_http.html" class="btn btn-default navbar-btn cursorNorm" role="button">http</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/httpapi-protocol-bindings-cloudevents.html b/2.0/httpapi-protocol-bindings-cloudevents.html
new file mode 100644
index 0000000..64057ca
--- /dev/null
+++ b/2.0/httpapi-protocol-bindings-cloudevents.html
@@ -0,0 +1,1889 @@
+<!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="bindingprotocolhttp, binding, protocol, http, cloudevents">
+<title> Cloud Events HTTP 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Cloud Events HTTP 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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 class="active"><a href="httpapi-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Cloud Events HTTP 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>Implements the <a href="https://github.com/cloudevents/spec/blob/v1.0/http-protocol-binding.md">HTTP Protocol Binding for CloudEvents - Version 1.0</a>.</p>
+
+<p>Unless mentioned otherwise, the endpoint following the Cloud Events specification for the HTTP binding in version 1.0.</p>
+
+<h2 id="cloud-events-features">Cloud Events features</h2>
+
+<p>The Cloud Events endpoint provides an alternative to the other connectivity APIs to stream data into your instance.</p>
+
+<h2 id="cloud-events-endpoint">Cloud Events endpoint</h2>
+
+<p>The Cloud Events endpoint is accessible at the following URL:</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/2/cloudevents
+</code></pre></div></div>
+
+<h3 id="authentication">Authentication</h3>
+
+<p>A user who connects to the Cloud Events endpoint can be authenticated by using</p>
+
+<ul>
+ <li>HTTP BASIC Authentication by providing a username and the password of a user managed within nginx or</li>
+ <li>a JSON Web Token (JWT) issued by an OpenID connect provider.</li>
+</ul>
+
+<p>See <a href="basic-auth.html">Authenticate</a> for more details.</p>
+
+<h2 id="cloud-events-protocol-format">Cloud Events protocol format</h2>
+
+<p>The source must be a Cloud Event, encoded in the format for the HTTP binding. It may be encoded in <em>binary content mode</em>
+or in <em>structural content mode</em>.</p>
+
+<p>The <em>data content type</em> of the event must be <code class="highlighter-rouge">application/json</code>.</p>
+
+<p>The <em>data schema</em> must start with <code class="highlighter-rouge">ditto:</code>, for example <code class="highlighter-rouge">ditto:some-schema</code>.</p>
+
+<p>The events <em>payload</em> must in the Ditto Protocol JSON format as defined in the
+<a href="protocol-specification.html">Protocol specification</a>.</p>
+
+<h2 id="publishing-events-to-the-endpoint">Publishing events to the endpoint</h2>
+
+<p>Publishing events to the endpoint can be done by directly sending HTTP requests, conforming to the Cloud Events
+HTTP binding specification. Or by using other technologies that have adopted Cloud Events.</p>
+
+<h3 id="knative-eventing">Knative eventing</h3>
+
+<p>The endpoint can directly be configured as a <a href="https://knative.dev/docs/eventing/">Knative eventing</a> destination.</p>
+
+<p>In the following example, a Knative eventing flow is configured to normalize the payload with a Vorto converter
+and send the result to Ditto’s cloud events endpoint:</p>
+
+<div class="language-yaml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="na">apiVersion</span><span class="pi">:</span> <span class="s">flows.knative.dev/v1</span>
+<span class="na">kind</span><span class="pi">:</span> <span class="s">Sequence</span>
+<span class="na">metadata</span><span class="pi">:</span>
+ <span class="na">name</span><span class="pi">:</span> <span class="s">digital-twin</span>
+<span class="na">spec</span><span class="pi">:</span>
+ <span class="na">channelTemplate</span><span class="pi">:</span>
+ <span class="na">apiVersion</span><span class="pi">:</span> <span class="s">messaging.knative.dev/v1alpha1</span>
+ <span class="na">kind</span><span class="pi">:</span> <span class="s">KafkaChannel</span>
+ <span class="na">spec</span><span class="pi">:</span>
+ <span class="na">numPartitions</span><span class="pi">:</span> <span class="s">1</span>
+ <span class="na">replicationFactor</span><span class="pi">:</span> <span class="s">1</span>
+ <span class="na">steps</span><span class="pi">:</span>
+ <span class="pi">-</span> <span class="na">ref</span><span class="pi">:</span>
+ <span class="c1"># Convert incoming payload to the Ditto format</span>
+ <span class="na">apiVersion</span><span class="pi">:</span> <span class="s">serving.knative.dev/v1</span>
+ <span class="na">kind</span><span class="pi">:</span> <span class="s">Service</span>
+ <span class="na">name</span><span class="pi">:</span> <span class="s">vorto-converter</span>
+ <span class="na">namespace</span><span class="pi">:</span> <span class="s">digital-twin</span>
+ <span class="na">reply</span><span class="pi">:</span>
+ <span class="c1"># Deliver to Ditto Cloud Events endpoint</span>
+ <span class="na">uri</span><span class="pi">:</span> <span class="s">http://ditto:ditto@ditto-nginx.digital-twin.svc.cluster.local:8080/api/2/cloudevents</span>
+</code></pre></div></div>
+
+<p>This sequence itself can again be the target of another operation.</p>
+
+<h3 id="direct-invocation">Direct invocation</h3>
+
+<p>Of course, it is also possible to directly access the Cloud Events endpoint through HTTP:</p>
+
+<p>An example HTTP request could look like this:</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>POST /api/2/cloudevents HTTP/1.1
+ce-specversion: 1.0
+ce-type: my.ditto.event
+ce-time: 2020-11-24T14:35:00Z
+ce-id: f7b197fe-2e59-11eb-a8f4-d45d6455d2cc
+ce-source: /my/source
+ce-dataschema: ditto:some-schema
+Content-Type: application/json; charset=utf-8
+
+{
+ ... Ditto Protocol JSON ...
+}
+</code></pre></div></div>
+
+<p>For more information, see <a href="https://github.com/cloudevents/spec/blob/v1.0/http-protocol-binding.md">HTTP Protocol Binding for CloudEvents - Version 1.0</a>.</p>
+
+
+ <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_http.html" class="btn btn-default navbar-btn cursorNorm" role="button">http</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/httpapi-protocol-bindings-websocket.html b/2.0/httpapi-protocol-bindings-websocket.html
new file mode 100644
index 0000000..521d87e
--- /dev/null
+++ b/2.0/httpapi-protocol-bindings-websocket.html
@@ -0,0 +1,2133 @@
+<!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="protocolhttprql, binding, protocol, websocket, http">
+<title> WebSocket 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="WebSocket 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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 class="active"><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></li>
+
+
+
+
+
+
+ <li><a href="httpapi-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">WebSocket 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><a href="protocol-overview.html">Ditto Protocol</a> messages can be sent <em>as is</em> as <a href="https://tools.ietf.org/html/rfc6455">WebSocket</a>
+message. The Ditto Protocol JSON must be sent as <code class="highlighter-rouge">UTF-8</code> encoded String payload.</p>
+
+<h2 id="websocket-features">WebSocket features</h2>
+
+<p>The WebSocket provides an alternative to the <a href="httpapi-overview.html">HTTP API</a> in order to manage your digital twins.</p>
+
+<p>The benefits of the WebSocket compared to HTTP are multiple ones:</p>
+
+<ul>
+ <li>a single connection (socket like) is established and for commands to digital twins no further HTTP overhead
+(e.g. HTTP headers, HTTP connection establishment) is produced which means you can get more commands/seconds
+through the WebSocket compared to the HTTP endpoint</li>
+ <li>as the WebSocket is a duplex connection, <a href="basic-changenotifications.html">change notifications</a> can be sent via the
+WebSocket for changes to entities done in Ditto</li>
+ <li>additionally, <a href="basic-messages.html">messages</a> and <a href="protocol-twinlive.html">live commands/events</a> can be exchanged
+(sending and receiving) via multiple connected WebSocket sessions</li>
+</ul>
+
+<p>Please keep in mind that every web WebSocket connection will receive all events and messages it is allowed to receive
+depending on the provided authentication.<br />
+There is no round-robin dispatching for WebSockets using the same authentication.</p>
+
+<div class="alert alert-danger" role="alert"><i class="fa fa-exclamation-circle"></i> <b>Warning:</b> This means that WebSockets are not meant to be used for scenarios where horizontal
+ scaling should be applied.
+ For those scenarios we suggest using the <a href="connectivity-overview.html">Connectivity API</a>.</div>
+
+<h3 id="send-commands-and-get-responses">Send commands and get responses</h3>
+
+<p>When sending a command via WebSocket you will receive a corresponding response (the response can be related to the
+request by the <code class="highlighter-rouge">correlation-id</code> header). <br />
+The response indicates the success or the failure of the command and, depending on the command type, contains the
+result payload.</p>
+
+<p>Please find examples of commands, and their response pattern at <a href="protocol-examples.html">Protocol examples</a>.</p>
+
+<h3 id="request-receiving-eventschange-notifications">Request receiving events/change notifications</h3>
+
+<p>In addition to the response, which Ditto addresses directly to the instance which was sending the command, an event
+is generated. <br />
+This will be delivered to all other clients with read permissions for the respective thing, feature change, etc.</p>
+
+<p>See <a href="#request-events">request events</a> for subscribing/unsubscribing for receiving change notifications.</p>
+
+<h3 id="request-receiving-messages">Request receiving messages</h3>
+
+<p><a href="basic-messages.html">Messages</a> can be sent both via the <a href="httpapi-overview.html">HTTP API</a> and the WebSocket.
+Receiving messages and answering to them however can only be done via the WebSocket.</p>
+
+<p>See <a href="#request-messages">request messages</a> for subscribing/unsubscribing for receiving messages.</p>
+
+<h3 id="request-receiving-live-commands--events">Request receiving live commands + events</h3>
+
+<p>In order to receive <a href="protocol-twinlive.html">live commands and events</a>, the WebSocket API can be used.
+The Ditto Protocol messages are the same as for the “twin” channel, only with <em>live</em> as channel in the
+<a href="protocol-specification-topic.html">topic</a>.</p>
+
+<p>See <a href="#request-live-commands">request live commands</a> and <a href="#request-live-events">request live events</a> for
+subscribing/unsubscribing for receiving live commands and events.</p>
+
+<h2 id="websocket-endpoint">WebSocket endpoint</h2>
+
+<p>The WebSocket endpoint is accessible at the following URL:</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ws://localhost:8080/ws/2
+</code></pre></div></div>
+
+<h3 id="authentication">Authentication</h3>
+
+<p>A user who connects to the WebSocket endpoint can be authenticated by using</p>
+
+<ul>
+ <li>HTTP BASIC Authentication by providing a username and the password of a user managed within nginx or</li>
+ <li>a JSON Web Token (JWT) issued by an OpenID connect provider.</li>
+</ul>
+
+<p>See <a href="basic-auth.html">Authenticate</a> for more details.</p>
+
+<h2 id="websocket-protocol-format">WebSocket protocol format</h2>
+
+<p>As defined in the <a href="protocol-specification.html">Protocol specification</a> a Ditto Protocol message consists of different
+information. This information is combined into a single JSON message for the WebSocket endpoint:</p>
+
+<ul>
+ <li><a href="protocol-specification.html#topic">topic</a>: JSON string with key <code class="highlighter-rouge">topic</code></li>
+ <li><a href="protocol-specification.html#headers">headers</a>: JSON object with key <code class="highlighter-rouge">headers</code></li>
+ <li><a href="protocol-specification.html#path">path</a>: JSON string with key <code class="highlighter-rouge">path</code></li>
+ <li><a href="protocol-specification.html#value">value</a>: JSON value (e.g. JSON object, string, array, …) with key <code class="highlighter-rouge">value</code></li>
+ <li><a href="protocol-specification.html#status">status</a> (for responses): JSON number with key <code class="highlighter-rouge">status</code></li>
+</ul>
+
+<p>The schema for Ditto Protocol message via WebSocket:</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">"<the topic>"</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">"<a correlation-id>"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"a-header"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<header value>"</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">"<the 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="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="websocket-binding-specific-messages">WebSocket binding specific messages</h2>
+
+<p>The WebSocket binding defines several specific messages which are not defined in the Ditto Protocol specification.</p>
+
+<p>Those are also not defined as JSON messages, but as plain text messages. All of those declare a demand for some kind
+of information from the backend to be pushed into the WebSocket session.</p>
+
+<h3 id="request-events">Request events</h3>
+
+<p>In order to subscribe for <a href="basic-changenotifications.html">events/change notifications</a> for entities (e.g. Things),
+following text message has to be sent to the backend: <code class="highlighter-rouge">START-SEND-EVENTS</code></p>
+
+<p>From then on the WebSocket session will receive all change notifications it is entitled to see.</p>
+
+<h3 id="request-messages">Request messages</h3>
+
+<p>In order to subscribe for <a href="basic-messages.html">messages</a> which can be sent from a WebSocket session to another
+WebSocket session or from the <a href="httpapi-overview.html">HTTP API</a> to a WebSocket session, the following text message has
+to be sent to the backend: <code class="highlighter-rouge">START-SEND-MESSAGES</code></p>
+
+<p>From then on the WebSocket session will receive all messages it is entitled to see.</p>
+
+<h3 id="request-live-commands">Request live commands</h3>
+
+<p>In order to subscribe for <a href="protocol-twinlive.html">live commands</a> which can be sent from a WebSocket session to another
+WebSocket session, the following text message has to be sent to the backend: <code class="highlighter-rouge">START-SEND-LIVE-COMMANDS</code></p>
+
+<p>From then on the WebSocket session will receive all live commands it is entitled to see.</p>
+
+<h3 id="request-live-events">Request live events</h3>
+
+<p>In order to subscribe for <a href="protocol-twinlive.html">live events</a> which can be sent from a WebSocket session to another
+WebSocket session, the following text message has to be sent to the backend: <code class="highlighter-rouge">START-SEND-LIVE-EVENTS</code></p>
+
+<p>From then on the WebSocket session will receive all live events it is entitled to see.</p>
+
+<h3 id="request-policy-announcements">Request policy announcements</h3>
+
+<p>In order to subscribe for <a href="protocol-specification-policies-announcement.html">Policy announcements</a> which can be
+published to a WebSocket session, the following text message has to be sent to the backend:
+<code class="highlighter-rouge">START-SEND-POLICY-ANNOUNCEMENTS</code></p>
+
+<p>From then on the WebSocket session will receive all announcements related to policies related to the authenticated
+subjects of the websocket session.</p>
+
+<h3 id="overview">Overview</h3>
+
+<p>The following table shows which WebSocket protocol message are supported:</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Description</th>
+ <th>Request message</th>
+ <th>Response message</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>Refresh JWT based authentication</td>
+ <td><code class="highlighter-rouge">JWT-TOKEN</code></td>
+ <td><code class="highlighter-rouge">-</code></td>
+ </tr>
+ <tr>
+ <td>Subscribe for <a href="basic-changenotifications.html">Thing events/change notifications</a></td>
+ <td><code class="highlighter-rouge">START-SEND-EVENTS</code></td>
+ <td><code class="highlighter-rouge">START-SEND-EVENTS:ACK</code></td>
+ </tr>
+ <tr>
+ <td>Stop receiving Thing change notifications</td>
+ <td><code class="highlighter-rouge">STOP-SEND-EVENTS</code></td>
+ <td><code class="highlighter-rouge">STOP-SEND-EVENTS:ACK</code></td>
+ </tr>
+ <tr>
+ <td>Subscribe for <a href="basic-messages.html">Thing messages</a></td>
+ <td><code class="highlighter-rouge">START-SEND-MESSAGES</code></td>
+ <td><code class="highlighter-rouge">START-SEND-MESSAGES:ACK</code></td>
+ </tr>
+ <tr>
+ <td>Stop receiving Thing messages</td>
+ <td><code class="highlighter-rouge">STOP-SEND-MESSAGES</code></td>
+ <td><code class="highlighter-rouge">STOP-SEND-MESSAGES:ACK</code></td>
+ </tr>
+ <tr>
+ <td>Subscribe for <a href="protocol-twinlive.html">Thing live commands</a></td>
+ <td><code class="highlighter-rouge">START-SEND-LIVE-COMMANDS</code></td>
+ <td><code class="highlighter-rouge">START-SEND-LIVE-COMMANDS:ACK</code></td>
+ </tr>
+ <tr>
+ <td>Stop receiving Thing live commands</td>
+ <td><code class="highlighter-rouge">STOP-SEND-LIVE-COMMANDS</code></td>
+ <td><code class="highlighter-rouge">STOP-SEND-LIVE-COMMANDS:ACK</code></td>
+ </tr>
+ <tr>
+ <td>Subscribe for <a href="protocol-twinlive.html">Thing live events</a></td>
+ <td><code class="highlighter-rouge">START-SEND-LIVE-EVENTS</code></td>
+ <td><code class="highlighter-rouge">START-SEND-LIVE-EVENTS:ACK</code></td>
+ </tr>
+ <tr>
+ <td>Stop receiving Thing live commands</td>
+ <td><code class="highlighter-rouge">STOP-SEND-LIVE-EVENTS</code></td>
+ <td><code class="highlighter-rouge">STOP-SEND-LIVE-EVENTS:ACK</code></td>
+ </tr>
+ <tr>
+ <td>Subscribe for <a href="protocol-specification-policies-announcement.html">Policy announcements</a></td>
+ <td><code class="highlighter-rouge">START-SEND-POLICY-ANNOUNCEMENTS</code></td>
+ <td><code class="highlighter-rouge">START-SEND-POLICY-ANNOUNCEMENTS:ACK</code></td>
+ </tr>
+ <tr>
+ <td>Stop receiving Policy announcements</td>
+ <td><code class="highlighter-rouge">STOP-SEND-POLICY-ANNOUNCEMENTS</code></td>
+ <td><code class="highlighter-rouge">STOP-SEND-POLICY-ANNOUNCEMENTS:ACK</code></td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="authentication-1">Authentication</h3>
+
+<p>Ditto closes Websocket connections when the JWT provided with the initial connect expires. To keep the connection
+open, one can send a valid JWT via <code class="highlighter-rouge">JWT-TOKEN</code> protocol message. The <code class="highlighter-rouge">sub</code> of the new token must match the one from
+the initial connect, otherwise Ditto will close the connection.</p>
+
+<p>Ditto expects the message with the JWT as a base64 encoded string provided with the paramter <code class="highlighter-rouge">?jwtToken=<token></code>, e.g.:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>JWT-TOKEN?jwtToken=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
+</code></pre></div></div>
+
+<h3 id="enrichment">Enrichment</h3>
+
+<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">Thing 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">Thing 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">Thing 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">Thing live events</a></td>
+ <td><code class="highlighter-rouge">START-SEND-LIVE-EVENTS</code></td>
+ <td>✔</td>
+ </tr>
+ <tr>
+ <td>Subscribe for <a href="protocol-specification-policies-announcement.html">Policy announcements</a></td>
+ <td><code class="highlighter-rouge">START-SEND-POLICY-ANNOUNCEMENTS</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
+following parameters can additionally be provided when sending the WebSocket protocol messages:</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Description</th>
+ <th>Request message</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>
+ <tr>
+ <td>Subscribe for <a href="basic-changenotifications.html">Thing events/change notifications</a></td>
+ <td><code class="highlighter-rouge">START-SEND-EVENTS</code></td>
+ <td>✔</td>
+ <td>✔</td>
+ </tr>
+ <tr>
+ <td>Subscribe for <a href="basic-messages.html">Thing messages</a></td>
+ <td><code class="highlighter-rouge">START-SEND-MESSAGES</code></td>
+ <td>✔</td>
+ <td>❌</td>
+ </tr>
+ <tr>
+ <td>Subscribe for <a href="protocol-twinlive.html">Thing live commands</a></td>
+ <td><code class="highlighter-rouge">START-SEND-LIVE-COMMANDS</code></td>
+ <td>✔</td>
+ <td>❌</td>
+ </tr>
+ <tr>
+ <td>Subscribe for <a href="protocol-twinlive.html">Thing live events</a></td>
+ <td><code class="highlighter-rouge">START-SEND-LIVE-EVENTS</code></td>
+ <td>✔</td>
+ <td>✔</td>
+ </tr>
+ <tr>
+ <td>Subscribe for <a href="protocol-specification-policies-announcement.html">Policy announcements</a></td>
+ <td><code class="highlighter-rouge">START-SEND-POLICY-ANNOUNCEMENTS</code></td>
+ <td>✔</td>
+ <td>❌</td>
+ </tr>
+ </tbody>
+</table>
+
+<p>The parameters are specified similar to HTTP query parameters, the first one separated with a <code class="highlighter-rouge">?</code> and all following ones
+with <code class="highlighter-rouge">&</code>. You have to URL encode the filter values before using them in a configuration.</p>
+
+<p>For example this way the WebSocket session would register for all events in the namespace <code class="highlighter-rouge">org.eclipse.ditto</code> and which
+would match an attribute “counter” to be greater than 42:</p>
+<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">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_protocol.html" class="btn btn-default navbar-btn cursorNorm" role="button">protocol</a>
+
+
+
+ <a href="tag_http.html" class="btn btn-default navbar-btn cursorNorm" role="button">http</a>
+
+
+
+ <a href="tag_rql.html" class="btn btn-default navbar-btn cursorNorm" role="button">rql</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/httpapi-search.html b/2.0/httpapi-search.html
new file mode 100644
index 0000000..138127e
--- /dev/null
+++ b/2.0/httpapi-search.html
@@ -0,0 +1,1851 @@
+<!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="httpsearchrql, http, api, search, query, rql">
+<title> HTTP API search • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="HTTP API search">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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 class="active"><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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">HTTP API search</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>The <a href="basic-search.html">search aspect</a> of Ditto can be accessed via an HTTP API.</p>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Find the HTTP API reference at the
+ <a href="http-api-doc.html?urls.primaryName=api2#/Search">Search resources</a>.</div>
+
+<p>The concepts of the <a href="basic-rql.html#rql-filter">RQL expression</a>, <a href="basic-rql.html#rql-sorting">RQL sorting</a> and
+<a href="basic-search.html#rql-paging-deprecated">RQL paging</a> are mapped to HTTP as query parameters which are added to
+<code class="highlighter-rouge">GET</code> requests to the search endpoint:</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/2/search/things
+</code></pre></div></div>
+
+<p>If the <code class="highlighter-rouge">filter</code> parameter is omitted, the result contains all <code class="highlighter-rouge">Things</code> the authenticated user is
+<a href="basic-auth.html">allowed to read</a>.</p>
+
+<p>Optionally a <code class="highlighter-rouge">namespaces</code> parameter can be added to search only in the given namespaces.</p>
+
+<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">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
+.eclipse.ditto,foo.bar
+</code></pre></div></div>
+
+<p>Another Complex example with the <code class="highlighter-rouge">namespaces</code> parameter:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>GET .../search/things?filter=eq(attributes/location,"living-room")&namespaces=org.eclipse.ditto,foo.bar
+</code></pre></div></div>
+
+<p>The HTTP search API can also profit from the <a href="httpapi-concepts.html#partial-requests">partial request</a> concept
+of the API:<br />
+Additionally to a <code class="highlighter-rouge">filter</code> and <code class="highlighter-rouge">options</code>, a <code class="highlighter-rouge">fields</code> parameter may be specified in order to select which data
+of the result set to retrieve.</p>
+
+<p>Example which only returns <code class="highlighter-rouge">thingId</code> and the <code class="highlighter-rouge">manufacturer</code> attribute of the found Things:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>GET .../search/things?filter=eq(attributes/location,"living-room")&fields=thingId,attributes/manufacturer
+</code></pre></div></div>
+
+<p>With the <code class="highlighter-rouge">namespaces</code> parameter, the result can be limited to the given namespaces.</p>
+
+<p>Example which only returns Things with the given namespaces prefix:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>GET .../search/things?namespaces=org.eclipse.ditto,foo.bar
+</code></pre></div></div>
+
+<h2 id="search-count">Search count</h2>
+<p>Search counts can be made against this endpoint:</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/2/search/things/count
+</code></pre></div></div>
+
+<p>Complex example:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>GET .../search/things/count?filter=eq(attributes/location,"living-room")
+</code></pre></div></div>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_http.html" class="btn btn-default navbar-btn cursorNorm" role="button">http</a>
+
+
+
+ <a href="tag_search.html" class="btn btn-default navbar-btn cursorNorm" role="button">search</a>
+
+
+
+ <a href="tag_rql.html" class="btn btn-default navbar-btn cursorNorm" role="button">rql</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/httpapi-sse.html b/2.0/httpapi-sse.html
new file mode 100644
index 0000000..722a0ab
--- /dev/null
+++ b/2.0/httpapi-sse.html
@@ -0,0 +1,2037 @@
+<!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="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">
+<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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="HTTP API server sent events (SSE)">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP protocol binding</a></li>
+
+
+
+
+
+
+ <li class="active"><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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">HTTP API server sent events (SSE)</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>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>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 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 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>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/2/things
+</code></pre></div></div>
+
+<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>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-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 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/2/things?namespaces=org.eclipse.ditto.one,org.eclipse.test&filter=gt
+(attributes/counter,42)
+</code></pre></div></div>
+
+<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
+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/2/things?ids=<thingId1>,<thingId2>
+</code></pre></div></div>
+
+<h4 id="fields-projection">Fields projection</h4>
+
+<p>Additionally, using the <code class="highlighter-rouge">fields</code> parameter of the <a href="httpapi-concepts.html#partial-requests">partial request</a> feature,
+only specific parts can be watched for changes, e.g.:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/2/things?fields=thingId,attributes
+</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 visible for which thing the change was made.</div>
+
+<h4 id="field-enrichment">Field enrichment</h4>
+
+<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/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/2/things?extraFields=attributes/location&filter=eq(attributes/location,"kitchen")
+</code></pre></div></div>
+
+<p>For combined usage of <code class="highlighter-rouge">fields</code> and <code class="highlighter-rouge">extraFields</code> one needs to specify all fields, selected as extra fields, for the
+field projection, too. This is required to allow filtering based on extra fields but still omit them in the payload.
+An example without filtering would look like this:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/2/things?fields=thingId,attributes&extraFields=attributes
+</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 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/2/things?namespaces=org.eclipse.ditto.one,org.eclipse.test
+</code></pre></div></div>
+
+<h4 id="filtering-by-rql-expression">Filtering by RQL expression</h4>
+
+<p>As also described in <a href="basic-changenotifications.html#by-rql-expression">change notifications</a>, it is additionally
+possible to specify an RQL expression expressing on which occasions to emit an event via the SSE API.
+Simply specify the <code class="highlighter-rouge">filter</code> parameter with an <a href="basic-rql.html">RQL expression</a>, e.g.:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/2/things?filter=gt(attributes/counter,42)
+</code></pre></div></div>
+
+<h3 id="example-for-sse-on-things">Example for SSE on Things</h3>
+
+<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">"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">
+ </span><span class="s2">"some"</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">"serialNo"</span><span class="p">:</span><span class="w"> </span><span class="mi">4711</span><span class="w">
+ </span><span class="p">}</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">"lamp"</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">"on"</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">"color"</span><span class="p">:</span><span class="w"> </span><span class="s2">"blue"</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>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 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/2/things?ids=org.eclipse.ditto:fancy-thing&fields=thingId,features/lamp'</span><span class="p">,</span> <span class="p">{</span> <span class="na">withCredentials</span><span class="p">:</span> <span class="kc">true</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>By defining <code class="highlighter-rouge">{ withCredentials: true }</code> at the <code class="highlighter-rouge">new EventSource()</code>, the browser credentials (<code class="highlighter-rouge">Authorization</code> header) of
+the already authenticated browser against that domain are sent along, this works for Basic Auth as well as for
+JWT based authentication using a <code class="highlighter-rouge">Bearer</code> token.</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/2/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>
+<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">
+ </span><span class="s2">"lamp"</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">"on"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</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="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/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/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/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/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/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">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_http.html" class="btn btn-default navbar-btn cursorNorm" role="button">http</a>
+
+
+
+ <a href="tag_rql.html" class="btn btn-default navbar-btn cursorNorm" role="button">rql</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/images/2020-04-16-Logo_TTVC_color.png b/2.0/images/2020-04-16-Logo_TTVC_color.png
new file mode 100755
index 0000000..aef387c
--- /dev/null
+++ b/2.0/images/2020-04-16-Logo_TTVC_color.png
Binary files differ
diff --git a/2.0/images/GitHub-Mark-Light-32px.png b/2.0/images/GitHub-Mark-Light-32px.png
new file mode 100755
index 0000000..628da97
--- /dev/null
+++ b/2.0/images/GitHub-Mark-Light-32px.png
Binary files differ
diff --git a/2.0/images/blog/2018-05-02-ditto-hono-digital-twin.png b/2.0/images/blog/2018-05-02-ditto-hono-digital-twin.png
new file mode 100644
index 0000000..1475ed7
--- /dev/null
+++ b/2.0/images/blog/2018-05-02-ditto-hono-digital-twin.png
Binary files differ
diff --git a/2.0/images/blog/2018-09-21-selective-push-notifications-example-setup.png b/2.0/images/blog/2018-09-21-selective-push-notifications-example-setup.png
new file mode 100644
index 0000000..617c7c6
--- /dev/null
+++ b/2.0/images/blog/2018-09-21-selective-push-notifications-example-setup.png
Binary files differ
diff --git a/2.0/images/blog/2018-09-21-selective-push-notifications-visual-comparison.png b/2.0/images/blog/2018-09-21-selective-push-notifications-visual-comparison.png
new file mode 100644
index 0000000..cb15491
--- /dev/null
+++ b/2.0/images/blog/2018-09-21-selective-push-notifications-visual-comparison.png
Binary files differ
diff --git a/2.0/images/blog/2018-09-21-selective-push-notifications-websocket_org.png b/2.0/images/blog/2018-09-21-selective-push-notifications-websocket_org.png
new file mode 100644
index 0000000..4be2d76
--- /dev/null
+++ b/2.0/images/blog/2018-09-21-selective-push-notifications-websocket_org.png
Binary files differ
diff --git a/2.0/images/blog/2018-12-14-command-and-control.png b/2.0/images/blog/2018-12-14-command-and-control.png
new file mode 100644
index 0000000..38da33c
--- /dev/null
+++ b/2.0/images/blog/2018-12-14-command-and-control.png
Binary files differ
diff --git a/2.0/images/blog/2021-03-22-azure-iot-hub-integration-overview.png b/2.0/images/blog/2021-03-22-azure-iot-hub-integration-overview.png
new file mode 100755
index 0000000..01253fe
--- /dev/null
+++ b/2.0/images/blog/2021-03-22-azure-iot-hub-integration-overview.png
Binary files differ
diff --git a/2.0/images/blog/2021-04-06-ssh-tunnel-for-managed-connections-shema.png b/2.0/images/blog/2021-04-06-ssh-tunnel-for-managed-connections-shema.png
new file mode 100644
index 0000000..3518dc9
--- /dev/null
+++ b/2.0/images/blog/2021-04-06-ssh-tunnel-for-managed-connections-shema.png
Binary files differ
diff --git a/2.0/images/ditto.svg b/2.0/images/ditto.svg
new file mode 100644
index 0000000..b950f67
--- /dev/null
+++ b/2.0/images/ditto.svg
@@ -0,0 +1,183 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+ xmlns:i="&ns_ai;"
+ 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:svg="http://www.w3.org/2000/svg"
+ xmlns="http://www.w3.org/2000/svg"
+ xmlns:xlink="http://www.w3.org/1999/xlink"
+ xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+ xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+ width="20.146963mm"
+ height="24.962379mm"
+ viewBox="0 0 20.146963 24.962379"
+ version="1.1"
+ id="svg8"
+ inkscape:version="0.92.2 (5c3e80d, 2017-08-06)"
+ sodipodi:docname="ditto2.svg">
+ <defs
+ id="defs2" />
+ <sodipodi:namedview
+ id="base"
+ pagecolor="#ffffff"
+ bordercolor="#666666"
+ borderopacity="1.0"
+ inkscape:pageopacity="0.0"
+ inkscape:pageshadow="2"
+ inkscape:zoom="2.8"
+ inkscape:cx="9.6705704"
+ inkscape:cy="31.365963"
+ inkscape:document-units="mm"
+ inkscape:current-layer="layer1"
+ showgrid="false"
+ inkscape:window-width="1920"
+ inkscape:window-height="1137"
+ inkscape:window-x="-8"
+ inkscape:window-y="-8"
+ inkscape:window-maximized="1" />
+ <metadata
+ id="metadata5">
+ <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></dc:title>
+ </cc:Work>
+ </rdf:RDF>
+ </metadata>
+ <g
+ inkscape:label="Layer 1"
+ inkscape:groupmode="layer"
+ id="layer1"
+ transform="translate(-79.884852,-10.108096)">
+ <switch
+ id="switch3753"
+ transform="matrix(0.26458333,0,0,0.26458333,-21.416697,-56.161297)">
+ <foreignObject
+ height="1"
+ width="1"
+ y="0"
+ x="0"
+ requiredExtensions="http://ns.adobe.com/AdobeIllustrator/10.0/">
+ <i:pgfRef
+ xlink:href="#adobe_illustrator_pgf" />
+ </foreignObject>
+ <g
+ id="g3751"
+ i:extraneous="self">
+ <g
+ id="g3749">
+ <g
+ id="g3733">
+ <polygon
+ id="polygon3699"
+ points="432.84,257.514 438.936,261.058 432.838,264.533 432.838,257.514 "
+ style="opacity:0.45;fill:#3a8c9a" />
+ <polygon
+ id="polygon3701"
+ points="420.526,264.668 420.557,271.74 432.898,264.566 426.74,261.058 "
+ style="opacity:0.8;fill:#3a8c9a" />
+ <polygon
+ id="polygon3703"
+ points="420.5,257.516 420.526,264.668 426.74,261.058 "
+ style="opacity:0.7;fill:#3a8c9a" />
+ <polygon
+ id="polygon3705"
+ points="426.74,261.058 432.838,264.533 432.84,257.514 "
+ style="opacity:0.6;fill:#3a8c9a" />
+ <polygon
+ id="polygon3707"
+ points="432.838,257.514 432.838,250.467 420.5,257.516 426.74,261.058 "
+ style="opacity:0.5;fill:#3a8c9a" />
+ <g
+ id="g3713">
+ <polygon
+ id="polygon3709"
+ points="420.526,293.258 420.557,286.187 432.838,293.394 426.74,296.869 "
+ style="opacity:0.8;fill:#3a8c9a" />
+ <polygon
+ id="polygon3711"
+ points="420.5,300.412 420.526,293.258 426.74,296.869 "
+ style="opacity:0.7;fill:#3a8c9a" />
+ </g>
+ <path
+ id="path3715"
+ d="m 408.188,250.467 -12.471,6.795 -12.84,7.302 v 0.131 l -0.005,-0.004 v 14.228 0.091 14.226 l 0.005,-0.002 v 0.13 l 12.84,7.302 12.473,6.795 12.333,-7.048 0.034,-6.877 v -7.348 l -12.431,7.174 -12.47,-7.555 v -0.129 -13.43 l 0.002,-0.124 12.468,-7.557 12.431,7.174 -0.03,-7.072 v -7.154 z m -25.189,28.477 0.039,0.02 -0.039,0.02 -0.037,-0.02 z"
+ inkscape:connector-curvature="0"
+ style="fill:#3a8c9a" />
+ <polygon
+ id="polygon3717"
+ points="432.84,257.514 432.838,257.514 432.838,250.467 445.176,257.516 438.936,261.058 "
+ style="opacity:0.25;fill:#3a8c9a" />
+ <polygon
+ id="polygon3719"
+ points="445.193,264.668 445.162,271.74 432.818,264.566 438.977,261.058 "
+ style="opacity:0.25;fill:#3a8c9a" />
+ <polygon
+ id="polygon3721"
+ points="432.84,300.412 438.936,296.869 432.838,293.394 432.838,300.412 "
+ style="opacity:0.45;fill:#3a8c9a" />
+ <polygon
+ id="polygon3723"
+ points="426.74,296.869 432.838,293.394 432.84,300.412 "
+ style="opacity:0.6;fill:#3a8c9a" />
+ <polygon
+ id="polygon3725"
+ points="432.838,300.412 432.838,307.46 420.5,300.408 426.74,296.869 "
+ style="opacity:0.5;fill:#3a8c9a" />
+ <polygon
+ id="polygon3727"
+ points="432.84,300.412 432.838,300.412 432.838,307.46 445.176,300.408 438.936,296.869 "
+ style="opacity:0.25;fill:#3a8c9a" />
+ <polygon
+ id="polygon3729"
+ points="445.193,293.256 445.162,286.187 432.838,293.394 438.977,296.869 "
+ style="opacity:0.25;fill:#3a8c9a" />
+ <path
+ id="path3731"
+ d="m 438.088,296.902 c 0,0.47 0.381,0.849 0.848,0.849 0.299,0 0.547,-0.163 0.699,-0.396 l 4.766,2.779 c -0.031,0.087 -0.057,0.181 -0.057,0.278 0,0.471 0.379,0.85 0.85,0.85 0.471,0 0.85,-0.379 0.85,-0.85 0,-0.092 -0.027,-0.174 -0.053,-0.257 l 11.508,-6.244 c 0.16,0.185 0.385,0.312 0.652,0.312 0.479,0 0.867,-0.386 0.867,-0.865 0,-0.424 -0.309,-0.76 -0.713,-0.834 l -0.002,-12.727 c 0.406,-0.074 0.715,-0.409 0.715,-0.834 0,-0.425 -0.309,-0.76 -0.715,-0.834 l 0.002,-12.727 c 0.404,-0.074 0.713,-0.41 0.713,-0.836 0,-0.479 -0.389,-0.865 -0.867,-0.865 -0.268,0 -0.492,0.128 -0.652,0.312 l -11.508,-6.242 c 0.025,-0.083 0.053,-0.166 0.053,-0.257 0,-0.47 -0.379,-0.849 -0.85,-0.849 -0.471,0 -0.85,0.379 -0.85,0.849 0,0.098 0.025,0.189 0.057,0.279 l -4.766,2.777 c -0.152,-0.233 -0.4,-0.395 -0.699,-0.395 -0.467,0 -0.848,0.379 -0.848,0.847 0,0.468 0.381,0.85 0.848,0.85 0.26,0 0.482,-0.125 0.639,-0.307 l 4.846,2.761 c -0.047,0.104 -0.076,0.22 -0.076,0.342 0,0.414 0.303,0.743 0.691,0.817 v 5.71 c -0.389,0.074 -0.691,0.403 -0.691,0.815 0,0.414 0.303,0.745 0.691,0.819 v 12.27 c -0.389,0.074 -0.691,0.403 -0.691,0.817 0,0.411 0.303,0.742 0.691,0.816 v 5.708 c -0.389,0.076 -0.691,0.403 -0.691,0.817 0,0.122 0.029,0.239 0.076,0.344 l -4.846,2.759 c -0.156,-0.183 -0.379,-0.307 -0.639,-0.307 -0.467,-10e-4 -0.848,0.381 -0.848,0.849 z m 6.947,-33.05 c -0.166,0.033 -0.324,0.1 -0.441,0.216 l -4.863,-2.772 c 0.029,-0.087 0.053,-0.174 0.053,-0.272 0,-0.057 -0.021,-0.106 -0.031,-0.163 l 4.805,-2.796 c 0.125,0.142 0.289,0.231 0.479,0.268 v 5.519 z m 12.959,1.55 v 12.729 c -0.188,0.037 -0.354,0.12 -0.475,0.255 l -4.988,-2.635 c 0.033,-0.096 0.063,-0.196 0.063,-0.303 0,-0.422 -0.311,-0.76 -0.711,-0.834 v -5.362 c 0.4,-0.074 0.711,-0.409 0.711,-0.834 0,-0.122 -0.029,-0.24 -0.074,-0.344 l 4.982,-2.946 c 0.127,0.145 0.297,0.237 0.492,0.274 z m -0.705,13.561 c 0,0.098 0.025,0.189 0.057,0.281 l -4.979,2.664 c -0.127,-0.14 -0.293,-0.227 -0.484,-0.264 v -5.364 c 0.191,-0.037 0.357,-0.124 0.484,-0.261 l 4.984,2.633 c -0.037,0.096 -0.062,0.2 -0.062,0.311 z m -4.769,10.887 c 0.045,-0.104 0.074,-0.222 0.074,-0.344 0,-0.422 -0.311,-0.758 -0.711,-0.832 v -5.361 c 0.4,-0.076 0.711,-0.414 0.711,-0.836 0,-0.104 -0.029,-0.205 -0.063,-0.303 l 4.971,-2.659 c 0.127,0.148 0.297,0.244 0.492,0.279 v 12.731 c -0.195,0.035 -0.365,0.126 -0.492,0.274 z m -7.172,4.225 c 0.393,-0.074 0.695,-0.405 0.695,-0.819 0,-0.096 -0.027,-0.188 -0.057,-0.274 l 5.117,-2.879 c 0.156,0.166 0.375,0.27 0.623,0.27 0.244,0 0.463,-0.102 0.617,-0.263 l 0.221,0.128 4.777,2.831 c -0.031,0.087 -0.059,0.188 -0.059,0.29 0,0.103 0.027,0.194 0.057,0.286 l -11.498,6.241 c -0.121,-0.152 -0.297,-0.252 -0.494,-0.289 v -5.522 z m 0.695,-8.16 c 0,-0.055 -0.023,-0.103 -0.031,-0.155 l 5.021,-2.788 c 0.127,0.179 0.314,0.298 0.541,0.34 v 5.359 c -0.215,0.042 -0.396,0.146 -0.521,0.312 l -5.041,-2.918 c 0.008,-0.05 0.031,-0.096 0.031,-0.15 z m -0.695,0.816 c 0.232,-0.043 0.424,-0.176 0.547,-0.37 l 5.018,2.901 c -0.023,0.078 -0.053,0.157 -0.053,0.244 0,0.122 0.025,0.235 0.07,0.34 l -5.102,2.864 c -0.121,-0.142 -0.287,-0.233 -0.48,-0.27 z m 0,-13.916 c 0.227,-0.046 0.424,-0.166 0.547,-0.357 l 5.008,2.781 c -0.018,0.07 -0.043,0.133 -0.043,0.209 0,0.425 0.311,0.76 0.715,0.834 v 5.36 c -0.404,0.076 -0.715,0.412 -0.715,0.834 0,0.076 0.025,0.139 0.043,0.209 l -5.008,2.781 c -0.123,-0.189 -0.32,-0.312 -0.547,-0.357 z m 0.695,-0.805 c 0,-0.052 -0.023,-0.101 -0.031,-0.15 l 5.041,-2.916 c 0.125,0.163 0.307,0.27 0.521,0.309 v 5.359 c -0.227,0.042 -0.414,0.164 -0.541,0.342 l -5.021,-2.79 c 0.008,-0.05 0.031,-0.098 0.031,-0.154 z m -0.695,-6.525 c 0.193,-0.035 0.359,-0.126 0.48,-0.27 l 5.102,2.866 c -0.045,0.104 -0.07,0.215 -0.07,0.337 0,0.087 0.029,0.167 0.053,0.246 l -5.018,2.898 c -0.123,-0.194 -0.314,-0.324 -0.547,-0.368 z m 0,-7.154 c 0.197,-0.04 0.373,-0.137 0.494,-0.29 l 11.498,6.242 c -0.029,0.089 -0.057,0.183 -0.057,0.283 0,0.104 0.027,0.203 0.059,0.292 l -4.777,2.829 -0.221,0.128 c -0.154,-0.161 -0.373,-0.261 -0.617,-0.261 -0.248,0 -0.467,0.104 -0.623,0.27 l -5.117,-2.879 c 0.029,-0.087 0.057,-0.179 0.057,-0.277 0,-0.411 -0.303,-0.742 -0.695,-0.816 v -5.521 z m -5.565,38.571 c 0,-0.096 -0.023,-0.185 -0.053,-0.27 l 4.863,-2.774 c 0.117,0.117 0.275,0.183 0.441,0.218 v 5.521 c -0.189,0.037 -0.354,0.124 -0.479,0.268 l -4.805,-2.8 c 0.012,-0.054 0.033,-0.107 0.033,-0.163 z"
+ inkscape:connector-curvature="0"
+ style="fill:#3a8c9a" />
+ </g>
+ <g
+ id="g3747">
+ <path
+ id="path3735"
+ d="m 406.486,330.292 c -2.058,-2.827 -2.058,-2.827 -2.058,-2.827 h 4.02 c 1.562,0 2.226,0.697 2.226,2.261 v 10.401 c 0,0.466 0.266,0.731 0.732,0.731 h 1.328 v 3.554 h -4.021 c -1.563,0 -2.228,-0.662 -2.228,-2.26 v -11.86 z"
+ inkscape:connector-curvature="0"
+ style="fill:#0f262b" />
+ <polygon
+ id="polygon3737"
+ points="410.343,320.818 410.343,324.708 406.687,320.818 "
+ style="fill:#3a8c9a" />
+ <path
+ id="path3739"
+ d="m 416.356,330.82 -2.193,-3.355 h 2.293 v -4.621 h 4.123 v 4.621 h 3.854 v 3.355 h -3.854 v 6.85 c 0,2.787 2.19,3.188 3.354,3.188 0.465,0 0.766,-0.065 0.766,-0.065 v 3.689 c 0,0 -0.531,0.1 -1.293,0.1 -2.366,0 -7.05,-0.701 -7.05,-6.385 z"
+ inkscape:connector-curvature="0"
+ style="fill:#0f262b" />
+ <path
+ id="path3741"
+ d="m 428.652,330.82 -2.193,-3.355 h 2.293 v -4.621 h 4.123 v 4.621 h 3.855 v 3.355 h -3.855 v 6.85 c 0,2.787 2.191,3.188 3.355,3.188 0.465,0 0.768,-0.065 0.768,-0.065 v 3.689 c 0,0 -0.533,0.1 -1.301,0.1 -2.357,0 -7.045,-0.701 -7.045,-6.385 z"
+ inkscape:connector-curvature="0"
+ style="fill:#0f262b" />
+ <path
+ id="path3743"
+ d="m 448.193,327.064 c 5.184,0 9.309,3.691 9.309,8.877 0,5.218 -4.125,8.872 -9.309,8.872 -5.15,0 -9.27,-3.654 -9.27,-8.872 10e-4,-5.185 4.12,-8.877 9.27,-8.877 z m 0,14.161 c 2.762,0 5.053,-2.126 5.053,-5.283 0,-3.123 -2.291,-5.283 -5.053,-5.283 -2.727,0 -5.018,2.16 -5.018,5.283 10e-4,3.157 2.292,5.283 5.018,5.283 z"
+ inkscape:connector-curvature="0"
+ style="fill:#0f262b" />
+ <path
+ id="path3745"
+ d="m 391.214,327.082 c 3.685,0 4.878,2.061 4.878,2.061 h 0.069 c 0,0 -0.035,-0.434 -0.035,-0.998 v -4.596 l -2.06,-2.709 h 4.021 c 1.559,0 2.256,0.697 2.256,2.256 v 17.035 c 0,0.467 0.266,0.732 0.729,0.732 h 1.296 v 3.549 h -3.885 c -1.529,0 -2.091,-0.727 -2.091,-1.725 0,-0.365 0,-0.631 0,-0.631 h -0.065 c 0,0 -1.398,2.757 -5.281,2.757 -4.584,0 -7.537,-3.62 -7.537,-8.864 0,-5.381 3.219,-8.867 7.705,-8.867 z m 5.011,8.833 c 0,-2.622 -1.361,-5.214 -4.184,-5.214 -2.323,0 -4.251,1.891 -4.251,5.248 0,3.219 1.694,5.311 4.186,5.311 2.191,0 4.249,-1.595 4.249,-5.345 z"
+ inkscape:connector-curvature="0"
+ style="fill:#0f262b" />
+ </g>
+ </g>
+ </g>
+ </switch>
+ </g>
+</svg>
diff --git a/2.0/images/ditto_allwhite_symbolonly.svg b/2.0/images/ditto_allwhite_symbolonly.svg
new file mode 100644
index 0000000..1cd23d3
--- /dev/null
+++ b/2.0/images/ditto_allwhite_symbolonly.svg
@@ -0,0 +1,133 @@
+<?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:svg="http://www.w3.org/2000/svg"
+ 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="20.146963mm"
+ height="15.079926mm"
+ viewBox="0 0 20.146963 15.079926"
+ version="1.1"
+ id="svg71"
+ inkscape:version="0.92.2 (5c3e80d, 2017-08-06)"
+ sodipodi:docname="ditto_allwhite_symbolonly.svg">
+ <defs
+ id="defs65" />
+ <sodipodi:namedview
+ id="base"
+ pagecolor="#ffffff"
+ bordercolor="#666666"
+ borderopacity="1.0"
+ inkscape:pageopacity="0.0"
+ inkscape:pageshadow="2"
+ inkscape:zoom="3.959798"
+ inkscape:cx="43.404713"
+ inkscape:cy="-22.948143"
+ inkscape:document-units="mm"
+ inkscape:current-layer="g123"
+ showgrid="false"
+ inkscape:window-width="1920"
+ inkscape:window-height="1137"
+ inkscape:window-x="-8"
+ inkscape:window-y="-8"
+ inkscape:window-maximized="1" />
+ <metadata
+ id="metadata68">
+ <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></dc:title>
+ </cc:Work>
+ </rdf:RDF>
+ </metadata>
+ <g
+ inkscape:label="Layer 1"
+ inkscape:groupmode="layer"
+ id="layer1"
+ transform="translate(-76.105091,-47.149763)">
+ <g
+ id="g123"
+ transform="matrix(0.26458333,0,0,0.26458333,-25.196458,-19.11963)">
+ <g
+ id="g107">
+ <polygon
+ id="polygon73"
+ points="432.838,264.533 432.838,257.515 432.84,257.515 438.936,261.058 "
+ style="opacity:0.45;fill:#f9f9f9" />
+ <polygon
+ id="polygon75"
+ points="432.898,264.566 426.74,261.058 420.527,264.668 420.557,271.739 "
+ style="opacity:0.8;fill:#f9f9f9" />
+ <polygon
+ id="polygon77"
+ points="420.5,257.517 420.527,264.668 426.74,261.058 "
+ style="opacity:0.7;fill:#f9f9f9" />
+ <polygon
+ id="polygon79"
+ points="426.74,261.058 432.838,264.533 432.84,257.515 "
+ style="opacity:0.6;fill:#f9f9f9" />
+ <polygon
+ id="polygon81"
+ points="420.5,257.517 426.74,261.058 432.838,257.515 432.838,250.467 "
+ style="opacity:0.5;fill:#f9f9f9" />
+ <g
+ id="g87">
+ <polygon
+ id="polygon83"
+ points="432.838,293.394 426.74,296.869 420.527,293.259 420.557,286.188 "
+ style="opacity:0.8;fill:#f9f9f9" />
+ <polygon
+ id="polygon85"
+ points="420.5,300.412 420.527,293.259 426.74,296.869 "
+ style="opacity:0.7;fill:#f9f9f9" />
+ </g>
+ <path
+ id="path89"
+ d="m 408.187,250.467 -12.47,6.795 -12.84,7.302 v 0.131 l -0.005,-0.004 v 14.228 0.091 14.226 l 0.005,-0.002 v 0.131 l 12.84,7.302 12.473,6.795 12.332,-7.048 0.035,-6.877 v -7.348 l -12.431,7.173 -12.47,-7.555 v -0.128 -13.431 l 0.002,-0.124 12.468,-7.557 12.431,7.173 -0.03,-7.071 v -7.153 z m -25.188,28.476 0.04,0.021 -0.04,0.02 -0.036,-0.02 z"
+ inkscape:connector-curvature="0"
+ style="fill:#f9f9f9" />
+ <polygon
+ id="polygon91"
+ points="432.838,257.515 432.838,250.467 445.176,257.517 438.936,261.058 432.84,257.515 "
+ style="opacity:0.25;fill:#f9f9f9" />
+ <polygon
+ id="polygon93"
+ points="432.818,264.566 438.977,261.058 445.193,264.668 445.162,271.739 "
+ style="opacity:0.25;fill:#f9f9f9" />
+ <polygon
+ id="polygon95"
+ points="432.838,293.394 432.838,300.412 432.84,300.412 438.936,296.869 "
+ style="opacity:0.45;fill:#f9f9f9" />
+ <polygon
+ id="polygon97"
+ points="426.74,296.869 432.838,293.394 432.84,300.412 "
+ style="opacity:0.6;fill:#f9f9f9" />
+ <polygon
+ id="polygon99"
+ points="420.5,300.408 426.74,296.869 432.838,300.412 432.838,307.46 "
+ style="opacity:0.5;fill:#f9f9f9" />
+ <polygon
+ id="polygon101"
+ points="432.838,300.412 432.838,307.46 445.176,300.408 438.936,296.869 432.84,300.412 "
+ style="opacity:0.25;fill:#f9f9f9" />
+ <polygon
+ id="polygon103"
+ points="432.838,293.394 438.977,296.869 445.193,293.256 445.162,286.188 "
+ style="opacity:0.25;fill:#f9f9f9" />
+ <path
+ id="path105"
+ d="m 438.088,296.902 c 0,0.47 0.379,0.849 0.848,0.849 0.299,0 0.547,-0.163 0.699,-0.396 l 4.766,2.779 c -0.031,0.087 -0.057,0.181 -0.057,0.278 0,0.471 0.379,0.85 0.85,0.85 0.469,0 0.848,-0.379 0.848,-0.85 0,-0.091 -0.025,-0.174 -0.051,-0.257 l 11.506,-6.243 c 0.162,0.185 0.387,0.312 0.654,0.312 0.479,0 0.867,-0.386 0.867,-0.865 0,-0.425 -0.311,-0.76 -0.713,-0.834 l -0.002,-12.727 c 0.404,-0.074 0.715,-0.41 0.715,-0.834 0,-0.425 -0.311,-0.761 -0.715,-0.835 l 0.002,-12.727 c 0.402,-0.074 0.713,-0.409 0.713,-0.836 0,-0.479 -0.389,-0.865 -0.867,-0.865 -0.268,0 -0.492,0.129 -0.654,0.312 l -11.506,-6.241 c 0.025,-0.083 0.051,-0.166 0.051,-0.257 0,-0.471 -0.379,-0.85 -0.848,-0.85 -0.471,0 -0.85,0.379 -0.85,0.85 0,0.098 0.025,0.189 0.057,0.278 l -4.766,2.776 c -0.152,-0.232 -0.4,-0.394 -0.699,-0.394 -0.469,0 -0.848,0.379 -0.848,0.847 0,0.469 0.379,0.85 0.848,0.85 0.26,0 0.48,-0.124 0.639,-0.307 l 4.846,2.761 c -0.047,0.104 -0.076,0.22 -0.076,0.342 0,0.414 0.303,0.743 0.691,0.817 v 5.71 c -0.389,0.074 -0.691,0.402 -0.691,0.814 0,0.414 0.303,0.745 0.691,0.818 v 12.271 c -0.389,0.073 -0.691,0.402 -0.691,0.816 0,0.411 0.303,0.742 0.691,0.816 v 5.708 c -0.389,0.076 -0.691,0.403 -0.691,0.816 0,0.122 0.029,0.24 0.076,0.345 l -4.846,2.759 c -0.158,-0.183 -0.379,-0.307 -0.639,-0.307 -0.469,0.002 -0.848,0.383 -0.848,0.851 z m 6.947,-33.05 c -0.168,0.033 -0.324,0.101 -0.441,0.216 l -4.863,-2.772 c 0.029,-0.087 0.053,-0.174 0.053,-0.272 0,-0.057 -0.021,-0.106 -0.031,-0.163 l 4.805,-2.796 c 0.125,0.142 0.289,0.23 0.479,0.268 v 5.519 z m 12.959,1.55 v 12.729 c -0.188,0.037 -0.354,0.119 -0.475,0.255 l -4.988,-2.636 c 0.033,-0.096 0.061,-0.195 0.061,-0.303 0,-0.422 -0.309,-0.76 -0.709,-0.834 v -5.361 c 0.4,-0.074 0.709,-0.41 0.709,-0.834 0,-0.122 -0.027,-0.24 -0.072,-0.345 l 4.982,-2.946 c 0.125,0.146 0.295,0.238 0.492,0.275 z m -0.707,13.562 c 0,0.098 0.027,0.189 0.057,0.28 l -4.979,2.664 c -0.125,-0.14 -0.291,-0.227 -0.482,-0.264 v -5.364 c 0.191,-0.037 0.357,-0.124 0.482,-0.262 l 4.986,2.634 c -0.037,0.096 -0.064,0.201 -0.064,0.312 z m -4.767,10.887 c 0.045,-0.104 0.072,-0.223 0.072,-0.345 0,-0.422 -0.309,-0.758 -0.709,-0.832 v -5.361 c 0.4,-0.076 0.709,-0.414 0.709,-0.836 0,-0.104 -0.027,-0.205 -0.061,-0.303 l 4.971,-2.659 c 0.125,0.147 0.295,0.244 0.492,0.278 v 12.731 c -0.197,0.035 -0.367,0.127 -0.492,0.274 z m -7.172,4.224 c 0.391,-0.074 0.693,-0.405 0.693,-0.819 0,-0.096 -0.025,-0.187 -0.057,-0.274 l 5.119,-2.879 c 0.156,0.166 0.375,0.271 0.623,0.271 0.244,0 0.463,-0.103 0.617,-0.264 l 0.221,0.129 4.777,2.831 c -0.031,0.087 -0.059,0.187 -0.059,0.289 0,0.102 0.027,0.194 0.057,0.285 l -11.498,6.242 c -0.123,-0.152 -0.297,-0.253 -0.494,-0.29 v -5.521 z m 0.693,-8.16 c 0,-0.055 -0.021,-0.103 -0.029,-0.154 l 5.021,-2.788 c 0.127,0.179 0.314,0.299 0.541,0.34 v 5.359 c -0.215,0.042 -0.396,0.146 -0.521,0.312 l -5.041,-2.918 c 0.008,-0.051 0.029,-0.096 0.029,-0.151 z m -0.693,0.816 c 0.232,-0.043 0.424,-0.176 0.547,-0.37 l 5.018,2.901 c -0.025,0.078 -0.053,0.156 -0.053,0.243 0,0.122 0.025,0.235 0.07,0.34 l -5.102,2.864 c -0.121,-0.142 -0.287,-0.233 -0.48,-0.271 z m 0,-13.916 c 0.227,-0.046 0.424,-0.165 0.547,-0.357 l 5.008,2.781 c -0.018,0.07 -0.043,0.133 -0.043,0.209 0,0.425 0.311,0.76 0.715,0.834 v 5.359 c -0.404,0.077 -0.715,0.412 -0.715,0.835 0,0.076 0.025,0.139 0.043,0.209 l -5.008,2.78 c -0.123,-0.189 -0.32,-0.311 -0.547,-0.356 z m 0.693,-0.805 c 0,-0.053 -0.021,-0.101 -0.029,-0.15 l 5.041,-2.916 c 0.125,0.163 0.307,0.271 0.521,0.31 v 5.359 c -0.227,0.041 -0.414,0.163 -0.541,0.342 l -5.021,-2.79 c 0.008,-0.051 0.029,-0.099 0.029,-0.155 z m -0.693,-6.525 c 0.193,-0.035 0.359,-0.127 0.48,-0.271 l 5.102,2.866 c -0.045,0.104 -0.07,0.216 -0.07,0.338 0,0.087 0.027,0.167 0.053,0.246 l -5.018,2.898 c -0.123,-0.194 -0.314,-0.324 -0.547,-0.368 z m 0,-7.154 c 0.197,-0.039 0.371,-0.138 0.494,-0.29 l 11.498,6.242 c -0.029,0.089 -0.057,0.183 -0.057,0.283 0,0.104 0.027,0.202 0.059,0.291 l -4.777,2.829 -0.221,0.129 c -0.154,-0.161 -0.373,-0.262 -0.617,-0.262 -0.248,0 -0.467,0.104 -0.623,0.271 l -5.119,-2.879 c 0.031,-0.088 0.057,-0.179 0.057,-0.277 0,-0.411 -0.303,-0.742 -0.693,-0.816 v -5.521 z m -5.565,38.571 c 0,-0.097 -0.023,-0.186 -0.053,-0.271 l 4.863,-2.774 c 0.117,0.117 0.273,0.183 0.441,0.218 v 5.521 c -0.189,0.037 -0.354,0.124 -0.479,0.268 l -4.805,-2.8 c 0.012,-0.053 0.033,-0.105 0.033,-0.162 z"
+ inkscape:connector-curvature="0"
+ style="fill:#f9f9f9" />
+ </g>
+ </g>
+ </g>
+</svg>
diff --git a/2.0/images/ditto_allwhite_textonly.svg b/2.0/images/ditto_allwhite_textonly.svg
new file mode 100644
index 0000000..e2f3ca3
--- /dev/null
+++ b/2.0/images/ditto_allwhite_textonly.svg
@@ -0,0 +1,93 @@
+<?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:svg="http://www.w3.org/2000/svg"
+ 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="19.577579mm"
+ height="6.3486772mm"
+ viewBox="0 0 19.577579 6.348677"
+ version="1.1"
+ id="svg71"
+ sodipodi:docname="ditto_allwhite_textonly.svg"
+ inkscape:version="0.92.2 (5c3e80d, 2017-08-06)">
+ <defs
+ id="defs65" />
+ <sodipodi:namedview
+ id="base"
+ pagecolor="#ffffff"
+ bordercolor="#666666"
+ borderopacity="1.0"
+ inkscape:pageopacity="0.0"
+ inkscape:pageshadow="2"
+ inkscape:zoom="3.959798"
+ inkscape:cx="42.768713"
+ inkscape:cy="7.3564308"
+ inkscape:document-units="mm"
+ inkscape:current-layer="g123"
+ showgrid="false"
+ inkscape:window-width="1920"
+ inkscape:window-height="1137"
+ inkscape:window-x="-8"
+ inkscape:window-y="-8"
+ inkscape:window-maximized="1" />
+ <metadata
+ id="metadata68">
+ <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></dc:title>
+ </cc:Work>
+ </rdf:RDF>
+ </metadata>
+ <g
+ inkscape:label="Layer 1"
+ inkscape:groupmode="layer"
+ id="layer1"
+ transform="translate(-76.273366,-65.763465)">
+ <g
+ id="g123"
+ transform="matrix(0.26458333,0,0,0.26458333,-25.196458,-19.11963)">
+ <g
+ id="g121">
+ <path
+ id="path109"
+ d="m 406.487,330.292 c -2.059,-2.827 -2.059,-2.827 -2.059,-2.827 h 4.021 c 1.562,0 2.226,0.697 2.226,2.261 v 10.401 c 0,0.466 0.266,0.731 0.732,0.731 h 1.328 v 3.555 h -4.021 c -1.563,0 -2.228,-0.662 -2.228,-2.261 v -11.86 z"
+ inkscape:connector-curvature="0"
+ style="fill:#f9f9f9" />
+ <polygon
+ id="polygon111"
+ points="410.343,320.818 410.343,324.708 406.687,320.818 "
+ style="fill:#f9f9f9" />
+ <path
+ id="path113"
+ d="m 416.356,330.821 -2.192,-3.356 h 2.293 v -4.621 h 4.122 v 4.621 h 3.855 v 3.356 h -3.855 v 6.849 c 0,2.788 2.191,3.188 3.355,3.188 0.465,0 0.766,-0.065 0.766,-0.065 v 3.689 c 0,0 -0.531,0.101 -1.293,0.101 -2.366,0 -7.05,-0.701 -7.05,-6.386 v -7.376 z"
+ inkscape:connector-curvature="0"
+ style="fill:#f9f9f9" />
+ <path
+ id="path115"
+ d="m 428.652,330.821 -2.193,-3.356 h 2.293 v -4.621 h 4.123 v 4.621 h 3.855 v 3.356 h -3.855 v 6.849 c 0,2.788 2.191,3.188 3.355,3.188 0.465,0 0.768,-0.065 0.768,-0.065 v 3.689 c 0,0 -0.533,0.101 -1.301,0.101 -2.359,0 -7.045,-0.701 -7.045,-6.386 z"
+ inkscape:connector-curvature="0"
+ style="fill:#f9f9f9" />
+ <path
+ id="path117"
+ d="m 448.193,327.064 c 5.184,0 9.309,3.691 9.309,8.877 0,5.218 -4.125,8.872 -9.309,8.872 -5.15,0 -9.271,-3.654 -9.271,-8.872 0,-5.185 4.121,-8.877 9.271,-8.877 z m 0,14.161 c 2.762,0 5.053,-2.126 5.053,-5.283 0,-3.123 -2.291,-5.283 -5.053,-5.283 -2.727,0 -5.018,2.16 -5.018,5.283 10e-4,3.157 2.292,5.283 5.018,5.283 z"
+ inkscape:connector-curvature="0"
+ style="fill:#f9f9f9" />
+ <path
+ id="path119"
+ d="m 391.213,327.082 c 3.686,0 4.879,2.06 4.879,2.06 h 0.069 c 0,0 -0.035,-0.433 -0.035,-0.997 v -4.595 l -2.06,-2.71 h 4.02 c 1.56,0 2.257,0.697 2.257,2.257 v 17.034 c 0,0.467 0.266,0.732 0.729,0.732 h 1.296 v 3.55 h -3.886 c -1.528,0 -2.091,-0.728 -2.091,-1.726 0,-0.365 0,-0.631 0,-0.631 h -0.065 c 0,0 -1.397,2.757 -5.28,2.757 -4.585,0 -7.538,-3.619 -7.538,-8.863 0,-5.382 3.219,-8.868 7.705,-8.868 z m 5.012,8.833 c 0,-2.622 -1.361,-5.214 -4.184,-5.214 -2.324,0 -4.251,1.891 -4.251,5.249 0,3.219 1.694,5.309 4.186,5.309 2.191,0 4.249,-1.594 4.249,-5.344 z"
+ inkscape:connector-curvature="0"
+ style="fill:#f9f9f9" />
+ </g>
+ </g>
+ </g>
+</svg>
diff --git a/2.0/images/ditto_symbolonly.svg b/2.0/images/ditto_symbolonly.svg
new file mode 100644
index 0000000..c4ee7b2
--- /dev/null
+++ b/2.0/images/ditto_symbolonly.svg
@@ -0,0 +1,148 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+ xmlns:i="&#38;ns_ai;"
+ 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:svg="http://www.w3.org/2000/svg"
+ xmlns="http://www.w3.org/2000/svg"
+ xmlns:xlink="http://www.w3.org/1999/xlink"
+ xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+ xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+ width="20.146698mm"
+ height="15.079926mm"
+ viewBox="0 0 20.146698 15.079926"
+ version="1.1"
+ id="svg76"
+ inkscape:version="0.92.2 (5c3e80d, 2017-08-06)"
+ sodipodi:docname="ditto_symbolonly.svg">
+ <defs
+ id="defs70" />
+ <sodipodi:namedview
+ id="base"
+ pagecolor="#ffffff"
+ bordercolor="#666666"
+ borderopacity="1.0"
+ inkscape:pageopacity="0.0"
+ inkscape:pageshadow="2"
+ inkscape:zoom="0.35"
+ inkscape:cx="206.64393"
+ inkscape:cy="-271.5025"
+ inkscape:document-units="mm"
+ inkscape:current-layer="layer1"
+ showgrid="false"
+ inkscape:window-width="1920"
+ inkscape:window-height="1137"
+ inkscape:window-x="-8"
+ inkscape:window-y="-8"
+ inkscape:window-maximized="1" />
+ <metadata
+ id="metadata73">
+ <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></dc:title>
+ </cc:Work>
+ </rdf:RDF>
+ </metadata>
+ <g
+ inkscape:label="Layer 1"
+ inkscape:groupmode="layer"
+ id="layer1"
+ transform="translate(-51.158794,-61.91837)">
+ <switch
+ transform="matrix(0.26458333,0,0,0.26458333,-50.143019,-9.2926459)"
+ id="switch40">
+ <foreignObject
+ height="1"
+ width="1"
+ y="0"
+ x="0"
+ requiredExtensions="http://ns.adobe.com/AdobeIllustrator/10.0/">
+ <i:pgfRef
+ xlink:href="#adobe_illustrator_pgf" />
+ </foreignObject>
+ <g
+ id="g38"
+ i:extraneous="self">
+ <g
+ id="g36">
+ <polygon
+ style="opacity:0.45;fill:#3a8c9a"
+ id="polygon2"
+ points="432.838,283.21 432.838,276.191 432.84,276.191 438.936,279.734 " />
+ <polygon
+ style="opacity:0.8;fill:#3a8c9a"
+ id="polygon4"
+ points="432.898,283.243 426.74,279.734 420.527,283.345 420.557,290.417 " />
+ <polygon
+ style="opacity:0.7;fill:#3a8c9a"
+ id="polygon6"
+ points="426.74,279.734 420.5,276.193 420.527,283.345 " />
+ <polygon
+ style="opacity:0.6;fill:#3a8c9a"
+ id="polygon8"
+ points="432.84,276.191 426.74,279.734 432.838,283.21 " />
+ <polygon
+ style="opacity:0.5;fill:#3a8c9a"
+ id="polygon10"
+ points="420.5,276.193 426.74,279.734 432.838,276.191 432.838,269.144 " />
+ <g
+ id="g16">
+ <polygon
+ style="opacity:0.8;fill:#3a8c9a"
+ id="polygon12"
+ points="432.838,312.07 426.74,315.546 420.527,311.936 420.557,304.863 " />
+ <polygon
+ style="opacity:0.7;fill:#3a8c9a"
+ id="polygon14"
+ points="426.74,315.546 420.5,319.089 420.527,311.936 " />
+ </g>
+ <path
+ style="fill:#3a8c9a"
+ inkscape:connector-curvature="0"
+ id="path18"
+ d="m 408.188,269.144 -12.471,6.795 -12.84,7.302 v 0.131 l -0.004,-0.004 v 14.228 0.091 14.226 l 0.004,-0.002 v 0.13 l 12.84,7.303 12.473,6.795 12.334,-7.048 0.033,-6.877 v -7.349 l -12.43,7.174 -12.471,-7.555 v -0.129 -13.43 l 0.002,-0.124 12.469,-7.557 12.43,7.174 -0.029,-7.072 v -7.154 z M 383,297.621 l 0.039,0.02 -0.039,0.019 -0.037,-0.02 z" />
+ <polygon
+ style="opacity:0.25;fill:#3a8c9a"
+ id="polygon20"
+ points="432.838,269.144 445.176,276.193 438.936,279.734 432.84,276.191 432.838,276.191 " />
+ <polygon
+ style="opacity:0.25;fill:#3a8c9a"
+ id="polygon22"
+ points="432.818,283.243 438.977,279.734 445.193,283.345 445.162,290.417 " />
+ <polygon
+ style="opacity:0.45;fill:#3a8c9a"
+ id="polygon24"
+ points="432.838,312.07 432.838,319.089 432.84,319.089 438.936,315.546 " />
+ <polygon
+ style="opacity:0.6;fill:#3a8c9a"
+ id="polygon26"
+ points="432.84,319.089 426.74,315.546 432.838,312.07 " />
+ <polygon
+ style="opacity:0.5;fill:#3a8c9a"
+ id="polygon28"
+ points="420.5,319.085 426.74,315.546 432.838,319.089 432.838,326.137 " />
+ <polygon
+ style="opacity:0.25;fill:#3a8c9a"
+ id="polygon30"
+ points="432.838,326.137 445.176,319.085 438.936,315.546 432.84,319.089 432.838,319.089 " />
+ <polygon
+ style="opacity:0.25;fill:#3a8c9a"
+ id="polygon32"
+ points="432.838,312.07 438.977,315.546 445.193,311.934 445.162,304.863 " />
+ <path
+ style="fill:#3a8c9a"
+ inkscape:connector-curvature="0"
+ id="path34"
+ d="m 438.088,315.578 c 0,0.471 0.381,0.85 0.848,0.85 0.299,0 0.547,-0.163 0.699,-0.396 l 4.766,2.779 c -0.031,0.087 -0.057,0.181 -0.057,0.278 0,0.471 0.379,0.85 0.85,0.85 0.471,0 0.85,-0.379 0.85,-0.85 0,-0.092 -0.027,-0.174 -0.053,-0.257 l 11.508,-6.244 c 0.16,0.186 0.385,0.313 0.652,0.313 0.479,0 0.867,-0.387 0.867,-0.865 0,-0.424 -0.309,-0.76 -0.713,-0.834 l -0.002,-12.727 c 0.406,-0.074 0.715,-0.409 0.715,-0.834 0,-0.425 -0.309,-0.76 -0.715,-0.834 l 0.002,-12.727 c 0.404,-0.074 0.713,-0.41 0.713,-0.836 0,-0.479 -0.389,-0.865 -0.867,-0.865 -0.268,0 -0.492,0.128 -0.652,0.312 l -11.508,-6.242 c 0.025,-0.083 0.053,-0.166 0.053,-0.257 0,-0.47 -0.379,-0.849 -0.85,-0.849 -0.471,0 -0.85,0.379 -0.85,0.849 0,0.098 0.025,0.189 0.057,0.279 l -4.766,2.777 c -0.152,-0.233 -0.4,-0.395 -0.699,-0.395 -0.467,0 -0.848,0.379 -0.848,0.847 0,0.468 0.381,0.85 0.848,0.85 0.26,0 0.482,-0.125 0.639,-0.307 l 4.846,2.761 c -0.047,0.104 -0.076,0.22 -0.076,0.342 0,0.414 0.303,0.743 0.691,0.817 v 5.71 c -0.389,0.074 -0.691,0.403 -0.691,0.815 0,0.414 0.303,0.745 0.691,0.819 v 12.27 c -0.389,0.074 -0.691,0.402 -0.691,0.816 0,0.411 0.303,0.742 0.691,0.816 v 5.708 c -0.389,0.076 -0.691,0.403 -0.691,0.817 0,0.121 0.029,0.238 0.076,0.344 l -4.846,2.759 c -0.156,-0.183 -0.379,-0.308 -0.639,-0.308 -0.467,0 -0.848,0.381 -0.848,0.849 z m 6.947,-33.05 c -0.166,0.033 -0.324,0.1 -0.441,0.216 l -4.863,-2.772 c 0.029,-0.087 0.053,-0.174 0.053,-0.272 0,-0.057 -0.021,-0.106 -0.031,-0.163 l 4.805,-2.796 c 0.125,0.142 0.289,0.231 0.479,0.268 v 5.519 z m 12.959,1.551 v 12.729 c -0.188,0.037 -0.354,0.12 -0.475,0.255 l -4.988,-2.635 c 0.033,-0.096 0.063,-0.196 0.063,-0.303 0,-0.422 -0.311,-0.76 -0.711,-0.834 v -5.362 c 0.4,-0.074 0.711,-0.409 0.711,-0.834 0,-0.122 -0.029,-0.24 -0.074,-0.344 l 4.982,-2.946 c 0.127,0.145 0.297,0.237 0.492,0.274 z m -0.705,13.561 c 0,0.098 0.025,0.189 0.057,0.281 l -4.979,2.663 c -0.127,-0.139 -0.293,-0.227 -0.484,-0.264 v -5.363 c 0.191,-0.037 0.357,-0.124 0.484,-0.261 l 4.984,2.633 c -0.037,0.095 -0.062,0.2 -0.062,0.311 z m -4.769,10.887 c 0.045,-0.105 0.074,-0.223 0.074,-0.345 0,-0.423 -0.311,-0.758 -0.711,-0.832 v -5.361 c 0.4,-0.076 0.711,-0.414 0.711,-0.837 0,-0.104 -0.029,-0.204 -0.063,-0.303 l 4.971,-2.659 c 0.127,0.148 0.297,0.244 0.492,0.279 V 311.2 c -0.195,0.035 -0.365,0.127 -0.492,0.274 z m -7.172,4.225 c 0.393,-0.074 0.695,-0.405 0.695,-0.818 0,-0.097 -0.027,-0.188 -0.057,-0.275 l 5.117,-2.879 c 0.156,0.166 0.375,0.27 0.623,0.27 0.244,0 0.463,-0.102 0.617,-0.263 l 0.221,0.128 4.777,2.832 c -0.031,0.086 -0.059,0.188 -0.059,0.289 0,0.103 0.027,0.193 0.057,0.285 l -11.498,6.241 c -0.121,-0.152 -0.297,-0.252 -0.494,-0.289 v -5.521 z m 0.695,-8.16 c 0,-0.055 -0.023,-0.103 -0.031,-0.154 l 5.021,-2.788 c 0.127,0.179 0.314,0.298 0.541,0.34 v 5.359 c -0.215,0.042 -0.396,0.146 -0.521,0.312 l -5.041,-2.918 c 0.008,-0.052 0.031,-0.097 0.031,-0.151 z m -0.695,0.816 c 0.232,-0.043 0.424,-0.176 0.547,-0.37 l 5.018,2.901 c -0.023,0.078 -0.053,0.156 -0.053,0.243 0,0.122 0.025,0.235 0.07,0.34 l -5.102,2.864 c -0.121,-0.143 -0.287,-0.233 -0.48,-0.271 z m 0,-13.916 c 0.227,-0.046 0.424,-0.166 0.547,-0.357 l 5.008,2.781 c -0.018,0.07 -0.043,0.133 -0.043,0.209 0,0.425 0.311,0.76 0.715,0.834 v 5.359 c -0.404,0.076 -0.715,0.412 -0.715,0.834 0,0.076 0.025,0.14 0.043,0.209 l -5.008,2.781 c -0.123,-0.189 -0.32,-0.311 -0.547,-0.357 z m 0.695,-0.805 c 0,-0.052 -0.023,-0.101 -0.031,-0.15 l 5.041,-2.916 c 0.125,0.163 0.307,0.27 0.521,0.309 v 5.359 c -0.227,0.042 -0.414,0.164 -0.541,0.342 l -5.021,-2.79 c 0.008,-0.05 0.031,-0.098 0.031,-0.154 z m -0.695,-6.525 c 0.193,-0.035 0.359,-0.126 0.48,-0.27 l 5.102,2.866 c -0.045,0.104 -0.07,0.215 -0.07,0.337 0,0.087 0.029,0.167 0.053,0.246 l -5.018,2.898 c -0.123,-0.194 -0.314,-0.324 -0.547,-0.368 z m 0,-7.154 c 0.197,-0.04 0.373,-0.137 0.494,-0.29 l 11.498,6.242 c -0.029,0.089 -0.057,0.183 -0.057,0.283 0,0.104 0.027,0.203 0.059,0.292 l -4.777,2.829 -0.221,0.128 c -0.154,-0.161 -0.373,-0.261 -0.617,-0.261 -0.248,0 -0.467,0.104 -0.623,0.27 l -5.117,-2.879 c 0.029,-0.087 0.057,-0.179 0.057,-0.277 0,-0.411 -0.303,-0.742 -0.695,-0.816 v -5.521 z m -5.565,38.57 c 0,-0.096 -0.023,-0.185 -0.053,-0.27 l 4.863,-2.774 c 0.117,0.117 0.275,0.183 0.441,0.218 v 5.521 c -0.189,0.037 -0.354,0.124 -0.479,0.268 l -4.805,-2.8 c 0.012,-0.053 0.033,-0.106 0.033,-0.163 z" />
+ </g>
+ </g>
+ </switch>
+ </g>
+</svg>
diff --git a/2.0/images/ditto_textonly.svg b/2.0/images/ditto_textonly.svg
new file mode 100644
index 0000000..4ef518f
--- /dev/null
+++ b/2.0/images/ditto_textonly.svg
@@ -0,0 +1,108 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+ xmlns:i="&#38;ns_ai;"
+ 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:svg="http://www.w3.org/2000/svg"
+ xmlns="http://www.w3.org/2000/svg"
+ xmlns:xlink="http://www.w3.org/1999/xlink"
+ xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+ xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+ width="19.577314mm"
+ height="6.3486772mm"
+ viewBox="0 0 19.577314 6.3486772"
+ version="1.1"
+ id="svg128"
+ inkscape:version="0.92.2 (5c3e80d, 2017-08-06)"
+ sodipodi:docname="ditto_textonly.svg">
+ <defs
+ id="defs122" />
+ <sodipodi:namedview
+ id="base"
+ pagecolor="#ffffff"
+ bordercolor="#666666"
+ borderopacity="1.0"
+ inkscape:pageopacity="0.0"
+ inkscape:pageshadow="2"
+ inkscape:zoom="0.35"
+ inkscape:cx="42.710785"
+ inkscape:cy="-205.14536"
+ inkscape:document-units="mm"
+ inkscape:current-layer="layer1"
+ showgrid="false"
+ inkscape:window-width="1920"
+ inkscape:window-height="1137"
+ inkscape:window-x="-8"
+ inkscape:window-y="-8"
+ inkscape:window-maximized="1" />
+ <metadata
+ id="metadata125">
+ <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></dc:title>
+ </cc:Work>
+ </rdf:RDF>
+ </metadata>
+ <g
+ inkscape:label="Layer 1"
+ inkscape:groupmode="layer"
+ id="layer1"
+ transform="translate(-94.532771,-88.206614)">
+ <switch
+ transform="matrix(0.26458333,0,0,0.26458333,-7.0537336,12.630238)"
+ id="switch18">
+ <foreignObject
+ height="1"
+ width="1"
+ y="0"
+ x="0"
+ requiredExtensions="http://ns.adobe.com/AdobeIllustrator/10.0/">
+ <i:pgfRef
+ xlink:href="#adobe_illustrator_pgf" />
+ </foreignObject>
+ <g
+ id="g16"
+ i:extraneous="self">
+ <g
+ id="g14">
+ <path
+ style="fill:#0f262b"
+ inkscape:connector-curvature="0"
+ id="path2"
+ d="m 406.926,295.116 c -2.057,-2.827 -2.057,-2.827 -2.057,-2.827 h 4.02 c 1.561,0 2.225,0.697 2.225,2.261 v 10.401 c 0,0.466 0.266,0.731 0.732,0.731 h 1.328 v 3.554 h -4.02 c -1.564,0 -2.229,-0.662 -2.229,-2.26 v -11.86 z" />
+ <polygon
+ style="fill:#3a8c9a"
+ id="polygon4"
+ points="407.127,285.643 410.783,285.643 410.783,289.532 " />
+ <path
+ style="fill:#0f262b"
+ inkscape:connector-curvature="0"
+ id="path6"
+ d="m 416.797,295.645 -2.193,-3.355 h 2.293 v -4.621 h 4.123 v 4.621 h 3.854 v 3.355 h -3.854 v 6.85 c 0,2.787 2.189,3.188 3.354,3.188 0.465,0 0.766,-0.065 0.766,-0.065 v 3.689 c 0,0 -0.531,0.1 -1.293,0.1 -2.365,0 -7.049,-0.701 -7.049,-6.385 v -7.377 z" />
+ <path
+ style="fill:#0f262b"
+ inkscape:connector-curvature="0"
+ id="path8"
+ d="m 429.092,295.645 -2.193,-3.355 h 2.293 v -4.621 h 4.123 v 4.621 h 3.855 v 3.355 h -3.855 v 6.85 c 0,2.787 2.191,3.188 3.355,3.188 0.465,0 0.768,-0.065 0.768,-0.065 v 3.689 c 0,0 -0.533,0.1 -1.301,0.1 -2.357,0 -7.045,-0.701 -7.045,-6.385 z" />
+ <path
+ style="fill:#0f262b"
+ inkscape:connector-curvature="0"
+ id="path10"
+ d="m 448.633,291.889 c 5.184,0 9.309,3.691 9.309,8.877 0,5.218 -4.125,8.872 -9.309,8.872 -5.15,0 -9.27,-3.654 -9.27,-8.872 0,-5.186 4.119,-8.877 9.27,-8.877 z m 0,14.16 c 2.762,0 5.053,-2.126 5.053,-5.283 0,-3.123 -2.291,-5.283 -5.053,-5.283 -2.727,0 -5.018,2.16 -5.018,5.283 0,3.157 2.291,5.283 5.018,5.283 z" />
+ <path
+ style="fill:#0f262b"
+ inkscape:connector-curvature="0"
+ id="path12"
+ d="m 391.654,291.906 c 3.684,0 4.877,2.061 4.877,2.061 h 0.07 c 0,0 -0.035,-0.434 -0.035,-0.998 v -4.596 l -2.061,-2.709 h 4.021 c 1.559,0 2.256,0.697 2.256,2.256 v 17.035 c 0,0.467 0.266,0.732 0.729,0.732 h 1.297 v 3.549 h -3.885 c -1.529,0 -2.092,-0.727 -2.092,-1.725 0,-0.365 0,-0.631 0,-0.631 h -0.064 c 0,0 -1.398,2.757 -5.281,2.757 -4.584,0 -7.537,-3.62 -7.537,-8.864 0,-5.38 3.219,-8.867 7.705,-8.867 z m 5.01,8.833 c 0,-2.622 -1.361,-5.214 -4.184,-5.214 -2.322,0 -4.25,1.891 -4.25,5.248 0,3.219 1.693,5.311 4.186,5.311 2.191,0 4.248,-1.595 4.248,-5.345 z" />
+ </g>
+ </g>
+ </switch>
+ </g>
+</svg>
diff --git a/2.0/images/eclipse_foundation_logo.svg b/2.0/images/eclipse_foundation_logo.svg
new file mode 100644
index 0000000..d1f4211
--- /dev/null
+++ b/2.0/images/eclipse_foundation_logo.svg
@@ -0,0 +1,38 @@
+<?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="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
+ width="270.825px" height="93.432px" viewBox="0 0 270.825 93.432" enable-background="new 0 0 270.825 93.432"
+ xml:space="preserve">
+<g>
+ <path fill="#F79322" d="M267.165,86.697l-8.675-10.993h-2.707v17.728h3.338V81.479l9.308,11.952h2.074V75.704h-3.338V86.697z
+ M234.752,78.411c4.173,0,5.843,3.337,5.792,6.322c-0.052,2.907-1.619,6.044-5.792,6.044c-4.174,0-5.74-3.111-5.816-6.02
+ C228.858,81.774,230.578,78.411,234.752,78.411 M234.752,75.375c-6.12,0-9.104,4.679-9.104,9.332c0,4.654,2.882,9.129,9.104,9.129
+ s9.027-4.577,9.078-9.154C243.882,80.054,240.847,75.375,234.752,75.375 M213.518,75.704h-3.313v17.728h3.313V75.704z
+ M189.957,93.432h3.339V78.739h5.613v-3.035h-14.566v3.035h5.614V93.432z M171.05,86.984h-6.575l3.287-7.555L171.05,86.984z
+ M173.882,93.432h3.643l-7.94-17.728h-3.643l-7.942,17.728h3.617l1.518-3.338h9.256L173.882,93.432z M135.88,78.866h3.641
+ c3.845,0,5.462,2.761,5.539,5.524c0.076,2.893-1.518,5.829-5.539,5.829h-3.641V78.866z M139.521,75.704h-6.955v17.728h6.955
+ c6.197,0,8.928-4.525,8.853-9.016C148.298,80.029,145.592,75.704,139.521,75.704 M117.149,86.697l-8.674-10.993h-2.706v17.728
+ h3.338V81.479l9.306,11.952h2.074V75.704h-3.338V86.697z M89.694,75.754v10.143c0,3.035-1.569,4.881-4.324,4.881
+ c-2.758,0-4.578-1.695-4.578-4.881V75.754h-3.313v10.143c0,5.336,3.616,7.916,7.865,7.916c4.45,0,7.662-2.681,7.662-7.916V75.754
+ H89.694z M56.7,78.411c4.174,0,5.843,3.337,5.792,6.322c-0.051,2.907-1.618,6.044-5.792,6.044c-4.172,0-5.74-3.111-5.816-6.02
+ C50.808,81.774,52.527,78.411,56.7,78.411 M56.7,75.375c-6.12,0-9.104,4.679-9.104,9.332c0,4.654,2.883,9.129,9.104,9.129
+ c6.221,0,9.029-4.577,9.079-9.154C65.83,80.054,62.794,75.375,56.7,75.375 M26.917,93.432v-6.55h8.877v-3.086h-8.877v-4.83H36.3
+ v-3.212H23.58v17.678H26.917z"/>
+ <path fill="#3D3C3B" d="M270.825,57.147h-22.167v-8.912h21.378v-6.938h-21.378v-9.137h22.167V24.94h-29.555v39.54h29.555V57.147z
+ M230.85,31.483c-2.989-6.091-9.363-7.839-15.512-7.839c-7.275,0.056-15.285,3.384-15.285,11.506
+ c0,8.856,7.445,10.999,15.512,11.957c5.245,0.564,9.137,2.088,9.137,5.81c0,4.287-4.4,5.923-9.081,5.923
+ c-4.795,0-9.363-1.918-11.112-6.261l-6.203,3.215c2.933,7.219,9.138,9.702,17.203,9.702c8.799,0,16.583-3.78,16.583-12.579
+ c0-9.419-7.671-11.562-15.906-12.578c-4.738-0.564-8.8-1.523-8.8-4.963c0-2.934,2.651-5.247,8.18-5.247
+ c4.286,0,8.009,2.144,9.363,4.4L230.85,31.483z M177.505,24.94c-6.205-0.056-12.409,0-18.612,0v39.54h7.444V52.861h11.168
+ C196.853,52.861,196.795,24.94,177.505,24.94 M166.337,32.048h11.168c9.477,0,9.532,13.988,0,13.988h-11.168V32.048z
+ M148.359,24.94h-7.39v39.54h7.39V24.94z M104.378,24.94v39.54h27.751v-6.881h-20.306V24.94H104.378z M92.153,54.384
+ c-2.595,2.595-6.487,4.004-9.928,4.004c-9.757,0-13.537-6.824-13.593-13.367c-0.057-6.6,4.061-13.706,13.593-13.706
+ c3.441,0,6.938,1.184,9.533,3.722l4.963-4.794c-4.06-4.005-9.137-6.036-14.496-6.036c-14.27,0-20.982,10.492-20.925,20.814
+ c0.055,10.265,6.261,20.361,20.925,20.361c5.697,0,10.943-1.861,15.004-5.866L92.153,54.384z M53.136,57.147H30.969v-8.912h21.377
+ v-6.938H30.969v-9.137h22.167V24.94H23.579v39.54h29.557V57.147z"/>
+ <path fill="#F79322" d="M11.259,20.922C20.304,6.818,38.412,1.892,53.515,8.669c-0.334-0.232-0.669-0.466-1.014-0.688
+ C37.037-1.936,16.486,2.52,6.6,17.934c-9.885,15.415-5.363,35.951,10.102,45.869c0.346,0.223,0.698,0.429,1.049,0.636
+ C5.29,53.54,2.214,35.026,11.259,20.922"/>
+</g>
+</svg>
diff --git a/2.0/images/favicon-16x16.png b/2.0/images/favicon-16x16.png
new file mode 100644
index 0000000..0cfb7fb
--- /dev/null
+++ b/2.0/images/favicon-16x16.png
Binary files differ
diff --git a/2.0/images/favicon-32x32.png b/2.0/images/favicon-32x32.png
new file mode 100644
index 0000000..3fdcde9
--- /dev/null
+++ b/2.0/images/favicon-32x32.png
Binary files differ
diff --git a/2.0/images/favicon-96x96.png b/2.0/images/favicon-96x96.png
new file mode 100644
index 0000000..51afc72
--- /dev/null
+++ b/2.0/images/favicon-96x96.png
Binary files differ
diff --git a/2.0/images/iot_logo.svg b/2.0/images/iot_logo.svg
new file mode 100755
index 0000000..e30be71
--- /dev/null
+++ b/2.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/2.0/images/pages/advanced/data-by-pass-architectural-design.jpg b/2.0/images/pages/advanced/data-by-pass-architectural-design.jpg
new file mode 100644
index 0000000..b758d2d
--- /dev/null
+++ b/2.0/images/pages/advanced/data-by-pass-architectural-design.jpg
Binary files differ
diff --git a/2.0/images/pages/architecture/context-overview-initial.png b/2.0/images/pages/architecture/context-overview-initial.png
new file mode 100644
index 0000000..7542dea
--- /dev/null
+++ b/2.0/images/pages/architecture/context-overview-initial.png
Binary files differ
diff --git a/2.0/images/pages/architecture/context-overview.png b/2.0/images/pages/architecture/context-overview.png
new file mode 100755
index 0000000..86023bd
--- /dev/null
+++ b/2.0/images/pages/architecture/context-overview.png
Binary files differ
diff --git a/2.0/images/pages/basic/ditto-class-diagram-v2.png b/2.0/images/pages/basic/ditto-class-diagram-v2.png
new file mode 100755
index 0000000..5a1d4ab
--- /dev/null
+++ b/2.0/images/pages/basic/ditto-class-diagram-v2.png
Binary files differ
diff --git a/2.0/images/pages/basic/ditto-messages.png b/2.0/images/pages/basic/ditto-messages.png
new file mode 100644
index 0000000..5f38d40
--- /dev/null
+++ b/2.0/images/pages/basic/ditto-messages.png
Binary files differ
diff --git a/2.0/images/pages/basic/ditto-thing-feature-definition-model.png b/2.0/images/pages/basic/ditto-thing-feature-definition-model.png
new file mode 100644
index 0000000..1ad636e
--- /dev/null
+++ b/2.0/images/pages/basic/ditto-thing-feature-definition-model.png
Binary files differ
diff --git a/2.0/images/pages/basic/ditto-thing-feature.png b/2.0/images/pages/basic/ditto-thing-feature.png
new file mode 100644
index 0000000..cb531ed
--- /dev/null
+++ b/2.0/images/pages/basic/ditto-thing-feature.png
Binary files differ
diff --git a/2.0/images/pages/basic/policy-example-2.png b/2.0/images/pages/basic/policy-example-2.png
new file mode 100644
index 0000000..2bb73e2
--- /dev/null
+++ b/2.0/images/pages/basic/policy-example-2.png
Binary files differ
diff --git a/2.0/images/pages/basic/policy-example.png b/2.0/images/pages/basic/policy-example.png
new file mode 100644
index 0000000..9fa4400
--- /dev/null
+++ b/2.0/images/pages/basic/policy-example.png
Binary files differ
diff --git a/2.0/images/pages/protocol/ditto-live-channel.png b/2.0/images/pages/protocol/ditto-live-channel.png
new file mode 100644
index 0000000..e6648eb
--- /dev/null
+++ b/2.0/images/pages/protocol/ditto-live-channel.png
Binary files differ
diff --git a/2.0/images/pages/protocol/ditto-twin-channel.png b/2.0/images/pages/protocol/ditto-twin-channel.png
new file mode 100644
index 0000000..229ba85
--- /dev/null
+++ b/2.0/images/pages/protocol/ditto-twin-channel.png
Binary files differ
diff --git a/2.0/index.html b/2.0/index.html
new file mode 100644
index 0000000..663ce23
--- /dev/null
+++ b/2.0/index.html
@@ -0,0 +1,315 @@
+<!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="Eclipse Ditto™ is an open source framework for creating and managing digital twins in the IoT.">
+<meta name="keywords" content=" ditto, digital twin, iot, twin, eclipse ditto, eclipse iot, opensource, open source">
+<title>Eclipse Ditto™ • open source framework for digital twins in the IoT</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>
+ $(function () {
+ $('[data-toggle="tooltip"]').tooltip()
+ })
+ </script>
+ <script src="//iot.eclipse.org/assets/js/eclipsefdn.adopters.js"></script>
+ <script>
+ eclipseFdnAdopters.getList({
+ project_id: "iot.ditto",
+ selector: ".who .user-logos-container",
+ ul_classes: "user-logos",
+ logo_white: true
+ });
+ </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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="">{title}</a></li>',
+ noResultsText: 'No results found.',
+ limit: 10,
+ fuzzy: true,
+ })
+ </script>
+ <!--end search-->
+ </li>
+ </ul>
+ </div>
+ </div>
+ <!-- /.container -->
+</nav>
+
+
+<div class="startpage">
+ <header class="ditto-header">
+ <div class="container">
+ <div class="row">
+ <div class="col-lg-12 text-center">
+ <img src="images/ditto.svg" class="img-fluid ditto-logo" alt="Eclipse Ditto">
+ <h1>… where IoT devices and their digital twins get together</h1>
+ </div>
+ </div>
+ </div>
+</header>
+
+<div class="container info-container">
+ <div class="row">
+ <div class="col-md-4 col-sm-6">
+ <div class="panel panel-default text-center">
+ <div class="panel-heading">
+ <span class="fa-stack fa-5x">
+ <i class="fa fa-circle fa-stack-2x text-primary"></i>
+ <i class="fa fa-globe fa-stack-1x fa-inverse"></i>
+ </span>
+ </div>
+ <div class="panel-body">
+ <h4>Device-as-a-Service</h4>
+ <p>Provide a higher abstraction level in form of an API used to work with individual devices.</p>
+ <!--<a href="#" class="btn btn-primary">Learn More</a>-->
+ </div>
+ </div>
+ </div>
+ <div class="col-md-4 col-sm-6">
+ <div class="panel panel-default text-center">
+ <div class="panel-heading">
+ <span class="fa-stack fa-5x">
+ <i class="fa fa-circle fa-stack-2x text-primary"></i>
+ <i class="fa fa-database fa-stack-1x fa-inverse"></i>
+ </span>
+ </div>
+ <div class="panel-body">
+ <h4>State management for digital twins</h4>
+ <p>Differ between reported (last known), desired (target) and current state (live) of devices, including support for synchronization and publishing of state changes.</p>
+ <!--<a href="#" class="btn btn-primary">Learn More</a>-->
+ </div>
+ </div>
+ </div>
+ <div class="col-md-4 col-sm-6">
+ <div class="panel panel-default text-center">
+ <div class="panel-heading">
+ <span class="fa-stack fa-5x">
+ <i class="fa fa-circle fa-stack-2x text-primary"></i>
+ <i class="fa fa-search fa-stack-1x fa-inverse"></i>
+ </span>
+ </div>
+ <div class="panel-body">
+ <h4>Organize your set of digital twins</h4>
+ <p>Support finding and selecting sets of digital twins by providing search functionality on metadata and state data.</p>
+ <!--<a href="#" class="btn btn-primary">Learn More</a>-->
+ </div>
+ </div>
+ </div>
+ </div>
+</div>
+
+<div class="row highlight who">
+ <div class="container">
+ <h2>Who's using Eclipse Ditto™?</h2>
+ <div class="row user-logos-container">
+ </div>
+ <p>Add your logo as <a href="https://iot.eclipse.org/adopters/" target="_blank">adopter/user</a> of Eclipse Ditto to this list.</p>
+ </div>
+</div>
+
+<div class="container">
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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>
+
+</div>
+
+</body>
+</html>
diff --git a/2.0/installation-building.html b/2.0/installation-building.html
new file mode 100644
index 0000000..7eb9401
--- /dev/null
+++ b/2.0/installation-building.html
@@ -0,0 +1,1822 @@
+<!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="getting_startedinstallation, installation, docker, maven">
+<title> Building Ditto • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Building Ditto">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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 class="active"><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Building Ditto</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="building-with-apache-maven">Building with Apache Maven</h2>
+
+<p>In order to build Ditto with Maven, you’ll need:</p>
+<ul>
+ <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>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>
+
+<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.</p>
+
+<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.6-jdk-11 <span class="se">\</span>
+ mvn clean install
+
+<span class="nb">cd </span>services
+sh build-images.sh
+</code></pre></div></div>
+
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_getting_started.html" class="btn btn-default navbar-btn cursorNorm" role="button">getting_started</a>
+
+
+
+ <a href="tag_installation.html" class="btn btn-default navbar-btn cursorNorm" role="button">installation</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/installation-operating.html b/2.0/installation-operating.html
new file mode 100644
index 0000000..d8c5922
--- /dev/null
+++ b/2.0/installation-operating.html
@@ -0,0 +1,2717 @@
+<!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="installation, operating, docker, docker-compose, devops, logging, logstash, elk, monitoring, prometheus, grafana">
+<title> Operating Ditto • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Operating Ditto">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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 class="active"><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Operating Ditto</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>Once you have successfully started Ditto, proceed with setting it up for continuous operation.</p>
+
+<p>This page shows the basics for operating Ditto.</p>
+
+<h2 id="configuration">Configuration</h2>
+
+<p>Ditto has many config parameters which can be set in the config files or via environment variables.
+This section will cover some of Ditto’s config parameters.</p>
+
+<h3 id="mongodb-configuration">MongoDB configuration</h3>
+<p>If you choose not to use the MongoDB container and instead use a dedicated MongoDB you can use
+the following environment variables in order to configure the connection to the MongoDB.</p>
+
+<ul>
+ <li>MONGO_DB_URI: Connection string to MongoDB</li>
+ <li>MONGO_DB_SSL_ENABLED: Enabled SSL connection to MongoDB</li>
+ <li>MONGO_DB_CONNECTION_POOL_SIZE: Configure MongoDB connection pool size</li>
+ <li>MONGO_DB_READ_PREFERENCE: Configure MongoDB read preference</li>
+ <li>MONGO_DB_WRITE_CONCERN: Configure MongoDB write concern</li>
+ <li>AKKA_PERSISTENCE_MONGO_JOURNAL_WRITE_CONCERN: Configure Akka Persistence MongoDB journal write concern</li>
+ <li>AKKA_PERSISTENCE_MONGO_SNAPS_WRITE_CONCERN: Configure Akka Persistence MongoDB snapshot write concern</li>
+</ul>
+
+<h3 id="ditto-configuration">Ditto configuration</h3>
+
+<p>Each of Ditto’s microservice has many options for configuration, e.g. timeouts, cache sizes, etc.</p>
+
+<p>In order to have a look at all possible configuration options and what default values they have, here are the
+configuration files of Ditto’s microservices:</p>
+<ul>
+ <li>Policies: <a href="https://github.com/eclipse/ditto/blob/master/services/policies/starter/src/main/resources/policies.conf">policies.conf</a></li>
+ <li>Things: <a href="https://github.com/eclipse/ditto/blob/master/services/things/starter/src/main/resources/things.conf">things.conf</a></li>
+ <li>Things-Search: <a href="https://github.com/eclipse/ditto/blob/master/services/thingsearch/starter/src/main/resources/things-search.conf">things-search.conf</a></li>
+ <li>Concierge: <a href="https://github.com/eclipse/ditto/blob/master/services/concierge/starter/src/main/resources/concierge.conf">concierge.conf</a></li>
+ <li>Connectivity: <a href="https://github.com/eclipse/ditto/blob/master/services/connectivity/starter/src/main/resources/connectivity.conf">connectivity.conf</a></li>
+ <li>Gateway: <a href="https://github.com/eclipse/ditto/blob/master/services/gateway/starter/src/main/resources/gateway.conf">gateway.conf</a></li>
+</ul>
+
+<p>Whenever you find the syntax <code class="highlighter-rouge">${?UPPER_CASE_ENV_NAME}</code> in the configuration files, you may overwrite the default value
+by specifying that environment variable when running the container.</p>
+
+<p>When no environment variable is defined in the config, you may change the default value anyway by specifying a
+“System property” you pass to the Java process.</p>
+
+<p>The following example configures the devops password of the gateway-service started via docker-compose. In order
+to supply additional configuration one has to add the variable in the corresponding <code class="highlighter-rouge">command</code> section of the
+<code class="highlighter-rouge">docker-compose.yml</code> file.</p>
+
+<div class="language-yml highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nn">...</span>
+<span class="c1"># Alternative approach for configuration of the service</span>
+<span class="na">command</span><span class="pi">:</span> <span class="s">java -Dditto.gateway.authentication.devops.password=foobar -jar starter.jar</span>
+</code></pre></div></div>
+
+<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.
+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#subjects">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.
+<code class="highlighter-rouge">auth-subjects</code>, an optional field, takes a list of placeholders that will be
+evaluated against incoming JWT’s.
+For each entry in <code class="highlighter-rouge">auth-subjects</code> and authorization subject will be generated.
+If the entry contains unresolvable placeholders, it will be ignored in full.
+When <code class="highlighter-rouge">auth-subjects</code> is not provided, the “sub” claim (<code class="highlighter-rouge">{{ jwt:sub }}</code>) is used by default.</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ditto.gateway.authentication {
+ oauth {
+ openid-connect-issuers = {
+ myprovider = {
+ issuer = "localhost:9000"
+ auth-subjects = [
+ "{{ jwt:sub }}",
+ "{{ jwt:sub }}/{{ jwt:scp }}",
+ "{{ jwt:sub }}/{{ jwt:scp }}@{{ jwt:client_id }}",
+ "{{ jwt:sub }}/{{ jwt:scp }}@{{ jwt:non_existing }}",
+ "{{ jwt:roles/support }}"
+ ]
+ }
+ }
+ }
+}
+</code></pre></div></div>
+
+<p>In order to do this by specifying a Java system property, use the following:</p>
+
+<div class="language-shell highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nt">-Dditto</span>.gateway.authentication.oauth.openid-connect-issuers.myprovider.issuer<span class="o">=</span>localhost:9000
+<span class="nt">-Dditto</span>.gateway.authentication.oauth.openid-connect-issuers.myprovider.auth-subjects.0<span class="o">=</span><span class="s1">'{{ jwt:sub }}/{{ jwt:scp }}'</span>
+
+</code></pre></div></div>
+
+<p>The configured subject-issuer will be used to prefix the value of each individual <code class="highlighter-rouge">auth-subject</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">"subjects"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"<provider>:<auth-subject-0>"</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">"generated"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="err">...</span><span class="w">
+ </span><span class="s2">"<provider>:<auth-subject-n>"</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">"generated"</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>As of the OAuth2.0 and OpenID Connect standards Ditto expects the headers <code class="highlighter-rouge">Authorization: Bearer <JWT></code> and
+<code class="highlighter-rouge">Content-Type: application/json</code>, containing the issued token of the provider.</p>
+
+<p><strong>The token has to be issued beforehand. The required logic is not provided by Ditto.</strong> When using
+the OIDC provider <a href="https://www.keycloak.org/">keycloak</a>, a project like <a href="https://github.com/keycloak/keycloak-gatekeeper">keycloak-gatekeeper</a>
+may be put in front of Ditto to handle the token-logic.</p>
+
+<p><strong>If the chosen OIDC provider uses a self-signed certificate</strong>, the certificate has to be retrieved and configured for
+the akka-http ssl configuration.</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ssl-config {
+ trustManager = {
+ stores = [
+ { type = "PEM", path = "/path/to/cert/globalsign.crt" }
+ ]
+ }
+}
+</code></pre></div></div>
+
+<h2 id="logging">Logging</h2>
+
+<p>Gathering logs for a running Ditto installation can be achieved by:</p>
+
+<ul>
+ <li>grepping log output from STDOUT/STDERR via Docker’s <a href="https://docs.docker.com/engine/admin/logging/overview/">logging drivers</a>
+ <ul>
+ <li>Benefits: simple, works with all Docker logging drivers (e.g. “awslogs”, “splunk”, etc.)</li>
+ </ul>
+ </li>
+</ul>
+
+<p>This option may also use an ELK stack with the right Docker logging driver.</p>
+
+<h2 id="monitoring">Monitoring</h2>
+
+<p>In addition to logging, the Ditto images include monitoring features. Specific metrics are
+automatically gathered and published on a HTTP port. There it can be scraped by a <a href="https://prometheus.io">Prometheus</a>
+backend, from where the metrics can be accessed to display in dashboards (e.g. with <a href="https://grafana.com">Grafana</a>).</p>
+
+<h3 id="configuring">Configuring</h3>
+
+<p>In the default configuration, each Ditto service opens a HTTP endpoint, where it provides the Prometheus metrics
+on port <code class="highlighter-rouge">9095</code>. This can be changed via the environment variable <code class="highlighter-rouge">PROMETHEUS_PORT</code>.</p>
+
+<p>Ditto will automatically publish gathered metrics at the endpoint <code class="highlighter-rouge">http://<container-host-or-ip>:9095/</code>.</p>
+
+<p>Further, Prometheus can be configured to poll on all Ditto service endpoints in order to persist the historical metrics.
+Grafana can add a Prometheus server as its data source and can display
+the metrics based on the keys mentioned in section <a href="#gathered-metrics">“Gathered metrics”</a>.</p>
+
+<h3 id="gathered-metrics">Gathered metrics</h3>
+
+<p>In order to inspect which metrics are exported to Prometheus, just visit the Prometheus HTTP endpoint of a Ditto service:
+<code class="highlighter-rouge">http://<container-host-or-ip>:9095/</code>.</p>
+
+<p>The following example shows an excerpt of metrics gathered for the
+<a href="architecture-services-gateway.html">gateway-service</a>.</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>#Kamon Metrics
+# TYPE jvm_threads gauge
+jvm_threads{component="system-metrics",measure="total"} 72.0
+# TYPE jvm_memory_buffer_pool_count gauge
+jvm_memory_buffer_pool_count{component="system-metrics",pool="direct"} 14.0
+# TYPE jvm_class_loading gauge
+jvm_class_loading{component="system-metrics",mode="loaded"} 10491.0
+# TYPE jvm_memory_buffer_pool_usage gauge
+jvm_memory_buffer_pool_usage{component="system-metrics",pool="direct",measure="used"} 396336.0
+# TYPE roundtrip_http_seconds histogram
+roundtrip_http_seconds_bucket{le="0.05",ditto_request_path="/api/2/things/x",ditto_request_method="PUT",ditto_statusCode="201",segment="overall"} 1.0
+roundtrip_http_seconds_sum{ditto_request_path="/api/2/things/x",ditto_statusCode="201",ditto_request_method="PUT",segment="overall"} 0.038273024
+roundtrip_http_seconds_bucket{le="0.001",ditto_request_path="/api/2/things/x",ditto_request_method="PUT",ditto_statusCode="204",segment="overall"} 0.0
+roundtrip_http_seconds_bucket{le="0.1",ditto_request_path="/api/2/things/x",ditto_request_method="PUT",ditto_statusCode="204",segment="overall"} 7.0
+roundtrip_http_seconds_sum{ditto_request_path="/api/2/things/x",ditto_statusCode="204",ditto_request_method="PUT",segment="overall"} 0.828899328
+# TYPE jvm_gc_promotion histogram
+jvm_gc_promotion_sum{space="old"} 7315456.0
+# TYPE jvm_gc_seconds histogram
+jvm_gc_seconds_count{component="system-metrics",collector="scavenge"} 9.0
+jvm_gc_seconds_sum{component="system-metrics",collector="scavenge"} 0.063
+# TYPE jvm_memory_bytes histogram
+jvm_memory_bytes_count{component="system-metrics",measure="used",segment="miscellaneous-non-heap-storage"} 54.0
+jvm_memory_bytes_sum{component="system-metrics",measure="used",segment="miscellaneous-non-heap-storage"} 786350080.0
+</code></pre></div></div>
+
+<p>To put it in a nutshell, Ditto reports:</p>
+
+<ul>
+ <li>JVM metrics for all services
+ <ul>
+ <li>amount of garbage collections + GC times</li>
+ <li>memory consumption (heap + non-heap)</li>
+ <li>amount of threads + loaded classes</li>
+ </ul>
+ </li>
+ <li>HTTP metrics for <a href="architecture-services-gateway.html">gateway-service</a>
+ <ul>
+ <li>roundtrip times from request to response</li>
+ <li>amount of HTTP calls</li>
+ <li>status code of HTTP responses</li>
+ </ul>
+ </li>
+ <li>MongoDB metrics for <a href="architecture-services-things.html">things-service</a>,
+<a href="architecture-services-policies.html">policies-service</a>, <a href="architecture-services-things-search.html">things-search-service</a>
+ <ul>
+ <li>inserts, updates, reads per second</li>
+ <li>roundtrip times</li>
+ </ul>
+ </li>
+ <li>cache metrics for <a href="architecture-services-concierge.html">concierge-service</a></li>
+ <li>connection metrics for <a href="architecture-services-connectivity.html">connectivity-service</a>
+ <ul>
+ <li>processed messages</li>
+ <li>mapping times</li>
+ </ul>
+ </li>
+</ul>
+
+<h2 id="devops-commands">DevOps commands</h2>
+
+<p>The “DevOps commands” API allows Ditto operators to make changes to a running installation without restarts.</p>
+
+<p>The following DevOps commands are supported:</p>
+
+<ul>
+ <li>Dynamically retrieve and change log levels</li>
+ <li>Dynamically retrieve service configuration</li>
+ <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,
+since the cause of the problem could be lost on service restart.</p>
+
+<h4 id="retrieve-all-log-levels">Retrieve all log levels</h4>
+
+<p>Example for retrieving all currently configured log levels:<br />
+<code class="highlighter-rouge">GET /devops/logging</code></p>
+
+<p>Response:</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">"gateway"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"1"</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">"devops.responses:retrieveLoggerConfig"</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">"serviceName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"gateway"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"instance"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"loggerConfigs"</span><span class="p">:</span><span class="w"> </span><span class="p">[{</span><span class="w">
+ </span><span class="s2">"level"</span><span class="p">:</span><span class="w"> </span><span class="s2">"info"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"logger"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ROOT"</span><span class="w">
+ </span><span class="p">},</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"level"</span><span class="p">:</span><span class="w"> </span><span class="s2">"info"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"logger"</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">"level"</span><span class="p">:</span><span class="w"> </span><span class="s2">"warn"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"logger"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.mongodb.driver"</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">"things-search"</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="s2">"policies"</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="s2">"things"</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="s2">"connectivity"</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>
+
+<h4 id="change-a-specific-log-level-for-all-services">Change a specific log level for all services</h4>
+
+<p>Example request payload to change the log level of logger <code class="highlighter-rouge">org.eclipse.ditto</code> in all services to <code class="highlighter-rouge">DEBUG</code>:<br />
+<code class="highlighter-rouge">PUT /devops/logging</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">"logger"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"level"</span><span class="p">:</span><span class="w"> </span><span class="s2">"debug"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h4 id="retrieve-log-levels-of-a-service">Retrieve log levels of a service</h4>
+
+<p>Example response for retrieving all currently configured log levels of gateways services:<br />
+<code class="highlighter-rouge">GET /devops/logging/gateway</code></p>
+
+<p>Response:</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">"1"</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">"devops.responses:retrieveLoggerConfig"</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">"serviceName"</span><span class="p">:</span><span class="w"> </span><span class="s2">"gateway"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"instance"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"loggerConfigs"</span><span class="p">:</span><span class="w"> </span><span class="p">[{</span><span class="w">
+ </span><span class="s2">"level"</span><span class="p">:</span><span class="w"> </span><span class="s2">"info"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"logger"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ROOT"</span><span class="w">
+ </span><span class="p">},</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"level"</span><span class="p">:</span><span class="w"> </span><span class="s2">"info"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"logger"</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">"level"</span><span class="p">:</span><span class="w"> </span><span class="s2">"warn"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"logger"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.mongodb.driver"</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>
+
+<h4 id="change-a-specific-log-level-for-one-service">Change a specific log level for one service</h4>
+
+<p>Example request payload to change the log level of logger <code class="highlighter-rouge">org.eclipse.ditto</code> in all
+instances of gateway-service to <code class="highlighter-rouge">DEBUG</code>:</p>
+
+<p><code class="highlighter-rouge">PUT /devops/logging/gateway</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">"logger"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"level"</span><span class="p">:</span><span class="w"> </span><span class="s2">"debug"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h3 id="dynamically-retrieve-configurations">Dynamically retrieve configurations</h3>
+
+<p>Runtime configurations of services are available for the Ditto operator at
+<code class="highlighter-rouge">/devops/config/</code> with optional restrictions by service name, instance ID and configuration path.
+The entire runtime configuration of a service may be dozens of kilobytes big. If it exceeds the cluster message size
+of 250 kB, then it can only be read piece by piece via the <code class="highlighter-rouge">path</code> query parameter.</p>
+
+<h4 id="retrieve-all-service-configurations">Retrieve all service configurations</h4>
+
+<p>Retrieve the configuration at the path <code class="highlighter-rouge">ditto.info</code> thus:</p>
+
+<p><code class="highlighter-rouge">GET /devops/config?path=ditto.info</code></p>
+
+<p>It is recommended to not omit the query parameter <code class="highlighter-rouge">path</code>. Otherwise the full configurations of all services are
+aggregated in the response, which can become megabytes big.</p>
+
+<p>The path <code class="highlighter-rouge">ditto.info</code> points to information on service name, service instance index, JVM arguments and environment
+variables. Response 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">"?"</span><span class="p">:</span><span class="w"> </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><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"common.responses:retrieveConfig"</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">"config"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"env"</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">"/usr/games:/usr/local/games"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"service"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"instance-index"</span><span class="p">:</span><span class="w"> </span><span class="s2">"1"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"service-name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"gateway"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"vm-args"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"-Dfile.encoding=UTF-8"</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">"?1"</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.responses:retrieveConfig"</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">"config"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"env"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"CONNECTIVITY_FLUSH_PENDING_RESPONSES_TIMEOUT"</span><span class="p">:</span><span class="w"> </span><span class="s2">"3d"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"service"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"instance-index"</span><span class="p">:</span><span class="w"> </span><span class="s2">"1"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"service-name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"connectivity"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"vm-args"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"-Dditto.connectivity.connection.snapshot.threshold=2"</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>
+
+<h4 id="retrieve-the-configuration-of-a-service-instance">Retrieve the configuration of a service instance</h4>
+
+<p>Retrieving the configuration of a specific service instance is much faster
+because the response is not aggregated from an unknown number of respondents
+over the duration given in the query parameter <code class="highlighter-rouge">timeout</code>.</p>
+
+<p>To retrieve <code class="highlighter-rouge">ditto</code> configuration from Gateway instance <code class="highlighter-rouge">1</code>:</p>
+
+<p><code class="highlighter-rouge">GET /devops/config/gateway/1?path=ditto</code></p>
+
+<p>Response 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">"?"</span><span class="p">:</span><span class="w"> </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><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"common.responses:retrieveConfig"</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">"config"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"cluster"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"number-of-shards"</span><span class="p">:</span><span class="w"> </span><span class="mi">20</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"gateway"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"authentication"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"devops"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"password"</span><span class="p">:</span><span class="w"> </span><span class="s2">"foobar"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"secured"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</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>
+
+<h3 id="piggyback-commands">Piggyback commands</h3>
+
+<p>You can use a DevOps command to send a command to another actor in the cluster.
+Those special commands are called piggyback commands.
+A piggyback command must conform to the following schema:</p>
+
+<script src="docson/widget.js" data-schema="../jsonschema/piggyback-command.json"></script>
+
+<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">"targetActorSelection"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/system/sharding/connection"</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="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">"connectivity.commands:createConnection"</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>
+
+<h4 id="managing-connections">Managing connections</h4>
+
+<p>Piggybacks are used to configure Dittos connectivity service. More information on this can be found in
+the <a href="connectivity-manage-connections.html">Manage Connections</a> section.</p>
+
+<h4 id="managing-background-cleanup">Managing background cleanup</h4>
+
+<p>Ditto deletes unnecessary events and snapshots in the background according to database load.
+<a href="architecture-services-concierge.html">Concierge</a> has a cluster-singleton coordinating the background cleanup process.
+The cluster singleton responds to piggyback-commands to query its state and configuration, modify the configuration,
+and restart the background cleanup process.</p>
+
+<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=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=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="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">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>The response has the following details:</p>
+
+<ul>
+ <li><code class="highlighter-rouge">events</code>: State transitions of the actor. The top entry is the current state of the actor.</li>
+ <li><code class="highlighter-rouge">credit-decisions</code>: Decisions on how many cleanup actions were permitted, when, and why.</li>
+ <li><code class="highlighter-rouge">actions</code>: Log of cleanup actions, their round-trip times, and whether they were successful.</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">"?"</span><span class="p">:</span><span class="w"> </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><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"status.responses:retrieveHealth"</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">"statusInfo"</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="s2">"UP"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"details"</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">"INFO"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"events"</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">"2019-06-24T13:42:29.878Z"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Stream terminated. Result=<Done> Error=<null>"</span><span class="w"> </span><span class="p">},</span><span class="w">
+ </span><span class="p">{</span><span class="w"> </span><span class="s2">"2019-06-24T13:42:19.474Z"</span><span class="p">:</span><span class="w"> </span><span class="s2">"WOKE_UP"</span><span class="w"> </span><span class="p">}</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"credit-decisions"</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">"2019-06-24T13:42:29.609Z"</span><span class="p">:</span><span class="w"> </span><span class="s2">"100: maxTimeNanos=0 is below threshold=20000000"</span><span class="w"> </span><span class="p">},</span><span class="w">
+ </span><span class="p">{</span><span class="w"> </span><span class="s2">"2019-06-24T13:42:25.232Z"</span><span class="p">:</span><span class="w"> </span><span class="s2">"0: maxTimeNanos=47358000 is above threshold=20000000"</span><span class="w"> </span><span class="p">}</span><span class="w">
+ </span><span class="p">],</span><span class="w">
+ </span><span class="s2">"actions"</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">"2019-06-24T13:42:28.801Z"</span><span class="p">:</span><span class="w"> </span><span class="s2">"200 start=2019-06-24T13:42:28.755Z <thing:ditto:thing1>"</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><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<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=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="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">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>Response 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">"?"</span><span class="p">:</span><span class="w"> </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><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"common.responses:retrieveConfig"</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">"config"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"cleanup-timeout"</span><span class="p">:</span><span class="w"> </span><span class="s2">"30s"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"credit-decision"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"credit-per-batch"</span><span class="p">:</span><span class="w"> </span><span class="mi">100</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"interval"</span><span class="p">:</span><span class="w"> </span><span class="s2">"10s"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"metric-report-timeout"</span><span class="p">:</span><span class="w"> </span><span class="s2">"10s"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"timer-threshold"</span><span class="p">:</span><span class="w"> </span><span class="s2">"20ms"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"keep"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"actions"</span><span class="p">:</span><span class="w"> </span><span class="mi">120</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"credit-decisions"</span><span class="p">:</span><span class="w"> </span><span class="mi">30</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"events"</span><span class="p">:</span><span class="w"> </span><span class="mi">15</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="mi">1</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"persistence-ids"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"burst"</span><span class="p">:</span><span class="w"> </span><span class="mi">25</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"stream-idle-timeout"</span><span class="p">:</span><span class="w"> </span><span class="s2">"10m"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"stream-request-timeout"</span><span class="p">:</span><span class="w"> </span><span class="s2">"10s"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"quiet-period"</span><span class="p">:</span><span class="w"> </span><span class="s2">"5m"</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>
+
+<h5 id="modify-background-cleanup-coordinator-configuration">Modify background cleanup coordinator configuration</h5>
+
+<p>Send a piggyback command of type <code class="highlighter-rouge">common.commands:modifyConfig</code> to change the configuration of the background cleanup
+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=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="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">
+ </span><span class="s2">"config"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"quiet-period"</span><span class="p">:</span><span class="w"> </span><span class="s2">"240d"</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>The response contains the effective configuration of the background cleanup coordinator. If the configuration in the
+piggyback command contains any error, then an error is logged and the actor’s configuration is unchanged.</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">"?"</span><span class="p">:</span><span class="w"> </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><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"common.responses:modifyConfig"</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">"config"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"cleanup-timeout"</span><span class="p">:</span><span class="w"> </span><span class="s2">"30s"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"credit-decision"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"credit-per-batch"</span><span class="p">:</span><span class="w"> </span><span class="mi">100</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"interval"</span><span class="p">:</span><span class="w"> </span><span class="s2">"10s"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"metric-report-timeout"</span><span class="p">:</span><span class="w"> </span><span class="s2">"10s"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"timer-threshold"</span><span class="p">:</span><span class="w"> </span><span class="s2">"20ms"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"keep"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"actions"</span><span class="p">:</span><span class="w"> </span><span class="mi">120</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"credit-decisions"</span><span class="p">:</span><span class="w"> </span><span class="mi">30</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"events"</span><span class="p">:</span><span class="w"> </span><span class="mi">15</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="mi">1</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"persistence-ids"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"burst"</span><span class="p">:</span><span class="w"> </span><span class="mi">25</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"stream-idle-timeout"</span><span class="p">:</span><span class="w"> </span><span class="s2">"10m"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"stream-request-timeout"</span><span class="p">:</span><span class="w"> </span><span class="s2">"10s"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"quiet-period"</span><span class="p">:</span><span class="w"> </span><span class="s2">"240d"</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>
+
+<h5 id="shutdown-background-cleanup-coordinator">Shutdown background cleanup coordinator</h5>
+
+<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=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="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">
+ </span><span class="p">}</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>Response 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">"?"</span><span class="p">:</span><span class="w"> </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><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"common.responses:shutdown"</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">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Restarting stream in <PT5760H30M5S>."</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>
+
+<h5 id="cleanup-events-and-snapshots-of-an-entity">Cleanup events and snapshots of an entity</h5>
+
+<p>Send a cleanup command by piggyback to the entity’s service and shard region to trigger removal of stale events and
+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=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">
+ </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="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">"cleanup.commands:cleanupPersistence"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"entityId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ditto:thing1"</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>Response 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">"?"</span><span class="p">:</span><span class="w"> </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><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"cleanup.responses:cleanupPersistence"</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">"entityId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"thing:ditto:thing1"</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>
+
+<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.
+To do so safely, perform the following steps in sequence.</p>
+
+<ol>
+ <li><a href="#block-all-messages-to-a-namespace">Block all messages to the namespace</a>
+so that actors will not spawn in the namespace.</li>
+ <li><a href="#shutdown-all-actors-in-a-namespace">Shutdown all actors in the namespace</a>
+so that no actor will generate data in the namespace.</li>
+ <li><a href="#erase-all-data-in-a-namespace-from-the-persistence">Erase data from the persistence</a>.</li>
+ <li><a href="#unblock-messages-to-a-namespace">Unblock messages to the namespace</a>
+so that the old namespace could be reused at a later point in time.</li>
+</ol>
+
+<h5 id="block-all-messages-to-a-namespace">Block all messages to a namespace</h5>
+
+<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=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">
+ </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="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">"namespaces.commands:blockNamespace"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"namespace"</span><span class="p">:</span><span class="w"> </span><span class="s2">"namespaceToBlock"</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>Once a namespace is blocked on all members of the Ditto cluster, you will get a response
+similar to the one below. The namespace will remain blocked for the lifetime of the Ditto cluster,
+or until you proceed with <a href="#unblock-messages-to-a-namespace">step 4</a>, which unblocks it.</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">"?"</span><span class="p">:</span><span class="w"> </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><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"namespaces.responses:blockNamespace"</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">"namespace"</span><span class="p">:</span><span class="w"> </span><span class="s2">"namespaceToBlock"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"resourceType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"namespaces"</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>
+
+<h5 id="shutdown-all-actors-in-a-namespace">Shutdown all actors in a namespace</h5>
+
+<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">common.commands:shutdown</code>
+to request all actors in a namespace to shut down. The value of <code class="highlighter-rouge">piggybackCommand/reason/type</code> must be
+<code class="highlighter-rouge">purge-namespace</code>; otherwise, the namespace’s actors will not stop themselves.</p>
+
+<p><code class="highlighter-rouge">PUT /devops/piggygack?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">"/system/distributedPubSubMediator"</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="p">,</span><span class="w">
+ </span><span class="s2">"reason"</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">"purge-namespace"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"details"</span><span class="p">:</span><span class="w"> </span><span class="s2">"namespaceToShutdown"</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>The shutdown command has no response because the number of actors shutting down can be very large.
+The response will always be <code class="highlighter-rouge">408</code> timeout.
+Feel free to send the shutdown command several times to make sure.</p>
+
+<h5 id="erase-all-data-in-a-namespace-from-the-persistence">Erase all data in a namespace from the persistence</h5>
+
+<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:purgeNamespace</code>
+to erase all data from the persistence.
+It is better to purge a namespace after
+<a href="#block-all-messages-to-a-namespace">blocking</a> it and
+<a href="#shutdown-all-actors-in-a-namespace">shutting down</a>
+all its actors so that no data is written in the namespace while erasing is ongoing.</p>
+
+<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=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">
+ </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">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">"namespaces.commands:purgeNamespace"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"namespace"</span><span class="p">:</span><span class="w"> </span><span class="s2">"namespaceToPurge"</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>The response contains results of the data purge, one for each resource type.
+Note that to see responses from multiple resource types, the header <code class="highlighter-rouge">aggregate</code> must not be <code class="highlighter-rouge">false</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">"?"</span><span class="p">:</span><span class="w"> </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><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"namespaces.responses:purgeNamespace"</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">"namespace"</span><span class="p">:</span><span class="w"> </span><span class="s2">"namespaceToPurge"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"resourceType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"thing"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"successful"</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">"?1"</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">"namespaces.responses:purgeNamespace"</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">"namespace"</span><span class="p">:</span><span class="w"> </span><span class="s2">"namespaceToPurge"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"resourceType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"policy"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"successful"</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">"?2"</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">"namespaces.responses:purgeNamespace"</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">"namespace"</span><span class="p">:</span><span class="w"> </span><span class="s2">"namespaceToPurge"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"resourceType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"thing-search"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"successful"</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="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h5 id="unblock-messages-to-a-namespace">Unblock messages to a namespace</h5>
+
+<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=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">
+ </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="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">"namespaces.commands:unblockNamespace"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"namespace"</span><span class="p">:</span><span class="w"> </span><span class="s2">"namespaceToUnblock"</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>A response will come once the namespace’s blockade is released on all members of the Ditto cluster.</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">"?"</span><span class="p">:</span><span class="w"> </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><span class="s2">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"namespaces.responses:unblockNamespace"</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">"namespace"</span><span class="p">:</span><span class="w"> </span><span class="s2">"namespaceToUnblock"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"resourceType"</span><span class="p">:</span><span class="w"> </span><span class="s2">"namespaces"</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_installation.html" class="btn btn-default navbar-btn cursorNorm" role="button">installation</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/installation-running.html b/2.0/installation-running.html
new file mode 100644
index 0000000..3c812b7
--- /dev/null
+++ b/2.0/installation-running.html
@@ -0,0 +1,1848 @@
+<!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="getting_startedinstallation, running, start, run, docker, docker-compose, k3s, helm, openshift, kubernetes">
+<title> Running Ditto • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Running Ditto">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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 class="active"><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Running Ditto</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="start-ditto">Start Ditto</h2>
+
+<p>In order to start Ditto, you’ll need:</p>
+<ul>
+ <li>a <a href="https://github.com/mongodb/mongo">MongoDB</a> service or container with version <strong>4.2</strong> as backing datastore of Ditto.
+(if you want to use a managed MongoDB service have a look in the <a href="#managed-mongodb-service">section</a> below)</li>
+ <li>the built Docker images of Ditto
+ <ul>
+ <li>either by building them as described in <a href="installation-building.html">Building Ditto</a>,</li>
+ <li>or by using the pre-built <a href="https://hub.docker.com/u/eclipse/">Ditto images on Docker Hub</a>.</li>
+ </ul>
+ </li>
+ <li>some other tools like docker-compose, helm, k3s, minikube or openshift to run Ditto.</li>
+</ul>
+
+<p>You can choose from several options to deploy Ditto.
+A good starting point here is <a href="https://github.com/eclipse/ditto/blob/master/deployment/README.md">Ditto Deployment</a>.
+After completing the deployment of your choice Ditto should be up & running.</p>
+
+<p>Now you have running:</p>
+<ul>
+ <li>a MongoDB as backing datastore of Ditto (not part of Ditto but started to get Ditto running),</li>
+ <li>Ditto microservices:
+ <ul>
+ <li>Concierge,</li>
+ <li>Connectivity,</li>
+ <li>Policies,</li>
+ <li>Things,</li>
+ <li>Thing-Search,</li>
+ <li>Gateway,</li>
+ </ul>
+ </li>
+ <li>an instance of nginx acting as a reverse proxy performing a simple “basic authentication” listening on a local port
+ <ul>
+ <li>including some static HTTP + API documentation</li>
+ </ul>
+ </li>
+</ul>
+
+<p>The running port on which Ditto can be accessed is described in the Readme of the respective deployment section.</p>
+
+<p>If you want to change the MongoDB config or Ditto config please have a look here:
+<a href="installation-operating.html">Operating Ditto</a></p>
+
+<h3 id="managed-mongodb-service">Managed MongoDB service</h3>
+<p>When using a managed MongoDB service the following recommendations should be taken into account:</p>
+<ul>
+ <li>at least a 3 Node dedicated cluster for high-traffic applications and large datasets</li>
+ <li>Cluster scaling depending on load</li>
+</ul>
+
+<p>Other Recommendations:</p>
+<ul>
+ <li>SSL/TLS 1.2 and above</li>
+ <li>Data Encryption at rest</li>
+ <li>Daily Backups</li>
+</ul>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_getting_started.html" class="btn btn-default navbar-btn cursorNorm" role="button">getting_started</a>
+
+
+
+ <a href="tag_installation.html" class="btn btn-default navbar-btn cursorNorm" role="button">installation</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/intro-digitaltwins.html b/2.0/intro-digitaltwins.html
new file mode 100644
index 0000000..c3e5b11
--- /dev/null
+++ b/2.0/intro-digitaltwins.html
@@ -0,0 +1,1825 @@
+<!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="getting_started, digital twin, digitaltwin, twin, administrationshell, asset">
+<title> Digital twins • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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 class="active"><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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Digital twins</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"><strong>TL;DR</strong><br />Digital twins are a pattern for simplifying IoT solution development.</div>
+
+<p>The problem with the term <strong>digital twin</strong> is that there are many different understandings of what it means.
+Furthermore, the term was previously mostly used and coined by marketing. The term was/is missing a
+technical foundation of what to expect from a framework for digital twins.</p>
+
+<p>Eclipse Ditto provides such a framework for digital twins and this page describes how Ditto defines/sees digital twins
+from a technical perspective.</p>
+
+<h2 id="digital-twin-from-a-technical-perspective">Digital twin from a technical perspective</h2>
+
+<p>For Eclipse Ditto the <strong>digital twin</strong> is a concept for abstracting a real world asset/device with
+all capabilities and aspects including its digital representation.</p>
+
+<p>A digital twin</p>
+<ul>
+ <li>mirrors physical assets/devices</li>
+ <li>acts as a “single source of truth” for a physical asset</li>
+ <li>provides various aspects+services around devices</li>
+ <li>keeps real and digital worlds in sync</li>
+ <li>can be applied in both industrial and consumer-centric IoT scenarios</li>
+</ul>
+
+<p>A digital twin framework</p>
+<ul>
+ <li>provides capabilities (APIs) to interact with digital twins</li>
+ <li>ensures that access to twins can only be done by authorized parties</li>
+ <li>allows to not only interact with single twins but also with populations of many of them</li>
+ <li>integrates into other back-end infrastructure (like messaging systems, brokers)</li>
+</ul>
+
+<h2 id="industrial-context">Industrial context</h2>
+
+<p>In the <a href="#" data-toggle="tooltip" data-original-title="Industrial Internet of Things - also known as 'Industry 4.0'">IIoT</a> the <strong>digital twin</strong>
+metaphor is becoming a popular concept for tracking a produced product/good in its complete lifecycle.</p>
+
+<p>Another term often used in the IIoT in combination with digital twin is the “Asset Administration Shell”
+(“Verwaltungsschale” in german).</p>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_getting_started.html" class="btn btn-default navbar-btn cursorNorm" role="button">getting_started</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/intro-hello-world.html b/2.0/intro-hello-world.html
new file mode 100644
index 0000000..9db6f8a
--- /dev/null
+++ b/2.0/intro-hello-world.html
@@ -0,0 +1,1916 @@
+<!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="getting_started, ">
+<title> Hello world • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Hello world">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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 class="active"><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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Hello world</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>After <a href="installation-running.html">starting Ditto</a>, we have a HTTP and WebSocket API for your
+<a href="intro-digitaltwins.html">digital twins</a> at our hands.</p>
+
+<h2 id="example">Example</h2>
+
+<p>Assume we want to create a digital twin for a car. The twin should hold static metadata and dynamic state data.
+The state data should change as often as its real world counterpart does.</p>
+
+<p>Those static and dynamic types of data are mapped in the Ditto model to “attributes” (for static metadata), “features”
+(for dynamic state data) and “definition” (to link a model the thing follows,
+e.g. an <a href="https://www.eclipse.org/vorto/">Eclipse Vorto</a> “information model”).
+A JSON representation of some metadata and state data could for example 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">"definition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"digitaltwin:DigitaltwinExample:1.0.0"</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"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"VIN"</span><span class="p">:</span><span class="w"> </span><span class="s2">"0815666337"</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">"transmission"</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">"automatic"</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">"mode"</span><span class="p">:</span><span class="w"> </span><span class="s2">"eco"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"cur_speed"</span><span class="p">:</span><span class="w"> </span><span class="mi">90</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"gear"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"environment-scanner"</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">"temperature"</span><span class="p">:</span><span class="w"> </span><span class="mf">20.8</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"humidity"</span><span class="p">:</span><span class="w"> </span><span class="mi">73</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"barometricPressure"</span><span class="p">:</span><span class="w"> </span><span class="mf">970.7</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"location"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">47.682170</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">9.386372</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"altitude"</span><span class="p">:</span><span class="w"> </span><span class="mi">399</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>Background: Ditto only knows about “attributes”, “features” and the “definition”.</p>
+
+<p>Inside “attributes” (the metadata) we can add as much JSON keys as we like with any JSON value we need.</p>
+
+<p>Inside “features” (the state data) we can add as much features as we like - but each feature needs to have
+a “properties” JSON object. Inside that JSON object we can add as much JSON keys as we like with any JSON value we need.</p>
+
+<p>Inside “definition” we can add one JSON string value.</p>
+
+<h2 id="creating-your-first-thing">Creating your first Thing</h2>
+
+<p>We create a Thing for the example from above by using <a href="https://github.com/curl/curl">cURL</a>. Basic authentication will use the credentials of a user “ditto”.
+Those credentials have been created by default in the <a href="https://github.com/nginx/nginx">nginx</a> started via “docker”.
+(See <a href="https://github.com/eclipse/ditto/blob/master/deployment/docker/README.md">ditto/deployment/docker/README.md</a>)</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-u</span> ditto:ditto <span class="nt">-X</span> PUT <span class="nt">-H</span> <span class="s1">'Content-Type: application/json'</span> <span class="nt">-d</span> <span class="s1">'{
+ "definition": "digitaltwin:DigitaltwinExample:1.0.0",
+ "attributes": {
+ "manufacturer": "ACME",
+ "VIN": "0815666337"
+ },
+ "features": {
+ "transmission": {
+ "properties": {
+ "automatic": true,
+ "mode": "eco",
+ "cur_speed": 90,
+ "gear": 5
+ }
+ },
+ "environment-scanner": {
+ "properties": {
+ "temperature": 20.8,
+ "humidity": 73,
+ "barometricPressure": 970.7,
+ "location": {
+ "longitude": 47.682170,
+ "latitude": 9.386372
+ },
+ "altitude": 399
+ }
+ }
+ }
+ }'</span> <span class="s1">'http://localhost:8080/api/2/things/org.eclipse.ditto:fancy-car'</span>
+</code></pre></div></div>
+
+<p>The result is a digital twin in Thing notation. The Thing ID is <code class="highlighter-rouge">org.eclipse.ditto:fancy-car</code>.
+An ID must always contain a namespace before the <code class="highlighter-rouge">:</code>. That way Things are easier to organize.</p>
+
+<h2 id="querying-an-existing-thing">Querying an existing Thing</h2>
+
+<p>By creating the digital twin as a Thing with the specified JSON format, Ditto implicitly provides an API for
+our Thing.</p>
+
+<p>For Things we know the ID of, we can simply query them by their ID:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-u</span> ditto:ditto <span class="nt">-X</span> GET <span class="s1">'http://localhost:8080/api/2/things/org.eclipse.ditto:fancy-car'</span>
+
+<span class="c"># if you have python installed, that's how to get a prettier response:</span>
+curl <span class="nt">-u</span> ditto:ditto <span class="nt">-X</span> GET <span class="s1">'http://localhost:8080/api/2/things/org.eclipse.ditto:fancy-car'</span> | python <span class="nt">-m</span> json.tool
+</code></pre></div></div>
+
+<h2 id="querying-one-specific-state-value">Querying one specific state value</h2>
+
+<p>The created API for our Thing also provides HTTP endpoints for each attribute and feature property.</p>
+
+<p>That way we can for example just retrieve the <code class="highlighter-rouge">cur_speed</code> of our fancy car:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-u</span> ditto:ditto <span class="nt">-X</span> GET <span class="s1">'http://localhost:8080/api/2/things/org.eclipse.ditto:fancy-car/features/transmission/properties/cur_speed'</span>
+</code></pre></div></div>
+
+<h2 id="updating-one-specific-state-value">Updating one specific state value</h2>
+
+<p>We can just as easy use the HTTP API to update one attribute or feature property, e.g. update the <code class="highlighter-rouge">cur_speed</code> to <code class="highlighter-rouge">77</code>:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-u</span> ditto:ditto <span class="nt">-X</span> PUT <span class="nt">-H</span> <span class="s1">'Content-Type: application/json'</span> <span class="nt">-d</span> <span class="s1">'77'</span> <span class="s1">'http://localhost:8080/api/2/things/org.eclipse.ditto:fancy-car/features/transmission/properties/cur_speed'</span>
+</code></pre></div></div>
+
+<h2 id="searching-for-all-things">Searching for all Things</h2>
+
+<p>When we lost the overview which Things we have already created, we can use the <code class="highlighter-rouge">search</code> HTTP endpoint,
+e.g. searching all Things with the same <code class="highlighter-rouge">manufacturer</code> named <code class="highlighter-rouge">"ACME"</code>:</p>
+
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-u</span> ditto:ditto <span class="nt">-X</span> GET <span class="s1">'http://localhost:8080/api/2/search/things?filter=eq(attributes/manufacturer,"ACME")'</span>
+</code></pre></div></div>
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_getting_started.html" class="btn btn-default navbar-btn cursorNorm" role="button">getting_started</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/intro-overview.html b/2.0/intro-overview.html
new file mode 100644
index 0000000..a22bc32
--- /dev/null
+++ b/2.0/intro-overview.html
@@ -0,0 +1,1843 @@
+<!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="getting_started, purpose, about, motivation, digital twin, digitaltwin, twin">
+<title> Eclipse Ditto™ documentation overview • 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="Eclipse 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 class="active"><a href="intro-overview.html">Documentation</a></li>
+
+
+
+
+ <li><a href="http-api-doc.html">HTTP API</a></li>
+
+
+
+ <li><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Eclipse Ditto™ documentation overview">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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 class="active"><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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Eclipse Ditto™ documentation overview</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="what-is-it">What is it?</h2>
+
+<p>Eclipse Ditto™ is a technology in the <a href="#" data-toggle="tooltip" data-original-title="Internet of Things">IoT</a>
+implementing a software pattern called “<strong><a href="intro-digitaltwins.html">digital twins</a></strong>”.<br />
+A digital twin is a virtual, cloud based, representation of his real world counterpart
+(real world “Things”, e.g. devices like sensors, smart heating, connected cars, smart grids, EV charging stations, …).</p>
+
+<p>The technology mirrors potentially millions and billions of digital twins residing in the digital world
+with physical “<strong>Things</strong>”. This simplifies developing IoT solutions for software developers as they do not need
+to know how or where exactly the physical “Things” are connected.</p>
+
+<p>With Ditto a thing can just be used as any other web service via its digital twin.</p>
+
+<h2 id="what-is-it-not">What is it not?</h2>
+
+<p>Ditto is not another fully-fledged IoT platform. It does not provide software running on IoT gateways, and it does not
+define or implement an IoT protocol in order to communicate with devices.</p>
+
+<p>Its focus lies on back end scenarios by providing web APIs in order to simplify working with already connected (e.g.
+via <a href="https://www.eclipse.org/hono/">Eclipse Hono</a>) devices and “Things” from customer apps or other back end software.</p>
+
+<p>It also does not specify which data or which structure a “Thing” in the IoT has to provide.</p>
+
+<h2 id="when-to-use-it">When to use it?</h2>
+
+<div class="bs-callout bs-callout-primary"><strong>TL;DR</strong><br />Use it in order to get a fully-fledged, authorization aware API
+ (HTTP, WebSocket and other messaging protocols) for interacting with your digital twins and all aspects around them.</div>
+
+<p>Imagine you are building an IoT solution. And let’s assume that you use both hardware (e.g. sensors or actuators) and
+software (e.g. a mobile or web app) in order to solve your customer’s problem.</p>
+
+<p>In such a scenario you have several places where to implement software:</p>
+<ul>
+ <li>on or near the hardware, e.g. on an Arduino using <code class="highlighter-rouge">C/C++</code> or on an Raspberry PI using <code class="highlighter-rouge">Python</code>,</li>
+ <li>optionally on a gateway establishing the Internet connectivity (e.g. based on <a href="https://www.eclipse.org/kura/">Eclipse Kura</a>),</li>
+ <li>in the mobile or web app using <code class="highlighter-rouge">Java</code>, <code class="highlighter-rouge">Javascript</code>, <code class="highlighter-rouge">Swift</code> etc.,</li>
+ <li>in the “back end” fulfilling several responsibilities like
+ <ul>
+ <li>providing an API abstracting from the hardware,</li>
+ <li>routing requests between hardware and customer apps,</li>
+ <li>ensuring only authorized access,</li>
+ <li>persisting last reported state of hardware as cache and for providing the data when hardware is currently not connected,</li>
+ <li>notifying interested parties (e.g. other back end services) about changes,</li>
+ <li>…</li>
+ </ul>
+ </li>
+</ul>
+
+<p>Ditto focuses on solving the responsibilities a typical “back end” has in such scenarios.</p>
+
+<div class="bs-callout bs-callout-info">Its goal is to free IoT solutions from the need of implementing and operating a
+ custom back end. Instead by using Eclipse Ditto they can focus on business requirements, on connecting devices to
+ the cloud/back end and on implementing business applications.</div>
+
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_getting_started.html" class="btn btn-default navbar-btn cursorNorm" role="button">getting_started</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/js/customscripts.js b/2.0/js/customscripts.js
new file mode 100644
index 0000000..c45cdb9
--- /dev/null
+++ b/2.0/js/customscripts.js
@@ -0,0 +1,79 @@
+$(function () {
+ //this script says, if the height of the viewport is greater than 800px, then insert affix class, which makes the
+ // nav bar float in a fixed position as your scroll. if you have a lot of nav items, this height may not work for
+ // you. var h = $(window).height(); console.log (h); if (h > 800) { $( "#mysidebar" ).attr("class", "nav affix"); }
+ // activate tooltips. although this is a bootstrap js function, it must be activated this way in your theme.
+ $('[data-toggle="tooltip"]').tooltip({ placement: 'top' });
+
+ anchors.add('h2,h3,h4,h5');
+
+ $(document).ready(function() {
+ $("#mysidebar li.subfolders > a").click(function (e) {
+ e.preventDefault();
+ var theUl = $(this).parent().select("ul");
+ if (!theUl.hasClass("open")) {
+ theUl.addClass("open");
+ theUl.removeClass("closed");
+ } else {
+ theUl.addClass("closed");
+ theUl.removeClass("open");
+ }
+ });
+ $("#collapseAll").click(function(e) {
+ e.preventDefault();
+ var theLis = $("#mysidebar li.subfolders");
+ theLis.addClass("closed");
+ theLis.removeClass("open");
+ });
+
+ $("#expandAll").click(function(e) {
+ e.preventDefault();
+ var theLis = $("#mysidebar li.subfolders");
+ theLis.addClass("open");
+ theLis.removeClass("closed");
+ });
+
+ });
+
+ $("#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/", "/");
+ remainingPath = remainingPath.startsWith("/") ? remainingPath.substr(1) : remainingPath;
+ 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;
+ }
+ }
+}
diff --git a/2.0/js/toc.js b/2.0/js/toc.js
new file mode 100644
index 0000000..a54d172
--- /dev/null
+++ b/2.0/js/toc.js
@@ -0,0 +1,82 @@
+// https://github.com/ghiculescu/jekyll-table-of-contents
+(function($){
+ $.fn.toc = function(options) {
+ var defaults = {
+ noBackToTopLinks: false,
+ title: '',
+ minimumHeaders: 3,
+ headers: 'h1, h2, h3, h4',
+ listType: 'ol', // values: [ol|ul]
+ showEffect: 'show', // values: [show|slideDown|fadeIn|none]
+ showSpeed: 'slow' // set to 0 to deactivate effect
+ },
+ settings = $.extend(defaults, options);
+
+ var headers = $(settings.headers).filter(function() {
+ // get all headers with an ID
+ var previousSiblingName = $(this).prev().attr( "name" );
+ if (!this.id && previousSiblingName) {
+ this.id = $(this).attr( "id", previousSiblingName.replace(/\./g, "-") );
+ }
+ return this.id;
+ }), output = $(this);
+ if (!headers.length || headers.length < settings.minimumHeaders || !output.length) {
+ return;
+ }
+
+ if (0 === settings.showSpeed) {
+ settings.showEffect = 'none';
+ }
+
+ var render = {
+ show: function() { output.hide().html(html).show(settings.showSpeed); },
+ slideDown: function() { output.hide().html(html).slideDown(settings.showSpeed); },
+ fadeIn: function() { output.hide().html(html).fadeIn(settings.showSpeed); },
+ none: function() { output.html(html); }
+ };
+
+ var get_level = function(ele) { return parseInt(ele.nodeName.replace("H", ""), 10); }
+ var highest_level = headers.map(function(_, ele) { return get_level(ele); }).get().sort()[0];
+ var return_to_top = '<i class="icon-arrow-up back-to-top"> </i>';
+
+ var level = get_level(headers[0]),
+ this_level,
+ html = settings.title + " <"+settings.listType+">";
+ headers.on('click', function() {
+ if (!settings.noBackToTopLinks) {
+ window.location.hash = this.id;
+ }
+ })
+ .addClass('clickable-header')
+ .each(function(_, header) {
+ this_level = get_level(header);
+ if (!settings.noBackToTopLinks && this_level === highest_level) {
+ $(header).addClass('top-level-header').after(return_to_top);
+ }
+ if (this_level === level) // same level as before; same indenting
+ html += "<li><a href='#" + header.id + "'>" + header.innerHTML + "</a>";
+ else if (this_level <= level){ // higher level than before; end parent ol
+ for(i = this_level; i < level; i++) {
+ html += "</li></"+settings.listType+">"
+ }
+ html += "<li><a href='#" + header.id + "'>" + header.innerHTML + "</a>";
+ }
+ else if (this_level > level) { // lower level than before; expand the previous to contain a ol
+ for(i = this_level; i > level; i--) {
+ html += "<"+settings.listType+"><li>"
+ }
+ html += "<a href='#" + header.id + "'>" + header.innerHTML + "</a>";
+ }
+ level = this_level; // update for the next one
+ });
+ html += "</"+settings.listType+">";
+ if (!settings.noBackToTopLinks) {
+ $(document).on('click', '.back-to-top', function() {
+ $(window).scrollTop(0);
+ window.location.hash = '';
+ });
+ }
+
+ render[settings.showEffect]();
+ };
+})(jQuery);
\ No newline at end of file
diff --git a/2.0/jsonschema/connection.json b/2.0/jsonschema/connection.json
new file mode 100644
index 0000000..ab31c60
--- /dev/null
+++ b/2.0/jsonschema/connection.json
@@ -0,0 +1,582 @@
+{
+ "$schema": "http://json-schema.org/draft-04/schema#",
+ "title": "Connection",
+ "type": "object",
+ "properties": {
+ "id": {
+ "$id": "/properties/id",
+ "type": "string",
+ "title": "Connection ID",
+ "description": "The self assigned unique identifier of the connection",
+ "examples": [
+ "myConnection"
+ ]
+ },
+ "name": {
+ "$id": "/properties/name",
+ "type": "string",
+ "title": "Connection name",
+ "description": "A name describing the connection",
+ "examples": [
+ "My first Connection"
+ ]
+ },
+ "connectionType": {
+ "$id": "/properties/connectionType",
+ "type": "string",
+ "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": [
+ "amqp-10"
+ ]
+ },
+ "connectionStatus": {
+ "$id": "/properties/connectionStatus",
+ "type": "string",
+ "enum": [ "open", "closed" ],
+ "title": "Connection status",
+ "description": "The persisted/desired status of the connection",
+ "examples": [
+ "open"
+ ]
+ },
+ "uri": {
+ "$id": "/properties/uri",
+ "type": "string",
+ "format": "uri",
+ "title": "Connection URI",
+ "description": "The URI defining the connections remote endpoint",
+ "examples": [
+ "amqps://user:password@localhost:5671"
+ ]
+ },
+ "ca": {
+ "$id": "/properties/ca",
+ "type": "string",
+ "title": "Trusted certificates",
+ "description": "Certificates to trust as DER in PEM-format",
+ "examples": [
+ "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----\n"
+ ]
+ },
+ "credentials": {
+ "$id": "/properties/credentials",
+ "type": "object",
+ "title": "Credentials",
+ "description": "Credentials with which Ditto authenticates itself at the connection URI",
+ "properties": {
+ "type": {
+ "$id": "/properties/credentials/properties/type",
+ "type": "string",
+ "enum": [ "client-cert" ],
+ "title": "Type of credentials",
+ "description": "Type of credentials",
+ "examples": [
+ "client-cert"
+ ]
+ },
+ "cert": {
+ "$id": "/properties/credentials/properties/cert",
+ "type": "string",
+ "title": "Client certificate for type client-cert",
+ "description": "Client certificate for type client-cert as DER in PEM-format",
+ "examples": [
+ "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----\n"
+ ]
+ },
+ "key": {
+ "$id": "/properties/credentials/properties/key",
+ "type": "string",
+ "title": "Client private key for type client-cert",
+ "description": "Unencrypted client private for type client-cert as PKCS8 in PEM-format",
+ "examples": [
+ "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n"
+ ]
+ }
+ }
+ },
+ "sources": {
+ "$id": "/properties/sources",
+ "type": "array",
+ "title": "The subscription sources of this connection",
+ "description": "The subscription sources of this connection",
+ "uniqueItems": true,
+ "items": {
+ "$id": "/properties/sources/items",
+ "type": "object",
+ "title": "Source",
+ "description": "A subscription source subscribed by this connection",
+ "properties": {
+ "addresses": {
+ "$id": "/properties/sources/properties/addresses",
+ "type": "array",
+ "uniqueItems": true,
+ "title": "Array of source addresses",
+ "description": "The source addresses this connection consumes messages from.",
+ "items": {
+ "$id": "/properties/sources/items/addresses/items",
+ "type": "string",
+ "title": "Source address",
+ "description": "A source address to consume messages from."
+ }
+ },
+ "consumerCount": {
+ "$id": "/properties/sources/items/properties/consumerCount",
+ "type": "integer",
+ "title": "Consumer count",
+ "description": "The number of consumers that should be attached to each source address.",
+ "default": 1
+ },
+ "authorizationContext": {
+ "$id": "/properties/sources/items/properties/authorizationContext",
+ "type": "array",
+ "title": "The authorization context",
+ "description": "The authorization context defines all authorization subjects associated for this source. ",
+ "uniqueItems": true,
+ "items": {
+ "$id": "/properties/authorizationContext/items",
+ "type": "string",
+ "title": "Authorization Subject",
+ "description": "An authorization subject associated with this source. You can either use a fixed subject or use a placeholder that resolves header values from incoming messages. For example to use the `device_id` header in the subject, you can specify the placeholder `{{ header:device_id }}` which is then replaced by Ditto when a message from this source is processed. By using a placeholder you can access any header value: `{{ header:<any-header-name> }}`.",
+ "examples": [
+ "ditto:myAuthorizationSubject",
+ "device:{{ header:device-id }}"
+ ]
+ }
+ },
+ "enforcement": {
+ "$id": "/properties/sources/items/properties/enforcement",
+ "type": "object",
+ "title": "Enforcement configuration",
+ "description": "Configuration of enforcement for this source",
+ "properties": {
+ "input": {
+ "$id": "/properties/sources/items/properties/enforcement/input",
+ "type": "string",
+ "title": "Input value of enforcement",
+ "description": "The input value of the enforcement that should identify the origin of the message (e.g. a device id). Placeholders can be used within this field depending on the connection type. E.g. for AMQP 1.0 connections you can use `{{ header:[any-header-name] }}` to resolve the value from a message header.",
+ "examples": ["{{ header:device_id }}", "{{ source:address }}"]
+ },
+ "filters": {
+ "$id": "/properties/sources/items/properties/enforcement/filters",
+ "type": "array",
+ "uniqueItems": true,
+ "title": "Array of enforcement filters",
+ "description": "An array of filters. One of the defined filters must match the input value from the message otherwise the message is rejected.",
+ "items": {
+ "$id": "/properties/sources/items/enforcement/filters/items",
+ "type": "string",
+ "title": "Enforcement filter string",
+ "description": "A filter that must match the input value for a message to be accepted. You can use the placeholders `{{ thing:id }}`, `{{ thing:name }}` or `{{ thing:namespace }}` in a filter."
+ }
+ }
+ }
+ },
+ "acknowledgementRequests": {
+ "$id": "/properties/sources/items/properties/acknowledgementRequests",
+ "type": "object",
+ "title": "Acknowledgement requests configuration",
+ "description": "Contains requests to acknowledgements which must be fulfilled before a message consumed from this source is technically settled/ACKed at the e.g. message broker.",
+ "additionalProperties": false,
+ "properties": {
+ "includes": {
+ "$id": "/properties/sources/items/properties/acknowledgementRequests/includes",
+ "type": "array",
+ "title": "Included acknowledgement requests",
+ "description": "Acknowledgement requests to be included for each message consumed by this source.",
+ "items": {
+ "title": "String representation of a single acknowledgement request",
+ "type": "string"
+ }
+ },
+ "filter": {
+ "$id": "/properties/sources/items/properties/acknowledgementRequests/filter",
+ "type": "string",
+ "title": "Filter expression whether to include acknowledgements at all",
+ "description": "Optional filter to be applied to the requested acknowledgements - takes an `fn:filter()` function expression",
+ "examples": [
+ "fn:filter(header:qos,'ne',0)"
+ ]
+ }
+ },
+ "required": [
+ "includes"
+ ]
+ },
+ "declaredAcks": {
+ "$id": "/properties/sources/items/properties/declaredAcks",
+ "type": "array",
+ "title": "Declared acknowledgement labels",
+ "description": "Contains labels of acknowledgements this source is allowed to send. Must be globally unique.",
+ "items": {
+ "title": "Acknowledgement label",
+ "type": "string"
+ }
+ },
+ "payloadMapping": {
+ "$id": "/properties/sources/items/properties/payloadMapping",
+ "type": "array",
+ "description": "References the IDs of payload mappers defined in the payload mapping definitions that are applied to messages received via this source.",
+ "items": {
+ "title": "Payload definition reference",
+ "type": "string"
+ }
+ },
+ "headerMapping": {
+ "$id": "/properties/sources/items/properties/headerMapping",
+ "type": "object",
+ "title": "Header mapping configuration",
+ "description": "Ditto protocol headers computed from external headers and certain properties of the Ditto protocol messages created by payload mapping.",
+ "additionalProperties": false,
+ "patternProperties": {
+ "^.+$": {
+ "title": "header value",
+ "description": "The key is the Ditto protocol header key to set, the value can make use of placeholders in order to access external header values via `{{ header:[any-header-name] }}`, the Thing ID via `{{ thing:id }}` or to access the Ditto protocol topic via `{{ topic:[topic-placeholder-attr] }}`.",
+ "type": "string"
+ }
+ }
+ },
+ "replyTarget": {
+ "$id": "/properties/sources/items/properties/replyTarget",
+ "type": "object",
+ "title": "Reply target configuration",
+ "description": "Configuration for sending responses of incoming commands.",
+ "properties": {
+ "enabled": {
+ "$id": "/properties/sources/items/properties/replyTarget/enabled",
+ "type": "boolean",
+ "title": "Whether reply target is enabled",
+ "description": "Whether reply target is enabled."
+ },
+ "address": {
+ "$id": "/properties/sources/items/properties/replyTarget/address",
+ "type": "string",
+ "title": "Reply target address",
+ "description": "The target address where responses of incoming commands from the parent source are published to. The following placeholders are allowed within the target address:\n * Thing ID: `{{ thing:id }}`\n * Thing Namespace: `{{ thing:namespace }}`\n * Thing Name: `{{ thing:name }}` (the part of the ID without the namespace)\n * Ditto protocol topic attribute: `{{ topic:[topic-placeholder-attr] }}`\n * Ditto protocol header value: `{{ header:[any-header-name] }}`\n\nIf placeholder resolution fails for a response, then the response is dropped.",
+ "examples": ["{{ header:device_id }}", "{{ source:address }}"]
+ },
+ "headerMapping": {
+ "$id": "/properties/sources/items/properties/replyTarget/headerMapping",
+ "type": "object",
+ "title": "Header mapping configuration",
+ "description": "External headers computed from headers and other properties of Ditto protocol messages.",
+ "additionalProperties": false,
+ "patternProperties": {
+ "^.+$": {
+ "title": "header value",
+ "description": "The key is the external header key to set, the value can make use of placeholders in order to access Ditto protocol header values via `{{ header:[any-header-name] }}`, the Thing ID via `{{ thing:id }}` or to access the DittoProtocol topic via `{{ topic:[topic-placeholder-attr] }}`.",
+ "type": "string"
+ }
+ }
+ },
+ "expectedResponseTypes": {
+ "$id": "/properties/sources/items/properties/replyTarget/expectedResponseTypes",
+ "type": "array",
+ "title": "Expected response types",
+ "description": "Contains a list of response types that should be published to the reply target.",
+ "uniqueItems": true,
+ "items": {
+ "type": "string",
+ "title": "Response types",
+ "enum": [
+ "response",
+ "error",
+ "nack"
+ ]
+ }
+ }
+ },
+ "required": [
+ "address"
+ ]
+ }
+ }
+ }
+ },
+ "targets": {
+ "$id": "/properties/targets",
+ "type": "array",
+ "title": "The publish targets of this connection",
+ "description": "The publish targets of this connection",
+ "uniqueItems": true,
+ "items": {
+ "$id": "/properties/targets/items",
+ "type": "object",
+ "title": "Target",
+ "description": "A publish target served by this connection",
+ "properties": {
+ "address": {
+ "$id": "/properties/targets/properties/address",
+ "type": "string",
+ "title": "Target address",
+ "description": "The target address where events, commands and messages are published to. The following placeholders are allowed within the target address:\n * Thing ID: `{{ thing:id }}`\n * Thing Namespace: `{{ thing:namespace }}`\n * Thing Name: `{{ thing:name }}` (the part of the ID without the namespace)\n * Ditto protocol topic attribute: `{{ topic:[topic-placeholder-attr] }}`\n * Ditto protocol header value: `{{ header:[any-header-name] }}`"
+ },
+ "topics": {
+ "$id": "/properties/targets/items/properties/topics",
+ "type": "array",
+ "title": "Topics",
+ "description": "The topics to which this target is registered for.",
+ "uniqueItems": true,
+ "items": {
+ "type": "string",
+ "title": "Subscribed topics.",
+ "description": "Contains the type of messages that are delivered to this target. You can receive\n * Thing events: `_/_/things/twin/events` (notification about twin change) \n * Live events: `_/_/things/live/events`\n * Live commands: `_/_/things/live/commands`\n * Live messages: `_/_/things/live/messages`\n\nYou can specify an additional namespace and/or event filter (URL encoded)",
+ "examples": [
+ "_/_/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?extraFields=attributes/tags,attributes/location"
+ ]
+ }
+ },
+ "authorizationContext": {
+ "$id": "/properties/targets/items/properties/authorizationContext",
+ "type": "array",
+ "title": "The authorization context",
+ "description": "The authorization context defines all authorization subjects associated for this target. ",
+ "uniqueItems": true,
+ "items": {
+ "$id": "/properties/authorizationContext/items",
+ "type": "string",
+ "title": "Authorization Subject",
+ "description": "An authorization subject associated with this target.",
+ "examples": [
+ "ditto:myAuthorizationSubject"
+ ]
+ }
+ },
+ "issuedAcknowledgementLabel": {
+ "$id": "/properties/targets/items/properties/issuedAcknowledgementLabel",
+ "type": "string",
+ "title": "Issued acknowledgement label for this target",
+ "description": "the optional label of an acknowledgement which should automatically be issued by this target based on the technical settlement/ACK the connection channel provides."
+ },
+ "payloadMapping": {
+ "$id": "/properties/targets/items/properties/payloadMapping",
+ "type": "array",
+ "description": "References the IDs of payload mappers defined in the payload mapping definitions that are applied to messages received via this target.",
+ "items": {
+ "title": "Payload definition reference",
+ "type": "string"
+ }
+ },
+ "headerMapping": {
+ "$id": "/properties/targets/items/properties/headerMapping",
+ "type": "object",
+ "title": "Header mapping configuration",
+ "description": "External headers computed from headers and other properties of Ditto protocol messages.",
+ "additionalProperties": false,
+ "patternProperties": {
+ "^.+$": {
+ "title": "header value",
+ "description": "The key is the external header key to set, the value can make use of placeholder in order to access Ditto protocol header values via `{{ header:[any-header-name] }}`, the Thing ID via `{{ thing:id }}` or to access the Ditto protocol topic via `{{ topic:[topic-placeholder-attr] }}`.",
+ "type": "string"
+ }
+ }
+ }
+ }
+ }
+ },
+ "clientCount": {
+ "$id": "/properties/clientCount",
+ "type": "integer",
+ "title": "Client count",
+ "description": "The client count defines how many clients are instantiated for this connection. Each client opens a separate 'physical' connection and thus raises the overall availability and throughput of the connection. Clients are always instantiated on separate AKKA cluster nodes while having only a single client per node. Therefore the max client count is limited by the number of cluster nodes.",
+ "default": 1,
+ "minimum": 1,
+ "maximum": "#clusterNodes",
+ "examples": [
+ 1,2,3
+ ]
+ },
+ "failoverEnabled": {
+ "$id": "/properties/failoverEnabled",
+ "type": "boolean",
+ "title": "Failover enabled",
+ "description": "Defines if this connection uses automatic reconnect/recovery mechanisms when an active open connection fails",
+ "default": true
+ },
+ "validateCertificates": {
+ "$id": "/properties/validateCertificates",
+ "type": "boolean",
+ "title": "Validate certificates",
+ "description": "Defines if SSL certificate validation is enabled for this connection",
+ "default": true
+ },
+ "processorPoolSize": {
+ "$id": "/properties/processorPoolSize",
+ "type": "integer",
+ "title": "Processor pool size",
+ "description": "The processor pool size determines how many mapping processors are instantiated per client, therefore the total amount of mapping processors depends on the configured client count. By increasing the processor count, you can scale the message throughput in mapping scenarios.",
+ "default": 5,
+ "minimum": 1,
+ "examples": [
+ 1,2,3,5,8
+ ]
+ },
+ "specificConfig": {
+ "$id": "/properties/specificConfig",
+ "type": "object",
+ "title": "Specific config",
+ "description": "Depending on the configured connection type, there might be protocol specific configuration options or tuning settings available. These can be configured in the specific config object. The specific config object is interpreted as a key value based map of setting properties.",
+ "additionalProperties": false,
+ "patternProperties": {
+ "^.+$": {
+ "title": "Setting value",
+ "description": "Setting value",
+ "type": "string"
+ }
+ }
+ },
+ "mappingDefinitions": {
+ "$id": "/properties/mappingDefinitions",
+ "type": "object",
+ "additionalProperties": {
+ "type": "object",
+ "description": "The payload mapping definitions.",
+ "properties": {
+ "mappingEngine": {
+ "$id": "/properties/mappingDefinitions/properties/mappingEngine",
+ "type": "string",
+ "title": "Mapping engine",
+ "description": "The Mapping engine defines which kind of mapping processor is instantiated for this connection. Currently you can choose between `Ditto`, `JavaScript`, `Normalized` and `ConnectionStatus`. The payload mapper documentation provides a detailed description of available mappers or how to bring your own mapper."
+ },
+ "options": {
+ "$id": "/properties/mappingDefinitions/properties/options",
+ "type": "object",
+ "title": "Options",
+ "description": "The mapping options contain specific configuration settings for the selected mapping engine. The options object is interpreted as a key value based map of setting properties.",
+ "additionalProperties": false,
+ "patternProperties": {
+ "^.+$": {
+ "title": "Setting value",
+ "description": "Setting value",
+ "type": "string"
+ }
+ }
+ }
+ },
+ "additionalProperties": false,
+ "required": [
+ "mappingEngine"
+ ]
+ }
+ },
+ "sshTunnel": {
+ "$id": "/properties/sshTunnel",
+ "type": "object",
+ "additionalProperties": {
+ "type": "object",
+ "description": "The configuration of a local SSH port forwarding used to tunnel the connection to the actual endpoint.",
+ "properties": {
+ "enabled": {
+ "$id": "/properties/sshTunnel/properties/enabled",
+ "type": "boolean",
+ "title": "Whether the tunnel is enabled.",
+ "description": "This flag controls whether Ditto establishes an SSH tunnel before connecting to the actual endpoint."
+ },
+ "uri": {
+ "$id": "/properties/sshTunnel/properties/uri",
+ "type": "string",
+ "title": "SSH host",
+ "description": "The URI of the SSH host."
+ },
+ "credentials": {
+ "$id": "/properties/sshTunnel/properties/credentials",
+ "type": "object",
+ "title": "Credentials",
+ "description": "Credentials with which Ditto authenticates itself at the SSH host.",
+ "properties": {
+ "type": {
+ "$id": "/properties/sshTunnel/properties/credentials/properties/type",
+ "type": "string",
+ "enum": [
+ "password",
+ "public-key"
+ ],
+ "title": "Type of credentials",
+ "description": "Type of credentials",
+ "examples": [
+ "password",
+ "public-key"
+ ]
+ },
+ "username": {
+ "$id": "/properties/sshTunnel/properties/credentials/properties/username",
+ "type": "string",
+ "title": "The username for authentication.",
+ "description": "A valid username.",
+ "examples": [
+ "tunnel-user"
+ ]
+ },
+ "password": {
+ "$id": "/properties/sshTunnel/properties/credentials/properties/password",
+ "type": "string",
+ "title": "The password for authentication.",
+ "description": "A valid password. Only required for type `plain`.",
+ "examples": [
+ "*****"
+ ]
+ },
+ "publicKey": {
+ "$id": "/properties/sshTunnel/properties/credentials/properties/publicKey",
+ "type": "string",
+ "title": "Public key for credentials type `public-key`.",
+ "description": "Public key for type `public-key` in PEM-format.",
+ "examples": [
+ "-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----\n"
+ ]
+ },
+ "privateKey": {
+ "$id": "/properties/sshTunnel/properties/credentials/properties/privateKey",
+ "type": "string",
+ "title": "Private key for credentials type `public-key`.",
+ "description": "Unencrypted private key for type `public-key` as PKCS8 in PEM-format.",
+ "examples": [
+ "-----BEGIN PRIVATE KEY-----\n...\n-----END PRIVATE KEY-----\n"
+ ]
+ }
+ }
+ },
+ "validateHost": {
+ "$id": "/properties/sshTunnel/properties/validateHost",
+ "type": "boolean",
+ "title": "Whether the SSH host is verified.",
+ "description": "This flag controls whether Ditto verifies the SSH host used for tunneling by checking the public key provided by the host against the given public key fingerprints."
+ },
+ "knownHosts": {
+ "$id": "/properties/sshTunnel/properties/knownHosts",
+ "type": "array",
+ "title": "A list of accepted fingerprints.",
+ "description": "One of these fingerprints must match the fingerprint of the public key the SSH host provides.",
+ "uniqueItems": true,
+ "items": {
+ "$id": "/properties/sshTunnel/properties/knownHosts/items",
+ "type": "string",
+ "title": "Fingerprint",
+ "description": "A public key fingerprint in the format the command line tool `ssh-keygen` produces, e.g. `MD5:e0:3a:34:1c:68:ed:c6:bc:7c:ca:a8:67:c7:45:2b:19`. The fingerprint is prefixed with the hash algorithm used to calculate the fingerprint. Supported algorithms are `MD5`, `SHA1`, `SHA224`, `SHA256`, `SHA384` and `SHA512`"
+ },
+ "additionalProperties": false,
+ "required": [
+ "enabled",
+ "uri",
+ "credentials"
+ ]
+ }
+ }
+ }
+ }
+ },
+ "additionalProperties": false,
+ "required": [ "id", "connectionType", "connectionStatus", "uri", "authorizationContext"]
+}
diff --git a/2.0/jsonschema/error.json b/2.0/jsonschema/error.json
new file mode 100644
index 0000000..0002035
--- /dev/null
+++ b/2.0/jsonschema/error.json
@@ -0,0 +1,38 @@
+{
+ "$schema": "http://json-schema.org/draft-04/schema#",
+ "type": "object",
+ "title": "Error",
+ "description": "An *error* contains information about the status code (in HTTP semantics), error identifier and message.\nOptionally a description and a link how to solve the error may be provided.",
+ "properties": {
+ "status": {
+ "type": "integer",
+ "title": "Error status",
+ "description": "The status code of the error with HTTP status code semantics (e.g.: 4xx for user errors, 5xx for server errors)."
+ },
+ "error": {
+ "type": "string",
+ "title": "Error code",
+ "description": "The error code or identifier that uniquely identifies the error.\nThis code is not to be considered as API and must therefore not be relied on.\nIt might change without prior notice."
+ },
+ "message": {
+ "type": "string",
+ "title": "Error message",
+ "description": "The human readable message that explains what went wrong during the execution of a command/message."
+ },
+ "description": {
+ "type": "string",
+ "title": "Error description",
+ "description": "Contains further information about the error e.g. a hint what caused the problem and how to solve it."
+ },
+ "href": {
+ "type": "string",
+ "title": "Error link",
+ "description": "A link to further information about the error and how to fix it."
+ }
+ },
+ "required": [
+ "status",
+ "error",
+ "message"
+ ]
+}
diff --git a/2.0/jsonschema/feature_v2.json b/2.0/jsonschema/feature_v2.json
new file mode 100644
index 0000000..3f06996
--- /dev/null
+++ b/2.0/jsonschema/feature_v2.json
@@ -0,0 +1,32 @@
+{
+ "$schema": "http://json-schema.org/draft-04/schema#",
+ "title": "Feature",
+ "type": "object",
+ "description": "A Feature is used to manage all data and functionality of a Thing that can be clustered in an outlined technical context.",
+ "properties": {
+ "definition": {
+ "title": "Definition",
+ "type": "array",
+ "description": "The Definition of the Feature, a list of Identifiers containing at least 1 Identifier in the form 'namespace:name:version'.",
+ "minItems": 1,
+ "uniqueItems": true,
+ "items": {
+ "type": "string",
+ "description": "A single fully qualified Identifier of a Feature Definition in the form 'namespace:name:version'.",
+ "pattern": "(?<namespace>[_a-zA-Z0-9\\-.]+):(?<name>[_a-zA-Z0-9\\-.]+):(?<version>[_a-zA-Z0-9\\-.]+)"
+ }
+ },
+ "properties": {
+ "title": "Properties",
+ "type": "object",
+ "description": "The data related to a Feature is managed in form of a list of properties. Each property itself can be either a simple/scalar value or a complex object. Allowed is any JSON object."
+ },
+ "desiredProperties": {
+ "title": "Desired Properties",
+ "type": "object",
+ "description": "The desired data related to a Feature is managed in form of a list of desired properties. Each desired property itself can be either a simple/scalar value or a complex object. Allowed is any JSON object."
+ }
+ },
+ "required": [
+ ]
+}
\ No newline at end of file
diff --git a/2.0/jsonschema/piggyback-command.json b/2.0/jsonschema/piggyback-command.json
new file mode 100644
index 0000000..d77bf40
--- /dev/null
+++ b/2.0/jsonschema/piggyback-command.json
@@ -0,0 +1,43 @@
+{
+ "$schema": "http://json-schema.org/draft-04/schema#",
+ "title": "Piggyback Command",
+ "type": "object",
+ "properties": {
+ "targetActorSelection": {
+ "$id": "/properties/targetActorSelection",
+ "type": "string",
+ "title": "Target actor selection",
+ "description": "Selects the AKKA actors which should receive this command",
+ "examples": [
+ "/system/sharding/connection"
+ ]
+ },
+ "headers": {
+ "$id": "/properties/headers",
+ "type": "object",
+ "title": "The Ditto headers sent with the command",
+ "description": "The Ditto headers sent with the command",
+ "additionalProperties": true
+ },
+ "piggybackCommand": {
+ "$id": "/properties/piggybackCommand",
+ "type": "object",
+ "title": "The piggyback command to send",
+ "description": "The piggyback command to send",
+ "properties": {
+ "type": {
+ "$id": "/properties/piggybackCommand/properties/type",
+ "type": "string",
+ "title": "The command type",
+ "description": "The command type",
+ "examples": [
+ "connectivity.commands:createConnection"
+ ]
+ }
+ },
+ "additionalProperties": true,
+ "required": [ "type" ]
+ }
+ },
+ "required": [ "targetActorSelection", "headers", "piggybackCommand"]
+}
\ No newline at end of file
diff --git a/2.0/jsonschema/policy.json b/2.0/jsonschema/policy.json
new file mode 100644
index 0000000..8dc1ad5
--- /dev/null
+++ b/2.0/jsonschema/policy.json
@@ -0,0 +1,94 @@
+{
+ "$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. This string can take an arbitrary value and is intended for documentational purposes, e.g. in order to document when it was created or with which purpose."
+ },
+ "expiry": {
+ "type": "string",
+ "description": "The optional expiry timestamp (formatted in ISO-8601) indicates how long this subject should be considered before it is automatically deleted from the Policy.",
+ "format": "date-time"
+ }
+ },
+ "required": [
+ "type"
+ ]
+ }
+ },
+ "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"
+ ]
+ }
+ }
+ },
+ "required": [
+ "grant", "revoke"
+ ]
+ }
+ }
+ },
+ "required": [
+ "subjects", "resources"
+ ]
+ }
+ }
+ }
+ },
+ "required": [
+ "policyId", "entries"
+ ]
+}
diff --git a/2.0/jsonschema/protocol-ack.json b/2.0/jsonschema/protocol-ack.json
new file mode 100644
index 0000000..21b1aed
--- /dev/null
+++ b/2.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/2.0/jsonschema/protocol-acks.json b/2.0/jsonschema/protocol-acks.json
new file mode 100644
index 0000000..86b3b7c
--- /dev/null
+++ b/2.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/2.0/jsonschema/protocol-announcement.json b/2.0/jsonschema/protocol-announcement.json
new file mode 100644
index 0000000..d5ba9fa
--- /dev/null
+++ b/2.0/jsonschema/protocol-announcement.json
@@ -0,0 +1,25 @@
+{
+ "$schema": "http://json-schema.org/draft-04/schema#",
+ "type": "object",
+ "description": "An Ditto Protocol announcement announces an event before it actually happens.",
+ "title": "Ditto Protocol announcement",
+ "properties": {
+ "topic": {
+ "type": "string",
+ "description": "Contains the topic of the announcement, ending with the announcement name."
+ },
+ "headers": {
+ "type": "object",
+ "description": "Additional headers."
+ },
+ "path": {
+ "type": "string",
+ "description": "The path is always the empty path `/` for an announcement."
+ },
+ "value": {
+ "type": ["object","string","number","array","boolean"],
+ "description": "The _value_ field contains the optional payload of the announcement."
+ }
+ },
+ "required": [ "topic", "headers", "path" ]
+}
diff --git a/2.0/jsonschema/protocol-envelope.json b/2.0/jsonschema/protocol-envelope.json
new file mode 100644
index 0000000..a7ef294
--- /dev/null
+++ b/2.0/jsonschema/protocol-envelope.json
@@ -0,0 +1,90 @@
+{
+ "$schema": "http://json-schema.org/draft-04/schema#",
+ "type": "object",
+ "description": "The Ditto Protocol envelope of a Ditto Protocol message. This wraps the actual payload in the `value` field.",
+ "title": "Ditto Protocol envelope",
+ "properties": {
+ "topic": {
+ "type": "string",
+ "description": "Contains information about the contents of the payload:\n * the affected Thing (namespace and Thing ID)\n * the type of operation (command/event, create/retrieve/modify/delete) \n\nExample: `com.acme/xdk_53/things/twin/commands/modify`"
+ },
+ "headers": {
+ "type": "object",
+ "description": "Additional headers.",
+ "properties": {
+ "content-type": {
+ "type": "string",
+ "description": "The content-type which describes the value of Ditto Protocol messages."
+ },
+ "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,100}"
+ }
+ },
+ "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 schema version of the payload.",
+ "minimum": 1,
+ "maximum": 2
+ }
+ },
+ "required": [ "correlation-id" ]
+ },
+ "path": {
+ "type": "string",
+ "description": "A Path that references a part of a Thing which is affected by this message.\nExamples:\n * `/features/location/properties/longitude` (a single sensor value)\n * `/` (the whole Thing)"
+ },
+ "fields": {
+ "type": "string",
+ "description": "The fields that should be included in the response.\nExample: `thingId,attributes(location)`"
+ },
+ "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"
+ ]
+}
diff --git a/2.0/jsonschema/protocol-error_response.json b/2.0/jsonschema/protocol-error_response.json
new file mode 100644
index 0000000..57bc3fd
--- /dev/null
+++ b/2.0/jsonschema/protocol-error_response.json
@@ -0,0 +1,68 @@
+{
+ "$schema": "http://json-schema.org/draft-04/schema#",
+ "type": "object",
+ "description": "The Ditto Protocol error response is sent in response to a command that failed during execution.",
+ "title": "Ditto Protocol error response",
+ "properties": {
+ "topic": {
+ "type": "string",
+ "description": "Contains the topic of the error including on which channel it was issued: `<namespace>/<name>/<group>/<optional-channel>/errors`\n* for Thing related errors: `<namespace>/<name>/things/twin/errors`\n* for Policy related errors: `<namespace>/<name>/policies/errors`"
+ },
+ "headers": {
+ "type": "object",
+ "description": "Additional headers.",
+ "properties": {
+ "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."
+ }
+ },
+ "required": [ "correlation-id" ]
+ },
+ "path": {
+ "type": "string",
+ "description": "The path is always `/` for error responses."
+ },
+ "value": {
+ "type": "object",
+ "description": "The _value_ field contains information about the error that occurred.",
+ "properties": {
+ "status": {
+ "type": "integer",
+ "title": "Error status",
+ "description": "The status code of the error with HTTP status code semantics (e.g.: 4xx for user errors, 5xx for server errors)."
+ },
+ "error": {
+ "type": "string",
+ "title": "Error code",
+ "description": "The error code or identifier that uniquely identifies the error.\nThis code is not to be considered as API and must therefore not be relied on.\nIt might change without prior notice."
+ },
+ "message": {
+ "type": "string",
+ "title": "Error message",
+ "description": "The human readable message that explains what went wrong during the execution of a command/message."
+ },
+ "description": {
+ "type": "string",
+ "title": "Error description",
+ "description": "Contains further information about the error e.g. a hint what caused the problem and how to solve it."
+ },
+ "href": {
+ "type": "string",
+ "title": "Error link",
+ "description": "A link to further information about the error and how to fix it."
+ }
+ },
+ "required": [
+ "status",
+ "error",
+ "message"
+ ]
+ },
+ "status": {
+ "type": "integer",
+ "description": "The status code that indicates the result of the command. 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", "value","status" ]
+}
diff --git a/2.0/jsonschema/protocol-response.json b/2.0/jsonschema/protocol-response.json
new file mode 100644
index 0000000..ffad170
--- /dev/null
+++ b/2.0/jsonschema/protocol-response.json
@@ -0,0 +1,42 @@
+{
+ "$schema": "http://json-schema.org/draft-04/schema#",
+ "type": "object",
+ "description": "The Ditto Protocol response is sent in response to a command.",
+ "title": "Ditto Protocol response",
+ "properties": {
+ "topic": {
+ "type": "string",
+ "description": "Contains the same topic as the commands which this response correlates to."
+ },
+ "headers": {
+ "type": "object",
+ "description": "Additional headers.",
+ "properties": {
+ "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."
+ },
+ "version": {
+ "type": "integer",
+ "description": "Determines the version of the *Things* payload.",
+ "minimum": 1,
+ "maximum": 2
+ }
+ },
+ "required": [ "correlation-id" ]
+ },
+ "path": {
+ "type": "string",
+ "description": "A Path that references a part of a Thing which is affected by this message.\nExamples:\n * `/feature/location/properties/longitude` (a single sensor value)\n * `/` (the whole Thing)"
+ },
+ "value": {
+ "type": ["object","string","number","array","boolean"],
+ "description": "The _value_ field contains the actual payload e.g. a sensor value."
+ },
+ "status": {
+ "type": "integer",
+ "description": "The status code that indicates the result of the command. 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/2.0/jsonschema/protocol-search-failed-payload.json b/2.0/jsonschema/protocol-search-failed-payload.json
new file mode 100644
index 0000000..39ef16d
--- /dev/null
+++ b/2.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/2.0/jsonschema/protocol-search-next-payload.json b/2.0/jsonschema/protocol-search-next-payload.json
new file mode 100644
index 0000000..542be23
--- /dev/null
+++ b/2.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/2.0/jsonschema/protocol-search-request-payload.json b/2.0/jsonschema/protocol-search-request-payload.json
new file mode 100644
index 0000000..a87f7fe
--- /dev/null
+++ b/2.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/2.0/jsonschema/protocol-search-subscribe-payload.json b/2.0/jsonschema/protocol-search-subscribe-payload.json
new file mode 100644
index 0000000..51ea62f
--- /dev/null
+++ b/2.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/2.0/jsonschema/protocol-search-subscriptionid.json b/2.0/jsonschema/protocol-search-subscriptionid.json
new file mode 100644
index 0000000..490bea7
--- /dev/null
+++ b/2.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/2.0/jsonschema/thing_v2.json b/2.0/jsonschema/thing_v2.json
new file mode 100644
index 0000000..cb4f927
--- /dev/null
+++ b/2.0/jsonschema/thing_v2.json
@@ -0,0 +1,90 @@
+{
+ "$schema": "http://json-schema.org/draft-04/schema#",
+ "type": "object",
+ "description": "A *Thing* is a generic entity which can be used as a handle for multiple *Features* belonging to this *Thing*.",
+ "title": "Thing in API v2",
+ "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)).\n\nExamples for a valid Thing ID:\n * `org.eclipse.ditto:xdk_53`\n * `foo:xdk_53`\n * `org.eclipse.vorto_42:xdk_thing`"
+ },
+ "policyId": {
+ "type": "string",
+ "description": "Links to the ID of an existing Policy which contains the authorization information applied for this Thing. The policy ID 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))."
+ },
+ "definition": {
+ "title": "Definition",
+ "type": "string",
+ "description": "The definition of this Thing declaring its model in the form 'namespace:name:version'.",
+ "pattern": "([_a-zA-Z0-9\\-.]+):([_a-zA-Z0-9\\-.]+):([_a-zA-Z0-9\\-.]+)"
+ },
+ "attributes": {
+ "title": "Attributes",
+ "type": "object",
+ "description": "The Attributes that describe this Thing in more detail. Can be an arbitrary JSON object. Attributes are typically used to model rather static properties at the Thing level. Static means that the values do not change as frequently as property values of Features."
+ },
+ "features": {
+ "title": "Features",
+ "type": "object",
+ "description": "The Features belonging to this Thing. A Thing can handle any number of Features.\n The key of this object represents the `featureId`. Due to the fact that a Feature ID often needs to be set in the path of a HTTP request, we strongly recommend to use a restricted the set of characters (e.g. those for [Uniform Resource Identifiers (URI)](http://www.ietf.org/rfc/rfc3986.txt)).",
+ "additionalProperties": {
+ "title": "Feature",
+ "type": "object",
+ "description": "A Feature is used to manage all data and functionality of a Thing that can be clustered in an outlined technical context.",
+ "additionalProperties": {
+ "type": "object",
+ "description": "The elements of a Feature.",
+ "properties": {
+ "definition": {
+ "title": "Definition",
+ "type": "array",
+ "description": "The definition of the Feature declaring its model, a list of Identifiers containing at least 1 Identifier in the form 'namespace:name:version'.",
+ "minItems": 1,
+ "uniqueItems": true,
+ "items": {
+ "type": "string",
+ "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\\-.]+)"
+ }
+ },
+ "properties": {
+ "title": "Properties",
+ "type": "object",
+ "description": "The data related to a Feature is managed in form of a list of properties. Each property itself can be either a simple/scalar value or a complex object. Allowed is any JSON object."
+ },
+ "desiredProperties": {
+ "title": "Desired Properties",
+ "type": "object",
+ "description": "The desired data related to a Feature is managed in form of a list of desired properties. Each desired property itself can be either a simple/scalar value or a complex object. Allowed is any JSON object."
+ }
+ }
+ }
+ }
+ },
+ "_namespace": {
+ "type": "string",
+ "description": "_(read-only)_ The namespace that is also contained in the `thingId` field (the prefix part, up to the `:`)."
+ },
+ "_revision": {
+ "type": "integer",
+ "description": "_(read-only)_ The revision is a counter which is incremented on each modification of a Thing."
+ },
+ "_created": {
+ "type": "string",
+ "description": "_(read-only)_ The created timestamp of the Thing in ISO-8601 UTC format. The timestamp is set on creation of a Thing.",
+ "format": "date-time"
+ },
+ "_modified": {
+ "type": "string",
+ "description": "_(read-only)_ The modified timestamp of the Thing in ISO-8601 UTC format. The timestamp is set on each modification of a Thing.",
+ "format": "date-time"
+ },
+ "_metadata": {
+ "type": "object",
+ "description": "_(read-only)_ The Metadata of the Thing. This field is not returned by default but must be selected explicitly. The content is a JSON object having the Thing's JSON structure with the difference that the JSON leaves of the Thing are JSON objects containing the metadata."
+ }
+ },
+ "required": [
+ "thingId", "policyId"
+ ]
+}
diff --git a/2.0/openapi/README.md b/2.0/openapi/README.md
new file mode 100644
index 0000000..92a7926
--- /dev/null
+++ b/2.0/openapi/README.md
@@ -0,0 +1,24 @@
+## Eclipse Ditto :: Documentation :: OpenAPI Specification
+
+This folder contains the OpenAPI [OpenAPI](https://www.openapis.org) [Specification version 2](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md) documentation for Eclipse Ditto.
+
+You can view it as nicely rendered HTML by importing the file for API version 2 into the [Swagger Online Editor](https://editor.swagger.io).
+
+### Extend/update api docs
+
+To extend or update the OpenAPI of Ditto you can add or change the files in the `sources` directory.
+
+### Build api docs
+
+1. Install `swagger-cli`: `$ cd sources && npm install`
+2. Build bundled docs:
+```
+// go to sources
+$ cd sources
+
+// only v2
+$ npm run build-v2
+
+// both
+$ npm run build
+```
diff --git a/2.0/openapi/ditto-api-2.yml b/2.0/openapi/ditto-api-2.yml
new file mode 100644
index 0000000..1251986
--- /dev/null
+++ b/2.0/openapi/ditto-api-2.yml
@@ -0,0 +1,7100 @@
+openapi: 3.0.0
+info:
+ title: Eclipse Ditto™ HTTP API
+ version: '2'
+ description: |-
+ JSON-based, REST-like API for Eclipse Ditto
+
+ The Eclipse Ditto HTTP API uses response status codes (see [RFC 7231](https://tools.ietf.org/html/rfc7231#section-6))
+ to indicate whether a specific request has been successfully completed, or not.
+
+ However, the descriptions we provide additionally to the status code (e.g. in our API docs, or error codes like. "things:thing.tooLarge") might change without advance notice. These are not be considered as official API, and must therefore not be applied in your applications or tests.
+servers:
+ - url: 'https://ditto.eclipseprojects.io/api/2'
+ description: online Ditto Sandbox
+ - url: /api/2
+ description: local Ditto
+tags:
+ - name: Things
+ description: Manage every thing
+ - name: Features
+ description: Structure the features of your things
+ - name: Policies
+ description: Control access to your things
+ - name: Things-Search
+ description: Find every thing
+ - name: Messages
+ description: Talk with your things
+ - name: CloudEvents
+ description: Process CloudEvents in Ditto
+security:
+ - Google:
+ - openid
+ - NginxBasic: []
+ - Bearer: []
+paths:
+ /things:
+ get:
+ summary: Retrieve multiple things with specified IDs
+ description: |-
+ 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
+ parameters:
+ - 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/TimeoutParam'
+ responses:
+ '200':
+ description: |-
+ The successfully completed request contains as its result the first 200 for the user available Things.
+ The Things are sorted in the same order as the Thing IDs were provided in the `ids` parameter.
+ content:
+ application/json:
+ schema:
+ type: array
+ items:
+ $ref: '#/components/schemas/Thing'
+ '400':
+ description: |-
+ The request could not be completed. At least one of the defined
+ query parameters was invalid.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '414':
+ description: |-
+ The request could not be completed due to an URI length exceeding 8k
+ characters.
+ post:
+ summary: Create a new thing
+ description: |-
+ Creates a thing with a default `thingId` and a default `policyId`.
+
+ 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.
+
+ The field `_created` is filled automatically with the timestamp of the creation. The field is read-only and can
+ be retrieved later by explicitly selecting it or used in search filters.
+ tags:
+ - Things
+ parameters:
+ - $ref: '#/components/parameters/RequestedAcksParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ - $ref: '#/components/parameters/ResponseRequiredParam'
+ - $ref: '#/components/parameters/AllowPolicyLockoutParam'
+ responses:
+ '201':
+ description: The thing was successfully created.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ Location:
+ description: The location of the created thing resource
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Thing'
+ '400':
+ description: |-
+ The request could not be completed. Possible reasons:
+
+ * 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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. 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.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/NewThing'
+ 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
+ description: |-
+ 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:
+ - $ref: '#/components/parameters/ThingIdPathParam'
+ - $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.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Thing'
+ '304':
+ $ref: '#/components/responses/NotModified'
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ 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.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ put:
+ 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.
+
+ * 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.
+
+
+ ### 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"
+
+ The field `_created` is filled automatically with the timestamp of the creation. The field is read-only and can
+ be retrieved later by explicitly selecting it or used in search filters.
+
+ ### 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:model:version",
+ "attributes": {
+ "foo": 1
+ },
+ "features": {...}
+ }
+ ```
+
+ 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
+ }
+ }
+ ```
+
+ 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": "namespace:model:version",
+ "attributes": {
+ "foo": 2,
+ "bar": false
+ },
+ "features": {...}
+ }
+ ```
+ tags:
+ - Things
+ parameters:
+ - $ref: '#/components/parameters/ThingIdPathParam'
+ - $ref: '#/components/parameters/IfMatchHeaderParam'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/PutMetadataParam'
+ - $ref: '#/components/parameters/RequestedAcksParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ - $ref: '#/components/parameters/ResponseRequiredParam'
+ responses:
+ '201':
+ description: The thing was successfully created.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ Location:
+ description: The location of the created thing resource
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Thing'
+ '204':
+ description: The thing was successfully modified.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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. Possible reasons:
+ * the referenced thing does not exist.
+ * 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/NewThing'
+ 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.
+ patch:
+ summary: Patch a thing with a specified ID
+ description: |-
+ Patch an existing thing specified by the `thingId` path parameter.
+
+ Patching a thing will merge the provided request body with the exisiting thing.
+ This makes it possible to change only some parts of a thing in single request without providing the full thing
+ structure in the request body.
+
+
+ ### Patch a thing
+
+ With this resource it is possible to add, update or delete parts of an existing thing.
+ The request body provided in *JSON merge patch* (RFC-7396) format will be merged with the existing thing.
+ Notice that the `null` value in the JSON body will delete the specified JSON key from the thing.
+ For further documentation of JSON merge patch see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+
+
+ ### Example
+ A Thing already exists with the following content:
+
+ ```
+ {
+ "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
+ }
+ }
+ }
+ }
+ }
+ ```
+
+ To make changes that only affect parts of the existing thing, e.g. add some attribute and delete a
+ specific feature property, the content of the request body could look like this:
+
+ ```
+ {
+ "attributes": {
+ "manufacturingYear": "2020"
+ },
+ "features": {
+ "water-tank": {
+ "properties": {
+ "configuration": {
+ "smartMode": null,
+ "tempToHold": 50,
+ }
+ }
+ }
+ }
+ }
+ ```
+
+ The request body will be merged with the existing thing and the result will be the following thing:
+
+ ```
+ {
+ "definition": "com.acme:coffeebrewer:0.1.0",
+ "attributes": {
+ "manufacturer": "ACME demo corp.",
+ "manufacturingYear": "2020",
+ "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": {
+ "brewingTemp": 87,
+ "tempToHold": 50,
+ "timeoutSeconds": 6000
+ },
+ "status": {
+ "waterAmount": 731,
+ "temperature": 44
+ }
+ }
+ }
+ }
+ }
+ ```
+
+ ### Permissions for patching an existing Thing
+
+ For updating an existing thing, the authorized subject needs **WRITE** permission on those parts of the thing
+ that are affected by the merge update.
+
+ For example, to successfully execute the above example the authorized subject needs to have unrestricted
+ *WRITE* permissions on all affected paths of the JSON merge patch: `attributes/manufacturingYear`,
+ `features/water-tank/properties/configuration/smartMode`,
+ `features/water-tank/properties/configuration/tempToHold`. The *WRITE* permission must not be revoked on any
+ level further down the hierarchy. Consequently it is also sufficient for the authorized subject to have
+ unrestricted *WRITE* permission at root level or unrestricted *WRITE* permission at `/attributes` and
+ `/features` etc.
+ tags:
+ - Things
+ parameters:
+ - $ref: '#/components/parameters/ThingIdPathParam'
+ - $ref: '#/components/parameters/IfMatchHeaderParam'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/PutMetadataParam'
+ - $ref: '#/components/parameters/RequestedAcksParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ - $ref: '#/components/parameters/ResponseRequiredParam'
+ responses:
+ '204':
+ description: The thing was successfully patched.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ The request could not be completed. Possible reasons:
+
+ * the JSON body of the thing to be patched is invalid
+ * the JSON body of the thing to be patched contains a `thingId` which does not match the ID in the path
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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. Possible reasons:
+ * the referenced thing does not exist.
+ * the caller has insufficient permissions to read the referenced thing.
+ * the policy that should be copied does not exist.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ content:
+ application/merge-patch+json:
+ schema:
+ type: object
+ properties:
+ thingId:
+ type: string
+ description: Unique identifier representing the thing
+ policyId:
+ type: string
+ 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:
+ $ref: '#/components/schemas/Attributes'
+ features:
+ $ref: '#/components/schemas/Features'
+ required:
+ - thingId
+ - policyId
+ example:
+ attributes:
+ manufacturingYear: '2020'
+ features:
+ water-tank:
+ properties:
+ configuration:
+ smartMode: null
+ tempToHold: 50
+ description: JSON representation of the thing to be patched.
+ delete:
+ summary: Delete a specific thing
+ description: |-
+ 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.
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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 not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '/things/{thingId}/definition':
+ get:
+ summary: Retrieve the definition of a specific thing
+ description: Returns the definition of the thing identified by the `thingId` path parameter.
+ tags:
+ - Things
+ parameters:
+ - $ref: '#/components/parameters/ThingIdPathParam'
+ - $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.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Definition'
+ '304':
+ $ref: '#/components/responses/NotModified'
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ 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 not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ put:
+ summary: Create or update the definition of a specific thing
+ description: |-
+ * 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/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.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ Location:
+ description: The location of the created definition resource
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Definition'
+ '204':
+ description: The definition was successfully updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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 not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ $ref: '#/components/requestBodies/Definition'
+ patch:
+ summary: Patch the definition of a specific thing
+ description: |-
+ * If the thing does not have a definition yet, this request will create it.
+ * If the thing already has a definition you can replace it by providing the new definition in the request body.
+ * If the request body is set to `null` then the defintion will be deleted.
+
+ Notice that the `null` value in the JSON body has a special meaning and will delete the definition from the thing.
+ For further documentation see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+ tags:
+ - Things
+ parameters:
+ - $ref: '#/components/parameters/ThingIdPathParam'
+ - $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 patched.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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 not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ content:
+ application/merge-patch+json:
+ schema:
+ $ref: '#/components/schemas/Definition'
+ example: '"example:test:definition"'
+ description: |-
+ JSON string representation of the definition to be patched.
+
+ Consider that the value has to be a JSON string.
+
+ Examples:
+
+ * 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: `""`
+ * `null`: the definition will be deleted
+ delete:
+ summary: Delete the definition of a specific thing
+ description: Deletes the definition of the thing identified by the `thingId`.
+ tags:
+ - Things
+ parameters:
+ - $ref: '#/components/parameters/ThingIdPathParam'
+ - $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)).
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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 its definition was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '/things/{thingId}/policyId':
+ get:
+ summary: Retrieve the policy ID of a thing
+ description: Returns the policy ID of the thing identified by the `thingId` path parameter.
+ tags:
+ - Things
+ parameters:
+ - $ref: '#/components/parameters/ThingIdPathParam'
+ - $ref: '#/components/parameters/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ responses:
+ '200':
+ description: The request successfully returned the policy ID.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ type: string
+ '304':
+ $ref: '#/components/responses/NotModified'
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ 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 in the context of the authenticated user.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ put:
+ summary: Update the policy ID of a thing
+ description: |-
+ Update the policy ID of the thing identified by the `thingId` path parameter.
+
+ ### 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/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/RequestedAcksParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ - $ref: '#/components/parameters/ResponseRequiredParam'
+ responses:
+ '204':
+ description: The policy ID was successfully updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ 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 in the context of the authenticated user.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ type: string
+ example: '"your.namespace:your-policy-name"'
+ description: |-
+ 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
+ patch:
+ summary: Patch the policy ID of a thing
+ description: |-
+ Patch the policy ID of the thing identified by the `thingId` path parameter.
+
+ The `policyId` of the thing will be updated.
+ Notice that for this resource it is not possible to remove the `policyId` from the thing by setting the
+ payload to `null`.
+ tags:
+ - Things
+ parameters:
+ - $ref: '#/components/parameters/ThingIdPathParam'
+ - $ref: '#/components/parameters/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/RequestedAcksParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ - $ref: '#/components/parameters/ResponseRequiredParam'
+ responses:
+ '204':
+ description: 'The policy ID was successfully patched. Note: You will need to create the policy content separately.'
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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 `policyId` can not be removed from a thing.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ 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 in the context of the authenticated user.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ content:
+ application/merge-patch+json:
+ schema:
+ type: string
+ example: '"your.namespace:your-policy-name"'
+ description: |-
+ 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
+ description: 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/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ responses:
+ '200':
+ description: The attributes of the specific thing were successfully retrieved.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Attributes'
+ '304':
+ $ref: '#/components/responses/NotModified'
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ 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.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ put:
+ 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. 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/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.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ Location:
+ description: The location of the created attribute resource
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Attributes'
+ '204':
+ description: The attributes were successfully updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ 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 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 not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ $ref: '#/components/requestBodies/Attributes'
+ patch:
+ summary: Patch all attributes of a specific thing
+ description: |-
+ Patch the attributes of a thing identified by the `thingId` path parameter.
+ The existing attributes will be merged with the JSON content set in the request body.
+
+ Notice that the `null` value has a special meaning and can be used to delete all or specific attributes from a thing.
+ For further documentation see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+
+ **Note**: In contrast to the "PUT things/{thingId}/attributes" request,
+ a partial update is supported here and request body is merged with the existing attributes.
+ tags:
+ - Things
+ parameters:
+ - $ref: '#/components/parameters/ThingIdPathParam'
+ - $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 patched.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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 patched is invalid
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ 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 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 not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ content:
+ application/merge-patch+json:
+ schema:
+ $ref: '#/components/schemas/Attributes'
+ 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 patched. Consider that the value has to be a [JSON merge patch](https://tools.ietf.org/html/rfc7396).
+
+ Examples:
+ * 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
+ * `null`: deletes all attributes
+ required: true
+ delete:
+ summary: Delete all attributes of a specific thing at once
+ description: Deletes all attributes of the thing identified by the `thingId` path parameter.
+ tags:
+ - Things
+ parameters:
+ - $ref: '#/components/parameters/ThingIdPathParam'
+ - $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.
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '/things/{thingId}/attributes/{attributePath}':
+ get:
+ 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).
+
+ ### 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/AttributesPathPathParam'
+ - $ref: '#/components/parameters/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ responses:
+ '200':
+ description: The attribute was successfully retrieved.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '304':
+ $ref: '#/components/responses/NotModified'
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ 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.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ put:
+ 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.
+
+ * 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/AttributesPathPathParam'
+ - $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.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ Location:
+ description: The location of the created attribute resource
+ schema:
+ type: string
+ '204':
+ description: The attribute was successfully modified.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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 not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ $ref: '#/components/requestBodies/Value'
+ patch:
+ summary: Patch a specific attribute of a specific thing
+ description: |-
+ Patch a specific attribute of a 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 merged
+ * If you set the request body to `null` for an existing attribute path then the attribute will be deleted.
+ For further documentation see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+
+ The attribute (JSON) can be referenced hierarchically, by applying JSON Pointer notation (RFC-6901).
+
+ ### Example:
+
+ In order to patch 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/AttributesPathPathParam'
+ - $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 patched.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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 not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ $ref: '#/components/requestBodies/PatchValue'
+ delete:
+ 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).
+
+ ### 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/AttributesPathPathParam'
+ - $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.
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '/things/{thingId}/features':
+ get:
+ summary: List all features of a specific thing
+ description: 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/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/RequestedAcksParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ - $ref: '#/components/parameters/ResponseRequiredParam'
+ responses:
+ '200':
+ description: |-
+ The list of features of the specific thing were successfully
+ retrieved.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Features'
+ example:
+ featureId1:
+ definition:
+ - 'namespace:definition1:v1.0'
+ properties:
+ property1: value1
+ featureId2:
+ definition:
+ - 'namespace:definition2:v1.0'
+ properties:
+ property2: value2
+ '304':
+ $ref: '#/components/responses/NotModified'
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ 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.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ put:
+ summary: Create or modify all features of a specific thing at once
+ description: |-
+ 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/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.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ Location:
+ description: The location of the created features resource
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Features'
+ example: {}
+ '204':
+ description: The features were successfully modified.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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 not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Features'
+ 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 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
+ patch:
+ summary: Patch all features of a specific thing
+ description: |-
+ Patch all features of a thing identified by the `thingId` path parameter.
+
+ The existing features will be merged with the JSON content set in the request body.
+
+ Notice that the `null` value has a special meaning and can be used to delete specific features from the thing.
+ For further documentation see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+
+ **Note**: In contrast to the "PUT thing/{thingId}/features" request, a partial update is supported here
+ and request body is merged with the existing features.
+
+ ### Example
+
+ The following example will add/update the properties `brewed-coffees`, `tempToHold` and `failState`.
+ The configuration property `smartMode` will be deleted from the thing.
+
+
+ ```
+ {
+ "coffee-brewer": {
+ "properties": {
+ "brewed-coffees": 10
+ }
+ },
+ "water-tank": {
+ "properties": {
+ "configuration": {
+ "smartMode": null,
+ "tempToHold": 50,
+ },
+ "status": {
+ "failState": true
+ }
+ }
+ }
+ }
+ ```
+ tags:
+ - Features
+ parameters:
+ - $ref: '#/components/parameters/ThingIdPathParam'
+ - $ref: '#/components/parameters/FeatureIdPathPathParam'
+ - $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 patched.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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 not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ content:
+ application/merge-patch+json:
+ schema:
+ $ref: '#/components/schemas/Features'
+ example:
+ coffee-brewer:
+ properties:
+ brewed-coffees: 10
+ water-tank:
+ properties:
+ configuration:
+ smartMode: null
+ tempToHold: 50
+ status:
+ failState: true
+ description: |-
+ JSON object of all features to be patched. Consider that the value has to be a [JSON merge patch](https://tools.ietf.org/html/rfc7396).
+
+ Examples:
+ * a nested object with multiple features as shown in the example value field
+
+ * **Note**: To delete certain entries of a feature the `null` value can be used.
+ For further documentation see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+ required: true
+ delete:
+ summary: Delete all features of a specific thing
+ description: Deletes all features of the thing identified by the `thingId` path parameter.
+ tags:
+ - Features
+ parameters:
+ - $ref: '#/components/parameters/ThingIdPathParam'
+ - $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.
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '/things/{thingId}/features/{featureId}':
+ get:
+ 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.
+ tags:
+ - Features
+ parameters:
+ - $ref: '#/components/parameters/ThingIdPathParam'
+ - $ref: '#/components/parameters/FeatureIdPathPathParam'
+ - $ref: '#/components/parameters/FeatureFieldsQueryParam'
+ - $ref: '#/components/parameters/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ responses:
+ '200':
+ description: The feature was successfully retrieved.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Feature'
+ '304':
+ $ref: '#/components/responses/NotModified'
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ 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 with the specified `featureId` was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ put:
+ 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 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/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.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ Location:
+ description: The location of the created feature resource
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Feature'
+ '204':
+ description: The feature was successfully modified.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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 not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Feature'
+ 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.
+ 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
+ patch:
+ summary: Patch a specific feature of a specific thing
+ description: |-
+ Patch a specific feature identified by the `featureId` path parameter of a thing identified by the `thingId` path parameter.
+
+ The existing feature will be merged with the JSON content set in the request body.
+
+ Notice that the `null` value can be used to delete the whole feature or specific parts of it.
+ For further documentation see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+
+ **Note**: In contrast to the "PUT things/{thingId}/features/{featureId}" request,
+ a partial update is supported here and request body is merged with the existing feature.
+
+ ### Example
+
+ Set the `featureId` to **coffee-brewer** and all properties in the body part
+ to update the `brewed-coffees` property and delete the definition.
+
+ ```
+ {
+ "definition": null,
+ "properties": {
+ "brewed-coffees": 42
+ }
+ }
+ ```
+ tags:
+ - Features
+ parameters:
+ - $ref: '#/components/parameters/ThingIdPathParam'
+ - $ref: '#/components/parameters/FeatureIdPathPathParam'
+ - $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 patched.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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 not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ content:
+ application/merge-patch+json:
+ schema:
+ $ref: '#/components/schemas/Feature'
+ example:
+ definition: null
+ properties:
+ connected: true
+ brewed-coffees: 0
+ description: |-
+ JSON representation of the feature to be patched. Consider that the value has to be a [JSON merge patch](https://tools.ietf.org/html/rfc7396).
+
+ Examples:
+ * a nested object with multiple model definitions and multiple properties as shown in the example value field
+ * **Note**: To delete certain properties of a feature the `null` value can be used.
+ For further documentation see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+ required: true
+ delete:
+ 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.
+ tags:
+ - Features
+ parameters:
+ - $ref: '#/components/parameters/ThingIdPathParam'
+ - $ref: '#/components/parameters/FeatureIdPathPathParam'
+ - $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.
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '/things/{thingId}/features/{featureId}/definition':
+ get:
+ summary: List the definition of a feature
+ description: 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/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ responses:
+ '200':
+ description: The definition was successfully retrieved.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/FeatureDefinition'
+ '304':
+ $ref: '#/components/responses/NotModified'
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ 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
+ with `featureId` was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ put:
+ 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.
+
+ 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/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.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ Location:
+ description: The location of the created definition resource
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/FeatureDefinition'
+ '204':
+ description: The definition was successfully updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ 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 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 given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/FeatureDefinition'
+ 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 are strings in the format `"namespace:name:version"` which is enforced.
+ required: true
+ patch:
+ summary: Patch the definition of a feature
+ description: |-
+ Patch the definition of a feature identified by the `thingId` and `featureId` path parameter.
+
+ The existing definition field will be overwritten with the JSON array set in the request body.
+
+ Notice that the `null` value can be used to delete the definition of a feature.
+ For further documentation see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+ tags:
+ - Features
+ parameters:
+ - $ref: '#/components/parameters/ThingIdPathParam'
+ - $ref: '#/components/parameters/FeatureIdPathPathParam'
+ - $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 patched.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ 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 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 given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ content:
+ application/merge-patch+json:
+ schema:
+ $ref: '#/components/schemas/FeatureDefinition'
+ example:
+ - 'com.acme:coffeebrewer:0.1.0'
+ - 'com.acme:coffeebrewer:1.1.0'
+ description: |-
+ JSON array of the complete definition to be patched. Consider that the value has to be a JSON array.
+
+ The content of the JSON array are strings in the format `"namespace:name:version"` which is enforced.
+ To delete the definition use `null` as content in the request body.
+ required: true
+ delete:
+ summary: Delete the definition of a feature
+ description: 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/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. 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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 with `featureId` was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '/things/{thingId}/features/{featureId}/properties':
+ get:
+ summary: List all properties of a feature
+ description: Returns 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/PropertiesFieldsQueryParam'
+ - $ref: '#/components/parameters/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ responses:
+ '200':
+ description: The properties were successfully retrieved.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/FeatureProperties'
+ '304':
+ $ref: '#/components/responses/NotModified'
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ 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 with `featureId` was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ put:
+ 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.
+
+ 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/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.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/FeatureProperties'
+ '204':
+ description: The properties were successfully updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ 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 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 given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/FeatureProperties'
+ 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\-]*
+ required: true
+ patch:
+ summary: Patch all properties of a feature
+ description: |-
+ Patch the properties of a feature identified by the `thingId` and `featureId` path parameter.
+
+ The existing properties will be merged with the JSON content set in the request body.
+
+ Notice that the `null` value can be used to delete specific feature properties.
+ For further documentation see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+
+ **Note**: In contrast to the "PUT things/{thingId}/features/{featureId}/properties" request,
+ a partial update is supported here and request body is merged with the existing properties.
+ tags:
+ - Features
+ parameters:
+ - $ref: '#/components/parameters/ThingIdPathParam'
+ - $ref: '#/components/parameters/FeatureIdPathPathParam'
+ - $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 patched.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ 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 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 given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ content:
+ application/merge-patch+json:
+ schema:
+ $ref: '#/components/schemas/FeatureProperties'
+ example:
+ configuration:
+ smartMode: null
+ brewingTemp: 87
+ tempToHold: 44
+ timeoutSeconds: 6000
+ status:
+ waterAmount: 731
+ temperature: 44
+ description: |-
+ JSON object of all properties to be patched.
+
+ Consider that the value has to be a [JSON merge patch](https://tools.ietf.org/html/rfc7396).
+ 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
+ description: 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/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.
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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 with `featureId` was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '/things/{thingId}/features/{featureId}/properties/{propertyPath}':
+ get:
+ summary: Retrieve a specific property of a feature
+ description: |-
+ 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/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ responses:
+ '200':
+ description: The property was successfully retrieved.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '304':
+ $ref: '#/components/responses/NotModified'
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '404':
+ description: |-
+ 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:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ put:
+ 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),
+
+ ### 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/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.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '204':
+ description: The property was successfully updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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 given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ $ref: '#/components/requestBodies/Value'
+ patch:
+ summary: Patch a specific property of a feature
+ description: |-
+ Patch a specific property of a feature identified by the `thingId` and `featureId` path parameter.
+
+ The existing property will be merged with the existing one of the thing.
+
+ Notice that the `null` value can be used to delete the specified propertyPath.
+ For further documentation see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+
+ 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/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/RequestedAcksParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ - $ref: '#/components/parameters/ResponseRequiredParam'
+ responses:
+ '204':
+ description: The property was successfully patched.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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 given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ $ref: '#/components/requestBodies/PatchValue'
+ delete:
+ 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)
+
+ ### 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/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.
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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 property or
+ the thing with the specified `thingId` or the feature with `featureId` was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '/things/{thingId}/features/{featureId}/desiredProperties':
+ get:
+ summary: List all desired properties of a feature
+ description: Returns all desired 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/DesiredPropertiesFieldsQueryParam'
+ - $ref: '#/components/parameters/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ responses:
+ '200':
+ description: The desired properties were successfully retrieved.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/FeatureProperties'
+ '304':
+ $ref: '#/components/responses/NotModified'
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '402':
+ description: The request could not be completed due to exceeded data volume or exceeded transaction count.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '404':
+ description: |-
+ The request could not be completed. The specified feature has no desired properties or
+ the thing with the specified `thingId` or the feature with `featureId` was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ put:
+ summary: Create or update all desired properties of a feature at once
+ description: |-
+ Create or update the desired properties of a feature identified by the `thingId` and `featureId` path parameter.
+
+ The desired 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/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/RequestedAcksParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ - $ref: '#/components/parameters/ResponseRequiredParam'
+ responses:
+ '201':
+ description: The desired properties were successfully created.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/FeatureProperties'
+ '204':
+ description: The desired properties were successfully updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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 desired feature roperties to be created/modified is invalid
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ 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 desired 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 given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/FeatureProperties'
+ example:
+ configuration:
+ smartMode: true
+ brewingTemp: 87
+ tempToHold: 44
+ timeoutSeconds: 6000
+ status:
+ waterAmount: 731
+ temperature: 44
+ description: |-
+ JSON object of all desried 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
+ patch:
+ summary: Patch all desired properties of a feature
+ description: |-
+ Patch the desired properties of a feature identified by the `thingId` and `featureId` path parameter.
+
+ The existing desired properties will be merged with the JSON content set in the request body.
+
+ Notice that the `null` value can be used to delete the whole feature or specific parts of it.
+ For further documentation see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+
+ **Note**: In contrast to the "PUT things/{thingId}/features/{featureId}/desiredProperties" request,
+ a partial update is supported here and request body is merged with the existing desired properties.
+ tags:
+ - Features
+ parameters:
+ - $ref: '#/components/parameters/ThingIdPathParam'
+ - $ref: '#/components/parameters/FeatureIdPathPathParam'
+ - $ref: '#/components/parameters/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/RequestedAcksParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ - $ref: '#/components/parameters/ResponseRequiredParam'
+ responses:
+ '204':
+ description: The desired properties were successfully patched.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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 desired feature roperties to be created/modified is invalid
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ 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 desired 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 given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ content:
+ application/merge-patch+json:
+ schema:
+ $ref: '#/components/schemas/FeatureProperties'
+ example:
+ configuration:
+ smartMode: null
+ brewingTemp: 87
+ tempToHold: 44
+ timeoutSeconds: 6000
+ status:
+ waterAmount: 731
+ temperature: 44
+ description: |-
+ JSON object of all desried properties to be patched.
+
+ Consider that the value has to be a [JSON merge patch](https://tools.ietf.org/html/rfc7396). 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 desired properties of a feature
+ description: Deletes all desired 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/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/RequestedAcksParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ - $ref: '#/components/parameters/ResponseRequiredParam'
+ responses:
+ '204':
+ description: The desired properties were successfully deleted.
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ The request could not be completed. Possible reasons:
+ * the caller has insufficient permissions.
+ For deleting the desired 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 desired properties or
+ the thing with the specified `thingId` or the feature with `featureId` was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '/things/{thingId}/features/{featureId}/desiredProperties/{propertyPath}':
+ get:
+ summary: Retrieve a specific desired property of a feature
+ description: |-
+ Returns the a specific desired property path of the feature identified by the `thingId` and `featureId` path parameter.
+
+ The desired 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/desiredProperties/configuration/brewingTemp`
+ tags:
+ - Features
+ parameters:
+ - $ref: '#/components/parameters/ThingIdPathParam'
+ - $ref: '#/components/parameters/FeatureIdPathPathParam'
+ - $ref: '#/components/parameters/PropertyPathPathParam'
+ - $ref: '#/components/parameters/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ responses:
+ '200':
+ description: The desired property was successfully retrieved.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '304':
+ $ref: '#/components/responses/NotModified'
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '404':
+ description: |-
+ The request could not be completed. The specified desired property or
+ the thing with the specified `thingId` or the feature with `featureId` was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ put:
+ summary: Create or update a specific desired property of a feature
+ description: |-
+ Create or update a specific desired property of a feature identified by the `thingId` and `featureId` path parameter.
+
+ The desired property will be created if it doesn't exist or else updated.
+
+ The desired 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/desiredProperties/configuration/brewingTemp`
+ tags:
+ - Features
+ parameters:
+ - $ref: '#/components/parameters/ThingIdPathParam'
+ - $ref: '#/components/parameters/FeatureIdPathPathParam'
+ - $ref: '#/components/parameters/PropertyPathPathParam'
+ - $ref: '#/components/parameters/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/RequestedAcksParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ - $ref: '#/components/parameters/ResponseRequiredParam'
+ responses:
+ '201':
+ description: The desired property was successfully created.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '204':
+ description: The desired property was successfully updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ The request could not be completed. Possible reasons:
+ * the caller has insufficient permissions.
+ For creating/updating a desired 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 given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ $ref: '#/components/requestBodies/Value'
+ patch:
+ summary: Patch a specific desired property of a feature
+ description: |-
+ Patch a specific desired property of a feature identified by the `thingId` and `featureId` path parameter.
+
+ The exisiting desired property of a feature will be merged with the JSON content set in the request body.
+
+ Notice that the `null` value can be used to delete the specified propertyPath.
+ For further documentation see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+
+ The desired 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/desiredProperties/configuration/brewingTemp`
+ tags:
+ - Features
+ parameters:
+ - $ref: '#/components/parameters/ThingIdPathParam'
+ - $ref: '#/components/parameters/FeatureIdPathPathParam'
+ - $ref: '#/components/parameters/PropertyPathPathParam'
+ - $ref: '#/components/parameters/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/RequestedAcksParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ - $ref: '#/components/parameters/ResponseRequiredParam'
+ responses:
+ '204':
+ description: The desired property was successfully patched.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ The request could not be completed. Possible reasons:
+ * the caller has insufficient permissions.
+ For creating/updating a desired 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 given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ $ref: '#/components/requestBodies/PatchValue'
+ delete:
+ summary: Delete a specific desired property of a feature
+ description: |-
+ Deletes a specific desired property of the feature identified by the `thingId`
+ and `featureId` path parameter.
+
+ The desired 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/desiredProperties/configuration/brewingTemp`
+ tags:
+ - Features
+ parameters:
+ - $ref: '#/components/parameters/ThingIdPathParam'
+ - $ref: '#/components/parameters/FeatureIdPathPathParam'
+ - $ref: '#/components/parameters/PropertyPathPathParam'
+ - $ref: '#/components/parameters/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/RequestedAcksParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ - $ref: '#/components/parameters/ResponseRequiredParam'
+ responses:
+ '204':
+ description: The desired property was successfully deleted.
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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 desired property or
+ the thing with the specified `thingId` or the feature with `featureId` was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '/things/{thingId}/inbox/claim':
+ post:
+ summary: Initiates claiming a specific thing in order to gain access
+ description: |-
+ ### 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.
+
+ The HTTP request blocks until all acknowledgement requests are fulfilled.
+ By default, it 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.
+
+ Note that the client chooses which HTTP status code it wants to return. Ditto
+ will forward the status code to you. (Also note that '204 - No Content' status code
+ will never return a body, even if the client responded with a body).
+
+ ### 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:
+ - $ref: '#/components/parameters/ThingIdPathParam'
+ - $ref: '#/components/parameters/MessageClaimTimeoutParam'
+ - $ref: '#/components/parameters/LiveMessageRequestedAcksParam'
+ responses:
+ '200':
+ description: |-
+ The Claim message was processed successfully and the response body
+ contains the custom response. The response body may contain
+ arbitrary data chosen by the recipient. The response code defaults
+ to `200` but may be chosen by the recipient too.
+ '204':
+ description: |-
+ The Claim message was processed successfully and no custom response
+ body was set. The response code defaults to `204` but may be chosen
+ by the recipient.
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '404':
+ description: |-
+ The request could not be completed. Possible reasons:
+ * the referenced thing does not exist.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '408':
+ description: The request could not be completed due to timeout.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '413':
+ $ref: '#/components/responses/MessageTooLarge'
+ '429':
+ description: |-
+ The user has sent too many requests in a given amount of time ("rate
+ limiting").
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '503':
+ $ref: '#/components/responses/MessageTimeout'
+ requestBody:
+ $ref: '#/components/requestBodies/Payload'
+ '/things/{thingId}/inbox/messages/{messageSubject}':
+ post:
+ summary: Send a message TO a specific thing
+ description: |-
+ ### 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 HTTP request blocks until all acknowledgement requests are fulfilled.
+ By default, it blocks until a response to the 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.
+
+ In order to handle the message in a fire and forget manner, add
+ a query-parameter `timeout=0` to the request.
+
+ Note that the client chooses which HTTP status code it wants to return. Ditto
+ will forward the status code to you. (Also note that '204 - No Content' status code
+ will never return a body, even if the client responded with a body).
+
+ ### 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:
+ - $ref: '#/components/parameters/ThingIdPathParam'
+ - $ref: '#/components/parameters/MessageSubjectPathParam'
+ - $ref: '#/components/parameters/MessageTimeoutParam'
+ - $ref: '#/components/parameters/LiveMessageRequestedAcksParam'
+ responses:
+ '202':
+ description: The message was sent but not necessarily received by the thing (fire and forget).
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '404':
+ description: |-
+ The request could not be completed. Possible reasons:
+ * the referenced thing does not exist.
+ * the caller has insufficient permissions to interact with the messages of referenced thing.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '408':
+ description: The request could not be completed due to timeout.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '413':
+ $ref: '#/components/responses/MessageTooLarge'
+ '503':
+ $ref: '#/components/responses/MessageTimeout'
+ requestBody:
+ $ref: '#/components/requestBodies/Payload'
+ '/things/{thingId}/outbox/messages/{messageSubject}':
+ post:
+ summary: Send a message FROM a specific thing
+ description: |-
+ 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.
+
+ The HTTP request blocks until all acknowledgement requests are fulfilled.
+ By default, it blocks until a response to the 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.
+
+ In order to handle the message in a fire and forget manner, add
+ a query-parameter `timeout=0` to the request.
+
+ Note that the client chooses which HTTP status code it wants to return. Ditto
+ will forward the status code to you. (Also note that '204 - No Content' status code
+ will never return a body, even if the client responded with a body).
+
+ ### 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:
+ - $ref: '#/components/parameters/ThingIdPathParam'
+ - $ref: '#/components/parameters/MessageSubjectPathParam'
+ - $ref: '#/components/parameters/MessageTimeoutParam'
+ - $ref: '#/components/parameters/LiveMessageRequestedAcksParam'
+ responses:
+ '202':
+ description: The message was sent (fire and forget).
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '404':
+ description: |-
+ The request could not be completed. Possible reasons:
+ * the referenced thing does not exist.
+ * the caller has insufficient permissions to interact with the messages of referenced thing.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '408':
+ description: The request could not be completed due to timeout.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '413':
+ $ref: '#/components/responses/MessageTooLarge'
+ '503':
+ $ref: '#/components/responses/MessageTimeout'
+ requestBody:
+ $ref: '#/components/requestBodies/Payload'
+ '/things/{thingId}/features/{featureId}/inbox/messages/{messageSubject}':
+ post:
+ summary: Send a message TO a specific feature of a specific thing
+ description: |-
+ 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 HTTP request blocks until all acknowledgement requests are fulfilled.
+ By default, it blocks until a response to the 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.
+
+ In order to handle the message in a fire and forget manner, add
+ a query-parameter `timeout=0` to the request.
+
+ Note that the client chooses which HTTP status code it wants to return. Ditto
+ will forward the status code to you. (Also note that '204 - No Content' status code
+ will never return a body, even if the client responded with a body).
+
+ ### 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:
+ - $ref: '#/components/parameters/ThingIdPathParam'
+ - $ref: '#/components/parameters/FeatureIdPathPathParam'
+ - $ref: '#/components/parameters/MessageSubjectPathParam'
+ - $ref: '#/components/parameters/MessageTimeoutParam'
+ - $ref: '#/components/parameters/LiveMessageRequestedAcksParam'
+ responses:
+ '202':
+ description: |-
+ The message was sent but not necessarily received by the feature
+ (fire and forget).
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '404':
+ description: |-
+ The request could not be completed. Possible reasons:
+ * the referenced thing does not exist.
+ * the caller has insufficient permissions to interact with the messages of referenced thing.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '408':
+ description: The request could not be completed due to timeout.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '413':
+ $ref: '#/components/responses/MessageTooLarge'
+ '503':
+ $ref: '#/components/responses/MessageTimeout'
+ requestBody:
+ $ref: '#/components/requestBodies/Payload'
+ '/things/{thingId}/features/{featureId}/outbox/messages/{messageSubject}':
+ post:
+ summary: Send a message FROM a specific feature of a specific thing
+ description: |-
+ 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.
+
+ The HTTP request blocks until all acknowledgement requests are fulfilled.
+ By default, it blocks until a response to the 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.
+
+ In order to handle the message in a fire and forget manner, add
+ a query-parameter `timeout=0` to the request.
+
+ Note that the client chooses which HTTP status code it wants to return. Ditto
+ will forward the status code to you. (Also note that '204 - No Content' status code
+ will never return a body, even if the client responded with a body).
+
+ ### 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:
+ - $ref: '#/components/parameters/ThingIdPathParam'
+ - $ref: '#/components/parameters/FeatureIdPathPathParam'
+ - $ref: '#/components/parameters/MessageSubjectPathParam'
+ - $ref: '#/components/parameters/MessageTimeoutParam'
+ - $ref: '#/components/parameters/LiveMessageRequestedAcksParam'
+ responses:
+ '202':
+ description: The message was sent (fire and forget).
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '404':
+ description: |-
+ The request could not be completed. Possible reasons:
+ * the referenced thing does not exist.
+ * the caller has insufficient permissions to interact with the messages of referenced thing.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '408':
+ description: The request could not be completed due to timeout.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '413':
+ $ref: '#/components/responses/MessageTooLarge'
+ '503':
+ $ref: '#/components/responses/MessageTimeout'
+ requestBody:
+ $ref: '#/components/requestBodies/Payload'
+ '/policies/{policyId}':
+ get:
+ summary: Retrieve a specific policy
+ description: |-
+ 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 of a thing, 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.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Policy'
+ '304':
+ $ref: '#/components/responses/NotModified'
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '404':
+ description: |-
+ 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:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ put:
+ summary: Create or update a policy with a specified ID
+ description: |-
+ 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.
+
+ ### 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.
+
+ By default the authorized subject needs WRITE permission on the root resource of the created policy. You can
+ however omit this check by setting the parameter `allow-policy-lockout` to `true`.
+
+ 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.
+
+ ```
+ {
+ "entries": {
+ "DEFAULT": {
+ "subjects": {
+ "{{ request:subjectId }}": {
+ "type": "the creator"
+ }
+ },
+ "resources": {
+ "policy:/": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ },
+ "thing:/": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ },
+ "message:/": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ }
+ }
+ }
+ }
+ }
+ ```
+
+ ### 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 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'
+ - $ref: '#/components/parameters/AllowPolicyLockoutParam'
+ responses:
+ '201':
+ description: The policy was successfully created.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ Location:
+ description: The location of the created policy resource
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/NewPolicy'
+ '204':
+ description: The policy was successfully updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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.
+ (You can omit this check by setting the `allow-policy-lockout` parameter.)
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '404':
+ description: |-
+ 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:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/NewPolicy'
+ 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.
+ 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
+ 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.
+
+ 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.
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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
+ not found in the context of the authenticated user.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '/policies/{policyId}/actions/activateTokenIntegration':
+ post:
+ summary: Activate subjects for this policy derived from the token
+ description: |-
+ **This action only works when authenticated with a Json Web Token (JWT).**
+
+ Based on the authenticated token (JWT), **for each policy entry** matching those conditions:
+ * the authenticated token is granted the `EXECUTE` permission to perform the `activateTokenIntegration` action
+ * one of the subject IDs is contained in the authenticated token
+ * at least one `READ` permission to a `thing:/` resource path is granted
+
+ a new subject is **injected into the matched policy entry** calculated with information extracted from the
+ authenticated JWT.
+
+ The injected subjects expire when the JWT expires.
+ tags:
+ - Policies
+ parameters:
+ - $ref: '#/components/parameters/PolicyIdPathParam'
+ responses:
+ '204':
+ description: The request was successful. Subjects were injected into authorized policy entries.
+ '400':
+ description: The request could not be completed because the authentication was not performed with a JWT.
+ '403':
+ description: |-
+ The request could not be completed because the authenticated JWT did not have the `EXECUTE` permission on any
+ entries of the policy.
+ '404':
+ description: |-
+ The request could not be completed because no policy entry matched the following conditions:
+ * containing a a subject ID matching the JWT's authenticated subject
+ * containing a `READ` permission granted to a `thing:/` resource path
+ requestBody:
+ $ref: '#/components/requestBodies/ActivateTokenIntegration'
+ '/policies/{policyId}/actions/deactivateTokenIntegration':
+ post:
+ summary: Deactivate subjects for this policy derived from the token
+ description: |-
+ **This action only works when authenticated with a Json Web Token (JWT).**
+
+ Based on the authenticated token (JWT), **for each policy entry** matching those conditions:
+ * the authenticated token is granted the `EXECUTE` permission to perform the `deactivateTokenIntegration` action
+ * one of the subject IDs is contained in the authenticated token
+
+ the calculated subject with information extracted from the authenticated JWT is **removed
+ from the matched policy entry**.
+ tags:
+ - Policies
+ parameters:
+ - $ref: '#/components/parameters/PolicyIdPathParam'
+ responses:
+ '204':
+ description: The request was successful. Subjects were removed from authorized policy entries.
+ '400':
+ description: The request could not be completed because the authentication was not performed with a JWT.
+ '403':
+ description: |-
+ The request could not be completed because the authenticated JWT did not have the `EXECUTE` permission on any
+ entries of the policy.
+ '404':
+ description: |-
+ The request could not be completed because no policy entry matched the following conditions:
+ * containing a a subject ID matching the JWT's authenticated subject
+ '/policies/{policyId}/entries':
+ get:
+ summary: Retrieve the entries of a specific policy
+ description: |-
+ Returns all policy entries of the policy identified by the `policyId`
+ path parameter.
+ tags:
+ - Policies
+ parameters:
+ - $ref: '#/components/parameters/PolicyIdPathParam'
+ - $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.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/PolicyEntries'
+ '304':
+ $ref: '#/components/responses/NotModified'
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '404':
+ description: |-
+ 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:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ put:
+ summary: Modify the entries of a specific policy
+ description: |-
+ 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/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ - $ref: '#/components/parameters/ResponseRequiredParam'
+ responses:
+ '204':
+ description: The policy entries were successfully updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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
+ not found in the context of the authenticated user.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/PolicyEntries'
+ 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.
+ 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 the entries of a specific Label of a specific policy
+ description: |-
+ 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/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ responses:
+ '200':
+ description: |-
+ The request successfully returned completed and returned is the
+ policy entry.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/PolicyEntry'
+ '304':
+ $ref: '#/components/responses/NotModified'
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ 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
+ user.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ put:
+ summary: Create or modify the entries of a specific Label of a specific policy
+ description: |-
+ 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/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ - $ref: '#/components/parameters/ResponseRequiredParam'
+ responses:
+ '201':
+ description: The policy entry was successfully created.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ Location:
+ description: The location of the created policy entry
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/PolicyEntry'
+ '204':
+ description: The policy entry was successfully updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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
+ not found in the context of the authenticated user.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/PolicyEntry'
+ 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.
+ 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 the entries of a specific Label of a specific policy
+ description: |-
+ 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/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ - $ref: '#/components/parameters/ResponseRequiredParam'
+ responses:
+ '204':
+ description: The policy entry was successfully deleted.
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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
+ not found in the context of the authenticated user.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '/policies/{policyId}/entries/{label}/actions/activateTokenIntegration':
+ post:
+ summary: Activate a subject for this policy entry derived from the token
+ description: |-
+ **This action only works when authenticated with a Json Web Token (JWT).**
+
+ Based on the authenticated token (JWT), **this policy entry** is checked to match those conditions:
+ * the authenticated token is granted the `EXECUTE` permission to perform the `activateTokenIntegration` action
+ * one of the subject IDs is contained in the authenticated token
+ * at least one `READ` permission to a `thing:/` resource path is granted
+
+ When all conditions match, a new subject is **injected into this policy entry** calculated with information
+ extracted from the authenticated JWT.
+
+ The injected subjects expire when the JWT expires.
+ tags:
+ - Policies
+ parameters:
+ - $ref: '#/components/parameters/PolicyIdPathParam'
+ - $ref: '#/components/parameters/LabelPathParam'
+ responses:
+ '204':
+ description: The request was successful. The subject was injected.
+ '400':
+ description: The request could not be completed because the authentication was not performed with a JWT.
+ '403':
+ description: |-
+ The request could not be completed because the authenticated JWT did not have the `EXECUTE` permission on this
+ policy entry.
+ '404':
+ description: |-
+ The request could not be completed because this policy entry did not match the following conditions:
+ * containing a a subject ID matching the JWT's authenticated subject
+ * containing a `READ` permission granted to a `thing:/` resource path
+ requestBody:
+ $ref: '#/components/requestBodies/ActivateTokenIntegration'
+ '/policies/{policyId}/entries/{label}/actions/deactivateTokenIntegration':
+ post:
+ summary: Deactivate a subject for this policy entry derived from the token
+ description: |-
+ **This action only works when authenticated with a Json Web Token (JWT).**
+
+ Based on the authenticated token (JWT), **this policy entry** is checked to match those conditions:
+ * the authenticated token is granted the `EXECUTE` permission to perform the `deactivateTokenIntegration` action
+ * one of the subject IDs is contained in the authenticated token
+
+ When all conditions match, the calculated subject with information extracted from the authenticated JWT is **removed
+ from this policy entry**.
+ tags:
+ - Policies
+ parameters:
+ - $ref: '#/components/parameters/PolicyIdPathParam'
+ - $ref: '#/components/parameters/LabelPathParam'
+ responses:
+ '204':
+ description: The request was successful. The subject was removed.
+ '400':
+ description: The request could not be completed because the authentication was not performed with a JWT.
+ '403':
+ description: The request could not be completed because the user did not have the `EXECUTE` permission on this policy entry.
+ '404':
+ description: |-
+ The request could not be completed because this policy entry did not match the following conditions:
+ * containing a a subject ID matching the JWT's authenticated subject
+ '/policies/{policyId}/entries/{label}/subjects':
+ get:
+ summary: Retrieve all Subjects for a specific Label of a specific policy
+ description: |-
+ 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/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ responses:
+ '200':
+ description: The request successfully returned. The subjects are returned.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Subjects'
+ '304':
+ $ref: '#/components/responses/NotModified'
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ 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
+ user.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ put:
+ summary: Create or modify all Subjects for a specific Label of a specific policy
+ description: |-
+ 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/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ - $ref: '#/components/parameters/ResponseRequiredParam'
+ responses:
+ '204':
+ description: The Subjects were successfully created or updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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
+ not found in the context of the authenticated user.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Subjects'
+ description: |-
+ JSON representation of the Subjects.
+
+
+ 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}/subjects/{subjectId}':
+ get:
+ 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 `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/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ responses:
+ '200':
+ description: |-
+ The request successfully returned completed and returned is the
+ Subject.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/SubjectEntry'
+ '304':
+ $ref: '#/components/responses/NotModified'
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ 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
+ authenticated user.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ put:
+ 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 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/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ - $ref: '#/components/parameters/ResponseRequiredParam'
+ responses:
+ '201':
+ description: The Subject was successfully created.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ Location:
+ description: The location of the created Subject
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/SubjectEntry'
+ '204':
+ description: The Subject was successfully updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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
+ user.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/SubjectEntry'
+ description: JSON representation of the Subject
+ required: true
+ delete:
+ summary: Delete one specific Subject for a specific Label of a specific policy
+ description: |-
+ 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/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. 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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
+ authenticated user.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '/policies/{policyId}/entries/{label}/resources':
+ get:
+ summary: Retrieve all Resources for a specific Label of a specific policy
+ description: |-
+ 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/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ responses:
+ '200':
+ description: The request successfully returned. The resources are returned.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Resources'
+ '304':
+ $ref: '#/components/responses/NotModified'
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ 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
+ user.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ put:
+ summary: Create or modify all Resources for a specific Label of a specific policy
+ description: |-
+ 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:/features/confidential": {
+ "grant": [],
+ "revoke": [
+ "READ"
+ ]
+ }
+ }
+ ```
+ tags:
+ - Policies
+ parameters:
+ - $ref: '#/components/parameters/PolicyIdPathParam'
+ - $ref: '#/components/parameters/LabelPathParam'
+ - $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.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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
+ user.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Resources'
+ description: JSON representation of the Resources
+ required: true
+ '/policies/{policyId}/entries/{label}/resources/{resourcePath}':
+ get:
+ summary: Retrieve one specific Resource for a specific Label of a specific policy
+ description: |-
+ 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/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ responses:
+ '200':
+ description: |-
+ The request successfully returned completed and returned is the
+ Resource.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ResourceEntry'
+ '304':
+ $ref: '#/components/responses/NotModified'
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ 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
+ authenticated user.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ put:
+ 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
+ identified by the `policyId` path parameter.
+ tags:
+ - Policies
+ parameters:
+ - $ref: '#/components/parameters/PolicyIdPathParam'
+ - $ref: '#/components/parameters/LabelPathParam'
+ - $ref: '#/components/parameters/ResourcePathPathParam'
+ - $ref: '#/components/parameters/IfMatchHeaderParamHash'
+ - $ref: '#/components/parameters/IfNoneMatchHeaderParam'
+ - $ref: '#/components/parameters/TimeoutParam'
+ - $ref: '#/components/parameters/ResponseRequiredParam'
+ responses:
+ '201':
+ description: The Resource was successfully created.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ Location:
+ description: The location of the created Resource
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ResourceEntry'
+ '204':
+ description: The Resource was successfully updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '304':
+ $ref: '#/components/responses/NotModified'
+ '400':
+ description: |-
+ 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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
+ user.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ '413':
+ $ref: '#/components/responses/EntityTooLarge'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/ResourceEntry'
+ description: JSON representation of the Resource
+ required: true
+ delete:
+ summary: Delete one specific Resource for a specific Label of a specific policy
+ description: |-
+ 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/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. 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:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ 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
+ authenticated user.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '412':
+ $ref: '#/components/responses/PreconditionFailed'
+ /whoami:
+ get:
+ summary: Retrieve information about the current caller
+ description: 'Get information about the current caller, e.g. the auth subjects that are generated for the caller.'
+ tags:
+ - Policies
+ responses:
+ '200':
+ description: The request successfully returned information about the caller.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/WhoAmI'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ /search/things:
+ get:
+ 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, the
+ result contains all things which the logged in user is allowed to read.
+
+ * The search is case sensitive. In case you don't know how exactly the
+ spelling of value of the namespace, name, attribute, feature etc. is, use the *like*
+ notation instead of *eq* for filtering.
+
+ * 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([+|-]{property})```
+ * ```sort([+|-]{property},[+|-]{property},...)```
+
+ #### Paging operations
+
+ * ```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 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 or timeouts and will be removed eventually.
+
+ #### Examples:
+
+ * ```sort(+thingId)```
+ * ```sort(-attributes/manufacturer)```
+ * ```sort(+thingId,-attributes/manufacturer)```
+ * ```size(10)``` return 10 results
+ * ```cursor(LOREMIPSUM)``` return results after the position of the cursor `LOREMIPSUM`.
+
+ #### 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,
+ you will need to separate the options using a comma (,) character.
+
+ ```size(200),cursor(LOREMIPSUM)```
+
+ The deprecated paging option `limit` may not be combined with the other paging options `size` and `cursor`.
+ required: false
+ schema:
+ type: string
+ tags:
+ - Things-Search
+ responses:
+ '200':
+ description: An array of the matching things.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/SearchResultThings'
+ '400':
+ description: |-
+ The request could not be completed. A provided parameter is in a
+ wrong format.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: The request could not be completed due to an invalid authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '504':
+ description: The request ran out of time to execute on the the back-end. Optimize your query and try again.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ /search/things/count:
+ get:
+ summary: Count things
+ description: |-
+ This resource can be used to count things.
+
+ The query parameter `filter` is not mandatory. If it is not set there is
+ returned the total amount of 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:
+
+ ```eq(attributes/location,"kitchen")```
+ parameters:
+ - $ref: '#/components/parameters/SearchFilter'
+ - $ref: '#/components/parameters/NamespacesFilter'
+ - $ref: '#/components/parameters/TimeoutParam'
+ tags:
+ - Things-Search
+ responses:
+ '200':
+ description: A number indicating the amount of matched things
+ content:
+ application/json:
+ schema:
+ type: integer
+ '400':
+ description: |-
+ The request could not be completed. A provided parameter is in a
+ wrong format.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: The request could not be completed due to an invalid authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '504':
+ description: The request ran out of time to execute on the the back-end. Optimize your query and try again.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ /cloudevents:
+ post:
+ summary: Processes a CloudEvent sent in Ditto Protocol
+ description: |-
+ Provides an endpoint accepting [CloudEvents via its HTTP protocol binding](https://github.com/cloudevents/spec/blob/v1.0/http-protocol-binding.md)
+ in [Ditto Protocol JSON](https://www.eclipse.org/ditto/protocol-specification.html).
+
+ The endpoint can also directly be configured as a [Knative eventing](https://knative.dev/docs/eventing/) destination.
+
+ Find more documentation on that [here](https://www.eclipse.org/ditto/httpapi-protocol-bindings-cloudevents.html).
+ tags:
+ - CloudEvents
+ parameters:
+ - in: header
+ name: ce-specversion
+ description: The CloudEvents "specversion".
+ schema:
+ type: string
+ example: '1.0'
+ required: true
+ - in: header
+ name: ce-type
+ description: The CloudEvents event "type".
+ schema:
+ type: string
+ example: com.example.someevent
+ required: true
+ - in: header
+ name: ce-source
+ description: The CloudEvents event "source".
+ schema:
+ type: string
+ example: /mycontext
+ required: true
+ - in: header
+ name: ce-id
+ description: The CloudEvents event "id".
+ schema:
+ type: string
+ example: 1234-1234-1234
+ required: true
+ - in: header
+ name: ce-time
+ description: The CloudEvents event "time".
+ schema:
+ type: string
+ format: date-time
+ example: '2020-12-31T23:59:59Z'
+ required: true
+ - in: header
+ name: ce-dataschema
+ description: 'The CloudEvents event "dataschema". If provided, this must start with `ditto:`.'
+ schema:
+ type: string
+ required: false
+ responses:
+ '202':
+ description: 'The Ditto Protocol CloudEvent was successfully parsed, the authentication was valid and also reached the persistence.'
+ '400':
+ description: |-
+ The request could not be completed. Possible reasons:
+ * the CloudEvent could not be parsed as some mandatory CloudEvent headers were missing from the request
+ * the payload was missing from the CloudEvent
+ * the [Ditto Protocol JSON](https://www.eclipse.org/ditto/protocol-specification.html) message could not be parsed or was missing a required field
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '403':
+ description: |-
+ The request could not be completed. Possible reasons:
+ * the caller has insufficient permissions.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '404':
+ description: |-
+ The request could not be completed. Possible reasons:
+ * the referenced thing does not exist.
+ * the caller has insufficient permissions to perform the contained Ditto Protocol command.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '408':
+ description: The request could not be completed due to timeout.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ '415':
+ description: The `Content-Type` of the request was not supported.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ requestBody:
+ content:
+ application/vnd.eclipse.ditto+json:
+ schema:
+ type: object
+ properties:
+ topic:
+ type: string
+ description: |-
+ Contains information about the contents of the payload:
+ * the affected Thing (namespace and Thing ID)
+ * the type of operation (command/event, create/retrieve/modify/delete)
+ example: org.eclipse.ditto/thing-1/things/twin/commands/modify
+ headers:
+ type: object
+ description: Additional headers.
+ properties:
+ 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.
+ example:
+ correlation-id: 1234-4321-1234
+ path:
+ type: string
+ description: References the part of a Thing which is affected by this message.
+ example: /features/location/properties/longitude
+ value:
+ oneOf:
+ - type: object
+ - type: string
+ - type: number
+ - type: array
+ - type: boolean
+ description: The `value` field contains the actual payload e.g. a sensor value.
+ required:
+ - topic
+ - path
+ example:
+ topic: org.eclipse.ditto/thing-1/things/twin/commands/modify
+ path: /
+ value:
+ attributes:
+ foo: 42
+ description: |-
+ The [Ditto Protocol JSON](https://www.eclipse.org/ditto/protocol-specification.html) payload defining which
+ command to process.
+components:
+ requestBodies:
+ Attributes:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Attributes'
+ 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:
+ * 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
+ Definition:
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/Definition'
+ example: '"example:test:definition"'
+ description: |-
+ 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 should follow the pattern: [_a-zA-Z0-9\-]:[_a-zA-Z0-9\-]:[_a-zA-Z0-9\-]
+ * an empty string: `""`
+ Payload:
+ content:
+ application/json:
+ schema:
+ type: string
+ example: ''
+ application/octet-stream:
+ schema:
+ type: string
+ example: ''
+ text/plain:
+ schema:
+ type: string
+ example: ''
+ description: |-
+ Payload of the message with max size of 250 kB. It can be any HTTP
+ supported content, including binary content.
+ Value:
+ content:
+ application/json:
+ schema:
+ type: object
+ example: {}
+ description: |-
+ JSON representation of the value to be created/updated. This may be as
+ well `null` or an empty object.
+
+ Consider that the value has to be a JSON value, examples:
+
+ * for a number, the JSON value is the number: `42`
+
+ * for a string, the JSON value must be quoted: `"aString"`
+
+ * 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\-]*
+
+ * for an list, the JSON value is the list: `[ 1,2,3 ]`
+ required: true
+ PatchValue:
+ content:
+ application/merge-patch+json:
+ schema:
+ type: object
+ example: {}
+ description: |-
+ JSON representation of the value to be patched. This may be as well an empty object.
+
+ Consider that the value has to be a JSON value.
+
+ Examples:
+ * for a number, the JSON value is the number: `42`
+ * for a string, the JSON value must be quoted: `"aString"`
+ * 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\-]*
+ * for an list, the JSON value is the list: `[ 1,2,3 ]`
+ * special value `null` will delete the referenced key. For further documentation see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+ required: true
+ ActivateTokenIntegration:
+ content:
+ application/json:
+ schema:
+ properties:
+ announcement:
+ $ref: '#/components/schemas/SubjectAnnouncement'
+ example:
+ announcement:
+ beforeExpiry: 5m
+ whenDeleted: true
+ description: Optional request payload for `activateTokenIntegration` policy action.
+ required: false
+ responses:
+ EntityTooLarge:
+ description: The created or modified entity is larger than the accepted limit of 100 kB.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ MessageTimeout:
+ description: The request could not be completed as there is no consumer for this message connected.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ MessageTooLarge:
+ description: The size of the send message is larger than the accepted limit of 250 kB.
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ NotModified:
+ description: |-
+ The (sub-)resource has not been modified. This happens when you specified a If-None-Match header which
+ matches the current ETag of the (sub-)resource.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ PreconditionFailed:
+ description: |-
+ 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:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '#/components/schemas/AdvancedError'
+ parameters:
+ AllowPolicyLockoutParam:
+ name: allow-policy-lockout
+ in: query
+ description: |-
+ Defines whether a subject is allowed to create a policy without having WRITE permission on the policy
+ resource of the created policy.
+
+ The default (if ommited) is `false`.
+ required: false
+ schema:
+ type: boolean
+ AttributesPathPathParam:
+ name: attributePath
+ in: path
+ description: 'The path to the attribute, e.g. **manufacturer/name**'
+ required: true
+ schema:
+ type: string
+ AttributesFieldsQueryParam:
+ name: fields
+ in: query
+ description: |-
+ 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)
+
+ For example:
+ * `?fields=model` would select only `model` attribute value (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 `( )`:
+ * 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=location(longitude,latitude)` would select the `longitude` and `latitude` value inside the `location` attribute
+
+ #### Examples
+
+ * `?fields=model,make,location(longitude,latitude)`
+
+ * `?fields=listOfAddresses/postal(city,street))`
+ required: false
+ schema:
+ type: string
+ DesiredPropertiesFieldsQueryParam:
+ name: fields
+ in: query
+ description: |-
+ Contains a comma-separated list of fields from the desiredProperties to be
+ included in the returned JSON.
+
+ #### Selectable fields
+
+ Supports selecting arbitrary sub-fields as defined in the desiredProperties by
+ using a comma-separated list:
+ * several desiredProperties paths can be passed as a comma-separated list of JSON pointers (RFC-6901)
+
+ For example:
+ * `?fields=temperature` would select only `temperature` property value of desiredProperties (if present)
+ * `?fields=temperature,humidity` would select only `temperature` and `humidity` property values of desiredProperties (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
+
+ For example:
+ * `?fields=location(longitude,latitude)` would select the `longitude` and `latitude` value inside the `location` property of desiredProperties
+
+ #### Examples
+
+ * `?fields=temperature,humidity,location(longitude,latitude)`
+
+ * `?fields=configuration,status(powerConsumption/watts)`
+ required: false
+ schema:
+ type: string
+ FeatureFieldsQueryParam:
+ name: fields
+ in: query
+ description: |-
+ 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)
+
+ For example:
+ * `?fields=properties/color` would select only `color` property value (if present)
+ * `?fields=properties/color,properties/brightness` would select only `color` and `brightness` property 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
+
+ For example:
+ * `?fields=properties(color,brightness)` would select only `color` and `brightness` property values (if present)
+ * `?fields=properties(location/longitude)` would select the `longitude` value inside the `location` object
+
+ #### Examples
+
+ * `?fields=properties(color,brightness)`
+ required: false
+ schema:
+ type: string
+ FeatureIdPathPathParam:
+ name: featureId
+ in: path
+ description: The ID of the feature - has to conform to RFC-3986 (URI)
+ required: true
+ schema:
+ type: string
+ FeaturesFieldsQueryParam:
+ name: fields
+ in: query
+ description: |-
+ 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
+ * `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)
+ 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}`
+ 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}`
+
+
+ #### Examples
+ * `?fields=EnvironmentScanner/properties(temperature,humidity)`
+ * `?fields=EnvironmentScanner/properties(temperature,humidity),Vehicle/properties/configuration`
+ 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
+ schema:
+ type: string
+ 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
+ IfNoneMatchHeaderParam:
+ 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 modify a resource only if it does not yet exist, thus to create it, by specifying `If-None-Match: *`.'
+ required: false
+ schema:
+ type: string
+ LabelPathParam:
+ name: label
+ in: path
+ description: The label of a policy entry
+ required: true
+ schema:
+ type: string
+ LiveMessageRequestedAcksParam:
+ name: requested-acks
+ in: query
+ description: |-
+ Contains the "requested acknowledgements" for this 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=live-response` which will block the
+ HTTP call until a subscriber of the live message sends a response.
+ required: false
+ schema:
+ type: string
+ MessageClaimTimeoutParam:
+ name: timeout
+ in: query
+ description: |-
+ Contains an optional timeout (in seconds) of how long to wait for the Claim response and therefore block the
+ HTTP request. Default value (if omitted): 60 seconds. Maximum value: 600 seconds. A value of 0 seconds applies
+ fire and forget semantics for the message.
+ required: false
+ schema:
+ type: integer
+ MessageSubjectPathParam:
+ name: messageSubject
+ in: path
+ description: The subject of the Message - has to conform to RFC-3986 (URI)
+ required: true
+ schema:
+ type: string
+ MessageTimeoutParam:
+ name: timeout
+ in: query
+ description: |-
+ Contains an optional timeout (in seconds) of how long to wait for the message response and therefore block the
+ HTTP request. Default value (if omitted): 10 seconds. Maximum value: 60 seconds. A value of 0 seconds applies
+ fire and forget semantics for the message.
+ required: false
+ schema:
+ type: integer
+ NamespacesFilter:
+ 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.
+
+
+ #### Examples:
+
+ * `?namespaces=com.example.namespace`
+
+ * `?namespaces=com.example.namespace1,com.example.namespace2`
+ required: false
+ schema:
+ type: string
+ PolicyIdPathParam:
+ name: policyId
+ in: path
+ description: |-
+ 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
+ PropertiesFieldsQueryParam:
+ name: fields
+ in: query
+ description: |-
+ 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)
+
+ For example:
+ * `?fields=temperature` would select only `temperature` property value (if present)
+ * `?fields=temperature,humidity` would select only `temperature` and `humidity` property 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
+
+ For example:
+ * `?fields=location(longitude,latitude)` would select the `longitude` and `latitude` value inside the `location` property
+
+ #### Examples
+
+ * `?fields=temperature,humidity,location(longitude,latitude)`
+
+ * `?fields=configuration,status(powerConsumption/watts)`
+ required: false
+ schema:
+ type: string
+ PropertyPathPathParam:
+ name: propertyPath
+ in: path
+ description: The path to the property
+ required: true
+ schema:
+ type: string
+ PutMetadataParam:
+ name: put-metadata
+ in: header
+ description: 'The `put-metadata` header, which sets Metadata information in the Thing.'
+ required: false
+ schema:
+ type: array
+ description: An array of objects containing metadata to apply.
+ items:
+ type: object
+ description: Object containing a `key` where to apply the metadata and a `value` with the metadata value to apply.
+ additionalProperties:
+ properties:
+ key:
+ type: string
+ description: The JsonPointer to set the metadata `value` to. May start with `*/<key>` in order to apply the metadata to all affected JSON leaves.
+ value:
+ description: The arbitrary JSON value to set as metadata.
+ 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
+ ResourcePathPathParam:
+ name: resourcePath
+ in: path
+ description: The path of an (Authorization) Resource
+ required: true
+ 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
+ SearchFilter:
+ name: filter
+ in: query
+ description: |-
+
+ #### Filter predicates:
+
+ * ```eq({property},{value})``` (i.e. equal to the given value)
+
+ * ```ne({property},{value})``` (i.e. not equal to the given value)
+
+ * ```gt({property},{value})``` (i.e. greater than the given value)
+
+ * ```ge({property},{value})``` (i.e. equal to the given value or greater than it)
+
+ * ```lt({property},{value})``` (i.e. lower than the given value or equal to it)
+
+ * ```le({property},{value})``` (i.e. lower than the given value)
+
+ * ```in({property},{value},{value},...)``` (i.e. contains at least one of the values listed)
+
+ * ```like({property},{value})``` (i.e. contains values similar to the expressions listed)
+
+ * ```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.
+ For example, the filter `ne(attributes/owner, "SID123")` will only return things that do have
+ the `owner` attribute.
+
+
+ #### Logical operations:
+
+
+ * ```and({query},{query},...)```
+
+ * ```or({query},{query},...)```
+
+ * ```not({query})```
+
+
+ #### Examples:
+
+ * ```eq(attributes/location,"kitchen")```
+
+ * ```ge(thingId,"myThing1")```
+
+ * ```gt(_created,"2020-08-05T12:17")```
+
+ * ```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
+ SubjectIdPathParam:
+ name: subjectId
+ in: path
+ description: The ID of an (Authorization) Subject
+ required: true
+ schema:
+ type: string
+ ThingFieldsQueryParam:
+ 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.
+
+ #### Selectable fields
+
+ * `thingId`
+ * `policyId`
+ * `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)
+
+ For example:
+ * `?fields=attributes/model` would select only `model` attribute value (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
+
+ For example:
+ * `?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)
+
+ * `_namespace`
+
+ Specifically selects the namespace also contained in the `thingId`
+
+ * `_revision`
+
+ Specifically selects the revision of the thing. The revision is a counter, which is incremented on each modification of a thing.
+
+ * `_created`
+
+ Specifically selects the created timestamp of the thing in ISO-8601 UTC format. The timestamp is set on creation 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.
+
+ * `_metadata`
+
+ Specifically selects the Metadata of the thing. The content is a JSON object having the Thing's JSON structure with the difference that the JSON leaves of the Thing are JSON objects containing the metadata.
+
+ * `_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`
+ required: false
+ schema:
+ type: string
+ ThingIdPathParam:
+ name: thingId
+ in: path
+ description: '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
+ 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
+ schemas:
+ Error:
+ properties:
+ status:
+ type: integer
+ description: The HTTP status of the error
+ message:
+ type: string
+ description: The message of the error - what went wrong
+ description:
+ type: string
+ description: A description how to fix the error or more details
+ href:
+ type: string
+ description: A link to further information about the error and how to fix it
+ required:
+ - status
+ - message
+ AdvancedError:
+ properties:
+ status:
+ type: integer
+ description: The HTTP status of the error
+ error:
+ type: string
+ description: The error code of the occurred exception
+ message:
+ type: string
+ description: The message of the error - what went wrong
+ description:
+ type: string
+ description: A description how to fix the error or more details
+ href:
+ type: string
+ description: A link to further information about the error and how to fix it
+ required:
+ - status
+ - error
+ - message
+ Attributes:
+ type: 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'''
+ pattern: '([_a-zA-Z0-9\-.]+):([_a-zA-Z0-9\-.]+):([_a-zA-Z0-9\-.]+)'
+ FeatureProperties:
+ type: object
+ description: An arbitrary JSON object describing the properties of a feature.
+ FeatureDesiredProperties:
+ type: object
+ description: An arbitrary JSON object describing the desired properties of a feature.
+ Feature:
+ type: object
+ properties:
+ definition:
+ $ref: '#/components/schemas/FeatureDefinition'
+ properties:
+ $ref: '#/components/schemas/FeatureProperties'
+ desiredProperties:
+ $ref: '#/components/schemas/FeatureDesiredProperties'
+ SearchResultThings:
+ properties:
+ items:
+ type: array
+ items:
+ $ref: '#/components/schemas/Thing'
+ cursor:
+ type: string
+ SearchResultThingsCount:
+ type: integer
+ NewThing:
+ type: object
+ properties:
+ _policy:
+ 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. The
+ caller needs to have READ and WRITE<sup>*</sup> access to the policy.
+ * 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. The caller needs to have READ access to the thing and READ and WRITE<sup>*</sup>
+ access to the policy of the thing.
+
+
+ <sup>*</sup> The check for WRITE permission avoids locking yourself out of the newly created policy. You can
+ bypass this check by setting the header `allowPolicyLockout` to `true`. Be aware that the authorized
+ subject cannot modify the policy if you do not assign WRITE permission on the policy resource!
+
+ 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
+ resource `/policies/{policyId}`.
+ definition:
+ $ref: '#/components/schemas/Definition'
+ attributes:
+ $ref: '#/components/schemas/Attributes'
+ features:
+ $ref: '#/components/schemas/Features'
+ required:
+ - policyId
+ Thing:
+ type: object
+ properties:
+ thingId:
+ type: string
+ description: Unique identifier representing the thing
+ policyId:
+ type: string
+ 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:
+ $ref: '#/components/schemas/Attributes'
+ features:
+ $ref: '#/components/schemas/Features'
+ _revision:
+ type: string
+ description: |-
+ _(read-only)_ The revision is a counter which is incremented on each modification of a Thing. This field
+ is not returned by default but must be selected explicitly.
+ _created:
+ type: string
+ description: |-
+ _(read-only)_ The created timestamp of the Thing in ISO-8601 UTC format. The timestamp is set on creation
+ of a Thing. This field is not returned by default but must be selected explicitly.
+ _modified:
+ type: string
+ description: |-
+ _(read-only)_ The modified timestamp of the Thing in ISO-8601 UTC format. The timestamp is set on each
+ modification of a Thing. This field is not returned by default but must be selected explicitly.
+ _metadata:
+ type: object
+ description: _(read-only)_ The Metadata of the Thing. This field is not returned by default but must be selected explicitly.
+ required:
+ - thingId
+ - policyId
+ NewPolicy:
+ type: object
+ description: Policy consisting of policy entries
+ properties:
+ entries:
+ $ref: '#/components/schemas/PolicyEntries'
+ required:
+ - entries
+ Policy:
+ type: object
+ description: Policy consisting of policy entries
+ properties:
+ policyId:
+ type: string
+ description: Unique identifier representing the policy
+ entries:
+ $ref: '#/components/schemas/PolicyEntries'
+ required:
+ - policyId
+ - entries
+ PolicyEntries:
+ type: object
+ description: Policy entries containing one policy entry for each arbitrary `label` key
+ properties:
+ label1:
+ $ref: '#/components/schemas/PolicyEntry'
+ labelN:
+ $ref: '#/components/schemas/PolicyEntry'
+ PolicyEntry:
+ type: object
+ description: Single policy entry containing Subjects and Resources.
+ properties:
+ subjects:
+ $ref: '#/components/schemas/Subjects'
+ resources:
+ $ref: '#/components/schemas/Resources'
+ required:
+ - subjects
+ - resources
+ Subjects:
+ type: object
+ description: A SubjectEntry defines who is addressed.
+ properties:
+ 'nginx:subjectId1':
+ $ref: '#/components/schemas/SubjectEntry'
+ 'nginx:subjectIdN':
+ $ref: '#/components/schemas/SubjectEntry'
+ SubjectEntry:
+ type: object
+ description: Single (Authorization) Subject entry holding its type.
+ required:
+ - type
+ properties:
+ type:
+ type: string
+ 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.'
+ expiry:
+ type: string
+ description: The optional expiry timestamp (formatted in ISO-8601) indicates how long this subject should be considered active before it is automatically deleted from the Policy.
+ format: date-time
+ announcement:
+ $ref: '#/components/schemas/SubjectAnnouncement'
+ example:
+ type: 'This is some description for this subject, adjust as needed.'
+ expiry: '2020-12-07T11:36:40Z'
+ announcement:
+ beforeExpiry: 5m
+ whenDeleted: true
+ Resources:
+ type: object
+ description: |-
+ (Authorization) Resources containing one ResourceEntry for each
+ `type:path` key, `type` being one of the following `thing`, `policy`, `message`.
+ additionalProperties:
+ $ref: '#/components/schemas/ResourceEntry'
+ example:
+ 'thing:/':
+ grant:
+ - READ
+ - WRITE
+ revoke: null
+ 'thing:/attributes/some/path':
+ grant: null
+ revoke:
+ - READ
+ 'policy:/':
+ grant:
+ - READ
+ - WRITE
+ revoke: null
+ 'message:/':
+ grant:
+ - READ
+ - WRITE
+ revoke: null
+ ResourceEntry:
+ type: object
+ description: |-
+ Single (Authorization) Resource entry defining permissions per effect.
+ Allowed effects are `grant` and `revoke`.
+ properties:
+ grant:
+ type: array
+ items:
+ $ref: '#/components/schemas/Permission'
+ revoke:
+ type: array
+ items:
+ $ref: '#/components/schemas/Permission'
+ Permission:
+ type: string
+ description: A Permission allows a certain action on an entity
+ enum:
+ - READ
+ - WRITE
+ SubjectAnnouncement:
+ type: object
+ description: Settings for announcements to be made about the subject.
+ properties:
+ beforeExpiry:
+ type: string
+ description: |-
+ The duration before expiry when an announcement should be made.
+ Must be a positive integer followed by one of `h` (hour), `m` (minute) or `s` (second).
+ whenDeleted:
+ type: boolean
+ description: Whether an announcement should be made when this subject is deleted.
+ example:
+ beforeExpiry: 5m
+ whenDeleted: true
+ Features:
+ type: object
+ description: |-
+ 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'
+ WhoAmI:
+ type: object
+ description: Contains information about the current user and the auth subjects available for the used authentication.
+ properties:
+ defaultSubject:
+ $ref: '#/components/schemas/WhoAmISubject'
+ subjects:
+ type: array
+ items:
+ $ref: '#/components/schemas/WhoAmISubject'
+ WhoAmISubject:
+ type: string
+ description: An auth subject that can be used to provide access for a caller (e.g. in subject entries of policies).
+ securitySchemes:
+ NginxBasic:
+ type: http
+ description: Eclipse Ditto sandbox demo user (demo1 ... demo9) + password (demo)
+ scheme: basic
+ Bearer:
+ type: http
+ scheme: bearer
+ bearerFormat: JWT
+ description: A JSON Web Token issued by a supported OAuth 2.0 Identity Provider.
+ Google:
+ type: oauth2
+ description: Allow Eclipse Ditto to perform OAuth2.0 based authentication accessing your Google-ID.
+ x-tokenName: id_token
+ flows:
+ authorizationCode:
+ authorizationUrl: 'https://accounts.google.com/o/oauth2/v2/auth'
+ tokenUrl: /oauth2/google/token
+ scopes:
+ openid: Access your Google-ID
diff --git a/2.0/openapi/sources/api-2-index.yml b/2.0/openapi/sources/api-2-index.yml
new file mode 100644
index 0000000..be7cc86
--- /dev/null
+++ b/2.0/openapi/sources/api-2-index.yml
@@ -0,0 +1,289 @@
+# Copyright (c) 2017 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+openapi: 3.0.0
+info:
+ title: Eclipse Ditto™ HTTP API
+ version: "2"
+ description: |-
+ JSON-based, REST-like API for Eclipse Ditto
+
+ The Eclipse Ditto HTTP API uses response status codes (see [RFC 7231](https://tools.ietf.org/html/rfc7231#section-6))
+ to indicate whether a specific request has been successfully completed, or not.
+
+ The information Ditto provides additionally to the status code (e.g. in API docs, or error codes like. "things:thing.tooLarge") might change without advance notice. These are not be considered as official API, and must therefore not be applied in your applications or tests.
+
+servers:
+ - url: https://ditto.eclipseprojects.io/api/2
+ description: "online Ditto Sandbox"
+ - url: /api/2
+ description: "local Ditto"
+
+tags:
+ - name: Things
+ description: Manage every thing
+ - name: Features
+ description: Structure the features of your things
+ - name: Policies
+ description: Control access to your things
+ - name: Things-Search
+ description: Find every thing
+ - name: Messages
+ description: Talk with your things
+ - name: CloudEvents
+ description: Process CloudEvents in Ditto
+
+security:
+ - Google:
+ - openid
+ - NginxBasic: [ ]
+ - Bearer: [ ]
+
+paths:
+
+ ###
+ ### Things
+ ###
+ /things:
+ $ref: "./paths/things/index.yml"
+ '/things/{thingId}':
+ $ref: "./paths/things/thing.yml"
+ '/things/{thingId}/definition':
+ $ref: "./paths/things/definition.yml"
+ '/things/{thingId}/policyId':
+ $ref: "./paths/things/policyId.yml"
+ '/things/{thingId}/attributes':
+ $ref: "./paths/things/attributes.yml"
+ '/things/{thingId}/attributes/{attributePath}':
+ $ref: "./paths/things/attribute.yml"
+
+ ###
+ ### Features
+ ###
+ '/things/{thingId}/features':
+ $ref: "./paths/features/index.yml"
+ '/things/{thingId}/features/{featureId}':
+ $ref: "./paths/features/feature.yml"
+ '/things/{thingId}/features/{featureId}/definition':
+ $ref: "./paths/features/definition.yml"
+ '/things/{thingId}/features/{featureId}/properties':
+ $ref: "./paths/features/properties.yml"
+ '/things/{thingId}/features/{featureId}/properties/{propertyPath}':
+ $ref: "./paths/features/property.yml"
+ '/things/{thingId}/features/{featureId}/desiredProperties':
+ $ref: "./paths/features/desiredProperties.yml"
+ '/things/{thingId}/features/{featureId}/desiredProperties/{propertyPath}':
+ $ref: "./paths/features/desiredProperty.yml"
+
+ ###
+ ### Messages
+ ###
+ '/things/{thingId}/inbox/claim':
+ $ref: "./paths/messages/inbox-claim.yml"
+ '/things/{thingId}/inbox/messages/{messageSubject}':
+ $ref: "./paths/messages/inbox-message.yml"
+ '/things/{thingId}/outbox/messages/{messageSubject}':
+ $ref: "./paths/messages/outbox-message.yml"
+ '/things/{thingId}/features/{featureId}/inbox/messages/{messageSubject}':
+ $ref: "./paths/messages/feature-inbox-message.yml"
+ '/things/{thingId}/features/{featureId}/outbox/messages/{messageSubject}':
+ $ref: "./paths/messages/feature-outbox-message.yml"
+
+ ###
+ ### Policies
+ ###
+ '/policies/{policyId}':
+ $ref: "./paths/policies/policy.yml"
+ '/policies/{policyId}/actions/activateTokenIntegration':
+ $ref: "./paths/policies/activateTokenIntegration.yml"
+ '/policies/{policyId}/actions/deactivateTokenIntegration':
+ $ref: "./paths/policies/deactivateTokenIntegration.yml"
+ '/policies/{policyId}/entries':
+ $ref: "./paths/policies/entries.yml"
+ '/policies/{policyId}/entries/{label}':
+ $ref: "./paths/policies/entry.yml"
+ '/policies/{policyId}/entries/{label}/actions/activateTokenIntegration':
+ $ref: "./paths/policies/activateTokenIntegrationForEntry.yml"
+ '/policies/{policyId}/entries/{label}/actions/deactivateTokenIntegration':
+ $ref: "./paths/policies/deactivateTokenIntegrationForEntry.yml"
+ '/policies/{policyId}/entries/{label}/subjects':
+ $ref: "./paths/policies/subjects.yml"
+ '/policies/{policyId}/entries/{label}/subjects/{subjectId}':
+ $ref: "./paths/policies/subject.yml"
+ '/policies/{policyId}/entries/{label}/resources':
+ $ref: "./paths/policies/resources.yml"
+ '/policies/{policyId}/entries/{label}/resources/{resourcePath}':
+ $ref: "./paths/policies/resource.yml"
+
+ ###
+ ### Who Am I
+ ###
+ '/whoami':
+ $ref: "./paths/whoami/index.yml"
+
+ ###
+ ### Things-Search
+ ###
+ /search/things:
+ $ref: "./paths/search/things.yml"
+ /search/things/count:
+ $ref: "./paths/search/things-count.yml"
+
+ ###
+ ### CloudEvents
+ ###
+ '/cloudevents':
+ $ref: "./paths/cloudevents/cloudevents.yml"
+
+components:
+
+ requestBodies:
+ Attributes:
+ $ref: "./requests/attributes.yml"
+ Definition:
+ $ref: "./requests/definition.yml"
+ Payload:
+ $ref: "./requests/payload.yml"
+ Value:
+ $ref: "./requests/value.yml"
+ PatchValue:
+ $ref: "./requests/patchValue.yml"
+ ActivateTokenIntegration:
+ $ref: "./requests/policies/actions/activateTokenIntegration.yml"
+
+ responses:
+ EntityTooLarge:
+ $ref: "./responses/entityTooLarge.yml"
+ MessageTimeout:
+ $ref: "./responses/messageTimeout.yml"
+ MessageTooLarge:
+ $ref: "./responses/messageTooLarge.yml"
+ NotModified:
+ $ref: "./responses/notModified.yml"
+ PreconditionFailed:
+ $ref: "./responses/preconditionFailed.yml"
+
+ parameters:
+ AllowPolicyLockoutParam:
+ $ref: "./parameters/allowPolicyLockoutParam.yml"
+ AttributesPathPathParam:
+ $ref: "./parameters/attributePathPathParam.yml"
+ AttributesFieldsQueryParam:
+ $ref: "./parameters/attributesFieldsQueryParam.yml"
+ DesiredPropertiesFieldsQueryParam:
+ $ref: "./parameters/desiredPropertiesFieldsQueryParam.yml"
+ FeatureFieldsQueryParam:
+ $ref: "./parameters/featureFieldsQueryParam.yml"
+ FeatureIdPathPathParam:
+ $ref: "./parameters/featureIdPathPathParam.yml"
+ FeaturesFieldsQueryParam:
+ $ref: "./parameters/featuresFieldsQueryParam.yml"
+ IfMatchHeaderParam:
+ $ref: "./parameters/ifMatchHeaderParam.yml"
+ IfMatchHeaderParamHash:
+ $ref: "./parameters/ifMatchHeaderParamHash.yml"
+ IfNoneMatchHeaderParam:
+ $ref: "./parameters/ifNoneMatchHeaderParam.yml"
+ LabelPathParam:
+ $ref: "./parameters/labelPathParam.yml"
+ LiveMessageRequestedAcksParam:
+ $ref: "./parameters/liveMessageRequestedAcksParam.yml"
+ MessageClaimTimeoutParam:
+ $ref: "./parameters/messageClaimTimeoutParam.yml"
+ MessageSubjectPathParam:
+ $ref: "./parameters/messageSubjectPathParam.yml"
+ MessageTimeoutParam:
+ $ref: "./parameters/messageTimeoutParam.yml"
+ NamespacesFilter:
+ $ref: "./parameters/namespacesFilter.yml"
+ PolicyIdPathParam:
+ $ref: "./parameters/policyIdPathParam.yml"
+ PropertiesFieldsQueryParam:
+ $ref: "./parameters/propertiesFieldsQueryParam.yml"
+ PropertyPathPathParam:
+ $ref: "./parameters/propertyPathPathParam.yml"
+ PutMetadataParam:
+ $ref: "./parameters/putMetadataParam.yml"
+ RequestedAcksParam:
+ $ref: "./parameters/requestedAcksParam.yml"
+ ResourcePathPathParam:
+ $ref: "./parameters/resourcePathPathParam.yml"
+ ResponseRequiredParam:
+ $ref: "./parameters/responseRequiredParam.yml"
+ SearchFilter:
+ $ref: "./parameters/searchFilter.yml"
+ SubjectIdPathParam:
+ $ref: "./parameters/subjectIdPathParam.yml"
+ ThingFieldsQueryParam:
+ $ref: "./parameters/thingFieldsQueryParam.yml"
+ ThingIdPathParam:
+ $ref: "./parameters/thingIdPathParam.yml"
+ TimeoutParam:
+ $ref: "./parameters/timeoutParam.yml"
+
+ schemas:
+ Error:
+ $ref: "./schemas/errors/error.yml"
+ AdvancedError:
+ $ref: "./schemas/errors/advancedError.yml"
+ Attributes:
+ $ref: "./schemas/things/attributes.yml"
+ Definition:
+ $ref: "./schemas/things/definition.yml"
+ FeatureDefinition:
+ $ref: "./schemas/features/featureDefinition.yml"
+ FeatureProperties:
+ $ref: "./schemas/features/featureProperties.yml"
+ FeatureDesiredProperties:
+ $ref: "./schemas/features/featureDesiredProperties.yml"
+ Feature:
+ $ref: "./schemas/features/feature.yml"
+ SearchResultThings:
+ $ref: "./schemas/search/searchResultThings.yml"
+ SearchResultThingsCount:
+ type: integer
+ NewThing:
+ $ref: "./schemas/things/newThing.yml"
+ Thing:
+ $ref: "./schemas/things/thing.yml"
+ NewPolicy:
+ $ref: "./schemas/policies/newPolicy.yml"
+ Policy:
+ $ref: "./schemas/policies/policy.yml"
+ PolicyEntries:
+ $ref: "./schemas/policies/policyEntries.yml"
+ PolicyEntry:
+ $ref: "./schemas/policies/policyEntry.yml"
+ Subjects:
+ $ref: "./schemas/policies/subjects.yml"
+ SubjectEntry:
+ $ref: "./schemas/policies/subjectEntry.yml"
+ Resources:
+ $ref: "./schemas/policies/resources.yml"
+ ResourceEntry:
+ $ref: "./schemas/policies/resourceEntry.yml"
+ Permission:
+ $ref: "./schemas/policies/permission.yml"
+ SubjectAnnouncement:
+ $ref: "./schemas/policies/subjectAnnouncement.yml"
+ Features:
+ $ref: "./schemas/features/features.yml"
+ WhoAmI:
+ $ref: "./schemas/whoami/whoami.yml"
+ WhoAmISubject:
+ $ref: "./schemas/whoami/whoamiSubject.yml"
+
+ securitySchemes:
+ NginxBasic:
+ $ref: './security/nginxBasic.yml'
+ Bearer:
+ $ref: './security/bearerAuth.yml'
+ Google:
+ $ref: './security/google.yml'
diff --git a/2.0/openapi/sources/package-lock.json b/2.0/openapi/sources/package-lock.json
new file mode 100644
index 0000000..5491b28
--- /dev/null
+++ b/2.0/openapi/sources/package-lock.json
@@ -0,0 +1,335 @@
+{
+ "requires": true,
+ "lockfileVersion": 1,
+ "dependencies": {
+ "@apidevtools/json-schema-ref-parser": {
+ "version": "9.0.6",
+ "resolved": "https://registry.npmjs.org/@apidevtools/json-schema-ref-parser/-/json-schema-ref-parser-9.0.6.tgz",
+ "integrity": "sha512-M3YgsLjI0lZxvrpeGVk9Ap032W6TPQkH6pRAZz81Ac3WUNF79VQooAFnp8umjvVzUmD93NkogxEwbSce7qMsUg==",
+ "requires": {
+ "@jsdevtools/ono": "^7.1.3",
+ "call-me-maybe": "^1.0.1",
+ "js-yaml": "^3.13.1"
+ }
+ },
+ "@apidevtools/openapi-schemas": {
+ "version": "2.0.4",
+ "resolved": "https://registry.npmjs.org/@apidevtools/openapi-schemas/-/openapi-schemas-2.0.4.tgz",
+ "integrity": "sha512-ob5c4UiaMYkb24pNhvfSABShAwpREvUGCkqjiz/BX9gKZ32y/S22M+ALIHftTAuv9KsFVSpVdIDzi9ZzFh5TCA=="
+ },
+ "@apidevtools/swagger-methods": {
+ "version": "3.0.2",
+ "resolved": "https://registry.npmjs.org/@apidevtools/swagger-methods/-/swagger-methods-3.0.2.tgz",
+ "integrity": "sha512-QAkD5kK2b1WfjDS/UQn/qQkbwF31uqRjPTrsCs5ZG9BQGAkjwvqGFjjPqAuzac/IYzpPtRzjCP1WrTuAIjMrXg=="
+ },
+ "@apidevtools/swagger-parser": {
+ "version": "10.0.2",
+ "resolved": "https://registry.npmjs.org/@apidevtools/swagger-parser/-/swagger-parser-10.0.2.tgz",
+ "integrity": "sha512-JFxcEyp8RlNHgBCE98nwuTkZT6eNFPc1aosWV6wPcQph72TSEEu1k3baJD4/x1qznU+JiDdz8F5pTwabZh+Dhg==",
+ "requires": {
+ "@apidevtools/json-schema-ref-parser": "^9.0.6",
+ "@apidevtools/openapi-schemas": "^2.0.4",
+ "@apidevtools/swagger-methods": "^3.0.2",
+ "@jsdevtools/ono": "^7.1.3",
+ "call-me-maybe": "^1.0.1",
+ "z-schema": "^4.2.3"
+ }
+ },
+ "@jsdevtools/ono": {
+ "version": "7.1.3",
+ "resolved": "https://registry.npmjs.org/@jsdevtools/ono/-/ono-7.1.3.tgz",
+ "integrity": "sha512-4JQNk+3mVzK3xh2rqd6RB4J46qUR19azEHBneZyTZM+c456qOrbbM/5xcR8huNCCcbVt7+UmizG6GuUvPvKUYg=="
+ },
+ "ansi-regex": {
+ "version": "5.0.0",
+ "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.0.tgz",
+ "integrity": "sha512-bY6fj56OUQ0hU1KjFNDQuJFezqKdrAyFdIevADiqrWHwSlbmBNMHp5ak2f40Pm8JTFyM2mqxkG6ngkHO11f/lg=="
+ },
+ "ansi-styles": {
+ "version": "4.3.0",
+ "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz",
+ "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==",
+ "requires": {
+ "color-convert": "^2.0.1"
+ }
+ },
+ "argparse": {
+ "version": "1.0.10",
+ "resolved": "https://registry.npmjs.org/argparse/-/argparse-1.0.10.tgz",
+ "integrity": "sha512-o5Roy6tNG4SL/FOkCAN6RzjiakZS25RLYFrcMttJqbdd8BWrnA+fGz57iN5Pb06pvBGvl5gQ0B48dJlslXvoTg==",
+ "requires": {
+ "sprintf-js": "~1.0.2"
+ }
+ },
+ "call-me-maybe": {
+ "version": "1.0.1",
+ "resolved": "https://registry.npmjs.org/call-me-maybe/-/call-me-maybe-1.0.1.tgz",
+ "integrity": "sha1-JtII6onje1y95gJQoV8DHBak1ms="
+ },
+ "camelcase": {
+ "version": "5.3.1",
+ "resolved": "https://registry.npmjs.org/camelcase/-/camelcase-5.3.1.tgz",
+ "integrity": "sha512-L28STB170nwWS63UjtlEOE3dldQApaJXZkOI1uMFfzf3rRuPegHaHesyee+YxQ+W6SvRDQV6UrdOdRiR153wJg=="
+ },
+ "chalk": {
+ "version": "4.1.0",
+ "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.0.tgz",
+ "integrity": "sha512-qwx12AxXe2Q5xQ43Ac//I6v5aXTipYrSESdOgzrN+9XjgEpyjpKuvSGaN4qE93f7TQTlerQQ8S+EQ0EyDoVL1A==",
+ "requires": {
+ "ansi-styles": "^4.1.0",
+ "supports-color": "^7.1.0"
+ }
+ },
+ "cliui": {
+ "version": "6.0.0",
+ "resolved": "https://registry.npmjs.org/cliui/-/cliui-6.0.0.tgz",
+ "integrity": "sha512-t6wbgtoCXvAzst7QgXxJYqPt0usEfbgQdftEPbLL/cvv6HPE5VgvqCuAIDR0NgU52ds6rFwqrgakNLrHEjCbrQ==",
+ "requires": {
+ "string-width": "^4.2.0",
+ "strip-ansi": "^6.0.0",
+ "wrap-ansi": "^6.2.0"
+ }
+ },
+ "color-convert": {
+ "version": "2.0.1",
+ "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz",
+ "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==",
+ "requires": {
+ "color-name": "~1.1.4"
+ }
+ },
+ "color-name": {
+ "version": "1.1.4",
+ "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz",
+ "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA=="
+ },
+ "commander": {
+ "version": "2.20.3",
+ "resolved": "https://registry.npmjs.org/commander/-/commander-2.20.3.tgz",
+ "integrity": "sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ==",
+ "optional": true
+ },
+ "decamelize": {
+ "version": "1.2.0",
+ "resolved": "https://registry.npmjs.org/decamelize/-/decamelize-1.2.0.tgz",
+ "integrity": "sha1-9lNNFRSCabIDUue+4m9QH5oZEpA="
+ },
+ "emoji-regex": {
+ "version": "8.0.0",
+ "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz",
+ "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A=="
+ },
+ "esprima": {
+ "version": "4.0.1",
+ "resolved": "https://registry.npmjs.org/esprima/-/esprima-4.0.1.tgz",
+ "integrity": "sha512-eGuFFw7Upda+g4p+QHvnW0RyTX/SVeJBDM/gCtMARO0cLuT2HcEKnTPvhjV6aGeqrCB/sbNop0Kszm0jsaWU4A=="
+ },
+ "find-up": {
+ "version": "4.1.0",
+ "resolved": "https://registry.npmjs.org/find-up/-/find-up-4.1.0.tgz",
+ "integrity": "sha512-PpOwAdQ/YlXQ2vj8a3h8IipDuYRi3wceVQQGYWxNINccq40Anw7BlsEXCMbt1Zt+OLA6Fq9suIpIWD0OsnISlw==",
+ "requires": {
+ "locate-path": "^5.0.0",
+ "path-exists": "^4.0.0"
+ }
+ },
+ "get-caller-file": {
+ "version": "2.0.5",
+ "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz",
+ "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg=="
+ },
+ "has-flag": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz",
+ "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ=="
+ },
+ "is-fullwidth-code-point": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz",
+ "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg=="
+ },
+ "js-yaml": {
+ "version": "3.14.0",
+ "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-3.14.0.tgz",
+ "integrity": "sha512-/4IbIeHcD9VMHFqDR/gQ7EdZdLimOvW2DdcxFjdyyZ9NsbS+ccrXqVWDtab/lRl5AlUqmpBx8EhPaWR+OtY17A==",
+ "requires": {
+ "argparse": "^1.0.7",
+ "esprima": "^4.0.0"
+ }
+ },
+ "locate-path": {
+ "version": "5.0.0",
+ "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-5.0.0.tgz",
+ "integrity": "sha512-t7hw9pI+WvuwNJXwk5zVHpyhIqzg2qTlklJOf0mVxGSbe3Fp2VieZcduNYjaLDoy6p9uGpQEGWG87WpMKlNq8g==",
+ "requires": {
+ "p-locate": "^4.1.0"
+ }
+ },
+ "lodash.get": {
+ "version": "4.4.2",
+ "resolved": "https://registry.npmjs.org/lodash.get/-/lodash.get-4.4.2.tgz",
+ "integrity": "sha1-LRd/ZS+jHpObRDjVNBSZ36OCXpk="
+ },
+ "lodash.isequal": {
+ "version": "4.5.0",
+ "resolved": "https://registry.npmjs.org/lodash.isequal/-/lodash.isequal-4.5.0.tgz",
+ "integrity": "sha1-QVxEePK8wwEgwizhDtMib30+GOA="
+ },
+ "p-limit": {
+ "version": "2.3.0",
+ "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-2.3.0.tgz",
+ "integrity": "sha512-//88mFWSJx8lxCzwdAABTJL2MyWB12+eIY7MDL2SqLmAkeKU9qxRvWuSyTjm3FUmpBEMuFfckAIqEaVGUDxb6w==",
+ "requires": {
+ "p-try": "^2.0.0"
+ }
+ },
+ "p-locate": {
+ "version": "4.1.0",
+ "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-4.1.0.tgz",
+ "integrity": "sha512-R79ZZ/0wAxKGu3oYMlz8jy/kbhsNrS7SKZ7PxEHBgJ5+F2mtFW2fK2cOtBh1cHYkQsbzFV7I+EoRKe6Yt0oK7A==",
+ "requires": {
+ "p-limit": "^2.2.0"
+ }
+ },
+ "p-try": {
+ "version": "2.2.0",
+ "resolved": "https://registry.npmjs.org/p-try/-/p-try-2.2.0.tgz",
+ "integrity": "sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ=="
+ },
+ "path-exists": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz",
+ "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w=="
+ },
+ "require-directory": {
+ "version": "2.1.1",
+ "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz",
+ "integrity": "sha1-jGStX9MNqxyXbiNE/+f3kqam30I="
+ },
+ "require-main-filename": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/require-main-filename/-/require-main-filename-2.0.0.tgz",
+ "integrity": "sha512-NKN5kMDylKuldxYLSUfrbo5Tuzh4hd+2E8NPPX02mZtn1VuREQToYe/ZdlJy+J3uCpfaiGF05e7B8W0iXbQHmg=="
+ },
+ "set-blocking": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/set-blocking/-/set-blocking-2.0.0.tgz",
+ "integrity": "sha1-BF+XgtARrppoA93TgrJDkrPYkPc="
+ },
+ "sprintf-js": {
+ "version": "1.0.3",
+ "resolved": "https://registry.npmjs.org/sprintf-js/-/sprintf-js-1.0.3.tgz",
+ "integrity": "sha1-BOaSb2YolTVPPdAVIDYzuFcpfiw="
+ },
+ "string-width": {
+ "version": "4.2.0",
+ "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.0.tgz",
+ "integrity": "sha512-zUz5JD+tgqtuDjMhwIg5uFVV3dtqZ9yQJlZVfq4I01/K5Paj5UHj7VyrQOJvzawSVlKpObApbfD0Ed6yJc+1eg==",
+ "requires": {
+ "emoji-regex": "^8.0.0",
+ "is-fullwidth-code-point": "^3.0.0",
+ "strip-ansi": "^6.0.0"
+ }
+ },
+ "strip-ansi": {
+ "version": "6.0.0",
+ "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.0.tgz",
+ "integrity": "sha512-AuvKTrTfQNYNIctbR1K/YGTR1756GycPsg7b9bdV9Duqur4gv6aKqHXah67Z8ImS7WEz5QVcOtlfW2rZEugt6w==",
+ "requires": {
+ "ansi-regex": "^5.0.0"
+ }
+ },
+ "supports-color": {
+ "version": "7.2.0",
+ "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz",
+ "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==",
+ "requires": {
+ "has-flag": "^4.0.0"
+ }
+ },
+ "swagger-cli": {
+ "version": "4.0.4",
+ "resolved": "https://registry.npmjs.org/swagger-cli/-/swagger-cli-4.0.4.tgz",
+ "integrity": "sha512-Cp8YYuLny3RJFQ4CvOBTaqmOOgYsem52dPx1xM5S4EUWFblIh2Q8atppMZvXKUr1e9xH5RwipYpmdUzdPcxWcA==",
+ "requires": {
+ "@apidevtools/swagger-cli": "4.0.4"
+ },
+ "dependencies": {
+ "@apidevtools/swagger-cli": {
+ "version": "4.0.4",
+ "resolved": "https://registry.npmjs.org/@apidevtools/swagger-cli/-/swagger-cli-4.0.4.tgz",
+ "integrity": "sha512-hdDT3B6GLVovCsRZYDi3+wMcB1HfetTU20l2DC8zD3iFRNMC6QNAZG5fo/6PYeHWBEv7ri4MvnlKodhNB0nt7g==",
+ "requires": {
+ "@apidevtools/swagger-parser": "^10.0.1",
+ "chalk": "^4.1.0",
+ "js-yaml": "^3.14.0",
+ "yargs": "^15.4.1"
+ }
+ }
+ }
+ },
+ "validator": {
+ "version": "12.2.0",
+ "resolved": "https://registry.npmjs.org/validator/-/validator-12.2.0.tgz",
+ "integrity": "sha512-jJfE/DW6tIK1Ek8nCfNFqt8Wb3nzMoAbocBF6/Icgg1ZFSBpObdnwVY2jQj6qUqzhx5jc71fpvBWyLGO7Xl+nQ=="
+ },
+ "which-module": {
+ "version": "2.0.0",
+ "resolved": "https://registry.npmjs.org/which-module/-/which-module-2.0.0.tgz",
+ "integrity": "sha1-2e8H3Od7mQK4o6j6SzHD4/fm6Ho="
+ },
+ "wrap-ansi": {
+ "version": "6.2.0",
+ "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-6.2.0.tgz",
+ "integrity": "sha512-r6lPcBGxZXlIcymEu7InxDMhdW0KDxpLgoFLcguasxCaJ/SOIZwINatK9KY/tf+ZrlywOKU0UDj3ATXUBfxJXA==",
+ "requires": {
+ "ansi-styles": "^4.0.0",
+ "string-width": "^4.1.0",
+ "strip-ansi": "^6.0.0"
+ }
+ },
+ "y18n": {
+ "version": "4.0.0",
+ "resolved": "https://registry.npmjs.org/y18n/-/y18n-4.0.0.tgz",
+ "integrity": "sha512-r9S/ZyXu/Xu9q1tYlpsLIsa3EeLXXk0VwlxqTcFRfg9EhMW+17kbt9G0NrgCmhGb5vT2hyhJZLfDGx+7+5Uj/w=="
+ },
+ "yargs": {
+ "version": "15.4.1",
+ "resolved": "https://registry.npmjs.org/yargs/-/yargs-15.4.1.tgz",
+ "integrity": "sha512-aePbxDmcYW++PaqBsJ+HYUFwCdv4LVvdnhBy78E57PIor8/OVvhMrADFFEDh8DHDFRv/O9i3lPhsENjO7QX0+A==",
+ "requires": {
+ "cliui": "^6.0.0",
+ "decamelize": "^1.2.0",
+ "find-up": "^4.1.0",
+ "get-caller-file": "^2.0.1",
+ "require-directory": "^2.1.1",
+ "require-main-filename": "^2.0.0",
+ "set-blocking": "^2.0.0",
+ "string-width": "^4.2.0",
+ "which-module": "^2.0.0",
+ "y18n": "^4.0.0",
+ "yargs-parser": "^18.1.2"
+ }
+ },
+ "yargs-parser": {
+ "version": "18.1.3",
+ "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-18.1.3.tgz",
+ "integrity": "sha512-o50j0JeToy/4K6OZcaQmW6lyXXKhq7csREXcDwk2omFPJEwUNOVtJKvmDr9EI1fAJZUyZcRF7kxGBWmRXudrCQ==",
+ "requires": {
+ "camelcase": "^5.0.0",
+ "decamelize": "^1.2.0"
+ }
+ },
+ "z-schema": {
+ "version": "4.2.3",
+ "resolved": "https://registry.npmjs.org/z-schema/-/z-schema-4.2.3.tgz",
+ "integrity": "sha512-zkvK/9TC6p38IwcrbnT3ul9in1UX4cm1y/VZSs4GHKIiDCrlafc+YQBgQBUdDXLAoZHf2qvQ7gJJOo6yT1LH6A==",
+ "requires": {
+ "commander": "^2.7.1",
+ "lodash.get": "^4.4.2",
+ "lodash.isequal": "^4.5.0",
+ "validator": "^12.0.0"
+ }
+ }
+ }
+}
diff --git a/2.0/openapi/sources/package.json b/2.0/openapi/sources/package.json
new file mode 100644
index 0000000..83d9df2
--- /dev/null
+++ b/2.0/openapi/sources/package.json
@@ -0,0 +1,9 @@
+{
+ "scripts": {
+ "build": "npm run build-v2",
+ "build-v2": "swagger-cli bundle api-2-index.yml --outfile ../ditto-api-2.yml --type yaml"
+ },
+ "dependencies": {
+ "swagger-cli": "^4.0.4"
+ }
+}
diff --git a/2.0/openapi/sources/parameters/allowPolicyLockoutParam.yml b/2.0/openapi/sources/parameters/allowPolicyLockoutParam.yml
new file mode 100644
index 0000000..b75807f
--- /dev/null
+++ b/2.0/openapi/sources/parameters/allowPolicyLockoutParam.yml
@@ -0,0 +1,21 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+
+name: allow-policy-lockout
+in: query
+description: |-
+ Defines whether a subject is allowed to create a policy without having WRITE permission on the policy
+ resource of the created policy.
+
+ The default (if ommited) is `false`.
+required: false
+schema:
+ type: boolean
\ No newline at end of file
diff --git a/2.0/openapi/sources/parameters/attributePathPathParam.yml b/2.0/openapi/sources/parameters/attributePathPathParam.yml
new file mode 100644
index 0000000..8721943
--- /dev/null
+++ b/2.0/openapi/sources/parameters/attributePathPathParam.yml
@@ -0,0 +1,16 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+name: attributePath
+in: path
+description: The path to the attribute, e.g. **manufacturer/name**
+required: true
+schema:
+ type: string
\ No newline at end of file
diff --git a/2.0/openapi/sources/parameters/attributesFieldsQueryParam.yml b/2.0/openapi/sources/parameters/attributesFieldsQueryParam.yml
new file mode 100644
index 0000000..8a0e5ac
--- /dev/null
+++ b/2.0/openapi/sources/parameters/attributesFieldsQueryParam.yml
@@ -0,0 +1,42 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+name: fields
+in: query
+description: |-
+ 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)
+
+ For example:
+ * `?fields=model` would select only `model` attribute value (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 `( )`:
+ * 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=location(longitude,latitude)` would select the `longitude` and `latitude` value inside the `location` attribute
+
+ #### Examples
+
+ * `?fields=model,make,location(longitude,latitude)`
+
+ * `?fields=listOfAddresses/postal(city,street))`
+required: false
+schema:
+ type: string
\ No newline at end of file
diff --git a/2.0/openapi/sources/parameters/desiredPropertiesFieldsQueryParam.yml b/2.0/openapi/sources/parameters/desiredPropertiesFieldsQueryParam.yml
new file mode 100644
index 0000000..3f1137a
--- /dev/null
+++ b/2.0/openapi/sources/parameters/desiredPropertiesFieldsQueryParam.yml
@@ -0,0 +1,42 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+name: fields
+in: query
+description: |-
+ Contains a comma-separated list of fields from the desiredProperties to be
+ included in the returned JSON.
+
+ #### Selectable fields
+
+ Supports selecting arbitrary sub-fields as defined in the desiredProperties by
+ using a comma-separated list:
+ * several desiredProperties paths can be passed as a comma-separated list of JSON pointers (RFC-6901)
+
+ For example:
+ * `?fields=temperature` would select only `temperature` property value of desiredProperties (if present)
+ * `?fields=temperature,humidity` would select only `temperature` and `humidity` property values of desiredProperties (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
+
+ For example:
+ * `?fields=location(longitude,latitude)` would select the `longitude` and `latitude` value inside the `location` property of desiredProperties
+
+ #### Examples
+
+ * `?fields=temperature,humidity,location(longitude,latitude)`
+
+ * `?fields=configuration,status(powerConsumption/watts)`
+required: false
+schema:
+ type: string
\ No newline at end of file
diff --git a/2.0/openapi/sources/parameters/featureFieldsQueryParam.yml b/2.0/openapi/sources/parameters/featureFieldsQueryParam.yml
new file mode 100644
index 0000000..98d9a08
--- /dev/null
+++ b/2.0/openapi/sources/parameters/featureFieldsQueryParam.yml
@@ -0,0 +1,41 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+name: fields
+in: query
+description: |-
+ 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)
+
+ For example:
+ * `?fields=properties/color` would select only `color` property value (if present)
+ * `?fields=properties/color,properties/brightness` would select only `color` and `brightness` property 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
+
+ For example:
+ * `?fields=properties(color,brightness)` would select only `color` and `brightness` property values (if present)
+ * `?fields=properties(location/longitude)` would select the `longitude` value inside the `location` object
+
+ #### Examples
+
+ * `?fields=properties(color,brightness)`
+required: false
+schema:
+ type: string
\ No newline at end of file
diff --git a/2.0/openapi/sources/parameters/featureIdPathPathParam.yml b/2.0/openapi/sources/parameters/featureIdPathPathParam.yml
new file mode 100644
index 0000000..94c28ed
--- /dev/null
+++ b/2.0/openapi/sources/parameters/featureIdPathPathParam.yml
@@ -0,0 +1,16 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+name: featureId
+in: path
+description: The ID of the feature - has to conform to RFC-3986 (URI)
+required: true
+schema:
+ type: string
\ No newline at end of file
diff --git a/2.0/openapi/sources/parameters/featuresFieldsQueryParam.yml b/2.0/openapi/sources/parameters/featuresFieldsQueryParam.yml
new file mode 100644
index 0000000..9873b8e
--- /dev/null
+++ b/2.0/openapi/sources/parameters/featuresFieldsQueryParam.yml
@@ -0,0 +1,39 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+name: fields
+in: query
+description: |-
+ 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
+ * `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)
+ 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}`
+ 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}`
+
+
+ #### Examples
+ * `?fields=EnvironmentScanner/properties(temperature,humidity)`
+ * `?fields=EnvironmentScanner/properties(temperature,humidity),Vehicle/properties/configuration`
+required: false
+schema:
+ type: string
\ No newline at end of file
diff --git a/2.0/openapi/sources/parameters/ifMatchHeaderParam.yml b/2.0/openapi/sources/parameters/ifMatchHeaderParam.yml
new file mode 100644
index 0000000..7993c51
--- /dev/null
+++ b/2.0/openapi/sources/parameters/ifMatchHeaderParam.yml
@@ -0,0 +1,19 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+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
+schema:
+ type: string
\ No newline at end of file
diff --git a/2.0/openapi/sources/parameters/ifMatchHeaderParamHash.yml b/2.0/openapi/sources/parameters/ifMatchHeaderParamHash.yml
new file mode 100644
index 0000000..f842452
--- /dev/null
+++ b/2.0/openapi/sources/parameters/ifMatchHeaderParamHash.yml
@@ -0,0 +1,19 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+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
\ No newline at end of file
diff --git a/2.0/openapi/sources/parameters/ifNoneMatchHeaderParam.yml b/2.0/openapi/sources/parameters/ifNoneMatchHeaderParam.yml
new file mode 100644
index 0000000..4d05edc
--- /dev/null
+++ b/2.0/openapi/sources/parameters/ifNoneMatchHeaderParam.yml
@@ -0,0 +1,18 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+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
+ modify a resource only if it does not yet exist, thus to create it, by specifying `If-None-Match: *`.
+required: false
+schema:
+ type: string
\ No newline at end of file
diff --git a/2.0/openapi/sources/parameters/labelPathParam.yml b/2.0/openapi/sources/parameters/labelPathParam.yml
new file mode 100644
index 0000000..d667a0c
--- /dev/null
+++ b/2.0/openapi/sources/parameters/labelPathParam.yml
@@ -0,0 +1,16 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+name: label
+in: path
+description: The label of a policy entry
+required: true
+schema:
+ type: string
\ No newline at end of file
diff --git a/2.0/openapi/sources/parameters/liveMessageRequestedAcksParam.yml b/2.0/openapi/sources/parameters/liveMessageRequestedAcksParam.yml
new file mode 100644
index 0000000..3cd29fe
--- /dev/null
+++ b/2.0/openapi/sources/parameters/liveMessageRequestedAcksParam.yml
@@ -0,0 +1,22 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+name: requested-acks
+in: query
+description: |-
+ Contains the "requested acknowledgements" for this 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=live-response` which will block the
+ HTTP call until a subscriber of the live message sends a response.
+required: false
+schema:
+ type: string
\ No newline at end of file
diff --git a/2.0/openapi/sources/parameters/messageClaimTimeoutParam.yml b/2.0/openapi/sources/parameters/messageClaimTimeoutParam.yml
new file mode 100644
index 0000000..73124f4
--- /dev/null
+++ b/2.0/openapi/sources/parameters/messageClaimTimeoutParam.yml
@@ -0,0 +1,19 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+name: timeout
+in: query
+description: |-
+ Contains an optional timeout (in seconds) of how long to wait for the Claim response and therefore block the
+ HTTP request. Default value (if omitted): 60 seconds. Maximum value: 600 seconds. A value of 0 seconds applies
+ fire and forget semantics for the message.
+required: false
+schema:
+ type: integer
\ No newline at end of file
diff --git a/2.0/openapi/sources/parameters/messageSubjectPathParam.yml b/2.0/openapi/sources/parameters/messageSubjectPathParam.yml
new file mode 100644
index 0000000..481c897
--- /dev/null
+++ b/2.0/openapi/sources/parameters/messageSubjectPathParam.yml
@@ -0,0 +1,16 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+name: messageSubject
+in: path
+description: The subject of the Message - has to conform to RFC-3986 (URI)
+required: true
+schema:
+ type: string
\ No newline at end of file
diff --git a/2.0/openapi/sources/parameters/messageTimeoutParam.yml b/2.0/openapi/sources/parameters/messageTimeoutParam.yml
new file mode 100644
index 0000000..e0399a9
--- /dev/null
+++ b/2.0/openapi/sources/parameters/messageTimeoutParam.yml
@@ -0,0 +1,19 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+name: timeout
+in: query
+description: |-
+ Contains an optional timeout (in seconds) of how long to wait for the message response and therefore block the
+ HTTP request. Default value (if omitted): 10 seconds. Maximum value: 60 seconds. A value of 0 seconds applies
+ fire and forget semantics for the message.
+required: false
+schema:
+ type: integer
\ No newline at end of file
diff --git a/2.0/openapi/sources/parameters/namespacesFilter.yml b/2.0/openapi/sources/parameters/namespacesFilter.yml
new file mode 100644
index 0000000..73d38ca
--- /dev/null
+++ b/2.0/openapi/sources/parameters/namespacesFilter.yml
@@ -0,0 +1,25 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+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.
+
+
+ #### Examples:
+
+ * `?namespaces=com.example.namespace`
+
+ * `?namespaces=com.example.namespace1,com.example.namespace2`
+required: false
+schema:
+ type: string
\ No newline at end of file
diff --git a/2.0/openapi/sources/parameters/policyIdPathParam.yml b/2.0/openapi/sources/parameters/policyIdPathParam.yml
new file mode 100644
index 0000000..f64e0fe
--- /dev/null
+++ b/2.0/openapi/sources/parameters/policyIdPathParam.yml
@@ -0,0 +1,20 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+name: policyId
+in: path
+description: |-
+ 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
\ No newline at end of file
diff --git a/2.0/openapi/sources/parameters/propertiesFieldsQueryParam.yml b/2.0/openapi/sources/parameters/propertiesFieldsQueryParam.yml
new file mode 100644
index 0000000..8bb3925
--- /dev/null
+++ b/2.0/openapi/sources/parameters/propertiesFieldsQueryParam.yml
@@ -0,0 +1,42 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+name: fields
+in: query
+description: |-
+ 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)
+
+ For example:
+ * `?fields=temperature` would select only `temperature` property value (if present)
+ * `?fields=temperature,humidity` would select only `temperature` and `humidity` property 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
+
+ For example:
+ * `?fields=location(longitude,latitude)` would select the `longitude` and `latitude` value inside the `location` property
+
+ #### Examples
+
+ * `?fields=temperature,humidity,location(longitude,latitude)`
+
+ * `?fields=configuration,status(powerConsumption/watts)`
+required: false
+schema:
+ type: string
\ No newline at end of file
diff --git a/2.0/openapi/sources/parameters/propertyPathPathParam.yml b/2.0/openapi/sources/parameters/propertyPathPathParam.yml
new file mode 100644
index 0000000..2e17604
--- /dev/null
+++ b/2.0/openapi/sources/parameters/propertyPathPathParam.yml
@@ -0,0 +1,16 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+name: propertyPath
+in: path
+description: The path to the property
+required: true
+schema:
+ type: string
\ No newline at end of file
diff --git a/2.0/openapi/sources/parameters/putMetadataParam.yml b/2.0/openapi/sources/parameters/putMetadataParam.yml
new file mode 100644
index 0000000..d6bb6c3
--- /dev/null
+++ b/2.0/openapi/sources/parameters/putMetadataParam.yml
@@ -0,0 +1,28 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+name: put-metadata
+in: header
+description: >-
+ The `put-metadata` header, which sets Metadata information in the Thing.
+required: false
+schema:
+ type: array
+ description: An array of objects containing metadata to apply.
+ items:
+ type: object
+ description: Object containing a `key` where to apply the metadata and a `value` with the metadata value to apply.
+ additionalProperties:
+ properties:
+ key:
+ type: string
+ description: The JsonPointer to set the metadata `value` to. May start with `*/<key>` in order to apply the metadata to all affected JSON leaves.
+ value:
+ description: The arbitrary JSON value to set as metadata.
\ No newline at end of file
diff --git a/2.0/openapi/sources/parameters/requestedAcksParam.yml b/2.0/openapi/sources/parameters/requestedAcksParam.yml
new file mode 100644
index 0000000..07e238d
--- /dev/null
+++ b/2.0/openapi/sources/parameters/requestedAcksParam.yml
@@ -0,0 +1,22 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+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
\ No newline at end of file
diff --git a/2.0/openapi/sources/parameters/resourcePathPathParam.yml b/2.0/openapi/sources/parameters/resourcePathPathParam.yml
new file mode 100644
index 0000000..26a3def
--- /dev/null
+++ b/2.0/openapi/sources/parameters/resourcePathPathParam.yml
@@ -0,0 +1,16 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+name: resourcePath
+in: path
+description: The path of an (Authorization) Resource
+required: true
+schema:
+ type: string
\ No newline at end of file
diff --git a/2.0/openapi/sources/parameters/responseRequiredParam.yml b/2.0/openapi/sources/parameters/responseRequiredParam.yml
new file mode 100644
index 0000000..86f42a5
--- /dev/null
+++ b/2.0/openapi/sources/parameters/responseRequiredParam.yml
@@ -0,0 +1,20 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+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
\ No newline at end of file
diff --git a/2.0/openapi/sources/parameters/searchFilter.yml b/2.0/openapi/sources/parameters/searchFilter.yml
new file mode 100644
index 0000000..cc62a72
--- /dev/null
+++ b/2.0/openapi/sources/parameters/searchFilter.yml
@@ -0,0 +1,76 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+name: filter
+in: query
+description: |-
+
+ #### Filter predicates:
+
+ * ```eq({property},{value})``` (i.e. equal to the given value)
+
+ * ```ne({property},{value})``` (i.e. not equal to the given value)
+
+ * ```gt({property},{value})``` (i.e. greater than the given value)
+
+ * ```ge({property},{value})``` (i.e. equal to the given value or greater than it)
+
+ * ```lt({property},{value})``` (i.e. lower than the given value or equal to it)
+
+ * ```le({property},{value})``` (i.e. lower than the given value)
+
+ * ```in({property},{value},{value},...)``` (i.e. contains at least one of the values listed)
+
+ * ```like({property},{value})``` (i.e. contains values similar to the expressions listed)
+
+ * ```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.
+ For example, the filter `ne(attributes/owner, "SID123")` will only return things that do have
+ the `owner` attribute.
+
+
+ #### Logical operations:
+
+
+ * ```and({query},{query},...)```
+
+ * ```or({query},{query},...)```
+
+ * ```not({query})```
+
+
+ #### Examples:
+
+ * ```eq(attributes/location,"kitchen")```
+
+ * ```ge(thingId,"myThing1")```
+
+ * ```gt(_created,"2020-08-05T12:17")```
+
+ * ```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
\ No newline at end of file
diff --git a/2.0/openapi/sources/parameters/subjectIdPathParam.yml b/2.0/openapi/sources/parameters/subjectIdPathParam.yml
new file mode 100644
index 0000000..8345bfc
--- /dev/null
+++ b/2.0/openapi/sources/parameters/subjectIdPathParam.yml
@@ -0,0 +1,16 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+name: subjectId
+in: path
+description: The ID of an (Authorization) Subject
+required: true
+schema:
+ type: string
\ No newline at end of file
diff --git a/2.0/openapi/sources/parameters/thingFieldsQueryParam.yml b/2.0/openapi/sources/parameters/thingFieldsQueryParam.yml
new file mode 100644
index 0000000..860c739
--- /dev/null
+++ b/2.0/openapi/sources/parameters/thingFieldsQueryParam.yml
@@ -0,0 +1,81 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+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.
+
+ #### Selectable fields
+
+ * `thingId`
+ * `policyId`
+ * `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)
+
+ For example:
+ * `?fields=attributes/model` would select only `model` attribute value (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
+
+ For example:
+ * `?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)
+
+ * `_namespace`
+
+ Specifically selects the namespace also contained in the `thingId`
+
+ * `_revision`
+
+ Specifically selects the revision of the thing. The revision is a counter, which is incremented on each modification of a thing.
+
+ * `_created`
+
+ Specifically selects the created timestamp of the thing in ISO-8601 UTC format. The timestamp is set on creation 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.
+
+ * `_metadata`
+
+ Specifically selects the Metadata of the thing. The content is a JSON object having the Thing's JSON structure with the difference that the JSON leaves of the Thing are JSON objects containing the metadata.
+
+ * `_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`
+required: false
+schema:
+ type: string
\ No newline at end of file
diff --git a/2.0/openapi/sources/parameters/thingIdPathParam.yml b/2.0/openapi/sources/parameters/thingIdPathParam.yml
new file mode 100644
index 0000000..c5dfac5
--- /dev/null
+++ b/2.0/openapi/sources/parameters/thingIdPathParam.yml
@@ -0,0 +1,17 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+name: thingId
+in: path
+description: |-
+ 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
\ No newline at end of file
diff --git a/2.0/openapi/sources/parameters/timeoutParam.yml b/2.0/openapi/sources/parameters/timeoutParam.yml
new file mode 100644
index 0000000..7036239
--- /dev/null
+++ b/2.0/openapi/sources/parameters/timeoutParam.yml
@@ -0,0 +1,22 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+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) and maximum timeout is `60s`. A value of `0` applies fire and forget semantics for
+ the command resulting in setting `response-required=false`.
+required: false
+schema:
+ type: string
\ No newline at end of file
diff --git a/2.0/openapi/sources/paths/cloudevents/cloudevents.yml b/2.0/openapi/sources/paths/cloudevents/cloudevents.yml
new file mode 100644
index 0000000..b333e49
--- /dev/null
+++ b/2.0/openapi/sources/paths/cloudevents/cloudevents.yml
@@ -0,0 +1,115 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+post:
+ summary: Processes a CloudEvent sent in Ditto Protocol
+ description: |-
+ Provides an endpoint accepting [CloudEvents via its HTTP protocol binding](https://github.com/cloudevents/spec/blob/v1.0/http-protocol-binding.md)
+ in [Ditto Protocol JSON](https://www.eclipse.org/ditto/protocol-specification.html).
+
+ The endpoint can also directly be configured as a [Knative eventing](https://knative.dev/docs/eventing/) destination.
+
+ Find more documentation on that [here](https://www.eclipse.org/ditto/httpapi-protocol-bindings-cloudevents.html).
+ tags:
+ - CloudEvents
+ parameters:
+ - in: header
+ name: ce-specversion
+ description: The CloudEvents "specversion".
+ schema:
+ type: string
+ example: "1.0"
+ required: true
+ - in: header
+ name: ce-type
+ description: The CloudEvents event "type".
+ schema:
+ type: string
+ example: "com.example.someevent"
+ required: true
+ - in: header
+ name: ce-source
+ description: The CloudEvents event "source".
+ schema:
+ type: string
+ example: "/mycontext"
+ required: true
+ - in: header
+ name: ce-id
+ description: The CloudEvents event "id".
+ schema:
+ type: string
+ example: "1234-1234-1234"
+ required: true
+ - in: header
+ name: ce-time
+ description: The CloudEvents event "time".
+ schema:
+ type: string
+ format: date-time
+ example: "2020-12-31T23:59:59Z"
+ required: true
+ - in: header
+ name: ce-dataschema
+ description: The CloudEvents event "dataschema". If provided, this must start with `ditto:`.
+ schema:
+ type: string
+ required: false
+ responses:
+ '202':
+ description: |-
+ The Ditto Protocol CloudEvent was successfully parsed, the authentication was valid and also reached the persistence.
+ '400':
+ description: |-
+ The request could not be completed. Possible reasons:
+ * the CloudEvent could not be parsed as some mandatory CloudEvent headers were missing from the request
+ * the payload was missing from the CloudEvent
+ * the [Ditto Protocol JSON](https://www.eclipse.org/ditto/protocol-specification.html) message could not be parsed or was missing a required field
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ The request could not be completed. Possible reasons:
+ * the caller has insufficient permissions.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. Possible reasons:
+ * the referenced thing does not exist.
+ * the caller has insufficient permissions to perform the contained Ditto Protocol command.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '408':
+ description: The request could not be completed due to timeout.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '415':
+ description: The `Content-Type` of the request was not supported.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ requestBody:
+ $ref: '../../requests/dittoProtocol.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/paths/features/definition.yml b/2.0/openapi/sources/paths/features/definition.yml
new file mode 100644
index 0000000..dc1ae33
--- /dev/null
+++ b/2.0/openapi/sources/paths/features/definition.yml
@@ -0,0 +1,283 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+get:
+ summary: List the definition of a feature
+ description: |-
+ Returns the complete definition field of the feature identified by the `thingId` and `featureId` path parameter.
+ tags:
+ - Features
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featureIdPathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ responses:
+ '200':
+ description: The definition was successfully retrieved.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/features/featureDefinition.yml'
+ '304':
+ $ref: '../../responses/notModified.yml'
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ 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:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+put:
+ 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.
+
+ The definition field will be overwritten with the JSON array set in the request body
+ tags:
+ - Features
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featureIdPathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '201':
+ description: The definition was successfully created.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ Location:
+ description: The location of the created definition resource
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/features/featureDefinition.yml'
+ '204':
+ description: The definition was successfully updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The thing or the feature with the given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/features/featureDefinition.yml'
+ 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 are strings in the format `"namespace:name:version"` which is enforced.
+ required: true
+patch:
+ summary: Patch the definition of a feature
+ description: |-
+ Patch the definition of a feature identified by the `thingId` and `featureId` path parameter.
+
+ The existing definition field will be overwritten with the JSON array set in the request body.
+
+ Notice that the `null` value can be used to delete the definition of a feature.
+ For further documentation see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+ tags:
+ - Features
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featureIdPathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The definition was successfully patched.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The thing or the feature with the given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ content:
+ application/merge-patch+json:
+ schema:
+ $ref: '../../schemas/features/featureDefinition.yml'
+ example:
+ - 'com.acme:coffeebrewer:0.1.0'
+ - 'com.acme:coffeebrewer:1.1.0'
+ description: |-
+ JSON array of the complete definition to be patched. Consider that the value has to be a JSON array.
+
+ The content of the JSON array are strings in the format `"namespace:name:version"` which is enforced.
+ To delete the definition use `null` as content in the request body.
+ required: true
+delete:
+ summary: Delete the definition of a feature
+ description: |-
+ Deletes the complete definition of the feature identified by the `thingId` and `featureId` path parameter.
+ tags:
+ - Features
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featureIdPathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The definition was successfully deleted.
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ 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:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/paths/features/desiredProperties.yml b/2.0/openapi/sources/paths/features/desiredProperties.yml
new file mode 100644
index 0000000..0d48d72
--- /dev/null
+++ b/2.0/openapi/sources/paths/features/desiredProperties.yml
@@ -0,0 +1,309 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+get:
+ summary: List all desired properties of a feature
+ description: |-
+ Returns all desired properties of the feature identified by the `thingId` and `featureId` path parameter.
+ tags:
+ - Features
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featureIdPathPathParam.yml'
+ - $ref: '../../parameters/desiredPropertiesFieldsQueryParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ responses:
+ '200':
+ description: The desired properties were successfully retrieved.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/features/featureProperties.yml'
+ '304':
+ $ref: '../../responses/notModified.yml'
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '402':
+ description: The request could not be completed due to exceeded data volume or exceeded transaction count.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The specified feature has no desired properties or
+ the thing with the specified `thingId` or the feature with `featureId` was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+put:
+ summary: Create or update all desired properties of a feature at once
+ description: |-
+ Create or update the desired properties of a feature identified by the `thingId` and `featureId` path parameter.
+
+ The desired properties will be overwritten with the JSON content from the request body.
+ tags:
+ - Features
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featureIdPathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '201':
+ description: The desired properties were successfully created.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/features/featureProperties.yml'
+ '204':
+ description: The desired properties were successfully updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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 desired feature roperties to be created/modified is invalid
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ The request could not be completed. Possible reasons:
+ * the caller has insufficient permissions.
+ For modifying the desired properties of an existing feature, `WRITE` permission is required.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The thing or the feature with the given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/features/featureProperties.yml'
+ example: {
+ "configuration": {
+ "smartMode": true,
+ "brewingTemp": 87,
+ "tempToHold": 44,
+ "timeoutSeconds": 6000
+ },
+ "status": {
+ "waterAmount": 731,
+ "temperature": 44
+ }
+ }
+ description: |-
+ JSON object of all desried 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
+patch:
+ summary: Patch all desired properties of a feature
+ description: |-
+ Patch the desired properties of a feature identified by the `thingId` and `featureId` path parameter.
+
+ The existing desired properties will be merged with the JSON content set in the request body.
+
+ Notice that the `null` value can be used to delete the whole feature or specific parts of it.
+ For further documentation see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+
+ **Note**: In contrast to the "PUT things/{thingId}/features/{featureId}/desiredProperties" request,
+ a partial update is supported here and request body is merged with the existing desired properties.
+ tags:
+ - Features
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featureIdPathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The desired properties were successfully patched.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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 desired feature roperties to be created/modified is invalid
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ The request could not be completed. Possible reasons:
+ * the caller has insufficient permissions.
+ For modifying the desired properties of an existing feature, `WRITE` permission is required.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The thing or the feature with the given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ content:
+ application/merge-patch+json:
+ schema:
+ $ref: '../../schemas/features/featureProperties.yml'
+ example:
+ configuration:
+ smartMode: null
+ brewingTemp: 87
+ tempToHold: 44
+ timeoutSeconds: 6000
+ status:
+ waterAmount: 731
+ temperature: 44
+ description: |-
+ JSON object of all desried properties to be patched.
+
+ Consider that the value has to be a [JSON merge patch](https://tools.ietf.org/html/rfc7396). 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 desired properties of a feature
+ description: |-
+ Deletes all desired properties of the feature identified by the `thingId` and `featureId` path parameter.
+ tags:
+ - Features
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featureIdPathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The desired properties were successfully deleted.
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ The request could not be completed. Possible reasons:
+ * the caller has insufficient permissions.
+ For deleting the desired properties of an existing feature, `WRITE` permission is required.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The specified feature has no desired properties or
+ the thing with the specified `thingId` or the feature with `featureId` was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/paths/features/desiredProperty.yml b/2.0/openapi/sources/paths/features/desiredProperty.yml
new file mode 100644
index 0000000..28ee585
--- /dev/null
+++ b/2.0/openapi/sources/paths/features/desiredProperty.yml
@@ -0,0 +1,279 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+get:
+ summary: Retrieve a specific desired property of a feature
+ description: |-
+ Returns the a specific desired property path of the feature identified by the `thingId` and `featureId` path parameter.
+
+ The desired 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/desiredProperties/configuration/brewingTemp`
+ tags:
+ - Features
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featureIdPathPathParam.yml'
+ - $ref: '../../parameters/propertyPathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ responses:
+ '200':
+ description: The desired property was successfully retrieved.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '304':
+ $ref: '../../responses/notModified.yml'
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The specified desired property or
+ the thing with the specified `thingId` or the feature with `featureId` was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+put:
+ summary: Create or update a specific desired property of a feature
+ description: |-
+ Create or update a specific desired property of a feature identified by the `thingId` and `featureId` path parameter.
+
+ The desired property will be created if it doesn't exist or else updated.
+
+ The desired 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/desiredProperties/configuration/brewingTemp`
+ tags:
+ - Features
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featureIdPathPathParam.yml'
+ - $ref: '../../parameters/propertyPathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '201':
+ description: The desired property was successfully created.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '204':
+ description: The desired property was successfully updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ The request could not be completed. Possible reasons:
+ * the caller has insufficient permissions.
+ For creating/updating a desired property of an existing feature, `WRITE` permission is required.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The thing or the feature with the given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ $ref: '../../requests/value.yml'
+patch:
+ summary: Patch a specific desired property of a feature
+ description: |-
+ Patch a specific desired property of a feature identified by the `thingId` and `featureId` path parameter.
+
+ The exisiting desired property of a feature will be merged with the JSON content set in the request body.
+
+ Notice that the `null` value can be used to delete the specified propertyPath.
+ For further documentation see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+
+ The desired 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/desiredProperties/configuration/brewingTemp`
+ tags:
+ - Features
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featureIdPathPathParam.yml'
+ - $ref: '../../parameters/propertyPathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The desired property was successfully patched.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ The request could not be completed. Possible reasons:
+ * the caller has insufficient permissions.
+ For creating/updating a desired property of an existing feature, `WRITE` permission is required.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The thing or the feature with the given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ $ref: '../../requests/patchValue.yml'
+delete:
+ summary: Delete a specific desired property of a feature
+ description: |-
+ Deletes a specific desired property of the feature identified by the `thingId`
+ and `featureId` path parameter.
+
+ The desired 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/desiredProperties/configuration/brewingTemp`
+ tags:
+ - Features
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featureIdPathPathParam.yml'
+ - $ref: '../../parameters/propertyPathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The desired property was successfully deleted.
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The specified desired property or
+ the thing with the specified `thingId` or the feature with `featureId` was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/paths/features/feature.yml b/2.0/openapi/sources/paths/features/feature.yml
new file mode 100644
index 0000000..8d33870
--- /dev/null
+++ b/2.0/openapi/sources/paths/features/feature.yml
@@ -0,0 +1,330 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+get:
+ 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.
+ tags:
+ - Features
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featureIdPathPathParam.yml'
+ - $ref: '../../parameters/featureFieldsQueryParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ responses:
+ '200':
+ description: The feature was successfully retrieved.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/features/feature.yml'
+ '304':
+ $ref: '../../responses/notModified.yml'
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+put:
+ 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 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: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featureIdPathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '201':
+ description: The feature was successfully created.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ Location:
+ description: The location of the created feature resource
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/features/feature.yml'
+ '204':
+ description: The feature was successfully modified.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The thing with the given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/features/feature.yml'
+ 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.
+ 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
+patch:
+ summary: Patch a specific feature of a specific thing
+ description: |-
+ Patch a specific feature identified by the `featureId` path parameter of a thing identified by the `thingId` path parameter.
+
+ The existing feature will be merged with the JSON content set in the request body.
+
+ Notice that the `null` value can be used to delete the whole feature or specific parts of it.
+ For further documentation see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+
+ **Note**: In contrast to the "PUT things/{thingId}/features/{featureId}" request,
+ a partial update is supported here and request body is merged with the existing feature.
+
+ ### Example
+
+ Set the `featureId` to **coffee-brewer** and all properties in the body part
+ to update the `brewed-coffees` property and delete the definition.
+
+ ```
+ {
+ "definition": null,
+ "properties": {
+ "brewed-coffees": 42
+ }
+ }
+ ```
+ tags:
+ - Features
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featureIdPathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The feature was successfully patched.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The thing with the given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ content:
+ application/merge-patch+json:
+ schema:
+ $ref: '../../schemas/features/feature.yml'
+ example:
+ definition: null
+ properties:
+ connected: true
+ brewed-coffees: 0
+ description: |-
+ JSON representation of the feature to be patched. Consider that the value has to be a [JSON merge patch](https://tools.ietf.org/html/rfc7396).
+
+ Examples:
+ * a nested object with multiple model definitions and multiple properties as shown in the example value field
+ * **Note**: To delete certain properties of a feature the `null` value can be used.
+ For further documentation see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+ required: true
+delete:
+ 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.
+ tags:
+ - Features
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featureIdPathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The feature was successfully deleted.
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/paths/features/index.yml b/2.0/openapi/sources/paths/features/index.yml
new file mode 100644
index 0000000..088b623
--- /dev/null
+++ b/2.0/openapi/sources/paths/features/index.yml
@@ -0,0 +1,400 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+get:
+ summary: List all features of a specific thing
+ description: |-
+ Returns all features of the thing identified by the `thingId` path parameter.
+ tags:
+ - Features
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featuresFieldsQueryParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '200':
+ description: |-
+ The list of features of the specific thing were successfully
+ retrieved.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/features/features.yml'
+ example:
+ {
+ "featureId1": {
+ "definition": [ "namespace:definition1:v1.0" ],
+ "properties": { "property1": "value1" }
+ },
+ "featureId2": {
+ "definition": [ "namespace:definition2:v1.0" ],
+ "properties": { "property2": "value2" }
+ }
+ }
+ '304':
+ $ref: '../../responses/notModified.yml'
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+put:
+ summary: Create or modify all features of a specific thing at once
+ description: |-
+ 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: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '201':
+ description: The features were successfully created.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ Location:
+ description: The location of the created features resource
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/features/features.yml'
+ example:
+ {}
+ '204':
+ description: The features were successfully modified.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The thing with the given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/features/features.yml'
+ 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 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
+patch:
+ summary: Patch all features of a specific thing
+ description: |-
+ Patch all features of a thing identified by the `thingId` path parameter.
+
+ The existing features will be merged with the JSON content set in the request body.
+
+ Notice that the `null` value has a special meaning and can be used to delete specific features from the thing.
+ For further documentation see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+
+ **Note**: In contrast to the "PUT thing/{thingId}/features" request, a partial update is supported here
+ and request body is merged with the existing features.
+
+ ### Example
+
+ The following example will add/update the properties `brewed-coffees`, `tempToHold` and `failState`.
+ The configuration property `smartMode` will be deleted from the thing.
+
+
+ ```
+ {
+ "coffee-brewer": {
+ "properties": {
+ "brewed-coffees": 10
+ }
+ },
+ "water-tank": {
+ "properties": {
+ "configuration": {
+ "smartMode": null,
+ "tempToHold": 50,
+ },
+ "status": {
+ "failState": true
+ }
+ }
+ }
+ }
+ ```
+ tags:
+ - Features
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featureIdPathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The features were successfully patched.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The thing with the given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ content:
+ application/merge-patch+json:
+ schema:
+ $ref: '../../schemas/features/features.yml'
+ example:
+ coffee-brewer:
+ properties:
+ brewed-coffees: 10
+ water-tank:
+ properties:
+ configuration:
+ smartMode: null
+ tempToHold: 50
+ status:
+ failState: true
+ description: |-
+ JSON object of all features to be patched. Consider that the value has to be a [JSON merge patch](https://tools.ietf.org/html/rfc7396).
+
+ Examples:
+ * a nested object with multiple features as shown in the example value field
+
+ * **Note**: To delete certain entries of a feature the `null` value can be used.
+ For further documentation see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+ required: true
+delete:
+ summary: Delete all features of a specific thing
+ description: |-
+ Deletes all features of the thing identified by the `thingId` path parameter.
+ tags:
+ - Features
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The features were successfully deleted.
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/paths/features/properties.yml b/2.0/openapi/sources/paths/features/properties.yml
new file mode 100644
index 0000000..682d611
--- /dev/null
+++ b/2.0/openapi/sources/paths/features/properties.yml
@@ -0,0 +1,302 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+get:
+ summary: List all properties of a feature
+ description: |-
+ Returns all properties of the feature identified by the `thingId` and `featureId` path parameter.
+ tags:
+ - Features
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featureIdPathPathParam.yml'
+ - $ref: '../../parameters/propertiesFieldsQueryParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ responses:
+ '200':
+ description: The properties were successfully retrieved.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/features/featureProperties.yml'
+ '304':
+ $ref: '../../responses/notModified.yml'
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ 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:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+put:
+ 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.
+
+ The properties will be overwritten with the JSON content from the request body.
+ tags:
+ - Features
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featureIdPathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '201':
+ description: The properties were successfully created.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/features/featureProperties.yml'
+ '204':
+ description: The properties were successfully updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The thing or the feature with the given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/features/featureProperties.yml'
+ 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\-]*
+ required: true
+patch:
+ summary: Patch all properties of a feature
+ description: |-
+ Patch the properties of a feature identified by the `thingId` and `featureId` path parameter.
+
+ The existing properties will be merged with the JSON content set in the request body.
+
+ Notice that the `null` value can be used to delete specific feature properties.
+ For further documentation see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+
+ **Note**: In contrast to the "PUT things/{thingId}/features/{featureId}/properties" request,
+ a partial update is supported here and request body is merged with the existing properties.
+ tags:
+ - Features
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featureIdPathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The properties were successfully patched.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The thing or the feature with the given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ content:
+ application/merge-patch+json:
+ schema:
+ $ref: '../../schemas/features/featureProperties.yml'
+ example:
+ configuration:
+ smartMode: null
+ brewingTemp: 87
+ tempToHold: 44
+ timeoutSeconds: 6000
+ status:
+ waterAmount: 731
+ temperature: 44
+ description: |-
+ JSON object of all properties to be patched.
+
+ Consider that the value has to be a [JSON merge patch](https://tools.ietf.org/html/rfc7396).
+ 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
+ description: |-
+ Deletes all properties of the feature identified by the `thingId` and `featureId` path parameter.
+ tags:
+ - Features
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featureIdPathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The properties were successfully deleted.
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ 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:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/paths/features/property.yml b/2.0/openapi/sources/paths/features/property.yml
new file mode 100644
index 0000000..5db8f5d
--- /dev/null
+++ b/2.0/openapi/sources/paths/features/property.yml
@@ -0,0 +1,276 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+get:
+ summary: Retrieve a specific property of a feature
+ description: |-
+ 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: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featureIdPathPathParam.yml'
+ - $ref: '../../parameters/propertyPathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ responses:
+ '200':
+ description: The property was successfully retrieved.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '304':
+ $ref: '../../responses/notModified.yml'
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ 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:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+put:
+ 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),
+
+ ### 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: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featureIdPathPathParam.yml'
+ - $ref: '../../parameters/propertyPathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '201':
+ description: The property was successfully created.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '204':
+ description: The property was successfully updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The thing or the feature with the given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ $ref: '../../requests/value.yml'
+patch:
+ summary: Patch a specific property of a feature
+ description: |-
+ Patch a specific property of a feature identified by the `thingId` and `featureId` path parameter.
+
+ The existing property will be merged with the existing one of the thing.
+
+ Notice that the `null` value can be used to delete the specified propertyPath.
+ For further documentation see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+
+ 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: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featureIdPathPathParam.yml'
+ - $ref: '../../parameters/propertyPathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The property was successfully patched.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The thing or the feature with the given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ $ref: '../../requests/patchValue.yml'
+delete:
+ 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)
+
+ ### 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: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featureIdPathPathParam.yml'
+ - $ref: '../../parameters/propertyPathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The property was successfully deleted.
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ 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:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/paths/messages/feature-inbox-message.yml b/2.0/openapi/sources/paths/messages/feature-inbox-message.yml
new file mode 100644
index 0000000..74271e3
--- /dev/null
+++ b/2.0/openapi/sources/paths/messages/feature-inbox-message.yml
@@ -0,0 +1,92 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+post:
+ summary: Send a message TO a specific feature of a specific thing
+ description: |-
+ 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 HTTP request blocks until all acknowledgement requests are fulfilled.
+ By default, it blocks until a response to the 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.
+
+ In order to handle the message in a fire and forget manner, add
+ a query-parameter `timeout=0` to the request.
+
+ Note that the client chooses which HTTP status code it wants to return. Ditto
+ will forward the status code to you. (Also note that '204 - No Content' status code
+ will never return a body, even if the client responded with a body).
+
+ ### 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:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featureIdPathPathParam.yml'
+ - $ref: '../../parameters/messageSubjectPathParam.yml'
+ - $ref: '../../parameters/messageTimeoutParam.yml'
+ - $ref: '../../parameters/liveMessageRequestedAcksParam.yml'
+ responses:
+ '202':
+ description: |-
+ The message was sent but not necessarily received by the feature
+ (fire and forget).
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. Possible reasons:
+ * the referenced thing does not exist.
+ * the caller has insufficient permissions to interact with the messages of referenced thing.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '408':
+ description: The request could not be completed due to timeout.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '413':
+ $ref: '../../responses/messageTooLarge.yml'
+ '503':
+ $ref: '../../responses/messageTimeout.yml'
+ requestBody:
+ $ref: '../../requests/payload.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/paths/messages/feature-outbox-message.yml b/2.0/openapi/sources/paths/messages/feature-outbox-message.yml
new file mode 100644
index 0000000..8145ec7
--- /dev/null
+++ b/2.0/openapi/sources/paths/messages/feature-outbox-message.yml
@@ -0,0 +1,90 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+post:
+ summary: Send a message FROM a specific feature of a specific thing
+ description: |-
+ 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.
+
+ The HTTP request blocks until all acknowledgement requests are fulfilled.
+ By default, it blocks until a response to the 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.
+
+ In order to handle the message in a fire and forget manner, add
+ a query-parameter `timeout=0` to the request.
+
+ Note that the client chooses which HTTP status code it wants to return. Ditto
+ will forward the status code to you. (Also note that '204 - No Content' status code
+ will never return a body, even if the client responded with a body).
+
+ ### 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:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/featureIdPathPathParam.yml'
+ - $ref: '../../parameters/messageSubjectPathParam.yml'
+ - $ref: '../../parameters/messageTimeoutParam.yml'
+ - $ref: '../../parameters/liveMessageRequestedAcksParam.yml'
+ responses:
+ '202':
+ description: The message was sent (fire and forget).
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. Possible reasons:
+ * the referenced thing does not exist.
+ * the caller has insufficient permissions to interact with the messages of referenced thing.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '408':
+ description: The request could not be completed due to timeout.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '413':
+ $ref: '../../responses/messageTooLarge.yml'
+ '503':
+ $ref: '../../responses/messageTimeout.yml'
+ requestBody:
+ $ref: '../../requests/payload.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/paths/messages/inbox-claim.yml b/2.0/openapi/sources/paths/messages/inbox-claim.yml
new file mode 100644
index 0000000..a1e727a
--- /dev/null
+++ b/2.0/openapi/sources/paths/messages/inbox-claim.yml
@@ -0,0 +1,107 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+post:
+ summary: Initiates claiming a specific thing in order to gain access
+ description: |-
+ ### 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.
+
+ The HTTP request blocks until all acknowledgement requests are fulfilled.
+ By default, it 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.
+
+ Note that the client chooses which HTTP status code it wants to return. Ditto
+ will forward the status code to you. (Also note that '204 - No Content' status code
+ will never return a body, even if the client responded with a body).
+
+ ### 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:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/messageClaimTimeoutParam.yml'
+ - $ref: '../../parameters/liveMessageRequestedAcksParam.yml'
+ responses:
+ '200':
+ description: |-
+ The Claim message was processed successfully and the response body
+ contains the custom response. The response body may contain
+ arbitrary data chosen by the recipient. The response code defaults
+ to `200` but may be chosen by the recipient too.
+ '204':
+ description: |-
+ The Claim message was processed successfully and no custom response
+ body was set. The response code defaults to `204` but may be chosen
+ by the recipient.
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. Possible reasons:
+ * the referenced thing does not exist.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '408':
+ description: The request could not be completed due to timeout.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '413':
+ $ref: '../../responses/messageTooLarge.yml'
+ '429':
+ description: |-
+ The user has sent too many requests in a given amount of time ("rate
+ limiting").
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '503':
+ $ref: '../../responses/messageTimeout.yml'
+ requestBody:
+ $ref: '../../requests/payload.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/paths/messages/inbox-message.yml b/2.0/openapi/sources/paths/messages/inbox-message.yml
new file mode 100644
index 0000000..646cd02
--- /dev/null
+++ b/2.0/openapi/sources/paths/messages/inbox-message.yml
@@ -0,0 +1,102 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+post:
+ summary: Send a message TO a specific thing
+ description: |-
+ ### 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 HTTP request blocks until all acknowledgement requests are fulfilled.
+ By default, it blocks until a response to the 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.
+
+ In order to handle the message in a fire and forget manner, add
+ a query-parameter `timeout=0` to the request.
+
+ Note that the client chooses which HTTP status code it wants to return. Ditto
+ will forward the status code to you. (Also note that '204 - No Content' status code
+ will never return a body, even if the client responded with a body).
+
+ ### 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:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/messageSubjectPathParam.yml'
+ - $ref: '../../parameters/messageTimeoutParam.yml'
+ - $ref: '../../parameters/liveMessageRequestedAcksParam.yml'
+ responses:
+ '202':
+ description: |-
+ The message was sent but not necessarily received by the thing (fire and forget).
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. Possible reasons:
+ * the referenced thing does not exist.
+ * the caller has insufficient permissions to interact with the messages of referenced thing.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '408':
+ description: The request could not be completed due to timeout.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '413':
+ $ref: '../../responses/messageTooLarge.yml'
+ '503':
+ $ref: '../../responses/messageTimeout.yml'
+ requestBody:
+ $ref: '../../requests/payload.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/paths/messages/outbox-message.yml b/2.0/openapi/sources/paths/messages/outbox-message.yml
new file mode 100644
index 0000000..92a663a
--- /dev/null
+++ b/2.0/openapi/sources/paths/messages/outbox-message.yml
@@ -0,0 +1,88 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+post:
+ summary: Send a message FROM a specific thing
+ description: |-
+ 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.
+
+ The HTTP request blocks until all acknowledgement requests are fulfilled.
+ By default, it blocks until a response to the 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.
+
+ In order to handle the message in a fire and forget manner, add
+ a query-parameter `timeout=0` to the request.
+
+ Note that the client chooses which HTTP status code it wants to return. Ditto
+ will forward the status code to you. (Also note that '204 - No Content' status code
+ will never return a body, even if the client responded with a body).
+
+ ### 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:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/messageSubjectPathParam.yml'
+ - $ref: '../../parameters/messageTimeoutParam.yml'
+ - $ref: '../../parameters/liveMessageRequestedAcksParam.yml'
+ responses:
+ '202':
+ description: The message was sent (fire and forget).
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. Possible reasons:
+ * the referenced thing does not exist.
+ * the caller has insufficient permissions to interact with the messages of referenced thing.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '408':
+ description: The request could not be completed due to timeout.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '413':
+ $ref: '../../responses/messageTooLarge.yml'
+ '503':
+ $ref: '../../responses/messageTimeout.yml'
+ requestBody:
+ $ref: '../../requests/payload.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/paths/policies/activateTokenIntegration.yml b/2.0/openapi/sources/paths/policies/activateTokenIntegration.yml
new file mode 100644
index 0000000..88e0fa3
--- /dev/null
+++ b/2.0/openapi/sources/paths/policies/activateTokenIntegration.yml
@@ -0,0 +1,44 @@
+# Copyright (c) 2021 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+post:
+ summary: Activate subjects for this policy derived from the token
+ description: |-
+ **This action only works when authenticated with a Json Web Token (JWT).**
+
+ Based on the authenticated token (JWT), **for each policy entry** matching those conditions:
+ * the authenticated token is granted the `EXECUTE` permission to perform the `activateTokenIntegration` action
+ * one of the subject IDs is contained in the authenticated token
+ * at least one `READ` permission to a `thing:/` resource path is granted
+
+ a new subject is **injected into the matched policy entry** calculated with information extracted from the
+ authenticated JWT.
+
+ The injected subjects expire when the JWT expires.
+ tags:
+ - Policies
+ parameters:
+ - $ref: '../../parameters/policyIdPathParam.yml'
+ responses:
+ '204':
+ description: The request was successful. Subjects were injected into authorized policy entries.
+ '400':
+ description: The request could not be completed because the authentication was not performed with a JWT.
+ '403':
+ description: |-
+ The request could not be completed because the authenticated JWT did not have the `EXECUTE` permission on any
+ entries of the policy.
+ '404':
+ description: |-
+ The request could not be completed because no policy entry matched the following conditions:
+ * containing a a subject ID matching the JWT's authenticated subject
+ * containing a `READ` permission granted to a `thing:/` resource path
+ requestBody:
+ $ref: '../../requests/policies/actions/activateTokenIntegration.yml'
diff --git a/2.0/openapi/sources/paths/policies/activateTokenIntegrationForEntry.yml b/2.0/openapi/sources/paths/policies/activateTokenIntegrationForEntry.yml
new file mode 100644
index 0000000..3fa2187
--- /dev/null
+++ b/2.0/openapi/sources/paths/policies/activateTokenIntegrationForEntry.yml
@@ -0,0 +1,45 @@
+# Copyright (c) 2021 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+post:
+ summary: Activate a subject for this policy entry derived from the token
+ description: |-
+ **This action only works when authenticated with a Json Web Token (JWT).**
+
+ Based on the authenticated token (JWT), **this policy entry** is checked to match those conditions:
+ * the authenticated token is granted the `EXECUTE` permission to perform the `activateTokenIntegration` action
+ * one of the subject IDs is contained in the authenticated token
+ * at least one `READ` permission to a `thing:/` resource path is granted
+
+ When all conditions match, a new subject is **injected into this policy entry** calculated with information
+ extracted from the authenticated JWT.
+
+ The injected subjects expire when the JWT expires.
+ tags:
+ - Policies
+ parameters:
+ - $ref: '../../parameters/policyIdPathParam.yml'
+ - $ref: '../../parameters/labelPathParam.yml'
+ responses:
+ '204':
+ description: The request was successful. The subject was injected.
+ '400':
+ description: The request could not be completed because the authentication was not performed with a JWT.
+ '403':
+ description: |-
+ The request could not be completed because the authenticated JWT did not have the `EXECUTE` permission on this
+ policy entry.
+ '404':
+ description: |-
+ The request could not be completed because this policy entry did not match the following conditions:
+ * containing a a subject ID matching the JWT's authenticated subject
+ * containing a `READ` permission granted to a `thing:/` resource path
+ requestBody:
+ $ref: '../../requests/policies/actions/activateTokenIntegration.yml'
diff --git a/2.0/openapi/sources/paths/policies/deactivateTokenIntegration.yml b/2.0/openapi/sources/paths/policies/deactivateTokenIntegration.yml
new file mode 100644
index 0000000..b3205a2
--- /dev/null
+++ b/2.0/openapi/sources/paths/policies/deactivateTokenIntegration.yml
@@ -0,0 +1,38 @@
+# Copyright (c) 2021 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+post:
+ summary: Deactivate subjects for this policy derived from the token
+ description: |-
+ **This action only works when authenticated with a Json Web Token (JWT).**
+
+ Based on the authenticated token (JWT), **for each policy entry** matching those conditions:
+ * the authenticated token is granted the `EXECUTE` permission to perform the `deactivateTokenIntegration` action
+ * one of the subject IDs is contained in the authenticated token
+
+ the calculated subject with information extracted from the authenticated JWT is **removed
+ from the matched policy entry**.
+ tags:
+ - Policies
+ parameters:
+ - $ref: '../../parameters/policyIdPathParam.yml'
+ responses:
+ '204':
+ description: The request was successful. Subjects were removed from authorized policy entries.
+ '400':
+ description: The request could not be completed because the authentication was not performed with a JWT.
+ '403':
+ description: |-
+ The request could not be completed because the authenticated JWT did not have the `EXECUTE` permission on any
+ entries of the policy.
+ '404':
+ description: |-
+ The request could not be completed because no policy entry matched the following conditions:
+ * containing a a subject ID matching the JWT's authenticated subject
diff --git a/2.0/openapi/sources/paths/policies/deactivateTokenIntegrationForEntry.yml b/2.0/openapi/sources/paths/policies/deactivateTokenIntegrationForEntry.yml
new file mode 100644
index 0000000..5537ffb
--- /dev/null
+++ b/2.0/openapi/sources/paths/policies/deactivateTokenIntegrationForEntry.yml
@@ -0,0 +1,38 @@
+# Copyright (c) 2021 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+post:
+ summary: Deactivate a subject for this policy entry derived from the token
+ description: |-
+ **This action only works when authenticated with a Json Web Token (JWT).**
+
+ Based on the authenticated token (JWT), **this policy entry** is checked to match those conditions:
+ * the authenticated token is granted the `EXECUTE` permission to perform the `deactivateTokenIntegration` action
+ * one of the subject IDs is contained in the authenticated token
+
+ When all conditions match, the calculated subject with information extracted from the authenticated JWT is **removed
+ from this policy entry**.
+ tags:
+ - Policies
+ parameters:
+ - $ref: '../../parameters/policyIdPathParam.yml'
+ - $ref: '../../parameters/labelPathParam.yml'
+ responses:
+ '204':
+ description: The request was successful. The subject was removed.
+ '400':
+ description: The request could not be completed because the authentication was not performed with a JWT.
+ '403':
+ description: |-
+ The request could not be completed because the user did not have the `EXECUTE` permission on this policy entry.
+ '404':
+ description: |-
+ The request could not be completed because this policy entry did not match the following conditions:
+ * containing a a subject ID matching the JWT's authenticated subject
diff --git a/2.0/openapi/sources/paths/policies/entries.yml b/2.0/openapi/sources/paths/policies/entries.yml
new file mode 100644
index 0000000..1d250d0
--- /dev/null
+++ b/2.0/openapi/sources/paths/policies/entries.yml
@@ -0,0 +1,171 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+get:
+ summary: Retrieve the entries of a specific policy
+ description: |-
+ Returns all policy entries of the policy identified by the `policyId`
+ path parameter.
+ tags:
+ - Policies
+ parameters:
+ - $ref: '../../parameters/policyIdPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ responses:
+ '200':
+ description: |-
+ The request successfully returned completed and returned are the
+ policy entries.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/policies/policyEntries.yml'
+ '304':
+ $ref: '../../responses/notModified.yml'
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ 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:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+put:
+ summary: Modify the entries of a specific policy
+ description: |-
+ 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: '../../parameters/policyIdPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The policy entries were successfully updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ 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:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/policies/policyEntries.yml'
+ 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.
+ Use the placeholder `{{ request:subjectId }}` in order to let the
+ backend insert the authenticated subjectId of the HTTP request.
+ required: true
\ No newline at end of file
diff --git a/2.0/openapi/sources/paths/policies/entry.yml b/2.0/openapi/sources/paths/policies/entry.yml
new file mode 100644
index 0000000..273c63f
--- /dev/null
+++ b/2.0/openapi/sources/paths/policies/entry.yml
@@ -0,0 +1,272 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+get:
+ summary: Retrieve the entries of a specific Label of a specific policy
+ description: |-
+ 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: '../../parameters/policyIdPathParam.yml'
+ - $ref: '../../parameters/labelPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ responses:
+ '200':
+ description: |-
+ The request successfully returned completed and returned is the
+ policy entry.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/policies/policyEntry.yml'
+ '304':
+ $ref: '../../responses/notModified.yml'
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '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
+ user.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+put:
+ summary: Create or modify the entries of a specific Label of a specific policy
+ description: |-
+ 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: '../../parameters/policyIdPathParam.yml'
+ - $ref: '../../parameters/labelPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '201':
+ description: The policy entry was successfully created.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ Location:
+ description: The location of the created policy entry
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/policies/policyEntry.yml'
+ '204':
+ description: The policy entry was successfully updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ 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:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/policies/policyEntry.yml'
+ 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.
+ 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 the entries of a specific Label of a specific policy
+ description: |-
+ 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: '../../parameters/policyIdPathParam.yml'
+ - $ref: '../../parameters/labelPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The policy entry was successfully deleted.
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ 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:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/paths/policies/policy.yml b/2.0/openapi/sources/paths/policies/policy.yml
new file mode 100644
index 0000000..d5e2b5f
--- /dev/null
+++ b/2.0/openapi/sources/paths/policies/policy.yml
@@ -0,0 +1,306 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+get:
+ summary: Retrieve a specific policy
+ description: |-
+ 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 of a thing, request it via GET `/things/{thingId}`.
+ tags:
+ - Policies
+ parameters:
+ - $ref: '../../parameters/policyIdPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParam.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ responses:
+ '200':
+ description: |-
+ The request successfully returned completed and returned is the
+ policy.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/policies/policy.yml'
+ '304':
+ $ref: '../../responses/notModified.yml'
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ 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:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+put:
+ summary: Create or update a policy with a specified ID
+ description: |-
+ 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.
+
+ ### 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.
+
+ By default the authorized subject needs WRITE permission on the root resource of the created policy. You can
+ however omit this check by setting the parameter `allow-policy-lockout` to `true`.
+
+ 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.
+
+ ```
+ {
+ "entries": {
+ "DEFAULT": {
+ "subjects": {
+ "{{ request:subjectId }}": {
+ "type": "the creator"
+ }
+ },
+ "resources": {
+ "policy:/": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ },
+ "thing:/": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ },
+ "message:/": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ }
+ }
+ }
+ }
+ }
+ ```
+
+ ### 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 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: '../../parameters/policyIdPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParam.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ - $ref: '../../parameters/allowPolicyLockoutParam.yml'
+ responses:
+ '201':
+ description: The policy was successfully created.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ Location:
+ description: The location of the created policy resource
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/policies/newPolicy.yml'
+ '204':
+ description: The policy was successfully updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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.
+ (You can omit this check by setting the `allow-policy-lockout` parameter.)
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ 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:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/policies/newPolicy.yml'
+ 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.
+ 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
+ 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.
+
+ 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: '../../parameters/policyIdPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParam.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The policy was successfully deleted.
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ 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:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/paths/policies/resource.yml b/2.0/openapi/sources/paths/policies/resource.yml
new file mode 100644
index 0000000..60dae82
--- /dev/null
+++ b/2.0/openapi/sources/paths/policies/resource.yml
@@ -0,0 +1,215 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+get:
+ summary: Retrieve one specific Resource for a specific Label of a specific policy
+ description: |-
+ 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: '../../parameters/policyIdPathParam.yml'
+ - $ref: '../../parameters/labelPathParam.yml'
+ - $ref: '../../parameters/resourcePathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ responses:
+ '200':
+ description: |-
+ The request successfully returned completed and returned is the
+ Resource.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/policies/resourceEntry.yml'
+ '304':
+ $ref: '../../responses/notModified.yml'
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '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
+ authenticated user.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+put:
+ 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
+ identified by the `policyId` path parameter.
+ tags:
+ - Policies
+ parameters:
+ - $ref: '../../parameters/policyIdPathParam.yml'
+ - $ref: '../../parameters/labelPathParam.yml'
+ - $ref: '../../parameters/resourcePathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '201':
+ description: The Resource was successfully created.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ Location:
+ description: The location of the created Resource
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/policies/resourceEntry.yml'
+ '204':
+ description: The Resource was successfully updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '304':
+ $ref: '../../responses/notModified.yml'
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '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
+ user.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/policies/resourceEntry.yml'
+ description: JSON representation of the Resource
+ required: true
+delete:
+ summary: Delete one specific Resource for a specific Label of a specific policy
+ description: |-
+ 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: '../../parameters/policyIdPathParam.yml'
+ - $ref: '../../parameters/labelPathParam.yml'
+ - $ref: '../../parameters/resourcePathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The Resource was successfully deleted.
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '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
+ authenticated user.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/paths/policies/resources.yml b/2.0/openapi/sources/paths/policies/resources.yml
new file mode 100644
index 0000000..1449027
--- /dev/null
+++ b/2.0/openapi/sources/paths/policies/resources.yml
@@ -0,0 +1,185 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+get:
+ summary: Retrieve all Resources for a specific Label of a specific policy
+ description: |-
+ Returns all resource entries of the policy identified by
+ the `policyId` path parameter,
+ and by the `label` path parameter.
+ tags:
+ - Policies
+ parameters:
+ - $ref: '../../parameters/policyIdPathParam.yml'
+ - $ref: '../../parameters/labelPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ responses:
+ '200':
+ description: The request successfully returned. The resources are returned.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/policies/resources.yml'
+ '304':
+ $ref: '../../responses/notModified.yml'
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '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
+ user.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+put:
+ summary: Create or modify all Resources for a specific Label of a specific policy
+ description: |-
+ 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:/features/confidential": {
+ "grant": [],
+ "revoke": [
+ "READ"
+ ]
+ }
+ }
+ ```
+ tags:
+ - Policies
+ parameters:
+ - $ref: '../../parameters/policyIdPathParam.yml'
+ - $ref: '../../parameters/labelPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The Resources were successfully created or updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '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
+ user.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/policies/resources.yml'
+ description: JSON representation of the Resources
+ required: true
\ No newline at end of file
diff --git a/2.0/openapi/sources/paths/policies/subject.yml b/2.0/openapi/sources/paths/policies/subject.yml
new file mode 100644
index 0000000..dc07ee2
--- /dev/null
+++ b/2.0/openapi/sources/paths/policies/subject.yml
@@ -0,0 +1,215 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+get:
+ 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 `policyId` path parameter, and by the `label` path parameter.
+ tags:
+ - Policies
+ parameters:
+ - $ref: '../../parameters/policyIdPathParam.yml'
+ - $ref: '../../parameters/labelPathParam.yml'
+ - $ref: '../../parameters/subjectIdPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ responses:
+ '200':
+ description: |-
+ The request successfully returned completed and returned is the
+ Subject.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/policies/subjectEntry.yml'
+ '304':
+ $ref: '../../responses/notModified.yml'
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '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
+ authenticated user.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+put:
+ 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 identified
+ by the `policyId` path parameter, and by the `label` path parameter.
+ tags:
+ - Policies
+ parameters:
+ - $ref: '../../parameters/policyIdPathParam.yml'
+ - $ref: '../../parameters/labelPathParam.yml'
+ - $ref: '../../parameters/subjectIdPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '201':
+ description: The Subject was successfully created.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ Location:
+ description: The location of the created Subject
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/policies/subjectEntry.yml'
+ '204':
+ description: The Subject was successfully updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '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
+ user.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/policies/subjectEntry.yml'
+ description: JSON representation of the Subject
+ required: true
+delete:
+ summary: Delete one specific Subject for a specific Label of a specific policy
+ description: |-
+ 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: '../../parameters/policyIdPathParam.yml'
+ - $ref: '../../parameters/labelPathParam.yml'
+ - $ref: '../../parameters/subjectIdPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The Subject was successfully deleted.
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '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
+ authenticated user.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/paths/policies/subjects.yml b/2.0/openapi/sources/paths/policies/subjects.yml
new file mode 100644
index 0000000..56e7ce9
--- /dev/null
+++ b/2.0/openapi/sources/paths/policies/subjects.yml
@@ -0,0 +1,154 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+get:
+ summary: Retrieve all Subjects for a specific Label of a specific policy
+ description: |-
+ Returns all subject entries of the policy identified by the
+ `policyId` path parameter, and by the `label`
+ path parameter.
+ tags:
+ - Policies
+ parameters:
+ - $ref: '../../parameters/policyIdPathParam.yml'
+ - $ref: '../../parameters/labelPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ responses:
+ '200':
+ description: The request successfully returned. The subjects are returned.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/policies/subjects.yml'
+ '304':
+ $ref: '../../responses/notModified.yml'
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '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
+ user.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+put:
+ summary: Create or modify all Subjects for a specific Label of a specific policy
+ description: |-
+ 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: '../../parameters/policyIdPathParam.yml'
+ - $ref: '../../parameters/labelPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The Subjects were successfully created or updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ 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:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/policies/subjects.yml'
+ description: |-
+ JSON representation of the Subjects.
+
+
+ Use the placeholder `{{ request:subjectId }}` in order to let the
+ backend insert the authenticated subjectId of the HTTP request.
+ required: true
\ No newline at end of file
diff --git a/2.0/openapi/sources/paths/search/things-count.yml b/2.0/openapi/sources/paths/search/things-count.yml
new file mode 100644
index 0000000..fc61698
--- /dev/null
+++ b/2.0/openapi/sources/paths/search/things-count.yml
@@ -0,0 +1,64 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+get:
+ summary: Count things
+ description: |-
+ This resource can be used to count things.
+
+ The query parameter `filter` is not mandatory. If it is not set there is
+ returned the total amount of 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:
+
+ ```eq(attributes/location,"kitchen")```
+ parameters:
+ - $ref: '../../parameters/searchFilter.yml'
+ - $ref: '../../parameters/namespacesFilter.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ tags:
+ - Things-Search
+ responses:
+ '200':
+ description: A number indicating the amount of matched things
+ content:
+ application/json:
+ schema:
+ type: integer
+ '400':
+ description: |-
+ The request could not be completed. A provided parameter is in a
+ wrong format.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: The request could not be completed due to an invalid authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '504':
+ description: The request ran out of time to execute on the the back-end. Optimize your query and try again.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/paths/search/things.yml b/2.0/openapi/sources/paths/search/things.yml
new file mode 100644
index 0000000..dc9b2a7
--- /dev/null
+++ b/2.0/openapi/sources/paths/search/things.yml
@@ -0,0 +1,108 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+get:
+ 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, the
+ result contains all things which the logged in user is allowed to read.
+
+ * The search is case sensitive. In case you don't know how exactly the
+ spelling of value of the namespace, name, attribute, feature etc. is, use the *like*
+ notation instead of *eq* for filtering.
+
+ * 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: '../../parameters/searchFilter.yml'
+ - $ref: '../../parameters/namespacesFilter.yml'
+ - $ref: '../../parameters/thingFieldsQueryParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - name: option
+ in: query
+ description: |-
+ Possible values for the parameter:
+
+ #### Sort operations
+
+ * ```sort([+|-]{property})```
+ * ```sort([+|-]{property},[+|-]{property},...)```
+
+ #### Paging operations
+
+ * ```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 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 or timeouts and will be removed eventually.
+
+ #### Examples:
+
+ * ```sort(+thingId)```
+ * ```sort(-attributes/manufacturer)```
+ * ```sort(+thingId,-attributes/manufacturer)```
+ * ```size(10)``` return 10 results
+ * ```cursor(LOREMIPSUM)``` return results after the position of the cursor `LOREMIPSUM`.
+
+ #### 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,
+ you will need to separate the options using a comma (,) character.
+
+ ```size(200),cursor(LOREMIPSUM)```
+
+ The deprecated paging option `limit` may not be combined with the other paging options `size` and `cursor`.
+ required: false
+ schema:
+ type: string
+ tags:
+ - Things-Search
+ responses:
+ '200':
+ description: An array of the matching things.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/search/searchResultThings.yml'
+ '400':
+ description: |-
+ The request could not be completed. A provided parameter is in a
+ wrong format.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: The request could not be completed due to an invalid authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '504':
+ description: The request ran out of time to execute on the the back-end. Optimize your query and try again.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/paths/things/attribute.yml b/2.0/openapi/sources/paths/things/attribute.yml
new file mode 100644
index 0000000..f54f3a4
--- /dev/null
+++ b/2.0/openapi/sources/paths/things/attribute.yml
@@ -0,0 +1,275 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+get:
+ 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).
+
+ ### 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: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/attributePathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ responses:
+ '200':
+ description: The attribute was successfully retrieved.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '304':
+ $ref: '../../responses/notModified.yml'
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+put:
+ 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.
+
+ * 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: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/attributePathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '201':
+ description: The attribute was successfully created.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ Location:
+ description: The location of the created attribute resource
+ schema:
+ type: string
+ '204':
+ description: The attribute was successfully modified.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The thing with the given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ $ref: '../../requests/value.yml'
+patch:
+ summary: Patch a specific attribute of a specific thing
+ description: |-
+ Patch a specific attribute of a 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 merged
+ * If you set the request body to `null` for an existing attribute path then the attribute will be deleted.
+ For further documentation see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+
+ The attribute (JSON) can be referenced hierarchically, by applying JSON Pointer notation (RFC-6901).
+
+ ### Example:
+
+ In order to patch the `name` field of an `manufacturer` attribute, the full path would be
+ `/things/{thingId}/attributes/manufacturer/name`
+ tags:
+ - Things
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/attributePathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The attribute was successfully patched.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The thing with the given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ $ref: '../../requests/patchValue.yml'
+delete:
+ 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).
+
+ ### 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: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/attributePathPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The attribute was successfully deleted.
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/paths/things/attributes.yml b/2.0/openapi/sources/paths/things/attributes.yml
new file mode 100644
index 0000000..53c56f3
--- /dev/null
+++ b/2.0/openapi/sources/paths/things/attributes.yml
@@ -0,0 +1,274 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+get:
+ summary: List all attributes of a specific thing
+ description: |-
+ Returns all attributes of the thing identified by the `thingId` path parameter.
+ tags:
+ - Things
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/attributesFieldsQueryParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ responses:
+ '200':
+ description: The attributes of the specific thing were successfully retrieved.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/things/attributes.yml'
+ '304':
+ $ref: '../../responses/notModified.yml'
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The thing with the given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+put:
+ 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. The attributes will be overwritten - all at once - with the
+ content (JSON) set in the request body.
+ tags:
+ - Things
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '201':
+ description: The attributes were successfully created.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ Location:
+ description: The location of the created attribute resource
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/things/attributes.yml'
+ '204':
+ description: The attributes were successfully updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The thing with the given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ $ref: '../../requests/attributes.yml'
+patch:
+ summary: Patch all attributes of a specific thing
+ description: |-
+ Patch the attributes of a thing identified by the `thingId` path parameter.
+ The existing attributes will be merged with the JSON content set in the request body.
+
+ Notice that the `null` value has a special meaning and can be used to delete all or specific attributes from a thing.
+ For further documentation see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+
+ **Note**: In contrast to the "PUT things/{thingId}/attributes" request,
+ a partial update is supported here and request body is merged with the existing attributes.
+ tags:
+ - Things
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The attributes were successfully patched.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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 patched is invalid
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The thing with the given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ content:
+ application/merge-patch+json:
+ schema:
+ $ref: '../../schemas/things/attributes.yml'
+ 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 patched. Consider that the value has to be a [JSON merge patch](https://tools.ietf.org/html/rfc7396).
+
+ Examples:
+ * 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
+ * `null`: deletes all attributes
+ required: true
+delete:
+ summary: Delete all attributes of a specific thing at once
+ description: |-
+ Deletes all attributes of the thing identified by the `thingId` path parameter.
+ tags:
+ - Things
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The attributes were successfully deleted.
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The thing with the given ID or its attributes were not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/paths/things/definition.yml b/2.0/openapi/sources/paths/things/definition.yml
new file mode 100644
index 0000000..fe58ca9
--- /dev/null
+++ b/2.0/openapi/sources/paths/things/definition.yml
@@ -0,0 +1,282 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+get:
+ summary: Retrieve the definition of a specific thing
+ description: |-
+ Returns the definition of the thing identified by the `thingId` path parameter.
+ tags:
+ - Things
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ responses:
+ '200':
+ description: The request successfully returned the definition of the specific thing.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/things/definition.yml'
+ '304':
+ $ref: '../../responses/notModified.yml'
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The thing with the given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+put:
+ summary: Create or update the definition of a specific thing
+ description: |-
+ * 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: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '201':
+ description: The definition was successfully created.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ Location:
+ description: The location of the created definition resource
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/things/definition.yml'
+ '204':
+ description: The definition was successfully updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The thing with the given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ $ref: '../../requests/definition.yml'
+patch:
+ summary: Patch the definition of a specific thing
+ description: |-
+ * If the thing does not have a definition yet, this request will create it.
+ * If the thing already has a definition you can replace it by providing the new definition in the request body.
+ * If the request body is set to `null` then the defintion will be deleted.
+
+ Notice that the `null` value in the JSON body has a special meaning and will delete the definition from the thing.
+ For further documentation see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+ tags:
+ - Things
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The definition was successfully patched.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The thing with the given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ content:
+ application/merge-patch+json:
+ schema:
+ $ref: '../../schemas/things/definition.yml'
+ example: '"example:test:definition"'
+ description: |-
+ JSON string representation of the definition to be patched.
+
+ Consider that the value has to be a JSON string.
+
+ Examples:
+
+ * 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: `""`
+ * `null`: the definition will be deleted
+delete:
+ summary: Delete the definition of a specific thing
+ description: |-
+ Deletes the definition of the thing identified by the `thingId`.
+ tags:
+ - Things
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ 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)).
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The thing with the given ID or its definition was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/paths/things/index.yml b/2.0/openapi/sources/paths/things/index.yml
new file mode 100644
index 0000000..6455eb5
--- /dev/null
+++ b/2.0/openapi/sources/paths/things/index.yml
@@ -0,0 +1,178 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+get:
+ summary: Retrieve multiple things with specified IDs
+ description: |-
+ 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
+ parameters:
+ - 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: '../../parameters/thingFieldsQueryParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ responses:
+ '200':
+ description: |-
+ The successfully completed request contains as its result the first 200 for the user available Things.
+ The Things are sorted in the same order as the Thing IDs were provided in the `ids` parameter.
+ content:
+ application/json:
+ schema:
+ type: array
+ items:
+ $ref: '../../schemas/things/thing.yml'
+ '400':
+ description: |-
+ The request could not be completed. At least one of the defined
+ query parameters was invalid.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '414':
+ description: |-
+ The request could not be completed due to an URI length exceeding 8k
+ characters.
+post:
+ summary: Create a new thing
+ description: |-
+ Creates a thing with a default `thingId` and a default `policyId`.
+
+ 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.
+
+ The field `_created` is filled automatically with the timestamp of the creation. The field is read-only and can
+ be retrieved later by explicitly selecting it or used in search filters.
+ tags:
+ - Things
+ parameters:
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ - $ref: '../../parameters/allowPolicyLockoutParam.yml'
+ responses:
+ '201':
+ description: The thing was successfully created.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ Location:
+ description: The location of the created thing resource
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/things/thing.yml'
+ '400':
+ description: |-
+ The request could not be completed. Possible reasons:
+
+ * 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ 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.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/things/newThing.yml'
+ 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.
diff --git a/2.0/openapi/sources/paths/things/policyId.yml b/2.0/openapi/sources/paths/things/policyId.yml
new file mode 100644
index 0000000..2200167
--- /dev/null
+++ b/2.0/openapi/sources/paths/things/policyId.yml
@@ -0,0 +1,190 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+get:
+ summary: Retrieve the policy ID of a thing
+ description: |-
+ Returns the policy ID of the thing identified by the `thingId` path parameter.
+ tags:
+ - Things
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ responses:
+ '200':
+ description: The request successfully returned the policy ID.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ type: string
+ '304':
+ $ref: '../../responses/notModified.yml'
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '404':
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+put:
+ summary: Update the policy ID of a thing
+ description: |-
+ Update the policy ID of the thing identified by the `thingId` path parameter.
+
+ ### 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: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The policy ID was successfully updated.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '404':
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ type: string
+ example: "\"your.namespace:your-policy-name\""
+ description: |-
+ 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
+patch:
+ summary: Patch the policy ID of a thing
+ description: |-
+ Patch the policy ID of the thing identified by the `thingId` path parameter.
+
+ The `policyId` of the thing will be updated.
+ Notice that for this resource it is not possible to remove the `policyId` from the thing by setting the
+ payload to `null`.
+ tags:
+ - Things
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParamHash.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: 'The policy ID was successfully patched. Note: You will need to create the policy content separately.'
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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 `policyId` can not be removed from a thing.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '404':
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ content:
+ application/merge-patch+json:
+ schema:
+ type: string
+ example: '"your.namespace:your-policy-name"'
+ description: |-
+ 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
diff --git a/2.0/openapi/sources/paths/things/thing.yml b/2.0/openapi/sources/paths/things/thing.yml
new file mode 100644
index 0000000..9c163c5
--- /dev/null
+++ b/2.0/openapi/sources/paths/things/thing.yml
@@ -0,0 +1,558 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+get:
+ summary: Retrieve a specific thing
+ description: |-
+ 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:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/thingFieldsQueryParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParam.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ responses:
+ '200':
+ description: The request successfully returned the specific thing.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/things/thing.yml'
+ '304':
+ $ref: '../../responses/notModified.yml'
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The thing with the given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+put:
+ 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.
+
+ * 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.
+
+
+ ### 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"
+
+ The field `_created` is filled automatically with the timestamp of the creation. The field is read-only and can
+ be retrieved later by explicitly selecting it or used in search filters.
+
+ ### 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:model:version",
+ "attributes": {
+ "foo": 1
+ },
+ "features": {...}
+ }
+ ```
+
+ 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
+ }
+ }
+ ```
+
+ 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": "namespace:model:version",
+ "attributes": {
+ "foo": 2,
+ "bar": false
+ },
+ "features": {...}
+ }
+ ```
+ tags:
+ - Things
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParam.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/putMetadataParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '201':
+ description: The thing was successfully created.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ Location:
+ description: The location of the created thing resource
+ schema:
+ type: string
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/things/thing.yml'
+ '204':
+ description: The thing was successfully modified.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. Possible reasons:
+ * the referenced thing does not exist.
+ * 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/things/newThing.yml'
+ 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.
+patch:
+ summary: Patch a thing with a specified ID
+ description: |-
+ Patch an existing thing specified by the `thingId` path parameter.
+
+ Patching a thing will merge the provided request body with the exisiting thing.
+ This makes it possible to change only some parts of a thing in single request without providing the full thing
+ structure in the request body.
+
+
+ ### Patch a thing
+
+ With this resource it is possible to add, update or delete parts of an existing thing.
+ The request body provided in *JSON merge patch* (RFC-7396) format will be merged with the existing thing.
+ Notice that the `null` value in the JSON body will delete the specified JSON key from the thing.
+ For further documentation of JSON merge patch see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+
+
+ ### Example
+ A Thing already exists with the following content:
+
+ ```
+ {
+ "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
+ }
+ }
+ }
+ }
+ }
+ ```
+
+ To make changes that only affect parts of the existing thing, e.g. add some attribute and delete a
+ specific feature property, the content of the request body could look like this:
+
+ ```
+ {
+ "attributes": {
+ "manufacturingYear": "2020"
+ },
+ "features": {
+ "water-tank": {
+ "properties": {
+ "configuration": {
+ "smartMode": null,
+ "tempToHold": 50,
+ }
+ }
+ }
+ }
+ }
+ ```
+
+ The request body will be merged with the existing thing and the result will be the following thing:
+
+ ```
+ {
+ "definition": "com.acme:coffeebrewer:0.1.0",
+ "attributes": {
+ "manufacturer": "ACME demo corp.",
+ "manufacturingYear": "2020",
+ "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": {
+ "brewingTemp": 87,
+ "tempToHold": 50,
+ "timeoutSeconds": 6000
+ },
+ "status": {
+ "waterAmount": 731,
+ "temperature": 44
+ }
+ }
+ }
+ }
+ }
+ ```
+
+ ### Permissions for patching an existing Thing
+
+ For updating an existing thing, the authorized subject needs **WRITE** permission on those parts of the thing
+ that are affected by the merge update.
+
+ For example, to successfully execute the above example the authorized subject needs to have unrestricted
+ *WRITE* permissions on all affected paths of the JSON merge patch: `attributes/manufacturingYear`,
+ `features/water-tank/properties/configuration/smartMode`,
+ `features/water-tank/properties/configuration/tempToHold`. The *WRITE* permission must not be revoked on any
+ level further down the hierarchy. Consequently it is also sufficient for the authorized subject to have
+ unrestricted *WRITE* permission at root level or unrestricted *WRITE* permission at `/attributes` and
+ `/features` etc.
+ tags:
+ - Things
+ parameters:
+ - $ref: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParam.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/putMetadataParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The thing was successfully patched.
+ headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+ '400':
+ description: |-
+ The request could not be completed. Possible reasons:
+
+ * the JSON body of the thing to be patched is invalid
+ * the JSON body of the thing to be patched contains a `thingId` which does not match the ID in the path
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. Possible reasons:
+ * the referenced thing does not exist.
+ * the caller has insufficient permissions to read the referenced thing.
+ * the policy that should be copied does not exist.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
+ '413':
+ $ref: '../../responses/entityTooLarge.yml'
+ requestBody:
+ content:
+ application/merge-patch+json:
+ schema:
+ $ref: '../../schemas/things/patchThing.yml'
+ example:
+ attributes:
+ manufacturingYear: '2020'
+ features:
+ water-tank:
+ properties:
+ configuration:
+ smartMode: null
+ tempToHold: 50
+ description: JSON representation of the thing to be patched.
+delete:
+ summary: Delete a specific thing
+ description: |-
+ 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: '../../parameters/thingIdPathParam.yml'
+ - $ref: '../../parameters/ifMatchHeaderParam.yml'
+ - $ref: '../../parameters/ifNoneMatchHeaderParam.yml'
+ - $ref: '../../parameters/requestedAcksParam.yml'
+ - $ref: '../../parameters/timeoutParam.yml'
+ - $ref: '../../parameters/responseRequiredParam.yml'
+ responses:
+ '204':
+ description: The thing was successfully deleted.
+ '400':
+ description: |-
+ 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:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '403':
+ description: |-
+ 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: '../../schemas/errors/advancedError.yml'
+ '404':
+ description: |-
+ The request could not be completed. The thing with the given ID was not found.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
+ '412':
+ $ref: '../../responses/preconditionFailed.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/paths/whoami/index.yml b/2.0/openapi/sources/paths/whoami/index.yml
new file mode 100644
index 0000000..c44babd
--- /dev/null
+++ b/2.0/openapi/sources/paths/whoami/index.yml
@@ -0,0 +1,30 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+get:
+ summary: Retrieve information about the current caller
+ description: |-
+ Get information about the current caller, e.g. the auth subjects that are generated for the caller.
+ tags:
+ - Policies
+ responses:
+ '200':
+ description: |-
+ The request successfully returned information about the caller.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/whoami/whoami.yml'
+ '401':
+ description: The request could not be completed due to missing authentication.
+ content:
+ application/json:
+ schema:
+ $ref: '../../schemas/errors/advancedError.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/requests/attributes.yml b/2.0/openapi/sources/requests/attributes.yml
new file mode 100644
index 0000000..65c465b
--- /dev/null
+++ b/2.0/openapi/sources/requests/attributes.yml
@@ -0,0 +1,33 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+content:
+ application/json:
+ schema:
+ $ref: '../schemas/things/attributes.yml'
+ 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:
+ * 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
\ No newline at end of file
diff --git a/2.0/openapi/sources/requests/definition.yml b/2.0/openapi/sources/requests/definition.yml
new file mode 100644
index 0000000..efc330c
--- /dev/null
+++ b/2.0/openapi/sources/requests/definition.yml
@@ -0,0 +1,21 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+content:
+ application/json:
+ schema:
+ $ref: '../schemas/things/definition.yml'
+ example: '"example:test:definition"'
+description: |-
+ 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 should follow the pattern: [_a-zA-Z0-9\-]:[_a-zA-Z0-9\-]:[_a-zA-Z0-9\-]
+ * an empty string: `""`
\ No newline at end of file
diff --git a/2.0/openapi/sources/requests/dittoProtocol.yml b/2.0/openapi/sources/requests/dittoProtocol.yml
new file mode 100644
index 0000000..9c25a01
--- /dev/null
+++ b/2.0/openapi/sources/requests/dittoProtocol.yml
@@ -0,0 +1,60 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+content:
+ application/vnd.eclipse.ditto+json:
+ schema:
+ type: object
+ properties:
+ topic:
+ type: string
+ description: |-
+ Contains information about the contents of the payload:
+ * the affected Thing (namespace and Thing ID)
+ * the type of operation (command/event, create/retrieve/modify/delete)
+ example: "org.eclipse.ditto/thing-1/things/twin/commands/modify"
+ headers:
+ type: object
+ description: Additional headers.
+ properties:
+ 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.
+ example:
+ correlation-id: "1234-4321-1234"
+ path:
+ type: string
+ description: References the part of a Thing which is affected by this message.
+ example: "/features/location/properties/longitude"
+ value:
+ oneOf:
+ - type: "object"
+ - type: "string"
+ - type: "number"
+ - type: "array"
+ - type: "boolean"
+ description: The `value` field contains the actual payload e.g. a sensor value.
+ required:
+ - topic
+ - path
+ example: {
+ "topic": "org.eclipse.ditto/thing-1/things/twin/commands/modify",
+ "path": "/",
+ "value": {
+ "attributes": {
+ "foo": 42
+ }
+ }
+ }
+description: |-
+ The [Ditto Protocol JSON](https://www.eclipse.org/ditto/protocol-specification.html) payload defining which
+ command to process.
\ No newline at end of file
diff --git a/2.0/openapi/sources/requests/patchValue.yml b/2.0/openapi/sources/requests/patchValue.yml
new file mode 100644
index 0000000..4ecfe09
--- /dev/null
+++ b/2.0/openapi/sources/requests/patchValue.yml
@@ -0,0 +1,28 @@
+# Copyright (c) 2021 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+content:
+ application/merge-patch+json:
+ schema:
+ type: object
+ example: {}
+description: |-
+ JSON representation of the value to be patched. This may be as well an empty object.
+
+ Consider that the value has to be a JSON value.
+
+ Examples:
+ * for a number, the JSON value is the number: `42`
+ * for a string, the JSON value must be quoted: `"aString"`
+ * 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\-]*
+ * for an list, the JSON value is the list: `[ 1,2,3 ]`
+ * special value `null` will delete the referenced key. For further documentation see [RFC 7396](https://tools.ietf.org/html/rfc7396).
+required: true
\ No newline at end of file
diff --git a/2.0/openapi/sources/requests/payload.yml b/2.0/openapi/sources/requests/payload.yml
new file mode 100644
index 0000000..7736e6c
--- /dev/null
+++ b/2.0/openapi/sources/requests/payload.yml
@@ -0,0 +1,26 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+content:
+ application/json:
+ schema:
+ type: string
+ example: ''
+ application/octet-stream:
+ schema:
+ type: string
+ example: ''
+ text/plain:
+ schema:
+ type: string
+ example: ''
+description: |-
+ Payload of the message with max size of 250 kB. It can be any HTTP
+ supported content, including binary content.
\ No newline at end of file
diff --git a/2.0/openapi/sources/requests/policies/actions/activateTokenIntegration.yml b/2.0/openapi/sources/requests/policies/actions/activateTokenIntegration.yml
new file mode 100644
index 0000000..0e3340d
--- /dev/null
+++ b/2.0/openapi/sources/requests/policies/actions/activateTokenIntegration.yml
@@ -0,0 +1,22 @@
+# Copyright (c) 2021 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+content:
+ application/json:
+ schema:
+ properties:
+ announcement:
+ $ref: '../../../schemas/policies/subjectAnnouncement.yml'
+ example:
+ announcement:
+ beforeExpiry: "5m"
+ whenDeleted: true
+description: Optional request payload for `activateTokenIntegration` policy action.
+required: false
\ No newline at end of file
diff --git a/2.0/openapi/sources/requests/value.yml b/2.0/openapi/sources/requests/value.yml
new file mode 100644
index 0000000..ee79c16
--- /dev/null
+++ b/2.0/openapi/sources/requests/value.yml
@@ -0,0 +1,31 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+content:
+ application/json:
+ schema:
+ type: object
+ example: { }
+description: |-
+ JSON representation of the value to be created/updated. This may be as
+ well `null` or an empty object.
+
+ Consider that the value has to be a JSON value, examples:
+
+ * for a number, the JSON value is the number: `42`
+
+ * for a string, the JSON value must be quoted: `"aString"`
+
+ * 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\-]*
+
+ * for an list, the JSON value is the list: `[ 1,2,3 ]`
+required: true
\ No newline at end of file
diff --git a/2.0/openapi/sources/responses/entityTooLarge.yml b/2.0/openapi/sources/responses/entityTooLarge.yml
new file mode 100644
index 0000000..e80d9cd
--- /dev/null
+++ b/2.0/openapi/sources/responses/entityTooLarge.yml
@@ -0,0 +1,16 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+description: |-
+ The created or modified entity is larger than the accepted limit of 100 kB.
+content:
+ application/json:
+ schema:
+ $ref: '../schemas/errors/advancedError.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/responses/messageTimeout.yml b/2.0/openapi/sources/responses/messageTimeout.yml
new file mode 100644
index 0000000..55092f2
--- /dev/null
+++ b/2.0/openapi/sources/responses/messageTimeout.yml
@@ -0,0 +1,16 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+description: |-
+ The request could not be completed as there is no consumer for this message connected.
+content:
+ application/json:
+ schema:
+ $ref: '../schemas/errors/advancedError.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/responses/messageTooLarge.yml b/2.0/openapi/sources/responses/messageTooLarge.yml
new file mode 100644
index 0000000..f8c6ecc
--- /dev/null
+++ b/2.0/openapi/sources/responses/messageTooLarge.yml
@@ -0,0 +1,16 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+description: |-
+ The size of the send message is larger than the accepted limit of 250 kB.
+content:
+ application/json:
+ schema:
+ $ref: '../schemas/errors/advancedError.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/responses/notModified.yml b/2.0/openapi/sources/responses/notModified.yml
new file mode 100644
index 0000000..ff173b4
--- /dev/null
+++ b/2.0/openapi/sources/responses/notModified.yml
@@ -0,0 +1,20 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+description: |-
+ The (sub-)resource has not been modified. This happens when you specified a If-None-Match header which
+ matches the current ETag of the (sub-)resource.
+headers:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
\ No newline at end of file
diff --git a/2.0/openapi/sources/responses/preconditionFailed.yml b/2.0/openapi/sources/responses/preconditionFailed.yml
new file mode 100644
index 0000000..9cf6dcb
--- /dev/null
+++ b/2.0/openapi/sources/responses/preconditionFailed.yml
@@ -0,0 +1,26 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+description: |-
+ 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:
+ ETag:
+ description: |-
+ The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
+ "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
+ schema:
+ type: string
+content:
+ application/json:
+ schema:
+ $ref: '../schemas/errors/advancedError.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/schemas/errors/advancedError.yml b/2.0/openapi/sources/schemas/errors/advancedError.yml
new file mode 100644
index 0000000..df9239f
--- /dev/null
+++ b/2.0/openapi/sources/schemas/errors/advancedError.yml
@@ -0,0 +1,30 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+properties:
+ status:
+ type: integer
+ description: The HTTP status of the error
+ error:
+ type: string
+ description: The error code of the occurred exception
+ message:
+ type: string
+ description: The message of the error - what went wrong
+ description:
+ type: string
+ description: A description how to fix the error or more details
+ href:
+ type: string
+ description: A link to further information about the error and how to fix it
+required:
+ - status
+ - error
+ - message
\ No newline at end of file
diff --git a/2.0/openapi/sources/schemas/errors/error.yml b/2.0/openapi/sources/schemas/errors/error.yml
new file mode 100644
index 0000000..bd4150f
--- /dev/null
+++ b/2.0/openapi/sources/schemas/errors/error.yml
@@ -0,0 +1,26 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+properties:
+ status:
+ type: integer
+ description: The HTTP status of the error
+ message:
+ type: string
+ description: The message of the error - what went wrong
+ description:
+ type: string
+ description: A description how to fix the error or more details
+ href:
+ type: string
+ description: A link to further information about the error and how to fix it
+required:
+ - status
+ - message
\ No newline at end of file
diff --git a/2.0/openapi/sources/schemas/features/feature.yml b/2.0/openapi/sources/schemas/features/feature.yml
new file mode 100644
index 0000000..6fb6759
--- /dev/null
+++ b/2.0/openapi/sources/schemas/features/feature.yml
@@ -0,0 +1,18 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+type: object
+properties:
+ definition:
+ $ref: "featureDefinition.yml"
+ properties:
+ $ref: "featureProperties.yml"
+ desiredProperties:
+ $ref: "featureDesiredProperties.yml"
\ No newline at end of file
diff --git a/2.0/openapi/sources/schemas/features/featureDefinition.yml b/2.0/openapi/sources/schemas/features/featureDefinition.yml
new file mode 100644
index 0000000..fe35b7b
--- /dev/null
+++ b/2.0/openapi/sources/schemas/features/featureDefinition.yml
@@ -0,0 +1,16 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+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'"
+ pattern: ([_a-zA-Z0-9\-.]+):([_a-zA-Z0-9\-.]+):([_a-zA-Z0-9\-.]+)
\ No newline at end of file
diff --git a/2.0/openapi/sources/schemas/features/featureDesiredProperties.yml b/2.0/openapi/sources/schemas/features/featureDesiredProperties.yml
new file mode 100644
index 0000000..2a08d3e
--- /dev/null
+++ b/2.0/openapi/sources/schemas/features/featureDesiredProperties.yml
@@ -0,0 +1,12 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+type: object
+description: An arbitrary JSON object describing the desired properties of a feature.
\ No newline at end of file
diff --git a/2.0/openapi/sources/schemas/features/featureProperties.yml b/2.0/openapi/sources/schemas/features/featureProperties.yml
new file mode 100644
index 0000000..b695dc9
--- /dev/null
+++ b/2.0/openapi/sources/schemas/features/featureProperties.yml
@@ -0,0 +1,12 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+type: object
+description: An arbitrary JSON object describing the properties of a feature.
\ No newline at end of file
diff --git a/2.0/openapi/sources/schemas/features/features.yml b/2.0/openapi/sources/schemas/features/features.yml
new file mode 100644
index 0000000..bcb9f52
--- /dev/null
+++ b/2.0/openapi/sources/schemas/features/features.yml
@@ -0,0 +1,16 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+type: object
+description: |-
+ List of features where the key represents the `featureId` of each feature.
+ The `featureId` key must be unique in the list.
+additionalProperties:
+ $ref: 'feature.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/schemas/policies/newPolicy.yml b/2.0/openapi/sources/schemas/policies/newPolicy.yml
new file mode 100644
index 0000000..bb9aabd
--- /dev/null
+++ b/2.0/openapi/sources/schemas/policies/newPolicy.yml
@@ -0,0 +1,17 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+type: object
+description: Policy consisting of policy entries
+properties:
+ entries:
+ $ref: 'policyEntries.yml'
+required:
+ - entries
\ No newline at end of file
diff --git a/2.0/openapi/sources/schemas/policies/permission.yml b/2.0/openapi/sources/schemas/policies/permission.yml
new file mode 100644
index 0000000..7cdda74
--- /dev/null
+++ b/2.0/openapi/sources/schemas/policies/permission.yml
@@ -0,0 +1,15 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+type: string
+description: A Permission allows a certain action on an entity
+enum:
+ - READ
+ - WRITE
\ No newline at end of file
diff --git a/2.0/openapi/sources/schemas/policies/policy.yml b/2.0/openapi/sources/schemas/policies/policy.yml
new file mode 100644
index 0000000..7b1e8db
--- /dev/null
+++ b/2.0/openapi/sources/schemas/policies/policy.yml
@@ -0,0 +1,21 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+type: object
+description: Policy consisting of policy entries
+properties:
+ policyId:
+ type: string
+ description: Unique identifier representing the policy
+ entries:
+ $ref: 'policyEntries.yml'
+required:
+ - policyId
+ - entries
\ No newline at end of file
diff --git a/2.0/openapi/sources/schemas/policies/policyEntries.yml b/2.0/openapi/sources/schemas/policies/policyEntries.yml
new file mode 100644
index 0000000..382fb64
--- /dev/null
+++ b/2.0/openapi/sources/schemas/policies/policyEntries.yml
@@ -0,0 +1,17 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+type: object
+description: Policy entries containing one policy entry for each arbitrary `label` key
+properties:
+ label1:
+ $ref: 'policyEntry.yml'
+ labelN:
+ $ref: 'policyEntry.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/schemas/policies/policyEntry.yml b/2.0/openapi/sources/schemas/policies/policyEntry.yml
new file mode 100644
index 0000000..226d776
--- /dev/null
+++ b/2.0/openapi/sources/schemas/policies/policyEntry.yml
@@ -0,0 +1,20 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+type: object
+description: Single policy entry containing Subjects and Resources.
+properties:
+ subjects:
+ $ref: 'subjects.yml'
+ resources:
+ $ref: 'resources.yml'
+required:
+ - subjects
+ - resources
\ No newline at end of file
diff --git a/2.0/openapi/sources/schemas/policies/resourceEntry.yml b/2.0/openapi/sources/schemas/policies/resourceEntry.yml
new file mode 100644
index 0000000..d797daa
--- /dev/null
+++ b/2.0/openapi/sources/schemas/policies/resourceEntry.yml
@@ -0,0 +1,23 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+type: object
+description: |-
+ Single (Authorization) Resource entry defining permissions per effect.
+ Allowed effects are `grant` and `revoke`.
+properties:
+ grant:
+ type: array
+ items:
+ $ref: 'permission.yml'
+ revoke:
+ type: array
+ items:
+ $ref: 'permission.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/schemas/policies/resources.yml b/2.0/openapi/sources/schemas/policies/resources.yml
new file mode 100644
index 0000000..d568626
--- /dev/null
+++ b/2.0/openapi/sources/schemas/policies/resources.yml
@@ -0,0 +1,36 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+type: object
+description: |-
+ (Authorization) Resources containing one ResourceEntry for each
+ `type:path` key, `type` being one of the following `thing`, `policy`, `message`.
+additionalProperties:
+ $ref: 'resourceEntry.yml'
+example:
+ 'thing:/':
+ grant:
+ - READ
+ - WRITE
+ revoke:
+ 'thing:/attributes/some/path':
+ grant:
+ revoke:
+ - READ
+ 'policy:/':
+ grant:
+ - READ
+ - WRITE
+ revoke:
+ 'message:/':
+ grant:
+ - READ
+ - WRITE
+ revoke:
\ No newline at end of file
diff --git a/2.0/openapi/sources/schemas/policies/subjectAnnouncement.yml b/2.0/openapi/sources/schemas/policies/subjectAnnouncement.yml
new file mode 100644
index 0000000..0552768
--- /dev/null
+++ b/2.0/openapi/sources/schemas/policies/subjectAnnouncement.yml
@@ -0,0 +1,24 @@
+# Copyright (c) 2021 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+type: object
+description: Settings for announcements to be made about the subject.
+properties:
+ beforeExpiry:
+ type: string
+ description: |-
+ The duration before expiry when an announcement should be made.
+ Must be a positive integer followed by one of `h` (hour), `m` (minute) or `s` (second).
+ whenDeleted:
+ type: boolean
+ description: Whether an announcement should be made when this subject is deleted.
+example:
+ beforeExpiry: "5m"
+ whenDeleted: true
\ No newline at end of file
diff --git a/2.0/openapi/sources/schemas/policies/subjectEntry.yml b/2.0/openapi/sources/schemas/policies/subjectEntry.yml
new file mode 100644
index 0000000..bd9b310
--- /dev/null
+++ b/2.0/openapi/sources/schemas/policies/subjectEntry.yml
@@ -0,0 +1,30 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+type: object
+description: Single (Authorization) Subject entry holding its type.
+required:
+ - type
+properties:
+ type:
+ type: string
+ 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.
+ expiry:
+ type: string
+ description: The optional expiry timestamp (formatted in ISO-8601) indicates how long this subject should be considered active before it is automatically deleted from the Policy.
+ format: date-time
+ announcement:
+ $ref: 'subjectAnnouncement.yml'
+example:
+ type: "This is some description for this subject, adjust as needed."
+ expiry: "2020-12-07T11:36:40Z"
+ announcement:
+ beforeExpiry: "5m"
+ whenDeleted: true
diff --git a/2.0/openapi/sources/schemas/policies/subjects.yml b/2.0/openapi/sources/schemas/policies/subjects.yml
new file mode 100644
index 0000000..97bf2ef
--- /dev/null
+++ b/2.0/openapi/sources/schemas/policies/subjects.yml
@@ -0,0 +1,18 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+type: object
+description: |-
+ A SubjectEntry defines who is addressed.
+properties:
+ 'nginx:subjectId1':
+ $ref: 'subjectEntry.yml'
+ 'nginx:subjectIdN':
+ $ref: 'subjectEntry.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/schemas/search/searchResultThings.yml b/2.0/openapi/sources/schemas/search/searchResultThings.yml
new file mode 100644
index 0000000..ee90022
--- /dev/null
+++ b/2.0/openapi/sources/schemas/search/searchResultThings.yml
@@ -0,0 +1,17 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+properties:
+ items:
+ type: array
+ items:
+ $ref: '../things/thing.yml'
+ cursor:
+ type: string
\ No newline at end of file
diff --git a/2.0/openapi/sources/schemas/things/attributes.yml b/2.0/openapi/sources/schemas/things/attributes.yml
new file mode 100644
index 0000000..76f5c6e
--- /dev/null
+++ b/2.0/openapi/sources/schemas/things/attributes.yml
@@ -0,0 +1,12 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+type: object
+description: An arbitrary JSON object describing the attributes of a thing.
\ No newline at end of file
diff --git a/2.0/openapi/sources/schemas/things/definition.yml b/2.0/openapi/sources/schemas/things/definition.yml
new file mode 100644
index 0000000..82c8570
--- /dev/null
+++ b/2.0/openapi/sources/schemas/things/definition.yml
@@ -0,0 +1,13 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+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\-.]+)
\ No newline at end of file
diff --git a/2.0/openapi/sources/schemas/things/newThing.yml b/2.0/openapi/sources/schemas/things/newThing.yml
new file mode 100644
index 0000000..2de557a
--- /dev/null
+++ b/2.0/openapi/sources/schemas/things/newThing.yml
@@ -0,0 +1,57 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+type: object
+properties:
+ _policy:
+ allOf:
+ - $ref: "../policies/policy.yml"
+ 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. The
+ caller needs to have READ and WRITE<sup>*</sup> access to the policy.
+ * 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. The caller needs to have READ access to the thing and READ and WRITE<sup>*</sup>
+ access to the policy of the thing.
+
+
+ <sup>*</sup> The check for WRITE permission avoids locking yourself out of the newly created policy. You can
+ bypass this check by setting the header `allowPolicyLockout` to `true`. Be aware that the authorized
+ subject cannot modify the policy if you do not assign WRITE permission on the policy resource!
+
+ 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
+ resource `/policies/{policyId}`.
+ definition:
+ $ref: 'definition.yml'
+ attributes:
+ $ref: 'attributes.yml'
+ features:
+ $ref: '../features/features.yml'
+required:
+ - policyId
\ No newline at end of file
diff --git a/2.0/openapi/sources/schemas/things/patchThing.yml b/2.0/openapi/sources/schemas/things/patchThing.yml
new file mode 100644
index 0000000..34514c0
--- /dev/null
+++ b/2.0/openapi/sources/schemas/things/patchThing.yml
@@ -0,0 +1,27 @@
+# Copyright (c) 2021 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+type: object
+properties:
+ thingId:
+ type: string
+ description: Unique identifier representing the thing
+ policyId:
+ type: string
+ description: 'The ID of the policy which controls the access to this thing. policies are managed by resource `/policies/{policyId}`'
+ definition:
+ $ref: 'definition.yml'
+ attributes:
+ $ref: 'attributes.yml'
+ features:
+ $ref: '../features/features.yml'
+required:
+ - thingId
+ - policyId
\ No newline at end of file
diff --git a/2.0/openapi/sources/schemas/things/thing.yml b/2.0/openapi/sources/schemas/things/thing.yml
new file mode 100644
index 0000000..23e3c8c
--- /dev/null
+++ b/2.0/openapi/sources/schemas/things/thing.yml
@@ -0,0 +1,46 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+type: object
+properties:
+ thingId:
+ type: string
+ description: Unique identifier representing the thing
+ policyId:
+ type: string
+ description: The ID of the policy which controls the access to this thing. policies are managed by resource `/policies/{policyId}`
+ definition:
+ $ref: 'definition.yml'
+ attributes:
+ $ref: 'attributes.yml'
+ features:
+ $ref: '../features/features.yml'
+ _revision:
+ type: string
+ description: |-
+ _(read-only)_ The revision is a counter which is incremented on each modification of a Thing. This field
+ is not returned by default but must be selected explicitly.
+ _created:
+ type: string
+ description: |-
+ _(read-only)_ The created timestamp of the Thing in ISO-8601 UTC format. The timestamp is set on creation
+ of a Thing. This field is not returned by default but must be selected explicitly.
+ _modified:
+ type: string
+ description: |-
+ _(read-only)_ The modified timestamp of the Thing in ISO-8601 UTC format. The timestamp is set on each
+ modification of a Thing. This field is not returned by default but must be selected explicitly.
+ _metadata:
+ type: object
+ description: |-
+ _(read-only)_ The Metadata of the Thing. This field is not returned by default but must be selected explicitly.
+required:
+ - thingId
+ - policyId
\ No newline at end of file
diff --git a/2.0/openapi/sources/schemas/whoami/whoami.yml b/2.0/openapi/sources/schemas/whoami/whoami.yml
new file mode 100644
index 0000000..02253e1
--- /dev/null
+++ b/2.0/openapi/sources/schemas/whoami/whoami.yml
@@ -0,0 +1,20 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+type: object
+description: |-
+ Contains information about the current user and the auth subjects available for the used authentication.
+properties:
+ defaultSubject:
+ $ref: 'whoamiSubject.yml'
+ subjects:
+ type: array
+ items:
+ $ref: 'whoamiSubject.yml'
\ No newline at end of file
diff --git a/2.0/openapi/sources/schemas/whoami/whoamiSubject.yml b/2.0/openapi/sources/schemas/whoami/whoamiSubject.yml
new file mode 100644
index 0000000..a27197f
--- /dev/null
+++ b/2.0/openapi/sources/schemas/whoami/whoamiSubject.yml
@@ -0,0 +1,12 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+type: string
+description: An auth subject that can be used to provide access for a caller (e.g. in subject entries of policies).
\ No newline at end of file
diff --git a/2.0/openapi/sources/security/bearerAuth.yml b/2.0/openapi/sources/security/bearerAuth.yml
new file mode 100644
index 0000000..bf54a0c
--- /dev/null
+++ b/2.0/openapi/sources/security/bearerAuth.yml
@@ -0,0 +1,15 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+type: http
+scheme: bearer
+bearerFormat: JWT
+description: |-
+ A JSON Web Token issued by a supported OAuth 2.0 Identity Provider.
\ No newline at end of file
diff --git a/2.0/openapi/sources/security/google.yml b/2.0/openapi/sources/security/google.yml
new file mode 100644
index 0000000..4e40003
--- /dev/null
+++ b/2.0/openapi/sources/security/google.yml
@@ -0,0 +1,20 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+type: oauth2
+description: |-
+ Allow Eclipse Ditto to perform OAuth2.0 based authentication accessing your Google-ID.
+x-tokenName: id_token
+flows:
+ authorizationCode:
+ authorizationUrl: 'https://accounts.google.com/o/oauth2/v2/auth'
+ tokenUrl: /oauth2/google/token
+ scopes:
+ openid: Access your Google-ID
\ No newline at end of file
diff --git a/2.0/openapi/sources/security/nginxBasic.yml b/2.0/openapi/sources/security/nginxBasic.yml
new file mode 100644
index 0000000..d5442a6
--- /dev/null
+++ b/2.0/openapi/sources/security/nginxBasic.yml
@@ -0,0 +1,14 @@
+# Copyright (c) 2020 Contributors to the Eclipse Foundation
+#
+# See the NOTICE file(s) distributed with this work for additional
+# information regarding copyright ownership.
+#
+# This program and the accompanying materials are made available under the
+# terms of the Eclipse Public License 2.0 which is available at
+# http://www.eclipse.org/legal/epl-2.0
+#
+# SPDX-License-Identifier: EPL-2.0
+type: http
+description: |-
+ Eclipse Ditto sandbox demo user (demo1 ... demo9) + password (demo)
+scheme: basic
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/announcements/subjectDeletion.md b/2.0/pages/ditto/protocol/examples/policies/generated/announcements/subjectDeletion.md
new file mode 100644
index 0000000..31a02d7
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/announcements/subjectDeletion.md
@@ -0,0 +1,18 @@
+## SubjectDeletionAnnouncement
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/announcements/subjectDeletion",
+ "headers": {
+ "correlation-id": "<some-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "deleteAt": "2021-03-03T16:05:55Z",
+ "subjectIds": [
+ "integration:some-label:my-aud-1",
+ "integration:some-label:my-aud-2"
+ ]
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/createpolicy.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/createpolicy.md
new file mode 100644
index 0000000..44fce9e
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/createpolicy.md
@@ -0,0 +1,32 @@
+## CreatePolicy
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/create",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "policyId": "org.eclipse.ditto:the_policy_id",
+ "entries": {
+ "the_label": {
+ "subjects": {
+ "google:the_subjectid": {
+ "type": "yourSubjectTypeDescription"
+ }
+ },
+ "resources": {
+ "thing:/the_resource_path": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ }
+ }
+ }
+ }
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/createpolicyresponse.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/createpolicyresponse.md
new file mode 100644
index 0000000..bbe10f3
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/createpolicyresponse.md
@@ -0,0 +1,33 @@
+## CreatePolicyResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/create",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "policyId": "org.eclipse.ditto:the_policy_id",
+ "entries": {
+ "the_label": {
+ "subjects": {
+ "google:the_subjectid": {
+ "type": "yourSubjectTypeDescription"
+ }
+ },
+ "resources": {
+ "thing:/the_resource_path": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ }
+ }
+ }
+ }
+ },
+ "status": 201
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/deletepolicy.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/deletepolicy.md
new file mode 100644
index 0000000..410b683
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/deletepolicy.md
@@ -0,0 +1,11 @@
+## DeletePolicy
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/delete",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/deletepolicyentry.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/deletepolicyentry.md
new file mode 100644
index 0000000..a8d8921
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/deletepolicyentry.md
@@ -0,0 +1,11 @@
+## DeletePolicyEntry
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/delete",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/entries/the_label"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/deletepolicyentryresponse.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/deletepolicyentryresponse.md
new file mode 100644
index 0000000..5a57cae
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/deletepolicyentryresponse.md
@@ -0,0 +1,12 @@
+## DeletePolicyEntryResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/delete",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/entries/the_label",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/deletepolicyresponse.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/deletepolicyresponse.md
new file mode 100644
index 0000000..c9c59c3
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/deletepolicyresponse.md
@@ -0,0 +1,12 @@
+## DeletePolicyResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/delete",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/deleteresource.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/deleteresource.md
new file mode 100644
index 0000000..bb2482b
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/deleteresource.md
@@ -0,0 +1,11 @@
+## DeleteResource
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/delete",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/entries/the_label/resources/thing:/the_resource_path"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/deleteresourceresponse.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/deleteresourceresponse.md
new file mode 100644
index 0000000..cdcf21b
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/deleteresourceresponse.md
@@ -0,0 +1,12 @@
+## DeleteResourceResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/delete",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/entries/the_label/resources/thing:/the_resource_path",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/deletesubject.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/deletesubject.md
new file mode 100644
index 0000000..ccc9da9
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/deletesubject.md
@@ -0,0 +1,11 @@
+## DeleteSubject
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/delete",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/entries/the_label/subjects/google:the_subjectid"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/deletesubjectresponse.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/deletesubjectresponse.md
new file mode 100644
index 0000000..777d795
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/deletesubjectresponse.md
@@ -0,0 +1,12 @@
+## DeleteSubjectResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/delete",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/entries/the_label/subjects/google:the_subjectid",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicy.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicy.md
new file mode 100644
index 0000000..8a7059e
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicy.md
@@ -0,0 +1,32 @@
+## ModifyPolicy
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/modify",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "policyId": "org.eclipse.ditto:the_policy_id",
+ "entries": {
+ "the_label": {
+ "subjects": {
+ "google:the_subjectid": {
+ "type": "yourSubjectTypeDescription"
+ }
+ },
+ "resources": {
+ "thing:/the_resource_path": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ }
+ }
+ }
+ }
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentries.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentries.md
new file mode 100644
index 0000000..3848a4d
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentries.md
@@ -0,0 +1,51 @@
+## ModifyPolicyEntries
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/modify",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/entries",
+ "value": {
+ "another_label": {
+ "__schemaVersion": 2,
+ "subjects": {
+ "google:the_subjectid": {
+ "__schemaVersion": 2,
+ "type": "yourSubjectTypeDescription"
+ }
+ },
+ "resources": {
+ "thing:/the_resource_path": {
+ "__schemaVersion": 2,
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ }
+ }
+ },
+ "the_label": {
+ "__schemaVersion": 2,
+ "subjects": {
+ "google:the_subjectid": {
+ "__schemaVersion": 2,
+ "type": "yourSubjectTypeDescription"
+ }
+ },
+ "resources": {
+ "thing:/the_resource_path": {
+ "__schemaVersion": 2,
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ }
+ }
+ }
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentriesresponse.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentriesresponse.md
new file mode 100644
index 0000000..33d8804
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentriesresponse.md
@@ -0,0 +1,12 @@
+## ModifyPolicyEntriesResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/entries",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentry.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentry.md
new file mode 100644
index 0000000..97eceb1
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentry.md
@@ -0,0 +1,29 @@
+## ModifyPolicyEntry
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/modify",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/entries/the_label",
+ "value": {
+ "subjects": {
+ "google:the_subjectid": {
+ "__schemaVersion": 2,
+ "type": "yourSubjectTypeDescription"
+ }
+ },
+ "resources": {
+ "thing:/the_resource_path": {
+ "__schemaVersion": 2,
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ }
+ }
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentryresponse.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentryresponse.md
new file mode 100644
index 0000000..0c710a7
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentryresponse.md
@@ -0,0 +1,12 @@
+## ModifyPolicyEntryResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/entries/the_label",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentryresponsecreated.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentryresponsecreated.md
new file mode 100644
index 0000000..ee0869c
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyentryresponsecreated.md
@@ -0,0 +1,28 @@
+## ModifyPolicyEntryResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/entries/the_label",
+ "value": {
+ "subjects": {
+ "google:the_subjectid": {
+ "type": "yourSubjectTypeDescription"
+ }
+ },
+ "resources": {
+ "thing:/the_resource_path": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ }
+ }
+ },
+ "status": 201
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyresponse.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyresponse.md
new file mode 100644
index 0000000..91a327d
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyresponse.md
@@ -0,0 +1,12 @@
+## ModifyPolicyResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyresponsecreated.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyresponsecreated.md
new file mode 100644
index 0000000..80fafa2
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifypolicyresponsecreated.md
@@ -0,0 +1,33 @@
+## ModifyPolicyResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "policyId": "org.eclipse.ditto:the_policy_id",
+ "entries": {
+ "the_label": {
+ "subjects": {
+ "google:the_subjectid": {
+ "type": "yourSubjectTypeDescription"
+ }
+ },
+ "resources": {
+ "thing:/the_resource_path": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ }
+ }
+ }
+ }
+ },
+ "status": 201
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresource.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresource.md
new file mode 100644
index 0000000..a83cc93
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresource.md
@@ -0,0 +1,18 @@
+## ModifyResource
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/modify",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/entries/the_label/resources/thing:/the_resource_path",
+ "value": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresourceresponse.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresourceresponse.md
new file mode 100644
index 0000000..1f800ba
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresourceresponse.md
@@ -0,0 +1,12 @@
+## ModifyResourceResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/entries/the_label/resources/thing:/the_resource_path",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresourceresponsecreated.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresourceresponsecreated.md
new file mode 100644
index 0000000..d235607
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresourceresponsecreated.md
@@ -0,0 +1,19 @@
+## ModifyResourceResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/entries/the_label/resources/thing:/the_resource_path",
+ "value": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ },
+ "status": 201
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresources.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresources.md
new file mode 100644
index 0000000..eea30e8
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresources.md
@@ -0,0 +1,21 @@
+## ModifyResources
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/modify",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/entries/the_label/resources",
+ "value": {
+ "thing:/the_resource_path": {
+ "__schemaVersion": 2,
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ }
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresourcesresponse.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresourcesresponse.md
new file mode 100644
index 0000000..83477a2
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifyresourcesresponse.md
@@ -0,0 +1,12 @@
+## ModifyResourcesResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/entries/the_label/resources",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubject.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubject.md
new file mode 100644
index 0000000..2e23086
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubject.md
@@ -0,0 +1,14 @@
+## ModifySubject
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/modify",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/entries/the_label/subjects/google:the_subjectid",
+ "value": {
+ "type": "yourSubjectTypeDescription"
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubjectresponse.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubjectresponse.md
new file mode 100644
index 0000000..516d8f2
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubjectresponse.md
@@ -0,0 +1,12 @@
+## ModifySubjectResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/entries/the_label/subjects/google:the_subjectid",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubjectresponsecreated.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubjectresponsecreated.md
new file mode 100644
index 0000000..55a9f41
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubjectresponsecreated.md
@@ -0,0 +1,15 @@
+## ModifySubjectResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/entries/the_label/subjects/google:the_subjectid",
+ "value": {
+ "type": "yourSubjectTypeDescription"
+ },
+ "status": 201
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubjects.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubjects.md
new file mode 100644
index 0000000..d568525
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubjects.md
@@ -0,0 +1,17 @@
+## ModifySubjects
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/modify",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/entries/the_label/subjects",
+ "value": {
+ "google:the_subjectid": {
+ "__schemaVersion": 2,
+ "type": "yourSubjectTypeDescription"
+ }
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubjectsresponse.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubjectsresponse.md
new file mode 100644
index 0000000..2d0f30a
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/modify/modifysubjectsresponse.md
@@ -0,0 +1,12 @@
+## ModifySubjectsResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/entries/the_label/subjects",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicy.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicy.md
new file mode 100644
index 0000000..d5b9aa1
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicy.md
@@ -0,0 +1,11 @@
+## RetrievePolicy
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/retrieve",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyentries.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyentries.md
new file mode 100644
index 0000000..57d3bdb
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyentries.md
@@ -0,0 +1,11 @@
+## RetrievePolicyEntries
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/retrieve",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/entries"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyentriesresponse.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyentriesresponse.md
new file mode 100644
index 0000000..2b6a1d3
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyentriesresponse.md
@@ -0,0 +1,46 @@
+## RetrievePolicyEntriesResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/retrieve",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/entries",
+ "value": {
+ "another_label": {
+ "subjects": {
+ "google:the_subjectid": {
+ "type": "yourSubjectTypeDescription"
+ }
+ },
+ "resources": {
+ "thing:/the_resource_path": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ }
+ }
+ },
+ "the_label": {
+ "subjects": {
+ "google:the_subjectid": {
+ "type": "yourSubjectTypeDescription"
+ }
+ },
+ "resources": {
+ "thing:/the_resource_path": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ }
+ }
+ }
+ },
+ "status": 200
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyentry.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyentry.md
new file mode 100644
index 0000000..d3d87ac
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyentry.md
@@ -0,0 +1,11 @@
+## RetrievePolicyEntry
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/retrieve",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/entries/the_label"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyentryresponse.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyentryresponse.md
new file mode 100644
index 0000000..f9253a4
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyentryresponse.md
@@ -0,0 +1,28 @@
+## RetrievePolicyEntryResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/retrieve",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/entries/the_label",
+ "value": {
+ "subjects": {
+ "google:the_subjectid": {
+ "type": "yourSubjectTypeDescription"
+ }
+ },
+ "resources": {
+ "thing:/the_resource_path": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ }
+ }
+ },
+ "status": 200
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyresponse.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyresponse.md
new file mode 100644
index 0000000..5cdefb6
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievepolicyresponse.md
@@ -0,0 +1,33 @@
+## RetrievePolicyResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/retrieve",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "policyId": "org.eclipse.ditto:the_policy_id",
+ "entries": {
+ "the_label": {
+ "subjects": {
+ "google:the_subjectid": {
+ "type": "yourSubjectTypeDescription"
+ }
+ },
+ "resources": {
+ "thing:/the_resource_path": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ }
+ }
+ }
+ }
+ },
+ "status": 200
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrieveresource.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrieveresource.md
new file mode 100644
index 0000000..2ca037e
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrieveresource.md
@@ -0,0 +1,11 @@
+## RetrieveResource
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/retrieve",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/entries/the_label/resources/thing:/the_resource_path"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrieveresourceresponse.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrieveresourceresponse.md
new file mode 100644
index 0000000..f065800
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrieveresourceresponse.md
@@ -0,0 +1,19 @@
+## RetrieveResourceResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/retrieve",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/entries/the_label/resources/thing:/the_resource_path",
+ "value": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ },
+ "status": 200
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrieveresources.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrieveresources.md
new file mode 100644
index 0000000..80e72d1
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrieveresources.md
@@ -0,0 +1,11 @@
+## RetrieveResources
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/retrieve",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/entries/the_label/resources"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrieveresourcesresponse.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrieveresourcesresponse.md
new file mode 100644
index 0000000..e76a3f9
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrieveresourcesresponse.md
@@ -0,0 +1,21 @@
+## RetrieveResourcesResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/retrieve",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/entries/the_label/resources",
+ "value": {
+ "thing:/the_resource_path": {
+ "grant": [
+ "READ",
+ "WRITE"
+ ],
+ "revoke": []
+ }
+ },
+ "status": 200
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievesubject.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievesubject.md
new file mode 100644
index 0000000..f3b1e17
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievesubject.md
@@ -0,0 +1,11 @@
+## RetrieveSubject
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/retrieve",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/entries/the_label/subjects/google:the_subjectid"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievesubjectresponse.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievesubjectresponse.md
new file mode 100644
index 0000000..bdf875d
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievesubjectresponse.md
@@ -0,0 +1,15 @@
+## RetrieveSubjectResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/retrieve",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/entries/the_label/subjects/google:the_subjectid",
+ "value": {
+ "type": "yourSubjectTypeDescription"
+ },
+ "status": 200
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievesubjects.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievesubjects.md
new file mode 100644
index 0000000..af8ccc8
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievesubjects.md
@@ -0,0 +1,11 @@
+## RetrieveSubjects
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/retrieve",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/entries/the_label/subjects"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievesubjectsresponse.md b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievesubjectsresponse.md
new file mode 100644
index 0000000..3d53028
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/commands/query/retrievesubjectsresponse.md
@@ -0,0 +1,17 @@
+## RetrieveSubjectsResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/commands/retrieve",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/entries/the_label/subjects",
+ "value": {
+ "google:the_subjectid": {
+ "type": "yourSubjectTypeDescription"
+ }
+ },
+ "status": 200
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_entry_invalid.md b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_entry_invalid.md
new file mode 100644
index 0000000..352643a
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_entry_invalid.md
@@ -0,0 +1,18 @@
+## policies:entry.invalid
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 400,
+ "error": "policies:entry.invalid",
+ "message": "The Policy Entry is invalid.",
+ "description": "Policy entry does not contain any known permission like 'READ' or 'WRITE'"
+ },
+ "status": 400
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_entry_modificationinvalid.md b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_entry_modificationinvalid.md
new file mode 100644
index 0000000..228d894
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_entry_modificationinvalid.md
@@ -0,0 +1,18 @@
+## policies:entry.modificationinvalid
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 403,
+ "error": "policies:entry.modificationinvalid",
+ "message": "The PolicyEntry with Label 'the_label' on the Policy with ID 'org.eclipse.ditto:the_policy_id' could not be modified as the resulting Policy would be invalid.",
+ "description": "There must always be at least one PolicyEntry with 'WRITE' permissions on resource 'policy:/'."
+ },
+ "status": 403
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_entry_notfound.md b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_entry_notfound.md
new file mode 100644
index 0000000..e5e4645
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_entry_notfound.md
@@ -0,0 +1,18 @@
+## policies:entry.notfound
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 404,
+ "error": "policies:entry.notfound",
+ "message": "The PolicyEntry with Label 'the_label' on the Policy with ID 'org.eclipse.ditto:the_policy_id' could not be found or requester had insufficient permissions to access it.",
+ "description": "Check if the ID of the Policy and the Label of your requested PolicyEntry was correct and you have sufficient permissions."
+ },
+ "status": 404
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_entry_notmodifiable.md b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_entry_notmodifiable.md
new file mode 100644
index 0000000..c9dc4d3
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_entry_notmodifiable.md
@@ -0,0 +1,18 @@
+## policies:entry.notmodifiable
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 403,
+ "error": "policies:entry.notmodifiable",
+ "message": "The PolicyEntry with Label 'the_label' on the Policy with ID 'org.eclipse.ditto:the_policy_id' could not be modified as the requester had insufficient permissions.",
+ "description": "Check if the ID of the Policy and the Label of your requested PolicyEntry was correct and you have sufficient permissions."
+ },
+ "status": 403
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_id_invalid.md b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_id_invalid.md
new file mode 100644
index 0000000..1e3d24f
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_id_invalid.md
@@ -0,0 +1,19 @@
+## policies:id.invalid
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 400,
+ "error": "policies:id.invalid",
+ "message": "Policy ID 'invalid id' is not valid!",
+ "description": "It must conform to the namespaced entity ID notation (see Ditto documentation)",
+ "href": "https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id"
+ },
+ "status": 400
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_conflict.md b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_conflict.md
new file mode 100644
index 0000000..4d6f979
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_conflict.md
@@ -0,0 +1,18 @@
+## policies:policy.conflict
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 409,
+ "error": "policies:policy.conflict",
+ "message": "The Policy with ID 'org.eclipse.ditto:the_policy_id' already exists",
+ "description": "Choose another Policy ID"
+ },
+ "status": 409
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_modificationinvalid.md b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_modificationinvalid.md
new file mode 100644
index 0000000..b822f6a
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_modificationinvalid.md
@@ -0,0 +1,18 @@
+## policies:policy.modificationinvalid
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 403,
+ "error": "policies:policy.modificationinvalid",
+ "message": "The Policy with ID 'org.eclipse.ditto:the_policy_id' could not be modified as the resulting Policy would be invalid.",
+ "description": "There must always be at least one PolicyEntry with 'WRITE' permissions on resource 'policy:/'."
+ },
+ "status": 403
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_notfound.md b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_notfound.md
new file mode 100644
index 0000000..cbca11d
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_notfound.md
@@ -0,0 +1,18 @@
+## policies:policy.notfound
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 404,
+ "error": "policies:policy.notfound",
+ "message": "The Policy with ID 'org.eclipse.ditto:the_policy_id' could not be found or requester had insufficient permissions to access it.",
+ "description": "Check if the ID of your requested Policy was correct and you have sufficient permissions."
+ },
+ "status": 404
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_notmodifiable.md b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_notmodifiable.md
new file mode 100644
index 0000000..a09e0dd
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_notmodifiable.md
@@ -0,0 +1,18 @@
+## policies:policy.notmodifiable
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 403,
+ "error": "policies:policy.notmodifiable",
+ "message": "The Policy with ID 'org.eclipse.ditto:the_policy_id' could not be modified as the requester had insufficient permissions.",
+ "description": "Check if the ID of your requested Policy was correct and you have sufficient permissions."
+ },
+ "status": 403
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_toomanymodifyingrequests.md b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_toomanymodifyingrequests.md
new file mode 100644
index 0000000..19bcc55
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_toomanymodifyingrequests.md
@@ -0,0 +1,18 @@
+## policies:policy.toomanymodifyingrequests
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 429,
+ "error": "policies:policy.toomanymodifyingrequests",
+ "message": "Too many modifying requests are already outstanding to the Policy with ID 'org.eclipse.ditto:the_policy_id'.",
+ "description": "Throttle your modifying requests to the Policy or re-structure your Policy in multiple Policies if you really need so many concurrent modifications."
+ },
+ "status": 429
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_unavailable.md b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_unavailable.md
new file mode 100644
index 0000000..90986d4
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_policy_unavailable.md
@@ -0,0 +1,18 @@
+## policies:policy.unavailable
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 503,
+ "error": "policies:policy.unavailable",
+ "message": "The Policy with ID 'org.eclipse.ditto:the_policy_id' is not available, please try again later.",
+ "description": "The requested Policy is temporarily not available."
+ },
+ "status": 503
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_resource_notfound.md b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_resource_notfound.md
new file mode 100644
index 0000000..7b9e189
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_resource_notfound.md
@@ -0,0 +1,18 @@
+## policies:resource.notfound
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 404,
+ "error": "policies:resource.notfound",
+ "message": "The Resource '/the_resource_path' of the PolicyEntry with Label 'the_label' on the Policy with ID 'org.eclipse.ditto:the_policy_id' could not be found or requester had insufficient permissions to access it.",
+ "description": "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."
+ },
+ "status": 404
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_resource_notmodifiable.md b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_resource_notmodifiable.md
new file mode 100644
index 0000000..aea50da
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_resource_notmodifiable.md
@@ -0,0 +1,18 @@
+## policies:resource.notmodifiable
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 403,
+ "error": "policies:resource.notmodifiable",
+ "message": "The Resource '/the_resource_path' of the PolicyEntry with Label 'the_label' on the Policy with ID 'org.eclipse.ditto:the_policy_id' could not be modified as the requester had insufficient permissions.",
+ "description": "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."
+ },
+ "status": 403
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_resources_notfound.md b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_resources_notfound.md
new file mode 100644
index 0000000..ade92e0
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_resources_notfound.md
@@ -0,0 +1,18 @@
+## policies:resources.notfound
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 404,
+ "error": "policies:resources.notfound",
+ "message": "The Resources of the PolicyEntry with Label 'the_label' on the Policy with ID 'org.eclipse.ditto:the_policy_id' could not be found or requester had insufficient permissions to access it.",
+ "description": "Check if the ID of the Policy and the Label of the PolicyEntry was correct and you have sufficient permissions."
+ },
+ "status": 404
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_resources_notmodifiable.md b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_resources_notmodifiable.md
new file mode 100644
index 0000000..93d6c5d
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_resources_notmodifiable.md
@@ -0,0 +1,18 @@
+## policies:resources.notmodifiable
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 403,
+ "error": "policies:resources.notmodifiable",
+ "message": "The Resources of the PolicyEntry with Label 'the_label' on the Policy with ID 'org.eclipse.ditto:the_policy_id' could not be modified as the requester had insufficient permissions.",
+ "description": "Check if the ID of the Policy and the PolicyEntry's Label of your requested Resources was correct and you have sufficient permissions."
+ },
+ "status": 403
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subject_notfound.md b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subject_notfound.md
new file mode 100644
index 0000000..282cade
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subject_notfound.md
@@ -0,0 +1,18 @@
+## policies:subject.notfound
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 404,
+ "error": "policies:subject.notfound",
+ "message": "The Subject with ID 'google:the_subjectid' of the PolicyEntry with Label 'the_label' on the Policy with ID 'org.eclipse.ditto:the_policy_id' could not be found or requester had insufficient permissions to access it.",
+ "description": "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."
+ },
+ "status": 404
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subject_notmodifiable.md b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subject_notmodifiable.md
new file mode 100644
index 0000000..c637545
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subject_notmodifiable.md
@@ -0,0 +1,18 @@
+## policies:subject.notmodifiable
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 403,
+ "error": "policies:subject.notmodifiable",
+ "message": "The Subject with ID 'google:the_subjectid' of the PolicyEntry with Label 'the_label' on the Policy with ID 'org.eclipse.ditto:the_policy_id' could not be modified as the requester had insufficient permissions.",
+ "description": "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."
+ },
+ "status": 403
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subjectid_invalid.md b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subjectid_invalid.md
new file mode 100644
index 0000000..fb85c35
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subjectid_invalid.md
@@ -0,0 +1,18 @@
+## policies:subjectid.invalid
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 400,
+ "error": "policies:subjectid.invalid",
+ "message": "Subject ID 'invalid subject' is not valid!",
+ "description": "It must contain an issuer as prefix separated by a colon ':' from the actual subject"
+ },
+ "status": 400
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subjects_notfound.md b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subjects_notfound.md
new file mode 100644
index 0000000..4fb0db1
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subjects_notfound.md
@@ -0,0 +1,18 @@
+## policies:subjects.notfound
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 404,
+ "error": "policies:subjects.notfound",
+ "message": "The Subjects of the PolicyEntry with Label 'the_label' on the Policy with ID 'org.eclipse.ditto:the_policy_id' could not be found or requester had insufficient permissions to access it.",
+ "description": "Check if the ID of the Policy and the Label of the PolicyEntry was correct and you have sufficient permissions."
+ },
+ "status": 404
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subjects_notmodifiable.md b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subjects_notmodifiable.md
new file mode 100644
index 0000000..25a403e
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/policies/generated/exceptions/policies_subjects_notmodifiable.md
@@ -0,0 +1,18 @@
+## policies:subjects.notmodifiable
+
+```json
+{
+ "topic": "org.eclipse.ditto/the_policy_id/policies/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 403,
+ "error": "policies:subjects.notmodifiable",
+ "message": "The Subjects of the PolicyEntry with Label 'the_label' on the Policy with ID 'org.eclipse.ditto:the_policy_id' could not be modified as the requester had insufficient permissions.",
+ "description": "Check if the ID of the Policy and the PolicyEntry's Label of your requested Subjects was correct and you have sufficient permissions."
+ },
+ "status": 403
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/search/generated/commands/cancel-subscription-command.md b/2.0/pages/ditto/protocol/examples/search/generated/commands/cancel-subscription-command.md
new file mode 100644
index 0000000..ae8fb14
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/search/generated/commands/cancel-subscription-command.md
@@ -0,0 +1,14 @@
+## CancelSubscription
+
+```json
+{
+ "topic": "_/_/things/twin/search/cancel",
+ "headers": {
+ "content-type": "application/json"
+ },
+ "path": "/",
+ "value": {
+ "subscriptionId": "24601"
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/search/generated/commands/create-subscription-command.md b/2.0/pages/ditto/protocol/examples/search/generated/commands/create-subscription-command.md
new file mode 100644
index 0000000..c3607bc
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/search/generated/commands/create-subscription-command.md
@@ -0,0 +1,20 @@
+## CreateSubscription
+
+```json
+{
+ "topic": "_/_/things/twin/search/subscribe",
+ "headers": {
+ "content-type": "application/json",
+ "correlation-id": "444dae7e-bacf-312b-bc97-8f393dadf1bd"
+ },
+ "path": "/",
+ "value": {
+ "filter": "eq(/attributes/temperature,32)",
+ "options": "size(10),sort(+thingId)",
+ "namespaces": [
+ "org.eclipse.ditto"
+ ]
+ },
+ "fields": "attributes"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/search/generated/commands/request-subscription-command.md b/2.0/pages/ditto/protocol/examples/search/generated/commands/request-subscription-command.md
new file mode 100644
index 0000000..5b2f2ed
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/search/generated/commands/request-subscription-command.md
@@ -0,0 +1,15 @@
+## RequestFromSubscription
+
+```json
+{
+ "topic": "_/_/things/twin/search/request",
+ "headers": {
+ "content-type": "application/json"
+ },
+ "path": "/",
+ "value": {
+ "subscriptionId": "24601",
+ "demand": 3
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/search/generated/events/subscription-complete-event.md b/2.0/pages/ditto/protocol/examples/search/generated/events/subscription-complete-event.md
new file mode 100644
index 0000000..948facb
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/search/generated/events/subscription-complete-event.md
@@ -0,0 +1,14 @@
+## SubscriptionComplete
+
+```json
+{
+ "topic": "_/_/things/twin/search/complete",
+ "headers": {
+ "content-type": "application/json"
+ },
+ "path": "/",
+ "value": {
+ "subscriptionId": "24601"
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/search/generated/events/subscription-created-event.md b/2.0/pages/ditto/protocol/examples/search/generated/events/subscription-created-event.md
new file mode 100644
index 0000000..8317697
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/search/generated/events/subscription-created-event.md
@@ -0,0 +1,15 @@
+## SubscriptionCreated
+
+```json
+{
+ "topic": "_/_/things/twin/search/created",
+ "headers": {
+ "content-type": "application/json",
+ "correlation-id": "444dae7e-bacf-312b-bc97-8f393dadf1bd"
+ },
+ "path": "/",
+ "value": {
+ "subscriptionId": "24601"
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/search/generated/events/subscription-failed-event.md b/2.0/pages/ditto/protocol/examples/search/generated/events/subscription-failed-event.md
new file mode 100644
index 0000000..6a742be
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/search/generated/events/subscription-failed-event.md
@@ -0,0 +1,20 @@
+## SubscriptionFailed
+
+```json
+{
+ "topic": "_/_/things/twin/search/failed",
+ "headers": {
+ "content-type": "application/json"
+ },
+ "path": "/",
+ "value": {
+ "subscriptionId": "24601",
+ "error": {
+ "status": 400,
+ "error": "thing-search:subscription.protocol.error",
+ "message": "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.",
+ "description": "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."
+ }
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/search/generated/events/subscription-has-next-event.md b/2.0/pages/ditto/protocol/examples/search/generated/events/subscription-has-next-event.md
new file mode 100644
index 0000000..17b8a29
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/search/generated/events/subscription-has-next-event.md
@@ -0,0 +1,26 @@
+## SubscriptionNextPage
+
+```json
+{
+ "topic": "_/_/things/twin/search/next",
+ "headers": {
+ "content-type": "application/json"
+ },
+ "path": "/",
+ "value": {
+ "subscriptionId": "24601",
+ "items": [{
+ "thingId": "default:thing1",
+ "attributes": {
+ "temperature": 35
+ }
+ },
+ {
+ "thingId": "default:thing2",
+ "attributes": {
+ "temperature": 35
+ }
+ }]
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/search/generated/exceptions/thing-search_search_option_invalid.md b/2.0/pages/ditto/protocol/examples/search/generated/exceptions/thing-search_search_option_invalid.md
new file mode 100644
index 0000000..eabfbd5
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/search/generated/exceptions/thing-search_search_option_invalid.md
@@ -0,0 +1,17 @@
+## thing-search:search.option.invalid
+
+```json
+{
+ "topic": "_/_/things/search/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 400,
+ "error": "thing-search:search.option.invalid",
+ "description": "At least one provided option is invalid."
+ },
+ "status": 400
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergeattribute.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergeattribute.md
new file mode 100644
index 0000000..d0cbe1d
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergeattribute.md
@@ -0,0 +1,16 @@
+## Merge thing command at /attributes/location
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "content-type": "application/merge-patch+json",
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/attributes/location",
+ "value": {
+ "latitude": 44.673856,
+ "longitude": 8.261719
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergeattributeresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergeattributeresponse.md
new file mode 100644
index 0000000..42a3ccf
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergeattributeresponse.md
@@ -0,0 +1,12 @@
+## Merge thing command response at /attributes/location
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/attributes/location",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergeattributes.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergeattributes.md
new file mode 100644
index 0000000..08ae346
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergeattributes.md
@@ -0,0 +1,18 @@
+## Merge thing command at /attributes
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "content-type": "application/merge-patch+json",
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/attributes",
+ "value": {
+ "location": {
+ "latitude": 44.673856,
+ "longitude": 8.261719
+ }
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergeattributesresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergeattributesresponse.md
new file mode 100644
index 0000000..7eab687
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergeattributesresponse.md
@@ -0,0 +1,12 @@
+## Merge thing command response at /attributes
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/attributes",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeleteattribute.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeleteattribute.md
new file mode 100644
index 0000000..8fdb72f
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeleteattribute.md
@@ -0,0 +1,13 @@
+## Merge thing command deleting /attributes/location
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "content-type": "application/merge-patch+json",
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/attributes/location",
+ "value": null
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeleteattributeresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeleteattributeresponse.md
new file mode 100644
index 0000000..42a3ccf
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeleteattributeresponse.md
@@ -0,0 +1,12 @@
+## Merge thing command response at /attributes/location
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/attributes/location",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeleteattributes.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeleteattributes.md
new file mode 100644
index 0000000..272d7a2
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeleteattributes.md
@@ -0,0 +1,13 @@
+## Merge thing command deleting /attributes
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "content-type": "application/merge-patch+json",
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/attributes",
+ "value": null
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeleteattributesresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeleteattributesresponse.md
new file mode 100644
index 0000000..7eab687
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeleteattributesresponse.md
@@ -0,0 +1,12 @@
+## Merge thing command response at /attributes
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/attributes",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeature.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeature.md
new file mode 100644
index 0000000..a7c7791
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeature.md
@@ -0,0 +1,13 @@
+## Merge thing command deleting /features/accelerometer
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "content-type": "application/merge-patch+json",
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer",
+ "value": null
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeaturedefinition.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeaturedefinition.md
new file mode 100644
index 0000000..98d8a87
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeaturedefinition.md
@@ -0,0 +1,13 @@
+## Merge thing command deleting /features/accelerometer/definition
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "content-type": "application/merge-patch+json",
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer/definition",
+ "value": null
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeaturedefinitionresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeaturedefinitionresponse.md
new file mode 100644
index 0000000..0a2c3f5
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeaturedefinitionresponse.md
@@ -0,0 +1,12 @@
+## Merge thing command response at /features/accelerometer/definition
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/definition",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeaturedesiredproperties.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeaturedesiredproperties.md
new file mode 100644
index 0000000..9af1373
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeaturedesiredproperties.md
@@ -0,0 +1,13 @@
+## Merge thing command deleting /features/accelerometer/desiredProperties
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "content-type": "application/merge-patch+json",
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties",
+ "value": null
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeaturedesiredpropertiesresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeaturedesiredpropertiesresponse.md
new file mode 100644
index 0000000..434c4b9
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeaturedesiredpropertiesresponse.md
@@ -0,0 +1,12 @@
+## Merge thing command response at /features/accelerometer/desiredProperties
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeaturedesiredproperty.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeaturedesiredproperty.md
new file mode 100644
index 0000000..b3cdd95
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeaturedesiredproperty.md
@@ -0,0 +1,13 @@
+## Merge thing command deleting /features/accelerometer/desiredProperties/x
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "content-type": "application/merge-patch+json",
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties/x",
+ "value": null
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeaturedesiredpropertyresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeaturedesiredpropertyresponse.md
new file mode 100644
index 0000000..8d39f51
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeaturedesiredpropertyresponse.md
@@ -0,0 +1,12 @@
+## Merge thing command response at /features/accelerometer/desiredProperties/x
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties/x",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeatureproperties.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeatureproperties.md
new file mode 100644
index 0000000..d340493
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeatureproperties.md
@@ -0,0 +1,13 @@
+## Merge thing command deleting /features/accelerometer/properties
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "content-type": "application/merge-patch+json",
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties",
+ "value": null
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeaturepropertiesresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeaturepropertiesresponse.md
new file mode 100644
index 0000000..4c2d586
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeaturepropertiesresponse.md
@@ -0,0 +1,12 @@
+## Merge thing command response at /features/accelerometer/properties
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeatureproperty.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeatureproperty.md
new file mode 100644
index 0000000..287d4a1
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeatureproperty.md
@@ -0,0 +1,13 @@
+## Merge thing command deleting /features/accelerometer/properties/x
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "content-type": "application/merge-patch+json",
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties/x",
+ "value": null
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeaturepropertyresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeaturepropertyresponse.md
new file mode 100644
index 0000000..8c9810f
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeaturepropertyresponse.md
@@ -0,0 +1,12 @@
+## Merge thing command response at /features/accelerometer/properties/x
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties/x",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeatureresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeatureresponse.md
new file mode 100644
index 0000000..3b7623f
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeatureresponse.md
@@ -0,0 +1,12 @@
+## Merge thing command response at /features/accelerometer
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeatures.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeatures.md
new file mode 100644
index 0000000..5f891f4
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeatures.md
@@ -0,0 +1,13 @@
+## Merge thing command deleting /features
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "content-type": "application/merge-patch+json",
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features",
+ "value": null
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeaturesresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeaturesresponse.md
new file mode 100644
index 0000000..620a5d3
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletefeaturesresponse.md
@@ -0,0 +1,12 @@
+## Merge thing command response at /features
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletethingdefinition.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletethingdefinition.md
new file mode 100644
index 0000000..b23d817
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletethingdefinition.md
@@ -0,0 +1,13 @@
+## Merge thing command deleting /definition
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "content-type": "application/merge-patch+json",
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/definition",
+ "value": null
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletethingdefinitionresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletethingdefinitionresponse.md
new file mode 100644
index 0000000..ca2816b
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergedeletethingdefinitionresponse.md
@@ -0,0 +1,12 @@
+## Merge thing command response at /definition
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/definition",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeature.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeature.md
new file mode 100644
index 0000000..ab66bdd
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeature.md
@@ -0,0 +1,23 @@
+## Merge thing command at /features/accelerometer
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "content-type": "application/merge-patch+json",
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer",
+ "value": {
+ "definition": [
+ "org.eclipse.ditto:accelerometer:1.0.0"
+ ],
+ "properties": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ }
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeaturedefinition.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeaturedefinition.md
new file mode 100644
index 0000000..cb74f80
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeaturedefinition.md
@@ -0,0 +1,15 @@
+## Merge thing command at /features/accelerometer/definition
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "content-type": "application/merge-patch+json",
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer/definition",
+ "value": [
+ "org.eclipse.ditto:accelerometer:1.0.0"
+ ]
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeaturedefinitionresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeaturedefinitionresponse.md
new file mode 100644
index 0000000..0a2c3f5
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeaturedefinitionresponse.md
@@ -0,0 +1,12 @@
+## Merge thing command response at /features/accelerometer/definition
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/definition",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeaturedesiredproperties.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeaturedesiredproperties.md
new file mode 100644
index 0000000..f86c7f4
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeaturedesiredproperties.md
@@ -0,0 +1,18 @@
+## Merge thing command at /features/accelerometer/desiredProperties
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "content-type": "application/merge-patch+json",
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties",
+ "value": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeaturedesiredpropertiesresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeaturedesiredpropertiesresponse.md
new file mode 100644
index 0000000..434c4b9
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeaturedesiredpropertiesresponse.md
@@ -0,0 +1,12 @@
+## Merge thing command response at /features/accelerometer/desiredProperties
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeaturedesiredproperty.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeaturedesiredproperty.md
new file mode 100644
index 0000000..cc4b9b1
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeaturedesiredproperty.md
@@ -0,0 +1,13 @@
+## Merge thing command at /features/accelerometer/desiredProperties/x
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "content-type": "application/merge-patch+json",
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties/x",
+ "value": 42
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeaturedesiredpropertyresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeaturedesiredpropertyresponse.md
new file mode 100644
index 0000000..8d39f51
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeaturedesiredpropertyresponse.md
@@ -0,0 +1,12 @@
+## Merge thing command response at /features/accelerometer/desiredProperties/x
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties/x",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeatureproperties.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeatureproperties.md
new file mode 100644
index 0000000..e3ee21a
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeatureproperties.md
@@ -0,0 +1,18 @@
+## Merge thing command at /features/accelerometer/properties
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "content-type": "application/merge-patch+json",
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties",
+ "value": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeaturepropertiesresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeaturepropertiesresponse.md
new file mode 100644
index 0000000..4c2d586
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeaturepropertiesresponse.md
@@ -0,0 +1,12 @@
+## Merge thing command response at /features/accelerometer/properties
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeatureproperty.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeatureproperty.md
new file mode 100644
index 0000000..d0c5ab6
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeatureproperty.md
@@ -0,0 +1,13 @@
+## Merge thing command at /features/accelerometer/properties/x
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "content-type": "application/merge-patch+json",
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties/x",
+ "value": 42
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeaturepropertyresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeaturepropertyresponse.md
new file mode 100644
index 0000000..8c9810f
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeaturepropertyresponse.md
@@ -0,0 +1,12 @@
+## Merge thing command response at /features/accelerometer/properties/x
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties/x",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeatureresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeatureresponse.md
new file mode 100644
index 0000000..3b7623f
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeatureresponse.md
@@ -0,0 +1,12 @@
+## Merge thing command response at /features/accelerometer
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeatures.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeatures.md
new file mode 100644
index 0000000..7a5c01f
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeatures.md
@@ -0,0 +1,25 @@
+## Merge thing command at /features
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "content-type": "application/merge-patch+json",
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features",
+ "value": {
+ "accelerometer": {
+ "definition": [
+ "org.eclipse.ditto:accelerometer:1.0.0"
+ ],
+ "properties": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ }
+ }
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeaturesresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeaturesresponse.md
new file mode 100644
index 0000000..620a5d3
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergefeaturesresponse.md
@@ -0,0 +1,12 @@
+## Merge thing command response at /features
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergepolicyid.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergepolicyid.md
new file mode 100644
index 0000000..06bb99e
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergepolicyid.md
@@ -0,0 +1,13 @@
+## Merge thing command at /policyId
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "content-type": "application/merge-patch+json",
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/policyId",
+ "value": "org.eclipse.ditto:the_policy_id"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergepolicyidresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergepolicyidresponse.md
new file mode 100644
index 0000000..74f450d
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergepolicyidresponse.md
@@ -0,0 +1,12 @@
+## Merge thing command response at /policyId
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/policyId",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergething.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergething.md
new file mode 100644
index 0000000..314e444
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergething.md
@@ -0,0 +1,36 @@
+## Merge thing command at /
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "content-type": "application/merge-patch+json",
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "thingId": "org.eclipse.ditto:fancy-thing_53",
+ "policyId": "org.eclipse.ditto:the_policy_id",
+ "definition": "org.eclipse.ditto:SomeModel:1.0.0",
+ "attributes": {
+ "location": {
+ "latitude": 44.673856,
+ "longitude": 8.261719
+ }
+ },
+ "features": {
+ "accelerometer": {
+ "definition": [
+ "org.eclipse.ditto:accelerometer:1.0.0"
+ ],
+ "properties": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ }
+ }
+ }
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergethingdefinition.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergethingdefinition.md
new file mode 100644
index 0000000..e213bf9
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergethingdefinition.md
@@ -0,0 +1,13 @@
+## Merge thing command at /definition
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "content-type": "application/merge-patch+json",
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/definition",
+ "value": "org.eclipse.ditto:SomeModel:1.0.0"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergethingdefinitionresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergethingdefinitionresponse.md
new file mode 100644
index 0000000..ca2816b
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergethingdefinitionresponse.md
@@ -0,0 +1,12 @@
+## Merge thing command response at /definition
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/definition",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergethingresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergethingresponse.md
new file mode 100644
index 0000000..555d958
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/merge/mergethingresponse.md
@@ -0,0 +1,12 @@
+## Merge thing command response at /
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/merge",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/creatething.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/creatething.md
new file mode 100644
index 0000000..368b6e9
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/creatething.md
@@ -0,0 +1,37 @@
+## CreateThing
+
+Creates a new Thing with ID ``org.eclipse.ditto:fancy-thing_53`` that uses an existing Policy with ID ``org.eclipse.ditto:the_policy_id``.
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/create",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "thingId": "org.eclipse.ditto:fancy-thing_53",
+ "policyId": "org.eclipse.ditto:the_policy_id",
+ "definition": "org.eclipse.ditto:SomeModel:1.0.0",
+ "attributes": {
+ "location": {
+ "latitude": 44.673856,
+ "longitude": 8.261719
+ }
+ },
+ "features": {
+ "accelerometer": {
+ "properties": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ },
+ "desiredProperties": {
+ "x": 4
+ }
+ }
+ }
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/createthingalternatives.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/createthingalternatives.md
new file mode 100644
index 0000000..55e171a
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/createthingalternatives.md
@@ -0,0 +1,42 @@
+## Alternative CreateThing commands
+
+If you want to copy an existing Policy instead of creating a new one by yourself or reference an existing Policy, you
+can adjust the CreateThing command like demonstrated in the following examples.
+
+### CreateThing with copied Policy by Policy ID
+
+Creates a new Thing with ID ``org.eclipse.ditto:fancy-thing_53`` with a Policy copied from the Policy with ID ``org.eclipse.ditto:the_policy_id_to_copy``.
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/create",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "thingId": "org.eclipse.ditto:fancy-thing_53",
+ "policyId": "org.eclipse.ditto:the_policy_id",
+ "_copyPolicyFrom": "com:acme:the_policy_id_to_copy"
+ }
+}
+```
+
+### CreateThing with copied Policy by Thing reference
+
+Creates a new Thing with ID ``org.eclipse.ditto:fancy-thing_53`` with a Policy copied from a Thing with ID ``org.eclipse.ditto:fancy-thing_52``.
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/create",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "thingId": "org.eclipse.ditto:fancy-thing_53",
+ "policyId": "org.eclipse.ditto:the_policy_id",
+ "_copyPolicyFrom": "{% raw %}{{ ref:things/com:acme:fancy-thing_52/policyId }}{% endraw %}"
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/createthingresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/createthingresponse.md
new file mode 100644
index 0000000..b8eff45
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/createthingresponse.md
@@ -0,0 +1,36 @@
+## CreateThingResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/create",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "thingId": "org.eclipse.ditto:fancy-thing_53",
+ "policyId": "org.eclipse.ditto:the_policy_id",
+ "definition": "org.eclipse.ditto:SomeModel:1.0.0",
+ "attributes": {
+ "location": {
+ "latitude": 44.673856,
+ "longitude": 8.261719
+ }
+ },
+ "features": {
+ "accelerometer": {
+ "properties": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ },
+ "desiredProperties": {
+ "x": 4
+ }
+ }
+ }
+ },
+ "status": 201
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deleteattribute.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deleteattribute.md
new file mode 100644
index 0000000..7145c61
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deleteattribute.md
@@ -0,0 +1,11 @@
+## DeleteAttribute
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/delete",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/attributes/location"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deleteattributeresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deleteattributeresponse.md
new file mode 100644
index 0000000..2dd20ac
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deleteattributeresponse.md
@@ -0,0 +1,12 @@
+## DeleteAttributeResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/delete",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/attributes/location",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deleteattributes.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deleteattributes.md
new file mode 100644
index 0000000..d07e578
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deleteattributes.md
@@ -0,0 +1,11 @@
+## DeleteAttributes
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/delete",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/attributes"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deleteattributesresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deleteattributesresponse.md
new file mode 100644
index 0000000..1070d9d
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deleteattributesresponse.md
@@ -0,0 +1,12 @@
+## DeleteAttributesResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/delete",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/attributes",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeature.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeature.md
new file mode 100644
index 0000000..38f1b2a
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeature.md
@@ -0,0 +1,11 @@
+## DeleteFeature
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/delete",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturedefinition.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturedefinition.md
new file mode 100644
index 0000000..5b8e32e
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturedefinition.md
@@ -0,0 +1,11 @@
+## DeleteFeatureDefinition
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/delete",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer/definition"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturedefinitionresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturedefinitionresponse.md
new file mode 100644
index 0000000..539e59c
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturedefinitionresponse.md
@@ -0,0 +1,12 @@
+## DeleteFeatureDefinitionResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/delete",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/definition",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturedesiredproperties.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturedesiredproperties.md
new file mode 100644
index 0000000..c158f1f
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturedesiredproperties.md
@@ -0,0 +1,11 @@
+## DeleteFeatureDesiredProperties
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/delete",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties"
+}
+```
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturedesiredpropertiesresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturedesiredpropertiesresponse.md
new file mode 100644
index 0000000..62595f2
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturedesiredpropertiesresponse.md
@@ -0,0 +1,12 @@
+## DeleteFeatureDesiredPropertiesResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/delete",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturedesiredproperty.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturedesiredproperty.md
new file mode 100644
index 0000000..3e1a6c4
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturedesiredproperty.md
@@ -0,0 +1,11 @@
+## DeleteFeatureDesiredProperty
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/delete",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties/x"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturedesiredpropertyresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturedesiredpropertyresponse.md
new file mode 100644
index 0000000..c484b95
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturedesiredpropertyresponse.md
@@ -0,0 +1,12 @@
+## DeleteFeatureDesiredPropertyResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/delete",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties/x",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeatureproperties.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeatureproperties.md
new file mode 100644
index 0000000..a7a85c6
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeatureproperties.md
@@ -0,0 +1,11 @@
+## DeleteFeatureProperties
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/delete",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturepropertiesresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturepropertiesresponse.md
new file mode 100644
index 0000000..4f16c27
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturepropertiesresponse.md
@@ -0,0 +1,12 @@
+## DeleteFeaturePropertiesResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/delete",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeatureproperty.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeatureproperty.md
new file mode 100644
index 0000000..324aa1d
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeatureproperty.md
@@ -0,0 +1,11 @@
+## DeleteFeatureProperty
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/delete",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties/x"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturepropertyresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturepropertyresponse.md
new file mode 100644
index 0000000..b45f56c
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturepropertyresponse.md
@@ -0,0 +1,12 @@
+## DeleteFeaturePropertyResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/delete",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties/x",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeatureresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeatureresponse.md
new file mode 100644
index 0000000..7257d7b
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeatureresponse.md
@@ -0,0 +1,12 @@
+## DeleteFeatureResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/delete",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeatures.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeatures.md
new file mode 100644
index 0000000..8830fa3
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeatures.md
@@ -0,0 +1,11 @@
+## DeleteFeatures
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/delete",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturesresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturesresponse.md
new file mode 100644
index 0000000..6c14294
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletefeaturesresponse.md
@@ -0,0 +1,12 @@
+## DeleteFeaturesResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/delete",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletething.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletething.md
new file mode 100644
index 0000000..3ff338b
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletething.md
@@ -0,0 +1,11 @@
+## DeleteThing
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/delete",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletethingdefinition.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletethingdefinition.md
new file mode 100644
index 0000000..6f9ebf9
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletethingdefinition.md
@@ -0,0 +1,11 @@
+## DeleteThingDefinition
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/delete",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/definition"
+}
+```
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletethingdefinitionresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletethingdefinitionresponse.md
new file mode 100644
index 0000000..d63384b
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletethingdefinitionresponse.md
@@ -0,0 +1,12 @@
+## DeleteThingDefinitionResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/delete",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/definition",
+ "status": 204
+}
+```
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletethingresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletethingresponse.md
new file mode 100644
index 0000000..21f80a7
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/deletethingresponse.md
@@ -0,0 +1,12 @@
+## DeleteThingResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/delete",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattribute.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattribute.md
new file mode 100644
index 0000000..13d13a9
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattribute.md
@@ -0,0 +1,15 @@
+## ModifyAttribute
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/attributes/location",
+ "value": {
+ "latitude": 44.673856,
+ "longitude": 8.261719
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributeresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributeresponse.md
new file mode 100644
index 0000000..90f0563
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributeresponse.md
@@ -0,0 +1,12 @@
+## ModifyAttributeResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/attributes/location",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributeresponsecreated.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributeresponsecreated.md
new file mode 100644
index 0000000..969fc4c
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributeresponsecreated.md
@@ -0,0 +1,16 @@
+## ModifyAttributeResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/attributes/location",
+ "value": {
+ "latitude": 44.673856,
+ "longitude": 8.261719
+ },
+ "status": 201
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributes.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributes.md
new file mode 100644
index 0000000..53b1ccc
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributes.md
@@ -0,0 +1,17 @@
+## ModifyAttributes
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/attributes",
+ "value": {
+ "location": {
+ "latitude": 44.673856,
+ "longitude": 8.261719
+ }
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributesresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributesresponse.md
new file mode 100644
index 0000000..e05d38c
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributesresponse.md
@@ -0,0 +1,13 @@
+## ModifyAttributesResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/attributes",
+ "value": null,
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributesresponsecreated.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributesresponsecreated.md
new file mode 100644
index 0000000..e55f5a3
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyattributesresponsecreated.md
@@ -0,0 +1,18 @@
+## ModifyAttributesResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/attributes",
+ "value": {
+ "location": {
+ "latitude": 44.673856,
+ "longitude": 8.261719
+ }
+ },
+ "status": 201
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeature.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeature.md
new file mode 100644
index 0000000..4da1151
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeature.md
@@ -0,0 +1,25 @@
+## ModifyFeature
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer",
+ "value": {
+ "properties": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ },
+ "desiredProperties": {
+ "x": 4,
+ "y": 3,
+ "z": 5,
+ "unit": "g"
+ }
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedefinition.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedefinition.md
new file mode 100644
index 0000000..e53f717
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedefinition.md
@@ -0,0 +1,14 @@
+## ModifyFeatureDefinition
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer/definition",
+ "value": [
+ "org.eclipse.ditto:accelerometer:1.0.0"
+ ]
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedefinitionresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedefinitionresponse.md
new file mode 100644
index 0000000..eab1026
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedefinitionresponse.md
@@ -0,0 +1,12 @@
+## ModifyFeatureDefinitionResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/definition",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedefinitionresponsecreated.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedefinitionresponsecreated.md
new file mode 100644
index 0000000..b64f368
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedefinitionresponsecreated.md
@@ -0,0 +1,15 @@
+## ModifyFeatureDefinitionResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/definition",
+ "value": [
+ "org.eclipse.ditto:accelerometer:1.0.0"
+ ],
+ "status": 201
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedesiredproperties.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedesiredproperties.md
new file mode 100644
index 0000000..59ac905
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedesiredproperties.md
@@ -0,0 +1,17 @@
+## ModifyFeatureDesiredProperties
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties",
+ "value": {
+ "x": 4,
+ "y": 3,
+ "z": 5,
+ "unit": "g"
+ }
+}
+```
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedesiredpropertiesresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedesiredpropertiesresponse.md
new file mode 100644
index 0000000..267a919
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedesiredpropertiesresponse.md
@@ -0,0 +1,12 @@
+## ModifyFeatureDesiredPropertiesResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedesiredpropertiesresponsecreated.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedesiredpropertiesresponsecreated.md
new file mode 100644
index 0000000..0f067a5
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedesiredpropertiesresponsecreated.md
@@ -0,0 +1,18 @@
+## ModifyFeatureDesiredPropertiesResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties",
+ "value": {
+ "x": 4,
+ "y": 5,
+ "z": 5,
+ "unit": "g"
+ },
+ "status": 201
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedesiredproperty.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedesiredproperty.md
new file mode 100644
index 0000000..0c5b495
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedesiredproperty.md
@@ -0,0 +1,12 @@
+## ModifyFeatureDesiredProperty
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties/x",
+ "value": 42
+}
+```
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedesiredpropertyresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedesiredpropertyresponse.md
new file mode 100644
index 0000000..2882094
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedesiredpropertyresponse.md
@@ -0,0 +1,12 @@
+## ModifyFeatureDesiredPropertyResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties/x",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedesiredpropertyresponsecreated.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedesiredpropertyresponsecreated.md
new file mode 100644
index 0000000..af1a765
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturedesiredpropertyresponsecreated.md
@@ -0,0 +1,13 @@
+## ModifyFeatureDesiredPropertyResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties/x",
+ "value": 42,
+ "status": 201
+}
+```
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatureproperties.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatureproperties.md
new file mode 100644
index 0000000..422f4a8
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatureproperties.md
@@ -0,0 +1,17 @@
+## ModifyFeatureProperties
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties",
+ "value": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturepropertiesresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturepropertiesresponse.md
new file mode 100644
index 0000000..a5b70f3
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturepropertiesresponse.md
@@ -0,0 +1,12 @@
+## ModifyFeaturePropertiesResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturepropertiesresponsecreated.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturepropertiesresponsecreated.md
new file mode 100644
index 0000000..bbe056a
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturepropertiesresponsecreated.md
@@ -0,0 +1,18 @@
+## ModifyFeaturePropertiesResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties",
+ "value": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ },
+ "status": 201
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatureproperty.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatureproperty.md
new file mode 100644
index 0000000..6fb4cb0
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatureproperty.md
@@ -0,0 +1,12 @@
+## ModifyFeatureProperty
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties/x",
+ "value": 42
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturepropertyresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturepropertyresponse.md
new file mode 100644
index 0000000..799ceae
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturepropertyresponse.md
@@ -0,0 +1,12 @@
+## ModifyFeaturePropertyResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties/x",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturepropertyresponsecreated.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturepropertyresponsecreated.md
new file mode 100644
index 0000000..2a795f6
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturepropertyresponsecreated.md
@@ -0,0 +1,13 @@
+## ModifyFeaturePropertyResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties/x",
+ "value": 42,
+ "status": 201
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatureresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatureresponse.md
new file mode 100644
index 0000000..74d7cc9
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatureresponse.md
@@ -0,0 +1,13 @@
+## ModifyFeatureResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer",
+ "value": null,
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatureresponsecreated.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatureresponsecreated.md
new file mode 100644
index 0000000..64edd85
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatureresponsecreated.md
@@ -0,0 +1,26 @@
+## ModifyFeatureResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer",
+ "value": {
+ "properties": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ },
+ "desiredProperties": {
+ "x": 4,
+ "y": 3,
+ "z": 5,
+ "unit": "g"
+ }
+ },
+ "status": 201
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatures.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatures.md
new file mode 100644
index 0000000..3e4ed5f
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeatures.md
@@ -0,0 +1,27 @@
+## ModifyFeatures
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features",
+ "value": {
+ "accelerometer": {
+ "properties": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ },
+ "desiredProperties": {
+ "x": 4,
+ "y": 3,
+ "z": 5,
+ "unit": "g"
+ }
+ }
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturesresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturesresponse.md
new file mode 100644
index 0000000..d770067
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturesresponse.md
@@ -0,0 +1,13 @@
+## ModifyFeaturesResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features",
+ "value": null,
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturesresponsecreated.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturesresponsecreated.md
new file mode 100644
index 0000000..df9fcaa
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifyfeaturesresponsecreated.md
@@ -0,0 +1,28 @@
+## ModifyFeaturesResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features",
+ "value": {
+ "accelerometer": {
+ "properties": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ },
+ "desiredProperties": {
+ "x": 4,
+ "y": 3,
+ "z": 5,
+ "unit": "g"
+ }
+ }
+ },
+ "status": 201
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifypolicyid.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifypolicyid.md
new file mode 100644
index 0000000..9026ff0
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifypolicyid.md
@@ -0,0 +1,12 @@
+## ModifyPolicyId
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/policyId",
+ "value": "org.eclipse.ditto:the_policy_id"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifypolicyidresponsecreated.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifypolicyidresponsecreated.md
new file mode 100644
index 0000000..4732d48
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifypolicyidresponsecreated.md
@@ -0,0 +1,13 @@
+## ModifyPolicyIdResponse when Thing had no Policy ID yet
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/policyId",
+ "value": "org.eclipse.ditto:the_policy_id",
+ "status": 201
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifypolicyidresponsemodified.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifypolicyidresponsemodified.md
new file mode 100644
index 0000000..ba90cfd
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifypolicyidresponsemodified.md
@@ -0,0 +1,12 @@
+## ModifyPolicyIdResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/policyId",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifything.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifything.md
new file mode 100644
index 0000000..f4df55c
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifything.md
@@ -0,0 +1,38 @@
+## ModifyThing
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "thingId": "org.eclipse.ditto:fancy-thing_53",
+ "policyId": "org.eclipse.ditto:the_policy_id",
+ "definition": "org.eclipse.ditto:SomeModel:1.0.0",
+ "attributes": {
+ "location": {
+ "latitude": 44.673856,
+ "longitude": 8.261719
+ }
+ },
+ "features": {
+ "accelerometer": {
+ "properties": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ },
+ "desiredProperties": {
+ "x": 4,
+ "y": 3,
+ "z": 5,
+ "unit": "g"
+ }
+ }
+ }
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingalternatives.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingalternatives.md
new file mode 100644
index 0000000..ab4e30e
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingalternatives.md
@@ -0,0 +1,46 @@
+## Alternative ModifyThing commands
+
+If you want to copy an existing Policy instead of creating a new one by yourself or reference an existing Policy, you
+can adjust the ModifyThing command like demonstrated in the following examples.<br/>
+This only works if a Thing with the given ``thingId`` does not exist, yet. If it exists the ``_copyPolicyFrom`` field
+will be ignored.
+
+### ModifyThing with copied Policy by Policy ID
+
+If no Thing with ID ``org.eclipse.ditto:fancy-thing_53`` exists, this command will create a new Thing with ID ``org.eclipse.ditto:fancy-thing_53`` with a
+Policy copied from the Policy with ID ``org.eclipse.ditto:the_policy_id_to_copy``.
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "thingId": "org.eclipse.ditto:fancy-thing_53",
+ "policyId": "org.eclipse.ditto:the_policy_id",
+ "_copyPolicyFrom": "com:acme:the_policy_id_to_copy"
+ }
+}
+```
+
+### ModifyThing with copied Policy by Thing reference
+
+If no Thing with ID ``org.eclipse.ditto:fancy-thing_53`` exists, this command will create a new Thing with ID ``org.eclipse.ditto:fancy-thing_53`` with a
+Policy copied from a Thing with ID ``org.eclipse.ditto:fancy-thing_52``.
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "thingId": "org.eclipse.ditto:fancy-thing_53",
+ "policyId": "org.eclipse.ditto:the_policy_id",
+ "_copyPolicyFrom": "{% raw %}{{ ref:things/com:acme:fancy-thing_52/policyId }}{% endraw %}"
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingdefinition.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingdefinition.md
new file mode 100644
index 0000000..b9c988f
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingdefinition.md
@@ -0,0 +1,12 @@
+## ModifyThingDefinition
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/definition",
+ "value": "digitaltwin:DigitaltwinExample:1.0.0"
+}
+```
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingdefinitionresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingdefinitionresponse.md
new file mode 100644
index 0000000..104ee8e
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingdefinitionresponse.md
@@ -0,0 +1,12 @@
+## ModifyThingDefinitionResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/definition",
+ "status": 204
+}
+```
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingdefinitionresponsecreated.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingdefinitionresponsecreated.md
new file mode 100644
index 0000000..c9740a2
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingdefinitionresponsecreated.md
@@ -0,0 +1,13 @@
+## ModifyThingDefinitionResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/definition",
+ "value": "digitaltwin:DigitaltwinExample:1.0.0",
+ "status": 201
+}
+```
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingresponse.md
new file mode 100644
index 0000000..8f8a635
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingresponse.md
@@ -0,0 +1,12 @@
+## ModifyThingResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "status": 204
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingresponsecreated.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingresponsecreated.md
new file mode 100644
index 0000000..153e580
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/modify/modifythingresponsecreated.md
@@ -0,0 +1,39 @@
+## ModifyThingResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "thingId": "org.eclipse.ditto:fancy-thing_53",
+ "policyId": "org.eclipse.ditto:the_policy_id",
+ "definition": "org.eclipse.ditto:SomeModel:1.0.0",
+ "attributes": {
+ "location": {
+ "latitude": 44.673856,
+ "longitude": 8.261719
+ }
+ },
+ "features": {
+ "accelerometer": {
+ "properties": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ },
+ "desiredProperties": {
+ "x": 4,
+ "y": 3,
+ "z": 5,
+ "unit": "g"
+ }
+ }
+ }
+ },
+ "status": 201
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattribute.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattribute.md
new file mode 100644
index 0000000..c0b96ef
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattribute.md
@@ -0,0 +1,11 @@
+## RetrieveAttribute
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/attributes/location"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattributeresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattributeresponse.md
new file mode 100644
index 0000000..e999630
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattributeresponse.md
@@ -0,0 +1,16 @@
+## RetrieveAttributeResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/attributes/location",
+ "value": {
+ "latitude": 44.673856,
+ "longitude": 8.261719
+ },
+ "status": 200
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattributes-selectedfields.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattributes-selectedfields.md
new file mode 100644
index 0000000..6afef62
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattributes-selectedfields.md
@@ -0,0 +1,12 @@
+## RetrieveAttributes
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/attributes",
+ "fields": "attributes"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattributes.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattributes.md
new file mode 100644
index 0000000..01ccc8c
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattributes.md
@@ -0,0 +1,11 @@
+## RetrieveAttributes
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/attributes"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattributesresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattributesresponse.md
new file mode 100644
index 0000000..5ec9ca4
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrieveattributesresponse.md
@@ -0,0 +1,18 @@
+## RetrieveAttributesResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/attributes",
+ "value": {
+ "location": {
+ "latitude": 44.673856,
+ "longitude": 8.261719
+ }
+ },
+ "status": 200
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeature.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeature.md
new file mode 100644
index 0000000..f05cb22
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeature.md
@@ -0,0 +1,11 @@
+## RetrieveFeature
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturedefinition.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturedefinition.md
new file mode 100644
index 0000000..bad6f3e
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturedefinition.md
@@ -0,0 +1,11 @@
+## RetrieveFeatureDefinition
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer/definition"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturedefinitionresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturedefinitionresponse.md
new file mode 100644
index 0000000..c45898c
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturedefinitionresponse.md
@@ -0,0 +1,15 @@
+## RetrieveFeatureDefinitionResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/definition",
+ "value": [
+ "org.eclipse.ditto:accelerometer:1.0.0"
+ ],
+ "status": 200
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturedesiredproperties-selectedfields.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturedesiredproperties-selectedfields.md
new file mode 100644
index 0000000..3e739fd
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturedesiredproperties-selectedfields.md
@@ -0,0 +1,12 @@
+## RetrieveFeatureDesiredProperties
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties",
+ "fields": "desiredProperties/target_year_1"
+}
+```
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturedesiredproperties.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturedesiredproperties.md
new file mode 100644
index 0000000..d1b13c5
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturedesiredproperties.md
@@ -0,0 +1,11 @@
+## RetrieveFeatureDesiredProperties
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties"
+}
+```
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturedesiredpropertiesresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturedesiredpropertiesresponse.md
new file mode 100644
index 0000000..0ea5452
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturedesiredpropertiesresponse.md
@@ -0,0 +1,18 @@
+## RetrieveFeatureDesiredPropertiesResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties",
+ "value": {
+ "x": 4,
+ "y": 3,
+ "z": 5,
+ "unit": "g"
+ },
+ "status": 200
+}
+```
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturedesiredproperty.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturedesiredproperty.md
new file mode 100644
index 0000000..f92e4f5
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturedesiredproperty.md
@@ -0,0 +1,11 @@
+## RetrieveFeatureDesiredProperty
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties/x"
+}
+```
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturedesiredpropertyresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturedesiredpropertyresponse.md
new file mode 100644
index 0000000..4a704ad
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturedesiredpropertyresponse.md
@@ -0,0 +1,13 @@
+## RetrieveFeatureDesiredPropertyResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties/x",
+ "value": 42,
+ "status": 200
+}
+```
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatureproperties-selectedfields.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatureproperties-selectedfields.md
new file mode 100644
index 0000000..ff93ebd
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatureproperties-selectedfields.md
@@ -0,0 +1,12 @@
+## RetrieveFeatureProperties
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties",
+ "fields": "properties/target_year_1"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatureproperties.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatureproperties.md
new file mode 100644
index 0000000..f1f37eb
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatureproperties.md
@@ -0,0 +1,11 @@
+## RetrieveFeatureProperties
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturepropertiesresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturepropertiesresponse.md
new file mode 100644
index 0000000..e4bac12
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturepropertiesresponse.md
@@ -0,0 +1,18 @@
+## RetrieveFeaturePropertiesResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties",
+ "value": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ },
+ "status": 200
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatureproperty.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatureproperty.md
new file mode 100644
index 0000000..dbab949
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatureproperty.md
@@ -0,0 +1,11 @@
+## RetrieveFeatureProperty
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties/x"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturepropertyresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturepropertyresponse.md
new file mode 100644
index 0000000..d6e120e
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturepropertyresponse.md
@@ -0,0 +1,13 @@
+## RetrieveFeaturePropertyResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties/x",
+ "value": 42,
+ "status": 200
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatureresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatureresponse.md
new file mode 100644
index 0000000..e47e75d
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatureresponse.md
@@ -0,0 +1,26 @@
+## RetrieveFeatureResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer",
+ "value": {
+ "properties": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ },
+ "desiredProperties": {
+ "x": 4,
+ "y": 3,
+ "z": 5,
+ "unit": "g"
+ }
+ },
+ "status": 200
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatures.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatures.md
new file mode 100644
index 0000000..f7eb27c
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeatures.md
@@ -0,0 +1,11 @@
+## RetrieveFeatures
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/features"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturesresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturesresponse.md
new file mode 100644
index 0000000..4df4ae0
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievefeaturesresponse.md
@@ -0,0 +1,28 @@
+## RetrieveFeaturesResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features",
+ "value": {
+ "accelerometer": {
+ "properties": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ },
+ "desiredProperties": {
+ "x": 4,
+ "y": 3,
+ "z": 5,
+ "unit": "g"
+ }
+ }
+ },
+ "status": 200
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievepolicyid.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievepolicyid.md
new file mode 100644
index 0000000..5e5aec4
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievepolicyid.md
@@ -0,0 +1,11 @@
+## RetrievePolicyId
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/policyId"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievepolicyidresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievepolicyidresponse.md
new file mode 100644
index 0000000..12fa563
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievepolicyidresponse.md
@@ -0,0 +1,13 @@
+## RetrievePolicyIdResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/policyId",
+ "value": "org.eclipse.ditto:the_policy_id",
+ "status": 200
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievething-withfieldselector.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievething-withfieldselector.md
new file mode 100644
index 0000000..e855c32
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievething-withfieldselector.md
@@ -0,0 +1,12 @@
+## RetrieveThing
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/",
+ "fields": "thingId,attributes(location)"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievething-withsnapshotrevision.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievething-withsnapshotrevision.md
new file mode 100644
index 0000000..773b131
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievething-withsnapshotrevision.md
@@ -0,0 +1,11 @@
+## RetrieveThing
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievething.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievething.md
new file mode 100644
index 0000000..773b131
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievething.md
@@ -0,0 +1,11 @@
+## RetrieveThing
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievethingdefinition.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievethingdefinition.md
new file mode 100644
index 0000000..d2e63d5
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievethingdefinition.md
@@ -0,0 +1,11 @@
+## RetrieveDefinition
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/definition"
+}
+```
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievethingdefinitionresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievethingdefinitionresponse.md
new file mode 100644
index 0000000..4b21bee
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievethingdefinitionresponse.md
@@ -0,0 +1,13 @@
+## RetrieveAttributeResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/definition",
+ "value": "digitaltwin:DigitaltwinExample:1.0.0",
+ "status": 200
+}
+```
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievethingresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievethingresponse.md
new file mode 100644
index 0000000..a9435e0
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievethingresponse.md
@@ -0,0 +1,38 @@
+## RetrieveThingResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "thingId": "org.eclipse.ditto:fancy-thing_53",
+ "policyId": "org.eclipse.ditto:the_policy_id",
+ "attributes": {
+ "location": {
+ "latitude": 44.673856,
+ "longitude": 8.261719
+ }
+ },
+ "features": {
+ "accelerometer": {
+ "properties": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ },
+ "desiredProperties": {
+ "x": 4,
+ "y": 3,
+ "z": 5,
+ "unit": "g"
+ }
+ }
+ }
+ },
+ "status": 200
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievethings-withfieldselector.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievethings-withfieldselector.md
new file mode 100644
index 0000000..4e6de64
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievethings-withfieldselector.md
@@ -0,0 +1,19 @@
+## RetrieveThings
+
+```json
+{
+ "topic": "_/_/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "thingIds": [
+ "org.eclipse.ditto:fancy-thing_53",
+ "org.eclipse.ditto:fancy-thing_58",
+ "org.eclipse.ditto:fancy-thing_67"
+ ]
+ },
+ "fields": "thingId,attributes(location)"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievethings.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievethings.md
new file mode 100644
index 0000000..6079cf0
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievethings.md
@@ -0,0 +1,18 @@
+## RetrieveThings
+
+```json
+{
+ "topic": "_/_/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "thingIds": [
+ "org.eclipse.ditto:fancy-thing_53",
+ "org.eclipse.ditto:fancy-thing_58",
+ "org.eclipse.ditto:fancy-thing_67"
+ ]
+ }
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievethingsresponse.md b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievethingsresponse.md
new file mode 100644
index 0000000..e320ad3
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/commands/query/retrievethingsresponse.md
@@ -0,0 +1,38 @@
+## RetrieveThingsResponse
+
+```json
+{
+ "topic": "org.eclipse.ditto/_/things/twin/commands/retrieve",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": [{
+ "thingId": "org.eclipse.ditto:fancy-thing_53",
+ "policyId": "org.eclipse.ditto:the_policy_id",
+ "attributes": {
+ "location": {
+ "latitude": 44.673856,
+ "longitude": 8.261719
+ }
+ },
+ "features": {
+ "accelerometer": {
+ "properties": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ },
+ "desiredProperties": {
+ "x": 4,
+ "y": 3,
+ "z": 5,
+ "unit": "g"
+ }
+ }
+ }
+ }],
+ "status": 200
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/attributecreated.md b/2.0/pages/ditto/protocol/examples/things/generated/events/attributecreated.md
new file mode 100644
index 0000000..4824c34
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/attributecreated.md
@@ -0,0 +1,16 @@
+## AttributeCreated
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/created",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/attributes/location",
+ "value": {
+ "latitude": 44.673856,
+ "longitude": 8.261719
+ },
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/attributedeleted.md b/2.0/pages/ditto/protocol/examples/things/generated/events/attributedeleted.md
new file mode 100644
index 0000000..814e8c2
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/attributedeleted.md
@@ -0,0 +1,12 @@
+## AttributeDeleted
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/deleted",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/attributes/location",
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/attributemodified.md b/2.0/pages/ditto/protocol/examples/things/generated/events/attributemodified.md
new file mode 100644
index 0000000..b79a6ae
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/attributemodified.md
@@ -0,0 +1,16 @@
+## AttributeModified
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/modified",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/attributes/location",
+ "value": {
+ "latitude": 44.673856,
+ "longitude": 8.261719
+ },
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/attributescreated.md b/2.0/pages/ditto/protocol/examples/things/generated/events/attributescreated.md
new file mode 100644
index 0000000..8d4ba88
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/attributescreated.md
@@ -0,0 +1,18 @@
+## AttributesCreated
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/created",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/attributes",
+ "value": {
+ "location": {
+ "latitude": 44.673856,
+ "longitude": 8.261719
+ }
+ },
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/attributesdeleted.md b/2.0/pages/ditto/protocol/examples/things/generated/events/attributesdeleted.md
new file mode 100644
index 0000000..bcdefba
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/attributesdeleted.md
@@ -0,0 +1,12 @@
+## AttributesDeleted
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/deleted",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/attributes",
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/attributesmodified.md b/2.0/pages/ditto/protocol/examples/things/generated/events/attributesmodified.md
new file mode 100644
index 0000000..eb30a14
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/attributesmodified.md
@@ -0,0 +1,18 @@
+## AttributesModified
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/modified",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/attributes",
+ "value": {
+ "location": {
+ "latitude": 44.673856,
+ "longitude": 8.261719
+ }
+ },
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/featurecreated.md b/2.0/pages/ditto/protocol/examples/things/generated/events/featurecreated.md
new file mode 100644
index 0000000..5b5eb9f
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/featurecreated.md
@@ -0,0 +1,26 @@
+## FeatureCreated
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/created",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer",
+ "value": {
+ "properties": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ },
+ "desiredProperties": {
+ "x": 4,
+ "y": 3,
+ "z": 5,
+ "unit": "g"
+ }
+ },
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/featuredefinitioncreated.md b/2.0/pages/ditto/protocol/examples/things/generated/events/featuredefinitioncreated.md
new file mode 100644
index 0000000..a423ef7
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/featuredefinitioncreated.md
@@ -0,0 +1,15 @@
+## FeatureDefinitionCreated
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/created",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/definition",
+ "value": [
+ "org.eclipse.ditto:accelerometer:1.0.0"
+ ],
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/featuredefinitiondeleted.md b/2.0/pages/ditto/protocol/examples/things/generated/events/featuredefinitiondeleted.md
new file mode 100644
index 0000000..92a44a0
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/featuredefinitiondeleted.md
@@ -0,0 +1,12 @@
+## FeatureDefinitionDeleted
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/deleted",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/definition",
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/featuredefinitionmodified.md b/2.0/pages/ditto/protocol/examples/things/generated/events/featuredefinitionmodified.md
new file mode 100644
index 0000000..b421c9d
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/featuredefinitionmodified.md
@@ -0,0 +1,15 @@
+## FeatureDefinitionModified
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/modified",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/definition",
+ "value": [
+ "org.eclipse.ditto:accelerometer:1.0.0"
+ ],
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/featuredeleted.md b/2.0/pages/ditto/protocol/examples/things/generated/events/featuredeleted.md
new file mode 100644
index 0000000..8711ef0
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/featuredeleted.md
@@ -0,0 +1,12 @@
+## FeatureDeleted
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/deleted",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer",
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/featuredesiredpropertiescreated.md b/2.0/pages/ditto/protocol/examples/things/generated/events/featuredesiredpropertiescreated.md
new file mode 100644
index 0000000..1618462
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/featuredesiredpropertiescreated.md
@@ -0,0 +1,18 @@
+## FeatureDesiredPropertiesCreated
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/created",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties",
+ "value": {
+ "x": 4,
+ "y": 3,
+ "z": 5,
+ "unit": "g"
+ },
+ "revision": 1
+}
+```
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/featuredesiredpropertiesdeleted.md b/2.0/pages/ditto/protocol/examples/things/generated/events/featuredesiredpropertiesdeleted.md
new file mode 100644
index 0000000..b7c6fe7
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/featuredesiredpropertiesdeleted.md
@@ -0,0 +1,12 @@
+## FeatureDesiredPropertiesDeleted
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/deleted",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties",
+ "revision": 1
+}
+```
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/featuredesiredpropertiesmodified.md b/2.0/pages/ditto/protocol/examples/things/generated/events/featuredesiredpropertiesmodified.md
new file mode 100644
index 0000000..58f5dd8
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/featuredesiredpropertiesmodified.md
@@ -0,0 +1,18 @@
+## FeatureDesiredPropertiesModified
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/modified",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties",
+ "value": {
+ "x": 4,
+ "y": 3,
+ "z": 5,
+ "unit": "g"
+ },
+ "revision": 1
+}
+```
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/featuredesiredpropertycreated.md b/2.0/pages/ditto/protocol/examples/things/generated/events/featuredesiredpropertycreated.md
new file mode 100644
index 0000000..0bb77bc
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/featuredesiredpropertycreated.md
@@ -0,0 +1,13 @@
+## FeatureDesiredPropertyCreated
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/created",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties/x",
+ "value": 42,
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/featuredesiredpropertydeleted.md b/2.0/pages/ditto/protocol/examples/things/generated/events/featuredesiredpropertydeleted.md
new file mode 100644
index 0000000..5e36ef7
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/featuredesiredpropertydeleted.md
@@ -0,0 +1,12 @@
+## FeatureDesiredPropertyDeleted
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/deleted",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties/x",
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/featuredesiredpropertymodified.md b/2.0/pages/ditto/protocol/examples/things/generated/events/featuredesiredpropertymodified.md
new file mode 100644
index 0000000..12aa7a8
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/featuredesiredpropertymodified.md
@@ -0,0 +1,13 @@
+## FeatureDesiredPropertyModified
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/modified",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/desiredProperties/x",
+ "value": 42,
+ "revision": 1
+}
+```
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/featuremodified.md b/2.0/pages/ditto/protocol/examples/things/generated/events/featuremodified.md
new file mode 100644
index 0000000..8b8e1d9
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/featuremodified.md
@@ -0,0 +1,26 @@
+## FeatureModified
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/modified",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer",
+ "value": {
+ "properties": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ },
+ "desiredProperties": {
+ "x": 4,
+ "y": 3,
+ "z": 5,
+ "unit": "g"
+ }
+ },
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/featurepropertiescreated.md b/2.0/pages/ditto/protocol/examples/things/generated/events/featurepropertiescreated.md
new file mode 100644
index 0000000..3ed1029
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/featurepropertiescreated.md
@@ -0,0 +1,18 @@
+## FeaturePropertiesCreated
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/created",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties",
+ "value": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ },
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/featurepropertiesdeleted.md b/2.0/pages/ditto/protocol/examples/things/generated/events/featurepropertiesdeleted.md
new file mode 100644
index 0000000..14cd6fb
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/featurepropertiesdeleted.md
@@ -0,0 +1,12 @@
+## FeaturePropertiesDeleted
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/deleted",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties",
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/featurepropertiesmodified.md b/2.0/pages/ditto/protocol/examples/things/generated/events/featurepropertiesmodified.md
new file mode 100644
index 0000000..3b51100
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/featurepropertiesmodified.md
@@ -0,0 +1,18 @@
+## FeaturePropertiesModified
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/modified",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties",
+ "value": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ },
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/featurepropertycreated.md b/2.0/pages/ditto/protocol/examples/things/generated/events/featurepropertycreated.md
new file mode 100644
index 0000000..01f6e29
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/featurepropertycreated.md
@@ -0,0 +1,13 @@
+## FeaturePropertyCreated
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/created",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties/x",
+ "value": 42,
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/featurepropertydeleted.md b/2.0/pages/ditto/protocol/examples/things/generated/events/featurepropertydeleted.md
new file mode 100644
index 0000000..96d4ef7
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/featurepropertydeleted.md
@@ -0,0 +1,12 @@
+## FeaturePropertyDeleted
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/deleted",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties/x",
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/featurepropertymodified.md b/2.0/pages/ditto/protocol/examples/things/generated/events/featurepropertymodified.md
new file mode 100644
index 0000000..894d5b8
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/featurepropertymodified.md
@@ -0,0 +1,13 @@
+## FeaturePropertyModified
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/modified",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features/accelerometer/properties/x",
+ "value": 42,
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/featurescreated.md b/2.0/pages/ditto/protocol/examples/things/generated/events/featurescreated.md
new file mode 100644
index 0000000..583be6a
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/featurescreated.md
@@ -0,0 +1,28 @@
+## FeaturesCreated
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/created",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features",
+ "value": {
+ "accelerometer": {
+ "properties": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ },
+ "desiredProperties": {
+ "x": 4,
+ "y": 3,
+ "z": 5,
+ "unit": "g"
+ }
+ }
+ },
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/featuresdeleted.md b/2.0/pages/ditto/protocol/examples/things/generated/events/featuresdeleted.md
new file mode 100644
index 0000000..9ef02f4
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/featuresdeleted.md
@@ -0,0 +1,12 @@
+## FeaturesDeleted
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/deleted",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features",
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/featuresmodified.md b/2.0/pages/ditto/protocol/examples/things/generated/events/featuresmodified.md
new file mode 100644
index 0000000..fddd509
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/featuresmodified.md
@@ -0,0 +1,28 @@
+## FeaturesModified
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/modified",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/features",
+ "value": {
+ "accelerometer": {
+ "properties": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ },
+ "desiredProperties": {
+ "x": 4,
+ "y": 3,
+ "z": 5,
+ "unit": "g"
+ }
+ }
+ },
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/mergedattribute.md b/2.0/pages/ditto/protocol/examples/things/generated/events/mergedattribute.md
new file mode 100644
index 0000000..81a445d
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/mergedattribute.md
@@ -0,0 +1,17 @@
+## Thing merged event at /attributes/location
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/merged",
+ "headers": {
+ "content-type": "application/merge-patch+json"
+ },
+ "path": "/attributes/location",
+ "value": {
+ "latitude": 44.673856,
+ "longitude": 8.261719
+ },
+ "revision": 42,
+ "timestamp": "2021-01-18T09:42:12Z"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/mergedattributes.md b/2.0/pages/ditto/protocol/examples/things/generated/events/mergedattributes.md
new file mode 100644
index 0000000..1c4fc81
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/mergedattributes.md
@@ -0,0 +1,19 @@
+## Thing merged event at /attributes
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/merged",
+ "headers": {
+ "content-type": "application/merge-patch+json"
+ },
+ "path": "/attributes",
+ "value": {
+ "location": {
+ "latitude": 44.673856,
+ "longitude": 8.261719
+ }
+ },
+ "revision": 42,
+ "timestamp": "2021-01-18T09:42:12Z"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeleteattribute.md b/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeleteattribute.md
new file mode 100644
index 0000000..01c4019
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeleteattribute.md
@@ -0,0 +1,14 @@
+## Thing merged event at /attributes/location
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/merged",
+ "headers": {
+ "content-type": "application/merge-patch+json"
+ },
+ "path": "/attributes/location",
+ "value": null,
+ "revision": 42,
+ "timestamp": "2021-01-18T09:42:12Z"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeleteattributes.md b/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeleteattributes.md
new file mode 100644
index 0000000..0f4ec32
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeleteattributes.md
@@ -0,0 +1,14 @@
+## Thing merged event at /attributes
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/merged",
+ "headers": {
+ "content-type": "application/merge-patch+json"
+ },
+ "path": "/attributes",
+ "value": null,
+ "revision": 42,
+ "timestamp": "2021-01-18T09:42:12Z"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeletefeature.md b/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeletefeature.md
new file mode 100644
index 0000000..0708604
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeletefeature.md
@@ -0,0 +1,14 @@
+## Thing merged event at /features/accelerometer
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/merged",
+ "headers": {
+ "content-type": "application/merge-patch+json"
+ },
+ "path": "/features/accelerometer",
+ "value": null,
+ "revision": 42,
+ "timestamp": "2021-01-18T09:42:12Z"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeletefeaturedefinition.md b/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeletefeaturedefinition.md
new file mode 100644
index 0000000..8e6de65
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeletefeaturedefinition.md
@@ -0,0 +1,14 @@
+## Thing merged event at /features/accelerometer/definition
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/merged",
+ "headers": {
+ "content-type": "application/merge-patch+json"
+ },
+ "path": "/features/accelerometer/definition",
+ "value": null,
+ "revision": 42,
+ "timestamp": "2021-01-18T09:42:12Z"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeletefeaturedesiredproperties.md b/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeletefeaturedesiredproperties.md
new file mode 100644
index 0000000..3498913
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeletefeaturedesiredproperties.md
@@ -0,0 +1,14 @@
+## Thing merged event at /features/accelerometer/desiredProperties
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/merged",
+ "headers": {
+ "content-type": "application/merge-patch+json"
+ },
+ "path": "/features/accelerometer/desiredProperties",
+ "value": null,
+ "revision": 42,
+ "timestamp": "2021-01-18T09:42:12Z"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeletefeaturedesiredproperty.md b/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeletefeaturedesiredproperty.md
new file mode 100644
index 0000000..50bb3be
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeletefeaturedesiredproperty.md
@@ -0,0 +1,14 @@
+## Thing merged event at /features/accelerometer/desiredProperties/x
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/merged",
+ "headers": {
+ "content-type": "application/merge-patch+json"
+ },
+ "path": "/features/accelerometer/desiredProperties/x",
+ "value": null,
+ "revision": 42,
+ "timestamp": "2021-01-18T09:42:12Z"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeletefeatureproperties.md b/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeletefeatureproperties.md
new file mode 100644
index 0000000..159cd5b
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeletefeatureproperties.md
@@ -0,0 +1,14 @@
+## Thing merged event at /features/accelerometer/properties
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/merged",
+ "headers": {
+ "content-type": "application/merge-patch+json"
+ },
+ "path": "/features/accelerometer/properties",
+ "value": null,
+ "revision": 42,
+ "timestamp": "2021-01-18T09:42:12Z"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeletefeatureproperty.md b/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeletefeatureproperty.md
new file mode 100644
index 0000000..fb1c006
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeletefeatureproperty.md
@@ -0,0 +1,14 @@
+## Thing merged event at /features/accelerometer/properties/x
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/merged",
+ "headers": {
+ "content-type": "application/merge-patch+json"
+ },
+ "path": "/features/accelerometer/properties/x",
+ "value": null,
+ "revision": 42,
+ "timestamp": "2021-01-18T09:42:12Z"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeletefeatures.md b/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeletefeatures.md
new file mode 100644
index 0000000..e38fe18
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeletefeatures.md
@@ -0,0 +1,14 @@
+## Thing merged event at /features
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/merged",
+ "headers": {
+ "content-type": "application/merge-patch+json"
+ },
+ "path": "/features",
+ "value": null,
+ "revision": 42,
+ "timestamp": "2021-01-18T09:42:12Z"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeletethingdefinition.md b/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeletethingdefinition.md
new file mode 100644
index 0000000..02c75f6
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/mergeddeletethingdefinition.md
@@ -0,0 +1,14 @@
+## Thing merged event at /definition
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/merged",
+ "headers": {
+ "content-type": "application/merge-patch+json"
+ },
+ "path": "/definition",
+ "value": null,
+ "revision": 42,
+ "timestamp": "2021-01-18T09:42:12Z"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/mergedfeature.md b/2.0/pages/ditto/protocol/examples/things/generated/events/mergedfeature.md
new file mode 100644
index 0000000..3a8430e
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/mergedfeature.md
@@ -0,0 +1,24 @@
+## Thing merged event at /features/accelerometer
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/merged",
+ "headers": {
+ "content-type": "application/merge-patch+json"
+ },
+ "path": "/features/accelerometer",
+ "value": {
+ "definition": [
+ "org.eclipse.ditto:accelerometer:1.0.0"
+ ],
+ "properties": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ }
+ },
+ "revision": 42,
+ "timestamp": "2021-01-18T09:42:12Z"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/mergedfeaturedefinition.md b/2.0/pages/ditto/protocol/examples/things/generated/events/mergedfeaturedefinition.md
new file mode 100644
index 0000000..8bfc0f2
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/mergedfeaturedefinition.md
@@ -0,0 +1,16 @@
+## Thing merged event at /features/accelerometer/definition
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/merged",
+ "headers": {
+ "content-type": "application/merge-patch+json"
+ },
+ "path": "/features/accelerometer/definition",
+ "value": [
+ "org.eclipse.ditto:accelerometer:1.0.0"
+ ],
+ "revision": 42,
+ "timestamp": "2021-01-18T09:42:12Z"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/mergedfeaturedesiredproperties.md b/2.0/pages/ditto/protocol/examples/things/generated/events/mergedfeaturedesiredproperties.md
new file mode 100644
index 0000000..ed4ca92
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/mergedfeaturedesiredproperties.md
@@ -0,0 +1,19 @@
+## Thing merged event at /features/accelerometer/desiredProperties
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/merged",
+ "headers": {
+ "content-type": "application/merge-patch+json"
+ },
+ "path": "/features/accelerometer/desiredProperties",
+ "value": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ },
+ "revision": 42,
+ "timestamp": "2021-01-18T09:42:12Z"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/mergedfeaturedesiredproperty.md b/2.0/pages/ditto/protocol/examples/things/generated/events/mergedfeaturedesiredproperty.md
new file mode 100644
index 0000000..0bdec40
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/mergedfeaturedesiredproperty.md
@@ -0,0 +1,14 @@
+## Thing merged event at /features/accelerometer/desiredProperties/x
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/merged",
+ "headers": {
+ "content-type": "application/merge-patch+json"
+ },
+ "path": "/features/accelerometer/desiredProperties/x",
+ "value": 42,
+ "revision": 42,
+ "timestamp": "2021-01-18T09:42:12Z"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/mergedfeatureproperties.md b/2.0/pages/ditto/protocol/examples/things/generated/events/mergedfeatureproperties.md
new file mode 100644
index 0000000..ca85413
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/mergedfeatureproperties.md
@@ -0,0 +1,19 @@
+## Thing merged event at /features/accelerometer/properties
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/merged",
+ "headers": {
+ "content-type": "application/merge-patch+json"
+ },
+ "path": "/features/accelerometer/properties",
+ "value": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ },
+ "revision": 42,
+ "timestamp": "2021-01-18T09:42:12Z"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/mergedfeatureproperty.md b/2.0/pages/ditto/protocol/examples/things/generated/events/mergedfeatureproperty.md
new file mode 100644
index 0000000..8a030dc
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/mergedfeatureproperty.md
@@ -0,0 +1,14 @@
+## Thing merged event at /features/accelerometer/properties/x
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/merged",
+ "headers": {
+ "content-type": "application/merge-patch+json"
+ },
+ "path": "/features/accelerometer/properties/x",
+ "value": 42,
+ "revision": 42,
+ "timestamp": "2021-01-18T09:42:12Z"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/mergedfeatures.md b/2.0/pages/ditto/protocol/examples/things/generated/events/mergedfeatures.md
new file mode 100644
index 0000000..e339265
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/mergedfeatures.md
@@ -0,0 +1,26 @@
+## Thing merged event at /features
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/merged",
+ "headers": {
+ "content-type": "application/merge-patch+json"
+ },
+ "path": "/features",
+ "value": {
+ "accelerometer": {
+ "definition": [
+ "org.eclipse.ditto:accelerometer:1.0.0"
+ ],
+ "properties": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ }
+ }
+ },
+ "revision": 42,
+ "timestamp": "2021-01-18T09:42:12Z"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/mergedpolicyid.md b/2.0/pages/ditto/protocol/examples/things/generated/events/mergedpolicyid.md
new file mode 100644
index 0000000..abc8824
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/mergedpolicyid.md
@@ -0,0 +1,14 @@
+## Thing merged event at /policyId
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/merged",
+ "headers": {
+ "content-type": "application/merge-patch+json"
+ },
+ "path": "/policyId",
+ "value": "org.eclipse.ditto:the_policy_id",
+ "revision": 42,
+ "timestamp": "2021-01-18T09:42:12Z"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/mergedthing.md b/2.0/pages/ditto/protocol/examples/things/generated/events/mergedthing.md
new file mode 100644
index 0000000..11ade51
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/mergedthing.md
@@ -0,0 +1,37 @@
+## Thing merged event at /
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/merged",
+ "headers": {
+ "content-type": "application/merge-patch+json"
+ },
+ "path": "/",
+ "value": {
+ "thingId": "org.eclipse.ditto:fancy-thing_53",
+ "policyId": "org.eclipse.ditto:the_policy_id",
+ "definition": "org.eclipse.ditto:SomeModel:1.0.0",
+ "attributes": {
+ "location": {
+ "latitude": 44.673856,
+ "longitude": 8.261719
+ }
+ },
+ "features": {
+ "accelerometer": {
+ "definition": [
+ "org.eclipse.ditto:accelerometer:1.0.0"
+ ],
+ "properties": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ }
+ }
+ }
+ },
+ "revision": 42,
+ "timestamp": "2021-01-18T09:42:12Z"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/mergedthingdefinition.md b/2.0/pages/ditto/protocol/examples/things/generated/events/mergedthingdefinition.md
new file mode 100644
index 0000000..4f86694
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/mergedthingdefinition.md
@@ -0,0 +1,14 @@
+## Thing merged event at /definition
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/merged",
+ "headers": {
+ "content-type": "application/merge-patch+json"
+ },
+ "path": "/definition",
+ "value": "org.eclipse.ditto:SomeModel:1.0.0",
+ "revision": 42,
+ "timestamp": "2021-01-18T09:42:12Z"
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/policyidcreated.md b/2.0/pages/ditto/protocol/examples/things/generated/events/policyidcreated.md
new file mode 100644
index 0000000..a9b2655
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/policyidcreated.md
@@ -0,0 +1,13 @@
+## PolicyIdCreated
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/created",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/policyId",
+ "value": "org.eclipse.ditto:the_policy_id",
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/policyidmodified.md b/2.0/pages/ditto/protocol/examples/things/generated/events/policyidmodified.md
new file mode 100644
index 0000000..165a340
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/policyidmodified.md
@@ -0,0 +1,13 @@
+## PolicyIdModified
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/modified",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/policyId",
+ "value": "org.eclipse.ditto:the_policy_id",
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/thingcreated.md b/2.0/pages/ditto/protocol/examples/things/generated/events/thingcreated.md
new file mode 100644
index 0000000..b39236a
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/thingcreated.md
@@ -0,0 +1,38 @@
+## ThingCreated
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/created",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "thingId": "org.eclipse.ditto:fancy-thing_53",
+ "policyId": "org.eclipse.ditto:the_policy_id",
+ "attributes": {
+ "location": {
+ "latitude": 44.673856,
+ "longitude": 8.261719
+ }
+ },
+ "features": {
+ "accelerometer": {
+ "properties": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ },
+ "desiredProperties": {
+ "x": 4,
+ "y": 3,
+ "z": 5,
+ "unit": "g"
+ }
+ }
+ }
+ },
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/thingdefinitioncreated.md b/2.0/pages/ditto/protocol/examples/things/generated/events/thingdefinitioncreated.md
new file mode 100644
index 0000000..af14311
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/thingdefinitioncreated.md
@@ -0,0 +1,13 @@
+## DefinitionCreated
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/created",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/definition",
+ "value": "digitaltwin:DigitaltwinExample:1.0.0",
+ "revision": 2
+}
+```
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/thingdefinitiondeleted.md b/2.0/pages/ditto/protocol/examples/things/generated/events/thingdefinitiondeleted.md
new file mode 100644
index 0000000..c7eea3d
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/thingdefinitiondeleted.md
@@ -0,0 +1,12 @@
+## DefinitionDeleted
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/deleted",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/definition",
+ "revision": 3
+}
+```
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/thingdefinitionmodified.md b/2.0/pages/ditto/protocol/examples/things/generated/events/thingdefinitionmodified.md
new file mode 100644
index 0000000..705d1e2
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/thingdefinitionmodified.md
@@ -0,0 +1,13 @@
+## DefinitionModified
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/modified",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/definition",
+ "value": "digitaltwin:DigitaltwinExample:1.0.0",
+ "revision": 3
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/thingdeleted.md b/2.0/pages/ditto/protocol/examples/things/generated/events/thingdeleted.md
new file mode 100644
index 0000000..ce4de55
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/thingdeleted.md
@@ -0,0 +1,12 @@
+## ThingDeleted
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/deleted",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/events/thingmodified.md b/2.0/pages/ditto/protocol/examples/things/generated/events/thingmodified.md
new file mode 100644
index 0000000..85993a4
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/events/thingmodified.md
@@ -0,0 +1,38 @@
+## ThingModified
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/events/modified",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "thingId": "org.eclipse.ditto:fancy-thing_53",
+ "policyId": "org.eclipse.ditto:the_policy_id",
+ "attributes": {
+ "location": {
+ "latitude": 44.673856,
+ "longitude": 8.261719
+ }
+ },
+ "features": {
+ "accelerometer": {
+ "properties": {
+ "x": 3.141,
+ "y": 2.718,
+ "z": 1,
+ "unit": "g"
+ },
+ "desiredProperties": {
+ "x": 4,
+ "y": 3,
+ "z": 5,
+ "unit": "g"
+ }
+ }
+ }
+ },
+ "revision": 1
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_attribute_notfound.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_attribute_notfound.md
new file mode 100644
index 0000000..5f6b333
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_attribute_notfound.md
@@ -0,0 +1,18 @@
+## things:attribute.notfound
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 404,
+ "error": "things:attribute.notfound",
+ "message": "The attribute with key '/location' on the thing with ID 'org.eclipse.ditto:fancy-thing' could not be found or the requester had insufficient permissions to access it.",
+ "description": "Check if the ID of the thing and the key of your requested attribute was correct and you have sufficient permissions."
+ },
+ "status": 404
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_attribute_notmodifiable.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_attribute_notmodifiable.md
new file mode 100644
index 0000000..0b29ec0
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_attribute_notmodifiable.md
@@ -0,0 +1,18 @@
+## things:attribute.notmodifiable
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 403,
+ "error": "things:attribute.notmodifiable",
+ "message": " The Attribute with name '/location' on the Thing with ID 'org.eclipse.ditto:fancy-thing' could not be modified as the requester had insufficient permissions (WRITE is required).",
+ "description": "Check if the ID of your requested Thing was correct and you have sufficient permissions."
+ },
+ "status": 403
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_attributes_notfound.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_attributes_notfound.md
new file mode 100644
index 0000000..07424ae
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_attributes_notfound.md
@@ -0,0 +1,18 @@
+## things:attributes.notfound
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 404,
+ "error": "things:attributes.notfound",
+ "message": "The Attributes of the Thing with ID 'org.eclipse.ditto:fancy-thing' could not be found or the requester had insufficient permissions to access it.",
+ "description": "Check if the ID of the Thing was correct and you have sufficient permissions."
+ },
+ "status": 404
+}
+```
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_attributes_notmodifiable.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_attributes_notmodifiable.md
new file mode 100644
index 0000000..0b778ab
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_attributes_notmodifiable.md
@@ -0,0 +1,18 @@
+## things:attributes.notmodifiable
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 403,
+ "error": "things:attributes.notmodifiable",
+ "message": "The Attributes on the Thing with ID 'org.eclipse.ditto:fancy-thing' could not be modified as the requester had insufficient permissions (WRITE is required).",
+ "description": "Check if the ID of your requested Thing was correct and you have sufficient permissions."
+ },
+ "status": 403
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_definition_empty.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_definition_empty.md
new file mode 100644
index 0000000..8b4268b
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_definition_empty.md
@@ -0,0 +1,18 @@
+## things:feature.definition.empty
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 400,
+ "error": "things:feature.definition.empty",
+ "message": "Feature Definition must not be empty!",
+ "description": "A Feature Definition must contain at least one element. It can however also be set to null or deleted completely."
+ },
+ "status": 400
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_definition_identifier_invalid.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_definition_identifier_invalid.md
new file mode 100644
index 0000000..d8a0b19
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_definition_identifier_invalid.md
@@ -0,0 +1,18 @@
+## things:feature.definition.identifier.invalid
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 400,
+ "error": "things:feature.definition.identifier.invalid",
+ "message": "Feature Definition Identifier <foo:bar> is invalid!",
+ "description": "An Identifier string is expected to have the structure 'namespace:name:version'. Each segment must contain at least one char of [_a-zA-Z0-9\\-.]"
+ },
+ "status": 400
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_definition_notfound.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_definition_notfound.md
new file mode 100644
index 0000000..ea93f41
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_definition_notfound.md
@@ -0,0 +1,18 @@
+## things:feature.definition.notfound
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 404,
+ "error": "things:feature.definition.notfound",
+ "message": "The Definition of the Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' does not exist or the requester had insufficient permissions to access it.",
+ "description": "Check if the ID of the Thing and the Feature ID was correct and you have sufficient permissions."
+ },
+ "status": 404
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_definition_notmodifiable.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_definition_notmodifiable.md
new file mode 100644
index 0000000..ed39c1b
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_definition_notmodifiable.md
@@ -0,0 +1,18 @@
+## things:feature.definition.notmodifiable
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 403,
+ "error": "things:feature.definition.notmodifiable",
+ "message": "The Definition of the Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' cannot be modified as the requester had insufficient permissions to modify it (WRITE is required).",
+ "description": "Check if the ID of the Thing and the Feature ID was correct and you have sufficient permissions."
+ },
+ "status": 403
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_desired_properties_notfound.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_desired_properties_notfound.md
new file mode 100644
index 0000000..0f10865
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_desired_properties_notfound.md
@@ -0,0 +1,18 @@
+## things:feature.desiredProperties.notfound
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 404,
+ "error": "things:feature.desiredProperties.notfound",
+ "message": "The desired properties of the Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' do not exist or the requester had insufficient permissions to access it.",
+ "description": "Check if the ID of the Thing and the Feature ID was correct and you have sufficient permissions."
+ },
+ "status": 404
+}
+```
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_desired_properties_notmodifiable.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_desired_properties_notmodifiable.md
new file mode 100644
index 0000000..4fba3b0
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_desired_properties_notmodifiable.md
@@ -0,0 +1,18 @@
+## things:feature.desiredProperties.notmodifiable
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 403,
+ "error": "things:feature.desiredProperties.notmodifiable",
+ "message": "The desired properties of the Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' cannot be modified as the requester had insufficient permissions to modify it (WRITE is required).",
+ "description": "Check if the ID of the Thing and the Feature ID was correct and you have sufficient permissions."
+ },
+ "status": 403
+}
+```
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_desired_property_notfound.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_desired_property_notfound.md
new file mode 100644
index 0000000..9a86f7f
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_desired_property_notfound.md
@@ -0,0 +1,18 @@
+## things:feature.desiredProperty.notfound
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 404,
+ "error": "things:feature.desiredProperty.notfound",
+ "message": "The desired property with JSON Pointer '/x' of the Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' does not exist or the requester had insufficient permissions to access it.",
+ "description": "Check if the ID of the Thing, the Feature ID and the key of your requested desired property was correct and you have sufficient permissions."
+ },
+ "status": 404
+}
+```
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_desired_property_notmodifiable.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_desired_property_notmodifiable.md
new file mode 100644
index 0000000..d626a25
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_desired_property_notmodifiable.md
@@ -0,0 +1,18 @@
+## things:feature.desiredProperty.notmodifiable
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 403,
+ "error": "things:feature.desiredProperty.notmodifiable",
+ "message": "The desired property with JSON Pointer '/x' of the Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' could not be modified as the requester had insufficient permissions to modify it (WRITE is required).",
+ "description": "Check if the ID of the Thing, the Feature ID and the key of your requested desired property was correct and you have sufficient permissions."
+ },
+ "status": 403
+}
+```
\ No newline at end of file
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_notfound.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_notfound.md
new file mode 100644
index 0000000..d5edcaf
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_notfound.md
@@ -0,0 +1,18 @@
+## things:feature.notfound
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 404,
+ "error": "things:feature.notfound",
+ "message": "The Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' could not be found or the requester had insufficient permissions to access it.",
+ "description": "Check if the ID of the Thing and the ID of your requested Feature was correct and you have sufficient permissions."
+ },
+ "status": 404
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_notmodifiable.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_notmodifiable.md
new file mode 100644
index 0000000..d728b1f
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_notmodifiable.md
@@ -0,0 +1,18 @@
+## things:feature.notmodifiable
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 403,
+ "error": "things:feature.notmodifiable",
+ "message": "The Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' could not be modified as the requester had insufficient permissions to modify it (WRITE is required).",
+ "description": "Check if the ID of the Thing and the ID of your requested Feature was correct and you have sufficient permissions."
+ },
+ "status": 403
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_properties_notfound.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_properties_notfound.md
new file mode 100644
index 0000000..1b107fb
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_properties_notfound.md
@@ -0,0 +1,18 @@
+## things:feature.properties.notfound
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 404,
+ "error": "things:feature.properties.notfound",
+ "message": "The Properties of the Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' do not exist or the requester had insufficient permissions to access it.",
+ "description": "Check if the ID of the Thing and the Feature ID was correct and you have sufficient permissions."
+ },
+ "status": 404
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_properties_notmodifiable.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_properties_notmodifiable.md
new file mode 100644
index 0000000..671cf50
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_properties_notmodifiable.md
@@ -0,0 +1,18 @@
+## things:feature.properties.notmodifiable
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 403,
+ "error": "things:feature.properties.notmodifiable",
+ "message": "The Properties of the Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' cannot be modified as the requester had insufficient permissions to modify it (WRITE is required).",
+ "description": "Check if the ID of the Thing and the Feature ID was correct and you have sufficient permissions."
+ },
+ "status": 403
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_property_notfound.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_property_notfound.md
new file mode 100644
index 0000000..e767e2f
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_property_notfound.md
@@ -0,0 +1,18 @@
+## things:feature.property.notfound
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 404,
+ "error": "things:feature.property.notfound",
+ "message": "The Property with JSON Pointer '/x' of the Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' does not exist or the requester had insufficient permissions to access it.",
+ "description": "Check if the ID of the Thing, the Feature ID and the key of your requested property was correct and you have sufficient permissions."
+ },
+ "status": 404
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_property_notmodifiable.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_property_notmodifiable.md
new file mode 100644
index 0000000..c6989e8
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_feature_property_notmodifiable.md
@@ -0,0 +1,18 @@
+## things:feature.property.notmodifiable
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 403,
+ "error": "things:feature.property.notmodifiable",
+ "message": "The Property with JSON Pointer '/x' of the Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' could not be modified as the requester had insufficient permissions to modify it (WRITE is required).",
+ "description": "Check if the ID of the Thing, the Feature ID and the key of your requested property was correct and you have sufficient permissions."
+ },
+ "status": 403
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_features_notfound.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_features_notfound.md
new file mode 100644
index 0000000..558eec7
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_features_notfound.md
@@ -0,0 +1,18 @@
+## things:features.notfound
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 404,
+ "error": "things:features.notfound",
+ "message": "The Features on the Thing with ID 'org.eclipse.ditto:fancy-thing' do not exist or the requester had insufficient permissions to access it.",
+ "description": "Check if the ID of the Thing was correct and you have sufficient permissions."
+ },
+ "status": 404
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_features_notmodifiable.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_features_notmodifiable.md
new file mode 100644
index 0000000..1b1e38c
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_features_notmodifiable.md
@@ -0,0 +1,18 @@
+## things:features.notmodifiable
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 403,
+ "error": "things:features.notmodifiable",
+ "message": "The Features on the Thing with ID 'org.eclipse.ditto:fancy-thing' cannot be modified as requester had insufficient permissions to modify it (WRITE is required).",
+ "description": "Check if the ID of the Thing was correct and you have sufficient permissions."
+ },
+ "status": 403
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_id_invalid.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_id_invalid.md
new file mode 100644
index 0000000..da4235d
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_id_invalid.md
@@ -0,0 +1,19 @@
+## things:id.invalid
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 400,
+ "error": "things:id.invalid",
+ "message": "Thing ID 'invalid id' is not valid!",
+ "description": "It must conform to the namespaced entity ID notation (see Ditto documentation)",
+ "url": "https://www.eclipse.org/ditto/basic-namespaces-and-names.html#namespaced-id"
+ },
+ "status": 400
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_id_notdeletable.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_id_notdeletable.md
new file mode 100644
index 0000000..7d461b6
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_id_notdeletable.md
@@ -0,0 +1,19 @@
+## things:id.notdeletable
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "response-required": false,
+ "content-type": "application/json"
+ },
+ "path": "/",
+ "value": {
+ "status": 400,
+ "error": "things:id.notdeletable",
+ "message": "The Thing ID of a Thing cannot be deleted.",
+ "description": "Remove the Thing ID entry from the request body and retry the request."
+ },
+ "status": 400
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_id_notsettable.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_id_notsettable.md
new file mode 100644
index 0000000..d449afd
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_id_notsettable.md
@@ -0,0 +1,18 @@
+## things:id.notsettable
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 400,
+ "error": "things:id.notsettable",
+ "message": "The Thing ID in the request body is not equal to the Thing ID in the request URL.",
+ "description": "Either delete the Thing ID from the request body or use the same Thing ID as in the request URL."
+ },
+ "status": 400
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_policyId_notallowed.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_policyId_notallowed.md
new file mode 100644
index 0000000..beb9c83
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_policyId_notallowed.md
@@ -0,0 +1,18 @@
+## things:policyId.notallowed
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 400,
+ "error": "things:policyId.notallowed",
+ "message": "The Thing with ID 'org.eclipse.ditto:fancy-thing' could not be modified as it contained an inline Policy with an ID or a Policy ID and a Policy",
+ "description": "If you want to use an existing Policy, specify it as 'policyId' in the Thing JSON. If you want to create a Thing with inline Policy, no Policy ID is allowed as it will be created with the Thing ID."
+ },
+ "status": 400
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_policyId_notdeletable.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_policyId_notdeletable.md
new file mode 100644
index 0000000..bf4855b
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_policyId_notdeletable.md
@@ -0,0 +1,19 @@
+## things:policyId.notdeletable
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "response-required": false,
+ "content-type": "application/json"
+ },
+ "path": "/",
+ "value": {
+ "status": 400,
+ "error": "things:policyId.notdeletable",
+ "message": "The Policy ID of a Thing cannot be deleted.",
+ "description": "Remove Policy ID entry from the request body and retry the request."
+ },
+ "status": 400
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_policyId_notmodifiable.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_policyId_notmodifiable.md
new file mode 100644
index 0000000..88e245c
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_policyId_notmodifiable.md
@@ -0,0 +1,18 @@
+## things:policyId.notmodifiable
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 403,
+ "error": "things:policyId.notmodifiable",
+ "message": "The Policy ID of the Thing with ID 'org.eclipse.ditto:fancy-thing' could not be modified as the requester had insufficient permissions (WRITE is required).",
+ "description": "Check if the ID of your requested Thing was correct and you have sufficient permissions."
+ },
+ "status": 403
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_policy_notallowed.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_policy_notallowed.md
new file mode 100644
index 0000000..ca58f0b
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_policy_notallowed.md
@@ -0,0 +1,18 @@
+## things:policy.notallowed
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 400,
+ "error": "things:policy.notallowed",
+ "message": "The Thing with ID 'org.eclipse.ditto:fancy-thing' could not be modified as it contained an inline Policy",
+ "description": "Once a Thing with inline Policy is created it can't be modified with another Policy. Use the Policy resources to modify the existing Policy."
+ },
+ "status": 400
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_conflict.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_conflict.md
new file mode 100644
index 0000000..b0636cd
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_conflict.md
@@ -0,0 +1,18 @@
+## things:thing.conflict
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 409,
+ "error": "things:thing.conflict",
+ "message": "The Thing with ID 'org.eclipse.ditto:fancy-thing' already exists",
+ "description": "Choose another Thing ID"
+ },
+ "status": 409
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_notcreatable.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_notcreatable.md
new file mode 100644
index 0000000..ad9f6a4
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_notcreatable.md
@@ -0,0 +1,18 @@
+## things:thing.notcreatable
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 400,
+ "error": "things:thing.notcreatable",
+ "message": "The Thing with ID 'org.eclipse.ditto:fancy-thing' could not be created as the Policy with ID 'org.eclipse.ditto:the_policy_id' is not existing.",
+ "description": "Check if the ID of the Policy you created the Thing with is correct and that the Policy is existing."
+ },
+ "status": 400
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_notdeletable.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_notdeletable.md
new file mode 100644
index 0000000..2fd3096
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_notdeletable.md
@@ -0,0 +1,18 @@
+## things:thing.notdeletable
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 403,
+ "error": "things:thing.notdeletable",
+ "message": "The Thing with ID 'org.eclipse.ditto:fancy-thing' could not be deleted as the requester had insufficient permissions ( WRITE on root resource is required).",
+ "description": "Check if the ID of your requested Thing was correct and you have sufficient permissions."
+ },
+ "status": 403
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_notfound.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_notfound.md
new file mode 100644
index 0000000..281c84e
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_notfound.md
@@ -0,0 +1,18 @@
+## things:thing.notfound
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 404,
+ "error": "things:thing.notfound",
+ "message": "The Thing with ID 'org.eclipse.ditto:fancy-thing' could not be found or requester had insufficient permissions to access it.",
+ "description": "Check if the ID of your requested Thing was correct and you have sufficient permissions."
+ },
+ "status": 404
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_notmodifiable.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_notmodifiable.md
new file mode 100644
index 0000000..7ebd834
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_notmodifiable.md
@@ -0,0 +1,18 @@
+## things:thing.notmodifiable
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 403,
+ "error": "things:thing.notmodifiable",
+ "message": "The Thing with ID 'org.eclipse.ditto:fancy-thing' could not be modified as the requester had insufficient permissions (WRITE is required).",
+ "description": "Check if the ID of your requested Thing was correct and you have sufficient permissions."
+ },
+ "status": 403
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_toomanymodifyingrequests.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_toomanymodifyingrequests.md
new file mode 100644
index 0000000..c53f6aa
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_toomanymodifyingrequests.md
@@ -0,0 +1,18 @@
+## things:thing.toomanymodifyingrequests
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 429,
+ "error": "things:thing.toomanymodifyingrequests",
+ "message": "Too many modifying requests are already outstanding to the Thing with ID 'org.eclipse.ditto:fancy-thing'.",
+ "description": "Throttle your modifying requests to the Thing or re-structure your Thing in multiple Things if you really need so many concurrent modifications."
+ },
+ "status": 429
+}
+```
diff --git a/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_unavailable.md b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_unavailable.md
new file mode 100644
index 0000000..04ca494
--- /dev/null
+++ b/2.0/pages/ditto/protocol/examples/things/generated/exceptions/things_thing_unavailable.md
@@ -0,0 +1,18 @@
+## things:thing.unavailable
+
+```json
+{
+ "topic": "org.eclipse.ditto/fancy-thing/things/twin/errors",
+ "headers": {
+ "correlation-id": "<preserved-command-correlation-id>"
+ },
+ "path": "/",
+ "value": {
+ "status": 503,
+ "error": "things:thing.unavailable",
+ "message": "The Thing with ID 'org.eclipse.ditto:fancy-thing' is not available, please try again later.",
+ "description": "The requested Thing is temporarily not available."
+ },
+ "status": 503
+}
+```
diff --git a/2.0/presentations.html b/2.0/presentations.html
new file mode 100644
index 0000000..a96608b
--- /dev/null
+++ b/2.0/presentations.html
@@ -0,0 +1,1835 @@
+<!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=" presentations, slides, meetup">
+<title> Presentations • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Presentations">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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 class="active"><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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Presentations</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>This page contains a collection of presentations, videos and workshops about Eclipse Ditto, sorted from most recent ones downwards.</p>
+
+<h2 id="19102020-eclipsecon-europe-2020-community-day">19.10.2020 EclipseCon Europe 2020 Community Day</h2>
+
+<p>Topic: Project status update of Eclipse Ditto</p>
+
+<p>The slides can be found here: <a href="slides/2020_10_19-eclipse-iot-wg-community-day/index.html">2020_10_19-eclipse-iot-wg-community-day</a>.</p>
+
+<h2 id="28072020-eclipse-iot-workinggroup-status-update">28.07.2020 Eclipse IoT WorkingGroup status update</h2>
+
+<p>Topic: Eclipse Ditto: Eclipse IoT WG status update</p>
+
+<p>The slides can be found here: <a href="slides/2020_07_28-iot-wg-status-update/index.html">2020_07_28-iot-wg-status-update</a>.</p>
+
+<h2 id="16042020-the-things-network-virtual-conference-2020-stayhome">16.04.2020 The Things Network Virtual Conference 2020 #StayHome</h2>
+
+<p>Topic: Eclipse Ditto: Digital Twins as part of an open IoT platform</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/2020_04_16-ttn-virtual-conference/index.html">2020_04_16-ttn-virtual-conference</a>.</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>
+
+<p>Topic: “Digital twins with Eclipse Ditto”</p>
+
+<p>Organized via <a href="https://www.meetup.com/IoT-Hessen/events/248886802/">Meetup</a> by Diana Kupfer from codecentric.</p>
+
+<p>The slides can be found here: <a href="slides/2018_05_23-meetup-iot-hessen/index.html">2018_05_23-meetup-iot-hessen</a>.</p>
+
+<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="07022018-virtual-iot-meetup">07.02.2018 Virtual IoT Meetup</h2>
+
+<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>
+
+<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>
+
+<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">
+
+ </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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-bindings.html b/2.0/protocol-bindings.html
new file mode 100644
index 0000000..cc3ce87
--- /dev/null
+++ b/2.0/protocol-bindings.html
@@ -0,0 +1,1815 @@
+<!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, bindings, protocol">
+<title> Protocol bindings • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 bindings">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Protocol bindings</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>A protocol binding defines how the Ditto protocol messages are transported using a specific network protocol e.g.
+“Ditto Protocol over WebSocket”.
+The binding defines a set of rules how Ditto protocol messages are mapped to network protocol messages and back.</p>
+
+<p>Currently the following protocol bindings are supported:</p>
+
+<ul>
+ <li><a href="httpapi-protocol-bindings-websocket.html">WebSocket</a></li>
+ <li><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0</a></li>
+ <li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1</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>
+
+<h2 id="content-type">Content Type</h2>
+
+<p>When sending messages towards Ditto, the following content type has to be specified in a protocol-specific way given
+that the messages are already in <a href="protocol-overview.html">Ditto Protocol</a> format.</p>
+
+<p>All <a href="basic-changenotifications.html">change notifications</a> emitted by Ditto will also contain the <code class="highlighter-rouge">content-type</code>:</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>application/vnd.eclipse.ditto+json
+</code></pre></div></div>
+
+<p>For messages which are not yet in that format, the <a href="connectivity-mapping.html">payload mapping</a> of Ditto’s
+<a href="connectivity-overview.html">connectivity</a> may be used to bring the messages in that format.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-createattribute.html b/2.0/protocol-examples-createattribute.html
new file mode 100644
index 0000000..7948ed6
--- /dev/null
+++ b/2.0/protocol-examples-createattribute.html
@@ -0,0 +1,1823 @@
+<!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 attribute">
+<title> Create a single attribute • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 single attribute">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Create a single attribute</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="modifyattribute">ModifyAttribute</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">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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">"/attributes/location"</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">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">8.261719</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="modifyattributeresponse">ModifyAttributeResponse</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">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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">"/attributes/location"</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="attributecreated">AttributeCreated</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">"org.eclipse.ditto/fancy-thing/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"/attributes/location"</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">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">8.261719</span><span class="w">
+ </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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-createattributes.html b/2.0/protocol-examples-createattributes.html
new file mode 100644
index 0000000..9667fd7
--- /dev/null
+++ b/2.0/protocol-examples-createattributes.html
@@ -0,0 +1,1828 @@
+<!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 attributes">
+<title> Create attributes • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 attributes">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Create attributes</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="modifyattributes">ModifyAttributes</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">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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">"/attributes"</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">"location"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">8.261719</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="modifyattributesresponse">ModifyAttributesResponse</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">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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">"/attributes"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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="attributescreated">AttributesCreated</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">"org.eclipse.ditto/fancy-thing/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"/attributes"</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">"location"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">8.261719</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-createdefinition.html b/2.0/protocol-examples-createdefinition.html
new file mode 100644
index 0000000..d45699a
--- /dev/null
+++ b/2.0/protocol-examples-createdefinition.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=" examples, create feature definition, definition">
+<title> Create Feature Definition • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 Feature Definition">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Create Feature Definition</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="modifyfeaturedefinition">ModifyFeatureDefinition</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">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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/accelerometer/definition"</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">"org.eclipse.ditto:accelerometer:1.0.0"</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="modifyfeaturedefinitionresponse">ModifyFeatureDefinitionResponse</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">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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/accelerometer/definition"</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="featuredefinitioncreated">FeatureDefinitionCreated</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">"org.eclipse.ditto/fancy-thing/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/definition"</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">"org.eclipse.ditto:accelerometer:1.0.0"</span><span class="w">
+ </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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-createdesiredproperties.html b/2.0/protocol-examples-createdesiredproperties.html
new file mode 100644
index 0000000..af6248e
--- /dev/null
+++ b/2.0/protocol-examples-createdesiredproperties.html
@@ -0,0 +1,1826 @@
+<!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 feature desiredProperties">
+<title> Create Feature Desired Properties • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 Feature Desired Properties">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><a href="protocol-examples-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Create Feature Desired Properties</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="modifyfeaturedesiredproperties">ModifyFeatureDesiredProperties</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">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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/accelerometer/desiredProperties"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</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">"g"</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="modifyfeaturedesiredpropertiesresponse">ModifyFeatureDesiredPropertiesResponse</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">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties"</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="featuredesiredpropertiescreated">FeatureDesiredPropertiesCreated</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">"org.eclipse.ditto/fancy-thing/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</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">"g"</span><span class="w">
+ </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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-createdesiredproperty.html b/2.0/protocol-examples-createdesiredproperty.html
new file mode 100644
index 0000000..5f91699
--- /dev/null
+++ b/2.0/protocol-examples-createdesiredproperty.html
@@ -0,0 +1,1816 @@
+<!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 desiredProperty">
+<title> Create a single desired property • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 single desired property">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Create a single desired property</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="modifyfeaturedesiredproperty">ModifyFeatureDesiredProperty</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">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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/accelerometer/desiredProperties/x"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">42</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="modifyfeaturedesiredpropertyresponse">ModifyFeatureDesiredPropertyResponse</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">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties/x"</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="featuredesiredpropertycreated">FeatureDesiredPropertyCreated</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">"org.eclipse.ditto/fancy-thing/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties/x"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">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">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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-createfeature.html b/2.0/protocol-examples-createfeature.html
new file mode 100644
index 0000000..42e6b4d
--- /dev/null
+++ b/2.0/protocol-examples-createfeature.html
@@ -0,0 +1,1844 @@
+<!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 feature">
+<title> Create a single feature • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 single feature">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Create a single feature</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="modifyfeature">ModifyFeature</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">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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/accelerometer"</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">"properties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"desiredProperties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"x"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</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">"g"</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="modifyfeatureresponse">ModifyFeatureResponse</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">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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/accelerometer"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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="featurecreated">FeatureCreated</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">"org.eclipse.ditto/fancy-thing/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer"</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">"properties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"desiredProperties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"x"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</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">"g"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-createfeatures.html b/2.0/protocol-examples-createfeatures.html
new file mode 100644
index 0000000..d6119b4
--- /dev/null
+++ b/2.0/protocol-examples-createfeatures.html
@@ -0,0 +1,1848 @@
+<!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 features">
+<title> Create features • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 features">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Create features</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="modifyfeatures">ModifyFeatures</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">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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"</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">"accelerometer"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"desiredProperties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"x"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</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">"g"</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="modifyfeaturesresponse">ModifyFeaturesResponse</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">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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="featurescreated">FeaturesCreated</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">"org.eclipse.ditto/fancy-thing/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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"</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">"accelerometer"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"desiredProperties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"x"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</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">"g"</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">"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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-createproperties.html b/2.0/protocol-examples-createproperties.html
new file mode 100644
index 0000000..a69bc2d
--- /dev/null
+++ b/2.0/protocol-examples-createproperties.html
@@ -0,0 +1,1827 @@
+<!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 feature properties">
+<title> Create Feature Properties • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 Feature Properties">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Create Feature Properties</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="modifyfeatureproperties">ModifyFeatureProperties</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">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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/accelerometer/properties"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</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="modifyfeaturepropertiesresponse">ModifyFeaturePropertiesResponse</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">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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/accelerometer/properties"</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="featurepropertiescreated">FeaturePropertiesCreated</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">"org.eclipse.ditto/fancy-thing/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/properties"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</span><span class="w">
+ </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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-createproperty.html b/2.0/protocol-examples-createproperty.html
new file mode 100644
index 0000000..d02cf6e
--- /dev/null
+++ b/2.0/protocol-examples-createproperty.html
@@ -0,0 +1,1817 @@
+<!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 property">
+<title> Create a single property • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 single property">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Create a single property</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="modifyfeatureproperty">ModifyFeatureProperty</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">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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/accelerometer/properties/x"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">42</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="modifyfeaturepropertyresponse">ModifyFeaturePropertyResponse</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">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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/accelerometer/properties/x"</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="featurepropertycreated">FeaturePropertyCreated</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">"org.eclipse.ditto/fancy-thing/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/properties/x"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">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">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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-creatething.html b/2.0/protocol-examples-creatething.html
new file mode 100644
index 0000000..543e967
--- /dev/null
+++ b/2.0/protocol-examples-creatething.html
@@ -0,0 +1,1932 @@
+<!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 thing">
+<title> Create 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Create 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="creatething">CreateThing</h2>
+
+<p>Creates a new Thing with ID <code class="highlighter-rouge">org.eclipse.ditto:fancy-thing_53</code> that uses an existing Policy with ID <code class="highlighter-rouge">org.eclipse.ditto:the_policy_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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:fancy-thing_53"</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:the_policy_id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:SomeModel:1.0.0"</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="p">{</span><span class="w">
+ </span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">8.261719</span><span class="w">
+ </span><span class="p">}</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">"accelerometer"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"desiredProperties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"x"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</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="createthingresponse">CreateThingResponse</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:fancy-thing_53"</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:the_policy_id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:SomeModel:1.0.0"</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="p">{</span><span class="w">
+ </span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">8.261719</span><span class="w">
+ </span><span class="p">}</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">"accelerometer"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"desiredProperties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"x"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</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>
+
+<h2 id="thingcreated">ThingCreated</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">"org.eclipse.ditto/fancy-thing/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:fancy-thing_53"</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:the_policy_id"</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="p">{</span><span class="w">
+ </span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">8.261719</span><span class="w">
+ </span><span class="p">}</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">"accelerometer"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"desiredProperties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"x"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</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">"g"</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">"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="alternative-creatething-commands">Alternative CreateThing commands</h2>
+
+<p>If you want to copy an existing Policy instead of creating a new one by yourself or reference an existing Policy, you
+can adjust the CreateThing command like demonstrated in the following examples.</p>
+
+<h3 id="creatething-with-copied-policy-by-policy-id">CreateThing with copied Policy by Policy ID</h3>
+
+<p>Creates a new Thing with ID <code class="highlighter-rouge">org.eclipse.ditto:fancy-thing_53</code> with a Policy copied from the Policy with ID <code class="highlighter-rouge">org.eclipse.ditto:the_policy_id_to_copy</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:fancy-thing_53"</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:the_policy_id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"_copyPolicyFrom"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com:acme:the_policy_id_to_copy"</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="creatething-with-copied-policy-by-thing-reference">CreateThing with copied Policy by Thing reference</h3>
+
+<p>Creates a new Thing with ID <code class="highlighter-rouge">org.eclipse.ditto:fancy-thing_53</code> with a Policy copied from a Thing with ID <code class="highlighter-rouge">org.eclipse.ditto:fancy-thing_52</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:fancy-thing_53"</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:the_policy_id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"_copyPolicyFrom"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ ref:things/com:acme:fancy-thing_52/policyId }}"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-createthingdefinition.html b/2.0/protocol-examples-createthingdefinition.html
new file mode 100644
index 0000000..b7a56b0
--- /dev/null
+++ b/2.0/protocol-examples-createthingdefinition.html
@@ -0,0 +1,1818 @@
+<!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, definition">
+<title> Create a definition • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 definition">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Create a definition</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="modifythingdefinition">ModifyThingDefinition</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">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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">"/definition"</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">"digitaltwin:DigitaltwinExample:1.0.0"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="modifythingdefinitionresponse">ModifyThingDefinitionResponse</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">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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">"/definition"</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">"digitaltwin:DigitaltwinExample:1.0.0"</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="definitioncreated">DefinitionCreated</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">"org.eclipse.ditto/fancy-thing/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"/definition"</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">"digitaltwin:DigitaltwinExample:1.0.0"</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">2</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-deleteattribute.html b/2.0/protocol-examples-deleteattribute.html
new file mode 100644
index 0000000..6e8bcbf
--- /dev/null
+++ b/2.0/protocol-examples-deleteattribute.html
@@ -0,0 +1,1815 @@
+<!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 attribute">
+<title> Delete a single attribute • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 single attribute">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Delete a single attribute</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="deleteattribute">DeleteAttribute</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"/attributes/location"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="deleteattributeresponse">DeleteAttributeResponse</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"/attributes/location"</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="attributedeleted">AttributeDeleted</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">"org.eclipse.ditto/fancy-thing/things/twin/events/deleted"</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">"<preserved-command-correlation-id>"</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">"/attributes/location"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-deleteattributes.html b/2.0/protocol-examples-deleteattributes.html
new file mode 100644
index 0000000..135423c
--- /dev/null
+++ b/2.0/protocol-examples-deleteattributes.html
@@ -0,0 +1,1815 @@
+<!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 attributes">
+<title> Delete attributes • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 attributes">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Delete attributes</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="deleteattributes">DeleteAttributes</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"/attributes"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="deleteattributesresponse">DeleteAttributesResponse</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"/attributes"</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="attributesdeleted">AttributesDeleted</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">"org.eclipse.ditto/fancy-thing/things/twin/events/deleted"</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">"<preserved-command-correlation-id>"</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">"/attributes"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-deletedefinition.html b/2.0/protocol-examples-deletedefinition.html
new file mode 100644
index 0000000..fbc19b7
--- /dev/null
+++ b/2.0/protocol-examples-deletedefinition.html
@@ -0,0 +1,1815 @@
+<!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 feature definition, definition">
+<title> Delete Feature Definition • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 Feature Definition">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Delete Feature Definition</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="deletefeaturedefinition">DeleteFeatureDefinition</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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/accelerometer/definition"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="deletefeaturedefinitionresponse">DeleteFeatureDefinitionResponse</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/definition"</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="featuredefinitiondeleted">FeatureDefinitionDeleted</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">"org.eclipse.ditto/fancy-thing/things/twin/events/deleted"</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">"<preserved-command-correlation-id>"</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/accelerometer/definition"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-deletedesiredproperties.html b/2.0/protocol-examples-deletedesiredproperties.html
new file mode 100644
index 0000000..fda1f19
--- /dev/null
+++ b/2.0/protocol-examples-deletedesiredproperties.html
@@ -0,0 +1,1814 @@
+<!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 feature desiredProperties">
+<title> Delete Feature Desired Properties • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 Feature Desired Properties">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Delete Feature Desired Properties</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="deletefeaturedesiredproperties">DeleteFeatureDesiredProperties</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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/accelerometer/desiredProperties"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="deletefeaturedesiredpropertiesresponse">DeleteFeatureDesiredPropertiesResponse</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties"</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="featuredesiredpropertiesdeleted">FeatureDesiredPropertiesDeleted</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">"org.eclipse.ditto/fancy-thing/things/twin/events/deleted"</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">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-deletedesiredproperty.html b/2.0/protocol-examples-deletedesiredproperty.html
new file mode 100644
index 0000000..3216f7e
--- /dev/null
+++ b/2.0/protocol-examples-deletedesiredproperty.html
@@ -0,0 +1,1814 @@
+<!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 desiredProperty">
+<title> Delete a single desired property • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 single desired property">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Delete a single desired property</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="deletefeaturedesiredproperty">DeleteFeatureDesiredProperty</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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/accelerometer/desiredProperties/x"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="deletefeaturedesiredpropertyresponse">DeleteFeatureDesiredPropertyResponse</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties/x"</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="featuredesiredpropertydeleted">FeatureDesiredPropertyDeleted</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">"org.eclipse.ditto/fancy-thing/things/twin/events/deleted"</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">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties/x"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-deletefeature.html b/2.0/protocol-examples-deletefeature.html
new file mode 100644
index 0000000..ee1800b
--- /dev/null
+++ b/2.0/protocol-examples-deletefeature.html
@@ -0,0 +1,1815 @@
+<!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 feature">
+<title> Delete a single feature • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 single feature">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Delete a single feature</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="deletefeature">DeleteFeature</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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/accelerometer"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="deletefeatureresponse">DeleteFeatureResponse</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer"</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="featuredeleted">FeatureDeleted</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">"org.eclipse.ditto/fancy-thing/things/twin/events/deleted"</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">"<preserved-command-correlation-id>"</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/accelerometer"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-deletefeatures.html b/2.0/protocol-examples-deletefeatures.html
new file mode 100644
index 0000000..ae77d2d
--- /dev/null
+++ b/2.0/protocol-examples-deletefeatures.html
@@ -0,0 +1,1815 @@
+<!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 features">
+<title> Delete features • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 features">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Delete features</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="deletefeatures">DeleteFeatures</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="deletefeaturesresponse">DeleteFeaturesResponse</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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"</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="featuresdeleted">FeaturesDeleted</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">"org.eclipse.ditto/fancy-thing/things/twin/events/deleted"</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">"<preserved-command-correlation-id>"</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"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-deleteproperties.html b/2.0/protocol-examples-deleteproperties.html
new file mode 100644
index 0000000..3bdce81
--- /dev/null
+++ b/2.0/protocol-examples-deleteproperties.html
@@ -0,0 +1,1815 @@
+<!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 feature properties">
+<title> Delete Feature Properties • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 Feature Properties">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Delete Feature Properties</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="deletefeatureproperties">DeleteFeatureProperties</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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/accelerometer/properties"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="deletefeaturepropertiesresponse">DeleteFeaturePropertiesResponse</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/properties"</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="featurepropertiesdeleted">FeaturePropertiesDeleted</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">"org.eclipse.ditto/fancy-thing/things/twin/events/deleted"</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">"<preserved-command-correlation-id>"</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/accelerometer/properties"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-deleteproperty.html b/2.0/protocol-examples-deleteproperty.html
new file mode 100644
index 0000000..eba777d
--- /dev/null
+++ b/2.0/protocol-examples-deleteproperty.html
@@ -0,0 +1,1815 @@
+<!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 property">
+<title> Delete a single property • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 single property">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Delete a single property</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="deletefeatureproperty">DeleteFeatureProperty</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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/accelerometer/properties/x"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="deletefeaturepropertyresponse">DeleteFeaturePropertyResponse</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/properties/x"</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="featurepropertydeleted">FeaturePropertyDeleted</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">"org.eclipse.ditto/fancy-thing/things/twin/events/deleted"</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">"<preserved-command-correlation-id>"</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/accelerometer/properties/x"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-deletething.html b/2.0/protocol-examples-deletething.html
new file mode 100644
index 0000000..a986444
--- /dev/null
+++ b/2.0/protocol-examples-deletething.html
@@ -0,0 +1,1815 @@
+<!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 thing">
+<title> Delete 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Delete 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="deletething">DeleteThing</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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="deletethingresponse">DeleteThingResponse</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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>
+
+<h2 id="thingdeleted">ThingDeleted</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">"org.eclipse.ditto/fancy-thing/things/twin/events/deleted"</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">"<preserved-command-correlation-id>"</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">"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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-deletethingdefinition.html b/2.0/protocol-examples-deletethingdefinition.html
new file mode 100644
index 0000000..5f02ee5
--- /dev/null
+++ b/2.0/protocol-examples-deletethingdefinition.html
@@ -0,0 +1,1815 @@
+<!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, definition">
+<title> Delete a definition • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 definition">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Delete a definition</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="deletethingdefinition">DeleteThingDefinition</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"/definition"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="deletethingdefinitionresponse">DeleteThingDefinitionResponse</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"/definition"</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="definitiondeleted">DefinitionDeleted</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">"org.eclipse.ditto/fancy-thing/things/twin/events/deleted"</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">"<preserved-command-correlation-id>"</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">"/definition"</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">3</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-errorresponses.html b/2.0/protocol-examples-errorresponses.html
new file mode 100644
index 0000000..bba3d46
--- /dev/null
+++ b/2.0/protocol-examples-errorresponses.html
@@ -0,0 +1,2292 @@
+<!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, things error responses, error responses">
+<title> Things 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Things 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired Property</a></li>
+
+
+
+
+
+ <li class="active"><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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Things 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>
+
+
+
+
+
+
+
+
+
+ <p>The following listed example errors do not claim to be a complete list of all available and possible error responses.<br />
+Also, their texts and <strong>error</strong> codes might be outdated.</p>
+
+<p>In order to find out all currently available errors, please inspect Ditto’s codebase and look at all implementations of
+the <code class="highlighter-rouge">ThingException</code> interface.</p>
+
+<h2 id="thingsattributenotmodifiable">things:attribute.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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:attribute.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 Attribute with name '/location' on the Thing with ID 'org.eclipse.ditto:fancy-thing' could not be modified as the requester had insufficient permissions (WRITE is required)."</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 Thing 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="thingsattributesnotfound">things:attributes.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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:attributes.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 Attributes of the Thing with ID 'org.eclipse.ditto:fancy-thing' could not be found or the 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 Thing 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="thingsattributesnotmodifiable">things:attributes.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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:attributes.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 Attributes on the Thing with ID 'org.eclipse.ditto:fancy-thing' could not be modified as the requester had insufficient permissions (WRITE is required)."</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 Thing 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="thingsfeaturenotfound">things:feature.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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:feature.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 Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' could not be found or the 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 Thing and the ID of your requested Feature 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="thingsfeaturenotmodifiable">things:feature.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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:feature.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 Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' could not be modified as the requester had insufficient permissions to modify it (WRITE is required)."</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 Thing and the ID of your requested Feature 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="thingsfeaturepropertiesnotfound">things:feature.properties.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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:feature.properties.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 Properties of the Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' do not exist or the 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 Thing and the Feature ID 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="thingsfeaturepropertiesnotmodifiable">things:feature.properties.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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:feature.properties.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 Properties of the Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' cannot be modified as the requester had insufficient permissions to modify it (WRITE is required)."</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 Thing and the Feature ID 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="thingsfeaturepropertynotfound">things:feature.property.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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:feature.property.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 Property with JSON Pointer '/x' of the Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' does not exist or the 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 Thing, the Feature ID and the key of your requested property 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="thingsfeaturepropertynotmodifiable">things:feature.property.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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:feature.property.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 Property with JSON Pointer '/x' of the Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' could not be modified as the requester had insufficient permissions to modify it (WRITE is required)."</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 Thing, the Feature ID and the key of your requested property 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="thingsfeaturedesiredpropertiesnotfound">things:feature.desiredProperties.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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:feature.desiredProperties.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 desired properties of the Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' do not exist or the 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 Thing and the Feature ID 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="thingsfeaturedesiredpropertiesnotmodifiable">things:feature.desiredProperties.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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:feature.desiredProperties.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 desired properties of the Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' cannot be modified as the requester had insufficient permissions to modify it (WRITE is required)."</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 Thing and the Feature ID 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="thingsfeaturedesiredpropertynotfound">things:feature.desiredProperty.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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:feature.desiredProperty.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 desired property with JSON Pointer '/x' of the Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' does not exist or the 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 Thing, the Feature ID and the key of your requested desired property 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="thingsfeaturedesiredpropertynotmodifiable">things:feature.desiredProperty.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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:feature.desiredProperty.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 desired property with JSON Pointer '/x' of the Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' could not be modified as the requester had insufficient permissions to modify it (WRITE is required)."</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 Thing, the Feature ID and the key of your requested desired property 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="thingsfeaturesnotfound">things:features.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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:features.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 Features on the Thing with ID 'org.eclipse.ditto:fancy-thing' do not exist or the 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 Thing 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="thingsfeaturesnotmodifiable">things:features.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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:features.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 Features on the Thing with ID 'org.eclipse.ditto:fancy-thing' cannot be modified as requester had insufficient permissions to modify it (WRITE is required)."</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 Thing 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="thingsidinvalid">things: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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things: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">"Thing 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">"url"</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="thingsidnotsettable">things:id.notsettable</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:id.notsettable"</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 Thing ID in the request body is not equal to the Thing ID in the request URL."</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">"Either delete the Thing ID from the request body or use the same Thing ID as in the request URL."</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="thingspolicynotallowed">things:policy.notallowed</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:policy.notallowed"</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 Thing with ID 'org.eclipse.ditto:fancy-thing' could not be modified as it contained an inline Policy"</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">"Once a Thing with inline Policy is created it can't be modified with another Policy. Use the Policy resources to modify the existing 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">400</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="thingspolicyidnotmodifiable">things:policyId.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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:policyId.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 ID of the Thing with ID 'org.eclipse.ditto:fancy-thing' could not be modified as the requester had insufficient permissions (WRITE is required)."</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 Thing 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="thingsthingconflict">things:thing.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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:thing.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 Thing with ID 'org.eclipse.ditto:fancy-thing' 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 Thing 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="thingsthingnotcreatable">things:thing.notcreatable</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:thing.notcreatable"</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 Thing with ID 'org.eclipse.ditto:fancy-thing' could not be created as the Policy with ID 'org.eclipse.ditto:the_policy_id' is not existing."</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 you created the Thing with is correct and that the Policy is existing."</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="thingsthingnotdeletable">things:thing.notdeletable</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:thing.notdeletable"</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 Thing with ID 'org.eclipse.ditto:fancy-thing' could not be deleted as the requester had insufficient permissions ( WRITE on root resource is required)."</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 Thing 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="thingsthingnotfound">things:thing.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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:thing.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 Thing with ID 'org.eclipse.ditto:fancy-thing' 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 Thing 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="thingsthingnotmodifiable">things:thing.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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:thing.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 Thing with ID 'org.eclipse.ditto:fancy-thing' could not be modified as the requester had insufficient permissions (WRITE is required)."</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 Thing 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="thingsthingtoomanymodifyingrequests">things:thing.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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:thing.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 Thing with ID 'org.eclipse.ditto:fancy-thing'."</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 Thing or re-structure your Thing in multiple Things 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="thingsthingunavailable">things:thing.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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:thing.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 Thing with ID 'org.eclipse.ditto:fancy-thing' 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 Thing 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="thingsidnotdeletable">things:id.notdeletable</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"response-required"</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">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/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">"things:id.notdeletable"</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 Thing ID of a Thing cannot be deleted."</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">"Remove the Thing ID entry from the request body and retry the request."</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="thingspolicyidnotdeletable">things:policyId.notdeletable</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"response-required"</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">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/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">"things:policyId.notdeletable"</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 ID of a Thing cannot be deleted."</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">"Remove Policy ID entry from the request body and retry the request."</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>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-mergeattribute.html b/2.0/protocol-examples-mergeattribute.html
new file mode 100644
index 0000000..a0014fd
--- /dev/null
+++ b/2.0/protocol-examples-mergeattribute.html
@@ -0,0 +1,1837 @@
+<!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, merge attribute">
+<title> Merge a single attribute 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Merge a single attribute 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Merge a single attribute 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="merge-thing-command-at-attributeslocation">Merge thing command at /attributes/location</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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/merge-patch+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">"<command-correlation-id>"</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">"/attributes/location"</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">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">8.261719</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="merge-thing-command-response-at-attributeslocation">Merge thing command response at /attributes/location</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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">"<preserved-command-correlation-id>"</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">"/attributes/location"</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="thing-merged-event-at-attributeslocation">Thing merged event at /attributes/location</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">"org.eclipse.ditto/fancy-thing/things/twin/events/merged"</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/merge-patch+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">"/attributes/location"</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">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">8.261719</span><span class="w">
+ </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">42</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"timestamp"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2021-01-18T09:42:12Z"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="merge-thing-command-deleting-attributeslocation">Merge thing command deleting /attributes/location</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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/merge-patch+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">"<command-correlation-id>"</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">"/attributes/location"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-mergeattributes.html b/2.0/protocol-examples-mergeattributes.html
new file mode 100644
index 0000000..5bf25ca
--- /dev/null
+++ b/2.0/protocol-examples-mergeattributes.html
@@ -0,0 +1,1841 @@
+<!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, merge attributes">
+<title> Merge all attributes 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Merge all attributes 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Merge all attributes 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="merge-thing-command-at-attributes">Merge thing command at /attributes</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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/merge-patch+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">"<command-correlation-id>"</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">"/attributes"</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">"location"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">8.261719</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="merge-thing-command-response-at-attributes">Merge thing command response at /attributes</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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">"<preserved-command-correlation-id>"</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">"/attributes"</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="thing-merged-event-at-attributes">Thing merged event at /attributes</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">"org.eclipse.ditto/fancy-thing/things/twin/events/merged"</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/merge-patch+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">"/attributes"</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">"location"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">8.261719</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </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">42</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"timestamp"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2021-01-18T09:42:12Z"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="merge-thing-command-deleting-attributes">Merge thing command deleting /attributes</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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/merge-patch+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">"<command-correlation-id>"</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">"/attributes"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-mergedesiredproperties.html b/2.0/protocol-examples-mergedesiredproperties.html
new file mode 100644
index 0000000..60a71d9
--- /dev/null
+++ b/2.0/protocol-examples-mergedesiredproperties.html
@@ -0,0 +1,1841 @@
+<!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, merge feature desired properties">
+<title> Merge all desired properties of a feature • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Merge all desired properties of a feature">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Merge all desired properties of a feature</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="merge-thing-command-at-featuresaccelerometerdesiredproperties">Merge thing command at /features/accelerometer/desiredProperties</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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/merge-patch+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">"<command-correlation-id>"</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/accelerometer/desiredProperties"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</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="merge-thing-command-response-at-featuresaccelerometerdesiredproperties">Merge thing command response at /features/accelerometer/desiredProperties</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties"</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="thing-merged-event-at-featuresaccelerometerdesiredproperties">Thing merged event at /features/accelerometer/desiredProperties</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">"org.eclipse.ditto/fancy-thing/things/twin/events/merged"</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/merge-patch+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">"/features/accelerometer/desiredProperties"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</span><span class="w">
+ </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">42</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"timestamp"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2021-01-18T09:42:12Z"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="merge-thing-command-deleting-featuresaccelerometerdesiredproperties">Merge thing command deleting /features/accelerometer/desiredProperties</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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/merge-patch+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">"<command-correlation-id>"</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/accelerometer/desiredProperties"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-mergedesiredproperty.html b/2.0/protocol-examples-mergedesiredproperty.html
new file mode 100644
index 0000000..18a03c2
--- /dev/null
+++ b/2.0/protocol-examples-mergedesiredproperty.html
@@ -0,0 +1,1831 @@
+<!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, merge feature desired property">
+<title> Merge a single desired property of a feature • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Merge a single desired property of a feature">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Merge a single desired property of a feature</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="merge-thing-command-at-featuresaccelerometerdesiredpropertiesx">Merge thing command at /features/accelerometer/desiredProperties/x</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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/merge-patch+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">"<command-correlation-id>"</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/accelerometer/desiredProperties/x"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">42</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="merge-thing-command-response-at-featuresaccelerometerdesiredpropertiesx">Merge thing command response at /features/accelerometer/desiredProperties/x</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties/x"</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="thing-merged-event-at-featuresaccelerometerdesiredpropertiesx">Thing merged event at /features/accelerometer/desiredProperties/x</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">"org.eclipse.ditto/fancy-thing/things/twin/events/merged"</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/merge-patch+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">"/features/accelerometer/desiredProperties/x"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">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">42</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"timestamp"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2021-01-18T09:42:12Z"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="merge-thing-command-deleting-featuresaccelerometerdesiredpropertiesx">Merge thing command deleting /features/accelerometer/desiredProperties/x</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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/merge-patch+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">"<command-correlation-id>"</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/accelerometer/desiredProperties/x"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-mergefeature.html b/2.0/protocol-examples-mergefeature.html
new file mode 100644
index 0000000..fd768a2
--- /dev/null
+++ b/2.0/protocol-examples-mergefeature.html
@@ -0,0 +1,1851 @@
+<!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, merge feature">
+<title> Merge a single feature 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Merge a single feature 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Merge a single feature 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="merge-thing-command-at-featuresaccelerometer">Merge thing command at /features/accelerometer</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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/merge-patch+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">"<command-correlation-id>"</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/accelerometer"</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">"definition"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"org.eclipse.ditto:accelerometer:1.0.0"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</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="merge-thing-command-response-at-featuresaccelerometer">Merge thing command response at /features/accelerometer</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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">"<preserved-command-correlation-id>"</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/accelerometer"</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="thing-merged-event-at-featuresaccelerometer">Thing merged event at /features/accelerometer</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">"org.eclipse.ditto/fancy-thing/things/twin/events/merged"</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/merge-patch+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">"/features/accelerometer"</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">"definition"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"org.eclipse.ditto:accelerometer:1.0.0"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </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">42</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"timestamp"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2021-01-18T09:42:12Z"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="merge-thing-command-deleting-featuresaccelerometer">Merge thing command deleting /features/accelerometer</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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/merge-patch+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">"<command-correlation-id>"</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/accelerometer"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-mergefeaturedefinition.html b/2.0/protocol-examples-mergefeaturedefinition.html
new file mode 100644
index 0000000..4640ada
--- /dev/null
+++ b/2.0/protocol-examples-mergefeaturedefinition.html
@@ -0,0 +1,1835 @@
+<!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, merge feature definition">
+<title> Merge the definition of a feature • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Merge the definition of a feature">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Merge the definition of a feature</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="merge-thing-command-at-featuresaccelerometerdefinition">Merge thing command at /features/accelerometer/definition</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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/merge-patch+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">"<command-correlation-id>"</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/accelerometer/definition"</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">"org.eclipse.ditto:accelerometer:1.0.0"</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="merge-thing-command-response-at-featuresaccelerometerdefinition">Merge thing command response at /features/accelerometer/definition</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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">"<preserved-command-correlation-id>"</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/accelerometer/definition"</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="thing-merged-event-at-featuresaccelerometerdefinition">Thing merged event at /features/accelerometer/definition</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">"org.eclipse.ditto/fancy-thing/things/twin/events/merged"</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/merge-patch+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">"/features/accelerometer/definition"</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">"org.eclipse.ditto:accelerometer:1.0.0"</span><span class="w">
+ </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">42</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"timestamp"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2021-01-18T09:42:12Z"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="merge-thing-command-deleting-featuresaccelerometerdefinition">Merge thing command deleting /features/accelerometer/definition</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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/merge-patch+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">"<command-correlation-id>"</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/accelerometer/definition"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-mergefeatures.html b/2.0/protocol-examples-mergefeatures.html
new file mode 100644
index 0000000..3465b0f
--- /dev/null
+++ b/2.0/protocol-examples-mergefeatures.html
@@ -0,0 +1,1855 @@
+<!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, merge features">
+<title> Merge all features 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Merge all features 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Merge all features 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="merge-thing-command-at-features">Merge thing command at /features</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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/merge-patch+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">"<command-correlation-id>"</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"</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">"accelerometer"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"org.eclipse.ditto:accelerometer:1.0.0"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</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="merge-thing-command-response-at-features">Merge thing command response at /features</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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">"<preserved-command-correlation-id>"</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"</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="thing-merged-event-at-features">Thing merged event at /features</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">"org.eclipse.ditto/fancy-thing/things/twin/events/merged"</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/merge-patch+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">"/features"</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">"accelerometer"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"org.eclipse.ditto:accelerometer:1.0.0"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</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">"revision"</span><span class="p">:</span><span class="w"> </span><span class="mi">42</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"timestamp"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2021-01-18T09:42:12Z"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="merge-thing-command-deleting-features">Merge thing command deleting /features</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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/merge-patch+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">"<command-correlation-id>"</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"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-mergepolicyid.html b/2.0/protocol-examples-mergepolicyid.html
new file mode 100644
index 0000000..ab7faf8
--- /dev/null
+++ b/2.0/protocol-examples-mergepolicyid.html
@@ -0,0 +1,1818 @@
+<!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, merge policy id">
+<title> Merge a 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Merge a 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Merge a 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="merge-thing-command-at-policyid">Merge thing command at /policyId</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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/merge-patch+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">"<command-correlation-id>"</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">"org.eclipse.ditto:the_policy_id"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="merge-thing-command-response-at-policyid">Merge thing command response at /policyId</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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">"<preserved-command-correlation-id>"</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="thing-merged-event-at-policyid">Thing merged event at /policyId</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">"org.eclipse.ditto/fancy-thing/things/twin/events/merged"</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/merge-patch+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">"/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">"org.eclipse.ditto: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">42</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"timestamp"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2021-01-18T09:42:12Z"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-mergeproperties.html b/2.0/protocol-examples-mergeproperties.html
new file mode 100644
index 0000000..9a131bc
--- /dev/null
+++ b/2.0/protocol-examples-mergeproperties.html
@@ -0,0 +1,1841 @@
+<!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, merge feature properties">
+<title> Merge all properties of a feature • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Merge all properties of a feature">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Merge all properties of a feature</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="merge-thing-command-at-featuresaccelerometerproperties">Merge thing command at /features/accelerometer/properties</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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/merge-patch+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">"<command-correlation-id>"</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/accelerometer/properties"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</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="merge-thing-command-response-at-featuresaccelerometerproperties">Merge thing command response at /features/accelerometer/properties</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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">"<preserved-command-correlation-id>"</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/accelerometer/properties"</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="thing-merged-event-at-featuresaccelerometerproperties">Thing merged event at /features/accelerometer/properties</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">"org.eclipse.ditto/fancy-thing/things/twin/events/merged"</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/merge-patch+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">"/features/accelerometer/properties"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</span><span class="w">
+ </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">42</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"timestamp"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2021-01-18T09:42:12Z"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="merge-thing-command-deleting-featuresaccelerometerproperties">Merge thing command deleting /features/accelerometer/properties</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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/merge-patch+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">"<command-correlation-id>"</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/accelerometer/properties"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-mergeproperty.html b/2.0/protocol-examples-mergeproperty.html
new file mode 100644
index 0000000..ec49d6c
--- /dev/null
+++ b/2.0/protocol-examples-mergeproperty.html
@@ -0,0 +1,1831 @@
+<!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, merge feature property">
+<title> Merge a single property of a feature • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Merge a single property of a feature">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Merge a single property of a feature</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="merge-thing-command-at-featuresaccelerometerpropertiesx">Merge thing command at /features/accelerometer/properties/x</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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/merge-patch+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">"<command-correlation-id>"</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/accelerometer/properties/x"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">42</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="merge-thing-command-response-at-featuresaccelerometerpropertiesx">Merge thing command response at /features/accelerometer/properties/x</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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">"<preserved-command-correlation-id>"</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/accelerometer/properties/x"</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="thing-merged-event-at-featuresaccelerometerpropertiesx">Thing merged event at /features/accelerometer/properties/x</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">"org.eclipse.ditto/fancy-thing/things/twin/events/merged"</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/merge-patch+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">"/features/accelerometer/properties/x"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">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">42</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"timestamp"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2021-01-18T09:42:12Z"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="merge-thing-command-deleting-featuresaccelerometerpropertiesx">Merge thing command deleting /features/accelerometer/properties/x</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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/merge-patch+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">"<command-correlation-id>"</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/accelerometer/properties/x"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-mergething.html b/2.0/protocol-examples-mergething.html
new file mode 100644
index 0000000..a89d3af
--- /dev/null
+++ b/2.0/protocol-examples-mergething.html
@@ -0,0 +1,1864 @@
+<!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, merge thing">
+<title> Merge 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Merge 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li class="active"><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Merge 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="merge-thing-command-at-">Merge thing command at /</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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/merge-patch+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">"<command-correlation-id>"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:fancy-thing_53"</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:the_policy_id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:SomeModel:1.0.0"</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="p">{</span><span class="w">
+ </span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">8.261719</span><span class="w">
+ </span><span class="p">}</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">"accelerometer"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"org.eclipse.ditto:accelerometer:1.0.0"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</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="merge-thing-command-response-at-">Merge thing command response at /</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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">"<preserved-command-correlation-id>"</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>
+
+<h2 id="thing-merged-event-at-">Thing merged event at /</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">"org.eclipse.ditto/fancy-thing/things/twin/events/merged"</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/merge-patch+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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:fancy-thing_53"</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:the_policy_id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:SomeModel:1.0.0"</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="p">{</span><span class="w">
+ </span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">8.261719</span><span class="w">
+ </span><span class="p">}</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">"accelerometer"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"org.eclipse.ditto:accelerometer:1.0.0"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</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">"revision"</span><span class="p">:</span><span class="w"> </span><span class="mi">42</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"timestamp"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2021-01-18T09:42:12Z"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-mergethingdefinition.html b/2.0/protocol-examples-mergethingdefinition.html
new file mode 100644
index 0000000..2655bf7
--- /dev/null
+++ b/2.0/protocol-examples-mergethingdefinition.html
@@ -0,0 +1,1831 @@
+<!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, merge definition">
+<title> Merge the definition 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Merge the definition 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Merge the definition 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="merge-thing-command-at-definition">Merge thing command at /definition</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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/merge-patch+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">"<command-correlation-id>"</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">"/definition"</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">"org.eclipse.ditto:SomeModel:1.0.0"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="merge-thing-command-response-at-definition">Merge thing command response at /definition</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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">"<preserved-command-correlation-id>"</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">"/definition"</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="thing-merged-event-at-definition">Thing merged event at /definition</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">"org.eclipse.ditto/fancy-thing/things/twin/events/merged"</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/merge-patch+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">"/definition"</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">"org.eclipse.ditto:SomeModel:1.0.0"</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">42</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"timestamp"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2021-01-18T09:42:12Z"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="merge-thing-command-deleting-definition">Merge thing command deleting /definition</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">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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/merge-patch+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">"<command-correlation-id>"</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">"/definition"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-modifyattribute.html b/2.0/protocol-examples-modifyattribute.html
new file mode 100644
index 0000000..e365de9
--- /dev/null
+++ b/2.0/protocol-examples-modifyattribute.html
@@ -0,0 +1,1823 @@
+<!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 attribute">
+<title> Modify a single attribute • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 single attribute">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Modify a single attribute</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="modifyattribute">ModifyAttribute</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">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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">"/attributes/location"</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">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">8.261719</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="modifyattributeresponse">ModifyAttributeResponse</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">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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">"/attributes/location"</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="attributemodified">AttributeModified</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">"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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"/attributes/location"</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">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">8.261719</span><span class="w">
+ </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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-modifyattributes.html b/2.0/protocol-examples-modifyattributes.html
new file mode 100644
index 0000000..1cb38cf
--- /dev/null
+++ b/2.0/protocol-examples-modifyattributes.html
@@ -0,0 +1,1828 @@
+<!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 attributes">
+<title> Modify attributes • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 attributes">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Modify attributes</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="modifyattributes">ModifyAttributes</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">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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">"/attributes"</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">"location"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">8.261719</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="modifyattributesresponse">ModifyAttributesResponse</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">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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">"/attributes"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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="attributesmodified">AttributesModified</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">"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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"/attributes"</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">"location"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">8.261719</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-modifydefinition.html b/2.0/protocol-examples-modifydefinition.html
new file mode 100644
index 0000000..5fe692a
--- /dev/null
+++ b/2.0/protocol-examples-modifydefinition.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=" examples, modify feature definition, definition">
+<title> Modify Feature Definition • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 Feature Definition">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Modify Feature Definition</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="modifyfeaturedefinition">ModifyFeatureDefinition</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">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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/accelerometer/definition"</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">"org.eclipse.ditto:accelerometer:1.0.0"</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="modifyfeaturedefinitionresponse">ModifyFeatureDefinitionResponse</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">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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/accelerometer/definition"</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="featuredefinitionmodified">FeatureDefinitionModified</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">"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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/definition"</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">"org.eclipse.ditto:accelerometer:1.0.0"</span><span class="w">
+ </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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-modifydesiredproperties.html b/2.0/protocol-examples-modifydesiredproperties.html
new file mode 100644
index 0000000..f736311
--- /dev/null
+++ b/2.0/protocol-examples-modifydesiredproperties.html
@@ -0,0 +1,1826 @@
+<!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 feature desiredProperties">
+<title> Modify Feature Desired Properties • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 Feature Desired Properties">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Modify Feature Desired Properties</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="modifyfeaturedesiredproperties">ModifyFeatureDesiredProperties</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">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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/accelerometer/desiredProperties"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</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">"g"</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="modifyfeaturedesiredpropertiesresponse">ModifyFeatureDesiredPropertiesResponse</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">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties"</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="featuredesiredpropertiesmodified">FeatureDesiredPropertiesModified</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">"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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</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">"g"</span><span class="w">
+ </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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-modifydesiredproperty.html b/2.0/protocol-examples-modifydesiredproperty.html
new file mode 100644
index 0000000..d72c142
--- /dev/null
+++ b/2.0/protocol-examples-modifydesiredproperty.html
@@ -0,0 +1,1816 @@
+<!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 desiredProperty">
+<title> Modify a single desired property • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 single desired property">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Modify a single desired property</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="modifyfeaturedesiredproperty">ModifyFeatureDesiredProperty</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">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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/accelerometer/desiredProperties/x"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">42</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="modifyfeaturedesiredpropertyresponse">ModifyFeatureDesiredPropertyResponse</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">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties/x"</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="featuredesiredpropertymodified">FeatureDesiredPropertyModified</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">"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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties/x"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">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">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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-modifyfeature.html b/2.0/protocol-examples-modifyfeature.html
new file mode 100644
index 0000000..ab36cf7
--- /dev/null
+++ b/2.0/protocol-examples-modifyfeature.html
@@ -0,0 +1,1844 @@
+<!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 feature">
+<title> Modify a single feature • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 single feature">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Modify a single feature</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="modifyfeature">ModifyFeature</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">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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/accelerometer"</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">"properties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"desiredProperties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"x"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</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">"g"</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="modifyfeatureresponse">ModifyFeatureResponse</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">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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/accelerometer"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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="featuremodified">FeatureModified</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">"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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer"</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">"properties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"desiredProperties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"x"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</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">"g"</span><span class="w">
+ </span><span class="p">}</span><span class="w">
+ </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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-modifyfeatures.html b/2.0/protocol-examples-modifyfeatures.html
new file mode 100644
index 0000000..397d00f
--- /dev/null
+++ b/2.0/protocol-examples-modifyfeatures.html
@@ -0,0 +1,1848 @@
+<!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 features">
+<title> Modify features • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 features">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Modify features</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="modifyfeatures">ModifyFeatures</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">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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"</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">"accelerometer"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"desiredProperties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"x"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</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">"g"</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="modifyfeaturesresponse">ModifyFeaturesResponse</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">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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="featuresmodified">FeaturesModified</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">"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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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"</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">"accelerometer"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"desiredProperties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"x"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</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">"g"</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">"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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-modifypolicyid.html b/2.0/protocol-examples-modifypolicyid.html
new file mode 100644
index 0000000..6c70019
--- /dev/null
+++ b/2.0/protocol-examples-modifypolicyid.html
@@ -0,0 +1,1843 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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">"org.eclipse.ditto: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">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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">"org.eclipse.ditto: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">"org.eclipse.ditto/fancy-thing/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"org.eclipse.ditto: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">"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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"org.eclipse.ditto: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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-modifyproperties.html b/2.0/protocol-examples-modifyproperties.html
new file mode 100644
index 0000000..a509283
--- /dev/null
+++ b/2.0/protocol-examples-modifyproperties.html
@@ -0,0 +1,1827 @@
+<!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 feature properties">
+<title> Modify Feature Properties • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 Feature Properties">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Modify Feature Properties</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="modifyfeatureproperties">ModifyFeatureProperties</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">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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/accelerometer/properties"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</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="modifyfeaturepropertiesresponse">ModifyFeaturePropertiesResponse</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">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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/accelerometer/properties"</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="featurepropertiesmodified">FeaturePropertiesModified</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">"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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/properties"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</span><span class="w">
+ </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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-modifyproperty.html b/2.0/protocol-examples-modifyproperty.html
new file mode 100644
index 0000000..3611c19
--- /dev/null
+++ b/2.0/protocol-examples-modifyproperty.html
@@ -0,0 +1,1817 @@
+<!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 property">
+<title> Modify a single property • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 single property">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Modify a single property</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="modifyfeatureproperty">ModifyFeatureProperty</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">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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/accelerometer/properties/x"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">42</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="modifyfeaturepropertyresponse">ModifyFeaturePropertyResponse</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">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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/accelerometer/properties/x"</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="featurepropertymodified">FeaturePropertyModified</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">"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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/properties/x"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">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">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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-modifything.html b/2.0/protocol-examples-modifything.html
new file mode 100644
index 0000000..bf39da9
--- /dev/null
+++ b/2.0/protocol-examples-modifything.html
@@ -0,0 +1,1913 @@
+<!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 thing">
+<title> Modify 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Modify 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="modifything">ModifyThing</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">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:fancy-thing_53"</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:the_policy_id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:SomeModel:1.0.0"</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="p">{</span><span class="w">
+ </span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">8.261719</span><span class="w">
+ </span><span class="p">}</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">"accelerometer"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"desiredProperties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"x"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</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">"g"</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="modifythingresponse">ModifyThingResponse</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">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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>
+
+<h2 id="thingmodified">ThingModified</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">"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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:fancy-thing_53"</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:the_policy_id"</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="p">{</span><span class="w">
+ </span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">8.261719</span><span class="w">
+ </span><span class="p">}</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">"accelerometer"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"desiredProperties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"x"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</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">"g"</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">"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="alternative-modifything-commands">Alternative ModifyThing commands</h2>
+
+<p>If you want to copy an existing Policy instead of creating a new one by yourself or reference an existing Policy, you
+can adjust the ModifyThing command like demonstrated in the following examples.<br />
+This only works if a Thing with the given <code class="highlighter-rouge">thingId</code> does not exist, yet. If it exists the <code class="highlighter-rouge">_copyPolicyFrom</code> field
+will be ignored.</p>
+
+<h3 id="modifything-with-copied-policy-by-policy-id">ModifyThing with copied Policy by Policy ID</h3>
+
+<p>If no Thing with ID <code class="highlighter-rouge">org.eclipse.ditto:fancy-thing_53</code> exists, this command will create a new Thing with ID <code class="highlighter-rouge">org.eclipse.ditto:fancy-thing_53</code> with a
+Policy copied from the Policy with ID <code class="highlighter-rouge">org.eclipse.ditto:the_policy_id_to_copy</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:fancy-thing_53"</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:the_policy_id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"_copyPolicyFrom"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com:acme:the_policy_id_to_copy"</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="modifything-with-copied-policy-by-thing-reference">ModifyThing with copied Policy by Thing reference</h3>
+
+<p>If no Thing with ID <code class="highlighter-rouge">org.eclipse.ditto:fancy-thing_53</code> exists, this command will create a new Thing with ID <code class="highlighter-rouge">org.eclipse.ditto:fancy-thing_53</code> with a
+Policy copied from a Thing with ID <code class="highlighter-rouge">org.eclipse.ditto:fancy-thing_52</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:fancy-thing_53"</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:the_policy_id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"_copyPolicyFrom"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ ref:things/com:acme:fancy-thing_52/policyId }}"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-modifythingdefinition.html b/2.0/protocol-examples-modifythingdefinition.html
new file mode 100644
index 0000000..354edb4
--- /dev/null
+++ b/2.0/protocol-examples-modifythingdefinition.html
@@ -0,0 +1,1817 @@
+<!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, definition">
+<title> Modify a definition • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 definition">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Modify a definition</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="modifythingdefinition">ModifyThingDefinition</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">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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">"/definition"</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">"digitaltwin:DigitaltwinExample:1.0.0"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="modifythingdefinitionresponse">ModifyThingDefinitionResponse</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">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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">"/definition"</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="definitionmodified">DefinitionModified</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">"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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"/definition"</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">"digitaltwin:DigitaltwinExample:1.0.0"</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">3</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-policies-announcement-subjectDeletion.html b/2.0/protocol-examples-policies-announcement-subjectDeletion.html
new file mode 100644
index 0000000..ba41c80
--- /dev/null
+++ b/2.0/protocol-examples-policies-announcement-subjectDeletion.html
@@ -0,0 +1,1798 @@
+<!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, policy, announcement, subjectDeletion">
+<title> SubjectDeletionAnnouncement • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="SubjectDeletionAnnouncement">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">SubjectDeletionAnnouncement</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="subjectdeletionannouncement">SubjectDeletionAnnouncement</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">"org.eclipse.ditto/the_policy_id/policies/announcements/subjectDeletion"</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">"<some-correlation-id>"</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">"deleteAt"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2021-03-03T16:05:55Z"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"subjectIds"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"integration:some-label:my-aud-1"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"integration:some-label:my-aud-2"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-policies-createpolicy.html b/2.0/protocol-examples-policies-createpolicy.html
new file mode 100644
index 0000000..eada199
--- /dev/null
+++ b/2.0/protocol-examples-policies-createpolicy.html
@@ -0,0 +1,1845 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"org.eclipse.ditto: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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"org.eclipse.ditto: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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-policies-createpolicyentry.html b/2.0/protocol-examples-policies-createpolicyentry.html
new file mode 100644
index 0000000..b68af7f
--- /dev/null
+++ b/2.0/protocol-examples-policies-createpolicyentry.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=" 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-policies-createresource.html b/2.0/protocol-examples-policies-createresource.html
new file mode 100644
index 0000000..e5dc2b2
--- /dev/null
+++ b/2.0/protocol-examples-policies-createresource.html
@@ -0,0 +1,1810 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-policies-createsubject.html b/2.0/protocol-examples-policies-createsubject.html
new file mode 100644
index 0000000..86c351a
--- /dev/null
+++ b/2.0/protocol-examples-policies-createsubject.html
@@ -0,0 +1,1806 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-policies-deletepolicy.html b/2.0/protocol-examples-policies-deletepolicy.html
new file mode 100644
index 0000000..be9d453
--- /dev/null
+++ b/2.0/protocol-examples-policies-deletepolicy.html
@@ -0,0 +1,1803 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-policies-deletepolicyentry.html b/2.0/protocol-examples-policies-deletepolicyentry.html
new file mode 100644
index 0000000..a8b8d94
--- /dev/null
+++ b/2.0/protocol-examples-policies-deletepolicyentry.html
@@ -0,0 +1,1803 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-policies-deleteresource.html b/2.0/protocol-examples-policies-deleteresource.html
new file mode 100644
index 0000000..8730770
--- /dev/null
+++ b/2.0/protocol-examples-policies-deleteresource.html
@@ -0,0 +1,1803 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-policies-deletesubject.html b/2.0/protocol-examples-policies-deletesubject.html
new file mode 100644
index 0000000..ffb80d8
--- /dev/null
+++ b/2.0/protocol-examples-policies-deletesubject.html
@@ -0,0 +1,1803 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-policies-errorresponses.html b/2.0/protocol-examples-policies-errorresponses.html
new file mode 100644
index 0000000..2b31b05
--- /dev/null
+++ b/2.0/protocol-examples-policies-errorresponses.html
@@ -0,0 +1,2146 @@
+<!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> Policies 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Policies 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>
+
+
+
+
+
+
+
+
+
+ <p>The following listed example errors do not claim to be a complete list of all available and possible error responses.<br />
+Also, their texts and <strong>error</strong> codes might be outdated.</p>
+
+<p>In order to find out all currently available errors, please inspect Ditto’s codebase and look at all implementations of
+the <code class="highlighter-rouge">PolicyException</code> interface.</p>
+
+<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">"org.eclipse.ditto/the_policy_id/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"org.eclipse.ditto/the_policy_id/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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 'org.eclipse.ditto: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">"org.eclipse.ditto/the_policy_id/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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 'org.eclipse.ditto: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">"org.eclipse.ditto/the_policy_id/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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 'org.eclipse.ditto: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">"org.eclipse.ditto/the_policy_id/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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 'org.eclipse.ditto: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">"org.eclipse.ditto/the_policy_id/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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 'org.eclipse.ditto: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">"org.eclipse.ditto/the_policy_id/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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 'org.eclipse.ditto: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">"org.eclipse.ditto/the_policy_id/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"org.eclipse.ditto/the_policy_id/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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 'org.eclipse.ditto: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">"org.eclipse.ditto/the_policy_id/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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 'org.eclipse.ditto: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">"org.eclipse.ditto/the_policy_id/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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 'org.eclipse.ditto: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">"org.eclipse.ditto/the_policy_id/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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 'org.eclipse.ditto: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">"org.eclipse.ditto/the_policy_id/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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 'org.eclipse.ditto: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">"org.eclipse.ditto/the_policy_id/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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 'org.eclipse.ditto: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">"org.eclipse.ditto/the_policy_id/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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 'org.eclipse.ditto: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">"org.eclipse.ditto/the_policy_id/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"org.eclipse.ditto/the_policy_id/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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 'org.eclipse.ditto: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">"org.eclipse.ditto/the_policy_id/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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 'org.eclipse.ditto: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">"org.eclipse.ditto/the_policy_id/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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 'org.eclipse.ditto: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">"org.eclipse.ditto/the_policy_id/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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 'org.eclipse.ditto: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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-policies-modifypolicy.html b/2.0/protocol-examples-policies-modifypolicy.html
new file mode 100644
index 0000000..acd0457
--- /dev/null
+++ b/2.0/protocol-examples-policies-modifypolicy.html
@@ -0,0 +1,1824 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"org.eclipse.ditto: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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-policies-modifypolicyentries.html b/2.0/protocol-examples-policies-modifypolicyentries.html
new file mode 100644
index 0000000..42c5765
--- /dev/null
+++ b/2.0/protocol-examples-policies-modifypolicyentries.html
@@ -0,0 +1,1843 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-policies-modifypolicyentry.html b/2.0/protocol-examples-policies-modifypolicyentry.html
new file mode 100644
index 0000000..c068f29
--- /dev/null
+++ b/2.0/protocol-examples-policies-modifypolicyentry.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=" 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-policies-modifyresource.html b/2.0/protocol-examples-policies-modifyresource.html
new file mode 100644
index 0000000..0ba63bc
--- /dev/null
+++ b/2.0/protocol-examples-policies-modifyresource.html
@@ -0,0 +1,1810 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-policies-modifyresources.html b/2.0/protocol-examples-policies-modifyresources.html
new file mode 100644
index 0000000..48f9d28
--- /dev/null
+++ b/2.0/protocol-examples-policies-modifyresources.html
@@ -0,0 +1,1813 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-policies-modifysubject.html b/2.0/protocol-examples-policies-modifysubject.html
new file mode 100644
index 0000000..f00de43
--- /dev/null
+++ b/2.0/protocol-examples-policies-modifysubject.html
@@ -0,0 +1,1806 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-policies-modifysubjects.html b/2.0/protocol-examples-policies-modifysubjects.html
new file mode 100644
index 0000000..379f0a6
--- /dev/null
+++ b/2.0/protocol-examples-policies-modifysubjects.html
@@ -0,0 +1,1809 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-policies-retrievepolicy.html b/2.0/protocol-examples-policies-retrievepolicy.html
new file mode 100644
index 0000000..18ba368
--- /dev/null
+++ b/2.0/protocol-examples-policies-retrievepolicy.html
@@ -0,0 +1,1824 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"org.eclipse.ditto: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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-policies-retrievepolicyentries.html b/2.0/protocol-examples-policies-retrievepolicyentries.html
new file mode 100644
index 0000000..410a732
--- /dev/null
+++ b/2.0/protocol-examples-policies-retrievepolicyentries.html
@@ -0,0 +1,1837 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-policies-retrievepolicyentry.html b/2.0/protocol-examples-policies-retrievepolicyentry.html
new file mode 100644
index 0000000..da070fc
--- /dev/null
+++ b/2.0/protocol-examples-policies-retrievepolicyentry.html
@@ -0,0 +1,1819 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-policies-retrieveresource.html b/2.0/protocol-examples-policies-retrieveresource.html
new file mode 100644
index 0000000..65ac58c
--- /dev/null
+++ b/2.0/protocol-examples-policies-retrieveresource.html
@@ -0,0 +1,1810 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-policies-retrieveresources.html b/2.0/protocol-examples-policies-retrieveresources.html
new file mode 100644
index 0000000..eaafebf
--- /dev/null
+++ b/2.0/protocol-examples-policies-retrieveresources.html
@@ -0,0 +1,1812 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-policies-retrievesubject.html b/2.0/protocol-examples-policies-retrievesubject.html
new file mode 100644
index 0000000..5673178
--- /dev/null
+++ b/2.0/protocol-examples-policies-retrievesubject.html
@@ -0,0 +1,1806 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-policies-retrievesubjects.html b/2.0/protocol-examples-policies-retrievesubjects.html
new file mode 100644
index 0000000..f80b880
--- /dev/null
+++ b/2.0/protocol-examples-policies-retrievesubjects.html
@@ -0,0 +1,1808 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"org.eclipse.ditto/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-retrieveattribute.html b/2.0/protocol-examples-retrieveattribute.html
new file mode 100644
index 0000000..57309e1
--- /dev/null
+++ b/2.0/protocol-examples-retrieveattribute.html
@@ -0,0 +1,1807 @@
+<!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 attribute">
+<title> Retrieve a single attribute • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 single attribute">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Retrieve a single attribute</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="retrieveattribute">RetrieveAttribute</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"/attributes/location"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="retrieveattributeresponse">RetrieveAttributeResponse</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"/attributes/location"</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">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">8.261719</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-retrieveattributes.html b/2.0/protocol-examples-retrieveattributes.html
new file mode 100644
index 0000000..a6b4f26
--- /dev/null
+++ b/2.0/protocol-examples-retrieveattributes.html
@@ -0,0 +1,1809 @@
+<!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 attributes">
+<title> Retrieve attributes • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 attributes">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Retrieve attributes</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="retrieveattributes">RetrieveAttributes</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"/attributes"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="retrieveattributesresponse">RetrieveAttributesResponse</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"/attributes"</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">"location"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">8.261719</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-retrievedefinition.html b/2.0/protocol-examples-retrievedefinition.html
new file mode 100644
index 0000000..b92e263
--- /dev/null
+++ b/2.0/protocol-examples-retrievedefinition.html
@@ -0,0 +1,1806 @@
+<!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 feature definition, definition">
+<title> Retrieve Feature Definition • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 Feature Definition">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Retrieve Feature Definition</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="retrievefeaturedefinition">RetrieveFeatureDefinition</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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/accelerometer/definition"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="retrievefeaturedefinitionresponse">RetrieveFeatureDefinitionResponse</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/definition"</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">"org.eclipse.ditto:accelerometer:1.0.0"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-retrievedesiredproperties.html b/2.0/protocol-examples-retrievedesiredproperties.html
new file mode 100644
index 0000000..3d02e21
--- /dev/null
+++ b/2.0/protocol-examples-retrievedesiredproperties.html
@@ -0,0 +1,1808 @@
+<!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 desiredProperties">
+<title> Retrieve Feature Desired Properties • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 Feature Desired Properties">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Retrieve Feature Desired Properties</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="retrievefeaturedesiredproperties">RetrieveFeatureDesiredProperties</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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/accelerometer/desiredProperties"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="retrievefeaturedesiredpropertiesresponse">RetrieveFeatureDesiredPropertiesResponse</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</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">"g"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-retrievedesiredproperty.html b/2.0/protocol-examples-retrievedesiredproperty.html
new file mode 100644
index 0000000..1405254
--- /dev/null
+++ b/2.0/protocol-examples-retrievedesiredproperty.html
@@ -0,0 +1,1803 @@
+<!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 desiredProperty">
+<title> Retrieve Desired Property • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 Desired Property">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li class="active"><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Retrieve Desired Property</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="retrievefeaturedesiredproperty">RetrieveFeatureDesiredProperty</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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/accelerometer/desiredProperties/x"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="retrievefeaturedesiredpropertyresponse">RetrieveFeatureDesiredPropertyResponse</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties/x"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">42</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-retrievefeature.html b/2.0/protocol-examples-retrievefeature.html
new file mode 100644
index 0000000..9d47126
--- /dev/null
+++ b/2.0/protocol-examples-retrievefeature.html
@@ -0,0 +1,1817 @@
+<!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 feature">
+<title> Retrieve a single feature • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 single feature">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Retrieve a single feature</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="retrievefeature">RetrieveFeature</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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/accelerometer"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="retrievefeatureresponse">RetrieveFeatureResponse</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer"</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">"properties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"desiredProperties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"x"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</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">"g"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-retrievefeatures.html b/2.0/protocol-examples-retrievefeatures.html
new file mode 100644
index 0000000..39395f0
--- /dev/null
+++ b/2.0/protocol-examples-retrievefeatures.html
@@ -0,0 +1,1819 @@
+<!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 features">
+<title> Retrieve features • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 features">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Retrieve features</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="retrievefeatures">RetrieveFeatures</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="retrievefeaturesresponse">RetrieveFeaturesResponse</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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"</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">"accelerometer"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"desiredProperties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"x"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</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">"g"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-retrieveproperties.html b/2.0/protocol-examples-retrieveproperties.html
new file mode 100644
index 0000000..dce38bf
--- /dev/null
+++ b/2.0/protocol-examples-retrieveproperties.html
@@ -0,0 +1,1809 @@
+<!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 properties">
+<title> Retrieve Feature Properties • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 Feature Properties">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Retrieve Feature Properties</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="retrievefeatureproperties">RetrieveFeatureProperties</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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/accelerometer/properties"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="retrievefeaturepropertiesresponse">RetrieveFeaturePropertiesResponse</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/properties"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-retrieveproperty.html b/2.0/protocol-examples-retrieveproperty.html
new file mode 100644
index 0000000..f29122d
--- /dev/null
+++ b/2.0/protocol-examples-retrieveproperty.html
@@ -0,0 +1,1804 @@
+<!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 property">
+<title> Retrieve property • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 property">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><a href="protocol-examples-retrieveproperty.html">Retrieve a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Retrieve property</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="retrievefeatureproperty">RetrieveFeatureProperty</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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/accelerometer/properties/x"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="retrievefeaturepropertyresponse">RetrieveFeaturePropertyResponse</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/properties/x"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">42</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-retrievething.html b/2.0/protocol-examples-retrievething.html
new file mode 100644
index 0000000..f3f014a
--- /dev/null
+++ b/2.0/protocol-examples-retrievething.html
@@ -0,0 +1,1841 @@
+<!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 thing">
+<title> Retrieve 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Retrieve 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="retrievething">RetrieveThing</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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="retrievething">RetrieveThing</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"fields"</span><span class="p">:</span><span class="w"> </span><span class="s2">"thingId,attributes(location)"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="retrievethingresponse">RetrieveThingResponse</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:fancy-thing_53"</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:the_policy_id"</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="p">{</span><span class="w">
+ </span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">8.261719</span><span class="w">
+ </span><span class="p">}</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">"accelerometer"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"desiredProperties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"x"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</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">"g"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-retrievethingdefinition.html b/2.0/protocol-examples-retrievethingdefinition.html
new file mode 100644
index 0000000..9cd3f03
--- /dev/null
+++ b/2.0/protocol-examples-retrievethingdefinition.html
@@ -0,0 +1,1804 @@
+<!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, definition">
+<title> Retrieve a definition • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 definition">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Retrieve a definition</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="retrievedefinition">RetrieveDefinition</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"/definition"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="retrieveattributeresponse">RetrieveAttributeResponse</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">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"/definition"</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">"digitaltwin:DigitaltwinExample:1.0.0"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-retrievethings.html b/2.0/protocol-examples-retrievethings.html
new file mode 100644
index 0000000..71d5702
--- /dev/null
+++ b/2.0/protocol-examples-retrievethings.html
@@ -0,0 +1,1836 @@
+<!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 things">
+<title> Retrieve multiple Things • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 multiple Things">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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 class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Retrieve multiple Things</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="retrievethings">RetrieveThings</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/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"thingIds"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
+ </span><span class="s2">"org.eclipse.ditto:fancy-thing_53"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"org.eclipse.ditto:fancy-thing_58"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"org.eclipse.ditto:fancy-thing_67"</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="retrievethingsresponse">RetrieveThingsResponse</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">"org.eclipse.ditto/_/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:fancy-thing_53"</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:the_policy_id"</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="p">{</span><span class="w">
+ </span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"longitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">8.261719</span><span class="w">
+ </span><span class="p">}</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">"accelerometer"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mf">2.718</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</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">"g"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="s2">"desiredProperties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"x"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"y"</span><span class="p">:</span><span class="w"> </span><span class="mi">3</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"z"</span><span class="p">:</span><span class="w"> </span><span class="mi">5</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">"g"</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples-search.html b/2.0/protocol-examples-search.html
new file mode 100644
index 0000000..bc8e84a
--- /dev/null
+++ b/2.0/protocol-examples-search.html
@@ -0,0 +1,1904 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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/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/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/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/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/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/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/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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-examples.html b/2.0/protocol-examples.html
new file mode 100644
index 0000000..94c440a
--- /dev/null
+++ b/2.0/protocol-examples.html
@@ -0,0 +1,1889 @@
+<!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, examples">
+<title> 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-bindings.html">Bindings</a></li>
+
+
+
+
+
+
+ <li class="active"><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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">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>
+
+
+
+
+
+
+
+
+
+ <p>The structure of the examples in this section is as follows:</p>
+
+<h2 id="command">Command</h2>
+
+<p>Each example always starts with a command message that initiates an operation at Ditto
+(e.g. create a thing, retrieve a thing).</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/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="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">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="response">Response</h2>
+
+<p>A command always has a response which either reports the success or the failure.
+The example contains the success response.
+See Thing Error responses for examples of messages that will be returned in case of an error.</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">"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="err">...</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">204</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h2 id="event">Event</h2>
+
+<p>If Ditto triggers an event (e.g. Thing created, Attribute modified) as a result of the executed command,
+an example of such an event is also demonstrated.</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/thing_name_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="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">
+ </span><span class="err">...</span><span class="w">
+ </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="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">"org.eclipse.ditto/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 (aka NACK, 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">"org.eclipse.ditto/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">"org.eclipse.ditto/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">
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-overview.html b/2.0/protocol-overview.html
new file mode 100644
index 0000000..239dfbc
--- /dev/null
+++ b/2.0/protocol-overview.html
@@ -0,0 +1,1802 @@
+<!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, channel, command, event, json, live, protocol, response, twin">
+<title> Protocol overview • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 overview">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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 class="active"><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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Protocol overview</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>The Ditto Protocol defines a JSON based text protocol for communicating with <strong>digital twins</strong> and the actual physical
+devices they mirror.</p>
+
+<p>It defines several <strong>commands</strong> both the actual device and the <strong>digital twin</strong> are able to understand.</p>
+
+<p>The communication pattern is defined by the Ditto protocol and shown in the next section.</p>
+
+<h2 id="communication-pattern">Communication pattern</h2>
+
+<p>The typical communication pattern when interacting with a <strong>digital twin</strong> or the actual device using the Ditto Protocol
+is composed of multiple correlated Protocol messages.
+Therefore, each Protocol message contains a <code class="highlighter-rouge">correlation-id</code> which can be used to associate related Protocol messages.</p>
+
+<p>The <a href="basic-signals.html#communication-pattern">Signals</a> chapter already describes the basic communication pattern of
+<strong>commands</strong>, <strong>responses</strong>, <strong>events</strong> and <strong>announcements</strong>.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-specification-acks.html b/2.0/protocol-specification-acks.html
new file mode 100644
index 0000000..91e4e05
--- /dev/null
+++ b/2.0/protocol-specification-acks.html
@@ -0,0 +1,1826 @@
+<!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, ack, acknowledgement">
+<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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-specification-errors.html b/2.0/protocol-specification-errors.html
new file mode 100644
index 0000000..40e4ab2
--- /dev/null
+++ b/2.0/protocol-specification-errors.html
@@ -0,0 +1,1803 @@
+<!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, error, failure">
+<title> Protocol specification for errors • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 errors">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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 class="active"><a href="protocol-specification-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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 errors</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-signals-errorresponse.html">error responses</a> transport information about encountered
+<a href="basic-errors.html">errors</a>, e.g. client errors or server errors:</p>
+
+<script src="docson/widget.js" data-schema="../jsonschema/protocol-error_response.json"></script>
+
+<p>The <strong>error</strong> codes Ditto provides in addition to the HTTP <strong>status</strong> code
+(e.g. error codes like “things:thing.tooLarge”) is not to be considered as API and must therefore not be relied on.<br />
+It might change without prior notice.</p>
+
+<h2 id="examples">Examples</h2>
+
+<p>Examples for error responses can be found here:</p>
+<ul>
+ <li><a href="protocol-examples-errorresponses.html">Things error response examples</a></li>
+ <li><a href="protocol-examples-policies-errorresponses.html">Policies error response examples</a></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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-specification-policies-announcement.html b/2.0/protocol-specification-policies-announcement.html
new file mode 100644
index 0000000..6545f1a
--- /dev/null
+++ b/2.0/protocol-specification-policies-announcement.html
@@ -0,0 +1,1830 @@
+<!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, announcement, policy">
+<title> Policies - Announcement 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 - Announcement 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li class="active"><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Policies - Announcement 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="policy-announcements">Policy announcements</h2>
+
+<p>A Policy announcement contains the announcement name as last part of the topic:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code><namespace>/<policyName>/policies/announcements/<announcement-name>
+</code></pre></div></div>
+
+<p>The Ditto Protocol representation of an <code class="highlighter-rouge">Announcement</code> is specified as follows:</p>
+
+<script src="docson/widget.js" data-schema="../jsonschema/protocol-announcement.json"></script>
+
+<p>The following Policy announcements are currently supported:</p>
+
+<h3 id="subjectdeletionannouncement">SubjectDeletionAnnouncement</h3>
+
+<p>Announcement indicating that some subjects of a policy are deleted or about to be deleted soon.</p>
+
+<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/announcements/subjectDeletion</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td><code class="highlighter-rouge">JsonObject</code> containing<br />* <code class="highlighter-rouge">deleteAt</code> timestamp (as ISO-8601 <code class="highlighter-rouge">string</code>)<br />* <code class="highlighter-rouge">subjectIds</code> of policy <a href="basic-policy.html#subjects">subjects</a> which will soon be deleted (<code class="highlighter-rouge">JsonArray</code> of subjects <code class="highlighter-rouge">string</code>s)</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</a></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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-specification-policies-create-or-modify.html b/2.0/protocol-specification-policies-create-or-modify.html
new file mode 100644
index 0000000..68324af
--- /dev/null
+++ b/2.0/protocol-specification-policies-create-or-modify.html
@@ -0,0 +1,2363 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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 `
+<label><code class="highlighter-rouge"> in the </code>path` 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.</label></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>
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-specification-policies-delete.html b/2.0/protocol-specification-policies-delete.html
new file mode 100644
index 0000000..b7f91c7
--- /dev/null
+++ b/2.0/protocol-specification-policies-delete.html
@@ -0,0 +1,2033 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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>
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-specification-policies-retrieve.html b/2.0/protocol-specification-policies-retrieve.html
new file mode 100644
index 0000000..1554fee
--- /dev/null
+++ b/2.0/protocol-specification-policies-retrieve.html
@@ -0,0 +1,2256 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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>
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-specification-policies.html b/2.0/protocol-specification-policies.html
new file mode 100644
index 0000000..5e465b7
--- /dev/null
+++ b/2.0/protocol-specification-policies.html
@@ -0,0 +1,1872 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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 messages addressing Policies is <code class="highlighter-rouge">commands</code>,
+ for <a href="basic-signals-announcement.html">announcements</a> it is
+<a href="protocol-specification-policies-announcement.html"><code class="highlighter-rouge">announcements</code></a>.</li>
+ <li><code class="highlighter-rouge">action</code>: the action executed on the Policy via <code class="highlighter-rouge">commands</code> criterion:
+ <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>
+ <li><code class="highlighter-rouge">subject</code>: for <a href="basic-signals-announcement.html">announcements</a> the <code class="highlighter-rouge">subject</code> contains the announcement name</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="commands">Commands</h2>
+
+<p>The following Policy commands are available:</p>
+<ul>
+ <li><a href="protocol-specification-policies-create-or-modify.html">create/modify commands</a></li>
+ <li><a href="protocol-specification-policies-retrieve.html">retrieve commands</a></li>
+ <li><a href="protocol-specification-policies-delete.html">delete commands</a></li>
+</ul>
+
+<h3 id="common-errors-to-commands">Common errors to commands</h3>
+
+<p>Each Policy command could also result in an <a href="protocol-specification-errors.html">error</a> response.<br />
+The <code class="highlighter-rouge">"topic"</code> of such errors differ from the command <code class="highlighter-rouge">"topic"</code> - correlation is however possible via the
+<code class="highlighter-rouge">"correlation-id"</code> header which is preserved in the error message.</p>
+
+<p>The following table contains common error codes for Policy commands:</p>
+
+<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/deleted/retrieved as the requester had insufficient permissions.</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 <code class="highlighter-rouge">If-Match</code> or <code class="highlighter-rouge">If-None-Match</code> 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 Policy is larger than the configured limit (defaults to 100 kB).</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">429</code></td>
+ <td>Too many modifying requests are already outstanding to a specific Policy.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-specification-things-create-or-modify.html b/2.0/protocol-specification-things-create-or-modify.html
new file mode 100644
index 0000000..3e90e98
--- /dev/null
+++ b/2.0/protocol-specification-things-create-or-modify.html
@@ -0,0 +1,3320 @@
+<!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, thing">
+<title> Things - 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Things - 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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 class="active"><a href="protocol-specification-things-create-or-modify.html">Create/Modify</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Things - 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>
+
+
+
+
+
+
+
+
+
+ <p>All <code class="highlighter-rouge">topics</code> contain the <code class="highlighter-rouge"><channel></code> which may be either <code class="highlighter-rouge">twin</code> or <code class="highlighter-rouge">live</code>.<br />
+For the meaning of those two channels see <a href="protocol-specification.html">Protocol specification</a>.</p>
+
+<h2 id="create-a-thing">Create a Thing</h2>
+
+<p>This command creates the thing specified by the <code class="highlighter-rouge"><namespace></code> and <code class="highlighter-rouge"><thingId></code> in the topic defined by the JSON in the
+value.
+The <a href="#" data-toggle="tooltip" data-original-title="A Policy enables developers to configure fine-grained access control in an easy way. A specific policy defines who (subject) is granted or revoked permissions (rights) on a specific resource. The resource can be defined as rough or as fine-grained as necessary for the respective use case. ">Policy</a> of the created
+Thing must include at least one subject authorized to have READ, WRITE permissions.
+If no Policy is provided within the command, a default Policy with an entry for the authorized subject with
+all permissions set to true will be created.</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>/<thingName>/things/<channel>/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 thing as JSON object, see <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (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>/<thingName>/things/<channel>/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 Thing as JSON object, see <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (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 thing was created successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event">Event</h3>
+
+<p>The event emitted by Ditto after a thing was created.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/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>The created thing as JSON object, see <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (JSON)</a></td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-creatething.html">Create a Thing.</a></p>
+
+<h2 id="create-or-modify-a-thing">Create or modify a Thing</h2>
+
+<p>This command modifies the thing specified by the <code class="highlighter-rouge"><namespace></code> and <code class="highlighter-rouge"><thingId></code> in the <code class="highlighter-rouge">topic</code> with the JSON in the
+<code class="highlighter-rouge">value</code>, if it already exists. Otherwise, the thing 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>/<thingName>/things/<channel>/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 thing as JSON.<br />see <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (JSON)</a></td>
+ </tr>
+ </tbody>
+</table>
+
+<p>For modifying an existing thing, the authorized subject needs WRITE permission.<br />
+If the thing does not yet exist, the same rules apply as described for the <a href="#create-a-thing">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>/<thingName>/things/<channel>/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 Thing as JSON object, see <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (JSON)</a>. This field is not available, if the Thing 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 Thing was created successfully.</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">204</code></td>
+ <td>Success - the Thing was modified successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-1">Event</h3>
+
+<p>The event emitted by Ditto after a thing was modified.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/modified</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 modified Thing as JSON<br />see <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (JSON)</a>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-modifything.html">Modify a Thing</a></p>
+
+<p>In case a thing was created, the event described for the <a href="#create-a-thing">create command</a> will be emitted.</p>
+
+<h2 id="create-or-modify-all-attributes-of-a-thing">Create or modify all Attributes of a Thing</h2>
+
+<p>Create or modify the Attributes of a Thing identified by the <code class="highlighter-rouge"><namespace></code> and <code class="highlighter-rouge"><thingId></code> in the <code class="highlighter-rouge">topic</code>.
+The Attributes will be replaced by the JSON in the <code class="highlighter-rouge">value</code>.</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>/<thingName>/things/<channel>/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/attributes</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The attributes of the thing as JSON, see property <code class="highlighter-rouge">attributes</code> of Things JSON schema. See <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (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>/<thingName>/things/<channel>/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/attributes</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The created attributes as JSON, see property <code class="highlighter-rouge">attributes</code> of Things JSON schema. See <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (JSON).</a>. This field is not available, if the thing already contained attributes.</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 - Attributes were created successfully.</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">204</code></td>
+ <td>Success - Attributes were modified successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-2">Event</h3>
+
+<p>If the thing already contained attributes before the command was applied and they were thus overwritten, a <code class="highlighter-rouge">modified</code>
+event will be emitted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/modified</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/attributes</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The modified attributes of the thing as JSON, see property <code class="highlighter-rouge">attributes</code> of the Things JSON schema. See <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (JSON)</a>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-modifyattributes.html">Modify Attributes</a></p>
+
+<p>If the thing did not yet contain attributes before the command was applied, a <code class="highlighter-rouge">created</code> event will be emitted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/created</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/attributes</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The created Attributes of the Thing as JSON, see property <code class="highlighter-rouge">attributes</code> of the Things JSON schema at <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (JSON)</a>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-createattributes.html">Create Attributes</a></p>
+
+<h2 id="create-or-modify-a-single-attribute-of-a-thing">Create or modify a single Attribute of a Thing</h2>
+
+<p>Create or modify a specific attribute identified by the <code class="highlighter-rouge"><attributePath></code> of the Thing.
+The attribute will be created in case it doesn’t exist yet, otherwise the thing attribute is updated.
+The attribute (JSON) can be referenced hierarchically by applying <a href="https://tools.ietf.org/html/rfc6901">JSON Pointer notation (RFC-6901)</a>.</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>/<thingName>/things/<channel>/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/attributes/<attributePath></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The specific attribute of the Thing as JSON.</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>/<thingName>/things/<channel>/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/attributes/<attributePath></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The created attribute as JSON. This field is not available, if the attribute 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 Attribute was created successfully.</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">204</code></td>
+ <td>Success - The Attribute was modified successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-3">Event</h3>
+
+<p>If the attribute already existed before the command was applied and it was thus overwritten by the command, a
+<code class="highlighter-rouge">modified</code> event will be emitted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/modified</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/attributes/<attributePath></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The modified Attribute of the Thing as JSON value.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-modifyattribute.html">Modify a single Attribute</a></p>
+
+<p>If the attribute did not yet exist before the command was applied, a <code class="highlighter-rouge">created</code> event will be emitted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/created</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/attributes/<attributePath></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The created Attribute of the Thing as JSON value.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-createattribute.html">Create a single Attribute</a></p>
+
+<h2 id="create-or-modify-a-single-definition-of-a-thing">Create or modify a single definition of a Thing</h2>
+
+<p>Create or modify a definition of the Thing.
+The definition will be created in case it doesn’t exist yet, otherwise the thing definition is updated.</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>/<thingName>/things/<channel>/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/definition</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The specific definition of the Thing as JSON string value.</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>/<thingName>/things/<channel>/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/definition</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The created definition as JSON string value. This field is not available, if the definition 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 definition was created successfully.</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">204</code></td>
+ <td>Success - The definition was modified successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-4">Event</h3>
+
+<p>If the definition already existed before the command was applied and it was thus overwritten by the command, a
+<code class="highlighter-rouge">modified</code> event will be emitted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/modified</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/definition</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The modified definition of the Thing as JSON string value.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-modifythingdefinition.html">Modify a definition</a></p>
+
+<p>If the definition did not yet exist before the command was applied, a <code class="highlighter-rouge">created</code> event will be emitted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/created</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/definition</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The created definition of the Thing as JSON string value.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-createthingdefinition.html">Create a definition</a></p>
+
+<h2 id="create-or-modify-all-features-of-a-thing">Create or modify all Features of a Thing</h2>
+
+<p>Create or modify the Features of a Thing identified by the <code class="highlighter-rouge"><namespace></code> and the <code class="highlighter-rouge"><thingId></code> in the topic.<br />
+The list of Features will be replaced by the JSON in the <code class="highlighter-rouge">value</code>.</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>/<thingName>/things/<channel>/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>All Features of the Thing as JSON, see property <code class="highlighter-rouge">features</code> of Things JSON schema. See <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (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>/<thingName>/things/<channel>/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The created Features as JSON, see property <code class="highlighter-rouge">features</code> of Things JSON schema at <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (JSON)</a>. This field is not available, if the thing already contained features.</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 Features were created successfully.</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">204</code></td>
+ <td>Success - The Features were modified successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-5">Event</h3>
+
+<p>If the thing already contained Features before the command was applied and they were thus overwritten, a
+<code class="highlighter-rouge">modified</code> event will be emitted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/modified</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>All Features of the Thing as JSON, see property <code class="highlighter-rouge">features</code> of the Things JSON schema. See <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (JSON)</a>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-modifyfeatures.html">Modify Features</a></p>
+
+<p>If the thing did not yet contain Features before the command was applied, a <code class="highlighter-rouge">created</code> event will be emitted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/created</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>All Features of the Thing as JSON, see property <code class="highlighter-rouge">features</code> of the Things JSON schema at <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (JSON)</a>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-createfeatures.html">Create Features</a></p>
+
+<h2 id="create-or-modify-single-feature-of-a-thing">Create or modify single Feature of a Thing</h2>
+
+<p>Create or modify a specific Feature (identified by the Feature ID in the <code class="highlighter-rouge">path</code>) of the Thing (identified by the <code class="highlighter-rouge"><namespace></code> and the <code class="highlighter-rouge"><thingId></code> in the topic).</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>/<thingName>/things/<channel>/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The specific Feature of the Thing as JSON. See <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (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>/<thingName>/things/<channel>/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features/<featureId></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The created Feature as JSON. See <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (JSON)</a>. This field is not available, if the Feature 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 Feature was created successfully.</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">204</code></td>
+ <td>Success - the Feature was modified successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-6">Event</h3>
+
+<p>If the Feature already existed before the command was applied and it was thus overwritten by the command, a
+<code class="highlighter-rouge">modified</code> event will be emitted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/modified</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The modified Feature of the Thing as JSON. See <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (JSON)</a>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-modifyfeature.html">Modify a single Feature</a></p>
+
+<p>If the Feature did not yet exist before the command was applied, a <code class="highlighter-rouge">created</code> event will be emitted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/created</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The created Feature of the Thing as JSON.<br />see <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (JSON)</a>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-createfeature.html">Create a single Feature</a></p>
+
+<h2 id="create-or-modify-definition-of-a-feature">Create or modify Definition of a Feature</h2>
+
+<p>Create or modify the Definition of a Feature (identified by the Feature ID in the <code class="highlighter-rouge">path</code>) of the Thing (identified by the <code class="highlighter-rouge"><namespace></code> and the <code class="highlighter-rouge"><thingId></code> in the <code class="highlighter-rouge">topic</code>).</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>/<thingName>/things/<channel>/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/definition</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The Definition of the Feature as JSON array, see property <code class="highlighter-rouge">definition</code> of Things JSON schema. See <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (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>/<thingName>/things/<channel>/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features/<featureId>/definition</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The created Definition of the Feature as JSON array, see property <code class="highlighter-rouge">definition</code> of Things JSON schema at <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (JSON)</a>. This field is not available, if the Definition 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 Definition was created successfully.</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">204</code></td>
+ <td>Success - the Definition was modified successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-7">Event</h3>
+
+<p>If the Feature Definition already existed before the command was applied and it was thus overwritten by the command, a
+<code class="highlighter-rouge">modified</code> event will be emitted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/modified</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/definition</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The modified Definition of the Feature as JSON array, see property <code class="highlighter-rouge">properties</code> of the Things JSON schema. See <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (JSON)</a>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-modifydefinition.html">Modify Feature Definition</a></p>
+
+<p>If the Feature Definition did not yet exist before the command was applied, a <code class="highlighter-rouge">created</code> event will be emitted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/created</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/definition</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The created Definition of the Feature as JSON array, see property <code class="highlighter-rouge">definition</code> of the Things JSON schema at <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (JSON)</a>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-createdefinition.html">Create Feature Definition</a></p>
+
+<h2 id="modify-all-properties-of-a-feature">Modify all Properties of a Feature</h2>
+
+<p>Create or modify the Properties of a Feature (identified by the Feature ID in the <code class="highlighter-rouge">path</code>) of the Thing (identified by the <code class="highlighter-rouge"><namespace></code> and the <code class="highlighter-rouge"><thingId></code> in the <code class="highlighter-rouge">topic</code>).</p>
+
+<h3 id="command-8">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>/<thingName>/things/<channel>/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/properties</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The Properties of the Feature as JSON, see property <code class="highlighter-rouge">properties</code> of Things JSON schema. See <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (JSON)</a>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-8">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>/<thingName>/things/<channel>/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features/<featureId>/properties</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The created Properties of the Feature as JSON object, see property <code class="highlighter-rouge">properties</code> of Things JSON schema at <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (JSON)</a>. This field is not available, if Feature already contained Properties.</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 Properties were created successfully.</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">204</code></td>
+ <td>Success - the Properties were modified successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-8">Event</h3>
+
+<p>If the Feature already contained Properties before the command was applied and they were thus overwritten by the
+command, a <code class="highlighter-rouge">modified</code> event will be emitted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/modified</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/properties</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The modified Properties of the Feature as JSON, see property <code class="highlighter-rouge">properties</code> of the Things JSON schema. See <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (JSON)</a>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-modifyproperties.html">Modify Feature Properties</a></p>
+
+<p>If the Feature did not yet contain Properties before the command was applied, a <code class="highlighter-rouge">created</code> event will be emitted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/created</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/properties</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The created Properties of the Feature as JSON object, see property <code class="highlighter-rouge">properties</code> of the Things JSON schema at <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (JSON)</a>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-createproperties.html">Create Feature Properties</a></p>
+
+<h2 id="modify-all-desired-properties-of-a-feature">Modify all desired Properties of a Feature</h2>
+
+<p>Create or modify the desired Properties of a Feature (identified by the Feature ID in the <code class="highlighter-rouge">path</code>) of the Thing (identified by the <code class="highlighter-rouge"><namespace></code> and the <code class="highlighter-rouge"><thingId></code> in the <code class="highlighter-rouge">topic</code>).</p>
+
+<h3 id="command-9">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>/<thingName>/things/<channel>/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/desiredProperties</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The desired Properties of the Feature as JSON, see property <code class="highlighter-rouge">desiredProperties</code> of Things JSON schema. See <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (JSON)</a>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-9">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>/<thingName>/things/<channel>/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features/<featureId>/desiredProperties</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The created desired Properties of the Feature as JSON object, see property <code class="highlighter-rouge">desiredProperties</code> of Things JSON schema at <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (JSON)</a>. This field is not available, if Feature already contained desired Properties.</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 desired Properties were created successfully.</td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">204</code></td>
+ <td>Success - the desired Properties were modified successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-9">Event</h3>
+
+<p>If the Feature already contained desired Properties before the command was applied and they were thus overwritten by the command, a <code class="highlighter-rouge">modified</code> event will be emitted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/modified</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/desiredProperties</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The modified desired Properties of the Feature as JSON, see property <code class="highlighter-rouge">desiredProperties</code> of the Things JSON schema. See <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (JSON)</a>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-modifydesiredproperties.html">Modify Feature Desired Properties</a></p>
+
+<p>If the Feature did not yet contain desired Properties before the command was applied, a <code class="highlighter-rouge">created</code> event will be emitted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/created</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/desiredProperties</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The created desired Properties of the Feature as JSON object, see property <code class="highlighter-rouge">desiredProperties</code> of the Things JSON schema at <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (JSON)</a>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-createdesiredproperties.html">Create Feature Desired Properties</a></p>
+
+<h2 id="create-or-modify-a-single-property-of-a-feature">Create or modify a single Property of a Feature</h2>
+
+<p>Create or modify a specific Property (identified by <code class="highlighter-rouge"><propertyPath></code>) of a Feature (identified by the <code class="highlighter-rouge"><featureId></code> in the <code class="highlighter-rouge">path</code>).
+The Property will be created if it doesn’t exist or else updated.
+The Property (JSON) can be referenced hierarchically by applying <a href="https://tools.ietf.org/html/rfc6901">JSON Pointer notation (RFC-6901)</a>.</p>
+
+<h3 id="command-10">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>/<thingName>/things/<channel>/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/properties/<propertyPath></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The specific Property of the Feature as JSON.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-10">Response</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th> </th>
+ <th>Value</th>
+ <th> </th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/modify</code></td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features/<featureId>/properties/<propertyPath></code></td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The created Property of the Feature as JSON. This field is not available, if the Property already existed.</td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td><strong>status</strong></td>
+ <td><em>code</em></td>
+ <td> </td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">201</code></td>
+ <td>Success - the Property was created successfully.</td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">204</code></td>
+ <td>Success - the Property was modified successfully.</td>
+ <td> </td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-10">Event</h3>
+
+<p>If the Feature Property already existed before the command was applied and it was thus overwritten by the command, a
+<code class="highlighter-rouge">modified</code> event will be emitted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/modified</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/properties/<propertyPath></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The modified Property of the Thing as JSON.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-modifyproperty.html">Modify a single Feature Property</a></p>
+
+<p>If the Feature Property did not yet exist before the command was applied, a <code class="highlighter-rouge">created</code> event will be emitted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/created</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/properties/<propertyPath></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The created Property of the Thing as JSON.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-createproperty.html">Create a single Feature Property</a></p>
+
+<h2 id="create-or-modify-a-single-desired-property-of-a-feature">Create or modify a single desired Property of a Feature</h2>
+
+<p>Create or modify a specific desired Property (identified by <code class="highlighter-rouge"><desiredPropertyPath></code>) of a Feature (identified by the <code class="highlighter-rouge"><featureId></code> in the <code class="highlighter-rouge">path</code>).
+The desired Property will be created if it doesn’t exist or else updated.
+The Property (JSON) can be referenced hierarchically by applying <a href="https://tools.ietf.org/html/rfc6901">JSON Pointer notation (RFC-6901)</a>.</p>
+
+<h3 id="command-11">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>/<thingName>/things/<channel>/commands/modify</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/desiredProperties/<desiredPropertyPath></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The specific desired Property of the Feature as JSON.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-11">Response</h3>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th> </th>
+ <th>Value</th>
+ <th> </th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/commands/modify</code></td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features/<featureId>/desiredProperties/<desiredPropertyPath></code></td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The created desired Property of the Feature as JSON. This field is not available, if the Property already existed.</td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td><strong>status</strong></td>
+ <td><em>code</em></td>
+ <td> </td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">201</code></td>
+ <td>Success - the desired Property was created successfully.</td>
+ <td> </td>
+ </tr>
+ <tr>
+ <td> </td>
+ <td><code class="highlighter-rouge">204</code></td>
+ <td>Success - the desired Property was modified successfully.</td>
+ <td> </td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-11">Event</h3>
+
+<p>If the Feature desired Property already existed before the command was applied and it was thus overwritten by the command, a <code class="highlighter-rouge">modified</code> event will be emitted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/modified</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/desiredProperties/<desiredPropertyPath></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The modified desired Property of the Thing as JSON.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-modifydesiredproperty.html">Modify a single Feature desired Property</a></p>
+
+<p>If the Feature desired Property did not yet exist before the command was applied, a <code class="highlighter-rouge">created</code> event will be emitted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/created</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/desiredProperties/<desiredPropertyPath></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The created Property of the Thing as JSON.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-createdesiredproperty.html">Create a single Feature desired Property</a></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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-specification-things-delete.html b/2.0/protocol-specification-things-delete.html
new file mode 100644
index 0000000..8835565
--- /dev/null
+++ b/2.0/protocol-specification-things-delete.html
@@ -0,0 +1,2727 @@
+<!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, thing">
+<title> Things - 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Things - 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</a></li>
+
+
+
+
+
+ <li><a href="protocol-specification-things-retrieve.html">Retrieve</a></li>
+
+
+
+
+
+ <li class="active"><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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Things - 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>
+
+
+
+
+
+
+
+
+
+ <p>All <code class="highlighter-rouge">topics</code> contain the <code class="highlighter-rouge"><channel></code> which may be either <code class="highlighter-rouge">twin</code> or <code class="highlighter-rouge">live</code>.<br />
+For the meaning of those two channels see <a href="protocol-specification.html">Protocol specification</a>.</p>
+
+<h2 id="delete-a-thing">Delete a Thing</h2>
+
+<p>Deletes the Thing identified by the <code class="highlighter-rouge"><namespace></code> and <code class="highlighter-rouge"><thingId></code> in the <code class="highlighter-rouge">topic</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>/<thingName>/things/<channel>/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>/<thingName>/things/<channel>/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 Thing was deleted successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event">Event</h3>
+
+<p>The event emitted by Ditto after a thing was deleted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/deleted</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/</code></td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong>
+<a href="protocol-examples-deletething.html">Delete a Thing</a></p>
+
+<h2 id="delete-all-attributes-of-a-thing">Delete all Attributes of a Thing</h2>
+
+<p>Deletes all Attributes of a Thing identified by the <code class="highlighter-rouge"><namespace></code> and <code class="highlighter-rouge"><thingId></code> in the <code class="highlighter-rouge">topic</code>.</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>/<thingName>/things/<channel>/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/attributes</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>/<thingName>/things/<channel>/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/attributes</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 - Attributes were deleted successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-1">Event</h3>
+
+<p>The event emitted by Ditto after the attributes of a thing were deleted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/deleted</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/attributes</code></td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong>
+<a href="protocol-examples-deleteattributes.html">Delete Attributes</a></p>
+
+<h2 id="delete-a-single-attribute-of-a-thing">Delete a single Attribute of a Thing</h2>
+
+<p>Delete a specific Attribute identified by the <code class="highlighter-rouge"><attributePath></code> of the Thing.</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>/<thingName>/things/<channel>/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/attributes/<attributePath></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>/<thingName>/things/<channel>/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/attributes/<attributePath></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 Attribute was deleted successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-2">Event</h3>
+
+<p>The event emitted by Ditto after the Attribute of a thing was deleted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/deleted</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/attributes/<attributePath></code></td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong>
+<a href="protocol-examples-deleteattribute.html">Delete a single Attribute</a></p>
+
+<h2 id="delete-the-definition-of-a-thing">Delete the definition of a Thing</h2>
+
+<p>Delete the definition of the Thing.</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>/<thingName>/things/<channel>/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/definition</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>/<thingName>/things/<channel>/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/definition</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 definition was deleted successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-3">Event</h3>
+
+<p>The event emitted by Ditto after the definition of a thing was deleted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/deleted</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/definition</code></td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong>
+<a href="protocol-examples-deletethingdefinition.html">Delete a single definition</a></p>
+
+<h2 id="delete-all-features-of-a-thing">Delete all Features of a Thing</h2>
+
+<p>Delete all Features of a Thing identified by identified by the <code class="highlighter-rouge"><namespace></code> and the <code class="highlighter-rouge"><thingId></code> in the <code class="highlighter-rouge">topic</code>.</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>/<thingName>/things/<channel>/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features</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>/<thingName>/things/<channel>/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features</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 Features were deleted successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-4">Event</h3>
+
+<p>The event emitted by Ditto after the Features of a Thing were deleted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/deleted</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features</code></td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong>
+<a href="protocol-examples-deletefeatures.html">Delete Features</a></p>
+
+<h2 id="delete-single-feature-of-a-thing">Delete single Feature of a Thing</h2>
+
+<p>Delete a specific Feature (identified by the <code class="highlighter-rouge"><featureId></code> in the <code class="highlighter-rouge">path</code>) of a Thing.</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>/<thingName>/things/<channel>/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId></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>/<thingName>/things/<channel>/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features/<featureId></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 Feature was deleted successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-5">Event</h3>
+
+<p>The event emitted by Ditto after a Feature of a Thing was deleted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/deleted</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId></code></td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong>
+<a href="protocol-examples-deletefeature.html">Delete a single Feature</a></p>
+
+<h2 id="delete-definition-of-a-feature">Delete Definition of a Feature</h2>
+
+<p>Delete the Definition of a Feature (identified by the <code class="highlighter-rouge"><featureId></code> in the <code class="highlighter-rouge">path</code>) of the Thing
+(identified by the <code class="highlighter-rouge"><namespace></code> and the <code class="highlighter-rouge"><thingId></code> in the <code class="highlighter-rouge">topic</code>).</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>/<thingName>/things/<channel>/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/definition</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>/<thingName>/things/<channel>/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features/<featureId>/definition</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 Definition was deleted successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-6">Event</h3>
+
+<p>The event emitted by Ditto after the Feature Definition of a Thing was deleted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/deleted</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/definition</code></td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong>
+<a href="protocol-examples-deletedefinition.html">Delete Feature Definition</a></p>
+
+<h2 id="delete-all-properties-of-a-feature">Delete all Properties of a Feature</h2>
+
+<p>Delete all Properties of a Feature (identified by the <code class="highlighter-rouge"><featureId></code> in the <code class="highlighter-rouge">path</code>) of the Thing
+(identified by the <code class="highlighter-rouge"><namespace></code> and the <code class="highlighter-rouge"><thingId></code> in the <code class="highlighter-rouge">topic</code>).</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>/<thingName>/things/<channel>/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/properties</code></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>/<thingName>/things/<channel>/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features/<featureId>/properties</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 Properties were deleted successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-7">Event</h3>
+
+<p>The event emitted by Ditto after the Feature Properties of a Thing were deleted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/deleted</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/properties</code></td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong>
+<a href="protocol-examples-deleteproperties.html">Delete Feature Properties</a></p>
+
+<h2 id="delete-all-desired-properties-of-a-feature">Delete all desired Properties of a Feature</h2>
+
+<p>Delete all desired Properties of a Feature (identified by the <code class="highlighter-rouge"><featureId></code> in the <code class="highlighter-rouge">path</code>) of the Thing
+(identified by the <code class="highlighter-rouge"><namespace></code> and the <code class="highlighter-rouge"><thingId></code> in the <code class="highlighter-rouge">topic</code>).</p>
+
+<h3 id="command-8">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>/<thingName>/things/<channel>/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/desiredProperties</code></td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-8">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>/<thingName>/things/<channel>/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features/<featureId>/desiredProperties</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 desired Properties were deleted successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-8">Event</h3>
+
+<p>The event emitted by Ditto after the Feature desired Properties of a Thing were deleted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/deleted</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/desiredProperties</code></td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong>
+<a href="protocol-examples-deletedesiredproperties.html">Delete Feature Desired Properties</a></p>
+
+<h2 id="delete-a-single-property-of-a-feature">Delete a single Property of a Feature</h2>
+
+<p>Delete a specific Property (identified by <code class="highlighter-rouge"><propertyPath></code>) of a Feature (identified by the <code class="highlighter-rouge"><featureId></code> in the <code class="highlighter-rouge">path</code>).</p>
+
+<h3 id="command-9">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>/<thingName>/things/<channel>/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/properties/<propertyPath></code></td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-9">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>/<thingName>/things/<channel>/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features/<featureId>/properties/<propertyPath></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 Property was deleted successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-9">Event</h3>
+
+<p>The event emitted by Ditto after a Feature Property of a Thing was deleted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/deleted</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/properties/<propertyPath></code></td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong>
+<a href="protocol-examples-deleteproperty.html">Delete a single Feature Property</a></p>
+
+<h2 id="delete-a-single-desired-property-of-a-feature">Delete a single desired Property of a Feature</h2>
+
+<p>Delete a specific Property (identified by <code class="highlighter-rouge"><desiredPropertyPath></code>) of a Feature (identified by the <code class="highlighter-rouge"><featureId></code> in the <code class="highlighter-rouge">path</code>).</p>
+
+<h3 id="command-10">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>/<thingName>/things/<channel>/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/desiredProperties/<desiredPropertyPath></code></td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-10">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>/<thingName>/things/<channel>/commands/delete</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features/<featureId>/desiredProperties/<desiredPropertyPath></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 desired Property was deleted successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-10">Event</h3>
+
+<p>The event emitted by Ditto after a Feature desired Property of a Thing was deleted.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/deleted</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/desiredProperties/<desiredPropertyPath></code></td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong>
+<a href="protocol-examples-deletedesiredproperty.html">Delete a single Feature Desired Property</a></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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-specification-things-merge.html b/2.0/protocol-specification-things-merge.html
new file mode 100644
index 0000000..947fb42
--- /dev/null
+++ b/2.0/protocol-specification-things-merge.html
@@ -0,0 +1,2865 @@
+<!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, merge, thing">
+<title> Things - Merge 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Things - Merge 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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 class="active"><a href="protocol-specification-things-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Things - Merge 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>
+
+
+
+
+
+
+
+
+
+ <p>All <code class="highlighter-rouge">topics</code> contain the <code class="highlighter-rouge"><channel></code> which may be either <code class="highlighter-rouge">twin</code> or <code class="highlighter-rouge">live</code>.<br />
+For the meaning of those two channels see <a href="protocol-specification.html">Protocol specification</a>.</p>
+
+<p>For all merge commands the <code class="highlighter-rouge">value</code> field is provided in <a href="https://tools.ietf.org/html/rfc7396">JSON merge patch</a>
+format. In case of conflicts with the existing thing, the value provided in the patch overwrites the existing value.</p>
+
+<h2 id="merge-a-thing">Merge a thing</h2>
+
+<p>This command merges the thing specified by the <code class="highlighter-rouge"><namespace></code> and <code class="highlighter-rouge"><thingName></code> in the topic with
+the <a href="https://tools.ietf.org/html/rfc7396">JSON merge patch</a> defined by the JSON 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>/<thingName>/things/<channel>/commands/merge</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 JSON value in <a href="https://tools.ietf.org/html/rfc7396">JSON merge patch</a> format that is applied to the <a href="basic-thing.html#thing">thing</a> referenced in the <code class="highlighter-rouge">topic</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>/<thingName>/things/<channel>/commands/merge</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 thing was merged successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event">Event</h3>
+
+<p>The event emitted by Ditto after a thing was merged.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/merged</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 <a href="https://tools.ietf.org/html/rfc7396">JSON merge patch</a> that was applied to the thing referenced in the <code class="highlighter-rouge">topic</code>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-mergething.html">Merge a thing.</a></p>
+
+<h2 id="merge-all-attributes-of-a-thing">Merge all attributes of a thing</h2>
+
+<p>Merge the attributes of a thing identified by the <code class="highlighter-rouge"><namespace></code> and <code class="highlighter-rouge"><thingName></code> in the <code class="highlighter-rouge">topic</code>. The attributes will be
+merged with the JSON merge patch provided in the <code class="highlighter-rouge">value</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>/<thingName>/things/<channel>/commands/merge</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/attributes</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The JSON value in <a href="https://tools.ietf.org/html/rfc7396">JSON merge patch</a> format that is applied to the <a href="basic-thing.html#attributes">attributes</a> of the thing referenced in the <code class="highlighter-rouge">topic</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>/<thingName>/things/<channel>/commands/merge</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/attributes</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 - attributes were merged successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-1">Event</h3>
+
+<p>The event emitted by Ditto after the attributes of a thing were merged.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/merged</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/attributes</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The <a href="https://tools.ietf.org/html/rfc7396">JSON merge patch</a> that was applied to the attributes of the thing referenced in the <code class="highlighter-rouge">topic</code>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-mergeattributes.html">Merge attributes</a></p>
+
+<h2 id="merge-a-single-attribute-of-a-thing">Merge a single attribute of a thing</h2>
+
+<p>Merge a specific attribute identified by the <code class="highlighter-rouge"><attributePath></code> of the thing. The attribute (JSON) can be referenced
+hierarchically by applying <a href="https://tools.ietf.org/html/rfc6901">JSON Pointer notation (RFC-6901)</a>.</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>/<thingName>/things/<channel>/commands/merge</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/attributes/<attributePath></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The JSON value in <a href="https://tools.ietf.org/html/rfc7396">JSON merge patch</a> format that is applied to the <a href="basic-thing.html#attributes">attribute</a> identified by <code class="highlighter-rouge">path</code> of the thing referenced in the <code class="highlighter-rouge">topic</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>/<thingName>/things/<channel>/commands/merge</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/attributes/<attributePath></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 attribute was merged successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-2">Event</h3>
+
+<p>The event emitted by Ditto after a single attribute was merged.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/merged</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/attributes/<attributePath></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The <a href="https://tools.ietf.org/html/rfc7396">JSON merge patch</a> that was applied to the attribute identified by <code class="highlighter-rouge">path</code> of the thing referenced in the <code class="highlighter-rouge">topic</code>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-mergeattribute.html">Merge a single attribute</a></p>
+
+<h2 id="merge-the-definition-of-a-thing">Merge the definition of a thing</h2>
+
+<p>Merge the definition of a thing.</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>/<thingName>/things/<channel>/commands/merge</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/definition</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>A valid <a href="basic-thing.html#definition">thing definition</a> that replaces the definition of the thing referenced in the <code class="highlighter-rouge">topic</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>/<thingName>/things/<channel>/commands/merge</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/definition</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 definition was merged successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="merge-the-policy-id-of-a-thing">Merge the policy ID of a thing</h2>
+
+<p>Merge the policy ID of a thing.</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>/<thingName>/things/<channel>/commands/merge</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/policyId</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>A valid <a href="basic-thing.html#access-control">policy ID</a> that replaces the policyId of the thing referenced in the <code class="highlighter-rouge">topic</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>/<thingName>/things/<channel>/commands/merge</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/definition</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 definition was merged successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-3">Event</h3>
+
+<p>The event emitted by Ditto after the definition was merged.</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Field</th>
+ <th>Value</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><strong>topic</strong></td>
+ <td><code class="highlighter-rouge"><namespace>/<thingName>/things/<channel>/events/merged</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/definition</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The <a href="https://tools.ietf.org/html/rfc7396">JSON merge patch</a> that was applied to the definition of the thing referenced in the <code class="highlighter-rouge">topic</code>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-mergethingdefinition.html">Merge a definition</a></p>
+
+<h2 id="merge-all-features-of-a-thing">Merge all features of a thing</h2>
+
+<p>Merge the features of a thing identified by the <code class="highlighter-rouge"><namespace></code> and the <code class="highlighter-rouge"><thingName></code> in the topic.<br />
+The list of features will be merged with the JSON merge patch provided in the <code class="highlighter-rouge">value</code>.</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>/<thingName>/things/<channel>/commands/merge</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The JSON value in <a href="https://tools.ietf.org/html/rfc7396">JSON merge patch</a> format that is applied to the <a href="basic-thing.html#features">features</a> of the thing referenced in the <code class="highlighter-rouge">topic</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>/<thingName>/things/<channel>/commands/merge</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features</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 features were modified successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-4">Event</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>/<thingName>/things/<channel>/events/merged</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The <a href="https://tools.ietf.org/html/rfc7396">JSON merge patch</a> that was applied to the features of the thing referenced in the <code class="highlighter-rouge">topic</code>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-mergefeatures.html">Merge features</a></p>
+
+<h2 id="merge-a-single-feature-of-a-thing">Merge a single feature of a thing</h2>
+
+<p>Merge a specific feature (identified by the feature ID in the <code class="highlighter-rouge">path</code>) of the thing (identified by the <code class="highlighter-rouge"><namespace></code> and
+the <code class="highlighter-rouge"><thingName></code> in the topic).</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>/<thingName>/things/<channel>/commands/merge</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The JSON value in <a href="https://tools.ietf.org/html/rfc7396">JSON merge patch</a> format that is applied to the specific <a href="basic-thing.html#features">feature</a> identified by the feature ID in the <code class="highlighter-rouge">path</code> of the thing referenced in the <code class="highlighter-rouge">topic</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>/<thingName>/things/<channel>/commands/merge</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features/<featureId></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">201</code></td>
+ <td>Success - The feature was created successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-5">Event</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>/<thingName>/things/<channel>/events/merged</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The <a href="https://tools.ietf.org/html/rfc7396">JSON merge patch</a> that was applied to the specific feature identified by the feature ID in the <code class="highlighter-rouge">path</code> of the thing referenced in the <code class="highlighter-rouge">topic</code>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-mergefeature.html">Merge a single feature</a></p>
+
+<h2 id="merge-the-definition-of-a-feature">Merge the definition of a feature</h2>
+
+<p>Merge the definition of a feature (identified by the feature ID in the <code class="highlighter-rouge">path</code>) of the thing (identified by the
+<code class="highlighter-rouge"><namespace></code> and the <code class="highlighter-rouge"><thingName></code> in the <code class="highlighter-rouge">topic</code>).</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>/<thingName>/things/<channel>/commands/merge</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/definition</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The JSON value in <a href="https://tools.ietf.org/html/rfc7396">JSON merge patch</a> format that is applied to the <a href="basic-feature.html#feature-definition">definition of the feature</a> identified by the feature ID in the <code class="highlighter-rouge">path</code> of the thing referenced in the <code class="highlighter-rouge">topic</code>.</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>/<thingName>/things/<channel>/commands/merge</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features/<featureId>/definition</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 definition was merged successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-6">Event</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>/<thingName>/things/<channel>/events/merged</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/definition</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The <a href="https://tools.ietf.org/html/rfc7396">JSON merge patch</a> that was applied to the definition of the feature identified by the feature ID in the <code class="highlighter-rouge">path</code> of the thing referenced in the <code class="highlighter-rouge">topic</code>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-mergefeaturedefinition.html">Merge feature definition</a></p>
+
+<h2 id="merge-all-properties-of-a-feature">Merge all properties of a feature</h2>
+
+<p>Merge the properties of a feature (identified by the feature ID in the <code class="highlighter-rouge">path</code>) of the thing (identified by the
+<code class="highlighter-rouge"><namespace></code> and the <code class="highlighter-rouge"><thingName></code> in the <code class="highlighter-rouge">topic</code>).</p>
+
+<h3 id="command-8">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>/<thingName>/things/<channel>/commands/merge</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/properties</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The JSON value in <a href="https://tools.ietf.org/html/rfc7396">JSON merge patch</a> format that is applied to the <a href="basic-feature.html#feature-properties">properties of the feature</a> identified by the feature ID in the <code class="highlighter-rouge">path</code> of the thing referenced in the <code class="highlighter-rouge">topic</code>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-8">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>/<thingName>/things/<channel>/commands/merge</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features/<featureId>/properties</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 properties were modified successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-7">Event</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>/<thingName>/things/<channel>/events/merged</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/properties</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The <a href="https://tools.ietf.org/html/rfc7396">JSON merge patch</a> that was applied to the properties of the feature identified by the feature ID in the <code class="highlighter-rouge">path</code> of the thing referenced in the <code class="highlighter-rouge">topic</code>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-mergeproperties.html">Merge feature properties</a></p>
+
+<h2 id="merge-all-desired-properties-of-a-feature">Merge all desired properties of a feature</h2>
+
+<p>Merge the desired properties of a feature (identified by the feature ID in the <code class="highlighter-rouge">path</code>) of the thing (identified by the
+<code class="highlighter-rouge"><namespace></code> and the <code class="highlighter-rouge"><thingName></code> in the <code class="highlighter-rouge">topic</code>).</p>
+
+<h3 id="command-9">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>/<thingName>/things/<channel>/commands/merge</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/desiredProperties</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The JSON value in <a href="https://tools.ietf.org/html/rfc7396">JSON merge patch</a> format that is applied to the <a href="basic-feature.html#feature-desired-properties">desired properties of the feature</a> identified by the feature ID in the <code class="highlighter-rouge">path</code> of the thing referenced in the <code class="highlighter-rouge">topic</code>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-9">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>/<thingName>/things/<channel>/commands/merge</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features/<featureId>/desiredProperties</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 desired properties were modified successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-8">Event</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>/<thingName>/things/<channel>/events/merged</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/desiredProperties</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The <a href="https://tools.ietf.org/html/rfc7396">JSON merge patch</a> that was applied to the desired properties of the feature identified by the feature ID in the <code class="highlighter-rouge">path</code> of the thing referenced in the <code class="highlighter-rouge">topic</code>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-mergedesiredproperties.html">Merge feature desired properties</a></p>
+
+<h2 id="merge-a-single-property-of-a-feature">Merge a single property of a feature</h2>
+
+<p>Merge a specific property (identified by <code class="highlighter-rouge"><propertyPath></code>) of a feature (identified by the <code class="highlighter-rouge"><featureId></code> in the <code class="highlighter-rouge">path</code>).
+The property (JSON) can be referenced hierarchically by
+applying <a href="https://tools.ietf.org/html/rfc6901">JSON Pointer notation (RFC-6901)</a>.</p>
+
+<h3 id="command-10">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>/<thingName>/things/<channel>/commands/merge</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/properties/<propertyPath></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The JSON value in <a href="https://tools.ietf.org/html/rfc7396">JSON merge patch</a> format that is applied to the <a href="basic-feature.html#feature-properties">property</a> identified by the property path and the feature ID in <code class="highlighter-rouge">path</code> of the thing referenced in the <code class="highlighter-rouge">topic</code>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-10">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>/<thingName>/things/<channel>/commands/merge</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features/<featureId>/properties/<propertyPath></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 property was merged successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-9">Event</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>/<thingName>/things/<channel>/events/merged</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/properties/<propertyPath></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The <a href="https://tools.ietf.org/html/rfc7396">JSON merge patch</a> that was applied to the property identified by the property path and the feature ID in <code class="highlighter-rouge">path</code> of the thing referenced in the <code class="highlighter-rouge">topic</code>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-mergeproperty.html">Merge a single feature property</a></p>
+
+<h2 id="merge-a-single-desired-property-of-a-feature">Merge a single desired property of a feature</h2>
+
+<p>Merge a specific desired property (identified by <code class="highlighter-rouge"><desiredPropertyPath></code>) of a feature (identified by the <code class="highlighter-rouge"><featureId></code>
+in the <code class="highlighter-rouge">path</code>). The property (JSON) can be referenced hierarchically by
+applying <a href="https://tools.ietf.org/html/rfc6901">JSON Pointer notation (RFC-6901)</a>.</p>
+
+<h3 id="command-11">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>/<thingName>/things/<channel>/commands/merge</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/desiredProperties/<desiredPropertyPath></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The JSON value in <a href="https://tools.ietf.org/html/rfc7396">JSON merge patch</a> format that is applied to the <a href="basic-feature.html#feature-desired-properties">desired property</a> identified by the desired property path and the feature ID in <code class="highlighter-rouge">path</code> of the thing referenced in the <code class="highlighter-rouge">topic</code>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-11">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>/<thingName>/things/<channel>/commands/merge</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features/<featureId>/desiredProperties/<desiredPropertyPath></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 desired property was merged successfully.</td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="event-10">Event</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>/<thingName>/things/<channel>/events/merged</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/desiredProperties/<desiredPropertyPath></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>The <a href="https://tools.ietf.org/html/rfc7396">JSON merge patch</a> that was applied to the property identified by the desired property path and the feature ID in <code class="highlighter-rouge">path</code> of the thing referenced in the <code class="highlighter-rouge">topic</code>.</td>
+ </tr>
+ </tbody>
+</table>
+
+<p><strong>Example:</strong> <a href="protocol-examples-mergedesiredproperty.html">Merge a single feature desired property</a></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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-specification-things-messages.html b/2.0/protocol-specification-things-messages.html
new file mode 100644
index 0000000..13f7b03
--- /dev/null
+++ b/2.0/protocol-specification-things-messages.html
@@ -0,0 +1,2046 @@
+<!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, messages, thing">
+<title> Things - Messages 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Things - Messages 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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 class="active"><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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Things - Messages 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>
+
+
+
+
+
+
+
+
+
+ <p>Messages within the Ditto Protocol allow sending, receiving and responding to
+Messages. They contain an arbitrary <em>payload</em>, so you can choose what content
+fits your solution best. If you want to learn more about the basic concepts of the Messages
+functionality, please have a look at the <a href="basic-messages.html">Messages page</a>.</p>
+
+<div class="alert alert-success" role="alert"><i class="fa fa-check-square-o"></i> <b>Tip:</b> If you only need to send Messages, but don’t need to receive
+ or respond, you could also use the <a href="httpapi-messages.html">HTTP Messages API</a></div>
+
+<h2 id="messages-protocol">Messages protocol</h2>
+
+<p>The Messages protocol is part of the <a href="protocol-specification.html">Ditto Protocol</a> and therefore
+conforms to its specification. This section describes how the protocol envelope can be filled
+for sending Messages. If you want to jump right into using the API, head over to the
+next section that describes how to <a href="#using-the-messages-api">use the messages API</a>.</p>
+
+<p>There are three protocol parameters that have special meaning for Messages:</p>
+<ul>
+ <li><code class="highlighter-rouge">topic</code> : <em>{namespace}</em>/<em>{thingId}</em>/things/live/messages/<em>{messageSubject}</em></li>
+ <li><code class="highlighter-rouge">path</code> : <em>{addressedPartOfThing}</em>/<em>{mailbox}</em>/messages/<em>{messageSubject}</em></li>
+ <li><code class="highlighter-rouge">headers</code> : The headers for Messages must include <em>content-type</em></li>
+</ul>
+
+<p><br /></p>
+
+<p>The <code class="highlighter-rouge">topic</code> definition for Messages needs the <em>namespace</em> and <em>thingId</em>
+of the Thing you’re sending Messages to. The <em>messageSubject</em> describes the Message
+and must conform to the <em>path</em> as described in <a href="https://tools.ietf.org/html/rfc3986">RFC-3986</a>.
+Examples for valid topics are:</p>
+<ul>
+ <li><code class="highlighter-rouge">org.eclipse.ditto/smartcoffee/things/live/messages/ask/question</code></li>
+ <li><code class="highlighter-rouge">com.example/smarthome/things/live/messages/turnoff</code></li>
+</ul>
+
+<p><br /></p>
+
+<p>The <code class="highlighter-rouge">path</code> also contains the <em>messageSubject</em> that describes the Message.
+<em>mailbox</em> can be <em>inbox</em> (Message is sent to a Thing) or <em>outbox</em> (Message is
+sent from a Thing). The <em>addressedPartOfThing</em> tells which part of the Thing
+is addressed. <code class="highlighter-rouge">/features/water-tank</code> would address the water-tank Feature of
+the Thing, while `` would address the whole Thing. Valid paths are e.g.:</p>
+<ul>
+ <li><code class="highlighter-rouge">/inbox/messages/ask/question</code></li>
+ <li><code class="highlighter-rouge">/features/lights/inbox/messages/turnoff</code></li>
+ <li><code class="highlighter-rouge">/features/smokedetector/outbox/messages/smokedetected</code></li>
+</ul>
+
+<p><br /></p>
+
+<p>In the <code class="highlighter-rouge">headers</code> of the envelope the Messages API requires:</p>
+<ul>
+ <li><code class="highlighter-rouge">content-type</code> : The type of the payload you are sending, e.g. <em>text/plain</em></li>
+</ul>
+
+<h2 id="using-the-messages-api">Using the Messages API</h2>
+
+<p>The following parts contain examples that will show you how to leverage the Messages API.
+In the examples we will use some kind of smart coffee machine with the id <em>smartcoffee</em>.</p>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> We encourage you to play around with the examples. You can use
+the WebSocket binding to do so. Make sure the Thing you are sending Messages to is existing and has
+ the correct access rights.</div>
+
+<h3 id="sending-a-message-to-a-thing">Sending a Message to a Thing</h3>
+
+<p>When sending a Message to a Thing, we send it to the inbox of the receiving entity.<br />
+What follows is a simple example Message that asks our Thing <em>smartcoffee</em> how it is feeling today:</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/smartcoffee/things/live/messages/ask"</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">"text/plain"</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">"a-unique-string-for-this-message"</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">"/inbox/messages/ask"</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">"Hey, how are you?"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>Notice that our <code class="highlighter-rouge">topic</code> adheres to the <a href="protocol-specification-topic.html">Ditto Protocol topic definition</a>
+with <em>messages</em> as the criterion, <em>live</em> as channel, and the message-subject as action.</p>
+
+<p>We encourage you to always send a <code class="highlighter-rouge">correlation-id</code> with your Messages.
+This is especially important, since the WebSocket Ditto Protocol binding
+sends messages in a fire-and-forget manner. Ditto wouldn’t know who to
+respond to if there was no <code class="highlighter-rouge">correlation-id</code> set in the Message.</p>
+
+<div class="alert alert-success" role="alert"><i class="fa fa-check-square-o"></i> <b>Tip:</b> If you want to receive the response to
+a Message, make sure to always send a <code class="highlighter-rouge">correlation-id</code> with it.</div>
+
+<p>The response we would get from our coffee machine could look something 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">"org.eclipse.ditto/smartcoffee/things/live/messages/ask"</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">"a-unique-string-for-this-message"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"auth-subjects"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"ditto"</span><span class="p">,</span><span class="w"> </span><span class="s2">"nginx:ditto"</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">"text/plain"</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">1</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">"/inbox/messages/ask"</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">"I do not know, since i am only a coffee machine."</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">418</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>The answer of the coffee machine has the same <code class="highlighter-rouge">topic</code> and <code class="highlighter-rouge">correlation-id</code>
+as the original message. As we can see, the response does not only contain a
+<code class="highlighter-rouge">value</code> but also the <code class="highlighter-rouge">status</code> of the response
+which is based on the <a href="protocol-specification.html#status">HTTP status codes</a>.
+Notice, that the <code class="highlighter-rouge">path</code> of the Message has changed from <em>inbox</em> to <em>outbox</em>,
+which means the Message was sent <em>from</em> the Thing.
+Ditto automatically added some headers that we can ignore for now.</p>
+
+<h3 id="receiving-a-message">Receiving a message</h3>
+
+<p>To be able to show how to receive Messages, we need to use one of the provided Ditto Protocol
+bindings. We will use the WebSocket binding for now. With it, it is amazingly easy to
+receive Messages sent <em>to</em> or <em>from</em> Things. You only need to fulfill these <em>three</em> simple requirements:</p>
+
+<ol>
+ <li>Having an open connection to the Ditto WebSocket</li>
+ <li>Having sent the <a href="httpapi-protocol-bindings-websocket.html#request-events">WebSocket binding specific message</a>
+<code class="highlighter-rouge">START-SEND-MESSAGES</code> to the WebSocket to be able to retrieve Messages</li>
+ <li>You are allowed (<a href="basic-auth.html">authorized</a>) to receive Messages</li>
+</ol>
+
+<p>If we have a user <em>ditto</em> that has <code class="highlighter-rouge">READ</code> permission on <em>smartcoffee</em>, we could receive Messages
+for it using a local Ditto instance using simple JavaScript:</p>
+
+<div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">// connect to the WebSocket</span>
+<span class="kd">var</span> <span class="nx">websocket</span> <span class="o">=</span> <span class="k">new</span> <span class="nx">WebSocket</span><span class="p">(</span><span class="s1">'ws://ditto:ditto@localhost:8080/ws/1'</span><span class="p">);</span>
+<span class="nx">websocket</span><span class="p">.</span><span class="nx">onmessage</span><span class="p">(</span><span class="kd">function</span><span class="p">(</span><span class="nx">message</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="s1">'received message data: '</span> <span class="o">+</span> <span class="nx">message</span><span class="p">.</span><span class="nx">data</span><span class="p">);</span>
+<span class="p">});</span>
+<span class="nx">websocket</span><span class="p">.</span><span class="nx">onopen</span><span class="p">(</span><span class="kd">function</span><span class="p">(</span><span class="nx">ws</span><span class="p">)</span> <span class="p">{</span>
+ <span class="c1">// register for receiving messages</span>
+ <span class="nx">ws</span><span class="p">.</span><span class="nx">send</span><span class="p">(</span><span class="s1">'START-SEND-MESSAGES'</span><span class="p">);</span>
+<span class="p">});</span>
+</code></pre></div></div>
+
+<p>If we would send the Message described in <a href="#sending-a-message-to-a-thing">Sending a Message to a Thing</a>
+to the WebSocket, our JavaScript receiver would receive the following 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/smartcoffee/things/live/messages/ask"</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">"demo-6qaal9l"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"auth-subjects"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"ditto"</span><span class="p">,</span><span class="w"> </span><span class="s2">"nginx:ditto"</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">"text/plain"</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">1</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">"/inbox/messages/ask"</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">"Hey, how are you?"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>The content is almost the same, except for automatically added headers that we can ignore.
+In the next part you can learn how to respond to this Message.</p>
+
+<h3 id="responding-to-a-message">Responding to a Message</h3>
+
+<p>After <a href="#sending-a-message-to-a-thing">sending a Message to a Thing</a> and
+<a href="#receiving-a-message">receiving the Message</a>, we are able to respond to the
+Message we received. To do this, we can re-use the relevant Message contents
+and change the type from incoming to outgoing. Here is a simple JavaScript
+function that shows how you could respond to a given Message. It takes
+the original Message, the response payload and status code and returns the
+response Message you can send using a Ditto Protocol binding.</p>
+
+<div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="nx">createTextResponse</span> <span class="o">=</span> <span class="kd">function</span><span class="p">(</span><span class="nx">originalMessage</span><span class="p">,</span> <span class="nx">payload</span><span class="p">,</span> <span class="nx">statusCode</span><span class="p">)</span> <span class="p">{</span>
+ <span class="kd">var</span> <span class="nx">topic</span> <span class="o">=</span> <span class="nx">originalMessage</span><span class="p">.</span><span class="nx">topic</span><span class="p">;</span>
+ <span class="kd">var</span> <span class="nx">correlationId</span> <span class="o">=</span> <span class="nx">originalMessage</span><span class="p">.</span><span class="nx">headers</span><span class="p">[</span><span class="s2">"correlation-id"</span><span class="p">];</span>
+ <span class="kd">var</span> <span class="nx">outboxPath</span> <span class="o">=</span> <span class="nx">originalMessage</span><span class="p">.</span><span class="nx">path</span><span class="p">.</span><span class="nx">replace</span><span class="p">(</span><span class="s2">"inbox"</span><span class="p">,</span> <span class="s2">"outbox"</span><span class="p">);</span>
+
+ <span class="k">return</span> <span class="p">{</span>
+ <span class="s2">"topic"</span><span class="p">:</span> <span class="nx">topic</span><span class="p">,</span>
+ <span class="s2">"headers"</span><span class="p">:</span> <span class="p">{</span>
+ <span class="s2">"correlation-id"</span><span class="p">:</span> <span class="nx">correlationId</span><span class="p">,</span>
+ <span class="s2">"content-type"</span><span class="p">:</span> <span class="s2">"text/plain"</span>
+ <span class="p">},</span>
+ <span class="s2">"path"</span><span class="p">:</span> <span class="nx">outboxPath</span><span class="p">,</span>
+ <span class="s2">"status"</span><span class="p">:</span> <span class="nx">statusCode</span><span class="p">,</span>
+ <span class="s2">"value"</span><span class="p">:</span> <span class="nx">payload</span>
+ <span class="p">};</span>
+<span class="p">};</span>
+</code></pre></div></div>
+
+<p>With this method you could create a simple text response, and send it
+using e.g. the WebSocket binding. Since the original Message and the response
+Message have the same <code class="highlighter-rouge">correlation-id</code>, the issuer would receive your response:</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/smartcoffee/things/live/messages/ask"</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">"demo-6qaal9l"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"auth-subjects"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="s2">"ditto"</span><span class="p">,</span><span class="w"> </span><span class="s2">"nginx:ditto"</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">"text/plain"</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">1</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">"/inbox/messages/ask"</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">418</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">"I don't know since i am only a coffee machine"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h3 id="talking-to-features">Talking to Features</h3>
+
+<p>When sending Messages to or from Features, almost everything stays the same as with
+Things. The <code class="highlighter-rouge">path</code> in the JSON and an additional <code class="highlighter-rouge">feature-id</code> header are the only parts to change.
+A Message to a Feature could therefore have the following JSON:</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/smartcoffee/things/live/messages/heatUp"</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">"text/plain"</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">"a-unique-string-for-this-message"</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/water-tank/inbox/messages/heatUp"</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">"47"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h3 id="sending-and-handling-claim-messages">Sending and handling Claim Messages</h3>
+
+<p>Claim Messages are handled like standard Messages with the difference that the message subject is <em>claim</em> and they
+can only be sent to a Thing. As the purpose of claiming is to gain access to a Thing, you do not require <code class="highlighter-rouge">WRITE</code>
+permission to send a Claim Message to a Thing. This however means for a receiver that incoming Claim Messages have to be
+carefully verified before granting access to a Thing.</p>
+
+<p>A Claim Message to gain access to our smart coffee machine might 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">"org.eclipse.ditto/smartcoffee/things/live/messages/claim"</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">"text/plain"</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">"a-unique-string-for-this-claim-message"</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">"/inbox/messages/claim"</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">"some-claiming-secret"</span><span class="w">
+</span><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<p>After verifying the Message, in particular the correctness of the payload, the smart coffee machine could grant access
+to the issuer by setting an additional permission and respond with a <em>status</em> of <code class="highlighter-rouge">200</code> or <code class="highlighter-rouge">204</code> (as you can see the
+<code class="highlighter-rouge">path</code> changed to <em>outbox</em> and the <code class="highlighter-rouge">direction</code> is now <em>from</em>, same as above for the Thing 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/smartcoffee/things/live/messages/claim"</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">"text/plain"</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">"a-unique-string-for-this-claim-message"</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">"/inbox/messages/claim"</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>
+
+<p>In case the Claim Message does not contain the required information the smart coffee machine can reject the
+claim request by <em>NOT</em> granting access and responding with a status different from <code class="highlighter-rouge">200</code> or <code class="highlighter-rouge">204</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-specification-things-retrieve.html b/2.0/protocol-specification-things-retrieve.html
new file mode 100644
index 0000000..c99fa78
--- /dev/null
+++ b/2.0/protocol-specification-things-retrieve.html
@@ -0,0 +1,2619 @@
+<!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, thing">
+<title> Things - 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Things - 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</a></li>
+
+
+
+
+
+ <li class="active"><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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Things - 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>
+
+
+
+
+
+
+
+
+
+ <p>All <code class="highlighter-rouge">topics</code> contain the <code class="highlighter-rouge"><channel></code> which may be either <code class="highlighter-rouge">twin</code> or <code class="highlighter-rouge">live</code>.<br />
+For the meaning of those two channels see <a href="protocol-specification.html">Protocol specification</a>.</p>
+
+<h2 id="retrieve-a-thing">Retrieve a Thing</h2>
+
+<p>Retrieve the Thing specified by the <code class="highlighter-rouge"><namespace></code> and <code class="highlighter-rouge"><thingId></code> in the <code class="highlighter-rouge">topic</code>.
+The response includes all details about the Thing.
+Optionally you can use field selectors (see <code class="highlighter-rouge">fields</code>) to only get the specified fields.</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>/<thingName>/things/<channel>/commands/retrieve</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 be included in the returned JSON.</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>/<thingName>/things/<channel>/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 found complete Thing as JSON object. See <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (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-retrievething.html">Retrieve a Thing</a></p>
+
+<h2 id="retrieve-multiple-things">Retrieve multiple Things</h2>
+
+<p>Retrieve the Things specified by the <code class="highlighter-rouge"><namespace></code> in the <code class="highlighter-rouge">topic</code> and the <code class="highlighter-rouge">thingIds</code> specified
+in the value. Note that the <code class="highlighter-rouge"><thingName></code> in this case contains the placeholder <code class="highlighter-rouge">_</code>. You can also omit the
+<code class="highlighter-rouge"><namespace></code> by using the placeholder <code class="highlighter-rouge">_</code>.
+The response includes all details about the requested Things.
+Optionally you can use field selectors (see <code class="highlighter-rouge">fields</code>) to only get the specified fields.</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>/_/things/<channel>/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td>a field <code class="highlighter-rouge">thingIds</code> that contains a JSON array of Thing IDs.</td>
+ </tr>
+ <tr>
+ <td><strong>fields</strong></td>
+ <td>Contains a comma separated list of fields to be included in the returned JSON.</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>/_/things/<channel>/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>JSON Array of all found Things (as JSON object). See <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (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-retrievethings.html">Retrieve multiple Things</a></p>
+
+<h2 id="retrieve-all-attributes-of-a-thing">Retrieve all Attributes of a Thing</h2>
+
+<p>Retrieve the Attributes of a Thing identified by the <code class="highlighter-rouge"><namespace></code> and <code class="highlighter-rouge"><thingId></code> in the <code class="highlighter-rouge">topic</code>.</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>/<thingName>/things/<channel>/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/attributes</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>/<thingName>/things/<channel>/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/attributes</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The Attributes of the Thing as JSON, see property attributes of Things JSON schema. See <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (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-retrieveattributes.html">Retrieve Attributes</a></p>
+
+<h2 id="retrieve-a-single-attributes-of-a-thing">Retrieve a single Attributes of a Thing</h2>
+
+<p>Retrieve a specific Attribute identified by the <code class="highlighter-rouge"><attributePath></code> of the Thing.
+The Attribute (JSON) can be referenced hierarchically by applying <a href="https://tools.ietf.org/html/rfc6901">JSON Pointer notation (RFC-6901)</a>.</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>/<thingName>/things/<channel>/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/attributes/<attributePath></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>/<thingName>/things/<channel>/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/attributes/<attributePath></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The specific Attribute of the Thing as JSON.</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-retrieveattribute.html">Retrieve a single Attribute</a></p>
+
+<h2 id="retrieve-the-definition-of-a-thing">Retrieve the definition of a Thing</h2>
+
+<p>Retrieve the Definition of the Thing.</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>/<thingName>/things/<channel>/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/definition</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>/<thingName>/things/<channel>/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/definition</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The specific Definition of the Thing as JSON.</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-retrieveattribute.html">Retrieve a single Attribute</a></p>
+
+<h2 id="retrieve-all-features-of-a-thing">Retrieve all Features of a Thing</h2>
+
+<p>Retrieve the Features of a Thing identified by identified by the <code class="highlighter-rouge"><namespace></code> and the <code class="highlighter-rouge"><thingId></code> in the <code class="highlighter-rouge">topic</code>.</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>/<thingName>/things/<channel>/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features</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>/<thingName>/things/<channel>/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>All Features of the Thing as JSON, see property features of Things JSON schema. See <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (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-retrievefeatures.html">Retrieve Features</a></p>
+
+<h2 id="retrieve-a-single-feature-of-a-thing">Retrieve a single Feature of a Thing</h2>
+
+<p>Retrieve a specific Feature (identified by the <code class="highlighter-rouge"><featureId></code> in the <code class="highlighter-rouge">path</code>) of the Thing
+(identified by the <code class="highlighter-rouge"><namespace></code> and the <code class="highlighter-rouge"><thingId></code> in the <code class="highlighter-rouge">topic</code>).</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>/<thingName>/things/<channel>/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId></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>/<thingName>/things/<channel>/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features/<featureId></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The specific Feature of the Thing as JSON. See <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (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-retrievefeature.html">Retrieve a single Feature</a></p>
+
+<h2 id="retrieve-definition-of-a-feature">Retrieve Definition of a Feature</h2>
+
+<p>Retrieve the Definition of a Feature (identified by the <code class="highlighter-rouge"><featureId></code> in the <code class="highlighter-rouge">path</code>) of the Thing
+(identified by the <code class="highlighter-rouge"><namespace></code> and the <code class="highlighter-rouge"><thingId></code> in the <code class="highlighter-rouge">topic</code>).</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>/<thingName>/things/<channel>/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/definition</code></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>/<thingName>/things/<channel>/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features/<featureId>/definition</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The Definition of the Feature as JSON array, see property properties of Things JSON schema. See <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (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-retrievedefinition.html">Retrieve Feature Definition</a></p>
+
+<h2 id="retrieve-all-properties-of-a-feature">Retrieve all Properties of a Feature</h2>
+
+<p>Retrieve all Properties of a Feature (identified by the <code class="highlighter-rouge"><featureId></code> in the <code class="highlighter-rouge">path</code>) of the Thing
+(identified by the <code class="highlighter-rouge"><namespace></code> and the <code class="highlighter-rouge"><thingId></code> in the <code class="highlighter-rouge">topic</code>).</p>
+
+<h3 id="command-8">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>/<thingName>/things/<channel>/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/properties</code></td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-8">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>/<thingName>/things/<channel>/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features/<featureId>/properties</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The Properties of the Feature as JSON, see property properties of Things JSON schema. See <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (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-retrieveproperties.html">Retrieve Feature Properties</a></p>
+
+<h2 id="retrieve-all-desired-properties-of-a-feature">Retrieve all desired Properties of a Feature</h2>
+
+<p>Retrieve all desired Properties of a Feature (identified by the <code class="highlighter-rouge"><featureId></code> in the <code class="highlighter-rouge">path</code>) of the Thing
+(identified by the <code class="highlighter-rouge"><namespace></code> and the <code class="highlighter-rouge"><thingId></code> in the <code class="highlighter-rouge">topic</code>).</p>
+
+<h3 id="command-9">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>/<thingName>/things/<channel>/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/desiredProperties</code></td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-9">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>/<thingName>/things/<channel>/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features/<featureId>/desiredProperties</code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The desired Properties of the Feature as JSON, see property desiredProperties of Things JSON schema. See <a href="protocol-specification.html#dittoProtocolPayload">Ditto protocol payload (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-retrieveproperties.html">Retrieve Feature Properties</a></p>
+
+<h2 id="retrieve-a-single-property-of-a-feature">Retrieve a single Property of a Feature</h2>
+
+<p>Retrieve the Property of the Feature identified by the <code class="highlighter-rouge"><featureId></code> in the path.
+The Property (JSON) can be referenced hierarchically by applying <a href="https://tools.ietf.org/html/rfc6901">JSON Pointer notation (RFC-6901)</a>.</p>
+
+<h3 id="command-10">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>/<thingName>/things/<channel>/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/properties/<propertyPath></code></td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-10">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>/<thingName>/things/<channel>/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features/<featureId>/properties/<propertyPath></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The specific Property of the Feature as JSON.</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-retrieveproperty.html">Retrieve a single Feature Property</a></p>
+
+<h2 id="retrieve-a-single-desired-property-of-a-feature">Retrieve a single desired Property of a Feature</h2>
+
+<p>Retrieve the desired Property of the Feature identified by the <code class="highlighter-rouge"><featureId></code> in the path.
+The Property (JSON) can be referenced hierarchically by applying <a href="https://tools.ietf.org/html/rfc6901">JSON Pointer notation (RFC-6901)</a>.</p>
+
+<h3 id="command-11">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>/<thingName>/things/<channel>/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td><code class="highlighter-rouge">/features/<featureId>/desiredProperties/<desiredPropertyPath></code></td>
+ </tr>
+ </tbody>
+</table>
+
+<h3 id="response-11">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>/<thingName>/things/<channel>/commands/retrieve</code></td>
+ </tr>
+ <tr>
+ <td><strong>path</strong></td>
+ <td> </td>
+ <td><code class="highlighter-rouge">/features/<featureId>/desiredProperties/<desiredPropertyPath></code></td>
+ </tr>
+ <tr>
+ <td><strong>value</strong></td>
+ <td> </td>
+ <td>The specific desired Property of the Feature as JSON.</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-retrievedesiredproperty.html">Retrieve a single Feature Property</a></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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-specification-things-search.html b/2.0/protocol-specification-things-search.html
new file mode 100644
index 0000000..dfde6fe
--- /dev/null
+++ b/2.0/protocol-specification-things-search.html
@@ -0,0 +1,2150 @@
+<!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="protocolsearch, protocol, specification, search, thing">
+<title> Things - Search 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Things - Search 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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 class="active"><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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Things - Search 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>
+
+
+
+
+
+
+
+
+
+ <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">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_protocol.html" class="btn btn-default navbar-btn cursorNorm" role="button">protocol</a>
+
+
+
+ <a href="tag_search.html" class="btn btn-default navbar-btn cursorNorm" role="button">search</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-specification-things.html b/2.0/protocol-specification-things.html
new file mode 100644
index 0000000..5f82249
--- /dev/null
+++ b/2.0/protocol-specification-things.html
@@ -0,0 +1,1874 @@
+<!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 Things • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 Things">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</a></li>
+
+
+
+
+
+
+ <li class="active"><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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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 Things</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-things">Ditto Protocol topic structure for Things</h2>
+
+<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>/<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">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>,
+<a href="protocol-specification-things-search.html"><code class="highlighter-rouge">search</code></a> or <a href="protocol-specification-things-messages.html"><code class="highlighter-rouge">messages</code></a>.</li>
+ <li><code class="highlighter-rouge">action</code>: the action executed on the Thing, only required for:
+ <ol>
+ <li>Commands: <a href="protocol-specification-things-create-or-modify.html"><code class="highlighter-rouge">create/modify</code></a>,
+<a href="protocol-specification-things-merge.html"><code class="highlighter-rouge">merge</code></a>,
+<a href="protocol-specification-things-retrieve.html"><code class="highlighter-rouge">retrieve</code></a> or
+<a href="protocol-specification-things-delete.html"><code class="highlighter-rouge">delete</code></a>.</li>
+ <li>Events: <code class="highlighter-rouge">created</code>, <code class="highlighter-rouge">modified</code>, <code class="highlighter-rouge">merged</code>, <code class="highlighter-rouge">deleted.</code></li>
+ </ol>
+ </li>
+</ol>
+
+<h2 id="thing-representation">Thing representation</h2>
+
+<p>The representation of a <code class="highlighter-rouge">Thing</code> in <strong>API version 2</strong> is specified as follows:</p>
+
+<script src="docson/widget.js" data-schema="../jsonschema/thing_v2.json"></script>
+
+<h2 id="commands">Commands</h2>
+
+<p>The following Thing commands are available:</p>
+<ul>
+ <li><a href="protocol-specification-things-create-or-modify.html">create/modify commands</a></li>
+ <li><a href="protocol-specification-things-merge.html">merge commands</a></li>
+ <li><a href="protocol-specification-things-retrieve.html">retrieve commands</a></li>
+ <li><a href="protocol-specification-things-delete.html">delete commands</a></li>
+</ul>
+
+<h3 id="common-errors-to-commands">Common errors to commands</h3>
+
+<p>Each Thing command could also result in an <a href="protocol-specification-errors.html">error</a> response.<br />
+The <code class="highlighter-rouge">"topic"</code> of such errors differ from the command <code class="highlighter-rouge">"topic"</code> - correlation is however possible via the
+<code class="highlighter-rouge">"correlation-id"</code> header which is preserved in the error message.</p>
+
+<p>The following table contains common error codes for Thing commands:</p>
+
+<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 Thing 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 Thing 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 <code class="highlighter-rouge">If-Match</code> or <code class="highlighter-rouge">If-None-Match</code> 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 configured limit (defaults to 100 kB).</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">429</code></td>
+ <td>Too many modifying requests are already outstanding to a specific Thing.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-specification-topic.html b/2.0/protocol-specification-topic.html
new file mode 100644
index 0000000..60a5197
--- /dev/null
+++ b/2.0/protocol-specification-topic.html
@@ -0,0 +1,1972 @@
+<!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, topic, protocol, specification, twin, digital twin, channel, criterion, action">
+<title> Protocol topic • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 topic">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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 class="active"><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Protocol topic</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>The Ditto Protocol defines a <strong>Topic</strong> for each Protocol message having following structure:</p>
+
+<p><em><a href="#namespace">{namespace}</a>/<a href="#entity-name">{entity-name}</a>/<a href="#group">{group}</a>/<a href="#channel">{channel}</a>/<a href="#criterion">{criterion}</a>/<a href="#action-optional">{action}</a></em></p>
+
+<p>Examples for valid topic paths are:</p>
+<ul>
+ <li><code class="highlighter-rouge">org.eclipse.ditto/fancy-car-1/things/twin/commands/create</code></li>
+ <li><code class="highlighter-rouge">org.eclipse.ditto/fancy-car-23/things/twin/commands/merge</code></li>
+ <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>
+ <li><code class="highlighter-rouge">org.eclipse.ditto/fancy-policy-1/policies/announcements/subjectDeletion</code></li>
+</ul>
+
+<h2 id="namespace">Namespace</h2>
+
+<p>The entity’s namespace in which the entity is located.</p>
+
+<h2 id="entity-name">Entity Name</h2>
+
+<p>The entity’s name (e.g. a <code class="highlighter-rouge">Thing Name</code>) to address.</p>
+
+<h2 id="group">Group</h2>
+
+<p>The <code class="highlighter-rouge">{group}</code> contains which type of entity should be referenced with the Protocol message.</p>
+
+<h3 id="things-group">Things Group</h3>
+
+<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>, to the actual <em>live</em> device
+or to none of both.</p>
+
+<h3 id="twin-channel">Twin channel</h3>
+
+<p>When addressing the <em>twin</em> channel, the <code class="highlighter-rouge">{criterion}</code> (e.g. a <strong>command</strong>) together with the optional <code class="highlighter-rouge">{action}</code> is
+applied to the digital representation, the <strong>digital twin</strong>, of a <code class="highlighter-rouge">Thing</code>.
+Ditto enforces that <strong>digital twins</strong> can only be accessed in an <a href="basic-auth.html">authorized way</a> and responds with
+an error if the required permissions are not met.
+Addressing on the <em>twin</em> channel means addressing the backend representation of a <code class="highlighter-rouge">Thing</code> which might be outdated, but
+roundtrips to actual devices are saved (e.g. a device in sleep mode must not be waken up in order to retrieve its last
+reported state).</p>
+
+<p>Protocol messages with the <em>search</em> <code class="highlighter-rouge">{criterion}</code> are only possible on the <em>twin</em> channel as the search is done on the
+server side representation of all digital twins.</p>
+
+<h3 id="live-channel">Live channel</h3>
+
+<p>When addressing the <em>live</em> channel, the <code class="highlighter-rouge">{criterion}</code> (e.g. a <strong>Command</strong>) together with the optional <code class="highlighter-rouge">{action}</code> is
+applied to the actual device.
+Ditto also enforces for the <em>live</em> channel that Protocol messages are <a href="basic-auth.html">authorized</a> and blocks
+unauthorized access to a <code class="highlighter-rouge">Thing</code> by responding with an error.</p>
+
+<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
+the defined <code class="highlighter-rouge">{channel}</code>.</p>
+
+<h3 id="commands-criterion">Commands criterion</h3>
+
+<p><em>commands</em> are sent to Ditto in order to do something, either on the digital twin or on a real connected device.<br />
+They are separated in ModifyCommands for creating, modifying, deleting and QueryCommands for retrieving.</p>
+
+<p>For each command Ditto processed a command response is created.
+This command response indicates whether the command was successfully applied or if an error occurred while
+processing the command.
+Command responses have the same topic path as the commands which they answer to.</p>
+
+<h3 id="events-criterion">Events criterion</h3>
+
+<p><em>events</em> are emitted by Ditto for each command which successfully <em>modified</em> an entity.<br />
+Each ModifyCommand causes a specific Event type to be published for which interested parties can subscribe themselves.</p>
+
+<h3 id="search-criterion">Search criterion</h3>
+
+<p><em>search</em> requests can only be put on the <em>twin channel</em>.<br />
+They contain a query string defining on which data to search in the population of all <strong>digital twins</strong>.
+Ditto respects the <a href="basic-auth.html">authorization</a> information while searching for the requested data and returns the
+search result as paged list of search hits.</p>
+
+<h3 id="messages-criterion">Messages criterion</h3>
+
+<p><em>messages</em> are always exchanged via the <em>live channel</em>.<br />
+They carry a custom payload and can be answered by another, correlated message.</p>
+
+<h3 id="errors-criterion">Errors criterion</h3>
+
+<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>
+
+<h3 id="announcement-criterion">Announcement criterion</h3>
+
+<p><em>announcements</em> are published by Ditto prior to an <em>event</em> taking place.<br />
+They are created by Ditto and are e.g. published a configured amount of time before an event will likely happen.</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 Protocol message.</p>
+
+<h3 id="command-criterion-actions">Command criterion actions</h3>
+
+<p>Requests to</p>
+
+<ul>
+ <li><code class="highlighter-rouge">create</code>,</li>
+ <li><code class="highlighter-rouge">retrieve</code>,</li>
+ <li><code class="highlighter-rouge">modify</code>,</li>
+ <li><code class="highlighter-rouge">merge</code> or</li>
+ <li><code class="highlighter-rouge">delete</code></li>
+</ul>
+
+<p>an entity or an aspect of an entity.</p>
+
+<h3 id="event-criterion-actions">Event criterion actions</h3>
+
+<p>An entity (e.g. a Thing) or an aspect of an entity was</p>
+
+<ul>
+ <li><code class="highlighter-rouge">created</code>,</li>
+ <li><code class="highlighter-rouge">modified</code>,</li>
+ <li><code class="highlighter-rouge">merged</code> or</li>
+ <li><code class="highlighter-rouge">deleted</code>.</li>
+</ul>
+
+<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, 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,100}</code>, i.e. letters of the Latin alphabet, numbers,
+dashes, and underscores.</p>
+
+<h3 id="announcement-criterion-actions">Announcement criterion actions</h3>
+
+<p>For the <em>announcement</em> criterion, the <em>action</em> segment specifies the announcement name.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-specification.html b/2.0/protocol-specification.html
new file mode 100644
index 0000000..8de74c8
--- /dev/null
+++ b/2.0/protocol-specification.html
@@ -0,0 +1,1967 @@
+<!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, action, channel, criterion, digital twin, envelope, payload, protocol, specification, twin">
+<title> 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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 class="active"><a href="protocol-specification.html">Specification</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-topic.html">Protocol topic</a></li>
+
+
+
+
+
+
+ <li><a href="protocol-specification-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">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>
+
+
+
+
+
+
+
+
+
+ <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>
+ <li>a Ditto Protocol payload (JSON).</li>
+</ul>
+
+<h2 id="ditto-protocol">Ditto Protocol</h2>
+
+<p>The communication protocol envelope is implicitly defined by the underlying messaging system
+(e.g. <a href="httpapi-protocol-bindings-websocket.html">WebSocket</a>) used to transport/serialize the messages over the wire.
+Please refer to the respective <a href="protocol-bindings.html">communication protocol binding</a> for information how to encode
+the data in a protocol specific way.</p>
+
+<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
+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
+following JSON schema:</p>
+
+<script src="docson/widget.js" data-schema="../jsonschema/protocol-envelope.json"></script>
+
+<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.</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 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>
+
+<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 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>
+<ul>
+ <li>addressing an entity,</li>
+ <li>defining the <code class="highlighter-rouge">channel</code> (<em>twin</em> vs. <em>live</em>) and</li>
+ <li>specifying what the intention of the Protocol message is.</li>
+</ul>
+
+<h2 id="headers">Headers</h2>
+
+<p>Protocol messages contain headers as JSON object with arbitrary content.
+The keys of the JSON object are the header names; the values are the header values.</p>
+
+<p>The header names are <em>case-insensitive</em> and <em>case-preserving</em> in the following sense:</p>
+<ul>
+ <li><strong>Case-insensitive</strong>: Capitalization of header names does not affect evaluation of the headers by Ditto;
+setting <code class="highlighter-rouge">correlation-id</code> or <code class="highlighter-rouge">CORRELATION-ID</code> has the same effect. If 2 headers differing only in capitalization
+are set, Ditto’s behavior is <strong>not defined</strong>.</li>
+ <li><strong>Case-preserving</strong>: Capitalization of headers by the sender of a Ditto protocol message is visible to the receiver.
+An exception to case-preservation are the headers of HTTP requests and responses,
+since they are themselves not case-sensitive.</li>
+</ul>
+
+<p>There are some pre-defined headers, which have a special meaning for Ditto:</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Header Key</th>
+ <th>Description</th>
+ <th>Possible values</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><code class="highlighter-rouge">content-type</code></td>
+ <td>The content-type which describes the <a href="#value">value</a> of Ditto Protocol messages.</td>
+ <td><code class="highlighter-rouge">String</code></td>
+ </tr>
+ <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">String</code></td>
+ </tr>
+ <tr>
+ <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>
+ <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">if-none-match</code></td>
+ <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">ditto-weak-ack</code></td>
+ <td>Marks <a href="basic-acknowledgements.html">weak acknowledgements</a> issued by Ditto.</td>
+ <td><code class="highlighter-rouge">Boolean</code> - default: <code class="highlighter-rouge">false</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>
+ <tr>
+ <td><code class="highlighter-rouge">put-metadata</code></td>
+ <td>Determines which Metadata information is stored in the thing.</td>
+ <td><code class="highlighter-rouge">JsonArray</code> of <code class="highlighter-rouge">JsonObject</code>s containing <a href="basic-metadata.html">metadata</a> to apply.</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
+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
+timeout-access
+</code></pre></div> </div>
+ </li>
+</ul>
+
+<p>The interaction between the headers <code class="highlighter-rouge">response-required</code>, <code class="highlighter-rouge">requested-acks</code> and <code class="highlighter-rouge">timeout</code> is documented
+<a href="basic-acknowledgements.html#interaction-between-headers">here</a>.</p>
+
+<h2 id="path">Path</h2>
+
+<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>
+
+<h2 id="value">Value</h2>
+
+<p>The JSON value to apply at the specified path.</p>
+
+<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>
+
+<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">
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/protocol-twinlive.html b/2.0/protocol-twinlive.html
new file mode 100644
index 0000000..1e7f37b
--- /dev/null
+++ b/2.0/protocol-twinlive.html
@@ -0,0 +1,1813 @@
+<!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, channel, command, device, event, live, message, protocol, response, twin">
+<title> Protocol twin/live channel • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 twin/live channel">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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 class="active"><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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Protocol twin/live channel</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>The Ditto Protocol furthermore covers two different communication channels to address different aspects of devices and
+their <strong>digital twins</strong>.</p>
+
+<h2 id="twin">Twin</h2>
+
+<p>The first <em>channel</em>, <strong>twin</strong>, connects to the digital representation of a Thing.
+This Thing is managed with Ditto and its state and properties can be read and updated.</p>
+
+<figure><img class="docimage" src="images/pages/protocol/ditto-twin-channel.png" alt="Ditto twin channel" style="max-width: 800px" /><figcaption>Ditto twin channel pattern</figcaption></figure>
+
+<h2 id="live">Live</h2>
+
+<p>The second <em>channel</em>, <strong>live</strong>, routes a command/message towards an actual device.
+The handling and execution of a received command/message by a device (or a gateway which connects the device) is very
+specific to the solution and thus out of Ditto’s scope.</p>
+
+<figure><img class="docimage" src="images/pages/protocol/ditto-live-channel.png" alt="Ditto live channel" style="max-width: 800px" /><figcaption>Ditto live channel pattern</figcaption></figure>
+
+<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">
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/release_notes_010-M1.html b/2.0/release_notes_010-M1.html
new file mode 100644
index 0000000..c9b0b48
--- /dev/null
+++ b/2.0/release_notes_010-M1.html
@@ -0,0 +1,1792 @@
+<!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 0.1.0-M1 of Eclipse Ditto, released on 18.12.2017">
+<meta name="keywords" content="release_notes, release notes, announcements, changelog">
+<title> Release notes 0.1.0-M1 • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 0.1.0-M1">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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 class="active"><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Release notes 0.1.0-M1</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 0.1.0-M1 of Eclipse Ditto, released on 18.12.2017</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>Eclipse Ditto 0.1.0-M1 is the first milestone of Eclipse Ditto.</p>
+
+<p>In the future at this point you’ll find the release notes for a milestone or a full release.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/release_notes_010-M3.html b/2.0/release_notes_010-M3.html
new file mode 100644
index 0000000..0ba18c5
--- /dev/null
+++ b/2.0/release_notes_010-M3.html
@@ -0,0 +1,1848 @@
+<!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 0.1.0-M3 of Eclipse Ditto, released on 12.01.2018">
+<meta name="keywords" content="release_notessearch, release notes, announcements, changelog">
+<title> Release notes 0.1.0-M3 • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 0.1.0-M3">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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 class="active"><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Release notes 0.1.0-M3</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 0.1.0-M3 of Eclipse Ditto, released on 12.01.2018</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>Since the first milestone of Eclipse Ditto <a href="release_notes_010-M1.html">0.1.0-M1</a>, the following new features and
+bugfixes were added.</p>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> In milestone 0.1.0-M2 we had identified a problem right after building it,
+ that’s why M3 follows M1.</div>
+
+<h2 id="new-features">New features</h2>
+
+<h3 id="amqp-bridge"><a href="https://github.com/eclipse/ditto/pull/65">AMQP Bridge</a></h3>
+
+<p>A new service “ditto-amqp-bridge” was added in order to be able establish a connection to AMQP 1.0
+endpoints like for example <a href="https://eclipse.org/hono/">Eclipse Hono</a>.</p>
+
+<p>That way messages in <a href="protocol-overview.html">Ditto Protocol</a> coming from Eclipse Hono can be processed.
+For more details, please have a look at the <a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 binding</a> and the
+<a href="architecture-services-connectivity.html">AMQP-Bridge architecture</a>.</p>
+
+<h3 id="devops-commands-http-endpoint"><a href="https://github.com/eclipse/ditto/pull/55">DevOps commands HTTP endpoint</a></h3>
+
+<p>In order to dynamically make changes to a running Ditto cluster without restarting, Ditto added an implementation
+of so called “DevOps commands”. Those can be triggered via a HTTP API for all services at once or specifically targeted
+at single instances.</p>
+
+<p>For the start the following commands are supported:</p>
+<ul>
+ <li>dynamically retrieve and change log levels</li>
+ <li>create new AMQP Bridge connections during runtime</li>
+</ul>
+
+<p>Further information can be found in the <a href="installation-operating.html#devops-commands">operating chapter</a></p>
+
+<h2 id="bugfixes">Bugfixes</h2>
+
+<h3 id="stabilization-of-eventually-consistent-search-index"><a href="https://github.com/eclipse/ditto/pull/83">Stabilization of eventually consistent search index</a></h3>
+
+<p>In various conditions the search index which is updated by the <a href="basic-search.html">search</a> of Ditto was not updated in case
+events were missed or there were timing issues.</p>
+
+<p>Those issues were resolved by improving the approach for keeping track of the already processed events.</p>
+
+<h3 id="various-smaller-bugfixes">Various smaller bugfixes</h3>
+
+<p>This is a complete list of the <a href="https://github.com/eclipse/ditto/pulls?q=is%3Apr+milestone%3A0.1.0-M3+">merged pull requests</a>.</p>
+
+<h2 id="documentation">Documentation</h2>
+
+<p>Enhanced the documentation at various places:</p>
+<ul>
+ <li><a href="protocol-overview.html">Ditto Protocol</a> and various subpages</li>
+ <li>documentation of Ditto’s <a href="basic-search.html">search</a> feature</li>
+ <li><a href="architecture-overview.html">architecture overview</a> including involved microservices</li>
+ <li>notes on how to <a href="installation-operating.html">operate Ditto</a></li>
+ <li>…</li>
+</ul>
+
+
+
+ <div class="tags">
+
+ <b>Tags: </b>
+
+
+
+ <a href="tag_release_notes.html" class="btn btn-default navbar-btn cursorNorm" role="button">release_notes</a>
+
+
+
+ <a href="tag_search.html" class="btn btn-default navbar-btn cursorNorm" role="button">search</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/release_notes_020-M1.html b/2.0/release_notes_020-M1.html
new file mode 100644
index 0000000..9e7e16b
--- /dev/null
+++ b/2.0/release_notes_020-M1.html
@@ -0,0 +1,1833 @@
+<!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 0.2.0-M1 of Eclipse Ditto, released on 07.02.2018">
+<meta name="keywords" content="release_notessearch, release notes, announcements, changelog">
+<title> Release notes 0.2.0-M1 • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 0.2.0-M1">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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 class="active"><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Release notes 0.2.0-M1</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 0.2.0-M1 of Eclipse Ditto, released on 07.02.2018</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>Since the last milestone of Eclipse Ditto <a href="release_notes_010-M3.html">0.1.0-M3</a>, the following new features and
+bugfixes were added.</p>
+
+<h2 id="new-features">New features</h2>
+
+<h3 id="search-in-namespaces"><a href="https://github.com/eclipse/ditto/pull/104">Search in namespaces</a></h3>
+
+<p>A query parameter <code class="highlighter-rouge">namespaces</code> was added to the <a href="httpapi-search.html">HTTP search API</a>.
+It can be used in order to restrict search to Things within specific namespaces. For example, with the route</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>/search/things?namespaces=john,mark
+</code></pre></div></div>
+
+<p>only Things with IDs of the form <code class="highlighter-rouge">john:<id-suffix></code> and <code class="highlighter-rouge">mark:<id-suffix></code> are returned as results.</p>
+
+<p>Namespace restriction happens at the start of a search query execution and may speed up a search queries considerably.</p>
+
+<h3 id="feature-definition"><a href="https://github.com/eclipse/ditto/issues/60">Feature Definition</a></h3>
+
+<p>Ditto’s model (to be precise the <code class="highlighter-rouge">Feature</code>) was enhanced by a <code class="highlighter-rouge">Definition</code>. This field is intended to store which
+contract a Feature follows (which state and capabilities can be expected from a Feature).</p>
+
+<p>The Java model, HTTP API and Ditto Protocol were enhanced (in a non-API breaking way) to now contain that field.</p>
+
+<p>For more information about the Feature Definition and how it can in future be used together with Eclipse Vorto, have
+a look at <a href="basic-feature.html#feature-definition">its documentation</a>.</p>
+
+<h2 id="bugfixes">Bugfixes</h2>
+
+<h3 id="amqp-10-failover-is-not-working"><a href="https://github.com/eclipse/ditto/issues/97">AMQP 1.0 failover is not working</a></h3>
+
+<p>Using <code class="highlighter-rouge">"failover": true</code> when creating a new AMQP 1.0 connection caused that the connection could not be established.</p>
+
+<h3 id="various-smaller-bugfixes">Various smaller bugfixes</h3>
+
+<p>This is a complete list of the <a href="https://github.com/eclipse/ditto/pulls?q=is%3Apr+milestone%3A0.2.0-M1+">merged pull requests</a>.</p>
+
+<h2 id="documentation">Documentation</h2>
+
+<p>Continuously improve and enhance the existing documentation.</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>
+
+
+
+ <a href="tag_search.html" class="btn btn-default navbar-btn cursorNorm" role="button">search</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/release_notes_030-M1.html b/2.0/release_notes_030-M1.html
new file mode 100644
index 0000000..7e3c146
--- /dev/null
+++ b/2.0/release_notes_030-M1.html
@@ -0,0 +1,1844 @@
+<!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 0.3.0-M1 of Eclipse Ditto, released on 26.04.2018">
+<meta name="keywords" content="release_notesconnectivity, release notes, announcements, changelog">
+<title> Release notes 0.3.0-M1 • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 0.3.0-M1">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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 class="active"><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Release notes 0.3.0-M1</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 0.3.0-M1 of Eclipse Ditto, released on 26.04.2018</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>Since the last milestone of Eclipse Ditto <a href="release_notes_020-M1.html">0.2.0-M1</a>, the following changes, new features and
+bugfixes were added.</p>
+
+<h2 id="changes">Changes</h2>
+
+<h3 id="openj9-based-docker-images"><a href="https://github.com/eclipse/ditto/pull/133">OpenJ9 based Docker images</a></h3>
+
+<p>The official Eclipse Ditto Docker images are now based on the <a href="https://www.eclipse.org/openj9/">Eclipse OpenJ9</a> JVM.
+With this JVM (cheers to the OpenJ9 developers for this awesome JVM) Ditto’s containers need a lot less memory having
+similar if not better throughput.</p>
+
+<p>This especially comes in handy for the <a href="https://ditto.eclipseprojects.io">Ditto sandbox</a> which only has 4GB RAM and 1 CPU core ;-)</p>
+
+<h3 id="amqp-bridge-renaming">AMQP bridge renaming</h3>
+
+<p>Ditto’s former AMQP bridge service was renamed to <code class="highlighter-rouge">connectivity</code> as it no longer only manages AMQP 1.0 connections, see
+the <a href="#new-features">new features</a>.</p>
+
+<h2 id="new-features">New features</h2>
+
+<h3 id="amqp-091-connectivity"><a href="https://github.com/eclipse/ditto/issues/129">AMQP 0.9.1 connectivity</a></h3>
+
+<p>The new <code class="highlighter-rouge">connectivity</code> service can now, additionally to AMQP 1.0, manage and open connections to AMQP 0.9.1 endpoints
+(e.g. provided by a <a href="https://www.rabbitmq.com">RabbitMQ</a> broker).</p>
+
+<h3 id="payload-mapping-tofrom-ditto-protocol"><a href="https://github.com/eclipse/ditto/issues/130">Payload mapping to/from Ditto Protocol</a></h3>
+
+<p>The new <code class="highlighter-rouge">connectivity</code> service can now also map message arbitrary text or byte payload from incoming AMQP 1.0 / 0.9.1
+connections which are not yet in <a href="protocol-overview.html">Ditto Protocol</a> messages in such and can also map outgoing
+Ditto Protocol messages (e.g. responses or events) back to some arbitrary text or byte payload.</p>
+
+<h2 id="bugfixes">Bugfixes</h2>
+
+<h3 id="failover-and-stability-fixes-in-connectivity-service">Failover and stability fixes in connectivity service</h3>
+
+<p>The former AMQP bridge did loose the connection to AMQP 1.0 endpoints. This is now much more stable from which also the
+new AMQP 0.9.1 connections benefit.</p>
+
+<h3 id="docker-compose-config-was-wrong"><a href="https://github.com/eclipse/ditto/issues/140">Docker compose config was wrong</a></h3>
+
+<p>The entrypoint/command was pointing to a wrong <code class="highlighter-rouge">starter.jar</code>.</p>
+
+<h3 id="various-smaller-bugfixes">Various smaller bugfixes</h3>
+
+<p>This is a complete list of the
+<a href="https://github.com/eclipse/ditto/pulls?q=is%3Apr+milestone%3A0.3.0-M1+">merged pull requests</a>.</p>
+
+<h2 id="documentation">Documentation</h2>
+
+<p>The documentation for the new/renamed <code class="highlighter-rouge">connectivity</code> service now has its own new section:
+<a href="connectivity-overview.html">Connectivity API</a>.</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>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/release_notes_030-M2.html b/2.0/release_notes_030-M2.html
new file mode 100644
index 0000000..04bdb8a
--- /dev/null
+++ b/2.0/release_notes_030-M2.html
@@ -0,0 +1,1841 @@
+<!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 0.3.0-M2 of Eclipse Ditto, released on 15.06.2018">
+<meta name="keywords" content="release_notes, release notes, announcements, changelog">
+<title> Release notes 0.3.0-M2 • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 0.3.0-M2">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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 class="active"><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Release notes 0.3.0-M2</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 0.3.0-M2 of Eclipse Ditto, released on 15.06.2018</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>Since the last milestone of Eclipse Ditto <a href="release_notes_030-M1.html">0.3.0-M1</a>, the following changes, new features and
+bugfixes were added.</p>
+
+<h2 id="changes">Changes</h2>
+
+<h3 id="reduce-network-load-for-cache-sync"><a href="https://github.com/eclipse/ditto/issues/126">Reduce network load for cache-sync</a></h3>
+
+<p>With 0.3.0-M1 Ditto had a performance issue when managing more than ~100.000 Things in its memory as Ditto used a
+distributed cluster cache which was not intended to be used in that way. Over time, as cache entries could not be deleted
+from this cache, a Ditto cluster got slower and slower.</p>
+
+<p>This is fixed now in 0.3.0-M2 by introducing a new Ditto service: <a href="architecture-services-concierge.html">ditto-concierge</a>
+which is also shown in the <a href="architecture-overview.html">architecture overview</a>.</p>
+
+<p>This is the biggest change in this milestone and required a lot of refactoring effort. Kudos to our two
+committers Daniel and Yufei who did an amazing job: the roundtrip times in a Ditto cluster are now at a constant and
+very good rate.</p>
+
+<h3 id="cluster-bootstrapping-improved"><a href="https://github.com/eclipse/ditto/issues/167">Cluster bootstrapping improved</a></h3>
+
+<p>Ditto now uses the <a href="https://developer.lightbend.com/docs/akka-management/current/index.html">akka-management</a> library
+in order to bootstrap a new cluster. By default Ditto now uses a DNS-based approach to find its other cluster-nodes and
+bootstrap a not yet formed cluster. This works very well for Docker (and Docker swarm) based clusters.</p>
+
+<p>The benefit is also that the containers no longer need to be started in a specific order and with delay.</p>
+
+<p>Future versions could also benefit from the other bootstrapping mechanisms for <code class="highlighter-rouge">kubenertes</code>, <code class="highlighter-rouge">mesos</code> or <code class="highlighter-rouge">ec2</code> (AWS)
+environment.</p>
+
+<h2 id="new-features">New features</h2>
+
+<p>No new features for this milestone.</p>
+
+<h2 id="bugfixes">Bugfixes</h2>
+
+<h3 id="search-index-fixes">Search index fixes</h3>
+
+<p>The search-index of the <a href="basic-search.html">Ditto search</a> had several issues which lead to a poor query performance
+when searching for Things.</p>
+
+<p>These issues were adressed in several fixes:</p>
+<ul>
+ <li><a href="https://github.com/eclipse/ditto/pull/159">#159</a></li>
+ <li><a href="https://github.com/eclipse/ditto/pull/169">#169</a></li>
+ <li><a href="https://github.com/eclipse/ditto/pull/175">#175</a></li>
+</ul>
+
+<h3 id="various-smaller-bugfixes">Various smaller bugfixes</h3>
+
+<p>This is a complete list of the
+<a href="https://github.com/eclipse/ditto/pulls?q=is%3Apr+milestone%3A0.3.0-M2+">merged pull requests</a>.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/release_notes_080-M1.html b/2.0/release_notes_080-M1.html
new file mode 100644
index 0000000..9564720
--- /dev/null
+++ b/2.0/release_notes_080-M1.html
@@ -0,0 +1,1863 @@
+<!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 0.8.0-M1 of Eclipse Ditto, released on 14.08.2018">
+<meta name="keywords" content="release_notes, release notes, announcements, changelog">
+<title> Release notes 0.8.0-M1 • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 0.8.0-M1">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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 class="active"><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Release notes 0.8.0-M1</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 0.8.0-M1 of Eclipse Ditto, released on 14.08.2018</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>Ditto is doing a version jump from the last milestone version 0.3.0-M2 to 0.8.0-M1. The reasons for this are:</p>
+<ul>
+ <li>Ditto wants to provide a first non-milestone release in the next months</li>
+ <li>the Ditto codebase is a very mature one, with most of the Java APIs being stable since the very first milestone,
+a 0.3.0 version would be an understatement</li>
+ <li>the Ditto main APIs (things, policies, search) are stable and backwards compatible to all previously released milestones</li>
+</ul>
+
+<p>Therefore Ditto’s first release deserves to be a “mature 0.x” version, we think 0.8.0 reflects this quite well. What
+is missing for a 1.0.0 are more features towards desired/reported state handling which will be on the agenda for after
+0.8.0.</p>
+
+<p>Since the last milestone of Eclipse Ditto <a href="release_notes_030-M2.html">0.3.0-M2</a>, the following changes, new features and
+bugfixes were added.</p>
+
+<h2 id="changes">Changes</h2>
+
+<h3 id="marked-some-dittoheaders-as-internal"><a href="https://github.com/eclipse/ditto/pull/195">Marked some DittoHeaders as internal</a></h3>
+
+<p>In order to prevent that a user of Ditto’s API (e.g. WebSocket or AMQP) sets arbitrary security relevant headers,
+those <code class="highlighter-rouge">DittoHeaders</code> are no marked as “not readable from external”. Other headers which should not be propagated to
+the outside of Ditto are marked as “not to be written to external”.</p>
+
+<h3 id="update-to-kamon-10-and-report-metrics-to-prometheus"><a href="https://github.com/eclipse/ditto/issues/105">Update to Kamon 1.0 and report metrics to Prometheus</a></h3>
+
+<p>Previously, Ditto was using Kamon 0.6.x and reported metrics/traces to a <a href="https://graphiteapp.org">Graphite</a> back-end.
+Together with the update to Kamon 1.0 the Ditto services now provide HTTP endpoints which can be scraped by
+<a href="https://prometheus.io">Prometheus</a> in order to get insights about the services.</p>
+
+<p>For more information, please read the <a href="installation-operating.html#monitoring">monitoring section</a> in the operating
+guide.</p>
+
+<h2 id="new-features">New features</h2>
+
+<h3 id="kubernetes-cluster-bootstrapping"><a href="https://github.com/eclipse/ditto/pull/201">Kubernetes cluster bootstrapping</a></h3>
+
+<p>Ditto now discovers its cluster nodes automatically also when running in Kubernetes. It uses the
+kubernetes-api in order to discover the other cluster nodes.</p>
+
+<p>An example on how to run Ditto with Kubernetes is provided in the /kubernetes git directory.</p>
+
+<h3 id="allow-placeholders-inside-connection-config"><a href="https://github.com/eclipse/ditto/issues/178">Allow placeholders inside connection config</a></h3>
+
+<p>In many cases configuration values of a <a href="connectivity-manage-connections.html">Connection</a> can be dependent on the
+message’s headers. This feature allows Ditto connections to access header fields and use it in the connection’s
+<code class="highlighter-rouge">authorizationContext</code>.</p>
+
+<p>For connecting to a <a href="connectivity-protocol-bindings-amqp10.html">Eclipse Hono</a> instance, it is e.g. possible to access the
+from Hono authenticated <code class="highlighter-rouge">device-id</code> via the placeholder <code class="highlighter-rouge">header:device-id</code>.</p>
+
+<h2 id="bugfixes">Bugfixes</h2>
+
+<h3 id="fixed-excessive-memory-consumption-of-things-service"><a href="https://github.com/eclipse/ditto/pull/194">Fixed excessive memory consumption of things-service</a></h3>
+
+<p>In previous versions, Ditto’s <code class="highlighter-rouge">things-service</code> created a lot of instances for each Thing which was loaded into memory.
+This is now optimized so that the service does no longer need so much memory.</p>
+
+<h3 id="stabilization-of-amqp-10-and-091-connections">Stabilization of AMQP 1.0 and 0.9.1 connections</h3>
+
+<p>The relatively new connectivity feature which Ditto added in previous versions had still some bugs and stability issues.
+In this milestone we put a lot of effort in further stabilizing AMQP 1.0 and 0.9.1 connections</p>
+
+<p>These issues were addressed in several fixes:</p>
+
+<ul>
+ <li><a href="https://github.com/eclipse/ditto/pull/189">#189</a></li>
+ <li><a href="https://github.com/eclipse/ditto/issues/178">#178</a></li>
+</ul>
+
+<h3 id="various-smaller-bugfixes">Various smaller bugfixes</h3>
+
+<p>This is a complete list of the
+<a href="https://github.com/eclipse/ditto/pulls?q=is%3Apr+milestone%3A0.8.0-M1+">merged pull requests</a>.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/release_notes_080-M2.html b/2.0/release_notes_080-M2.html
new file mode 100644
index 0000000..75a815b
--- /dev/null
+++ b/2.0/release_notes_080-M2.html
@@ -0,0 +1,1847 @@
+<!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 0.8.0-M2 of Eclipse Ditto, released on 27.09.2018">
+<meta name="keywords" content="release_notes, release notes, announcements, changelog">
+<title> Release notes 0.8.0-M2 • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 0.8.0-M2">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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 class="active"><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Release notes 0.8.0-M2</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 0.8.0-M2 of Eclipse Ditto, released on 27.09.2018</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 milestone release focuses mainly on the newly added MQTT connectivity. It brings Ditto an important step closer
+to the <a href="https://projects.eclipse.org/projects/iot.ditto/releases/0.8.0">first planned release 0.8.0</a>.</p>
+
+<p>Since the last milestone of Eclipse Ditto <a href="release_notes_080-M1.html">0.8.0-M1</a>, the following changes, new features and
+bugfixes were added.</p>
+
+<h2 id="changes">Changes</h2>
+
+<h3 id="define-and-enforce-max-entity-sizes-in-ditto-cluster"><a href="https://github.com/eclipse/ditto/issues/221">Define and enforce max. entity sizes in Ditto cluster</a></h3>
+
+<p>In previous versions of Ditto the entity sizes (e.g. for things and policies) were technically not limited. The only
+implicit limit was a max. cluster message size of 10m. As Ditto is not intended to manage digital twins which are that
+big, the sizes of the twins are now by default limited to:</p>
+<ul>
+ <li>max <a href="basic-thing.html">Thing</a> size: 100k</li>
+ <li>max <a href="basic-policy.html">Policy</a> size: 100k</li>
+ <li>max <a href="basic-messages.html">Message payload</a> size: 250k</li>
+</ul>
+
+<p>They can be adjusted to other needs via the configuration located in
+<a href="https://github.com/eclipse/ditto/blob/master/services/base/src/main/resources/ditto-limits.conf">ditto-limits.conf</a>.</p>
+
+<p>The default maximum frame size in the ditto cluster was changed to 256k and can be adjusted in the
+<a href="https://github.com/eclipse/ditto/blob/master/services/base/src/main/resources/ditto-akka-config.conf#L93">ditto-akka-config.conf</a>.</p>
+
+<h2 id="new-features">New features</h2>
+
+<h3 id="mqtt-support"><a href="https://github.com/eclipse/ditto/issues/220">MQTT support</a></h3>
+
+<p>In two big PRs (<a href="https://github.com/eclipse/ditto/pull/225">#225</a> and <a href="https://github.com/eclipse/ditto/pull/235">#235</a>)
+Ditto added support for connecting to MQTT brokers (like for example <a href="https://mosquitto.org">Eclipse Mosquitto</a>) via its
+<a href="connectivity-overview.html">connectivity feature</a>. Have a look at the
+<a href="connectivity-protocol-bindings-mqtt.html">MQTT protocol binding</a> for details.</p>
+
+<h3 id="subscribing-for-change-notifications-by-optional-filter"><a href="https://github.com/eclipse/ditto/issues/149">Subscribing for change notifications by optional filter</a></h3>
+
+<p>Until previous versions, when <a href="basic-changenotifications.html">subscribing for changes</a>, the subscriber always got all
+changes he was entitled to see (based on <a href="basic-auth.html">access control</a>). Now it is possible to specify for which
+changes to subscribe based on the optional <code class="highlighter-rouge">namespaces</code> to consider and an optional <a href="basic-rql.html">RQL</a> <code class="highlighter-rouge">filter</code>.
+The new feature is documented as <a href="basic-changenotifications.html#filtering">change notification filters</a>.</p>
+
+<h3 id="support-for-conditional-requests"><a href="https://github.com/eclipse/ditto/pull/226">Support for conditional requests</a></h3>
+
+<p>Ditto’s APIs now support <code class="highlighter-rouge">If-Match</code> and <code class="highlighter-rouge">If-None-Match</code> headers specified in
+<a href="https://tools.ietf.org/html/rfc7232#section-3.2">rfc7232</a> for <code class="highlighter-rouge">things</code> and <code class="highlighter-rouge">policies</code> resources. Have a look at the
+new <a href="https://www.eclipse.org/ditto/httpapi-concepts.html">documentation for conditional requests</a> for how this concept
+can help with advanced interaction-patterns with your twins.</p>
+
+<h2 id="bugfixes">Bugfixes</h2>
+
+<h3 id="reconnection-to-amqp-091-connections"><a href="https://github.com/eclipse/ditto/issues/228">Reconnection to AMQP 0.9.1 connections</a></h3>
+
+<p>Reconnection did not always work, e.g. when the AMQP 0.9.1 broker was not reachable for a while.</p>
+
+<h3 id="various-smaller-bugfixes">Various smaller bugfixes</h3>
+
+<p>This is a complete list of the
+<a href="https://github.com/eclipse/ditto/pulls?q=is%3Apr+milestone%3A0.8.0-M2+">merged pull requests</a>.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/release_notes_080-M3.html b/2.0/release_notes_080-M3.html
new file mode 100644
index 0000000..ffee538
--- /dev/null
+++ b/2.0/release_notes_080-M3.html
@@ -0,0 +1,1851 @@
+<!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 0.8.0-M3 of Eclipse Ditto, released on 14.11.2018">
+<meta name="keywords" content="release_notes, release notes, announcements, changelog">
+<title> Release notes 0.8.0-M3 • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 0.8.0-M3">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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 class="active"><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Release notes 0.8.0-M3</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 0.8.0-M3 of Eclipse Ditto, released on 14.11.2018</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>Since the last milestone of Eclipse Ditto <a href="release_notes_080-M2.html">0.8.0-M2</a>, the following changes, new features and
+bugfixes were added.</p>
+
+<h2 id="changes">Changes</h2>
+
+<h3 id="speed-up-search">Speed up Search</h3>
+
+<p>With more and more Things, the search service was slowing down massively.</p>
+
+<p>Two Pull Requests (<a href="https://github.com/eclipse/ditto/pull/275">#275</a>, <a href="https://github.com/eclipse/ditto/pull/278">#278</a>)
+addressed this issue with the following changes:</p>
+<ul>
+ <li>add an index on <code class="highlighter-rouge">_policyId</code> and <code class="highlighter-rouge">__policyRev</code> for the <code class="highlighter-rouge">thingEntities</code> collection.</li>
+ <li>add the field <code class="highlighter-rouge">_thingId</code> to new documents in <code class="highlighter-rouge">policiesBasedSearchIndex</code>.</li>
+ <li>add an index on <code class="highlighter-rouge">_thingId</code> for the <code class="highlighter-rouge">policiesBasedSearchIndex</code> collection.</li>
+ <li>rewrite queries on <code class="highlighter-rouge">policiesBasedSearchIndex</code> to always look for the indexed <code class="highlighter-rouge">_thingId</code> first.</li>
+</ul>
+
+<div class="alert alert-danger" role="alert"><i class="fa fa-exclamation-circle"></i> <b>Warning:</b> If you want to upgrade an existing Ditto installation, the following database
+ migration has to be done.</div>
+
+<p><strong>Data in <code class="highlighter-rouge">policiesBasedSearchIndex</code> needs to be migrated (we strongly recommend to do that in “offline mode”
+ with the Ditto cluster stopped) using the
+ <a class="no_icon" target="_blank" href="files/migration_mongodb_0.8.0-M2_0.8.0-M3.js">MongoDB migration script from 0.8.0-M2 to 0.8.0-M3</a>
+.</strong></p>
+
+<h3 id="netty-3-was-removed-from-dependencies"><a href="https://github.com/eclipse/ditto/issues/161">Netty 3 was removed from dependencies</a></h3>
+
+<p>Due to licensing issues with Netty 3, it was removed in this release and replaced with
+<a href="https://doc.akka.io/docs/akka/current/remoting-artery.html">Akka’s Artery</a> remoting which uses by default a plain TCP
+socket for communication.</p>
+
+<p>That means that a rolling update from a prior version of Ditto will fail - you’ll have to completely restart your
+cluster with all services running the new version.</p>
+
+<h2 id="new-features">New features</h2>
+
+<h3 id="apply-enforcement-for-incoming-messages-in-connectivity-service"><a href="https://github.com/eclipse/ditto/issues/265">Apply enforcement for incoming messages in connectivity service</a></h3>
+
+<p>When adding a <a href="connectivity-manage-connections.html">connection</a>, an optional enforcement (e.g. for
+<a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0</a>) may be configured in order to only accept messages having,
+for example, a defined header value.</p>
+
+<p>This is also very useful to be used for connecting to <a href="https://eclipse.org/hono/">Eclipse Hono</a> which sends a header
+<code class="highlighter-rouge">device_id</code> in every message which Ditto can check against the ID of the addressed twin.</p>
+
+<h3 id="allow-to-create-a-new-thing-that-uses-a-copied-policy"><a href="https://github.com/eclipse/ditto/issues/268">Allow to create a new thing that uses a copied policy</a></h3>
+
+<p>When <a href="protocol-specification-things-create-or-modify.html">creating a new Thing</a> it is now possible to copy the
+<a href="basic-policy.html">Policy</a> already used in another Thing.</p>
+
+<p>An example of this new feature can be found <a href="protocol-examples-creatething.html#alternative-creatething-commands">here</a>.</p>
+
+<h2 id="bugfixes">Bugfixes</h2>
+
+<p>This milestone contains several bugfixes related to memory leaks, recovery of connections and cluster consistency.</p>
+
+<h3 id="various-smaller-bugfixes">Various smaller bugfixes</h3>
+
+<p>This is a complete list of the
+<a href="https://github.com/eclipse/ditto/pulls?q=is%3Apr+milestone%3A0.8.0-M3+">merged pull requests</a>.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/release_notes_080.html b/2.0/release_notes_080.html
new file mode 100644
index 0000000..12e0e78
--- /dev/null
+++ b/2.0/release_notes_080.html
@@ -0,0 +1,1857 @@
+<!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 0.8.0 of Eclipse Ditto, released on 28.11.2018">
+<meta name="keywords" content="release_notes, release notes, announcements, changelog">
+<title> Release notes 0.8.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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 0.8.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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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 class="active"><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+
+
+ <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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Release notes 0.8.0</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 0.8.0 of Eclipse Ditto, released on 28.11.2018</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>Roughly one year after the <a href="2017-11-10-welcome-to-ditto.html">initial code contribution</a> of Eclipse Ditto and several
+milestone releases our team is very proud to announce the first official release of Ditto: <code class="highlighter-rouge">0.8.0</code>.</p>
+
+<p>Different to milestone releases which we already did this release is completely <a href="https://www.eclipse.org/projects/handbook/#ip">IP (intellectual property) checked by
+the Eclipse Foundation</a> meaning that project code as well as all used
+dependencies were “[…] reviewed to ensure that the copyrights 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>
+
+<p>Eclipse Ditto 0.8.0 focuses on providing advanced capabilities in building and working with the <em>digital twins</em> pattern.<br />
+Building and exposing digital twins is possible via different APIs: HTTP/REST, WebSockets, AMQP 1.0, AMQP 0.9.1 and
+MQTT 3.1.1 are supported.<br />
+Interaction with the bidirectional APIs is done via the “Ditto Protocol”, a protocol Ditto defined for twin interaction.<br />
+When working with a large set of twins (millions of), searching, finding and selecting partial data is possible.<br />
+On all APIs, Ditto ensures that only authorized subjects may interact (read/write) with the digital twins with the use
+of fine grained policies.</p>
+
+<p>In order to build digital twins of real world devices several integration approaches may be applied.<br />
+Ditto can establish a connection to Eclipse Hono or other AMQP 1.0 endpoints, AMQP 0.9.1 brokers or MQTT 3.1.1 brokers
+(e.g. Eclipse Mosquitto) and optionally transform received messages to “Ditto Protocol”.<br />
+Powerful devices may alternatively directly send their data to Ditto’s HTTP/WebSocket endpoints in order to reflect
+changes made to them.</p>
+
+<p>For integrating with <a href="https://eclipse.org/hono/">Eclipse Hono</a> this release makes it possible to subscribe to
+telemetry/events from devices connected via Hono and to also send command&control messages to devices
+connected to Hono and correlate replies from Hono accordingly.</p>
+
+<h3 id="changelog">Changelog</h3>
+
+<p>Compared to the latest milestone release <a href="release_notes_080-M3.html">0.8.0-M3</a>, the following changes, new features and
+bugfixes were added.</p>
+
+<h4 id="new-features">New features</h4>
+
+<h5 id="support-honos-commandcontrol-in-ditto-connectivity"><a href="https://github.com/eclipse/ditto/issues/164">Support Hono’s command&control in Ditto connectivity</a></h5>
+
+<p>Eclipse Ditto can now map arbitrary headers when connecting to AMQP 1.0 endpoints or AMQP 0.9.1 brokers.
+That way Ditto can send “command&control” messages to Eclipse Hono and correlate a potential response coming from a
+device.</p>
+
+<h4 id="bugfixes">Bugfixes</h4>
+
+<p>This release contains several bugfixes, this is a complete list of the
+<a href="https://github.com/eclipse/ditto/pulls?q=is%3Apr+milestone%3A0.8.0+">merged pull requests</a>.</p>
+
+<h2 id="api-stability">API stability</h2>
+
+<p>As you noticed, Ditto is not yet released as 1.x version, it is still an
+<a href="https://wiki.eclipse.org/Development_Resources/Process_Guidelines/What_is_Incubation">incubating Eclipse project</a>.</p>
+
+<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 API version 1 and 2 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
+already used productive and in various projects, the API stability has to be and will be ensured moving forward towards
+a 1.0.0 release.</p>
+
+<h2 id="roadmap">Roadmap</h2>
+
+<p>The Ditto project plans on releasing (non-milestone releases) twice per year, once every 6 months.</p>
+
+<p>In summer 2019 we expect to release a version 0.9.0 and in late 2019 we expect to graduate
+(exit the Eclipse incubation phase) with a 1.0.0 release.</p>
+
+<p>The plans towards which features will roughly be included will be added soon.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/release_notes_090-M1.html b/2.0/release_notes_090-M1.html
new file mode 100644
index 0000000..eeae223
--- /dev/null
+++ b/2.0/release_notes_090-M1.html
@@ -0,0 +1,1829 @@
+<!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 0.9.0-M1 of Eclipse Ditto, released on 28.03.2019">
+<meta name="keywords" content="release_notes, release notes, announcements, changelog">
+<title> Release notes 0.9.0-M1 • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 0.9.0-M1">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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 class="active"><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Release notes 0.9.0-M1</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 0.9.0-M1 of Eclipse Ditto, released on 28.03.2019</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>After the first release of Ditto <a href="release_notes_080.html">0.8.0</a>, this first milestone of the “0.9.0” release provides
+a preview of what to expect in the next release.</p>
+
+<h2 id="changes">Changes</h2>
+
+<h3 id="optimizedreduced-memory-consumption-of-ditto-json"><a href="https://github.com/eclipse/ditto/pull/304">Optimized/reduced memory consumption of ditto-json</a></h3>
+
+<p><code class="highlighter-rouge">ditto-json</code> used quite a lot of memory when building up JSON structures - this change optimized that by a factor of
+10-20, so now it is possible to keep ~1.000.000 things in memory with ~4GB of memory.</p>
+
+<h3 id="update-several-dependencies"><a href="https://github.com/eclipse/ditto/issues/300">Update several dependencies</a></h3>
+
+<p>Several used dependencies were updated to their latest (bugfix) releases or even to a stable 1.x version.</p>
+
+<h2 id="new-features">New features</h2>
+
+<h3 id="erasing-data-without-downtime"><a href="https://github.com/eclipse/ditto/issues/234">Erasing data without downtime</a></h3>
+
+<p>GDPR requires erasure of data on request of data subject.</p>
+
+<h3 id="enhance-placeholders-by-functions"><a href="https://github.com/eclipse/ditto/issues/337">Enhance placeholders by functions</a></h3>
+
+<p>The already existing placeholder mechanism for connections was enhanced by optionally adding function calls (currently
+simple string manipulations like <code class="highlighter-rouge">fn:substring-before(':')</code>).</p>
+
+<h3 id="connect-to-apache-kafka"><a href="https://github.com/eclipse/ditto/issues/224">Connect to Apache Kafka</a></h3>
+
+<p>In order to publish Ditto protocol messages (e.g. events/responses/messages/…) to Apache Kafka topics.</p>
+
+<h3 id="collect-and-provide-connection-metrics"><a href="https://github.com/eclipse/ditto/issues/317">Collect and provide connection metrics</a></h3>
+
+<p>Provide metrics about established connections (e.g. to AMQP 1.0, Kafka, MQTT, …).</p>
+
+<h2 id="bugfixes">Bugfixes</h2>
+
+<h3 id="various-smaller-bugfixes">Various smaller bugfixes</h3>
+
+<p>This is a complete list of the
+<a href="https://github.com/eclipse/ditto/pulls?q=is%3Apr+milestone%3A0.9.0-M1+">merged pull requests</a>.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/release_notes_090-M2.html b/2.0/release_notes_090-M2.html
new file mode 100644
index 0000000..fef4a5d
--- /dev/null
+++ b/2.0/release_notes_090-M2.html
@@ -0,0 +1,1830 @@
+<!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 0.9.0-M2 of Eclipse Ditto, released on 29.04.2019">
+<meta name="keywords" content="release_notes, release notes, announcements, changelog">
+<title> Release notes 0.9.0-M2 • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 0.9.0-M2">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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 class="active"><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Release notes 0.9.0-M2</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 0.9.0-M2 of Eclipse Ditto, released on 29.04.2019</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 second milestone of the “0.9.0” release provides closes more gaps towards the upcoming release.</p>
+
+<h2 id="changes">Changes</h2>
+
+<h3 id="make-it-easy-to-add-new-authentication-mechanisms-and-allow-chaining-them"><a href="https://github.com/eclipse/ditto/issues/348">Make it easy to add new Authentication mechanisms and allow chaining them</a></h3>
+
+<p>If we have multiple applicable authentication mechanisms all of them are processed until either one of them
+authenticates successfully or all of them fail.</p>
+
+<h3 id="unify-implementations-of-things-search-across-api-versions"><a href="https://github.com/eclipse/ditto/pull/392">Unify implementations of things-search across API versions</a></h3>
+
+<p>Ditto’s “search” capabilities were rewritten so that bot API v1 and API v2 use the same MongoDB based search index.</p>
+
+<div class="alert alert-danger" role="alert"><i class="fa fa-exclamation-circle"></i> <b>Warning:</b> If you want to upgrade an existing Ditto installation, the following database
+ migration has to be done: <strong>Follow the steps documented in <a href="architecture-services-things-search.html#migration-from-ditto-090-m1">the migration notes</a></strong>.</div>
+
+<h2 id="new-features">New features</h2>
+
+<h3 id="various-contributions-for-a-setup-of-eclipse-ditto-on-microsoft-azure">Various contributions for a setup of Eclipse Ditto on Microsoft Azure</h3>
+
+<p>As discussed in the ongoing issue <a href="https://github.com/eclipse/ditto/issues/358">Eclipse Ditto on Microsoft Azure</a> Microsoft
+added a few PRs in order to deploy Ditto on MS Azure cloud:</p>
+
+<ul>
+ <li><a href="https://github.com/eclipse/ditto/pull/364">Enable support for MongoDB persistence in K8s</a></li>
+ <li><a href="https://github.com/eclipse/ditto/pull/375">Fix Nginx connectivity after Helm update</a></li>
+ <li><a href="https://github.com/eclipse/ditto/pull/367">Recover from closed JMS AMQP message producer</a></li>
+ <li><a href="https://github.com/eclipse/ditto/pull/386">Improve nginx configuration for gateway restarts</a></li>
+</ul>
+
+<h2 id="bugfixes">Bugfixes</h2>
+
+<h3 id="mqtt-publish-fails-if-no-sources-are-configured"><a href="https://github.com/eclipse/ditto/issues/387">MQTT publish fails if no sources are configured</a></h3>
+
+<p>Fixed: If using a MQTT connection that only has targets but no sources, publishing of events will fail.</p>
+
+<h3 id="various-smaller-bugfixes">Various smaller bugfixes</h3>
+
+<p>This is a complete list of the
+<a href="https://github.com/eclipse/ditto/pulls?q=is%3Apr+milestone%3A0.9.0-M2+">merged pull requests</a>.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/release_notes_090.html b/2.0/release_notes_090.html
new file mode 100644
index 0000000..007ddc0
--- /dev/null
+++ b/2.0/release_notes_090.html
@@ -0,0 +1,1887 @@
+<!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 0.9.0 of Eclipse Ditto, released on 10.07.2019">
+<meta name="keywords" content="release_notes, release notes, announcements, changelog">
+<title> Release notes 0.9.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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 0.9.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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <li><a href="release_notes_100.html">1.0.0</a></li>
+
+
+
+
+
+ <li class="active"><a href="release_notes_090.html">0.9.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_080.html">0.8.0</a></li>
+
+
+
+
+
+ <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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Release notes 0.9.0</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 0.9.0 of Eclipse Ditto, released on 10.07.2019</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>During several very hot summer days the Eclipse Ditto team worked on that last issues which were blocking our next
+release: <code class="highlighter-rouge">0.9.0</code>.</p>
+
+<p>The successor release of <a href="release_notes_080.html">0.8.0</a> will most likely be the last “0.” incubation release as Ditto
+is moving forward for a <code class="highlighter-rouge">1.0.0</code> and a project graduation in Eclipse IoT.</p>
+
+<p>Same as for <code class="highlighter-rouge">0.8.0</code> this release is completely <a href="https://www.eclipse.org/projects/handbook/#ip">IP (intellectual property) checked by
+the Eclipse Foundation</a> meaning that project code as well as all used
+dependencies were “[…] reviewed to ensure that the copyrights 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>
+
+<p>Eclipse Ditto 0.9.0 focuses on the following areas:</p>
+
+<ul>
+ <li>Memory improvements for huge amounts (multi million) of digital twins which are held in memory</li>
+ <li>Adding metrics and logging around the connectivity feature in order to enable being able to operate connections to foreign systems/brokers via APIs</li>
+ <li>Enhancing Ditto’s connectivity feature by additionally being able to connect to Apache Kafka</li>
+ <li>Performance improvements of Ditto’s search functionality</li>
+ <li>Stabilization of cluster bootstrapping</li>
+ <li>Refactoring of how the services configurations are determined</li>
+ <li>Addition of a Helm template in order to simplify Kubernetes based deployments</li>
+ <li>Contributions from Microsoft in order to ease operating Eclipse Ditto on Microsoft Azure</li>
+</ul>
+
+<div class="alert alert-danger" role="alert"><i class="fa fa-exclamation-circle"></i> <b>Warning:</b> If you want to upgrade an existing Ditto 0.8.0 installation, the following database
+ migration has to be done: <strong>Follow the steps documented in <a href="architecture-services-things-search.html#migration-from-ditto-090-m1">the migration notes</a></strong>.</div>
+
+<h3 id="changelog">Changelog</h3>
+
+<p>Compared to the latest milestone release <a href="release_notes_090-M2.html">0.9.0-M2</a>, the following changes, new features and
+bugfixes were added.</p>
+
+<h4 id="changes">Changes</h4>
+
+<h5 id="streamline-configuration"><a href="https://github.com/eclipse/ditto/issues/350">Streamline configuration</a></h5>
+
+<p>In this release, we changed how internally the configuration is determined in Ditto’s microservices. This should not
+have any impact on a user of Eclipse Ditto. As however some configuration keys were remanded or restructured, some
+adjustments when manually configuring Ditto could be required.</p>
+
+<h4 id="new-features">New features</h4>
+
+<h5 id="introduce-cursor-based-paging-for-search-requests"><a href="https://github.com/eclipse/ditto/pull/407">Introduce cursor-based paging for search requests</a></h5>
+
+<p>In order to provide a constant performance for using pagination for the <code class="highlighter-rouge">things-search</code> miscroservice across even large
+result sets (100s of thousands or more) of digital twins, a new cursor-based approach was added in addition to the
+old <code class="highlighter-rouge">offset/limit</code> approach which gets slower for each page.</p>
+
+<h5 id="simple-throttling-for-amqp-10-consumers"><a href="https://github.com/eclipse/ditto/pull/420">Simple throttling for amqp 1.0 consumers</a></h5>
+
+<p>Added a simple throttling mechanism for amqp 1.0 consumers.
+The throttling is configurable by defining the number of messages allowed per time interval.</p>
+
+<h5 id="collect-connectivity-log-entries-and-provide-via-devops-command"><a href="https://github.com/eclipse/ditto/issues/318">Collect connectivity log entries and provide via devops command</a></h5>
+
+<p>In order to let a user analyze failures / unexpected behavior in his connections (e.g. to an MQTT or AMQP broker)
+without giving him full access to the log-files of Ditto, a connection scoped mechanism for retrieving connectivity logs
+was added.</p>
+
+<h4 id="bugfixes">Bugfixes</h4>
+
+<h5 id="memory-and-performance-fixes-in-concierge-gateway"><a href="https://github.com/eclipse/ditto/pull/400">Memory and performance fixes in concierge, gateway</a></h5>
+
+<p>Ditto’s <code class="highlighter-rouge">concierge</code> service did use a sharding approach for enforcing authorization information which lead to huge
+amounts of memory required when managing multi million of digital twins.</p>
+
+<p>That, in addition to some memory fixes in the gateway and addition of metrics, was fixed in this PR.</p>
+
+<h5 id="ensure-ordering-for-processed-commands"><a href="https://github.com/eclipse/ditto/pull/417">Ensure ordering for processed commands</a></h5>
+
+<p>In previous versions of Ditto the order in which command were processed not guaranteed to be maintained. As maintaining
+the order however is the expected behavior, we decided to treat that as bug and added to the <code class="highlighter-rouge">concierge</code> service (where
+the order could be lost) to sequentially process commands issues via HTTP/WebSocket and connections.</p>
+
+<p>This release contains several bugfixes, this is a complete list of the
+<a href="https://github.com/eclipse/ditto/pulls?q=is%3Apr+milestone%3A0.9.0+">merged pull requests</a>.</p>
+
+<h2 id="api-stability">API stability</h2>
+
+<p>As you noticed, Ditto is not yet released as 1.x version, it is still an
+<a href="https://wiki.eclipse.org/Development_Resources/Process_Guidelines/What_is_Incubation">incubating Eclipse project</a>.</p>
+
+<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 API version 1 and 2 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
+already used productive and in various projects, the API stability has to be and will be ensured moving forward towards
+a 1.0.0 release.</p>
+
+<h2 id="roadmap">Roadmap</h2>
+
+<p>The Ditto project plans on releasing (non-milestone releases) twice per year, once every 6 months.</p>
+
+<p>In late 2019 we expect to graduate (exit the Eclipse incubation phase) with a 1.0.0 release.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/release_notes_100-M1a.html b/2.0/release_notes_100-M1a.html
new file mode 100644
index 0000000..e8b2aa9
--- /dev/null
+++ b/2.0/release_notes_100-M1a.html
@@ -0,0 +1,1848 @@
+<!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.0.0-M1a of Eclipse Ditto, released on 17.09.2019">
+<meta name="keywords" content="release_notes, release notes, announcements, changelog">
+<title> Release notes 1.0.0-M1a • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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.0.0-M1a">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><a href="release_notes_100-M2.html">1.0.0-M2</a></li>
+
+
+
+
+
+ <li class="active"><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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.0.0-M1a</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 1.0.0-M1a of Eclipse Ditto, released on 17.09.2019</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 first milestone of the “1.0.0” release provides a preview of what to expect in the next release.</p>
+
+<h2 id="changes">Changes</h2>
+
+<h3 id="add-hivemq-mqtt-client-as-an-alternative-for-mqtt-integration"><a href="https://github.com/eclipse/ditto/pull/487">Add HiveMQ MQTT client as an alternative for MQTT integration</a></h3>
+
+<p>Due to the problems described in <a href="https://github.com/eclipse/ditto/issues/450">#450</a> we decided to add the HiveMQ
+ MQTT Client as an alternative for the connection of Ditto to MQTT brokers. Once it has proven to be working and
+ stable in production, it will replace the previous client (Alpakka/Paho).</p>
+
+<h3 id="scalable-event-publishing"><a href="https://github.com/eclipse/ditto/pull/483">Scalable event publishing</a></h3>
+
+<p>This patch improves horizontal scalability of Ditto’s event publishing mechanism. Find a more detailed description of
+ this change in the pull request.</p>
+
+<h3 id="typed-entity-ids"><a href="https://github.com/eclipse/ditto/pull/475">Typed entity IDs</a></h3>
+
+<p>This change introduces validated Java representations for entity IDs.</p>
+
+<h3 id="introduce-architectural-decision-records-adr"><a href="https://github.com/eclipse/ditto/pull/470">Introduce architectural decision records (ADR)</a></h3>
+
+<p>We want to keep track of architectural decisions and decided to use the format of ADRs for this purpose.</p>
+
+<h3 id="relax-uri-restrictions"><a href="https://github.com/eclipse/ditto/pull/451">Relax uri restrictions</a></h3>
+
+<p>With this change we allow more characters in uris.</p>
+
+<h3 id="background-cleanup-for-stale-journal-entries-and-snapshots"><a href="https://github.com/eclipse/ditto/pull/446">Background cleanup for stale journal entries and snapshots</a></h3>
+
+<p>This change introduces a asynchronous background deletion approach which replaces the current approach.</p>
+
+<h2 id="new-features">New features</h2>
+
+<h3 id="initial-contribution-of-java-client-sdk"><a href="https://github.com/eclipse/ditto-clients/pull/1">Initial contribution of Java client SDK</a></h3>
+
+<p>Contribution was extracted from former commercial-only client - all references to Bosch were removed. Consists of
+ full working, OSGi capable “ditto-client” artifact. More information can be found in our
+ <a href="client-sdk-java.html">SDK documentation</a>.</p>
+
+<h3 id="configurable-authorization-servers"><a href="https://github.com/eclipse/ditto/pull/477">Configurable authorization servers</a></h3>
+
+<p>Eclipse Ditto now supports all OAuth 2.0 providers which implement OpenID Connect out-of-the-box. See this
+<a href="https://www.eclipse.org/ditto/2019-08-28-openid-connect.html">blog post</a> for more details.</p>
+
+<h3 id="fine-grained-access-for-connections"><a href="https://github.com/eclipse/ditto/pull/463">Fine grained access for connections</a></h3>
+
+<p>With this change it is possible to restrict access to connections on any level via a policy.</p>
+
+<h3 id="reconnecting-feature-for-created-connections"><a href="https://github.com/eclipse/ditto/pull/442">Reconnecting feature for created connections</a></h3>
+
+<p>When creating a connection, it will also contain the desired status of the connection.</p>
+
+<h2 id="bugfixes">Bugfixes</h2>
+
+<h3 id="various-smaller-bugfixes">Various smaller bugfixes</h3>
+
+<p>This is a complete list of the
+<a href="https://github.com/eclipse/ditto/pulls?q=is%3Apr+milestone%3A1.0.0-M1a">merged pull requests</a>.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/release_notes_100-M2.html b/2.0/release_notes_100-M2.html
new file mode 100644
index 0000000..1a334f3
--- /dev/null
+++ b/2.0/release_notes_100-M2.html
@@ -0,0 +1,1865 @@
+<!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.0.0-M2 of Eclipse Ditto, released on 04.11.2019">
+<meta name="keywords" content="release_notes, release notes, announcements, changelog">
+<title> Release notes 1.0.0-M2 • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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.0.0-M2">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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="active"><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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.0.0-M2</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 1.0.0-M2 of Eclipse Ditto, released on 04.11.2019</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 second milestone is one last stop preparing for the upcoming “1.0.0” release.</p>
+
+<h2 id="changes">Changes</h2>
+
+<h3 id="dont-allow-double-slashes-in-json-pointers-and-rest"><a href="https://github.com/eclipse/ditto/pull/524">Don’t allow double slashes in JSON pointers and REST</a></h3>
+
+<p>Ditto allowed to have double slashed in JSON pointers (e.g.: <code class="highlighter-rouge">features//foo/properties</code>) and HTTP endpoints.
+Allowing those did not always result the API behave like expected, so this is now handled more strictly.
+From now on, a <code class="highlighter-rouge">JsonPointerInvalidException</code> will be thrown whenever double slashes are encountered, e.g. resulting
+in a status code <code class="highlighter-rouge">400</code> (Bad request) at the HTTP API.</p>
+
+<h3 id="connection-json-format-was-adjusted">Connection JSON format was adjusted</h3>
+
+<p>As a result of the newly added feature “<a href="https://github.com/eclipse/ditto/issues/492">Map Hono device connection status to Thing feature</a>”
+(see below), the JSON format of connections was adjusted.</p>
+
+<p>The new format is documented here:
+<a href="connectivity-manage-connections.html#payload-mapping-configuration">connections payload mapping configuration</a>.</p>
+
+<p>The good news however is that previously created connections will automatically be migrated to that format
+(e.g. when querying) the API, so the old format is still supported.</p>
+
+<h2 id="new-features">New features</h2>
+
+<h3 id="enhance-dittos-connectivity-by-invoking-http-endpoints"><a href="https://github.com/eclipse/ditto/issues/491">Enhance Ditto’s connectivity by invoking HTTP endpoints</a></h3>
+
+<p>One of the bigger feature enhancements since the last milestone release is connections to existing HTTP endpoints/servers.<br />
+By adding the “connection type” HTTP to Ditto’s connectivity feature Ditto can now perform HTTP calls for the configured
+“targets”, e.g. for twin events.</p>
+
+<p>That may be used in order to integrate with other public HTTP APIs. See also the
+<a href="2019-10-17-http-connectivity.html">published blog post about that</a>.</p>
+
+<h3 id="map-hono-device-connection-status-to-thing-feature"><a href="https://github.com/eclipse/ditto/issues/492">Map Hono device connection status to Thing feature</a></h3>
+
+<p>The integration with <a href="https://eclipse.org/hono/">Eclipse Hono</a> was improved by adding the possibility tp extract
+<code class="highlighter-rouge">creation-time</code> and <code class="highlighter-rouge">ttd</code> headers from consumed Hono telemetry and event messages and automatically updating the
+targeted thing with a <a href="connectivity-mapping.html#connectionstatus-mapper">ConnectionStatus</a> feature.</p>
+
+<p>This feature was added by enhancing and generalizing the overall <a href="connectivity-mapping.html">payload mapping</a> feature,
+as a result now multiple payload mappings may be defined and selectively applied to sources/targets in
+<a href="connectivity-manage-connections.html">connections</a>.</p>
+
+<h3 id="support-for-oauth-based-authentication-in-ditto-java-client"><a href="https://github.com/eclipse/ditto-clients/issues/17">Support for OAuth based authentication in Ditto Java client</a></h3>
+
+<p>In <a href="release_notes_100-M1a.html">1.0.0-M1a</a> support for arbitrary OpenID Connect providers was
+<a href="2019-08-28-openid-connect.html">added</a> to Ditto.<br />
+Now the Ditto Java client can authenticate itself by either providing “client-id” and “client-secret” or by
+supplying JWT tokens via a custom callback.</p>
+
+<h3 id="throttle-max-processed-inbound-websocket-per-time-interval"><a href="https://github.com/eclipse/ditto/pull/517">Throttle max. processed inbound websocket per time interval</a></h3>
+
+<p>It is not always desirable that a single websocket connection may “flood” a Ditto backend with a massive amount of
+commands.<br />
+This makes it possible to configure the amount of websocket commands limit per duration interval.<br />
+The defaults configuration is: 100 / 1second</p>
+
+<h2 id="bugfixes">Bugfixes</h2>
+
+<h3 id="deleted-things-were-still-available-in-search"><a href="https://github.com/eclipse/ditto/issues/526">Deleted things were still available in search</a></h3>
+
+<p>When things were deleted, they were still available and findable in the search index (as the search index was cleared
+via a <code class="highlighter-rouge">TTL</code> index). This is now fixed.</p>
+
+<h3 id="failed-connections-amqp-10-target-didnt-back-off"><a href="https://github.com/eclipse/ditto/pull/516">Failed connections AMQP 1.0 target didn’t back-off</a></h3>
+
+<p>When an AMQP 1.0 endpoint did not allow to open a link to an address, Ditto tried to reconnect in a high frequency.
+As such errors are most likely configuration errors, that almost never is a good solution. The aggressive reconnect
+produced a lot of load both to Ditto and the AMQP 1.0 endpoint.<br />
+This fix introduces an exponential back-off mechanism.</p>
+
+<h3 id="various-smaller-bugfixes">Various smaller bugfixes</h3>
+
+<p>This is a complete list of the
+<a href="https://github.com/eclipse/ditto/pulls?q=is%3Apr+milestone%3A1.0.0-M2">merged pull requests</a>.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/release_notes_100.html b/2.0/release_notes_100.html
new file mode 100644
index 0000000..d78ef75
--- /dev/null
+++ b/2.0/release_notes_100.html
@@ -0,0 +1,1868 @@
+<!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.0.0 of Eclipse Ditto, released on 12.12.2019">
+<meta name="keywords" content="release_notes, release notes, announcements, changelog">
+<title> Release notes 1.0.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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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.0.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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <li class="active"><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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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.0.0</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 1.0.0 of Eclipse Ditto, released on 12.12.2019</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 Ditto’s first major release which is tied to project graduation in Eclipse IoT.</p>
+
+<p>This release is completely <a href="https://www.eclipse.org/projects/handbook/#ip">IP (intellectual property) checked by the Eclipse Foundation</a>
+meaning that project code as well as all used dependencies were “[…] reviewed to ensure that the copyrights
+expressed are correct, licensing is valid and compatible, and that other issues have been uncovered and properly
+investigated.”</p>
+
+<h2 id="changelog">Changelog</h2>
+
+<p>Eclipse Ditto 1.0.0 focuses on the following areas:</p>
+
+<ul>
+ <li>Addition of “definition” field in thing at model level containing the model ID a thing may follow</li>
+ <li>Improved connection response handling/mapping</li>
+</ul>
+
+<div class="alert alert-danger" role="alert"><i class="fa fa-exclamation-circle"></i> <b>Warning:</b>
+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>
+
+<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>
+
+<h3 id="changes">Changes</h3>
+
+<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>
+
+<h3 id="new-features">New features</h3>
+
+<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>
+ <li>the response address may be configured</li>
+ <li>response header mappings may be configured</li>
+</ul>
+
+<p>Both accepting placeholders, so e.g. with that feature it is possible to send replies whenever an incoming command
+specified a <code class="highlighter-rouge">reply-to</code> address.</p>
+
+<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>
+
+<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>
+
+<h3 id="bugfixes">Bugfixes</h3>
+
+<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>
+
+<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.
+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>
+
+<p><a class="no_icon" target="_blank" href="files/migration_mongodb_1.0.0.js">MongoDB migration script</a></p>
+
+<p>The script will copy all Thing and Policy events and snapshots from suffixed collections to one journal for each entity,
+e.g. from things_journal@org.eclipse.ditto and things_journal@org.eclipse.hono to things_journal.</p>
+
+<ol>
+ <li>Completely stop Ditto.</li>
+ <li>Execute the migration script via mongo shell.</li>
+ <li>Update Ditto to 1.0.0.</li>
+ <li>Start Ditto.</li>
+</ol>
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/release_notes_110.html b/2.0/release_notes_110.html
new file mode 100644
index 0000000..84d7fce
--- /dev/null
+++ b/2.0/release_notes_110.html
@@ -0,0 +1,1909 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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="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>
+
+<h3 id="changes">Changes</h3>
+
+<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>
+
+<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>
+
+<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>
+
+<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>
+
+<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>
+
+<h3 id="new-features">New features</h3>
+
+<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
+<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>
+
+<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
+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>
+
+<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>
+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>
+
+<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 />
+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>
+
+<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>
+
+<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>
+
+<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>
+
+<h3 id="deprecations">Deprecations</h3>
+
+<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 ACLs, 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>
+
+<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>
+
+<h2 id="migration-notes">Migration notes</h2>
+
+<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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/release_notes_111.html b/2.0/release_notes_111.html
new file mode 100644
index 0000000..4b7b086
--- /dev/null
+++ b/2.0/release_notes_111.html
@@ -0,0 +1,1807 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/release_notes_112.html b/2.0/release_notes_112.html
new file mode 100644
index 0000000..f47e8cf
--- /dev/null
+++ b/2.0/release_notes_112.html
@@ -0,0 +1,1823 @@
+<!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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/release_notes_113.html b/2.0/release_notes_113.html
new file mode 100644
index 0000000..837c086
--- /dev/null
+++ b/2.0/release_notes_113.html
@@ -0,0 +1,1823 @@
+<!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.3 of Eclipse Ditto, released on 20.07.2020">
+<meta name="keywords" content="release_notes, release notes, announcements, changelog">
+<title> Release notes 1.1.3 • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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.3">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li class="active"><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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.3</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 1.1.3 of Eclipse Ditto, released on 20.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_112.html">1.1.2</a> were added.</p>
+
+<h2 id="changelog">Changelog</h2>
+
+<p>Compared to the latest release <a href="release_notes_112.html">1.1.2</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.3">merged pull requests</a>, including the fixed bugs.</p>
+
+<h4 id="do-not-decided-based-on-the-response-if-it-was-required"><a href="https://github.com/eclipse/ditto/pull/734">Do not decided based on the response if it was required</a></h4>
+
+<p>Fixed <a href="https://github.com/eclipse/ditto/issues/677">Responses should not decide whether they’re required</a>.</p>
+
+<h4 id="include-fields-query-parameter-when-retrieving-feature-properties"><a href="https://github.com/eclipse/ditto/pull/727">Include fields query parameter when retrieving feature properties</a></h4>
+
+<p>There was an issue where the fields query parameter wasn’t taken into account when retrieving feature properties.</p>
+
+<h4 id="delegate-default-options-from-wrapping-message-mapper-to-wrapped-message-mapper"><a href="https://github.com/eclipse/ditto/pull/723">Delegate default options from wrapping message mapper to wrapped message mapper</a></h4>
+
+<p>The WrappingMessageMapper didn’t delegate the default options to the message mapper it was wrapping.</p>
+
+<h4 id="improved-error-message-for-unknowninvalid-host-names-in-a-connection-configuration"><a href="https://github.com/eclipse/ditto/pull/676">Improved error message for unknown/invalid host names in a connection configuration</a></h4>
+
+<p>An unknown/invalid host in a connection configuration caused an exception with an error message that did not indicate the actual cause.</p>
+
+<h4 id="reworked-reconnect-behaviour-of-java-client"><a href="https://github.com/eclipse/ditto-clients/pull/64">Reworked reconnect behaviour of java client</a></h4>
+
+<p>There were reported issues with the reconnecting behaviour of the java client. We improved the reconnecting behaviour, so it should be more reliable.</p>
+
+<h4 id="added-orgreactivestreams-to-osgi-imports"><a href="https://github.com/eclipse/ditto-clients/pull/73">Added org.reactivestreams to osgi imports</a></h4>
+
+<p>The package <code class="highlighter-rouge">org.reactivestreams</code> was missing in the OSGI imports of our java client.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/release_notes_115.html b/2.0/release_notes_115.html
new file mode 100644
index 0000000..61c7629
--- /dev/null
+++ b/2.0/release_notes_115.html
@@ -0,0 +1,1811 @@
+<!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.5 of Eclipse Ditto, released on 25.08.2020">
+<meta name="keywords" content="release_notes, release notes, announcements, changelog">
+<title> Release notes 1.1.5 • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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.5">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li class="active"><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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.5</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 1.1.5 of Eclipse Ditto, released on 25.08.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_113.html">1.1.3</a> were added.</p>
+
+<p>Unfortunately Ditto release attempt 1.1.4 had technical difficulties on the build server which lead to that
+we had to skip 1.1.4 and release 1.1.5 instead (being the same as 1.1.4 would have been).</p>
+
+<h2 id="changelog">Changelog</h2>
+
+<p>Compared to the latest release <a href="release_notes_113.html">1.1.3</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.5">merged pull requests</a>, including the fixed bugs.</p>
+
+<h4 id="compile-model-modules-with-java-8"><a href="https://github.com/eclipse/ditto/pull/769">Compile model modules with Java 8</a></h4>
+
+<p>The 2 modules in the Ditto model were accidentally compiled with Java 11 as source/target which caused
+that e.g. the Ditto client could not be used any longer with Java 8:</p>
+<ul>
+ <li><code class="highlighter-rouge">rql-parser</code></li>
+ <li><code class="highlighter-rouge">thingssearch-parser</code></li>
+</ul>
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/release_notes_120.html b/2.0/release_notes_120.html
new file mode 100644
index 0000000..0fe64e8
--- /dev/null
+++ b/2.0/release_notes_120.html
@@ -0,0 +1,1883 @@
+<!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.2.0 of Eclipse Ditto, released on 31.08.2020">
+<meta name="keywords" content="release_notes, release notes, announcements, changelog">
+<title> Release notes 1.2.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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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.2.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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li class="active"><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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.2.0</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 1.2.0 of Eclipse Ditto, released on 31.08.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 second minor (feature adding) release of Eclipse Ditto 1 is here: <strong>1.2.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 and 1.1.0.</p>
+
+<h2 id="changelog">Changelog</h2>
+
+<p>Compared to the latest minor release <a href="release_notes_110.html">1.1.0</a>, the following changes, new features and
+bugfixes were added.</p>
+
+<p>The main change of Ditto 1.2.0 is the now full support for QoS 1 (“at least once”) message processing.</p>
+
+<h3 id="changes">Changes</h3>
+
+<h4 id="update-docker-base-image-to-openj9-0210"><a href="https://github.com/eclipse/ditto/pull/743">Update Docker base image to OpenJ9 0.21.0</a></h4>
+
+<p>Updated to running the Ditto Docker containers with the latest OpenJ9 0.21.0 (with OpenJDK 11).</p>
+
+<h4 id="added-config-key-for-setting-the-max-pool-size-for-connections">Added config key for setting the max pool size for connections</h4>
+
+<p>The pool is used for mapping inbound and outbound messages in the connectivity service. It is configured
+per connection in the attribute <code class="highlighter-rouge">processorPoolSize</code>.</p>
+
+<p>To provide a meaningful max per-connection pool size, you can now configure a service-wide maximum
+in the connectivity service using the key <code class="highlighter-rouge">ditto.connectivity.mapping.max-pool-size</code> (or its corresponding
+environment variable <code class="highlighter-rouge">CONNECTIVITY_MESSAGE_MAPPING_MAX_POOL_SIZE</code>).</p>
+
+<h3 id="new-features">New features</h3>
+
+<h4 id="fnfilter-function-for-connectivity-header-mapping"><a href="https://github.com/eclipse/ditto/pull/674"><code class="highlighter-rouge">fn:filter</code> function for connectivity header mapping</a></h4>
+
+<p>In connection <a href="connectivity-header-mapping.html">header mappings</a> as part of the placeholders, the new
+<a href="basic-placeholders.html#function-library"><code class="highlighter-rouge">fn:filter</code></a> function may be used in order to remove the result of the
+previous expression in the function pipeline unless the condition specified by the parameters is satisfied.</p>
+
+<h4 id="whoami-http-resource"><a href="https://github.com/eclipse/ditto/pull/687">Whoami HTTP resource</a></h4>
+
+<p>The new HTTP <code class="highlighter-rouge">GET</code> resource <code class="highlighter-rouge">/whoami</code> may be called in order to find out which authorization subjects were resolved in
+the HTTP call’s authentication. This can be e.g. useful to find out the used JWT subject which should be added to
+<a href="basic-policy.html#subjects">policies</a>.</p>
+
+<h4 id="support-using-client-certificate-based-authentication-in-http-push-connections"><a href="https://github.com/eclipse/ditto/pull/695">Support using client certificate based authentication in HTTP push connections</a></h4>
+
+<p>Connections of type <a href="connectivity-protocol-bindings-http.html">HTTP push</a> can now, additionally to username/password
+based authentication, make use of
+<a href="connectivity-protocol-bindings-http.html#client-certificate-authentication">client certificate based authentication</a>.</p>
+
+<h4 id="automatic-end-2-end-acknowledgements-handling-for-managed-connections"><a href="https://github.com/eclipse/ditto/issues/661">Automatic end-2-end acknowledgements handling for managed connections</a></h4>
+
+<p>Acknowledgements can now be configured to be requested for messages consumed by connection
+<a href="basic-connections.html#source-acknowledgement-requests">sources (acknowledgement requests)</a> and can automatically be
+issued by targets to automatically <a href="basic-connections.html#target-issued-acknowledgement-label">issue acknowledgements</a>
+for all published twin events, live commands and live messages that request them.</p>
+
+<h4 id="end-2-end-acknowledgements-support-for-live-messagescommands"><a href="https://github.com/eclipse/ditto/issues/757">End-2-end acknowledgements support for “live” messages/commands</a></h4>
+
+<p>Acknowledgements for <a href="basic-acknowledgements.html#assure-qos-until-processing-of-a-live-commandmessage-by-a-subscriber---live-response">live messages/commands</a>
+are now supported as well. Both requesting and issuing them, e.g. in order to acknowledge that a message was
+successfully received without directly responding to it.</p>
+
+<h4 id="addition-of-_created-date-to-things"><a href="https://github.com/eclipse/ditto/issues/749">Addition of <code class="highlighter-rouge">_created</code> date to things</a></h4>
+
+<p>Whenever a <a href="basic-thing.html">thing</a> is now created, a JSON field <code class="highlighter-rouge">"_created"</code> is now added containing the creation
+date. This field can be selected via <a href="httpapi-concepts.html#with-field-selector">fields selection</a>, as the already
+existing <code class="highlighter-rouge">"_modified"</code> field can also be. The created date can also be used as part of
+<a href="basic-rql.html">search RQL queries</a>.</p>
+
+<h4 id="support-for-adding-_metadata-to-things"><a href="https://github.com/eclipse/ditto/issues/680">Support for adding <code class="highlighter-rouge">_metadata</code> to things</a></h4>
+
+<p>On modifying API calls to a <a href="basic-thing.html">thing</a>, additional metadata can now be passed with the header field
+<code class="highlighter-rouge">"put-header"</code>. Documentation for this feature is still missing, but will be added soon after the 1.2.0 release.</p>
+
+<h3 id="bugfixes">Bugfixes</h3>
+
+<p>Several bugs in Ditto 1.1.x were fixed for 1.2.0.<br />
+This is a complete list of the
+<a href="https://github.com/eclipse/ditto/pulls?q=is%3Apr+milestone%3A1.2.0">merged pull requests</a>, including the fixed bugs.</p>
+
+<h4 id="connectivity-service-does-not-consume-message-after-reconnect-to-amqp-091"><a href="https://github.com/eclipse/ditto/issues/770">Connectivity service does not consume message after reconnect to AMQP (0.9.1)</a></h4>
+
+<p>Connections via AMQP 0.9.1 did not correctly resume message consumption after the broker was e.g. restarted.</p>
+
+<h2 id="migration-notes">Migration notes</h2>
+
+<h3 id="renamed-config-keys-containing-blacklist-to-blocklist">Renamed config keys containing <code class="highlighter-rouge">blacklist</code> to <code class="highlighter-rouge">blocklist</code></h3>
+
+<ul>
+ <li>in <code class="highlighter-rouge">gateway.conf</code>: <code class="highlighter-rouge">ditto.gateway.http.redirect-to-https-blocklist-pattern</code></li>
+ <li>in <code class="highlighter-rouge">ditto-cluster.conf</code>: <code class="highlighter-rouge">ditto.cluster.cluster-status-roles-blocklist</code></li>
+ <li>in <code class="highlighter-rouge">ditto-protocol.conf</code>: <code class="highlighter-rouge">ditto.protocol.blocklist</code></li>
+</ul>
+
+<p>If you configured any of the <code class="highlighter-rouge">blocklist</code> entries with Ditto < 1.2.0, you’ll have to adjust your configuration
+accordingly.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/release_notes_121.html b/2.0/release_notes_121.html
new file mode 100644
index 0000000..648e164
--- /dev/null
+++ b/2.0/release_notes_121.html
@@ -0,0 +1,1810 @@
+<!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.2.1 of Eclipse Ditto, released on 08.09.2020">
+<meta name="keywords" content="release_notes, release notes, announcements, changelog">
+<title> Release notes 1.2.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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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.2.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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li class="active"><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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.2.1</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 1.2.1 of Eclipse Ditto, released on 08.09.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_120.html">1.2.0</a> were added.</p>
+
+<h2 id="changelog">Changelog</h2>
+
+<p>Compared to the latest release <a href="release_notes_120.html">1.2.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.2.1">merged pull requests</a>, including the fixed bugs.</p>
+
+<h4 id="ditto-json-is-not-osgi-compatible-due-to-missing-imports"><a href="https://github.com/eclipse/ditto/issues/790">Ditto JSON is not OSGi compatible due to missing imports</a></h4>
+
+<p>The OSGi bundle <code class="highlighter-rouge">ditto-json</code> was not compatible to be run in OSGi environments as imports of 3rd party libraries
+were used which were not defined in the <code class="highlighter-rouge">Import-Package</code> of the bundle.</p>
+
+<p>The 3rd party libraries (<code class="highlighter-rouge">jackson-core</code> and <code class="highlighter-rouge">jackson-dataformat-cbor</code>) were declared on “provided” scope previously
+which made problems in the OSGi environment.</p>
+
+<p>Instead, the bugfix splitted up the CBOR serialization into a separate module <code class="highlighter-rouge">ditto-json-cbor</code> in order to prevent the
+jackson dependencies to be required at all in <code class="highlighter-rouge">ditto-json</code> (and as a result also in the <code class="highlighter-rouge">ditto-client</code>).</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/release_notes_130.html b/2.0/release_notes_130.html
new file mode 100644
index 0000000..e75b69f
--- /dev/null
+++ b/2.0/release_notes_130.html
@@ -0,0 +1,1900 @@
+<!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.3.0 of Eclipse Ditto, released on 30.09.2020">
+<meta name="keywords" content="release_notes, release notes, announcements, changelog">
+<title> Release notes 1.3.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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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.3.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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li class="active"><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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.3.0</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 1.3.0 of Eclipse Ditto, released on 30.09.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>Ditto <strong>1.3.0</strong> 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 prior Eclipse Ditto 1.x versions.</p>
+
+<h2 id="changelog">Changelog</h2>
+
+<p>Compared to the latest minor release <a href="release_notes_120.html">1.2.0</a>, the following changes, new features and
+bugfixes were added.</p>
+
+<h3 id="changes">Changes</h3>
+
+<h4 id="update-akka-akka-http-and-scala-to-latest-versions"><a href="https://github.com/eclipse/ditto/issues/774">Update Akka, Akka HTTP and Scala to latest versions</a></h4>
+
+<p>The core libraries Ditto is built on were updated to their latest versions which should improve cluster stability
+and overall performance.</p>
+
+<h4 id="removed-owasp-security-headers"><a href="https://github.com/eclipse/ditto/pull/804">Removed OWASP security headers</a></h4>
+
+<p>Setting the <a href="https://owasp.org/www-project-secure-headers/">OWASP recommended secure HTTP headers</a>
+(e.g. <code class="highlighter-rouge">X-Frame-Options</code>, <code class="highlighter-rouge">X-Content-Type-Options</code>, <code class="highlighter-rouge">X-XSS-Protection</code>) was removed from the Ditto codebase as such
+headers are typically set in a reverse proxy (e.g. nginx) or in a cloud loadbalancer in front of Ditto.</p>
+
+<h4 id="ditto-java-client-changed-default-initial-reconnect-behavior"><a href="https://github.com/eclipse/ditto-clients/pull/86">Ditto Java Client: Changed default initial reconnect behavior</a></h4>
+
+<p>A newly created configuration was added whether a Ditto Java Client should retry connecting to a Ditto backend
+even when the initial connection attempt failed
+(see the <code class="highlighter-rouge">initialConnectRetryEnabled(boolean)</code> option on the <code class="highlighter-rouge">WebSocketMessagingConfiguration</code> builder).</p>
+
+<div class="alert alert-danger" role="alert"><i class="fa fa-exclamation-circle"></i> <b>Warning:</b> The default behavior was changed so that a Ditto Java Client <strong>does not reconnect</strong>
+ when the initial connection to a Ditto WebSocket failed! <strong>Have a look at <a href="#migration-notes">the migration notes</a>
+ in order to restore the old behavior when updating to Ditto Java Client 1.3.0</strong>.</div>
+
+<p>Previously, up to Ditto Java Client 1.2.x, the client always retried connecting, even when the initial connection
+attempt failed.<br />
+We got feedback that this is not always desirable, e.g. when the credentials are wrong during development, the initial
+connection should fail with an exception instead, so this is the new default behavior.</p>
+
+<h3 id="new-features">New features</h3>
+
+<h4 id="automatic-creation-of-things"><a href="https://github.com/eclipse/ditto/issues/760">Automatic creation of things</a></h4>
+
+<p>Added a <a href="connectivity-mapping.html">payload mapper</a> for connectivity which implicitly creates a new digital twin (thing)
+for incoming messages: <a href="connectivity-mapping.html#implicitthingcreation-mapper">ImplicitThingCreation Mapper</a>.</p>
+
+<p>This is very useful when e.g. a device connectivity layer (like <a href="https://eclipse.org/hono/">Eclipse Hono</a>) also
+automatically creates connected devices, for example when a new device connects for the first time to an IoT gateway.</p>
+
+<p>This new feature can work together with the
+<a href="https://github.com/eclipse/hono/issues/2053">Hono feature for implicit registration of devices connected via gateways</a>.</p>
+
+<h4 id="use-response-of-http-push-connections-as-live-message-response"><a href="https://github.com/eclipse/ditto/pull/809">Use response of HTTP push connections as live message response</a></h4>
+
+<p>When <a href="connectivity-protocol-bindings-http.html">HTTP connections</a> there are now several options
+to respond to published <a href="protocol-specification-things-messages.html">live messages</a>:
+[Responding to messages](<a href="connectivity-protocol-bindings-http.html#responding-to-messages">HTTP connections</a></p>
+
+<p>For example, it is possible to use the HTTP response of the foreign HTTP endpoint (Webhook) as Ditto live message
+response.</p>
+
+<h4 id="raw-payload-mapper-to-enable-raw-pass-through-of-live-messages"><a href="https://github.com/eclipse/ditto/issues/777">Raw payload mapper to enable raw pass-through of live messages</a></h4>
+
+<p>Added a <a href="connectivity-mapping.html">payload mapper</a> for connectivity which converts consumed messages via connectivity
+in “raw mode”: <a href="connectivity-mapping.html#rawmessage-mapper">RawMessage mapper</a>.</p>
+
+<p>This mapper creates a <a href="protocol-specification-things-messages.html">Ditto Protocol live message</a> from consumed messages
+preserving the payload (e.g. JSON or text, binary, etc.) and publishing that message again to interested subscribers.</p>
+
+<p>This can be useful for connections which only need Ditto to forward a message to e.g. another connection or to a
+WebSocket.</p>
+
+<h3 id="bugfixes">Bugfixes</h3>
+
+<p>Several bugs in Ditto 1.2.x were fixed for 1.3.0.<br />
+This is a complete list of the
+<a href="https://github.com/eclipse/ditto/pulls?q=is%3Apr+milestone%3A1.3.0">merged pull requests</a>, including the fixed bugs.<br />
+Here as well for the Ditto Java Client: <a href="https://github.com/eclipse/ditto-clients/pulls?q=is%3Apr+milestone%3A1.3.0">merged pull requests</a></p>
+
+<h4 id="responses-from-http-messages-api-were-json-escaped"><a href="https://github.com/eclipse/ditto/issues/805">Responses from HTTP /messages API were JSON escaped</a></h4>
+
+<p>With Ditto 1.2.0 HTTP responses to the <code class="highlighter-rouge">POST /messages</code> APIs which transported <code class="highlighter-rouge">application/json</code> were falsely JSON
+escaped. As the fix for that had to be done in several steps and at several places, the fix is not backported to the
+Ditto 1.2.0 line and it is suggested to update to Ditto 1.3.0 right away, if affected by this bug.</p>
+
+<h4 id="putting-_metadata-while-creating-a-thing-does-not-work-bug"><a href="https://github.com/eclipse/ditto/issues/801">Putting <code class="highlighter-rouge">_metadata</code> while creating a Thing does not work bug</a></h4>
+
+<p>When putting <a href="basic-metadata.html">Metadata</a> as part of a “create thing” API call, the metadata was not applied. Only
+when updating an existing thing, the metadata was applied.</p>
+
+<h4 id="ditto-java-client-threads-leakage"><a href="https://github.com/eclipse/ditto-clients/pull/87">Ditto Java Client: threads leakage</a></h4>
+
+<p>The Ditto Java client did not close/cleanup its threadpools when closing the client.</p>
+
+<h2 id="migration-notes">Migration notes</h2>
+
+<h3 id="check-initialconnectretryenabled-option-when-upgrading-to-ditto-java-client-130">Check <code class="highlighter-rouge">initialConnectRetryEnabled</code> option when upgrading to Ditto Java Client 1.3.0</h3>
+
+<p>If you require that you Ditto Java Client reconnects even when the first connection attempt failed (this might e.g.
+be useful when you use the client in a backend application which might be restarted or scaled up/down at any given time),
+please configure the <code class="highlighter-rouge">initialConnectRetryEnabled(boolean)</code> to <code class="highlighter-rouge">true</code>:</p>
+
+<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="n">AuthenticationProvider</span> <span class="n">authenticationProvider</span> <span class="o">=</span> <span class="o">...;</span>
+
+<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.eclipseprojects.io"</span><span class="o">)</span>
+ <span class="o">.</span><span class="na">initialConnectRetryEnabled</span><span class="o">(</span><span class="kc">true</span><span class="o">)</span> <span class="c1">// set this to true in order to enable retry on initial connection errors</span>
+ <span class="o">.</span><span class="na">build</span><span class="o">(),</span> <span class="n">authenticationProvider</span><span class="o">);</span>
+
+<span class="n">DittoClient</span> <span class="n">client</span> <span class="o">=</span> <span class="n">DittoClients</span><span class="o">.</span><span class="na">newInstance</span><span class="o">(</span><span class="n">messagingProvider</span><span class="o">);</span>
+
+<span class="c1">// ...</span>
+</code></pre></div></div>
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/release_notes_140.html b/2.0/release_notes_140.html
new file mode 100644
index 0000000..ef68d0c
--- /dev/null
+++ b/2.0/release_notes_140.html
@@ -0,0 +1,1877 @@
+<!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.4.0 of Eclipse Ditto, released on 28.10.2020">
+<meta name="keywords" content="release_notes, release notes, announcements, changelog">
+<title> Release notes 1.4.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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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.4.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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li class="active"><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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.4.0</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 1.4.0 of Eclipse Ditto, released on 28.10.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>Ditto <strong>1.4.0</strong> 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 prior Eclipse Ditto 1.x versions.</p>
+
+<h2 id="changelog">Changelog</h2>
+
+<p>Compared to the latest release <a href="release_notes_130.html">1.3.0</a>, the following changes, new features and
+bugfixes were added.</p>
+
+<h3 id="changes">Changes</h3>
+
+<h4 id="status-codes-of-live-responses-are-no-longer-interpreted-for-acknowledgement-requests"><a href="https://github.com/eclipse/ditto/pull/833">Status codes of live responses are no longer interpreted for acknowledgement requests</a></h4>
+
+<p>Senders of live responses may freely choose the status code, since it no longer affects the technical settlement and redelivery of the corresponding live commands.</p>
+
+<h4 id="the-header-response-required-is-always-set-to-false-for-responses-and-events"><a href="https://github.com/eclipse/ditto/pull/850">The header response-required is always set to false for responses and events</a></h4>
+
+<p>Ditto sets the header <code class="highlighter-rouge">response-required</code> to <code class="highlighter-rouge">false</code> for signals that do not anticipate any responses,
+so that the header has a consistent meaning regardless of signal type.</p>
+
+<h4 id="ocsp-is-optional-for-connections"><a href="https://github.com/eclipse/ditto/pull/854">OCSP is optional for connections</a></h4>
+
+<p>Ditto will establish a connection even if the broker has a revoked certificate according to OCSP.
+Failed revocation checks will generate warnings in the connection log.
+This is to guard against unavailability of OCSP servers.</p>
+
+<h4 id="placeholder-topicentityid-renamed-to-topicentityname"><a href="https://github.com/eclipse/ditto/pull/859">Placeholder topic:entityId renamed to topic:entityName</a></h4>
+
+<p>The placeholder <code class="highlighter-rouge">topic:entityId</code> was not named correctly. It was resolved with the
+name of an entity and not the complete ID. Therefore, a new placeholder
+<code class="highlighter-rouge">topic:entityName</code> is introduced which reflects correctly what it means.</p>
+
+<h3 id="new-features">New features</h3>
+
+<h4 id="acknowledgement-label-declaration"><a href="https://github.com/eclipse/ditto/issues/792">Acknowledgement label declaration</a></h4>
+
+<p>Each subscriber of Ditto signals by Websocket or other connections is required to declare the labels of acknowledgements
+it may send. The labels should be unique to the subscriber. Labels of acknowledgements sent via a connection source or
+issued by a connection target must be prefixed by the connection ID followed by a colon. This is to prevent racing in
+fulfillment of acknowledgement requests and to detect misconfiguration early.</p>
+
+<p>Acknowledgement label declaration is available in <a href="https://github.com/eclipse/ditto-clients/pull/98">Ditto java client</a>.</p>
+
+<h3 id="bugfixes">Bugfixes</h3>
+
+<p>Several bugs in Ditto 1.3.0 were fixed for 1.4.0.<br />
+This is a complete list of the
+<a href="https://github.com/eclipse/ditto/pulls?q=is%3Apr+milestone%3A1.4.0">merged pull requests</a>, including the fixed bugs.<br />
+Here as well for the Ditto Java Client: <a href="https://github.com/eclipse/ditto-clients/pulls?q=is%3Apr+milestone%3A1.4.0">merged pull requests</a></p>
+
+<h4 id="thread-safe-loggers-added"><a href="https://github.com/eclipse/ditto/issues/773">Thread-safe loggers added</a></h4>
+
+<p>Concurrency issues in Ditto loggers and logging adapters are addressed by introducing thread-safe variants.</p>
+
+<h4 id="search-via-sse-enabled"><a href="https://github.com/eclipse/ditto/issues/822">Search via SSE enabled</a></h4>
+
+<p>Search via SSE was disabled due to incorrect initialization. It is enabled again.</p>
+
+<h4 id="memory-consumption-of-outgoing-amqp-connections-limited"><a href="https://github.com/eclipse/ditto/pull/853">Memory consumption of outgoing AMQP connections limited</a></h4>
+
+<p>AMQP 1.0 connections to a slow broker could accumulate indefinitely messages yet to be published.
+Now only a fixed number of messages are retained.</p>
+
+<h4 id="java-client-message-ordering-fixed"><a href="https://github.com/eclipse/ditto-clients/pull/97">Java client: Message ordering fixed</a></h4>
+
+<p>There was a bug in Ditto Java client that may cause messages to be handled in a different order
+than when they are received. It made some search results look empty when they are not.</p>
+
+<h2 id="migration-notes">Migration notes</h2>
+
+<h3 id="acknowledgement-labels-need-to-be-declared-and-unique">Acknowledgement labels need to be declared and unique</h3>
+
+<ul>
+ <li>
+ <p>Websocket connections need to declare the labels of any acknowledgments they may send.
+The acknowledgement labels should be declared as comma-separated list in the query parameter <code class="highlighter-rouge">declared-acks</code>.
+Declared acknowledgement labels should be unique to the Websocket connection. Declaring a duplicate label
+causes the Websocket connection to close after an error in Ditto protocol.</p>
+ </li>
+ <li>
+ <p>AMQP and MQTT connection sources need to declare the labels of any acknowledgement they may send as a JSON array
+in the JSON field <code class="highlighter-rouge">declaredAcks</code>. The acknowledgement labels should be prefixed by the connection ID and a colon.</p>
+ </li>
+ <li>
+ <p>Connection targets of all protocols need to prefix their issued acknowledgements by the connection ID and a colon.</p>
+ </li>
+</ul>
+
+<p>Details are in the <a href="basic-acknowledgements.html#issuing-acknowledgements">documentation</a>.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/release_notes_150.html b/2.0/release_notes_150.html
new file mode 100644
index 0000000..70ec43c
--- /dev/null
+++ b/2.0/release_notes_150.html
@@ -0,0 +1,1911 @@
+<!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.5.0 of Eclipse Ditto, released on 10.12.2020">
+<meta name="keywords" content="release_notes, release notes, announcements, changelog">
+<title> Release notes 1.5.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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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.5.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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li class="active"><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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.5.0</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 1.5.0 of Eclipse Ditto, released on 10.12.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>Ditto <strong>1.5.0</strong> 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 prior Eclipse Ditto 1.x versions.</p>
+
+<h2 id="changelog">Changelog</h2>
+
+<p>Compared to the latest release <a href="release_notes_140.html">1.4.0</a>, the following changes, new features and
+bugfixes were added.</p>
+
+<div class="alert alert-danger" role="alert"><i class="fa fa-exclamation-circle"></i> <b>Warning:</b> If you want to upgrade an existing Ditto installation to 1.5.0, the 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="changes">Changes</h3>
+
+<h4 id="negatively-settling-processed-amqp-10-messages-changed-to-rejected"><a href="https://github.com/eclipse/ditto/pull/907">Negatively settling processed AMQP 1.0 messages changed to <code class="highlighter-rouge">rejected</code></a></h4>
+
+<p>In previous versions, Ditto negatively settled messages consumed via AMQP 1.0 which could not be applied to Ditto
+(e.g. because the received message could not be understood or permissions were missing) with <code class="highlighter-rouge">modified[undeliverable-here]</code>.</p>
+
+<p>This was changed to settle with <code class="highlighter-rouge">rejected</code>
+(see <a href="http://docs.oasis-open.org/amqp/core/v1.0/os/amqp-core-messaging-v1.0-os.html#type-rejected">AMQP 1.0 spec</a>)
+instead, as this is the more correct settlement outcome.</p>
+
+<h4 id="mongodb-for-unit-tests-was-increased-to-version-42"><a href="https://github.com/eclipse/ditto/pull/896">MongoDB for unit tests was increased to version 4.2</a></h4>
+
+<p>Prior to Ditto 1.5.0, the unit tests still were done against MongoDB version 3.6 which reaches end-of-life in April 2021.</p>
+
+<h4 id="config-files-consolidation"><a href="https://github.com/eclipse/ditto/pull/888">Config files consolidation</a></h4>
+
+<p>No special <code class="highlighter-rouge">-cloud.conf</code> and <code class="highlighter-rouge">-docker.conf</code> config files are needed any longer, there are only special config files
+ending with <code class="highlighter-rouge">-dev.conf</code> which contain configuration in order to start Eclipse Ditto e.g. locally in an IDE.</p>
+
+<h3 id="new-features">New features</h3>
+
+<h4 id="header-mapping-for-feature-id-in-connectivity"><a href="https://github.com/eclipse/ditto/issues/857">Header mapping for Feature ID in connectivity</a></h4>
+
+<p>Feature IDs may now be used as placeholders in <a href="basic-placeholders.html#scope-connections">Connectivity header mappings</a>.</p>
+
+<h4 id="addition-of-desired-feature-properties-in-model-and-apis"><a href="https://github.com/eclipse/ditto/issues/697">Addition of “desired” feature properties in model and APIs</a></h4>
+
+<p>A feature which was long on the roadmap of Eclipse Ditto is the ability to distinguish between reported and <a href="basic-feature.html#feature-desired-properties">desired
+twin state</a>.</p>
+
+<p>“reported” twin state can be seen as data/state coming from the actual device (the current “truth”) whereas the
+“desired” state is something an application in the backend or a mobile app would set as the new requested target state
+for a property.</p>
+
+<p>This issue layed the foundation by creating the model and the APIs in order to manage those <code class="highlighter-rouge">desiredProperties</code>.</p>
+
+<h4 id="issuing-weak-acknowledgements-when-a-command-requesting-acks-was-filtered-out"><a href="https://github.com/eclipse/ditto/issues/852">Issuing “weak acknowledgements” when a command requesting acks was filtered out</a></h4>
+
+<p>When using <a href="basic-acknowledgements.html">acknowledgements</a> in order to guarantee “at least once” (QoS 1) delivery and
+scenarios like:</p>
+<ul>
+ <li>a subscriber that declared an ack label requested by the publisher is not authorized to receive a published signal</li>
+ <li>or: a subscriber that declared an ack label requested by the publisher discards the published signal due to namespace or RQL filtering</li>
+</ul>
+
+<p>resending the signal will not help.
+Ditto now emits a “weak acknowledgement” for such cases that does not trigger redelivery.</p>
+
+<h4 id="ditto-internal-pubsub-supports-using-a-grouping-concept"><a href="https://github.com/eclipse/ditto/issues/878">Ditto internal pub/sub supports using a “grouping” concept</a></h4>
+
+<p>A “group” concept was added to Ditto pub/sub:</p>
+<ul>
+ <li>Subscribers may subscribe with a group name.</li>
+ <li>Published signals are delivered to exactly 1 subscriber within each group chosen consistently according to the entity ID.</li>
+</ul>
+
+<p>With this feature, the event publishing at connections will scale with the number of client actors by having the client
+actors subscribe for events directly using the connection ID as group.</p>
+
+<h4 id="addition-of-cloudevents-http-endpoint"><a href="https://github.com/eclipse/ditto/issues/889">Addition of “cloudevents” HTTP endpoint</a></h4>
+
+<p>While <a href="https://cloudevents.io">cloud events</a> provide bindings for Kafka, MQTT, … they also have an HTTP endpoint
+binding, which can easily be used in the combination with Knative.</p>
+
+<p>With addition of a new HTTP endpoint <code class="highlighter-rouge">/cloudevents</code>, it is now possible to easily map incoming messages from any
+Knative eventing source to Eclipse Ditto, acting as a Knative eventing sink.</p>
+
+<p>A special thanks to <a href="https://github.com/ctron">Jens Reimann (ctron)</a> from <a href="https://github.com/RedHatOfficial">RedHat</a>
+for this addition to Eclipse Ditto.</p>
+
+<h3 id="bugfixes">Bugfixes</h3>
+
+<p>Several bugs in Ditto 1.4.0 were fixed for 1.5.0.<br />
+This is a complete list of the
+<a href="https://github.com/eclipse/ditto/pulls?q=is%3Apr+milestone%3A1.5.0">merged pull requests</a>, including the fixed bugs.<br />
+Here as well for the Ditto Java Client: <a href="https://github.com/eclipse/ditto-clients/pulls?q=is%3Apr+milestone%3A1.5.0">merged pull requests</a></p>
+
+<h4 id="fix-that-sending-messages-with-non-existing-value-was-not-possible-via-http-endpoints"><a href="https://github.com/eclipse/ditto/pull/875">Fix that sending messages with non-existing “value” was not possible via HTTP endpoints</a></h4>
+
+<p>The HTTP <code class="highlighter-rouge">/messages</code> endpoints did not allow that a Ditto Protocol messages with non-existing <code class="highlighter-rouge">"value"</code> were created for
+HTTP invocations which did not include payload at all.</p>
+
+<p>That was fixed in the way that for requests with <code class="highlighter-rouge">Content-Length: 0</code> the <code class="highlighter-rouge">"value"</code> is now removed from the resulting
+Ditto Protocol message instead of being <code class="highlighter-rouge">"value": ""</code> (empty JSON string).</p>
+
+<h4 id="ditto-java-client-when-starting-consumption-with-invalid-filter-wrongly-timeout-exception-is-propagate-to-the-user"><a href="https://github.com/eclipse/ditto-clients/pull/105">Ditto Java client: When starting consumption with invalid filter, wrongly timeout exception is propagate to the user</a></h4>
+
+<p><code class="highlighter-rouge">dittoClient.twin().startConsumption(org.eclipse.ditto.client.options.Options.Consumption.filter("invalidFilter"))</code>
+throwed a wrong exception and did not propagate the real error to the user.</p>
+
+<p>Affected <a href="https://github.com/eclipse/ditto/pull/902">Ditto PR</a>.</p>
+
+<h4 id="ditto-java-client-fix-featurechange-consumption-for-specific-feature-change-registration"><a href="https://github.com/eclipse/ditto-clients/pull/101">Ditto Java client: Fix FeatureChange consumption for specific feature change-registration</a></h4>
+
+<p>This fixes a bug that caused ignoring features in a FeatureChange for change-registrations on single features,
+when only a single subpath exists in the feature (i.e. feature with only properties).</p>
+
+<h2 id="migration-notes">Migration notes</h2>
+
+<h3 id="mongodb-hostname-configuration">MongoDB hostname configuration</h3>
+
+<p>Due to the <a href="https://github.com/eclipse/ditto/pull/888">consolidation of config files</a>, it is now <strong>required to configure
+the MongoDB <code class="highlighter-rouge">hostname</code> explicitly</strong> as the default hostname was changed to <code class="highlighter-rouge">localhost</code>.<br />
+Previously, this hostname was automatically set to <code class="highlighter-rouge">mongodb</code> (which is the hostname of the MongoDB when e.g. the
+<code class="highlighter-rouge">docker-compose.yaml</code> deployment is used) in Docker based environments.</p>
+
+<p>This now has to be manually done via the environment variable <code class="highlighter-rouge">MONGO_DB_HOSTNAME</code>.</p>
+
+<p>The default <code class="highlighter-rouge">docker-compose.yaml</code> was also adjusted accordingly:
+<a href="https://github.com/eclipse/ditto/blob/master/deployment/docker/docker-compose.yml">docker-compose.yml</a></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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/release_notes_151.html b/2.0/release_notes_151.html
new file mode 100644
index 0000000..f46ac72
--- /dev/null
+++ b/2.0/release_notes_151.html
@@ -0,0 +1,1799 @@
+<!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.5.1 of Eclipse Ditto, released on 22.12.2020">
+<meta name="keywords" content="release_notes, release notes, announcements, changelog">
+<title> Release notes 1.5.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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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.5.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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li class="active"><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</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.5.1</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 1.5.1 of Eclipse Ditto, released on 22.12.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_150.html">1.5.0</a> were added.</p>
+
+<h2 id="changelog">Changelog</h2>
+
+<p>Compared to the latest release <a href="release_notes_150.html">1.5.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.5.1">merged pull requests</a>, including the fixed bugs.</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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/release_notes_200.html b/2.0/release_notes_200.html
new file mode 100644
index 0000000..df906b5
--- /dev/null
+++ b/2.0/release_notes_200.html
@@ -0,0 +1,2464 @@
+<!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 2.0.0 of Eclipse Ditto, released on 06.05.2021">
+<meta name="keywords" content="release_notes, release notes, announcements, changelog">
+<title> Release notes 2.0.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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 2.0.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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Release notes 2.0.0</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 2.0.0 of Eclipse Ditto, released on 06.05.2021</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 Ditto’s second major release.</p>
+
+<p>This release is completely <a href="https://www.eclipse.org/projects/handbook/#ip">IP (intellectual property) checked by the Eclipse Foundation</a>
+meaning that project code as well as all used dependencies were “[…] reviewed to ensure that the copyrights
+expressed are correct, licensing is valid and compatible, and that other issues have been uncovered and properly
+investigated.”</p>
+
+<h2 id="changelog">Changelog</h2>
+
+<p>Eclipse Ditto 2.0.0 focuses on the following areas:</p>
+
+<ul>
+ <li>Merge/PATCH updates of digital twins</li>
+ <li>Configurable OpenID Connect / OAuth2.0 claim extraction to be used for authorization</li>
+ <li>Establishing connections to endpoints (via AMQP, MQTT, HTTP) utilizing a Ditto managed SSH tunnel</li>
+ <li>Addition of a DevOps API in order to retrieve all known connections</li>
+ <li>Expiring policy subjects + publishing of announcement message prior to expiry</li>
+ <li>Addition of policy actions in order to inject a policy subject based on a provided JWT</li>
+ <li>Built-in acknowledgement for search updates to have the option of twin updates with strong consistency of the search index</li>
+ <li>Restoring active connections faster after a hard restart of the Ditto cluster via automatic prioritization of connections</li>
+ <li>Support for LastWill/Testament + retain flag for MQTT connections</li>
+ <li>Provide JWT tokens to Websocket endpoint with browser APIs</li>
+</ul>
+
+<p>The step to a major version was done because of the following breaking API changes:</p>
+
+<ul>
+ <li>Removal of “API version 1” (deprecated in <a href="release_notes_110.html#deprecations">Ditto 1.1.0</a>)
+from Ditto’s Java APIs + HTTP API</li>
+ <li>Removal of code in Java APIs marked as <code class="highlighter-rouge">@Deprecated</code></li>
+ <li>Binary incompatible changes to Java APIs</li>
+ <li>Restructuring of Ditto’s Maven modules in order to simplify/ease further development</li>
+</ul>
+
+<p>The following non-functional enhancements are also included:</p>
+
+<ul>
+ <li>Improvement of stability during rolling updates</li>
+ <li>Addition of sharding concept for Ditto internal pub/sub enabling connection of e.g. tens of thousands websocket sessions</li>
+ <li>Background cleanup improvements in order to have less impact on DB roundtrip times</li>
+ <li>Update of third party libraries (e.g. Akka)</li>
+ <li>Documentation of deployment via K3S</li>
+</ul>
+
+<h3 id="changes">Changes</h3>
+
+<h4 id="removal-of-api-version-1-acl-based-authorization">Removal of API version 1 (ACL based authorization)</h4>
+
+<p>The <a href="basic-policy.html">Policy based</a> authorization is already available and stable since Ditto 1.0.0. This policy based
+authorization is more flexible and more powerful than the <a href="release_notes_110.html#deprecations">deprecated</a> ACL based
+authorization.<br />
+Having this well established replacement, the ACL based authorization and with that API version 1
+(in which a <a href="basic-thing.html">thing</a> contained an <code class="highlighter-rouge">acl</code> entry), is removed from Ditto 2.0.0.</p>
+
+<p>All documentation of the ACL based approach was deleted, but is still available by accessing version picker in Ditto’s
+documentation, selecting a 1.x Ditto version.</p>
+
+<p>The HTTP API <code class="highlighter-rouge">/api/1</code> and <code class="highlighter-rouge">/ws/1</code> (for the WebSocket) was also removed, using these endpoints will fail with Ditto 2.0.0.</p>
+
+<p><a href="basic-thing.html">Things</a> which still contain an <code class="highlighter-rouge">acl</code> entry (instead of a <code class="highlighter-rouge">policyId</code>) can no longer be used in
+Ditto 2.0.0. If you need to migrate “things” from API 1 to API version 2, please have a look at the<br />
+<a href="#migrate-api-1-things-to-api-2">migration notes</a>.</p>
+
+<h4 id="removal-of-deprecated-code--binary-incompatible-changes-to-java-apis">Removal of deprecated code + binary incompatible changes to Java APIs</h4>
+
+<p>In order to not break binary compatibility in Ditto 1.x, existing APIs were marked as <code class="highlighter-rouge">@Deprecated</code> with a comment
+pointing to an alternative implementation to use instead. Now, these deprecated APIs are removed from Ditto’s codebase.</p>
+
+<p>Some changes to the codebase which could not be done in Ditto 1.x without breaking binary compatibility were also done.</p>
+
+<h4 id="removed-content-type-header-mapping-for-connection-targets"><a href="https://github.com/eclipse/ditto/pull/934">Removed content-type header mapping for connection targets</a></h4>
+
+<p>Removed the default header mapping of <code class="highlighter-rouge">content-type</code> for new connection targets. The header mapping led to irritating
+results, when payload mapping and header mapping disagreed on the actual <code class="highlighter-rouge">content-type</code>. Existing connections will still
+keep the “old” default and map the <code class="highlighter-rouge">content-type</code> header.</p>
+
+<p>If you need to keep the old behavior, please have a look at the
+<a href="#content-type-header-mapping-in-connection-targets">migration notes</a>.</p>
+
+<h4 id="openid-connect-configuration-change">OpenID Connect configuration change</h4>
+
+<p>For supporting <a href="https://github.com/eclipse/ditto/issues/512">Configurable OpenID Connect / OAuth2.0 claim extraction</a>,
+the configuration format was changed, please have a look at the<br />
+<a href="#openid-connect-configuration-for-gateway">migration notes</a>.</p>
+
+<h4 id="removal-of-header-x-ditto-dummy-auth">Removal of header <code class="highlighter-rouge">x-ditto-dummy-auth</code></h4>
+
+<p>The HTTP header / query param <code class="highlighter-rouge">x-ditto-dummy-auth</code> which was already an alias for the
+<a href="installation-operating.html#pre-authentication">pre-authentication provider</a> header <code class="highlighter-rouge">x-ditto-pre-authenticated</code> has
+been removed from Ditto 2.0.<br />
+Please use the header <code class="highlighter-rouge">x-ditto-pre-authenticated</code> instead.</p>
+
+<h4 id="removed-default-source-header-mapping-for-mqtt-connections">Removed default source header mapping for MQTT connections</h4>
+
+<p>The default source header mapping of MQTT connections was removed. The headers <code class="highlighter-rouge">mqtt.topic</code>, <code class="highlighter-rouge">mqtt.qos</code>
+and <code class="highlighter-rouge">mqtt.retain</code> now must explicitly be added to the source header mapping if they are required for further processing.</p>
+
+<h4 id="restructuring-of-dittos-maven-modules">Restructuring of Ditto’s Maven modules</h4>
+
+<p>Ditto’s modules were adjusted to be structured in a more functional way. In Ditto 1.x the modules were structured
+in a more technical way.</p>
+
+<p>This table shows the old modules and in which module the old ones can be found in Ditto 2.0.0:</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Ditto 1.x module</th>
+ <th>Ditto 2.x module</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><code class="highlighter-rouge">ditto-model</code></td>
+ <td><code class="highlighter-rouge">-</code> (was pom only)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-base</code></td>
+ <td><code class="highlighter-rouge">ditto-base/ditto-base-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-cleanup</code></td>
+ <td><code class="highlighter-rouge">-</code> (was internal API)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-connectivity</code></td>
+ <td><code class="highlighter-rouge">ditto-connectivity/ditto-connectivity-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-devops</code></td>
+ <td><code class="highlighter-rouge">ditto-devops/ditto-devops-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-enforcers</code></td>
+ <td><code class="highlighter-rouge">ditto-policies/ditto-policies-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-jwt</code></td>
+ <td><code class="highlighter-rouge">ditto-jwt/ditto-jwt-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-messages</code></td>
+ <td><code class="highlighter-rouge">ditto-messages/ditto-messages-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-namespaces</code></td>
+ <td><code class="highlighter-rouge">ditto-base/ditto-base-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-policies</code></td>
+ <td><code class="highlighter-rouge">ditto-policies/ditto-policies-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-query</code></td>
+ <td><code class="highlighter-rouge">ditto-rql/ditto-rql-query</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-rql</code></td>
+ <td><code class="highlighter-rouge">ditto-rql/ditto-rql-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-rql-parser</code></td>
+ <td><code class="highlighter-rouge">ditto-rql/ditto-rql-parser</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-things</code></td>
+ <td><code class="highlighter-rouge">ditto-things/ditto-things-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-thingsearch</code></td>
+ <td><code class="highlighter-rouge">ditto-thingsearch/ditto-thingsearch-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-thingsearch-parser</code></td>
+ <td><code class="highlighter-rouge">ditto-rql/ditto-rql-parser</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">ditto-protocol-adapter</code></td>
+ <td><code class="highlighter-rouge">ditto-protocol</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">ditto-signals</code></td>
+ <td><code class="highlighter-rouge">-</code> (was pom only)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-signals-base</code></td>
+ <td><code class="highlighter-rouge">ditto-base/ditto-base-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-signals-acks</code></td>
+ <td><code class="highlighter-rouge">-</code> (was pom only)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-acks-base</code></td>
+ <td><code class="highlighter-rouge">ditto-base/ditto-base-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-acks-things</code></td>
+ <td><code class="highlighter-rouge">ditto-things/ditto-things-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-signals-announcements</code></td>
+ <td><code class="highlighter-rouge">-</code> (was pom only)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-announcements-base</code></td>
+ <td><code class="highlighter-rouge">ditto-base/ditto-base-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-announcements-policies</code></td>
+ <td><code class="highlighter-rouge">ditto-policies/ditto-policies-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-signals-commands</code></td>
+ <td><code class="highlighter-rouge">-</code> (was pom only)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-commands-base</code></td>
+ <td><code class="highlighter-rouge">ditto-base/ditto-base-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-commands-cleanup</code></td>
+ <td><code class="highlighter-rouge">-</code> (was internal API)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-commands-common</code></td>
+ <td><code class="highlighter-rouge">-</code> (was internal API)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-commands-connectivity</code></td>
+ <td><code class="highlighter-rouge">ditto-connectivity/ditto-connectivity-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-commands-devops</code></td>
+ <td><code class="highlighter-rouge">-</code> (was internal API and is merged into ditto-base/ditto-base-api)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-commands-messages</code></td>
+ <td><code class="highlighter-rouge">ditto-messages/ditto-messages-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-commands-namespaces</code></td>
+ <td><code class="highlighter-rouge">ditto-base/ditto-base-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-commands-policies</code></td>
+ <td><code class="highlighter-rouge">ditto-policies/ditto-policies-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-commands-things</code></td>
+ <td><code class="highlighter-rouge">ditto-things/ditto-things-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-commands-thingsearch</code></td>
+ <td><code class="highlighter-rouge">ditto-thingsearch/ditto-thingsearch-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-signals-events</code></td>
+ <td><code class="highlighter-rouge">-</code> (was pom only)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-events-base</code></td>
+ <td><code class="highlighter-rouge">ditto-base/ditto-base-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-events-connectivity</code></td>
+ <td><code class="highlighter-rouge">ditto-connectivity/ditto-connectivity-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-events-policies</code></td>
+ <td><code class="highlighter-rouge">ditto-policies/ditto-policies-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-events-things</code></td>
+ <td><code class="highlighter-rouge">ditto-things/ditto-things-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-events-thingsearch</code></td>
+ <td><code class="highlighter-rouge">ditto-thingsearch/ditto-thingsearch-model</code></td>
+ </tr>
+ </tbody>
+</table>
+
+<h4 id="restructuring-of-dittos-java-packages">Restructuring of Ditto’s Java packages</h4>
+
+<p>When updating from Ditto 1.x Java APIs (e.g. also when using the <a href="#ditto-java-client">Ditto Java client</a>), the following
+packages were renamed:</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Ditto 1.x package</th>
+ <th>Ditto 2.x package</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.base</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.base.model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.cleanup</code></td>
+ <td><code class="highlighter-rouge">-</code> (was internal API)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.connectivity</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.connectivity.model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.devops</code></td>
+ <td><code class="highlighter-rouge">-</code> (was internal API and is merged into ditto-base/ditto-base-api)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.enforcers</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.policies.model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.jwt</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.jwt.model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.messages</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.messages.model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.namespaces</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.base.model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.policies</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.policies.model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.query</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.rql.query</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.rql</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.rql.model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.rqlparser</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.rql.parser</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.things</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.things.model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.thingsearch</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.thingsearch.model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.thingsearchparser</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.rql.parser.thingsearch</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.protocoladapter</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.protocol</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.base</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.base.model.signals</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.acks.base</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.base.model.signals.acks</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.acks.things</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.things.model.signals.acks</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.announcements.base</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.base.model.signals.announcements</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.announcements.policies</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.policies.model.signals.announcements</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.commands.base</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.base.model.signals.commands</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.commands.cleanup</code></td>
+ <td><code class="highlighter-rouge">-</code> (was internal API)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.commands.common</code></td>
+ <td><code class="highlighter-rouge">-</code> (was internal API)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.commands.connectivity</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.connectivity.model.signals.commands</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.commands.devops</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.devops.model.signals.commands</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.commands.messages</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.messages.model.signals.commands</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.commands.namespaces</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.base.model.signals.commands</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.commands.policies</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.policies.model.signals.commands</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.commands.things</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.things.model.signals.commands</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.commands.thingsearch</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.thingsearch.model.signals.commands</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.events.base</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.base.model.signals.events</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.events.connectivity</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.connectivity.model.signals.events</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.events.policies</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.policies.model.signals.events</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.events.things</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.things.model.signals.events</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.events.thingsearch</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.thingsearch.model.signals.events</code></td>
+ </tr>
+ </tbody>
+</table>
+
+<h4 id="ditto-java-client">Ditto Java client</h4>
+
+<p>New Java client instances are instantiated differently, please have a look at the<br />
+<a href="#ditto-java-client-instantiation">migration notes</a>.</p>
+
+<p>In addition, all APIs which returned a <code class="highlighter-rouge">CompletableFuture</code> were adjusted to return a <code class="highlighter-rouge">CompletionStage</code> instead,
+please have a look at the<br />
+<a href="#ditto-java-client-completionstage-apis">migration notes</a>.</p>
+
+<h4 id="ditto-javascript-client">Ditto JavaScript client</h4>
+
+<p>Starting with Ditto 2.0.0, the releases of the <a href="https://github.com/eclipse/ditto-clients/tree/master/javascript">Ditto JavaScript client</a>
+are in sync with Ditto releases.<br />
+In oder to have a simplified usage of the JS client, the “api” module must no longer be explicitly imported,
+simply directly import one of the following 2 npm modules:</p>
+<ul>
+ <li><a href="https://www.npmjs.com/package/@eclipse-ditto/ditto-javascript-client-node">ditto-javascript-client-node</a></li>
+ <li><a href="https://www.npmjs.com/package/@eclipse-ditto/ditto-javascript-client-dom">ditto-javascript-client-dom</a></li>
+</ul>
+
+<h3 id="new-features">New features</h3>
+
+<h4 id="mergepatch-updates-of-digital-twins"><a href="https://github.com/eclipse/ditto/issues/288">Merge/PATCH updates of digital twins</a></h4>
+
+<p>This new feature allows updating parts of a thing without affecting existing parts. You may now for example update an
+attribute, add a new property to a feature and delete a property of a different feature in a <em>single request</em>. The new
+merge functionality is available via the HTTP API and the all channels using the Ditto Protocol. See
+<a href="httpapi-concepts.html#merge-updates">Merge updates via HTTP</a>
+or the <a href="protocol-specification-things-merge.html">Merge protocol specification</a> for more details and examples.</p>
+
+<h4 id="configurable-openid-connect--oauth20-claim-extraction"><a href="https://github.com/eclipse/ditto/issues/512">Configurable OpenID Connect / OAuth2.0 claim extraction</a></h4>
+
+<p>OpenID Connect support has been extended; Previously, only the <code class="highlighter-rouge">sub</code> field from a JWT was injected as an authorization subject.
+This is now configurable: The Ditto Gateway config takes a list of placeholder strings that are used to construct authorization subjects.<br />
+See <a href="installation-operating.html#openid-connect">OpenID Connect</a></p>
+
+<h4 id="establishing-connections-to-endpoints-via-ssh-tunnel"><a href="https://github.com/eclipse/ditto/issues/985">Establishing connections to endpoints via SSH tunnel</a></h4>
+
+<p>Add support for connecting to an external system from Ditto via an SSH tunnel.</p>
+
+<h4 id="devops-api-to-retrieve-all-known-connections"><a href="https://github.com/eclipse/ditto/issues/605">DevOps API to retrieve all known connections</a></h4>
+
+<p>Adds a new <a href="connectivity-manage-connections.html#retrieve-ids-of-all-connections">DevOps command</a> to list all
+configured, non-deleted connections.</p>
+
+<h4 id="expiring-policy-subjects"><a href="https://github.com/eclipse/ditto/issues/890">Expiring policy subjects</a></h4>
+
+<p>In order to give access for a certain “authorized subject” only until a fixed timestamp, a Policy subject can
+optionally be provided with an <a href="basic-policy.html#expiring-policy-subjects">“expiry” timestamp</a>
+(being an ISO-8601 string).</p>
+
+<h4 id="publishing-of-announcement-message-prior-to-policy-expiry"><a href="https://github.com/eclipse/ditto/issues/964">Publishing of announcement message prior to policy expiry</a></h4>
+
+<p>For “expiring” policy subjects it is useful to get an <a href="basic-signals-announcement.html">announcement</a> message prior
+to the actual expiry in order to be able to prolong the temporary access rights.</p>
+
+<h4 id="addition-of-policy-actions-in-order-to-inject-a-policy-subject"><a href="https://github.com/eclipse/ditto/issues/926">Addition of policy actions in order to inject a policy subject</a></h4>
+
+<p>New <a href="basic-policy.html#action-activatetokenintegration">policy HTTP API</a> to inject authorization subjects based on
+the <a href="#" data-toggle="tooltip" data-original-title="JSON Web Token (JWT)">JWT</a> of the HTTP request.</p>
+
+<h4 id="built-in-acknowledgement-for-search-updates--strong-consistency-of-the-search-index"><a href="https://github.com/eclipse/ditto/issues/914">Built-in acknowledgement for search updates / strong consistency of the search index</a></h4>
+
+<p>Ditto’s search index is only eventually consistent. Applications that rely on search to for twin interactions which
+need to know when a change is reflected in the search index, may request the new built-in
+<a href="basic-acknowledgements.html#built-in-acknowledgement-labels"><code class="highlighter-rouge">"search-persisted"</code></a> acknowledgement label.</p>
+
+<h4 id="restoring-active-connection-faster-after-a-hard-restart-of-the-ditto-cluster"><a href="https://github.com/eclipse/ditto/pull/1018">Restoring active connection faster after a hard restart of the Ditto cluster</a></h4>
+
+<p>Prioritize very active <a href="basic-connections.html">connections</a> over inactive connections for reconnecting:<br />
+The higher the priority, the earlier it will be reconnected on startup.</p>
+
+<h4 id="support-for-last-will-for-mqtt-connections"><a href="https://github.com/eclipse/ditto/issues/1021">Support for “Last Will” for MQTT connections</a></h4>
+
+<p>Adds “Last Will” support for managed MQTT connections</p>
+
+<h4 id="allow-setting-retain-flag-for-mqtt-connections"><a href="https://github.com/eclipse/ditto/issues/1029">Allow setting retain flag for MQTT connections</a></h4>
+
+<p>The <code class="highlighter-rouge">retain</code> flag of MQTT messages published via a managed connection is set according to a message header.</p>
+
+<h4 id="provide-jwt-tokens-to-websocket-endpoint-with-browser-apis"><a href="https://github.com/eclipse/ditto/issues/667">Provide JWT tokens to Websocket endpoint with browser APIs</a></h4>
+
+<p>Prior to Ditto 2.0 it was only possible to pass a JWT to the <code class="highlighter-rouge">/ws</code> endpoint with the <code class="highlighter-rouge">Authorization</code> header.<br />
+As this however is not possible to influence in the browser based JavaScript API of <code class="highlighter-rouge">WebSocket</code>, it was not possible
+to authenticate easily running a web application connecting against Ditto.</p>
+
+<p>This is now possible by supplying the JWT via a <a href="basic-auth.html#single-sign-on-sso">query-parameter <code class="highlighter-rouge">access_token</code></a>.</p>
+
+<h3 id="bugfixes">Bugfixes</h3>
+
+<p>Several bugs in Ditto 1.5.x were fixed for 2.0.0.<br />
+This is a complete list of the</p>
+<ul>
+ <li><a href="https://github.com/eclipse/ditto/pulls?q=is:pr+milestone:2.0.0-M1">merged pull requests for milestone 2.0.0-M1</a></li>
+ <li><a href="https://github.com/eclipse/ditto/pulls?q=is:pr+milestone:2.0.0-M2">merged pull requests for milestone 2.0.0-M2</a></li>
+ <li><a href="https://github.com/eclipse/ditto/pulls?q=is:pr+milestone:2.0.0">merged pull requests for milestone 2.0.0</a></li>
+</ul>
+
+<p>Here as well for the Ditto Java Client: <a href="https://github.com/eclipse/ditto-clients/pulls?q=is:pr+milestone:2.0.0">merged pull requests for milestone 2.0.0</a></p>
+
+<h4 id="content-type-of-a-ditto-protocol-json-message-did-not-describe-its-value"><a href="https://github.com/eclipse/ditto/pull/987">“content-type” of a Ditto Protocol JSON message did not describe its “value”</a></h4>
+
+<p>The <code class="highlighter-rouge">"content-type"</code> field in <a href="protocol-specification.html#headers">Ditto Protocol headers</a> was intended to identify the
+type of the <a href="protocol-specification.html#value"><code class="highlighter-rouge">"value"</code></a>. This was not consequently ensured which has now been fixed.</p>
+
+<h4 id="password-encodingdecoding-for-amqp-10-connections-with-special-characters"><a href="https://github.com/eclipse/ditto/pull/996">Password encoding/decoding for AMQP 1.0 connections with special characters</a></h4>
+
+<p>When passwords contained a <code class="highlighter-rouge">+</code> sign, they were wrongly decoded for
+<a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 connections</a>.</p>
+
+<h4 id="merging-extrafields-into-thing-payload-when-using-normalization-mapper"><a href="https://github.com/eclipse/ditto/issues/947">Merging “extraFields” into thing payload when using “normalization” mapper</a></h4>
+
+<p>When selecting <a href="basic-connections.html#target-topics-and-enrichment">extra</a> via “enrichment”, the actual value of an
+event could be overwritten by the “extra” data. The event data now always has priority.</p>
+
+<h2 id="migration-notes">Migration notes</h2>
+
+<h3 id="migrate-api-1-things-to-api-2">Migrate API 1 things to API 2</h3>
+
+<p>In order to migrate existing <a href="basic-thing.html">things</a> from API version 1 to API version 2
+(from having a <code class="highlighter-rouge">acl</code> to having a <code class="highlighter-rouge">policyId</code>) simply perform the following steps <strong>prior to updating to Ditto 2.0.0</strong>:</p>
+<ul>
+ <li>Retrieve the to-be-migrated thing <strong>via API 1</strong> <code class="highlighter-rouge">GET /api/1/things/<the-namespace>:<the-name></code></li>
+ <li>Save the content of the <code class="highlighter-rouge">"acl"</code> field in the returned Thing JSON</li>
+ <li>Create a new <a href="basic-policy.html">policy</a> based on the retrieved ACL content
+ <ul>
+ <li>tip: when creating the policy, use the same ID as for the thing</li>
+ <li>for the policy <a href="basic-policy.html#subjects">subject</a>, use the map “keys” of the ACL JSON object, prepending the
+required <code class="highlighter-rouge"><subject-issuer></code> prefix</li>
+ <li>choose the permissions in the <a href="basic-policy.html#which-resources-can-be-controlled">resources</a> according to your
+needs</li>
+ </ul>
+ </li>
+ <li>Update the thing <strong>via API 2</strong> <code class="highlighter-rouge">PUT /api/2/things/<the-namespace>:<the-name></code> and set the <code class="highlighter-rouge">"policyId"</code> to the just
+created policy id</li>
+ <li>You can now only access the thing via API 2</li>
+ <li>After all API 1 things were migrated, you can safely update to Ditto 2.0.0</li>
+</ul>
+
+<h3 id="content-type-header-mapping-in-connection-targets">“content-type” header mapping in connection targets</h3>
+
+<p>Due to the
+<a href="https://github.com/eclipse/ditto/pull/934">removed default content-type header mapping for connection targets</a>,
+it might be necessary to update the way connection targets are created in case you create connection targets without
+explicit <code class="highlighter-rouge">headerMapping</code> and rely on a specific content-type on the receiving side. The request to create connection
+targets can be updated to contain the “old” default 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">"targetActorSelection"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/system/sharding/connection"</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="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">"connectivity.commands:createConnection"</span><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">"targets"</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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{header:correlation-id}}"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"reply-to"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{header:reply-to}}"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="err">//</span><span class="w"> </span><span class="err">...</span><span class="w">
+ </span><span class="p">}]</span><span class="w">
+ </span><span class="err">//</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><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h3 id="openid-connect-configuration-for-gateway">OpenID Connect configuration for gateway</h3>
+
+<p>The oauth configuration section of the Gateway service has been altered to support
+<a href="https://github.com/eclipse/ditto/issues/512">arbitrary claims for authorization subjects</a>.
+The <code class="highlighter-rouge">openid-connect-issuers</code> map now takes key-object pairs rather than key-string pairs:</p>
+
+<p>old:</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>oauth = {
+ openid-connect-issuers = {
+ someissuer = "https://example.com"
+ }
+}
+</code></pre></div></div>
+
+<p>new:</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>oauth = {
+ openid-connect-issuers = {
+ someissuer = {
+ issuer = "https://example.com"
+ }
+ }
+}
+</code></pre></div></div>
+
+<p>The <code class="highlighter-rouge">auth-subjects</code> field is optional. When not supplied, the ‘old’ behaviour (using the JWT <code class="highlighter-rouge">sub</code> field) remains.</p>
+
+<h3 id="header-mapping-for-mqtt-connections">Header mapping for MQTT connections</h3>
+
+<p>Prior to this release, <a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1</a> and
+<a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5</a> always contained 3 headers for consumed messages via
+<a href="basic-connections.html#sources">connection sources</a> (subscribed MQTT topics):</p>
+<ul>
+ <li><code class="highlighter-rouge">mqtt.topic</code></li>
+ <li><code class="highlighter-rouge">mqtt.qos</code></li>
+ <li><code class="highlighter-rouge">mqtt.retain</code></li>
+</ul>
+
+<p>Those headers could be e.g. used in the
+<a href="connectivity-mapping.html#javascript-mapping-engine">JavaScript payload mapping engine</a> in order to find out on
+which topic a consumed MQTT message was received.</p>
+
+<p>These headers are not longer implicitly mapped, but instead have to be mapped via
+<a href="connectivity-header-mapping.html">header mapping</a> manually.</p>
+
+<p>An example <a href="connectivity-protocol-bindings-mqtt.html#source-header-mapping">source header mapping</a> is provided
+in the documentation.</p>
+
+<h3 id="ditto-java-client-instantiation">Ditto Java Client instantiation</h3>
+
+<p>The synchronous instantiation of the Ditto Java Client has been removed from its Factory class <code class="highlighter-rouge">DittoClients</code>.
+To get a <code class="highlighter-rouge">DittoClient</code> instantiate a <code class="highlighter-rouge">DisconnectedDittoClient</code> via <code class="highlighter-rouge">DittoClients.newInstance(messagingProvider)</code> first
+and call <code class="highlighter-rouge">connect()</code> on it.<br />
+This call returns a <code class="highlighter-rouge">CompletionStage</code> which finally resolves to a connected <code class="highlighter-rouge">DittoClient</code>.</p>
+
+<h2 id="roadmap">Roadmap</h2>
+
+<p>Looking forward, the current plans for Ditto 2.1.0 are:</p>
+
+<ul>
+ <li><a href="https://github.com/eclipse/ditto/issues/586">Support for consuming messages from Apache Kafka</a></li>
+ <li><a href="https://github.com/eclipse/ditto/issues/298">Let policies import other policies to enable re-use when securing things</a></li>
+</ul>
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/robots.txt b/2.0/robots.txt
new file mode 100644
index 0000000..d4e9656
--- /dev/null
+++ b/2.0/robots.txt
@@ -0,0 +1 @@
+Sitemap: https://www.eclipse.org/ditto/sitemap.xml
diff --git a/2.0/sandbox.html b/2.0/sandbox.html
new file mode 100644
index 0000000..28dd7f7
--- /dev/null
+++ b/2.0/sandbox.html
@@ -0,0 +1,1848 @@
+<!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=" sandbox, demo, trial">
+<title> Sandbox • 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="Eclipse 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 class="active"><a href="sandbox.html">Sandbox</a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Sandbox">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+
+ <li><a href="protocol-examples-search.html">→ Search examples</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="active"><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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Sandbox</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>The Ditto team provides a <a href="https://ditto.eclipseprojects.io">sandbox</a> which may be used by everyone wanting to
+try out Ditto without starting it locally.</p>
+
+<div class="alert alert-danger" role="alert"><i class="fa fa-exclamation-circle"></i> <b>Warning:</b> The Ditto sandbox is not set up in a highly available manner and may experience
+ downtimes. Also, the sandbox will be reset from time to time without prior notice.</div>
+
+<p>In addition, the following vendors offer free trial accounts for their Eclipse Ditto compatible products:</p>
+
+<ul>
+ <li><a href="https://developer.bosch-iot-suite.com/service/things/">Bosch IoT Things</a> by <a href="https://bosch.io">Bosch.IO</a></li>
+</ul>
+
+<h2 id="instructions">Instructions</h2>
+
+<p>As Ditto makes use of OAuth2.0 in order to authenticate users the sandbox contains a “sign in with Google”
+functionality. Ditto accepts the <code class="highlighter-rouge">id_token</code> which is issued by Google as <code class="highlighter-rouge">Bearer</code> token on authentication.</p>
+
+<h3 id="http-api-documentation">HTTP API documentation</h3>
+
+<p>The online <a href="https://ditto.eclipseprojects.io/apidoc/">HTTP API documentation</a> of the sandbox implements the OAuth2.0
+“authorization code” flow.<br />
+Simply click the green <code class="highlighter-rouge">Authorize</code> button, check the checkbox <code class="highlighter-rouge">openid</code> and click the <code class="highlighter-rouge">Authorize</code> button.
+Your browser will ask you if the Ditto sandbox may access your Google identity which you should acknowledge.<br />
+Afterwards you should be authenticated with your Google user (and therefore your Google ID).</p>
+
+<p>You can try out the API now. For example, expand the <a href="https://ditto.eclipseprojects.io/apidoc/#!/Things/put_things_thingId">PUT /things/{thingId}</a>
+item in order to create a new <code class="highlighter-rouge">Thing</code>, a <strong>digital twin</strong> so to say.<br />
+Scroll down to the parameters and enter the required ones (in this case the <code class="highlighter-rouge">thingId</code>), for example:</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>org.eclipse.ditto:my-first-thing
+</code></pre></div></div>
+
+<p>The ID must contain a namespace (in Java package notation) followed by a <code class="highlighter-rouge">:</code> and an arbitrary string afterwards.</p>
+
+<p>The body must be a JSON object, at least an empty one <code class="highlighter-rouge">{}</code>.<br />
+Or it can be filled with arbitrary <a href="basic-thing.html#attributes">attributes</a> and/or <a href="basic-thing.html#features">features</a>, e.g.:</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">"attributes"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"someAttr"</span><span class="p">:</span><span class="w"> </span><span class="mi">32</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="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">"heating-no1"</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">"connected"</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">"complexProperty"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
+ </span><span class="s2">"street"</span><span class="p">:</span><span class="w"> </span><span class="s2">"my street"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"house no"</span><span class="p">:</span><span class="w"> </span><span class="mi">42</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">"switchable"</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">"on"</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">"lastToggled"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2017-11-15T18:21Z"</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>
+
+<h3 id="programmatically-access-the-http-api">Programmatically access the HTTP API</h3>
+
+<p>If you want to programmatically (e.g. in a script running on a RaspberryPi) access the sandbox, we currently have
+to disappoint you. As there is no possibility to obtain a Google JWT with plain username/password and we currently
+have no other authentication provider configured in the sandbox, we have no possibility to authenticate a script.</p>
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/search.json b/2.0/search.json
new file mode 100644
index 0000000..a51f34e
--- /dev/null
+++ b/2.0/search.json
@@ -0,0 +1,1889 @@
+[
+
+
+
+
+{
+"title": "Data By-Pass Pattern",
+"tags": "advanced",
+"keywords": "auth, access control, router, content-type, correlation-id, feature, message, payload, thing",
+"url": "advanced-data-by-pass.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Architecture overview",
+"tags": "architecture",
+"keywords": "architecture, overview, component, services",
+"url": "architecture-overview.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Concierge service",
+"tags": "architecture",
+"keywords": "architecture, service, concierge",
+"url": "architecture-services-concierge.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Connectivity service",
+"tags": "architectureconnectivity",
+"keywords": "architecture, service, connectivity, amqp, hono",
+"url": "architecture-services-connectivity.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Gateway service",
+"tags": "architecture",
+"keywords": "architecture, service, gateway",
+"url": "architecture-services-gateway.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Policies service",
+"tags": "architecture",
+"keywords": "architecture, service, policies",
+"url": "architecture-services-policies.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Things-Search service",
+"tags": "architecturesearch",
+"keywords": "architecture, service, things-search, search",
+"url": "architecture-services-things-search.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Things service",
+"tags": "architecture",
+"keywords": "architecture, service, things",
+"url": "architecture-services-things.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Acknowledgements / Quality of Service",
+"tags": "model",
+"keywords": "acks, acknowledgement, acknowledgements, qos, at least once, delivery, guarantee",
+"url": "basic-acknowledgements.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "APIs",
+"tags": "model",
+"keywords": "API, HTTP, HTTPS, JWT, REST, websocket, WSS",
+"url": "basic-apis.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Authentication and authorization",
+"tags": "model",
+"keywords": "auth, authentication, authorization, policies, policy, sso, single sign on",
+"url": "basic-auth.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Change notifications",
+"tags": "modelrql",
+"keywords": "change, event, feature, notification, thing, filtering, rql, push, subscribe, consume, enrich, extra",
+"url": "basic-changenotifications.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Connections",
+"tags": "connectivity",
+"keywords": "connection, connectivity, mapping, connection, integration, placeholder, qos, at least once, delivery, guarantee",
+"url": "basic-connections.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Signal enrichment",
+"tags": "protocol",
+"keywords": "change, event, enrich, extra, enrichment, fields, extraFields",
+"url": "basic-enrichment.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Errors",
+"tags": "model",
+"keywords": "error, failure, exception, model",
+"url": "basic-errors.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Feature",
+"tags": "model",
+"keywords": "definition, properties, desiredProperties, entity, feature, functionblock, informationmodel, model, vorto",
+"url": "basic-feature.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Messages",
+"tags": "model",
+"keywords": "router, content-type, correlation-id, feature, message, payload, thing",
+"url": "basic-messages.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Thing Metadata",
+"tags": "model",
+"keywords": "metadata, things, model, semantic",
+"url": "basic-metadata.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Namespaces and Names",
+"tags": "model",
+"keywords": "namespace, name, id, entity, model, regex",
+"url": "basic-namespaces-and-names.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Basic concepts overview",
+"tags": "model",
+"keywords": "basic concepts, overview, thing, feature, domain model, model",
+"url": "basic-overview.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Placeholders",
+"tags": "connectivity",
+"keywords": "placeholder, function, expression, substring, default, lower, upper",
+"url": "basic-placeholders.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Policy",
+"tags": "model",
+"keywords": "authentication, authorization, auth, policies, policy",
+"url": "basic-policy.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "RQL expressions",
+"tags": "rqlprotocol",
+"keywords": "rql, query, filter, filtering, search",
+"url": "basic-rql.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Search functionality",
+"tags": "searchrql",
+"keywords": "search, things-search, rql, query",
+"url": "basic-search.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Announcement",
+"tags": "signal",
+"keywords": "announcement, signal",
+"url": "basic-signals-announcement.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Command",
+"tags": "signal",
+"keywords": "command, modify, query, signal",
+"url": "basic-signals-command.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Command response",
+"tags": "signal",
+"keywords": "signal, commandresponse, response",
+"url": "basic-signals-commandresponse.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Error response",
+"tags": "signal",
+"keywords": "signal, error, errorresponse, exception, response",
+"url": "basic-signals-errorresponse.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Event",
+"tags": "signal",
+"keywords": "event, signal",
+"url": "basic-signals-event.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Signals",
+"tags": "signal",
+"keywords": "command, communication, CQRS, DDD, event, EventSourcing, response, signal",
+"url": "basic-signals.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Thing",
+"tags": "model",
+"keywords": "entity, feature, model, namespace, thing",
+"url": "basic-thing.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Blog",
+"tags": "",
+"keywords": "news, blog, updates, release notes, announcements",
+"url": "blog.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Blog archive",
+"tags": "",
+"keywords": "news, blog, updates, release notes, announcements",
+"url": "blog_archive.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Client SDK Java",
+"tags": "client_sdk",
+"keywords": "",
+"url": "client-sdk-java.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Client SDK JavaScript",
+"tags": "client_sdk",
+"keywords": "",
+"url": "client-sdk-javascript.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Client SDK overview",
+"tags": "client_sdk",
+"keywords": "",
+"url": "client-sdk-overview.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Header mapping for connections",
+"tags": "connectivity",
+"keywords": "header, mapping, placeholder",
+"url": "connectivity-header-mapping.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Manage connections",
+"tags": "connectivity",
+"keywords": "",
+"url": "connectivity-manage-connections.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Payload mapping in connectivity service",
+"tags": "connectivity",
+"keywords": "mapping, transformation, payload, javascript",
+"url": "connectivity-mapping.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Connectivity API overview",
+"tags": "connectivity",
+"keywords": "",
+"url": "connectivity-overview.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "AMQP 0.9.1 protocol binding",
+"tags": "protocolconnectivityrql",
+"keywords": "binding, protocol, amqp, amqp091, rabbitmq",
+"url": "connectivity-protocol-bindings-amqp091.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "AMQP 1.0 protocol binding",
+"tags": "protocolconnectivityrql",
+"keywords": "binding, protocol, amqp, amqp10",
+"url": "connectivity-protocol-bindings-amqp10.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "HTTP 1.1 protocol binding",
+"tags": "protocolconnectivityrql",
+"keywords": "binding, protocol, http",
+"url": "connectivity-protocol-bindings-http.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Apache Kafka 2.x protocol binding",
+"tags": "protocolconnectivityrql",
+"keywords": "binding, protocol, kafka, kafka2",
+"url": "connectivity-protocol-bindings-kafka2.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "MQTT 3.1.1 protocol binding",
+"tags": "protocolconnectivity",
+"keywords": "binding, protocol, mqtt",
+"url": "connectivity-protocol-bindings-mqtt.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "MQTT 5 protocol binding",
+"tags": "protocolconnectivity",
+"keywords": "binding, protocol, mqtt, mqtt5",
+"url": "connectivity-protocol-bindings-mqtt5.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "SSH tunneling",
+"tags": "connectivity",
+"keywords": "ssh, tunnel, tunneling, port forwarding",
+"url": "connectivity-ssh-tunneling.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Certificates for Transport Layer Security",
+"tags": "connectivity",
+"keywords": "security, TLS",
+"url": "connectivity-tls-certificates.html",
+"summary": ""
+}
+,
+
+
+
+
+
+{
+"title": "Feedback",
+"tags": "getting_startedtroubleshooting",
+"keywords": "bugtracker, chat, contact, feedback, forum, github, gitter, mailing-list, questions, support, troubleshooting",
+"url": "feedback.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Glossary",
+"tags": "getting_started",
+"keywords": "definitions, glossaries, terms",
+"url": "glossary.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "HTTP API",
+"tags": "",
+"keywords": "HTTP, REST, documentation, swagger, openapi",
+"url": "http-api-doc.html",
+"summary": "Contains the HTTP API documentation of Eclipse Ditto."
+}
+,
+
+
+
+{
+"title": "HTTP API concepts",
+"tags": "http",
+"keywords": "http, api, concepts, partial, conditional, optimistic locking, ETag, If-Match, If-None-Match",
+"url": "httpapi-concepts.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "HTTP API Messages",
+"tags": "http",
+"keywords": "http, api, messages, thing",
+"url": "httpapi-messages.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "HTTP API overview",
+"tags": "http",
+"keywords": "api, http, overview, REST",
+"url": "httpapi-overview.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Cloud Events HTTP protocol binding",
+"tags": "bindingprotocolhttp",
+"keywords": "binding, protocol, http, cloudevents",
+"url": "httpapi-protocol-bindings-cloudevents.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "WebSocket protocol binding",
+"tags": "protocolhttprql",
+"keywords": "binding, protocol, websocket, http",
+"url": "httpapi-protocol-bindings-websocket.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "HTTP API search",
+"tags": "httpsearchrql",
+"keywords": "http, api, search, query, rql",
+"url": "httpapi-search.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "HTTP API server sent events (SSE)",
+"tags": "httprql",
+"keywords": "http, api, sse, EventSource, fields, projection, extra, enrich",
+"url": "httpapi-sse.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "",
+"tags": "",
+"keywords": "ditto, digital twin, iot, twin, eclipse ditto, eclipse iot, opensource, open source",
+"url": "index.html",
+"summary": "Eclipse Ditto™ is an open source framework for creating and managing digital twins in the IoT."
+}
+,
+
+
+
+{
+"title": "Building Ditto",
+"tags": "getting_startedinstallation",
+"keywords": "installation, docker, maven",
+"url": "installation-building.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Operating Ditto",
+"tags": "installation",
+"keywords": "operating, docker, docker-compose, devops, logging, logstash, elk, monitoring, prometheus, grafana",
+"url": "installation-operating.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Running Ditto",
+"tags": "getting_startedinstallation",
+"keywords": "running, start, run, docker, docker-compose, k3s, helm, openshift, kubernetes",
+"url": "installation-running.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Digital twins",
+"tags": "getting_started",
+"keywords": "digital twin, digitaltwin, twin, administrationshell, asset",
+"url": "intro-digitaltwins.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Hello world",
+"tags": "getting_started",
+"keywords": "",
+"url": "intro-hello-world.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Eclipse Ditto™ documentation overview",
+"tags": "getting_started",
+"keywords": "purpose, about, motivation, digital twin, digitaltwin, twin",
+"url": "intro-overview.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Presentations",
+"tags": "",
+"keywords": "presentations, slides, meetup",
+"url": "presentations.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Protocol bindings",
+"tags": "protocol",
+"keywords": "bindings, protocol",
+"url": "protocol-bindings.html",
+"summary": ""
+}
+,
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+{
+"title": "Protocol examples",
+"tags": "protocol",
+"keywords": "protocol, examples",
+"url": "protocol-examples.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Protocol overview",
+"tags": "protocol",
+"keywords": "channel, command, event, json, live, protocol, response, twin",
+"url": "protocol-overview.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Protocol specification for acknowledgements",
+"tags": "protocol",
+"keywords": "protocol, specification, ack, acknowledgement",
+"url": "protocol-specification-acks.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Protocol specification for errors",
+"tags": "protocol",
+"keywords": "protocol, specification, error, failure",
+"url": "protocol-specification-errors.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Policies - Announcement protocol specification",
+"tags": "protocol",
+"keywords": "protocol, specification, announcement, policy",
+"url": "protocol-specification-policies-announcement.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",
+"url": "protocol-specification-things-create-or-modify.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Things - Delete protocol specification",
+"tags": "protocol",
+"keywords": "protocol, specification, delete, thing",
+"url": "protocol-specification-things-delete.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Things - Merge protocol specification",
+"tags": "protocol",
+"keywords": "protocol, specification, merge, thing",
+"url": "protocol-specification-things-merge.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Things - Messages protocol specification",
+"tags": "protocol",
+"keywords": "protocol, specification, messages, thing",
+"url": "protocol-specification-things-messages.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Things - Retrieve protocol specification",
+"tags": "protocol",
+"keywords": "protocol, specification, retrieve, thing",
+"url": "protocol-specification-things-retrieve.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Things - Search protocol specification",
+"tags": "protocolsearch",
+"keywords": "protocol, specification, search, thing",
+"url": "protocol-specification-things-search.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Protocol specification for Things",
+"tags": "protocol",
+"keywords": "protocol, specification, general",
+"url": "protocol-specification-things.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Protocol topic",
+"tags": "protocol",
+"keywords": "topic, protocol, specification, twin, digital twin, channel, criterion, action",
+"url": "protocol-specification-topic.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Protocol specification",
+"tags": "protocol",
+"keywords": "action, channel, criterion, digital twin, envelope, payload, protocol, specification, twin",
+"url": "protocol-specification.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Protocol twin/live channel",
+"tags": "protocol",
+"keywords": "channel, command, device, event, live, message, protocol, response, twin",
+"url": "protocol-twinlive.html",
+"summary": ""
+}
+,
+
+
+
+{
+"title": "Release notes 0.1.0-M1",
+"tags": "release_notes",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_010-M1.html",
+"summary": "Version 0.1.0-M1 of Eclipse Ditto, released on 18.12.2017"
+}
+,
+
+
+
+{
+"title": "Release notes 0.1.0-M3",
+"tags": "release_notessearch",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_010-M3.html",
+"summary": "Version 0.1.0-M3 of Eclipse Ditto, released on 12.01.2018"
+}
+,
+
+
+
+{
+"title": "Release notes 0.2.0-M1",
+"tags": "release_notessearch",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_020-M1.html",
+"summary": "Version 0.2.0-M1 of Eclipse Ditto, released on 07.02.2018"
+}
+,
+
+
+
+{
+"title": "Release notes 0.3.0-M1",
+"tags": "release_notesconnectivity",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_030-M1.html",
+"summary": "Version 0.3.0-M1 of Eclipse Ditto, released on 26.04.2018"
+}
+,
+
+
+
+{
+"title": "Release notes 0.3.0-M2",
+"tags": "release_notes",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_030-M2.html",
+"summary": "Version 0.3.0-M2 of Eclipse Ditto, released on 15.06.2018"
+}
+,
+
+
+
+{
+"title": "Release notes 0.8.0",
+"tags": "release_notes",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_080.html",
+"summary": "Version 0.8.0 of Eclipse Ditto, released on 28.11.2018"
+}
+,
+
+
+
+{
+"title": "Release notes 0.8.0-M1",
+"tags": "release_notes",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_080-M1.html",
+"summary": "Version 0.8.0-M1 of Eclipse Ditto, released on 14.08.2018"
+}
+,
+
+
+
+{
+"title": "Release notes 0.8.0-M2",
+"tags": "release_notes",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_080-M2.html",
+"summary": "Version 0.8.0-M2 of Eclipse Ditto, released on 27.09.2018"
+}
+,
+
+
+
+{
+"title": "Release notes 0.8.0-M3",
+"tags": "release_notes",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_080-M3.html",
+"summary": "Version 0.8.0-M3 of Eclipse Ditto, released on 14.11.2018"
+}
+,
+
+
+
+{
+"title": "Release notes 0.9.0",
+"tags": "release_notes",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_090.html",
+"summary": "Version 0.9.0 of Eclipse Ditto, released on 10.07.2019"
+}
+,
+
+
+
+{
+"title": "Release notes 0.9.0-M1",
+"tags": "release_notes",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_090-M1.html",
+"summary": "Version 0.9.0-M1 of Eclipse Ditto, released on 28.03.2019"
+}
+,
+
+
+
+{
+"title": "Release notes 0.9.0-M2",
+"tags": "release_notes",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_090-M2.html",
+"summary": "Version 0.9.0-M2 of Eclipse Ditto, released on 29.04.2019"
+}
+,
+
+
+
+{
+"title": "Release notes 1.0.0",
+"tags": "release_notes",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_100.html",
+"summary": "Version 1.0.0 of Eclipse Ditto, released on 12.12.2019"
+}
+,
+
+
+
+{
+"title": "Release notes 1.0.0-M1a",
+"tags": "release_notes",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_100-M1a.html",
+"summary": "Version 1.0.0-M1a of Eclipse Ditto, released on 17.09.2019"
+}
+,
+
+
+
+{
+"title": "Release notes 1.0.0-M2",
+"tags": "release_notes",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_100-M2.html",
+"summary": "Version 1.0.0-M2 of Eclipse Ditto, released on 04.11.2019"
+}
+,
+
+
+
+{
+"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": "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": "Release notes 1.1.3",
+"tags": "release_notes",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_113.html",
+"summary": "Version 1.1.3 of Eclipse Ditto, released on 20.07.2020"
+}
+,
+
+
+
+{
+"title": "Release notes 1.1.5",
+"tags": "release_notes",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_115.html",
+"summary": "Version 1.1.5 of Eclipse Ditto, released on 25.08.2020"
+}
+,
+
+
+
+{
+"title": "Release notes 1.2.0",
+"tags": "release_notes",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_120.html",
+"summary": "Version 1.2.0 of Eclipse Ditto, released on 31.08.2020"
+}
+,
+
+
+
+{
+"title": "Release notes 1.2.1",
+"tags": "release_notes",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_121.html",
+"summary": "Version 1.2.1 of Eclipse Ditto, released on 08.09.2020"
+}
+,
+
+
+
+{
+"title": "Release notes 1.3.0",
+"tags": "release_notes",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_130.html",
+"summary": "Version 1.3.0 of Eclipse Ditto, released on 30.09.2020"
+}
+,
+
+
+
+{
+"title": "Release notes 1.4.0",
+"tags": "release_notes",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_140.html",
+"summary": "Version 1.4.0 of Eclipse Ditto, released on 28.10.2020"
+}
+,
+
+
+
+{
+"title": "Release notes 1.5.0",
+"tags": "release_notes",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_150.html",
+"summary": "Version 1.5.0 of Eclipse Ditto, released on 10.12.2020"
+}
+,
+
+
+
+{
+"title": "Release notes 1.5.1",
+"tags": "release_notes",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_151.html",
+"summary": "Version 1.5.1 of Eclipse Ditto, released on 22.12.2020"
+}
+,
+
+
+
+{
+"title": "Release notes 2.0.0",
+"tags": "release_notes",
+"keywords": "release notes, announcements, changelog",
+"url": "release_notes_200.html",
+"summary": "Version 2.0.0 of Eclipse Ditto, released on 06.05.2021"
+}
+,
+
+
+
+{
+"title": "Sandbox",
+"tags": "",
+"keywords": "sandbox, demo, trial",
+"url": "sandbox.html",
+"summary": ""
+}
+,
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+{
+"title": "",
+"tags": "",
+"keywords": "",
+"url": "robots.txt",
+"summary": ""
+}
+,
+
+
+
+
+
+{
+"title": "Announcing Eclipse Ditto Release 2.0.0",
+"tags": "blog",
+"keywords": "",
+"url": "2021-05-06-release-announcement-200.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Support SSH tunneling for managed connections",
+"tags": "blogarchitectureconnectivity",
+"keywords": "",
+"url": "2021-03-31-ssh-tunneling-for-managed-connections.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Use Eclipse Ditto with Azure IoT Hub as message broker",
+"tags": "blogarchitectureconnectivity",
+"keywords": "",
+"url": "2021-03-22-azure-iot-hub-integration.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Support merge functionality for things resources",
+"tags": "bloghttpprotocol",
+"keywords": "",
+"url": "2021-02-04-merge-feature.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Policy actions: token based subject activation",
+"tags": "blog",
+"keywords": "",
+"url": "2021-01-22-policy-subject-activate-token-integration.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Announcing Eclipse Ditto Release 1.5.0",
+"tags": "blog",
+"keywords": "",
+"url": "2020-12-10-release-announcement-150.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Weak acknowledgments to decouple signal publishers and subscribers",
+"tags": "blog",
+"keywords": "",
+"url": "2020-11-16-weak-acknowledgements.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Desired Feature Properties",
+"tags": "blog",
+"keywords": "",
+"url": "2020-11-11-desired-properties.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Announcing Eclipse Ditto Release 1.4.0",
+"tags": "blog",
+"keywords": "",
+"url": "2020-10-28-release-announcement-140.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "E2E acknowledgment",
+"tags": "blog",
+"keywords": "",
+"url": "2020-10-23-end-2-end-acknowledgment.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Asynchronous Client Creation in Ditto Java Client 1.3.0",
+"tags": "blog",
+"keywords": "",
+"url": "2020-10-08-asynchronous-client-creation.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Announcing Eclipse Ditto Release 1.3.0",
+"tags": "blog",
+"keywords": "",
+"url": "2020-09-30-release-announcement-130.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Announcing Eclipse Ditto Release 1.2.0",
+"tags": "blog",
+"keywords": "",
+"url": "2020-08-31-release-announcement-120.html",
+"summary": ""
+}
+,
+
+
+{
+"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": "",
+"url": "2019-12-12-release-announcement-100.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Announcing Ditto Milestone 1.0.0-M2",
+"tags": "blog",
+"keywords": "",
+"url": "2019-11-04-milestone-announcement-100-M2.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Integration of HTTP endpoints/webhooks",
+"tags": "blog",
+"keywords": "",
+"url": "2019-10-17-http-connectivity.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Announcing Ditto Milestone 1.0.0-M1a",
+"tags": "blog",
+"keywords": "",
+"url": "2019-09-17-milestone-announcement-100-M1a.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Eclipse Ditto now supports OpenID Connect",
+"tags": "blog",
+"keywords": "",
+"url": "2019-08-28-openid-connect.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Announcing Eclipse Ditto Release 0.9.0",
+"tags": "blog",
+"keywords": "",
+"url": "2019-07-10-release-announcement-090.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Announcing Ditto Milestone 0.9.0-M2",
+"tags": "blog",
+"keywords": "",
+"url": "2019-04-29-milestone-announcement-090-M2.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Announcing Ditto Milestone 0.9.0-M1",
+"tags": "blog",
+"keywords": "",
+"url": "2019-03-28-milestone-announcement-090-M1.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Connectivity to Apache Kafka in Eclipse Ditto",
+"tags": "blog",
+"keywords": "",
+"url": "2019-03-13-kafka-connectivity.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Using Eclipse Hono's Command&Control with Eclipse Ditto",
+"tags": "blog",
+"keywords": "",
+"url": "2018-12-05-example-command-and-control.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Announcing Eclipse Ditto Release 0.8.0",
+"tags": "blog",
+"keywords": "",
+"url": "2018-11-28-release-announcement-080.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Announcing Ditto Milestone 0.8.0-M3",
+"tags": "blog",
+"keywords": "",
+"url": "2018-11-14-milestone-announcement-080-M3.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Example demonstrating connectivity to an MQTT broker",
+"tags": "blog",
+"keywords": "",
+"url": "2018-10-16-example-mqtt-bidirectional.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Announcing Ditto Milestone 0.8.0-M2",
+"tags": "blog",
+"keywords": "",
+"url": "2018-09-27-milestone-announcement-080-M2.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Selective push notifications available",
+"tags": "blogconnectivityrql",
+"keywords": "",
+"url": "2018-09-21-selective-push-notifications.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Announcing Ditto Milestone 0.8.0-M1",
+"tags": "blog",
+"keywords": "",
+"url": "2018-08-14-milestone-announcement-080-M1.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Announcing Ditto Milestone 0.3.0-M2",
+"tags": "blog",
+"keywords": "",
+"url": "2018-06-15-milestone-announcement-030-M2.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Connecting Eclipse Ditto to Eclipse Hono",
+"tags": "blogconnectivity",
+"keywords": "",
+"url": "2018-05-02-connecting-ditto-hono.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Announcing Ditto Milestone 0.3.0-M1",
+"tags": "blog",
+"keywords": "",
+"url": "2018-04-26-milestone-announcement-030-M1.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Ditto's connectivity capabilities are pimped up",
+"tags": "blogconnectivity",
+"keywords": "",
+"url": "2018-04-25-connectivity-service.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Introducing Feature Definition",
+"tags": "blog",
+"keywords": "",
+"url": "2018-02-08-feature-definition.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Announcing Ditto Milestone 0.2.0-M1",
+"tags": "blog",
+"keywords": "",
+"url": "2018-02-07-milestone-announcement-020-M1.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Example demonstrating REST and WebSocket API",
+"tags": "blog",
+"keywords": "",
+"url": "2018-01-15-example-demonstrating-rest-to-websocket.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Announcing Ditto Milestone 0.1.0-M3",
+"tags": "blog",
+"keywords": "",
+"url": "2018-01-12-milestone-announcement-010-M3.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Announcing Ditto Milestone 0.1.0-M1",
+"tags": "blog",
+"keywords": "",
+"url": "2017-12-18-milestone-announcement-010-M1.html",
+"summary": ""
+}
+,
+
+
+{
+"title": "Welcome to the Eclipse Ditto project site",
+"tags": "blog",
+"keywords": "",
+"url": "2017-11-10-welcome-to-ditto.html",
+"summary": "This is our very first blog post of our new project site and we continue to add more documentation."
+}
+
+
+
+]
diff --git a/2.0/sitemap.xml b/2.0/sitemap.xml
new file mode 100644
index 0000000..ad0de7f
--- /dev/null
+++ b/2.0/sitemap.xml
@@ -0,0 +1,1151 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2021-05-06-release-announcement-200.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2021-03-31-ssh-tunneling-for-managed-connections.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2021-03-22-azure-iot-hub-integration.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2021-02-04-merge-feature.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2021-01-22-policy-subject-activate-token-integration.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2020-12-10-release-announcement-150.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2020-11-16-weak-acknowledgements.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2020-11-11-desired-properties.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2020-10-28-release-announcement-140.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2020-10-23-end-2-end-acknowledgment.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2020-10-08-asynchronous-client-creation.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2020-09-30-release-announcement-130.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2020-08-31-release-announcement-120.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2020-04-29-release-announcement-110.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2020-04-16-connecting-to-ttn-via-mqtt.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2019-12-12-release-announcement-100.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2019-11-04-milestone-announcement-100-M2.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2019-10-17-http-connectivity.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2019-09-17-milestone-announcement-100-M1a.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2019-08-28-openid-connect.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2019-07-10-release-announcement-090.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2019-04-29-milestone-announcement-090-M2.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2019-03-28-milestone-announcement-090-M1.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2019-03-13-kafka-connectivity.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2018-12-05-example-command-and-control.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2018-11-28-release-announcement-080.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2018-11-14-milestone-announcement-080-M3.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2018-10-16-example-mqtt-bidirectional.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2018-09-27-milestone-announcement-080-M2.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2018-09-21-selective-push-notifications.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2018-08-14-milestone-announcement-080-M1.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2018-06-15-milestone-announcement-030-M2.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2018-05-02-connecting-ditto-hono.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2018-04-26-milestone-announcement-030-M1.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2018-04-25-connectivity-service.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2018-02-08-feature-definition.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2018-02-07-milestone-announcement-020-M1.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2018-01-15-example-demonstrating-rest-to-websocket.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2018-01-12-milestone-announcement-010-M3.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2017-12-18-milestone-announcement-010-M1.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/2017-11-10-welcome-to-ditto.html</loc>
+ </url>
+
+
+
+
+
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/advanced-data-by-pass.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/architecture-overview.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/architecture-services-concierge.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/architecture-services-connectivity.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/architecture-services-gateway.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/architecture-services-policies.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/architecture-services-things-search.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/architecture-services-things.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/basic-acknowledgements.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/basic-apis.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/basic-auth.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/basic-changenotifications.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/basic-connections.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/basic-enrichment.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/basic-errors.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/basic-feature.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/basic-messages.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/basic-metadata.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/basic-namespaces-and-names.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/basic-overview.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/basic-placeholders.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/basic-policy.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/basic-rql.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/basic-search.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/basic-signals-announcement.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/basic-signals-command.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/basic-signals-commandresponse.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/basic-signals-errorresponse.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/basic-signals-event.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/basic-signals.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/basic-thing.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/blog.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/blog_archive.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/client-sdk-java.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/client-sdk-javascript.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/client-sdk-overview.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/connectivity-header-mapping.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/connectivity-manage-connections.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/connectivity-mapping.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/connectivity-overview.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/connectivity-protocol-bindings-amqp091.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/connectivity-protocol-bindings-amqp10.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/connectivity-protocol-bindings-http.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/connectivity-protocol-bindings-kafka2.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/connectivity-protocol-bindings-mqtt.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/connectivity-protocol-bindings-mqtt5.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/connectivity-ssh-tunneling.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/connectivity-tls-certificates.html</loc>
+ </url>
+
+
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/feedback.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/glossary.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/http-api-doc.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/httpapi-concepts.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/httpapi-messages.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/httpapi-overview.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/httpapi-protocol-bindings-cloudevents.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/httpapi-protocol-bindings-websocket.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/httpapi-search.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/httpapi-sse.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/index.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/installation-building.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/installation-operating.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/installation-running.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/intro-digitaltwins.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/intro-hello-world.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/intro-overview.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/presentations.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/protocol-bindings.html</loc>
+ </url>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/protocol-examples.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/protocol-overview.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/protocol-specification-acks.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/protocol-specification-errors.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/protocol-specification-policies-announcement.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/protocol-specification-policies-create-or-modify.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/protocol-specification-policies-delete.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/protocol-specification-policies-retrieve.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/protocol-specification-policies.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/protocol-specification-things-create-or-modify.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/protocol-specification-things-delete.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/protocol-specification-things-merge.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/protocol-specification-things-messages.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/protocol-specification-things-retrieve.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/protocol-specification-things-search.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/protocol-specification-things.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/protocol-specification-topic.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/protocol-specification.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/protocol-twinlive.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/release_notes_010-M1.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/release_notes_010-M3.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/release_notes_020-M1.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/release_notes_030-M1.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/release_notes_030-M2.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/release_notes_080.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/release_notes_080-M1.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/release_notes_080-M2.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/release_notes_080-M3.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/release_notes_090.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/release_notes_090-M1.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/release_notes_090-M2.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/release_notes_100.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/release_notes_100-M1a.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/release_notes_100-M2.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/release_notes_110.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/release_notes_111.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/release_notes_112.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/release_notes_113.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/release_notes_115.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/release_notes_120.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/release_notes_121.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/release_notes_130.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/release_notes_140.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/release_notes_150.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/release_notes_151.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/release_notes_200.html</loc>
+ </url>
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/sandbox.html</loc>
+ </url>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <url>
+ <loc>https://www.eclipse.org/ditto/robots.txt</loc>
+ </url>
+
+
+</urlset>
\ No newline at end of file
diff --git a/2.0/slides/2018_02_07-virtualiot-meetup/index.html b/2.0/slides/2018_02_07-virtualiot-meetup/index.html
new file mode 100644
index 0000000..3879ba0
--- /dev/null
+++ b/2.0/slides/2018_02_07-virtualiot-meetup/index.html
@@ -0,0 +1,658 @@
+<!doctype html>
+<html lang="en">
+
+<head>
+ <meta charset="utf-8">
+
+ <title>Digital Twins go open source: Eclipse Ditto introduction</title>
+
+ <meta name="description" content="Virtual IoT Meetup - Digital Twins go open source: Eclipse Ditto introduction">
+ <meta name="author" content="Thomas Jäckle">
+ <meta name="date" content="2018-02-07">
+ <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://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%;
+ }
+ #header-right {
+ position: absolute;
+ top: 0%;
+ right: 0%;
+ }
+
+ .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/eclipse_iot_logo.png" style="width: 150px; 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 -->
+ <br />
+ <h1 style="font-size: 3em;">Digital Twins go open source</h1>
+ <br/>
+ <h2>Eclipse Ditto introduction</h2>
+ <!--<h3>-</h3>-->
+ <!--<h2>new project introduction</h2>-->
+ <br style="clear: both"/>
+ <hr />
+ <small class="introlink">by <a
+ href="mailto:thomas.jaeckle@bosch-si.com">Thomas Jäckle</a> (<a
+ href="http://twitter.com/thjaeckle">@thjaeckle</a>)
+ </small>
+ </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">Ditto model + features</a></li>
+ <li><a href="#framework">A framework for Digital Twins</a></li>
+ <li><a href="#demo">Demo</a></li>
+ <li><a href="#wrap-up">Wrap up + Roadmap</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-1" style="clear: both;">
+ <h2>IoT development needs in the back-end</h2>
+ <br/>
+ <!--<h3 style="text-align: left;">for IoT devices we need</h3>-->
+ <ul style="font-size: 0.9em;">
+ <li class="fragment"><b>APIs</b> optimized for the web</li>
+ <li class="fragment" style="margin-top: 0.5em;"><b>control</b> who has <b>access</b> to which aspects</li>
+ <li class="fragment" style="margin-top: 0.5em;"><b>directly</b> communicate to devices <b>and</b> access <b>last known</b> state</li>
+ <li class="fragment" style="margin-top: 0.5em;">get <b>notified</b> about changes/events</li>
+ <li class="fragment" style="margin-top: 0.5em;"><b>enhance</b> APIs with further functionality</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/>
+ <h2>a mechanism for simplifying IoT solution development</h2>
+ </section>
+
+ <section id="twin-1" style="clear: both;">
+ <!-- background source: https://unsplash.com/search/cloud?photo=FIKD9t5_5zQ -->
+ <h2>Digital Twin metaphor</h2>
+ <br/>
+ <ul>
+ <li class="fragment" style="margin-top: 1em;">mirrors physical devices</li>
+ <li class="fragment" style="margin-top: 1em;">provider of aspects+services around devices</li>
+ <li class="fragment" style="margin-top: 1em;">keep real and digital worlds in sync</li>
+ <li class="fragment" style="margin-top: 1em;">applicable for both industrial and consumer-centric IoT scenarios</li>
+ </ul>
+ </section>
+ <section id="twin-2" style="clear: both;">
+ <!-- background source: https://unsplash.com/search/cloud?photo=FIKD9t5_5zQ -->
+ <h2>in IIoT / Industry 4.0</h2>
+ <br/>
+ <ul style="float:left; width: 52%;">
+ <li style="margin-top: 1em;">asset administration shell ("Verwaltungsschale")</li>
+ <li style="margin-top: 2em;">holistic view of all capabilities (services) and aspects of an asset</li>
+ </ul>
+ <div style="float:right; width: 40%;">
+ <img src="../images/asset-admin-shell.png" style="width: 80%" alt="Asset admin shell" />
+ <div style="font-size: 0.4em;"><a href="http://acplt.github.io/openAAS/AssetAdministrationShell.html">Source</a></div>
+ </div>
+ <!-- img source: http://acplt.github.io/openAAS/AssetAdministrationShell.html -->
+ </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>
+ <img src="../images/ditto-in-action.png" style="width: 75%" alt="Ditto in action"/>
+ </section>
+ <section id="ditto-2" style="clear: both;">
+ <h2>domain model</h2>
+ <ul style="font-size: 0.8em;">
+ <li>how does the model of Eclipse Ditto look like?</li>
+ <li>KISS</li>
+ </ul>
+ <br />
+ <br />
+ <img src="../../images/pages/basic/ditto-class-diagram-v2.png" alt="Ditto class diagram v2" class="fragment"/>
+ <a href="https://www.eclipse.org/ditto/basic-overview.html#domain-model">→ docs</a>
+ </section>
+ <section id="ditto-3" style="clear: both;">
+ <h2>turn device data into API</h2>
+ <div style="text-align: left; float: left; width: 38%">
+ <pre style="width: 100%; font-size: 0.48em;"><code class="hljs json">{
+ "thingId": "namespace:car-1",
+ "acl": { ... },
+ "attributes": {
+ "manufacturer": "ACME corp",
+ "productionData": {
+ "serialNo": 4711
+ }
+ },
+ "features": {
+ "headlights": {
+ "properties": {
+ "on": false
+ }
+ }
+ }
+}</code></pre>
+ </div>
+ <div style="text-align: left; float: right; width: 60%" class="fragment">
+ <pre style="width: 105%; font-size: 0.48em;"><code class="hljs">GET/PUT/DELETE /api/1/things/namespace:car-1
+ /api/1/things/namespace:car-1/thingId
+ /api/1/things/namespace:car-1/acl
+ /api/1/things/namespace:car-1/attributes
+ /api/1/things/namespace:car-1/attributes/manufacturer
+ /api/1/things/namespace:car-1/attributes/productionData
+ /api/1/things/namespace:car-1/attributes/productionData/serialNo
+
+
+ /api/1/things/namespace:car-1/features
+ /api/1/things/namespace:car-1/features/headlights
+ /api/1/things/namespace:car-1/features/headlights/properties
+ /api/1/things/namespace:car-1/features/headlights/properties/on
+
+
+
+
+</code></pre>
+ <a href="https://www.eclipse.org/ditto/httpapi-concepts.html#endpoints" style="float: right;">→ docs</a>
+ </div>
+ </section>
+ <section id="ditto-4" style="clear: both">
+ <h2>Ditto Protocol API</h2>
+ <ul>
+ <li>JSON based text protocol for communicating with Digital Twins bidirectionally (commands/events)</li>
+ <li>via: WebSocket, AMQP 1.0 (e.g. Hono), AMQP 0.9.1</li>
+ </ul>
+ <pre style="width: 100%; font-size: 0.5em;"><code class="hljs json">{
+ "topic": "namespace/car-1/things/twin/events/modified",
+ "headers": { ... },
+ "path": "/features/headlights/properties",
+ "value": {
+ "on": true
+ },
+ "revision": 42
+}</code></pre>
+ <a href="https://www.eclipse.org/ditto/protocol-overview.html" style="float: right;">→ docs</a>
+ </section>
+ <section id="ditto-5" style="clear: both">
+ <h2>access control</h2>
+ <div style="text-align: left; float: left; width: 48%">
+ <h3>API v1: ACL</h3>
+ <pre style="width: 100%; font-size: 0.5em;"><code class="hljs json">"acl": {
+ "ditto": {
+ "READ": true,
+ "WRITE": false,
+ "ADMINISTRATE": false
+ },
+ "adam": {
+ "READ": true,
+ "WRITE": true,
+ "ADMINISTRATE": true
+ }
+}</code></pre>
+ <ul>
+ <li>inlined in Thing</li>
+ </ul>
+ </div>
+ <div style="text-align: left; float: right; width: 48%" class="fragment">
+ <h3>API v2: Policy</h3>
+ <pre style="width: 110%; font-size: 0.3em;"><code class="hljs">{
+ "policyId": "namespace:car-1-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-6" style="clear: both;">
+ <h2>twin vs. live</h2>
+ <br/>
+ <div style="text-align: left; float: left; width: 48%">
+ <img src="../../images/pages/protocol/ditto-twin-channel.png" alt="Ditto twin channel" />
+ <ul style="font-size: 0.7em">
+ <li>uses Ditto as persistence</li>
+ <li>Ditto enforces access control</li>
+ <li>Ditto processes commands, emits events</li>
+ </ul>
+ </div>
+ <div style="text-align: left; float: right; width: 48%" class="fragment">
+ <ul style="font-size: 0.7em">
+ <li>uses Ditto as router</li>
+ <li>Ditto enforces access control</li>
+ <li>endpoints process commands, emit events</li>
+ </ul>
+ <img src="../../images/pages/protocol/ditto-live-channel.png" alt="Ditto live channel" />
+ <a href="https://www.eclipse.org/ditto/protocol-twinlive.html" style="float: right;">→ docs</a>
+ </div>
+ </section>
+ <section id="ditto-7" style="clear: both;">
+ <h2>get notified about changes</h2>
+ <br/>
+ <div style="text-align: left; float: left; width: 48%">
+ <h3>via WebSocket</h3>
+ <pre style="width: 100%; font-size: 0.5em;"><code class="hljs javascript">var ws = new WebSocket(
+ "ws://u:p@ditto.eclipseprojects.io/ws/1");
+ws.onopen = function(w) {
+ w.send('START-SEND-EVENTS');
+};
+ws.onmessage = function(msg) {
+ console.log('received: ' + msg.data);
+};</code></pre>
+ <ul style="font-size: 0.7em">
+ <li>bidirectionally send/receive Ditto Protocol messages</li>
+ </ul>
+ <a href="https://www.eclipse.org/ditto/httpapi-protocol-bindings-websocket.html" style="float: right;">→ docs</a>
+ </div>
+ <div style="text-align: left; float: right; width: 48%" class="fragment">
+ <h3>via SSEs</h3>
+ <pre style="width: 100%; font-size: 0.5em;"><code class="hljs">var source = new EventSource(
+ "/api/1/things?ids=namespace:car-1");
+source.onmessage = function(msg) {
+ console.log('received: ' + msg.data);
+};</code></pre>
+ <ul style="font-size: 0.7em">
+ <li>unidirectionally receive changes in Thing JSON form</li>
+ </ul>
+ <a href="https://www.eclipse.org/ditto/httpapi-sse.html" style="float: right;">→ docs</a>
+ </div>
+ </section>
+ <section id="ditto-8" 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">
+ <pre style="width: 100%; font-size: 0.5em;"><code class="hljs javascript">GET /api/1/search/things
+ ?filter=like(attributes/manufacturer,"ACME*")</code></pre>
+ <pre style="width: 100%; font-size: 0.5em;" class="fragment"><code class="hljs javascript">GET /api/1/search/things
+ ?filter=and(
+ exists(attributes/manufacturer),
+ eq(features/headlights/properties/on,true)
+ )
+ &namespaces=org.eclipse.ditto
+ &option=sort(-attributes/manufacturer)
+ &fields=thingId,attributes/manufacturer,_modified</code></pre>
+ </div>
+ <div class="fragment">
+ <ul style="font-size: 0.7em">
+ <li>search for arbitrary data with RQL query</li>
+ <li>Ditto enforces access control</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-9" style="clear: both;">
+ <h2>nonfunctional</h2>
+ <br/>
+ <div style="text-align: left; float: left; width: 48%">
+ <img src="../../images/pages/architecture/context-overview.png" alt="Ditto context overview" />
+ </div>
+ <div style="text-align: left; float: right; width: 52%">
+ <ul style="font-size: 0.8em">
+ <li >modular architecture of Ditto services</li>
+ <li style="margin-top: 0.5em;">horizontal scalability of each Ditto service</li>
+ <li style="margin-top: 0.5em;">runtime dependency to only MongoDB</li>
+ <li style="margin-top: 0.5em;">included monitoring (JVM metrics, roundtrips, MongoDB)</li>
+ <li style="margin-top: 0.5em;">prepared for operations (e.g. via devops commands)</li>
+ </ul>
+ </div>
+ </section>
+ </section>
+
+ <!-- Section: A framework for Digital Twins -->
+ <section style="clear: both;">
+ <section id="framework" class="new-chapter" data-background="../bg-images/background-framework-small.jpg"
+ data-state="chapter-background">
+ <!-- img background: https://unsplash.com/photos/FO7bKvgETgQ -->
+ <h1>A framework for Digital Twins</h1>
+ <br/>
+ <h2>acting as a Twin orchestrator</h2>
+ </section>
+
+ <section id="framework-1" style="clear: both;">
+ <h2>orchestration via messages</h2>
+ <br/>
+ <div style="text-align: left; float: left; width: 38%">
+ <ul style="font-size: 0.7em">
+ <li>Ditto as router of messages (via "live" channel)</li>
+ <li>enforcement of access control</li>
+ <li>correlation of command/response (e.g. for HTTP)</li>
+ <!--<li>device-to-cloud,cloud-to-device,device-to-device,cloud-to-cloud</li>-->
+ </ul>
+ </div>
+ <div style="text-align: left; float: right; width: 58%">
+ <img src="../../images/pages/basic/ditto-messages.png" alt="Ditto messages" />
+ </div>
+ <ul>
+ <li>enhance the API of a Digital Twin by a custom WebSocket consumer</li>
+ </ul>
+ </section>
+
+ <section id="framework-2" style="clear: both;">
+ <h2>examples for orchestrations</h2>
+ <br/>
+ <ul style="font-size: 0.9em;">
+ <li>enhance a location-aware Twin with the current weather</li>
+ <li>enhance a Twin with an API for its known spare parts</li>
+ </ul>
+ <br/>
+ <br/>
+ <img src="../images/ditto-orchestration-examples.png" style="width: 60%" alt="Ditto orchestration example" />
+ </section>
+ </section>
+
+ <!-- Section: Demo -->
+ <section style="clear: both;">
+ <section id="demo" class="new-chapter" data-background="../bg-images/background-demo-small.jpg" data-state="chapter-background">
+ <h1>Demo time!</h1>
+ </section>
+ </section>
+
+ <!-- Section: Wrap up + Roadmap -->
+ <section style="clear: both;">
+ <section id="wrap-up">
+ <h1>Wrap up</h1>
+ <br/>
+ <ul>
+ <li class="fragment">Digital Twins as pattern for simplifying IoT back-end development</li>
+ <li class="fragment" style="margin-top: 1em;">Mission: provide Device-as-a-Service</li>
+ <li class="fragment" style="margin-top: 1em;">Eclipse Ditto as framework for Digital Twins</li>
+ </ul>
+ </section>
+
+ <section id="wrap-up-1" style="clear: both;">
+ <h2>Roadmap 2018</h2>
+ <br/>
+ <ul>
+ <li>release (non-milestone)</li>
+ <li style="margin-top: 1em;">using <b>Eclipse Vorto</b> generator for validation</li>
+ <li style="margin-top: 1em;">mapping raw payloads to/from Ditto Protocol</li>
+ <li style="margin-top: 1em;">attracting IoT developers in using Ditto</li>
+ <li style="margin-top: 1em;">integration with other OSS projects</li>
+ </ul>
+ </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">
+ <h1>Q & A</h1>
+ <br/>
+ <h3>thanks for attending</h3>
+ <br/>
+ <br/>
+ <a href="https://www.eclipse.org/ditto/feedback.html">reach out to the Ditto team</a>
+ </section>
+ </section>
+ </div>
+
+</div>
+
+<div class="footer">
+ Copyright ©2018
+ <a href="https://www.bosch-si.com" target="_blank">Bosch Software Innovations GmbH</a> All rights reserved. |
+ <a href="https://www.bosch.com/terms-of-use/terms-of-use/provider/" target="_blank">Imprint</a> |
+ <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.eclipseprojects.io" 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/2.0/slides/2018_05_23-meetup-iot-hessen/index.html b/2.0/slides/2018_05_23-meetup-iot-hessen/index.html
new file mode 100644
index 0000000..aa2a389
--- /dev/null
+++ b/2.0/slides/2018_05_23-meetup-iot-hessen/index.html
@@ -0,0 +1,747 @@
+<!doctype html>
+<html lang="en">
+
+<head>
+ <meta charset="utf-8">
+
+ <title>Digital Twins with Eclipse Ditto</title>
+
+ <meta name="description" content="Meetup IoT Hessen - Digital Twins with Eclipse Ditto">
+ <meta name="author" content="Thomas Jäckle">
+ <meta name="date" content="2018-05-23">
+ <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%;
+ }
+ #header-right {
+ position: absolute;
+ top: 0%;
+ right: 0%;
+ }
+
+ .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/eclipse_iot_logo.png" style="width: 150px; 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 -->
+ <br />
+ <h1 style="font-size: 3em;">Digital Twins with Eclipse Ditto</h1>
+ <br/>
+ <h2 style="font-size: 1.0em">webweek rhein-main /18 #wwrm18</h2>
+ <h2 style="font-size: 1.0em">23.05.2018</h2>
+ <!--<h3>-</h3>-->
+ <!--<h2>new project introduction</h2>-->
+ <br style="clear: both"/>
+ <hr />
+ <small class="introlink">by <a
+ href="mailto:thomas.jaeckle@bosch-si.com">Thomas Jäckle</a> (<a
+ href="http://twitter.com/thjaeckle">@thjaeckle</a>)
+ </small>
+ </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 Software Innovations</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">Ditto model + features</a></li>
+ <li><a href="#framework">A framework for Digital Twins</a></li>
+ <li><a href="#demo">Demo</a></li>
+ <li><a href="#wrap-up">Wrap up + Roadmap</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></h3>
+ <div class="fragment">
+ <h3>happens</h3>
+ <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 development needs in the back-end</h2>
+ <br/>
+ <!--<h3 style="text-align: left;">for IoT devices we need</h3>-->
+ <ul style="font-size: 0.9em;">
+ <li class="fragment"><b>APIs</b> optimized for the web</li>
+ <li class="fragment" style="margin-top: 0.5em;"><b>control</b> who has <b>access</b> to which aspects</li>
+ <li class="fragment" style="margin-top: 0.5em;"><b>directly</b> communicate to devices <b>and</b> access <b>last known</b> state</li>
+ <li class="fragment" style="margin-top: 0.5em;">get <b>notified</b> about changes/events</li>
+ <li class="fragment" style="margin-top: 0.5em;"><b>enhance</b> APIs with further functionality</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/>
+ <h2>a mechanism for simplifying IoT solution development</h2>
+ </section>
+
+ <section id="twin-1" style="clear: both;">
+ <!-- background source: https://unsplash.com/search/cloud?photo=FIKD9t5_5zQ -->
+ <h2>Digital Twin metaphor</h2>
+ <br/>
+ <ul>
+ <li class="fragment" style="margin-top: 1em;">mirrors physical devices</li>
+ <li class="fragment" style="margin-top: 1em;">provider of aspects+services around devices</li>
+ <li class="fragment" style="margin-top: 1em;">keep real and digital worlds in sync</li>
+ <li class="fragment" style="margin-top: 1em;">applicable for both industrial and consumer-centric IoT scenarios</li>
+ </ul>
+ </section>
+ <section id="twin-2" style="clear: both;">
+ <!-- background source: https://unsplash.com/search/cloud?photo=FIKD9t5_5zQ -->
+ <h2>in IIoT / Industry 4.0</h2>
+ <br/>
+ <ul style="float:left; width: 52%;">
+ <li style="margin-top: 1em;">asset administration shell ("Verwaltungsschale")</li>
+ <li style="margin-top: 2em;">holistic view of all capabilities (services) and aspects of an asset</li>
+ </ul>
+ <div style="float:right; width: 40%;">
+ <img src="../images/asset-admin-shell.png" style="width: 80%" alt="Asset admin shell" />
+ <div style="font-size: 0.4em;"><a href="http://acplt.github.io/openAAS/AssetAdministrationShell.html">Source</a></div>
+ </div>
+ <!-- img source: http://acplt.github.io/openAAS/AssetAdministrationShell.html -->
+ </section>
+ <section id="twin-3" style="clear: both;">
+ <h2>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: 1em;">single source of truth</li>
+ <li class="fragment" style="margin-top: 1em;">harmonization of data/state</li>
+ <li class="fragment" style="margin-top: 1em;">orchestration+authorization of aspects</li>
+ <li class="fragment" style="margin-top: 1em;">APIs - <b>Device as a Service</b></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>
+ <img src="../images/ditto-in-action.png" style="width: 75%" alt="Ditto in action"/>
+ </section>
+ <section id="ditto-2" style="clear: both;">
+ <h2>domain model</h2>
+ <ul style="font-size: 0.8em;">
+ <li>how does a <b>Digital Twin</b> in Eclipse Ditto look like?</li>
+ <li>KISS</li>
+ </ul>
+ <br />
+ <br />
+ <img src="../../images/pages/basic/ditto-class-diagram-v2.png" alt="Ditto class diagram v2" class="fragment"/>
+ <a href="https://www.eclipse.org/ditto/basic-overview.html#domain-model">→ docs</a>
+ </section>
+ <section id="ditto-3" style="clear: both;">
+ <h2>turn device data into API</h2>
+ <div style="text-align: left; float: left; width: 38%">
+ <pre style="width: 100%; font-size: 0.48em;"><code class="hljs json">{
+ "thingId": "namespace:car-1",
+ "acl": { ... },
+ "attributes": {
+ "manufacturer": "ACME corp",
+ "productionData": {
+ "serialNo": 4711
+ }
+ },
+ "features": {
+ "headlights": {
+ "properties": {
+ "on": false
+ }
+ }
+ }
+}</code></pre>
+ </div>
+ <div style="text-align: left; float: right; width: 60%" class="fragment">
+ <pre style="width: 105%; font-size: 0.48em;"><code class="hljs">GET/PUT/DELETE /api/1/things/namespace:car-1
+ /api/1/things/namespace:car-1/thingId
+ /api/1/things/namespace:car-1/acl
+ /api/1/things/namespace:car-1/attributes
+ /api/1/things/namespace:car-1/attributes/manufacturer
+ /api/1/things/namespace:car-1/attributes/productionData
+ /api/1/things/namespace:car-1/attributes/productionData/serialNo
+
+
+ /api/1/things/namespace:car-1/features
+ /api/1/things/namespace:car-1/features/headlights
+ /api/1/things/namespace:car-1/features/headlights/properties
+ /api/1/things/namespace:car-1/features/headlights/properties/on
+
+
+
+
+</code></pre>
+ <a href="https://www.eclipse.org/ditto/httpapi-concepts.html#endpoints" style="float: right;">→ docs</a>
+ </div>
+ </section>
+ <section id="ditto-4" style="clear: both;">
+ <h2>data harmonization</h2>
+ <br/>
+ <ul>
+ <li>devices send data in various formats</li>
+ <li class="fragment">Ditto structures data of <b>things</b> (attributes, features)</li>
+ <li class="fragment">devices shouldn't need to be aware of Ditto</li>
+ </ul>
+ <br/>
+ <br/>
+ <h3 class="fragment">device data received via AMQP can be transformed via a custom JavaScript function</h3>
+ </section>
+ <section id="ditto-5" style="clear: both">
+ <h2>Ditto Protocol API</h2>
+ <ul>
+ <li>JSON based text protocol for communicating with <b>Digital Twins</b> bidirectionally (commands/events)</li>
+ <li>via: WebSocket, AMQP 1.0 (e.g. Hono), AMQP 0.9.1</li>
+ </ul>
+ <pre style="width: 100%; font-size: 0.5em;"><code class="hljs json">{
+ "topic": "namespace/car-1/things/twin/events/modified",
+ "headers": { ... },
+ "path": "/features/headlights/properties",
+ "value": {
+ "on": true
+ },
+ "revision": 42
+}</code></pre>
+ <a href="https://www.eclipse.org/ditto/protocol-overview.html" style="float: right;">→ docs</a>
+ </section>
+ <section id="ditto-6" style="clear: both">
+ <h2>access control</h2>
+ <div style="text-align: left; float: left; width: 48%">
+ <h3>API v1: ACL</h3>
+ <pre style="width: 100%; font-size: 0.5em;"><code class="hljs json">"acl": {
+ "ditto": {
+ "READ": true,
+ "WRITE": false,
+ "ADMINISTRATE": false
+ },
+ "adam": {
+ "READ": true,
+ "WRITE": true,
+ "ADMINISTRATE": true
+ }
+}</code></pre>
+ <ul>
+ <li>inlined in Thing</li>
+ </ul>
+ </div>
+ <div style="text-align: left; float: right; width: 48%" class="fragment">
+ <h3>API v2: Policy</h3>
+ <pre style="width: 110%; font-size: 0.3em;"><code class="hljs">{
+ "policyId": "namespace:car-1-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-7" style="clear: both;">
+ <h2>twin vs. live</h2>
+ <br/>
+ <div style="text-align: left; float: left; width: 48%">
+ <img src="../../images/pages/protocol/ditto-twin-channel.png" alt="Ditto twin channel" />
+ <ul style="font-size: 0.7em">
+ <li>uses Ditto as persistence</li>
+ <li>Ditto enforces access control</li>
+ <li>Ditto processes commands, emits events</li>
+ </ul>
+ </div>
+ <div style="text-align: left; float: right; width: 48%" class="fragment">
+ <ul style="font-size: 0.7em">
+ <li>uses Ditto as router</li>
+ <li>Ditto enforces access control</li>
+ <li>endpoints process commands, emit events</li>
+ </ul>
+ <img src="../../images/pages/protocol/ditto-live-channel.png" alt="Ditto live channel" />
+ <a href="https://www.eclipse.org/ditto/protocol-twinlive.html" style="float: right;">→ docs</a>
+ </div>
+ </section>
+ <section id="ditto-8" style="clear: both;">
+ <h2>get notified about changes</h2>
+ <br/>
+ <div style="text-align: left; float: left; width: 48%">
+ <h3>via WebSocket</h3>
+ <pre style="width: 100%; font-size: 0.5em;"><code class="hljs javascript">var ws = new WebSocket(
+ "ws://u:p@ditto.eclipseprojects.io/ws/2");
+ws.onopen = function(w) {
+ w.send('START-SEND-EVENTS');
+};
+ws.onmessage = function(msg) {
+ console.log('received: ' + msg.data);
+};</code></pre>
+ <ul style="font-size: 0.7em">
+ <li>bidirectionally send/receive Ditto Protocol messages</li>
+ </ul>
+ <a href="https://www.eclipse.org/ditto/httpapi-protocol-bindings-websocket.html" style="float: right;">→ docs</a>
+ </div>
+ <div style="text-align: left; float: right; width: 48%" class="fragment">
+ <h3>via SSEs</h3>
+ <pre style="width: 100%; font-size: 0.5em;"><code class="hljs">var source = new EventSource(
+ "https://ditto.eclipseprojects.io/api/2/things?ids=namespace:car-1", { withCredentials: true });
+source.onmessage = function(msg) {
+ console.log('received: ' + msg.data);
+};</code></pre>
+ <ul style="font-size: 0.7em">
+ <li>unidirectionally receive changes in Thing JSON form</li>
+ </ul>
+ <a href="https://www.eclipse.org/ditto/httpapi-sse.html" style="float: right;">→ docs</a>
+ </div>
+ </section>
+ <section id="ditto-9" style="clear: both;">
+ <h2>get notified about changes</h2>
+ <br/>
+ <h3>notifications also possible via</h3>
+ <ul>
+ <li>AMQP <b>1.0</b> endpoint (e.g. Eclipse Hono)</li>
+ <li>AMQP <b>0.9.1</b> broker (e.g. RabbitMQ)</li>
+ </ul>
+ <h3 class="fragment" style="margin-top: 1em">Ditto manages connections to those since version 0.3.0-M1</h3>
+ <a href="https://www.eclipse.org/ditto/connectivity-overview.html" style="float: right;">→ docs</a>
+ </section>
+ <section id="ditto-10" 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">
+ <pre style="width: 100%; font-size: 0.5em;"><code class="hljs javascript">GET /api/1/search/things
+ ?filter=like(attributes/manufacturer,"ACME*")</code></pre>
+ <pre style="width: 100%; font-size: 0.5em;" class="fragment"><code class="hljs javascript">GET /api/1/search/things
+ ?filter=and(
+ exists(attributes/manufacturer),
+ eq(features/headlights/properties/on,true)
+ )
+ &namespaces=org.eclipse.ditto
+ &option=sort(-attributes/manufacturer)
+ &fields=thingId,attributes/manufacturer,_modified</code></pre>
+ </div>
+ <div class="fragment">
+ <ul style="font-size: 0.7em">
+ <li>search for arbitrary data with RQL query</li>
+ <li>Ditto enforces access control</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-11" style="clear: both;">
+ <h2>nonfunctional</h2>
+ <br/>
+ <div style="text-align: left; float: left; width: 48%">
+ <img src="../../images/pages/architecture/context-overview.png" alt="Ditto context overview" />
+ </div>
+ <div style="text-align: left; float: right; width: 52%">
+ <ul style="font-size: 0.8em">
+ <li >modular architecture of Ditto services</li>
+ <li style="margin-top: 0.5em;">horizontal scalability of each Ditto service</li>
+ <li style="margin-top: 0.5em;">runtime dependency to only MongoDB</li>
+ <li style="margin-top: 0.5em;">included monitoring (JVM metrics, roundtrips, MongoDB)</li>
+ <li style="margin-top: 0.5em;">prepared for operations (e.g. via devops commands)</li>
+ </ul>
+ </div>
+ </section>
+ </section>
+
+ <!-- Section: A framework for Digital Twins -->
+ <section style="clear: both;">
+ <section id="framework" class="new-chapter" data-background="../bg-images/background-framework-small.jpg"
+ data-state="chapter-background">
+ <!-- img background: https://unsplash.com/photos/FO7bKvgETgQ -->
+ <h1>A framework for Digital Twins</h1>
+ <br/>
+ <h2>acting as a Twin orchestrator</h2>
+ </section>
+
+ <section id="framework-1" style="clear: both;">
+ <h2>orchestration via messages</h2>
+ <br/>
+ <div style="text-align: left; float: left; width: 38%">
+ <ul style="font-size: 0.7em">
+ <li>Ditto as router of messages (via "live" channel)</li>
+ <li>enforcement of access control</li>
+ <li>correlation of command/response (e.g. for HTTP)</li>
+ <!--<li>device-to-cloud,cloud-to-device,device-to-device,cloud-to-cloud</li>-->
+ </ul>
+ </div>
+ <div style="text-align: left; float: right; width: 58%">
+ <img src="../../images/pages/basic/ditto-messages.png" alt="Ditto messages" />
+ </div>
+ <ul>
+ <li>enhance the API of a Digital Twin by a custom WebSocket consumer</li>
+ </ul>
+ </section>
+
+ <section id="framework-2" style="clear: both;">
+ <h2>examples for orchestrations</h2>
+ <br/>
+ <ul style="font-size: 0.9em;">
+ <li>enhance a location-aware Twin with the current weather</li>
+ <li>enhance a Twin with an API for its known spare parts</li>
+ </ul>
+ <br/>
+ <br/>
+ <img src="../images/ditto-orchestration-examples.png" style="width: 60%" alt="Ditto orchestration example" />
+ </section>
+ </section>
+
+ <!-- Section: Demo -->
+ <section style="clear: both;">
+ <section id="demo" class="new-chapter" data-background="../bg-images/background-demo-small.jpg" data-state="chapter-background">
+ <h1>Demo time!</h1>
+ <br/>
+ <h3><a href="https://github.com/eclipse/ditto-examples/tree/master/octopus-via-hono">GitHub sources</a></h3>
+ </section>
+ </section>
+
+ <!-- Section: Wrap up + Roadmap -->
+ <section style="clear: both;">
+ <section id="wrap-up" style="clear: both;">
+ <h1>Wrap up</h1>
+ <br/>
+ <ul>
+ <li class="fragment">Digital Twins as pattern for simplifying IoT back-end development</li>
+ <li class="fragment" style="margin-top: 1em;">Mission: provide Device-as-a-Service</li>
+ <li class="fragment" style="margin-top: 1em;">Eclipse Ditto as framework for Digital Twins</li>
+ </ul>
+ </section>
+
+ <section id="wrap-up-1" style="clear: both;">
+ <h2>Roadmap 2018</h2>
+ <br/>
+ <ul>
+ <li>release (non-milestone)</li>
+ <li style="margin-top: 1em;">using <b>Eclipse Vorto</b> generator for validation</li>
+ <li style="margin-top: 1em;">mapping raw payloads to/from Ditto Protocol <i class="fas fa-check" style="color: green"></i></li>
+ <li style="margin-top: 1em;">attracting IoT developers in using Ditto</li>
+ <li style="margin-top: 1em;">integration with other OSS projects</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: 37%">
+ <img src="../images/bosch-iot-things.png" style="width: 100%" alt="Bosch IoT Things" />
+ <h4>freemium model</h4>
+ <h4>+operated 24/7</h4>
+ <h4>+support</h4>
+ <h4>+some features</h4>
+ </div>
+ <div style="text-align: left; float: right; width: 63%">
+ <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 Diana and codecentric for hosting this meetup</h3>
+ <br/>
+ <br/>
+ <h1>Q & A</h1>
+ </section>
+ </section>
+ </div>
+
+</div>
+
+<div class="footer">
+ Copyright ©2018
+ <a href="https://www.bosch-si.com" target="_blank">Bosch Software Innovations GmbH</a> All rights reserved. |
+ <a href="https://www.bosch.com/terms-of-use/terms-of-use/provider/" target="_blank">Imprint</a> |
+ <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.eclipseprojects.io" 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/2.0/slides/2018_10_22-eclipse-iot-wg-f2f-ludwigsburg/index.html b/2.0/slides/2018_10_22-eclipse-iot-wg-f2f-ludwigsburg/index.html
new file mode 100644
index 0000000..3711b9d
--- /dev/null
+++ b/2.0/slides/2018_10_22-eclipse-iot-wg-f2f-ludwigsburg/index.html
@@ -0,0 +1,397 @@
+<!--
+ ~ Copyright (c) 2017 Contributors to the Eclipse Foundation
+ ~
+ ~ See the NOTICE file(s) distributed with this work for additional
+ ~ information regarding copyright ownership.
+ ~
+ ~ This program and the accompanying materials are made available under the
+ ~ terms of the Eclipse Public License 2.0 which is available at
+ ~ http://www.eclipse.org/legal/epl-2.0
+ ~
+ ~ SPDX-License-Identifier: EPL-2.0
+ -->
+
+<!doctype html>
+<html lang="en">
+
+<head>
+ <meta charset="utf-8">
+
+ <title>EclipseCon 2018 Ludwigsburg - Eclipse Ditto status</title>
+
+ <meta name="description" content="EclipseCon 2018 Ludwigsburg - Eclipse Ditto status">
+ <meta name="author" content="Thomas Jäckle">
+ <meta name="date" content="2018-10-22">
+ <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%;
+ }
+
+ #header-right {
+ position: absolute;
+ top: 0%;
+ right: 0%;
+ }
+
+ .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/eclipse_iot_logo.png"
+ style="width: 150px; 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 -->
+ <br/>
+ <h1 style="font: 2.5em Helvetica, sans-serif;">Eclipse <img src="../../images/ditto.svg" style="width: 20%;" alt="Ditto logo"> status</h1>
+ <br/>
+ <br/>
+ <br/>
+ <h2 style="font-size: 1.2em">EclipseCon 2018 Ludwigsburg</h2>
+ <h2 style="font-size: 1.2em">22.10.2018</h2>
+ <br style="clear: both"/>
+ </section>
+ </section>
+
+ <!-- Section: Status -->
+ <section style="clear: both;">
+ <section id="status-0" style="clear: both;">
+ <!-- background source: http://wallpapercave.com/wp/WkziiJQ.jpg -->
+ <h2>Project overview</h2>
+ <br/>
+ <div style="margin-left: -10%; float: left; width: 60%">
+ <img src="../images/ditto-in-action.png" style="width: 100%" alt="Ditto in action"/>
+ </div>
+ <div style="text-align: left; float: right; width: 50%">
+ <br />
+ <ul style="font-size: 0.9em;">
+ <li class="fragment">Device-as-a-Service</li>
+ <li class="fragment" style="margin-top: 0.5em;">state and population management for <b>digital twins</b>
+ </li>
+ <li class="fragment" style="margin-top: 0.5em;">digital twin orchestration framework</li>
+ </ul>
+ </div>
+ </section>
+ <section id="status-1" style="clear: both;">
+ <h2>Stats</h2>
+ <br/>
+ <table style="font-size: 0.9em;">
+ <tr>
+ <td>Github stars</td>
+ <td>65</td>
+ </tr>
+ <tr>
+ <td>Docker image pulls</td>
+ <td><a href="https://hub.docker.com/search/?isAutomated=0&isOfficial=0&page=1&pullCount=0&q=eclipse%2Fditto-&starCount=0">~ 1.200</a></td>
+ </tr>
+ <tr>
+ <td>Committers</td>
+ <td>8 (all from Bosch)</td>
+ </tr>
+ <tr>
+ <td>Contributors</td>
+ <td>no significant ext. contributions</td>
+ </tr>
+ <tr>
+ <td>Questions via GitHub</td>
+ <td><a href="https://github.com/eclipse/ditto/issues?utf8=✓&q=is%3Aissue+label%3Aquestion+">15</a>
+ (increasing interest)
+ </td>
+ </tr>
+ <tr>
+ <td>Questions via Gitter.im</td>
+ <td>a few (tens)</td>
+ </tr>
+ </table>
+ </section>
+ <section id="status-2" style="clear: both;">
+ <h2>Plan</h2>
+ <ul>
+ <li>first release <a href="https://projects.eclipse.org/projects/iot.ditto/releases/0.8.0">0.8.0</a> in the next weeks
+ <ul>
+ <li class="fragment" style="margin-top: 0.5em;">waiting for the last CQ (Type-B) to be approved, fallback to Type-A release</li>
+ <li class="fragment" style="margin-top: 0.5em;">key features: digital twin framework with well-defined APIs and out-of-the-box
+ connectivity to Eclipse Hono + MQTT brokers</li>
+ </ul>
+ </li>
+ <li class="fragment" style="margin-top: 0.5em;">next year: road towards 1.0.0 - main features: reported/desired state, type enforcement</li>
+ </ul>
+ </section>
+ <section id="status-3" style="clear: both;">
+ <h2>Challenges</h2>
+ <br/>
+ <ul>
+ <li>term "digital twins" mostly seen as marketing buzzword</li>
+ <li class="fragment" style="margin-top: 0.5em;">attracting users who don't yet know they would benefit from "digital twin" framework</li>
+ <li class="fragment" style="margin-top: 0.5em;">contributions are still unlikely, focus is on finding users</li>
+ </ul>
+ </section>
+ <section id="status-4" style="clear: both;">
+ <h2>Collaboration</h2>
+ <br/>
+ <ul>
+ <li class="fragment">Eclipse Hono: ✔<br/>(telemetry/events/command&control)</li>
+ <li class="fragment" style="margin-top: 0.5em;">Eclipse Mosquitto: ✔<br/>(connection to MQTT 3.1.1 brokers)</li>
+ <li class="fragment" style="margin-top: 0.5em;">Eclipse Vorto:<br/>on our agenda to integrate in order to
+ validate structure of digital twins: <a href="https://github.com/eclipse/ditto/issues/107">#107</a>, <a href="https://github.com/eclipse/ditto/issues/247">#247</a></li>
+ </ul>
+ </section>
+ </section>
+ </div>
+
+</div>
+
+<div class="footer">
+ Copyright ©2018
+ <a href="https://www.bosch-si.com" target="_blank">Bosch Software Innovations GmbH</a> All rights reserved. |
+ <a href="https://www.bosch.com/terms-of-use/terms-of-use/provider/" target="_blank">Imprint</a> |
+ <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.eclipseprojects.io" 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/2.0/slides/2019_10_21-eclipse-iot-wg-f2f-ludwigsburg/index.html b/2.0/slides/2019_10_21-eclipse-iot-wg-f2f-ludwigsburg/index.html
new file mode 100644
index 0000000..33709e6
--- /dev/null
+++ b/2.0/slides/2019_10_21-eclipse-iot-wg-f2f-ludwigsburg/index.html
@@ -0,0 +1,404 @@
+<!--
+ ~ Copyright (c) 2019 Contributors to the Eclipse Foundation
+ ~
+ ~ See the NOTICE file(s) distributed with this work for additional
+ ~ information regarding copyright ownership.
+ ~
+ ~ This program and the accompanying materials are made available under the
+ ~ terms of the Eclipse Public License 2.0 which is available at
+ ~ http://www.eclipse.org/legal/epl-2.0
+ ~
+ ~ SPDX-License-Identifier: EPL-2.0
+ -->
+
+<!doctype html>
+<html lang="en">
+
+<head>
+ <meta charset="utf-8">
+
+ <title>EclipseCon 2019 Ludwigsburg - Eclipse Ditto status</title>
+
+ <meta name="description" content="EclipseCon 2019 Ludwigsburg - Eclipse Ditto status">
+ <meta name="author" content="Thomas Jäckle">
+ <meta name="date" content="2018-10-22">
+ <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%;
+ }
+
+ #header-right {
+ position: absolute;
+ top: 0%;
+ right: 0%;
+ }
+
+ .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/eclipse_iot_logo.png"
+ style="width: 150px; 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-eagle-small.jpg"
+ data-state="chapter-background">
+ <!-- background source: https://unsplash.com/photos/OjE4RtaibFc -->
+ <br/>
+ <div style="margin-left: -10%; float: left; width: 60%">
+ <h1 style="font: 2.0em Helvetica, sans-serif;"><img src="../../images/ditto.svg" style="width: 30%; padding-top: 0.5em;" alt="Eclipse Ditto"></h1>
+ <br/>
+ <h2 style="font-size: 1.0em">Status @ EclipseCon 2019 Ludwigsburg</h2>
+ <h2 style="font-size: 1.0em">21.10.2019</h2>
+ </div>
+
+ <br style="clear: both"/>
+
+ </section>
+ </section>
+
+ <!-- Section: Status -->
+ <section style="clear: both;">
+ <section id="status-0" style="clear: both;">
+ <h2>Project overview</h2>
+ <br/>
+ <div style="margin-left: -5%; float: left; width: 55%">
+ <img src="../images/ditto-in-action-2019.png" style="width: 100%" alt="Ditto in action"/>
+ </div>
+ <div style="margin-top: -5%;text-align: left; float: right; width: 50%">
+ <br />
+ <ul style="font-size: 0.9em;">
+ <li class="fragment">utilizing <b>digital twin</b> pattern in between IoT solutions and their devices
+ </li>
+ <li class="fragment" style="margin-top: 0.5em;">Device-as-a-Service</li>
+ <li class="fragment" style="margin-top: 0.5em;">features: authorization, search capabilities, notifications (+filtering), integrations, payload mapping, ...</li>
+ </ul>
+ </div>
+ </section>
+ <section id="status-1" style="clear: both;">
+ <h2>Stats</h2>
+ <br/>
+ <table style="font-size: 0.9em;">
+ <tr>
+ <td></td>
+ <th>2018</th>
+ <th>2019</th>
+ </tr>
+ <tr>
+ <td>Github stars</td>
+ <td>65</td>
+ <td>117</td>
+ </tr>
+ <tr>
+ <td>Docker image pulls</td>
+ <td><a href="https://hub.docker.com/search/?isAutomated=0&isOfficial=0&page=1&pullCount=0&q=eclipse%2Fditto-&starCount=0">~ 1.200</a></td>
+ <td><a href="https://hub.docker.com/search/?isAutomated=0&isOfficial=0&page=1&pullCount=0&q=eclipse%2Fditto-&starCount=0">~ 3.200</a></td>
+ </tr>
+ <tr>
+ <td>Active committers</td>
+ <td>8</td>
+ <td>9</td>
+ </tr>
+ <tr>
+ <td>Adopters</td>
+ <td>1</td>
+ <td>3</td>
+ </tr>
+ <tr>
+ <td>Contributors</td>
+ <td>-</td>
+ <td>~ 3</td>
+ </tr>
+ </table>
+ <h4 class="fragment" style="margin-top: 1em;">More and more questions raised via <a href="https://stackoverflow.com/questions/tagged/eclipse-ditto">Stackoverflow</a>, Gitter.im</h4>
+ </section>
+ <section id="status-2" style="clear: both;">
+ <h2>Achievements last year</h2>
+ <h4 style="text-align: left">releases:</h4>
+ <ul>
+ <li class="fragment" style="font-size: 0.9em; margin-top: 0.5em;"><a href="https://projects.eclipse.org/projects/iot.ditto/releases/0.8.0">0.8.0</a>:
+ Initial release - digital twin framework connectivity to Eclipse Hono + MQTT brokers
+ </li>
+ <li class="fragment" style="font-size: 0.9em; margin-top: 0.5em;"><a href="https://projects.eclipse.org/projects/iot.ditto/releases/0.9.0">0.9.0</a>:
+ Apache Kafka integration, memory/performance improvements, Helm template</li>
+ </ul>
+ <h4 class="fragment" style="text-align: left; margin-top: 0.8em;">scalability successfully tested (tbd: share in blogpost)</h4>
+ <h4 class="fragment" style="text-align: left;">we learned the Eclipse processes</h4>
+ </section>
+ <section id="status-3" style="clear: both;">
+ <h2>Plan</h2>
+ <h4 style="text-align: left">graduation and release of <a href="https://projects.eclipse.org/projects/iot.ditto/releases/1.0.0">1.0.0</a>:</h4>
+ <ul>
+ <li class="fragment" style="font-size: 0.9em; margin-top: 0.5em;">using OpenID connect auth providers via config</li>
+ <li class="fragment" style="font-size: 0.9em; margin-top: 0.5em;">Ditto Java and JavaScript client</li>
+ <li class="fragment" style="font-size: 0.9em; margin-top: 0.5em;">improvements on scalability</li>
+ <li class="fragment" style="font-size: 0.9em; margin-top: 0.5em;">improvements on Eclipse Hono integration (e.g. reflect connection state in device twins)</li>
+ </ul>
+ <h4 class="fragment" style="text-align: left; margin-top: 0.5em;">Eclipse IoT Packages: contributing Ditto Helm
+ templates and pre-defined connection to Hono for "Package Zero"</h4>
+ </section>
+ <section id="status-4" style="clear: both;">
+ <h2>Challenges</h2>
+ <br/>
+ <ul>
+ <li>adoption gaining only slowly, difficult to attract users who don't yet know they would benefit from "digital twin" framework</li>
+ <li class="fragment" style="margin-top: 0.5em;">contribution of new functionality has high barrier (huge codebase, async programming pattern, used actor framework)</li>
+ </ul>
+ </section>
+ </section>
+ </div>
+
+</div>
+
+<div class="footer">
+ Copyright ©2018
+ <a href="https://www.bosch-si.com" target="_blank">Bosch Software Innovations GmbH</a> All rights reserved. |
+ <a href="https://www.bosch.com/terms-of-use/terms-of-use/provider/" target="_blank">Imprint</a> |
+ <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.eclipseprojects.io" 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/2.0/slides/2020_04_16-ttn-virtual-conference/index.html b/2.0/slides/2020_04_16-ttn-virtual-conference/index.html
new file mode 100644
index 0000000..404f198
--- /dev/null
+++ b/2.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.eclipseprojects.io" 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/2.0/slides/2020_07_28-iot-wg-status-update/index.html b/2.0/slides/2020_07_28-iot-wg-status-update/index.html
new file mode 100644
index 0000000..4d62558
--- /dev/null
+++ b/2.0/slides/2020_07_28-iot-wg-status-update/index.html
@@ -0,0 +1,410 @@
+<!doctype html>
+<html lang="en">
+
+<head>
+ <meta charset="utf-8">
+
+ <title>Eclipse Ditto: Eclipse IoT WG status update</title>
+
+ <meta name="description" content="Eclipse Ditto: Eclipse IoT WG status update">
+ <meta name="author" content="Thomas Jäckle">
+ <meta name="date" content="2020-07-28">
+ <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/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: 2em; padding-top: 1em">Eclipse Ditto</h1>
+ <h1 style="font-size: 1.5em;">Eclipse IoT WG status update</h1>
+ <h2 style="font-size: 0.8em">28.07.2020</h2>
+ </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;">applicable for both industrial and consumer-centric IoT scenarios</li>
+ </ul>
+ </section>
+ </section>
+
+ <section id="status-1" style="clear: both;">
+ <h2>Ditto 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="status-2" style="clear: both;">
+ <h2>Stats</h2>
+ <br/>
+ <table style="font-size: 0.9em;">
+ <tr>
+ <td></td>
+ <th>2018 (oct)</th>
+ <th>2019 (oct)</th>
+ <th>2020 (jul)</th>
+ </tr>
+ <tr>
+ <td>Github stars</td>
+ <td>65</td>
+ <td>117</td>
+ <td>178</td>
+ </tr>
+ <tr>
+ <td>Docker image pulls</td>
+ <td><a href="https://hub.docker.com/search/?isAutomated=0&isOfficial=0&page=1&pullCount=0&q=eclipse%2Fditto-&starCount=0">~ 1.200</a></td>
+ <td><a href="https://hub.docker.com/search/?isAutomated=0&isOfficial=0&page=1&pullCount=0&q=eclipse%2Fditto-&starCount=0">~ 3.200</a></td>
+ <td><a href="https://hub.docker.com/search/?isAutomated=0&isOfficial=0&page=1&pullCount=0&q=eclipse%2Fditto-&starCount=0">~ 10.000</a></td>
+ </tr>
+ <tr>
+ <td>Active committers</td>
+ <td>8</td>
+ <td>9</td>
+ <td>8</td>
+ </tr>
+ <tr>
+ <td>Adopters</td>
+ <td>1</td>
+ <td>3</td>
+ <td>6</td>
+ </tr>
+ <tr>
+ <td>Contributors</td>
+ <td>-</td>
+ <td>~ 3</td>
+ <td>~ 8 (3 ext)</td>
+ </tr>
+ </table>
+ <h4 class="fragment" style="margin-top: 1em;">+ bigger contributions by our community</h4>
+ </section>
+
+ <section id="status-3" style="clear: both;">
+ <h2>Achievements</h2>
+ <br/>
+ <ul>
+ <li class="fragment" style="font-size: 0.9em; margin-top: 0.5em;"><a href="https://projects.eclipse.org/projects/iot.ditto/releases/1.0.0">1.0.0 (12/2019)</a>:
+ Graduation release; Ditto Java + JS client; invoking HTTP web hooks; performance improvements
+ </li>
+ <li class="fragment" style="font-size: 0.9em; margin-top: 0.5em;"><a href="https://projects.eclipse.org/projects/iot.ditto/releases/1.1.0">1.1.0 (04/2020)</a>:
+ MQTT 5; message enrichment; Java 11 runtime; policies+search in Ditto Protocol
+ </li>
+ <li class="fragment" style="font-size: 0.9em; margin-top: 0.5em;">
+ Eclipse IoT Packages:
+ <ul>
+ <li>added Helm chart with support of community</li>
+ <li>setup auto connection of Ditto to Hono in c2e package</li>
+ </ul>
+ </li>
+ </ul>
+ <h4 style="text-align: left; margin-top: 1em;" class="fragment">LoRaWAN Virtual Conference:
+ <a href="https://www.eclipse.org/ditto/slides/2020_04_16-ttn-virtual-conference/">workshop</a> +
+ <a href="https://youtu.be/D33JrN2RWiI">YouTube recording</a>
+ </h4>
+ </section>
+
+ <!-- Section: Roadmap -->
+ <section id="status-4" style="clear: both;">
+ <h2>Roadmap</h2>
+ <ul>
+ <li style="font-size: 0.9em; margin-top: 0.5em;"><a href="https://projects.eclipse.org/projects/iot.ditto/releases/1.2.0">1.2.0 (08/2020)</a>:
+ <ul>
+ <li class="fragment">QoS 1 (at least once) processing of async. consumed messages</li>
+ <li class="fragment">"_metadata" for digital twins</li>
+ <li class="fragment">.. several smaller things</li>
+ </ul>
+ </li>
+ <li class="fragment" style="font-size: 0.9em; margin-top: 0.5em;">outlook:
+ <ul>
+ <li>conditional modification of twins</li>
+ <li>partial updates (PATCH) of twins</li>
+ <li>reported/desired epic</li>
+ <li>Ditto Golang client</li>
+ </ul>
+ </li>
+ </ul>
+ </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.eclipseprojects.io" 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/2.0/slides/2020_10_19-eclipse-iot-wg-community-day/index.html b/2.0/slides/2020_10_19-eclipse-iot-wg-community-day/index.html
new file mode 100644
index 0000000..7c9fb91
--- /dev/null
+++ b/2.0/slides/2020_10_19-eclipse-iot-wg-community-day/index.html
@@ -0,0 +1,458 @@
+<!doctype html>
+<html lang="en">
+
+<head>
+ <meta charset="utf-8">
+
+ <title>EclipseCon 2020 - Eclipse Ditto status</title>
+
+ <meta name="description" content="EclipseCon 2020 - Eclipse Ditto status">
+ <meta name="author" content="Thomas Jäckle">
+ <meta name="date" content="2020-10-19">
+ <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/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-eagle-small.jpg"
+ data-state="chapter-background">
+ <!-- background source: https://unsplash.com/photos/OjE4RtaibFc -->
+ <br/>
+ <div style="margin-left: -10%; float: left; width: 60%">
+ <h1 style="font: 2.0em Helvetica, sans-serif;"><img src="../../images/ditto.svg"
+ style="width: 30%; padding-top: 0.5em;"
+ alt="Eclipse Ditto"></h1>
+ <br/>
+ <h2 style="font-size: 1.0em">Status @ EclipseCon 2020 Ludwigsburg</h2>
+ <h2 style="font-size: 1.0em">19.10.2020</h2>
+ </div>
+
+ <br style="clear: both"/>
+
+ </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;">applicable for both industrial and consumer-centric IoT
+ scenarios
+ </li>
+ </ul>
+ </section>
+ </section>
+
+ <section id="status-1" style="clear: both;">
+ <h2>Ditto 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="status-2" style="clear: both;">
+ <h2>Stats</h2>
+ <br/>
+ <table style="font-size: 0.9em;">
+ <tr>
+ <td></td>
+ <th>2018 (oct)</th>
+ <th>2019 (oct)</th>
+ <th>2020 (oct)</th>
+ </tr>
+ <tr>
+ <td>Github stars</td>
+ <td>65</td>
+ <td>117</td>
+ <td>204</td>
+ </tr>
+ <tr>
+ <td>Docker image pulls</td>
+ <td><a
+ href="https://hub.docker.com/search/?isAutomated=0&isOfficial=0&page=1&pullCount=0&q=eclipse%2Fditto-&starCount=0">~
+ 1.200</a></td>
+ <td><a
+ href="https://hub.docker.com/search/?isAutomated=0&isOfficial=0&page=1&pullCount=0&q=eclipse%2Fditto-&starCount=0">~
+ 3.200</a></td>
+ <td><a
+ href="https://hub.docker.com/search/?isAutomated=0&isOfficial=0&page=1&pullCount=0&q=eclipse%2Fditto-&starCount=0">~
+ 10.000</a></td>
+ </tr>
+ <tr>
+ <td>Active committers</td>
+ <td>8</td>
+ <td>9</td>
+ <td>8</td>
+ </tr>
+ <tr>
+ <td>Adopters</td>
+ <td>1</td>
+ <td>3</td>
+ <td>6</td>
+ </tr>
+ <tr>
+ <td>Contributors</td>
+ <td>-</td>
+ <td>~ 3</td>
+ <td>~ 8 (3 ext)</td>
+ </tr>
+ </table>
+ <h4 class="fragment" style="margin-top: 1em;">+ bigger contributions by our community</h4>
+ </section>
+
+ <section id="status-3" style="clear: both;">
+ <h2>Achievements</h2>
+ <br/>
+ <ul>
+ <li class="fragment" style="font-size: 0.9em; margin-top: 0.5em;"><a
+ href="https://projects.eclipse.org/projects/iot.ditto/releases/1.0.0">1.0.0 (12/2019)</a>:
+ Graduation release; Ditto Java + JS client; invoking HTTP web hooks; performance improvements
+ </li>
+ <li class="fragment" style="font-size: 0.9em; margin-top: 0.5em;"><a
+ href="https://projects.eclipse.org/projects/iot.ditto/releases/1.1.0">1.1.0 (04/2020)</a>:
+ MQTT 5; message enrichment; Java 11 runtime; policies+search in Ditto Protocol
+ </li>
+ <li class="fragment" style="font-size: 0.9em; margin-top: 0.5em;"><a
+ href="https://projects.eclipse.org/projects/iot.ditto/releases/1.2.0">1.2.0 (08/2020)</a>:
+ QoS 1 ("at least once") message processing; "_metadata" for twins
+ </li>
+ <li class="fragment" style="font-size: 0.9em; margin-top: 0.5em;"><a
+ href="https://projects.eclipse.org/projects/iot.ditto/releases/1.3.0">1.3.0 (09/2020)</a>:
+ Message mapping enhancements; bugfixes
+ </li>
+ </ul>
+ </section>
+ <section id="status-3a" style="clear: both;">
+ <h2>Achievements</h2>
+ <br/>
+ <ul>
+ <li style="font-size: 0.9em; margin-top: 0.5em;">
+ Eclipse IoT Packages:
+ <ul>
+ <li>added Helm chart with support of community</li>
+ <li>setup auto connection of Ditto to Hono in c2e package</li>
+ </ul>
+ </li>
+ <li class="fragment" style="font-size: 0.9em; margin-top: 0.5em;">
+ Initial contribution of a <a href="https://github.com/eclipse/ditto-clients-golang/">Ditto Golang client</a>
+ </li>
+ </ul>
+ <h4 style="text-align: left; margin-top: 1em;" class="fragment">LoRaWAN Virtual Conference:
+ <a href="https://www.eclipse.org/ditto/slides/2020_04_16-ttn-virtual-conference/">workshop</a> +
+ <a href="https://youtu.be/D33JrN2RWiI">YouTube recording</a>
+ </h4>
+ </section>
+
+ <!-- Section: Obstacles -->
+ <section id="status-4" style="clear: both;">
+ <h2>Obstacles</h2>
+ <br/>
+ <br/>
+ <br/>
+ <ul>
+ <li style="font-size: 0.9em; margin-top: 0.5em;">still rather moderate adoption rate</li>
+ </ul>
+ <br/>
+ <br/>
+ </section>
+
+ <!-- Section: Roadmap -->
+ <section id="status-5" style="clear: both;">
+ <h2>Roadmap</h2>
+ <ul>
+ <li style="font-size: 0.9em; margin-top: 0.5em;"><a href="https://github.com/eclipse/ditto/milestone/26">1.4.0
+ (12/2020)</a>:
+ <ul>
+ <li class="fragment">enhance twin by "desired" properties</li>
+ <li class="fragment">QoS 1 / acknowledgement improvements</li>
+ <li class="fragment">merge updates (PATCH) on twins</li>
+ </ul>
+ </li>
+ <li class="fragment" style="font-size: 0.9em; margin-top: 0.5em;">outlook:
+ <ul>
+ <li>topics around "desired" state handling</li>
+ <li>conditional modification of twins</li>
+ <li>consuming messages from Apache Kafka</li>
+ </ul>
+ </li>
+ </ul>
+ </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.eclipseprojects.io" 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/2.0/slides/bg-images/background-cloud-small.jpg b/2.0/slides/bg-images/background-cloud-small.jpg
new file mode 100644
index 0000000..1f18bb9
--- /dev/null
+++ b/2.0/slides/bg-images/background-cloud-small.jpg
Binary files differ
diff --git a/2.0/slides/bg-images/background-conclusion-small.jpg b/2.0/slides/bg-images/background-conclusion-small.jpg
new file mode 100644
index 0000000..74516db
--- /dev/null
+++ b/2.0/slides/bg-images/background-conclusion-small.jpg
Binary files differ
diff --git a/2.0/slides/bg-images/background-demo-small.jpg b/2.0/slides/bg-images/background-demo-small.jpg
new file mode 100644
index 0000000..9cf3bce
--- /dev/null
+++ b/2.0/slides/bg-images/background-demo-small.jpg
Binary files differ
diff --git a/2.0/slides/bg-images/background-eagle-small.jpg b/2.0/slides/bg-images/background-eagle-small.jpg
new file mode 100755
index 0000000..98749ae
--- /dev/null
+++ b/2.0/slides/bg-images/background-eagle-small.jpg
Binary files differ
diff --git a/2.0/slides/bg-images/background-framework-small.jpg b/2.0/slides/bg-images/background-framework-small.jpg
new file mode 100644
index 0000000..373e992
--- /dev/null
+++ b/2.0/slides/bg-images/background-framework-small.jpg
Binary files differ
diff --git a/2.0/slides/bg-images/background-outlook-small.jpg b/2.0/slides/bg-images/background-outlook-small.jpg
new file mode 100644
index 0000000..898708a
--- /dev/null
+++ b/2.0/slides/bg-images/background-outlook-small.jpg
Binary files differ
diff --git a/2.0/slides/bg-images/background-twin-small.jpg b/2.0/slides/bg-images/background-twin-small.jpg
new file mode 100644
index 0000000..bcc4b1a
--- /dev/null
+++ b/2.0/slides/bg-images/background-twin-small.jpg
Binary files differ
diff --git a/2.0/slides/images/Javascript_badge.svg b/2.0/slides/images/Javascript_badge.svg
new file mode 100755
index 0000000..1774518
--- /dev/null
+++ b/2.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/2.0/slides/images/asset-admin-shell.png b/2.0/slides/images/asset-admin-shell.png
new file mode 100644
index 0000000..55377f5
--- /dev/null
+++ b/2.0/slides/images/asset-admin-shell.png
Binary files differ
diff --git a/2.0/slides/images/bosch-iot-things-2020.png b/2.0/slides/images/bosch-iot-things-2020.png
new file mode 100755
index 0000000..3ce43bf
--- /dev/null
+++ b/2.0/slides/images/bosch-iot-things-2020.png
Binary files differ
diff --git a/2.0/slides/images/bosch-iot-things.png b/2.0/slides/images/bosch-iot-things.png
new file mode 100644
index 0000000..e5ef449
--- /dev/null
+++ b/2.0/slides/images/bosch-iot-things.png
Binary files differ
diff --git a/2.0/slides/images/ditto-in-action-2019.png b/2.0/slides/images/ditto-in-action-2019.png
new file mode 100755
index 0000000..55e2a06
--- /dev/null
+++ b/2.0/slides/images/ditto-in-action-2019.png
Binary files differ
diff --git a/2.0/slides/images/ditto-in-action-2020.png b/2.0/slides/images/ditto-in-action-2020.png
new file mode 100755
index 0000000..b02de70
--- /dev/null
+++ b/2.0/slides/images/ditto-in-action-2020.png
Binary files differ
diff --git a/2.0/slides/images/ditto-in-action.png b/2.0/slides/images/ditto-in-action.png
new file mode 100644
index 0000000..a23f52f
--- /dev/null
+++ b/2.0/slides/images/ditto-in-action.png
Binary files differ
diff --git a/2.0/slides/images/ditto-orchestration-examples.png b/2.0/slides/images/ditto-orchestration-examples.png
new file mode 100644
index 0000000..f8a957b
--- /dev/null
+++ b/2.0/slides/images/ditto-orchestration-examples.png
Binary files differ
diff --git a/2.0/slides/images/eclipse_iot_logo.png b/2.0/slides/images/eclipse_iot_logo.png
new file mode 100644
index 0000000..3927dbe
--- /dev/null
+++ b/2.0/slides/images/eclipse_iot_logo.png
Binary files differ
diff --git a/2.0/slides/images/meme-dino.jpg b/2.0/slides/images/meme-dino.jpg
new file mode 100644
index 0000000..99d22da
--- /dev/null
+++ b/2.0/slides/images/meme-dino.jpg
Binary files differ
diff --git a/2.0/slides/images/thjaeckle_400x400.jpg b/2.0/slides/images/thjaeckle_400x400.jpg
new file mode 100644
index 0000000..b6af202
--- /dev/null
+++ b/2.0/slides/images/thjaeckle_400x400.jpg
Binary files differ
diff --git a/2.0/slides/images/ttn-ditto-via-mqtt.png b/2.0/slides/images/ttn-ditto-via-mqtt.png
new file mode 100755
index 0000000..1918ed7
--- /dev/null
+++ b/2.0/slides/images/ttn-ditto-via-mqtt.png
Binary files differ
diff --git a/2.0/slides/images/ttn-hono-ditto.png b/2.0/slides/images/ttn-hono-ditto.png
new file mode 100755
index 0000000..914c5a8
--- /dev/null
+++ b/2.0/slides/images/ttn-hono-ditto.png
Binary files differ
diff --git a/2.0/slides/images/ttn-logo.png b/2.0/slides/images/ttn-logo.png
new file mode 100755
index 0000000..37a90d4
--- /dev/null
+++ b/2.0/slides/images/ttn-logo.png
Binary files differ
diff --git a/2.0/tag_advanced.html b/2.0/tag_advanced.html
new file mode 100644
index 0000000..9246e36
--- /dev/null
+++ b/2.0/tag_advanced.html
@@ -0,0 +1,2695 @@
+<!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=" ">
+<title> Advanced topics • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Advanced topics">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Advanced topics</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>The following pages and posts are tagged with <button type="button" style="cursor: default" class="btn btn-default navbar-btn">advanced</button></p>
+<table><thead><tr><th>Title</th><th>Type</th><th>Excerpt</th></tr></thead>
+ <tbody>
+
+
+
+
+
+
+
+ <tr><td><a href="advanced-data-by-pass.html">Data By-Pass Pattern</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> This pattern centers around the idea to delegate the data transmission to external services, by-passing the Ditto cluster, while still being able to benefit from Ditto’s policy system and IoT architecture. Context You have services exposing their functionality transparently though Ditto’s messaging API as part of your digital... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ </tbody>
+</table>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/tag_architecture.html b/2.0/tag_architecture.html
new file mode 100644
index 0000000..e8690a2
--- /dev/null
+++ b/2.0/tag_architecture.html
@@ -0,0 +1,2743 @@
+<!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=" ">
+<title> Architecture topics • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Architecture topics">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Architecture topics</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>The following pages and posts are tagged with <button type="button" style="cursor: default" class="btn btn-default navbar-btn">architecture</button></p>
+<table><thead><tr><th>Title</th><th>Type</th><th>Excerpt</th></tr></thead>
+ <tbody>
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="architecture-overview.html">Architecture overview</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> The architecture chapter describes the overall architecture of Eclipse Ditto and in detail which sub-components fulfill which responsibilities. Top level component view This overview shows the Ditto services (components), the externally provided and consumed API endpoints, the external dependencies (MongoDB and nginx) and the relations of the services to... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="architecture-services-concierge.html">Concierge service</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> The “concierge” service is responsible for orchestrating the backing persistence services and for performing authorization of commands and command responses. It acts as a gatekeeper and entry point for other services providing APIs: gateway connectivity Those services do not need to be aware of... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="architecture-services-connectivity.html">Connectivity service</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> The “connectivity” service enables Ditto to establish and manage client-side connections to external service endpoints. You can communicate with your connected things/twins over those connections via Ditto Protocol messages. The connectivity service supports various transport protocols, which are bound to the Ditto Protocol via specific Protocol Bindings.... </td>
+ </tr>
+
+
+
+
+
+
+
+
+ <tr><td><a href="architecture-services-gateway.html">Gateway service</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> The “gateway” service is responsible for providing Ditto’s HTTP + WebSocket API. Model The gateway service has no model by its own, but uses the model of all the services it provides the HTTP + WebSocket API for. Signals The gateway service has no signals by... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="architecture-services-policies.html">Policies service</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> The “policies” service takes care of persisting Policies. Model The model of the policies service is defined around the entity Policy: Policy model Signals Other services can communicate with the policies service via: commands: containing commands and command responses which are... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="architecture-services-things-search.html">Things-Search service</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> The “things-search” service takes care of: updating an optimized search index of Things based on the events emitted by the things and policies services when entities are changed there executing search queries against the search index in order to find out which Things match... </td>
+ </tr>
+
+
+
+
+
+
+
+
+ <tr><td><a href="architecture-services-things.html">Things service</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> The “things” service takes care of persisting Things and Features. Model The model of the things service is defined around the entities Thing and Feature: Thing model Signals Other services can communicate with the things service via: commands: containing... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="2021-03-31-ssh-tunneling-for-managed-connections.html">Support SSH tunneling for managed connections</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> With the upcoming release of Eclipse Ditto version 2.0.0 it will be possible to SSH tunneling for managed connections With the upcoming release of Eclipse Ditto version 2.0.0, managed connections support establishing an SSH tunnel, which is then used to connect to the actual target endpoint. This is useful... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="2021-03-22-azure-iot-hub-integration.html">Use Eclipse Ditto with Azure IoT Hub as message broker</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> This blogpost is based upon Eclipse Ditto Version 1.5.0, the Azure IoT Suite as of 2021-03-19 and the azure-iot-device-client version 1.29.2. Connecting devices to Eclipse Ditto via Azure IoT Hub This blog post elaborates on connecting and managing devices in Eclipse Ditto by using the Azure IoT Hub as... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ </tbody>
+</table>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/tag_blog.html b/2.0/tag_blog.html
new file mode 100644
index 0000000..6edd651
--- /dev/null
+++ b/2.0/tag_blog.html
@@ -0,0 +1,2935 @@
+<!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=" ">
+<title> Blog 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Blog 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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Blog 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>
+
+
+
+
+
+
+
+
+
+ <p>The following pages and posts are tagged with <button type="button" style="cursor: default" class="btn btn-default navbar-btn">blog</button></p>
+<table><thead><tr><th>Title</th><th>Type</th><th>Excerpt</th></tr></thead>
+ <tbody>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="2021-05-06-release-announcement-200.html">Announcing Eclipse Ditto Release 2.0.0</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> Today, ~1.5 years after release 1.0.0, the Eclipse Ditto team is happy to announce the availability of Eclipse Ditto 2.0.0. With the major version 2.0.0 the Ditto team removed technical debt and ended support for APIs which were deprecated long ago in order to have a better maintainable... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2021-03-31-ssh-tunneling-for-managed-connections.html">Support SSH tunneling for managed connections</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> With the upcoming release of Eclipse Ditto version 2.0.0 it will be possible to SSH tunneling for managed connections With the upcoming release of Eclipse Ditto version 2.0.0, managed connections support establishing an SSH tunnel, which is then used to connect to the actual target endpoint. This is useful... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="2021-03-22-azure-iot-hub-integration.html">Use Eclipse Ditto with Azure IoT Hub as message broker</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> This blogpost is based upon Eclipse Ditto Version 1.5.0, the Azure IoT Suite as of 2021-03-19 and the azure-iot-device-client version 1.29.2. Connecting devices to Eclipse Ditto via Azure IoT Hub This blog post elaborates on connecting and managing devices in Eclipse Ditto by using the Azure IoT Hub as... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="2021-02-04-merge-feature.html">Support merge functionality for things resources</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> With the upcoming release of Eclipse Ditto version 2.0.0 it will be possible to merge existing things and their subresources. Merge functionality for things resources Ditto now supports merging of existing things and all of its subresources with the provided payload in the request. This can be done by... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="2021-01-22-policy-subject-activate-token-integration.html">Policy actions: token based subject activation</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> The upcoming version of Eclipse Ditto 2.0.0 will be enhanced with the ability to alter policies based on policy actions. Policy actions This new concept of Policy actions allows upfront defined modifications to policies without the need for the one invoking the action to have “WRITE” permissions... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2020-12-10-release-announcement-150.html">Announcing Eclipse Ditto Release 1.5.0</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> Wrapping up this crazy year, the Ditto team is happy to announce the next feature update of Ditto 1.x: Eclipse Ditto 1.5.0 1.5.0 focuses on: Desired properties management (CRUD) Addition of “cloudevents” HTTP endpoint Ditto internal pub/sub supports using a “grouping” concept which improves Ditto’s scalability capabilities Issuing... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2020-11-16-weak-acknowledgements.html">Weak acknowledgments to decouple signal publishers and subscribers</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> Motivation Ditto 1.2.0 introduced at-least-once delivery via acknowledgement requests. It increased coupling between the publisher and the subscriber of signals in that the subscriber is no longer at the liberty to filter for signals it is interested in. Instead, the subscriber must consume all signals in... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2020-11-11-desired-properties.html">Desired Feature Properties</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> Desired feature properties added to things model With the upcoming release of Eclipse Ditto version 1.5.0 desired feature properties are introduced to the things model for API versions later than 1. The desired properties for features are added on the same level of the model as the feature... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2020-10-28-release-announcement-140.html">Announcing Eclipse Ditto Release 1.4.0</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> Today, the Ditto team is happy to announce the next feature update of Ditto 1.x: Eclipse Ditto 1.4.0 1.4.0 focuses on: Declaration of acknowledgement labels unique to each subscriber Please have a look at the 1.4.0 release notes for a more detailed information on the release.... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2020-10-23-end-2-end-acknowledgment.html">E2E acknowledgment</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> E2E acknowledgement using Eclipse Ditto By adding the new acknowledgements feature to Ditto, it is now possible to provide an end to end QoS (quality of service) with level 1. Previously the connectivity service of Ditto did accept all incoming messages immediately as soon as it received... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2020-10-08-asynchronous-client-creation.html">Asynchronous Client Creation in Ditto Java Client 1.3.0</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> Before Ditto Java Client 1.3.0, a client object connects to a configured Ditto back-end during its creation. // create a client object and block until it connects to the Ditto back-end. final DittoClient client = DittoClients.newInstance(<span... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2020-09-30-release-announcement-130.html">Announcing Eclipse Ditto Release 1.3.0</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> Today, the Ditto team is happy to announce the next feature update of Ditto 1.x: Eclipse Ditto 1.3.0 1.3.0 focuses on the following areas: Implicit/automatic creation of digital twins (things) Use response of HTTP push connections as live message response “Raw” payload mapper for “pass-through” connectivity scenarios not... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2020-08-31-release-announcement-120.html">Announcing Eclipse Ditto Release 1.2.0</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> Today, the Ditto team is happy to announce the second minor (feature) update of Ditto 1.x: Eclipse Ditto 1.2.0 1.2.0 focuses on the following areas: “At least once” (QoS 1) processing of messages consumed/sent via Ditto’s managed connections (via acknowledgements) Addition of a "_created"... </td>
+ </tr>
+
+
+
+
+
+
+ <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 team 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... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2019-11-04-milestone-announcement-100-M2.html">Announcing Ditto Milestone 1.0.0-M2</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> The second and last milestone of the upcoming release 1.0.0 was released today. Have a look at the Milestone 1.0.0-M2 release notes for what changed in detail. The main changes and new features since the last release 1.0.0-M1a release notes are invoking custom foreign HTTP endpoints... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2019-10-17-http-connectivity.html">Integration of HTTP endpoints/webhooks</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> By adding another connectivity type - HTTP - to Ditto’s connectivity, it is now (to be released in the next Ditto milestone 1.0.0-M2) possible to publish twin events, messages, live commands and events to existing HTTP servers/endpoints. That is especially useful for invoking existing APIs (which are most of... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2019-09-17-milestone-announcement-100-M1a.html">Announcing Ditto Milestone 1.0.0-M1a</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> Today the Ditto team is happy to announce the first milestone of the upcoming release 1.0.0. Have a look at the Milestone 1.0.0-M1a release notes for what changed in detail. The main changes and new features since the last release 0.9.0 are initial contribution of Java... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2019-08-28-openid-connect.html">Eclipse Ditto now supports OpenID Connect</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> Eclipse Ditto now supports all OAuth 2.0 providers which implement OpenID Connect out-of-the-box. You can find a list of certified providers at OpenID Connect - Certified OpenID Provider Servers and Services. With this post, we want to give an example of this new feature using the open source... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2019-07-10-release-announcement-090.html">Announcing Eclipse Ditto Release 0.9.0</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> Today the Eclipse Ditto team proudly presents its second release 0.9.0. The topics of this release in a nutshell were: Memory improvements for huge amounts (multi million) of digital twins which are held in memory Adding metrics and logging around the connectivity feature in order to enable being... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2019-04-29-milestone-announcement-090-M2.html">Announcing Ditto Milestone 0.9.0-M2</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> The second milestone of the upcoming release 0.9.0 was released today. Have a look at the Milestone 0.9.0-M2 release notes for what changed in detail. The main changes and new features since the last milestone 0.9.0-M1 are rewrite of Ditto’s “search” service in order to use... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2019-03-28-milestone-announcement-090-M1.html">Announcing Ditto Milestone 0.9.0-M1</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> Today the Ditto team is happy to announce the first milestone of the upcoming release 0.9.0. Have a look at the Milestone 0.9.0-M1 release notes for what changed in detail. The main changes and new features since the last release 0.8.0 are memory optimizations when working... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2019-03-13-kafka-connectivity.html">Connectivity to Apache Kafka in Eclipse Ditto</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> 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... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2018-12-05-example-command-and-control.html">Using Eclipse Hono's Command&Control with Eclipse Ditto</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> 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,... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2018-11-28-release-announcement-080.html">Announcing Eclipse Ditto Release 0.8.0</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> Today the Eclipse Ditto team proudly presents its first release 0.8.0. Please have a look at the 0.8.0 release notes for a more detailed information on the release. The main changes and new features since the latest milestone 0.8.0-M3 are: Support Eclipse Hono’s command&control in Ditto... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2018-11-14-milestone-announcement-080-M3.html">Announcing Ditto Milestone 0.8.0-M3</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> Preparing the upcoming first release 0.8.0 of Eclipse Ditto, this milestone is a last checkpoint to ensure that the release will be performed smoothly. Therefore, this milestone release primarily focuses on stabilization. Have a look at the Milestone 0.8.0-M3 release notes for what changed in detail. <div... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2018-10-16-example-mqtt-bidirectional.html">Example demonstrating connectivity to an MQTT broker</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> Eclipse Ditto can now connect to MQTT 3.1.1 brokers. Perfect timing to happily welcome a new colleague to our team behind Eclipse Ditto: David. In order to get familiar with Ditto and the development with digital twins, David was assigned with one of his first tasks to get his... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2018-09-27-milestone-announcement-080-M2.html">Announcing Ditto Milestone 0.8.0-M2</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> Brace yourself, Eclipse Ditto is preparing for its first release 0.8.0. We are happy to announce our next milestone towards that goal. Have a look at the Milestone 0.8.0-M2 release notes for what changed in detail. The main changes and new features are enforcement of max. entity... </td>
+ </tr>
+
+
+
+
+
+
+ <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>
+ <td> The connectivity service supercharged Ditto’s flexibility in integrating with other services. It’s such a great feature to let the other connected services know about thing updates and property changes. Even the direct exchange with real-world assets became more flexible through the multi-protocol support. But with a steady increase in... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="2018-08-14-milestone-announcement-080-M1.html">Announcing Ditto Milestone 0.8.0-M1</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> Even during the summer break the Ditto team worked hard in order to provide the next milestone release. Here it is: Milestone 0.8.0-M1. Have a look at the Milestone 0.8.0-M1 release notes for what changed in detail and why there was a version bump from 0.3.0-M2 to 0.8.0-M1. The... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2018-06-15-milestone-announcement-030-M2.html">Announcing Ditto Milestone 0.3.0-M2</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> Today we, the Eclipse Ditto team, are happy to announce our next milestone 0.3.0-M2. The main changes are improvement of Ditto’s cluster performance with many managed Things a new Ditto service ditto-concierge was added for this improved cluster bootstrapping based on DNS with the potential... </td>
+ </tr>
+
+
+
+
+
+
+ <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> 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>
+
+
+
+
+
+
+
+
+ <tr><td><a href="2018-04-26-milestone-announcement-030-M1.html">Announcing Ditto Milestone 0.3.0-M1</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> After some time of silence of Ditto milestone releases we are very proud to present our next one to the public. Have a look at the Milestone 0.3.0-M1 release notes. The main changes are switch to Eclipse OpenJ9 JVM in Ditto’s Docker images renaming of Ditto’s “AMQP... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2018-04-25-connectivity-service.html">Ditto's connectivity capabilities are pimped up</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> It has been quite lately on our website and on GitHub as the Ditto team currently prepares its new connectivity microservice. Until now Ditto’s amqp-bridge service could connect to AMQP1.0 endpoints (e.g. Eclipse Hono). That worked quite well, but still had some issues: failover/reconnection was not... </td>
+ </tr>
+
+
+
+
+
+
+
+
+ <tr><td><a href="2018-02-08-feature-definition.html">Introducing Feature Definition</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> Brace yourselves, Eclipse Vorto is going to be integrated with Ditto. Rationale By now you most probably represented your devices as things with features. This is indeed the proper way to do it. This approach is flexible and easy so far. But wouldn’t it be nice to have... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2018-02-07-milestone-announcement-020-M1.html">Announcing Ditto Milestone 0.2.0-M1</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> The Ditto team is proud to announce the next milestone release. Have a look at the Milestone 0.2.0-M1 release notes. The main changes are being able to search in namespaces which can speed up search queries when applied to a large population of digital twins the enhancement... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2018-01-15-example-demonstrating-rest-to-websocket.html">Example demonstrating REST and WebSocket API</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> There’s a new example showing how to combine the REST and WebSocket API over at the Eclipse Ditto examples repository. Right from the project’s description: This example shows how to leverage the powers of combining the REST and WebSocket Messages API of Eclipse Ditto. It demonstrates how... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2018-01-12-milestone-announcement-010-M3.html">Announcing Ditto Milestone 0.1.0-M3</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> We wish you all a happy new year and an hope you are curious about our new Eclipse Ditto milestone. Milestone 3 Our new milestone, namely 0.1.0-M3, adds an AMQP 1.0 bridge. The bridge enables to connect to a running instance of Eclipse Hono. Ditto can... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2017-12-18-milestone-announcement-010-M1.html">Announcing Ditto Milestone 0.1.0-M1</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> We finally managed to build our first milestone of Eclipse Ditto: 0.1.0-M1 Java artifacts were published to both the Eclipse Maven repository as well as Maven central. Additionally Docker images were pushed to Docker Hub: eclipse/ditto-policies eclipse/ditto-things eclipse/ditto-things-search eclipse/ditto-gateway You can... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="2017-11-10-welcome-to-ditto.html">Welcome to the Eclipse Ditto project site</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> This is our very first blog post of our new project site and we continue to add more documentation. </td>
+ </tr>
+
+
+
+
+ </tbody>
+</table>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/tag_client_sdk.html b/2.0/tag_client_sdk.html
new file mode 100644
index 0000000..c3d8fd4
--- /dev/null
+++ b/2.0/tag_client_sdk.html
@@ -0,0 +1,2717 @@
+<!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=" ">
+<title> Client SDK topics • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Client SDK topics">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Client SDK topics</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>The following pages and posts are tagged with <button type="button" style="cursor: default" class="btn btn-default navbar-btn">client_sdk</button></p>
+<table><thead><tr><th>Title</th><th>Type</th><th>Excerpt</th></tr></thead>
+ <tbody>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="client-sdk-java.html">Client SDK Java</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> A client SDK for Java in order to interact with digital twins provided by an Eclipse Ditto backend. Features Digital twin management: CRUD (create, read, update, delete) of Ditto things Change notifications: consume notifications whenever a “watched” digital twin is modified Send/receive messages to/from devices... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="client-sdk-javascript.html">Client SDK JavaScript</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> A TypeScript library to facilitate working the the REST-like HTTP API and web socket API of Eclipse Ditto. How to use it Install @eclipse-ditto/ditto-javascript-client-dom for the DOM (browser) implementation, @eclipse-ditto/ditto-javascript-client-node for the NodeJS implementation, or @eclipse/ditto-javascript-client-api-ditto for the API and build your own client implementation. More... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="client-sdk-overview.html">Client SDK overview</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Client SDK for Eclipse Ditto are API implementations in different programming languages.
+
+These SDKs make use of the Ditto Protocol to exchange messages with Eclipse Ditto.
+
+The following SDKs are supported:
+
+
+ Java
+ JavaScript
+
+ </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ </tbody>
+</table>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/tag_connectivity.html b/2.0/tag_connectivity.html
new file mode 100644
index 0000000..220912b
--- /dev/null
+++ b/2.0/tag_connectivity.html
@@ -0,0 +1,2821 @@
+<!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=" ">
+<title> Connectivity topics • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Connectivity topics">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Connectivity topics</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>The following pages and posts are tagged with <button type="button" style="cursor: default" class="btn btn-default navbar-btn">connectivity</button></p>
+<table><thead><tr><th>Title</th><th>Type</th><th>Excerpt</th></tr></thead>
+ <tbody>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="architecture-services-connectivity.html">Connectivity service</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> The “connectivity” service enables Ditto to establish and manage client-side connections to external service endpoints. You can communicate with your connected things/twins over those connections via Ditto Protocol messages. The connectivity service supports various transport protocols, which are bound to the Ditto Protocol via specific Protocol Bindings.... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="basic-connections.html">Connections</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Connection model Note: To get started with connections right away, consult the Manage connections page. You can integrate your Ditto instance with external messaging services such as Eclipse Hono, a RabbitMQ broker or an Apache Kafka broker via... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="basic-placeholders.html">Placeholders</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Placeholders Placeholders may be used at several places in Ditto where something should be resolved by a variable. The general syntax of a placeholder is {{ prefix:name }}. Which placeholder values are available depends on the context where the placeholder is used. Scope: Entity creation /... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="connectivity-header-mapping.html">Header mapping for connections</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> When receiving messages from external systems or sending messages to external systems, the external headers of the messages can be mapped to and from Ditto protocol headers. That way the headers can be passed through Ditto, or defined Ditto protocol headers like for example correlation-id may be mapped to... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="connectivity-manage-connections.html">Manage connections</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> In order to manage (CRUD) connections in Ditto DevOps commands have to be used. There is no separate HTTP API for managing the connections, as this is not a task for a developer using the digital twin APIs but more for a “DevOps engineer” creating new connections to external... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="connectivity-mapping.html">Payload mapping in connectivity service</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> TL;DRThe payload mapping feature in Ditto’s connectivity APIs can be used to transform arbitrary payload consumed via the different supported protocols to Ditto Protocol messages and vice versa. Motivation Eclipse Ditto is about providing access to IoT devices via the digital twin pattern. In... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="connectivity-overview.html">Connectivity API overview</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> The Connectivity API is a bare management API for Ditto’s Connectivity Service. It completely depends on DevOps Commands for connection management. Use it to manage client connections to remote systems and to exchange Ditto Protocol messages with those. If a remote system is unable to send... </td>
+ </tr>
+
+
+
+
+
+
+
+
+ <tr><td><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Consume messages from AMQP 0.9.1 brokers via sources and send messages to AMQP 0.9.1 brokers via targets. Content-type When messages are sent in Ditto Protocol (as UTF-8 encoded String payload), the content-type of AMQP 0.9.1 messages must be set to: application/vnd.eclipse.ditto+json... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Consume messages from AMQP 1.0 endpoints via sources and send messages to AMQP 1.0 endpoints via targets. Content-type When messages are sent in Ditto Protocol (as UTF-8 encoded String payload), the content-type of AMQP 1.0 messages must be set to: application/vnd.eclipse.ditto+json... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Perform HTTP request (with verbs POST, PUT, PATCH) to HTTP endpoints via targets. Specific connection configuration The common configuration for connections in Connections > Targets applies here as well. Following are some specifics for HTTP connections: Source format Note: HTTP... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="connectivity-protocol-bindings-kafka2.html">Apache Kafka 2.x protocol binding</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Send messages to Apache Kafka via targets. Content-type When Kafka 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 payload mapping must be configured for the connection in order... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Consume messages from MQTT brokers via sources and send messages to MQTT 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 payload... </td>
+ </tr>
+
+
+
+
+
+
+
+
+ <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-ssh-tunneling.html">SSH tunneling</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> SSH tunneling A managed connection supports establishing an SSH tunnel (see section TCP/IP Port Forwarding of the Secure Shell (SSH) Connection Protocol, RFC4254) which is then used to connect to the actual target endpoint. This is useful when the target endpoint is not directly accessible but only via... </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>
+ <td> Verify server certificate Server-certificate verification is available for AMQP 0.9.1, AMQP 1.0, MQTT 3.1.1, MQTT 5, HTTP 1.1, and Kafka 2.x connections. Connection configuration Verifying the server identity mitigates the risk of man-in-the-middle attacks. To have Ditto check the identity of external... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="release_notes_030-M1.html">Release notes 0.3.0-M1</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 0.3.0-M1 of Eclipse Ditto, released on 26.04.2018 </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="2021-03-31-ssh-tunneling-for-managed-connections.html">Support SSH tunneling for managed connections</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> With the upcoming release of Eclipse Ditto version 2.0.0 it will be possible to SSH tunneling for managed connections With the upcoming release of Eclipse Ditto version 2.0.0, managed connections support establishing an SSH tunnel, which is then used to connect to the actual target endpoint. This is useful... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="2021-03-22-azure-iot-hub-integration.html">Use Eclipse Ditto with Azure IoT Hub as message broker</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> This blogpost is based upon Eclipse Ditto Version 1.5.0, the Azure IoT Suite as of 2021-03-19 and the azure-iot-device-client version 1.29.2. Connecting devices to Eclipse Ditto via Azure IoT Hub This blog post elaborates on connecting and managing devices in Eclipse Ditto by using the Azure IoT Hub as... </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="2018-09-21-selective-push-notifications.html">Selective push notifications available</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> The connectivity service supercharged Ditto’s flexibility in integrating with other services. It’s such a great feature to let the other connected services know about thing updates and property changes. Even the direct exchange with real-world assets became more flexible through the multi-protocol support. But with a steady increase in... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <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> 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>
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="2018-04-25-connectivity-service.html">Ditto's connectivity capabilities are pimped up</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> It has been quite lately on our website and on GitHub as the Ditto team currently prepares its new connectivity microservice. Until now Ditto’s amqp-bridge service could connect to AMQP1.0 endpoints (e.g. Eclipse Hono). That worked quite well, but still had some issues: failover/reconnection was not... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ </tbody>
+</table>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/tag_getting_started.html b/2.0/tag_getting_started.html
new file mode 100644
index 0000000..3f53882
--- /dev/null
+++ b/2.0/tag_getting_started.html
@@ -0,0 +1,2739 @@
+<!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=" ">
+<title> Getting started topics • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Getting started topics">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Getting started topics</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>The following pages and posts are tagged with <button type="button" style="cursor: default" class="btn btn-default navbar-btn">getting_started</button></p>
+<table><thead><tr><th>Title</th><th>Type</th><th>Excerpt</th></tr></thead>
+ <tbody>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="feedback.html">Feedback</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> You have following possibilities in order to get support or give feedback:
+
+
+ Join the chat at https://gitter.im/eclipse/ditto for questions
+ As your question on StackOverflow
+ send a message to the mailing-list
+ create a GitHub issue
+
+ </td>
+ </tr>
+
+
+
+
+
+
+
+
+ <tr><td><a href="glossary.html">Glossary</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Common terms IoT Internet of Things IIoT Industrial Internet of Things - also known as ‘Industry 4.0’ CQRS Command-Query Responsibility Segregation. A pattern Ditto applies in order to handle commands (ModifyCommands in Ditto) and queries (QueryCommands in Ditto) differently, e.g. by reading queries from memory and persisting commands... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <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 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>
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="installation-running.html">Running Ditto</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Start Ditto In order to start Ditto, you’ll need: a MongoDB service or container with version 4.2 as backing datastore of Ditto. (if you want to use a managed MongoDB service have a look in the section below) the built Docker images of Ditto either... </td>
+ </tr>
+
+
+
+
+
+
+
+
+ <tr><td><a href="intro-digitaltwins.html">Digital twins</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> TL;DRDigital twins are a pattern for simplifying IoT solution development. The problem with the term digital twin is that there are many different understandings of what it means. Furthermore, the term was previously mostly used and coined by marketing. The term was/is missing a technical foundation of... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="intro-hello-world.html">Hello world</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> After starting Ditto, we have a HTTP and WebSocket API for your digital twins at our hands. Example Assume we want to create a digital twin for a car. The twin should hold static metadata and dynamic state data. The state data should change as often as... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="intro-overview.html">Eclipse Ditto™ documentation overview</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> What is it? Eclipse Ditto™ is a technology in the IoT implementing a software pattern called “digital twins”. A digital twin is a virtual, cloud based, representation of his real world counterpart (real world “Things”, e.g. devices like sensors, smart heating, connected... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ </tbody>
+</table>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/tag_http.html b/2.0/tag_http.html
new file mode 100644
index 0000000..5e373cc
--- /dev/null
+++ b/2.0/tag_http.html
@@ -0,0 +1,2737 @@
+<!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=" ">
+<title> HTTP topics • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="HTTP topics">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">HTTP topics</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>The following pages and posts are tagged with <button type="button" style="cursor: default" class="btn btn-default navbar-btn">http</button></p>
+<table><thead><tr><th>Title</th><th>Type</th><th>Excerpt</th></tr></thead>
+ <tbody>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <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 only provides API version 2. API version... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="httpapi-messages.html">HTTP API Messages</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> The HTTP API allows sending Messages to and from Things and its Features. To dive into the basic concepts of the Messages functionality, please have a look at the Messages page. Tip: Check out the WebSocket Messages API if you also need... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="httpapi-overview.html">HTTP API overview</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Ditto’s HTTP API is documented separately in the HTTP API Doc. There you can explore the two different API versions (the difference is described in the Basic Overview). Ditto does not provide a fully compliant RESTful API in the academic sense as it does not include hyperlinks... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="httpapi-protocol-bindings-cloudevents.html">Cloud Events HTTP protocol binding</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Implements the HTTP Protocol Binding for CloudEvents - Version 1.0. Unless mentioned otherwise, the endpoint following the Cloud Events specification for the HTTP binding in version 1.0. Cloud Events features The Cloud Events endpoint provides an alternative to the other connectivity APIs to stream data into your instance.... </td>
+ </tr>
+
+
+
+
+
+
+
+
+ <tr><td><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Ditto Protocol messages can be sent as is as WebSocket message. The Ditto Protocol JSON must be sent as UTF-8 encoded String payload. WebSocket features The WebSocket provides an alternative to the HTTP API in order to manage your digital twins. The benefits of the... </td>
+ </tr>
+
+
+
+
+
+
+
+
+ <tr><td><a href="httpapi-search.html">HTTP API search</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> The search aspect of Ditto can be accessed via an HTTP API. Note: Find the HTTP API reference at the Search resources. The concepts of the RQL expression, RQL sorting and RQL paging are mapped to HTTP as query... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+ <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> 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>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="2021-02-04-merge-feature.html">Support merge functionality for things resources</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> With the upcoming release of Eclipse Ditto version 2.0.0 it will be possible to merge existing things and their subresources. Merge functionality for things resources Ditto now supports merging of existing things and all of its subresources with the provided payload in the request. This can be done by... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ </tbody>
+</table>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/tag_installation.html b/2.0/tag_installation.html
new file mode 100644
index 0000000..a0ecce3
--- /dev/null
+++ b/2.0/tag_installation.html
@@ -0,0 +1,2707 @@
+<!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=" ">
+<title> Installation topics • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Installation topics">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Installation topics</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>The following pages and posts are tagged with <button type="button" style="cursor: default" class="btn btn-default navbar-btn">installation</button></p>
+<table><thead><tr><th>Title</th><th>Type</th><th>Excerpt</th></tr></thead>
+ <tbody>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <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 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>
+
+
+
+
+
+
+ <tr><td><a href="installation-operating.html">Operating Ditto</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Once you have successfully started Ditto, proceed with setting it up for continuous operation. This page shows the basics for operating Ditto. Configuration Ditto has many config parameters which can be set in the config files or via environment variables. This section will cover some of Ditto’s config parameters.... </td>
+ </tr>
+
+
+
+
+
+
+
+
+ <tr><td><a href="installation-running.html">Running Ditto</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Start Ditto In order to start Ditto, you’ll need: a MongoDB service or container with version 4.2 as backing datastore of Ditto. (if you want to use a managed MongoDB service have a look in the section below) the built Docker images of Ditto either... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ </tbody>
+</table>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/tag_model.html b/2.0/tag_model.html
new file mode 100644
index 0000000..52f2aef
--- /dev/null
+++ b/2.0/tag_model.html
@@ -0,0 +1,2761 @@
+<!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=" ">
+<title> Model topics • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Model topics">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Model topics</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>The following pages and posts are tagged with <button type="button" style="cursor: default" class="btn btn-default navbar-btn">model</button></p>
+<table><thead><tr><th>Title</th><th>Type</th><th>Excerpt</th></tr></thead>
+ <tbody>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="basic-acknowledgements.html">Acknowledgements / Quality of Service</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Acknowledgements are a concept in Ditto used to indicate that a supported signal was successfully received or processed by either an internal Ditto functionality or an external subscriber of that signal. Acknowledgements can be seen as (potentially multiple) responses to a single signal like for example a twin command.... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="basic-apis.html">APIs</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Ditto provides two ways to interact with: A REST-like HTTP API with a sophisticated resource layout that allows to create, read, update and delete Things and the Thing’s data. A JSON-based WebSocket API implementing the Ditto Protocol. HTTP API or WebSocket? The two ways... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="basic-auth.html">Authentication and authorization</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> You can integrate your solutions with Ditto via the HTTP API or via WebSocket. On all APIs Ditto protects functionality and data by using Authentication to make sure the requester is the one he/she claims to be, Authorization to make sure the requester is allowed to... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="basic-changenotifications.html">Change notifications</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Signals already described what an Event in Ditto is. Events are emitted after an entity (either a digital twin or an actual device) was changed. At the Ditto API there are different ways for getting notified of such events: Via the WebSocket API a WebSocket client... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="basic-errors.html">Errors</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Errors are datatypes containing information about occurred failures which were either cause by the user or appeared in the server. Error model specification Status The “status” uses HTTP status codes semantics (see RFC 7231) to indicate whether a specific command has been successfully completed,... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="basic-feature.html">Feature</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Feature A Feature is used to manage all data and functionality of a Thing that can be clustered in an outlined technical context. For different contexts or aspects of a Thing different Features can be used which are all belonging to the same Thing and do not exist without... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="basic-messages.html">Messages</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Messages do not affect the state of a digital twin or an actual device. Therefore, Ditto does not handle messages like commands: there are no responses which are produced by Ditto and no events which are emitted for messages. Note: Ditto has no... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="basic-metadata.html">Thing Metadata</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> A Thing in Ditto is also able to store Metadata information, e.g. about single feature properties, complete features and also attributes or other data stored in a digital twin (thing). This metadata can contain additionally information which shall not be treated as part of the twin’s value,... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="basic-namespaces-and-names.html">Namespaces and Names</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Ditto uses namespaces and names for the IDs of important entity types like Things or Policies. Due to the fact that those IDs often need to be set in the path of HTTP requests, we have restricted the set of allowed characters. Namespace The namespace must conform to the... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="basic-overview.html">Basic concepts overview</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Domain model Eclipse Ditto does not claim to know exactly which structure Things in the IoT have or should have. Its idea is to be as agnostic as possible when it comes to Thing data. Nevertheless, two coarse elements are defined in... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="basic-policy.html">Policy</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> A Policy enables developers to configure fine-grained access control for Things and other entities easily. Note: Find the HTTP API reference at Policies resources. Authorization concept A specific policy provides someone (called subject), permission to read and/or write a given resource. <div... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="basic-thing.html">Thing</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> The versatile assets in IoT applications can be managed as Things. Thing Things are very generic entities and are mostly used as a “handle” for multiple features belonging to this Thing. Examples: Physical Device: a lawn mower, a sensor, a vehicle, a lamp. Virtual Device: a room in... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ </tbody>
+</table>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/tag_news.html b/2.0/tag_news.html
new file mode 100644
index 0000000..2594e9a
--- /dev/null
+++ b/2.0/tag_news.html
@@ -0,0 +1,2689 @@
+<!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=" ">
+<title> News topics • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="News topics">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">News topics</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>The following pages and posts are tagged with <button type="button" style="cursor: default" class="btn btn-default navbar-btn">news</button></p>
+<table><thead><tr><th>Title</th><th>Type</th><th>Excerpt</th></tr></thead>
+ <tbody>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ </tbody>
+</table>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/tag_protocol.html b/2.0/tag_protocol.html
new file mode 100644
index 0000000..1c44cc0
--- /dev/null
+++ b/2.0/tag_protocol.html
@@ -0,0 +1,2875 @@
+<!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=" ">
+<title> Protocol topics • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 topics">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Protocol topics</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>The following pages and posts are tagged with <button type="button" style="cursor: default" class="btn btn-default navbar-btn">protocol</button></p>
+<table><thead><tr><th>Title</th><th>Type</th><th>Excerpt</th></tr></thead>
+ <tbody>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="basic-enrichment.html">Signal enrichment</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> 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 message. Events, for example, only contain the actually changed data by default, so when they are subscribed to... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <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>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Consume messages from AMQP 0.9.1 brokers via sources and send messages to AMQP 0.9.1 brokers via targets. Content-type When messages are sent in Ditto Protocol (as UTF-8 encoded String payload), the content-type of AMQP 0.9.1 messages must be set to: application/vnd.eclipse.ditto+json... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Consume messages from AMQP 1.0 endpoints via sources and send messages to AMQP 1.0 endpoints via targets. Content-type When messages are sent in Ditto Protocol (as UTF-8 encoded String payload), the content-type of AMQP 1.0 messages must be set to: application/vnd.eclipse.ditto+json... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Perform HTTP request (with verbs POST, PUT, PATCH) to HTTP endpoints via targets. Specific connection configuration The common configuration for connections in Connections > Targets applies here as well. Following are some specifics for HTTP connections: Source format Note: HTTP... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="connectivity-protocol-bindings-kafka2.html">Apache Kafka 2.x protocol binding</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Send messages to Apache Kafka via targets. Content-type When Kafka 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 payload mapping must be configured for the connection in order... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1 protocol binding</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Consume messages from MQTT brokers via sources and send messages to MQTT 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 payload... </td>
+ </tr>
+
+
+
+
+
+
+
+
+ <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="httpapi-protocol-bindings-cloudevents.html">Cloud Events HTTP protocol binding</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Implements the HTTP Protocol Binding for CloudEvents - Version 1.0. Unless mentioned otherwise, the endpoint following the Cloud Events specification for the HTTP binding in version 1.0. Cloud Events features The Cloud Events endpoint provides an alternative to the other connectivity APIs to stream data into your instance.... </td>
+ </tr>
+
+
+
+
+
+
+
+
+ <tr><td><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Ditto Protocol messages can be sent as is as WebSocket message. The Ditto Protocol JSON must be sent as UTF-8 encoded String payload. WebSocket features The WebSocket provides an alternative to the HTTP API in order to manage your digital twins. The benefits of the... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="protocol-bindings.html">Protocol bindings</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> A protocol binding defines how the Ditto protocol messages are transported using a specific network protocol e.g. “Ditto Protocol over WebSocket”. The binding defines a set of rules how Ditto protocol messages are mapped to network protocol messages and back. Currently the following protocol bindings are supported: WebSocket... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="protocol-examples.html">Protocol examples</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> The structure of the examples in this section is as follows: Command Each example always starts with a command message that initiates an operation at Ditto (e.g. create a thing, retrieve a thing). { "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify", <span... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="protocol-overview.html">Protocol overview</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> The Ditto Protocol defines a JSON based text protocol for communicating with digital twins and the actual physical devices they mirror. It defines several commands both the actual device and the digital twin are able to understand. The communication pattern is defined by the Ditto protocol and shown in the... </td>
+ </tr>
+
+
+
+
+
+
+ <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-errors.html">Protocol specification for errors</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Ditto Protocol messages of error responses transport information about encountered errors, e.g. client errors or server errors: The error codes Ditto provides in addition to the HTTP status code (e.g. error codes like “things:thing.tooLarge”) is not to be considered as API and must therefore not... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="protocol-specification-policies-announcement.html">Policies - Announcement 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. Policy announcements A Policy announcement contains the announcement name as last part of the topic: <namespace>/<policyName>/policies/announcements/<announcement-name> The Ditto Protocol representation of... </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>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="protocol-specification-things-delete.html">Things - Delete 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. Delete a Thing Deletes the Thing identified by the <namespace> and <thingId> in the topic. Command ... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="protocol-specification-things-merge.html">Things - Merge 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. For all merge commands the value field is provided in JSON merge patch format. In case of conflicts with the... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="protocol-specification-things-messages.html">Things - Messages protocol specification</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Messages within the Ditto Protocol allow sending, receiving and responding to Messages. They contain an arbitrary payload, so you can choose what content fits your solution best. If you want to learn more about the basic concepts of the Messages functionality, please have a look at the Messages page.... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="protocol-specification-things-retrieve.html">Things - Retrieve 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. Retrieve a Thing Retrieve the Thing specified by the <namespace> and <thingId> in the topic. The response includes... </td>
+ </tr>
+
+
+
+
+
+
+ <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> 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>
+
+
+
+
+
+
+
+
+ <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>/<thingName>/things/<channel>/<criterion>/<action> namespace: the namespace of the Thing. thingName: the name of the Thing. group: the... </td>
+ </tr>
+
+
+
+
+
+
+ <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}/{entity-name}/{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-23/things/twin/commands/merge 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 org.eclipse.ditto/fancy-policy-1/policies/announcements/subjectDeletion Namespace The entity’s namespace in... </td>
+ </tr>
+
+
+
+
+
+
+ <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>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="protocol-twinlive.html">Protocol twin/live channel</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> The Ditto Protocol furthermore covers two different communication channels to address different aspects of devices and their digital twins. Twin The first channel, twin, connects to the digital representation of a Thing. This Thing is managed with Ditto and its state and properties can be read and updated. <img... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="2021-02-04-merge-feature.html">Support merge functionality for things resources</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> With the upcoming release of Eclipse Ditto version 2.0.0 it will be possible to merge existing things and their subresources. Merge functionality for things resources Ditto now supports merging of existing things and all of its subresources with the provided payload in the request. This can be done by... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ </tbody>
+</table>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/tag_release_notes.html b/2.0/tag_release_notes.html
new file mode 100644
index 0000000..536fd04
--- /dev/null
+++ b/2.0/tag_release_notes.html
@@ -0,0 +1,2851 @@
+<!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=" ">
+<title> Release Notes topics • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 topics">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Release Notes topics</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>The following pages and posts are tagged with <button type="button" style="cursor: default" class="btn btn-default navbar-btn">release_notes</button></p>
+<table><thead><tr><th>Title</th><th>Type</th><th>Excerpt</th></tr></thead>
+ <tbody>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="release_notes_010-M1.html">Release notes 0.1.0-M1</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 0.1.0-M1 of Eclipse Ditto, released on 18.12.2017 </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="release_notes_010-M3.html">Release notes 0.1.0-M3</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 0.1.0-M3 of Eclipse Ditto, released on 12.01.2018 </td>
+ </tr>
+
+
+
+
+
+
+
+
+ <tr><td><a href="release_notes_020-M1.html">Release notes 0.2.0-M1</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 0.2.0-M1 of Eclipse Ditto, released on 07.02.2018 </td>
+ </tr>
+
+
+
+
+
+
+
+
+ <tr><td><a href="release_notes_030-M1.html">Release notes 0.3.0-M1</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 0.3.0-M1 of Eclipse Ditto, released on 26.04.2018 </td>
+ </tr>
+
+
+
+
+
+
+
+
+ <tr><td><a href="release_notes_030-M2.html">Release notes 0.3.0-M2</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 0.3.0-M2 of Eclipse Ditto, released on 15.06.2018 </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="release_notes_080.html">Release notes 0.8.0</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 0.8.0 of Eclipse Ditto, released on 28.11.2018 </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="release_notes_080-M1.html">Release notes 0.8.0-M1</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 0.8.0-M1 of Eclipse Ditto, released on 14.08.2018 </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="release_notes_080-M2.html">Release notes 0.8.0-M2</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 0.8.0-M2 of Eclipse Ditto, released on 27.09.2018 </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="release_notes_080-M3.html">Release notes 0.8.0-M3</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 0.8.0-M3 of Eclipse Ditto, released on 14.11.2018 </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="release_notes_090.html">Release notes 0.9.0</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 0.9.0 of Eclipse Ditto, released on 10.07.2019 </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="release_notes_090-M1.html">Release notes 0.9.0-M1</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 0.9.0-M1 of Eclipse Ditto, released on 28.03.2019 </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="release_notes_090-M2.html">Release notes 0.9.0-M2</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 0.9.0-M2 of Eclipse Ditto, released on 29.04.2019 </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="release_notes_100.html">Release notes 1.0.0</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 1.0.0 of Eclipse Ditto, released on 12.12.2019 </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="release_notes_100-M1a.html">Release notes 1.0.0-M1a</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 1.0.0-M1a of Eclipse Ditto, released on 17.09.2019 </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="release_notes_100-M2.html">Release notes 1.0.0-M2</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 1.0.0-M2 of Eclipse Ditto, released on 04.11.2019 </td>
+ </tr>
+
+
+
+
+
+
+ <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>
+
+
+
+
+
+
+ <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>
+
+
+
+
+
+
+ <tr><td><a href="release_notes_113.html">Release notes 1.1.3</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 1.1.3 of Eclipse Ditto, released on 20.07.2020 </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="release_notes_115.html">Release notes 1.1.5</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 1.1.5 of Eclipse Ditto, released on 25.08.2020 </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="release_notes_120.html">Release notes 1.2.0</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 1.2.0 of Eclipse Ditto, released on 31.08.2020 </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="release_notes_121.html">Release notes 1.2.1</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 1.2.1 of Eclipse Ditto, released on 08.09.2020 </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="release_notes_130.html">Release notes 1.3.0</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 1.3.0 of Eclipse Ditto, released on 30.09.2020 </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="release_notes_140.html">Release notes 1.4.0</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 1.4.0 of Eclipse Ditto, released on 28.10.2020 </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="release_notes_150.html">Release notes 1.5.0</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 1.5.0 of Eclipse Ditto, released on 10.12.2020 </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="release_notes_151.html">Release notes 1.5.1</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 1.5.1 of Eclipse Ditto, released on 22.12.2020 </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="release_notes_200.html">Release notes 2.0.0</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 2.0.0 of Eclipse Ditto, released on 06.05.2021 </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ </tbody>
+</table>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/tag_rql.html b/2.0/tag_rql.html
new file mode 100644
index 0000000..0423cfe
--- /dev/null
+++ b/2.0/tag_rql.html
@@ -0,0 +1,2755 @@
+<!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=" ">
+<title> RQL topics • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="RQL topics">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">RQL topics</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>The following pages and posts are tagged with <button type="button" style="cursor: default" class="btn btn-default navbar-btn">rql</button></p>
+<table><thead><tr><th>Title</th><th>Type</th><th>Excerpt</th></tr></thead>
+ <tbody>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="basic-changenotifications.html">Change notifications</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Signals already described what an Event in Ditto is. Events are emitted after an entity (either a digital twin or an actual device) was changed. At the Ditto API there are different ways for getting notified of such events: Via the WebSocket API a WebSocket client... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <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>
+
+
+
+
+
+
+
+
+
+
+ <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. 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>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1 protocol binding</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Consume messages from AMQP 0.9.1 brokers via sources and send messages to AMQP 0.9.1 brokers via targets. Content-type When messages are sent in Ditto Protocol (as UTF-8 encoded String payload), the content-type of AMQP 0.9.1 messages must be set to: application/vnd.eclipse.ditto+json... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 protocol binding</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Consume messages from AMQP 1.0 endpoints via sources and send messages to AMQP 1.0 endpoints via targets. Content-type When messages are sent in Ditto Protocol (as UTF-8 encoded String payload), the content-type of AMQP 1.0 messages must be set to: application/vnd.eclipse.ditto+json... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="connectivity-protocol-bindings-http.html">HTTP 1.1 protocol binding</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Perform HTTP request (with verbs POST, PUT, PATCH) to HTTP endpoints via targets. Specific connection configuration The common configuration for connections in Connections > Targets applies here as well. Following are some specifics for HTTP connections: Source format Note: HTTP... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="connectivity-protocol-bindings-kafka2.html">Apache Kafka 2.x protocol binding</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Send messages to Apache Kafka via targets. Content-type When Kafka 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 payload mapping must be configured for the connection in order... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="httpapi-protocol-bindings-websocket.html">WebSocket protocol binding</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Ditto Protocol messages can be sent as is as WebSocket message. The Ditto Protocol JSON must be sent as UTF-8 encoded String payload. WebSocket features The WebSocket provides an alternative to the HTTP API in order to manage your digital twins. The benefits of the... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="httpapi-search.html">HTTP API search</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> The search aspect of Ditto can be accessed via an HTTP API. Note: Find the HTTP API reference at the Search resources. The concepts of the RQL expression, RQL sorting and RQL paging are mapped to HTTP as query... </td>
+ </tr>
+
+
+
+
+
+
+
+
+ <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> 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>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <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>
+ <td> The connectivity service supercharged Ditto’s flexibility in integrating with other services. It’s such a great feature to let the other connected services know about thing updates and property changes. Even the direct exchange with real-world assets became more flexible through the multi-protocol support. But with a steady increase in... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ </tbody>
+</table>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/tag_search.html b/2.0/tag_search.html
new file mode 100644
index 0000000..b2bbef8
--- /dev/null
+++ b/2.0/tag_search.html
@@ -0,0 +1,2725 @@
+<!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=" ">
+<title> Search topics • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 topics">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Search topics</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>The following pages and posts are tagged with <button type="button" style="cursor: default" class="btn btn-default navbar-btn">search</button></p>
+<table><thead><tr><th>Title</th><th>Type</th><th>Excerpt</th></tr></thead>
+ <tbody>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="architecture-services-things-search.html">Things-Search service</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> The “things-search” service takes care of: updating an optimized search index of Things based on the events emitted by the things and policies services when entities are changed there executing search queries against the search index in order to find out which Things match... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <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. 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>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="httpapi-search.html">HTTP API search</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> The search aspect of Ditto can be accessed via an HTTP API. Note: Find the HTTP API reference at the Search resources. The concepts of the RQL expression, RQL sorting and RQL paging are mapped to HTTP as query... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <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> 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>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="release_notes_010-M3.html">Release notes 0.1.0-M3</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 0.1.0-M3 of Eclipse Ditto, released on 12.01.2018 </td>
+ </tr>
+
+
+
+
+
+
+
+
+ <tr><td><a href="release_notes_020-M1.html">Release notes 0.2.0-M1</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Version 0.2.0-M1 of Eclipse Ditto, released on 07.02.2018 </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ </tbody>
+</table>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/tag_signal.html b/2.0/tag_signal.html
new file mode 100644
index 0000000..1217a37
--- /dev/null
+++ b/2.0/tag_signal.html
@@ -0,0 +1,2730 @@
+<!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=" ">
+<title> Signal topics • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 topics">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Signal topics</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>The following pages and posts are tagged with <button type="button" style="cursor: default" class="btn btn-default navbar-btn">signal</button></p>
+<table><thead><tr><th>Title</th><th>Type</th><th>Excerpt</th></tr></thead>
+ <tbody>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="basic-signals-announcement.html">Announcement</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Announcements are special signals which are published in order to announce something before it actually happens. For example, before an event is created and published, an announcement could signal that the event will happen soon. Announcements have the following characteristics: they are not persisted/appended into any data... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="basic-signals-command.html">Command</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Commands involve the need to change or retrieve something of a digital twin managed by Ditto or an actual device connected to Ditto. Commands always contain an identifier of the entity they address (e.g. a Thing ID). Modify Commands Commands which modify a digital twin or an actual... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="basic-signals-commandresponse.html">Command response</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> CommandResponses are the answer to Commands and include information about whether the
+intention of changing something via a ModifyCommand has worked or if there was an Error
+instead.
+
+The CommandResponse of QueryCommands contains the requested information.
+ </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="basic-signals-errorresponse.html">Error response</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> If an issued command or message could not be applied, an appropriate error response conveys this error information back to the issuer. Failure of a command or message can have various reasons, starting from missing permissions to internal server errors during processing of the command. The... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="basic-signals-event.html">Event</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Events report that something took place in a digital twin in Ditto. Important is the “past tense” here; it took already place (it was for example persisted into the data store) and cannot be reversed or stopped. Events are one of the centerpieces of Ditto: they are persisted/appended into... </td>
+ </tr>
+
+
+
+
+
+
+ <tr><td><a href="basic-signals.html">Signals</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> Ditto has a concept called Signal which combines common functionality of Commands, Command Responses, Error Responses, Events and Announcements. Such common functionality is for example that all those have header fields in which they can be for example correlated to each other.... </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ </tbody>
+</table>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2.0/tag_troubleshooting.html b/2.0/tag_troubleshooting.html
new file mode 100644
index 0000000..cd09eeb
--- /dev/null
+++ b/2.0/tag_troubleshooting.html
@@ -0,0 +1,2703 @@
+<!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=" ">
+<title> Troubleshooting topics • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Troubleshooting topics">{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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Troubleshooting topics</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>The following pages and posts are tagged with <button type="button" style="cursor: default" class="btn btn-default navbar-btn">troubleshooting</button></p>
+<table><thead><tr><th>Title</th><th>Type</th><th>Excerpt</th></tr></thead>
+ <tbody>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ <tr><td><a href="feedback.html">Feedback</a></td>
+ <td><span class="label label-default">Page</span></td>
+ <td> You have following possibilities in order to get support or give feedback:
+
+
+ Join the chat at https://gitter.im/eclipse/ditto for questions
+ As your question on StackOverflow
+ send a message to the mailing-list
+ create a GitHub issue
+
+ </td>
+ </tr>
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ </tbody>
+</table>
+
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/2017-11-10-welcome-to-ditto.html b/2017-11-10-welcome-to-ditto.html
index ed7118d..62c172e 100644
--- a/2017-11-10-welcome-to-ditto.html
+++ b/2017-11-10-welcome-to-ditto.html
@@ -280,7 +280,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 78b5c87..b4f3da2 100644
--- a/2017-12-18-milestone-announcement-010-M1.html
+++ b/2017-12-18-milestone-announcement-010-M1.html
@@ -284,7 +284,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 01b8861..d9434a6 100644
--- a/2018-01-12-milestone-announcement-010-M3.html
+++ b/2018-01-12-milestone-announcement-010-M3.html
@@ -303,7 +303,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 da607ec..0c2e5d6 100644
--- a/2018-01-15-example-demonstrating-rest-to-websocket.html
+++ b/2018-01-15-example-demonstrating-rest-to-websocket.html
@@ -292,7 +292,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 6ffd93f..cd18c6e 100644
--- a/2018-02-07-milestone-announcement-020-M1.html
+++ b/2018-02-07-milestone-announcement-020-M1.html
@@ -304,7 +304,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 af72a0d..8646a36 100644
--- a/2018-02-08-feature-definition.html
+++ b/2018-02-08-feature-definition.html
@@ -334,7 +334,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 174b4c0..695eaae 100644
--- a/2018-04-25-connectivity-service.html
+++ b/2018-04-25-connectivity-service.html
@@ -348,7 +348,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 3b6c350..647b155 100644
--- a/2018-04-26-milestone-announcement-030-M1.html
+++ b/2018-04-26-milestone-announcement-030-M1.html
@@ -300,7 +300,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 3aefdef..b235af7 100644
--- a/2018-05-02-connecting-ditto-hono.html
+++ b/2018-05-02-connecting-ditto-hono.html
@@ -1022,7 +1022,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 ca9934e..1f0e234 100644
--- a/2018-06-15-milestone-announcement-030-M2.html
+++ b/2018-06-15-milestone-announcement-030-M2.html
@@ -300,7 +300,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 cd42910..ccf0650 100644
--- a/2018-08-14-milestone-announcement-080-M1.html
+++ b/2018-08-14-milestone-announcement-080-M1.html
@@ -300,7 +300,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 7dad4f0..36fb04c 100644
--- a/2018-09-21-selective-push-notifications.html
+++ b/2018-09-21-selective-push-notifications.html
@@ -500,7 +500,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 a6798ef..1e9926e 100644
--- a/2018-09-27-milestone-announcement-080-M2.html
+++ b/2018-09-27-milestone-announcement-080-M2.html
@@ -302,7 +302,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 90f124d..3ba8a44 100644
--- a/2018-10-16-example-mqtt-bidirectional.html
+++ b/2018-10-16-example-mqtt-bidirectional.html
@@ -308,7 +308,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 ef5292a..8696ae8 100644
--- a/2018-11-14-milestone-announcement-080-M3.html
+++ b/2018-11-14-milestone-announcement-080-M3.html
@@ -301,7 +301,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 31e6255..c630cae 100644
--- a/2018-11-28-release-announcement-080.html
+++ b/2018-11-28-release-announcement-080.html
@@ -296,7 +296,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 d7e1dfb..14d3df7 100644
--- a/2018-12-05-example-command-and-control.html
+++ b/2018-12-05-example-command-and-control.html
@@ -535,7 +535,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 4859e0f..fc663be 100644
--- a/2019-03-13-kafka-connectivity.html
+++ b/2019-03-13-kafka-connectivity.html
@@ -282,7 +282,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 ec5929a..0a7cd8d 100644
--- a/2019-03-28-milestone-announcement-090-M1.html
+++ b/2019-03-28-milestone-announcement-090-M1.html
@@ -298,7 +298,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 253685b..0803018 100644
--- a/2019-04-29-milestone-announcement-090-M2.html
+++ b/2019-04-29-milestone-announcement-090-M2.html
@@ -296,7 +296,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 5a422a5..331e8e6 100644
--- a/2019-07-10-release-announcement-090.html
+++ b/2019-07-10-release-announcement-090.html
@@ -302,7 +302,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 a9dfa1c..5d69cec 100644
--- a/2019-08-28-openid-connect.html
+++ b/2019-08-28-openid-connect.html
@@ -348,7 +348,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 65defd8..aa9f96b 100644
--- a/2019-09-17-milestone-announcement-100-M1a.html
+++ b/2019-09-17-milestone-announcement-100-M1a.html
@@ -299,7 +299,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 7867369..6591fce 100644
--- a/2019-10-17-http-connectivity.html
+++ b/2019-10-17-http-connectivity.html
@@ -307,7 +307,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 16fd979..7e3a654 100644
--- a/2019-11-04-milestone-announcement-100-M2.html
+++ b/2019-11-04-milestone-announcement-100-M2.html
@@ -298,7 +298,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 5107dac..2ac44ed 100644
--- a/2019-12-12-release-announcement-100.html
+++ b/2019-12-12-release-announcement-100.html
@@ -246,7 +246,7 @@
- <p>Today the Eclipse Ditto is thrilled to announce the availability of Eclipse Ditto’s first major release
+ <p>Today the Eclipse Ditto team is thrilled to announce the availability of Eclipse Ditto’s first major release
<a href="https://projects.eclipse.org/projects/iot.ditto/releases/1.0.0">1.0.0</a>.</p>
<h2 id="maturity">Maturity</h2>
@@ -347,7 +347,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 1404a14..31e7cd8 100644
--- a/2020-04-16-connecting-to-ttn-via-mqtt.html
+++ b/2020-04-16-connecting-to-ttn-via-mqtt.html
@@ -794,7 +794,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 c055680..529fb4f 100644
--- a/2020-04-29-release-announcement-110.html
+++ b/2020-04-29-release-announcement-110.html
@@ -276,7 +276,7 @@
</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>Deprecation of API version 1 (authorization via ACL mechanism)</li>
<li>Use of CBOR as cluster internal replacement for JSON serialization</li>
<li>Further improvements on increasing throughput</li>
</ul>
@@ -328,7 +328,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2020-08-31-release-announcement-120.html b/2020-08-31-release-announcement-120.html
index 3b72170..dfdbf11 100644
--- a/2020-08-31-release-announcement-120.html
+++ b/2020-08-31-release-announcement-120.html
@@ -306,7 +306,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2020-09-30-release-announcement-130.html b/2020-09-30-release-announcement-130.html
index c4ec6de..5e3d69a 100644
--- a/2020-09-30-release-announcement-130.html
+++ b/2020-09-30-release-announcement-130.html
@@ -306,7 +306,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2020-10-08-asynchronous-client-creation.html b/2020-10-08-asynchronous-client-creation.html
index e6d105b..0e3b0d4 100644
--- a/2020-10-08-asynchronous-client-creation.html
+++ b/2020-10-08-asynchronous-client-creation.html
@@ -340,7 +340,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2020-10-23-end-2-end-acknowledgment.html b/2020-10-23-end-2-end-acknowledgment.html
index 31c7220..0f0b7a1 100644
--- a/2020-10-23-end-2-end-acknowledgment.html
+++ b/2020-10-23-end-2-end-acknowledgment.html
@@ -581,7 +581,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2020-10-28-release-announcement-140.html b/2020-10-28-release-announcement-140.html
index 691447f..22c3c4d 100644
--- a/2020-10-28-release-announcement-140.html
+++ b/2020-10-28-release-announcement-140.html
@@ -304,7 +304,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2020-11-11-desired-properties.html b/2020-11-11-desired-properties.html
index cd6060c..362e249 100644
--- a/2020-11-11-desired-properties.html
+++ b/2020-11-11-desired-properties.html
@@ -408,7 +408,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2020-11-16-weak-acknowledgements.html b/2020-11-16-weak-acknowledgements.html
index e55d549..973a25d 100644
--- a/2020-11-16-weak-acknowledgements.html
+++ b/2020-11-16-weak-acknowledgements.html
@@ -365,7 +365,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2020-12-10-release-announcement-150.html b/2020-12-10-release-announcement-150.html
index 803a380..495eb41 100644
--- a/2020-12-10-release-announcement-150.html
+++ b/2020-12-10-release-announcement-150.html
@@ -306,7 +306,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2021-01-22-policy-subject-activate-token-integration.html b/2021-01-22-policy-subject-activate-token-integration.html
index 29a15f1..1a0d20e 100644
--- a/2021-01-22-policy-subject-activate-token-integration.html
+++ b/2021-01-22-policy-subject-activate-token-integration.html
@@ -465,7 +465,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2021-02-04-merge-feature.html b/2021-02-04-merge-feature.html
index 903c07c..d4a7ed5 100644
--- a/2021-02-04-merge-feature.html
+++ b/2021-02-04-merge-feature.html
@@ -604,7 +604,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2021-03-22-azure-iot-hub-integration.html b/2021-03-22-azure-iot-hub-integration.html
index 410cdec..a2ae5c6 100644
--- a/2021-03-22-azure-iot-hub-integration.html
+++ b/2021-03-22-azure-iot-hub-integration.html
@@ -421,7 +421,7 @@
<p>This can be achieved by configuring an outgoing JavaScript payload mapper in the message connection:</p>
<div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">function</span> <span class="nx">mapFromDittoProtocolMsg</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">name</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>
@@ -435,7 +435,7 @@
<span class="kd">let</span> <span class="nx">headers</span> <span class="o">=</span> <span class="nx">dittoHeaders</span><span class="p">;</span>
<span class="kd">let</span> <span class="nx">textPayload</span> <span class="o">=</span> <span class="kc">null</span><span class="p">;</span>
- <span class="kd">let</span> <span class="nx">bytePayload</span> <span class="o">=</span> <span class="nx">Ditto</span><span class="p">.</span><span class="nx">stringToArrayBuffer</span><span class="p">(</span><span class="nx">Ditto</span><span class="p">.</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">toString</span><span class="p">());</span>
+ <span class="kd">let</span> <span class="nx">bytePayload</span> <span class="o">=</span> <span class="nx">Ditto</span><span class="p">.</span><span class="nx">stringToArrayBuffer</span><span class="p">(</span><span class="nx">Ditto</span><span class="p">.</span><span class="nx">buildDittoProtocolMsg</span><span class="p">(</span><span class="nx">namespace</span><span class="p">,</span> <span class="nx">name</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">toString</span><span class="p">());</span>
<span class="kd">let</span> <span class="nx">contentType</span> <span class="o">=</span> <span class="s1">'application/octet-stream'</span><span class="p">;</span>
<span class="k">return</span> <span class="nx">Ditto</span><span class="p">.</span><span class="nx">buildExternalMsg</span><span class="p">(</span>
@@ -521,7 +521,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2021-03-31-ssh-tunneling-for-managed-connections.html b/2021-03-31-ssh-tunneling-for-managed-connections.html
index 95205a4..04e27dc 100644
--- a/2021-03-31-ssh-tunneling-for-managed-connections.html
+++ b/2021-03-31-ssh-tunneling-for-managed-connections.html
@@ -382,7 +382,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/2021-05-06-release-announcement-200.html b/2021-05-06-release-announcement-200.html
new file mode 100644
index 0000000..807abd5
--- /dev/null
+++ b/2021-05-06-release-announcement-200.html
@@ -0,0 +1,382 @@
+<!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 2.0.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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 2.0.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/19a9fd49b6778aef898249fb4f11bd24?s=135" alt="A photo of Thomas Jäckle" />-->
+
+<!--<!– Personal Info. –>-->
+ <!--Written by <a href="https://github.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 2.0.0</h1>
+ <p class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2021-05-06T00:00:00+00:00" itemprop="datePublished">May 6, 2021</time> - Tags:
+
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+
+
+ </p>
+
+
+ </header>
+
+ <div class="post-content" itemprop="articleBody">
+
+
+
+
+
+ <p>Today, ~1.5 years after release <a href="2019-12-12-release-announcement-100.html">1.0.0</a>, the Eclipse Ditto team is happy to
+announce the availability of Eclipse Ditto <a href="https://projects.eclipse.org/projects/iot.ditto/releases/2.0.0">2.0.0</a>.</p>
+
+<p>With the major version 2.0.0 the Ditto team removed technical debt and ended support for APIs which were deprecated
+long ago in order to have a better maintainable codebase. However some awesome new features are included as well.</p>
+
+<h2 id="adoption">Adoption</h2>
+
+<p>Companies are willing to show their adoption of Eclipse Ditto publicly: <a href="https://iot.eclipse.org/adopters/?#iot.ditto">https://iot.eclipse.org/adopters/?#iot.ditto</a></p>
+
+<p>From our various <a href="feedback.html">feedback channels</a> we however know of more adoption.<br />
+If you are making use of Eclipse Ditto, it would be great to show this by adding your company name to that list of
+known adopters.<br />
+In the end, that’s one main way of measuring the success of the project.</p>
+
+<h2 id="changelog">Changelog</h2>
+
+<p>The main improvements and additions of Ditto 2.0.0 are:</p>
+
+<ul>
+ <li>Merge/PATCH updates of digital twins</li>
+ <li>Configurable OpenID Connect / OAuth2.0 claim extraction to be used for authorization</li>
+ <li>Establishing connections to endpoints (via AMQP, MQTT, HTTP) utilizing a Ditto managed SSH tunnel</li>
+ <li>Addition of a DevOps API in order to retrieve all known connections</li>
+ <li>Expiring policy subjects + publishing of announcement message prior to expiry</li>
+ <li>Addition of policy actions in order to inject a policy subject based on a provided JWT</li>
+ <li>Built-in acknowledgement for search updates to have the option of twin updates with strong consistency of the search index</li>
+ <li>Restoring active connection faster after a hard restart of the Ditto cluster via automatic prioritization of connections</li>
+ <li>Support for LastWill/Testament + retain flag for MQTT connections</li>
+</ul>
+
+<p>The step to a major version was done because of the following breaking API changes:</p>
+
+<ul>
+ <li>Removal of “API version 1” (deprecated in <a href="release_notes_110.html#deprecations">Ditto 1.1.0</a>)
+from Ditto’s Java APIs + HTTP API</li>
+ <li>Removal of code in Java APIs marked as <code class="highlighter-rouge">@Deprecated</code></li>
+ <li>Binary incompatible changes to Java APIs</li>
+ <li>Restructuring of Ditto’s Maven modules in order to simplify/ease further development</li>
+</ul>
+
+<p>The following non-functional enhancements are also included:</p>
+
+<ul>
+ <li>Improvement of stability during rolling updates</li>
+ <li>Addition of sharding concept for Ditto internal pub/sub enabling connection of e.g. tens of thousands Websocket Wessions</li>
+ <li>Background cleanup improvements in order to have less impact on DB roundtrip times</li>
+ <li>Update of third party libraries (e.g. Akka)</li>
+ <li>Documentation of deployment via K3S</li>
+</ul>
+
+<p>Please have a look at the <a href="release_notes_200.html">2.0.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>The Ditto JavaScript client release was published on <a href="https://www.npmjs.com/~eclipse_ditto">npmjs.com</a>:</p>
+<ul>
+ <li><a href="https://www.npmjs.com/package/@eclipse-ditto/ditto-javascript-client-dom">@eclipse-ditto/ditto-javascript-client-dom</a></li>
+ <li><a href="https://www.npmjs.com/package/@eclipse-ditto/ditto-javascript-client-node">@eclipse-ditto/ditto-javascript-client-node</a></li>
+</ul>
+
+<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>
+
+<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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/404.html b/404.html
index 9055fad..ae8fa4f 100644
--- a/404.html
+++ b/404.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1740,7 +1743,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/advanced-data-by-pass.html b/advanced-data-by-pass.html
index 5716180..b87c2de 100644
--- a/advanced-data-by-pass.html
+++ b/advanced-data-by-pass.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1719,17 +1722,25 @@
- <p>This pattern centers around the idea to delegate the data transmission to external services, by-passing the Ditto cluster, while still being able to benefit from Ditto’s <a href="basic-policy.html">policy system</a> and IoT architecture.</p>
+ <p>This pattern centers around the idea to delegate the data transmission to external services, by-passing the Ditto cluster,
+while still being able to benefit from Ditto’s <a href="basic-policy.html">policy system</a> and IoT architecture.</p>
<h2 id="context">Context</h2>
-<p>You have services exposing their functionality transparently though Ditto’s messaging API as part of your digital twin. E.g. a history service providing the actual interface to your timeseries database as part of the things interface such that a client may not need to know if the history actually is managed by the thing itself or any other program. You use Ditto’s <a href="basic-policy.html">policy system</a> to secure access to your services that way.</p>
+<p>You have services exposing their functionality transparently though Ditto’s messaging API as part of your digital twin.
+E.g. a history service providing the actual interface to your timeseries database as part of the things interface such
+that a client may not need to know if the history actually is managed by the thing itself or any other program.
+You use Ditto’s <a href="basic-policy.html">policy system</a> to secure access to your services that way.</p>
-<p>Your services provide data in quantities that are not suited for transmission through the Ditto cluster directly, because of (de-)serialization costs, round-trip-times etc.</p>
+<p>Your services provide data in quantities that are not suited for transmission through the Ditto cluster directly,
+because of (de-)serialization costs, round-trip-times etc.</p>
<h2 id="problem">Problem</h2>
-<p>You want to query a greater amount of data (e.g. database query result) by issuing a Ditto message to a thing which is picked up by a service speaking with you databases. It does not work to just let this service return the result as a response to the Ditto message, since the messaging system in the Ditto cluster is not designed for big quantities of data and will reject them based on tight quotas. Also the costs due to many (de-)serialization steps are high.</p>
+<p>You want to query a greater amount of data (e.g. database query result) by issuing a Ditto message to a thing which is
+picked up by a service speaking with you databases. It does not work to just let this service return the result
+as a response to the Ditto message, since the messaging system in the Ditto cluster is not designed for big quantities
+of data and will reject them based on tight quotas. Also the costs due to many (de-)serialization steps are high.</p>
<h2 id="solution">Solution</h2>
@@ -1737,21 +1748,33 @@
<ul>
<li><strong>database</strong>: where your bigger chunks of data reside and wait to be delivered / queried</li>
- <li><strong>database provider mirco-service</strong>: the service managing the database connection and exposing it to clients through things messaging API</li>
+ <li><strong>database provider mirco-service</strong>: the service managing the database connection and exposing it to clients through
+things messaging API</li>
<li><strong>thing</strong>: a digital twin with extended API through a micro-service</li>
- <li><strong>client</strong>: a client-application trying to receive bigger quantities of data via a things messaging API in the scope of that thing and secured via ditto policies</li>
- <li><strong>high-performance data proxy</strong> (or just proxy): a third-party application proxy sitting in-between the database and the provider micro-service managing data delivery</li>
+ <li><strong>client</strong>: a client-application trying to receive bigger quantities of data via a things messaging API in the scope
+of that thing and secured via ditto policies</li>
+ <li><strong>high-performance data proxy</strong> (or just proxy): a third-party application proxy sitting in-between the database and
+the provider micro-service managing data delivery</li>
</ul>
<figure><img class="docimage" src="images/pages/advanced/data-by-pass-architectural-design.jpg" alt="Architectural Design" style="max-width: 800px" /><figcaption>Architectural design of the data by-pass pattern showing all actors and their interactions.</figcaption></figure>
-<p>In order for the client-application to retrieve the requested data in a secure and performant way we introduce a high-performance proxy (e.g. based on nginx, example below). The proxy will not have any credentials by itself, it’s just serving prepared queries on a randomly, hard-to-guess URL with an expiration time of 5 minutes. It features an admin API which the micro-service has credentials to access.</p>
+<p>In order for the client-application to retrieve the requested data in a secure and performant way we introduce a
+high-performance proxy (e.g. based on nginx, example below). The proxy will not have any credentials by itself,
+it’s just serving prepared queries on a randomly, hard-to-guess URL with an expiration time of 5 minutes.
+It features an admin API which the micro-service has credentials to access.</p>
-<p>The provider micro-service hooks into a twin (e.g. via websockets) and listens for queries. If a query arrives it will formulate the query, store it at the high-performance proxy (which might already query the data) and return a randomly generated URL to the proxy together with a Location-header as a response to the client-application. The client then needs to follow the response in order to retrieve the data from the proxy.</p>
+<p>The provider micro-service hooks into a twin (e.g. via websockets) and listens for queries.
+If a query arrives it will formulate the query, store it at the high-performance proxy (which might already query the data)
+and return a randomly generated URL to the proxy together with a Location-header as a response to the client-application.
+The client then needs to follow the response in order to retrieve the data from the proxy.</p>
-<p>With this approach the access to the database is secured via Ditto <a href="basic-policy.html">policies</a> and in scope of single things while the data retrieval happens via a performant proxy application without the Ditto cluster ever seeing those packages.</p>
+<p>With this approach the access to the database is secured via Ditto <a href="basic-policy.html">policies</a> and in scope of single
+things while the data retrieval happens via a performant proxy application without the Ditto cluster ever seeing those packages.</p>
-<p><em>Note: Keep in mind that security in this situation is highly dependent of the micro-service implementation. You have to make sure that your implementation uses provided information of ditto properly and that the contents of a message do not allow a violation of the policy. E.g. through SQL-Injections.</em></p>
+<p><em>Note: Keep in mind that security in this situation is highly dependent of the micro-service implementation.
+You have to make sure that your implementation uses provided information of ditto properly and that the contents of
+a message do not allow a violation of the policy. E.g. through SQL-Injections.</em></p>
<h2 id="discussion">Discussion</h2>
@@ -1759,7 +1782,7 @@
<ul>
<li>Higher performance compared to using just Ditto</li>
- <li>The Ditto <a href="basic-policy.html">policy system</a> can be utilized to scope and secure data access from clients to databases / -stores</li>
+ <li>The Ditto <a href="basic-policy.html">policy system</a> can be utilized to scope and secure data access from clients to databases/-stores</li>
</ul>
<p><strong>Drawbacks</strong>:</p>
@@ -1773,14 +1796,17 @@
<p><strong>Issues</strong>:</p>
<ul>
- <li>Managing and communicating custom messaging APIs is not natively supported in Ditto, other ways have to be explored to keep APIs consistent</li>
+ <li>Managing and communicating custom messaging APIs is not natively supported in Ditto, other ways have to be explored to
+keep APIs consistent</li>
</ul>
<h2 id="policies">Policies</h2>
-<p>Policies can be used to restrict access to the provider micro-service and through that eventually to the database using restrictions on the <code class="highlighter-rouge">message:/</code> resource.</p>
+<p>Policies can be used to restrict access to the provider micro-service and through that eventually to the database using
+restrictions on the <code class="highlighter-rouge">message:/</code> resource.</p>
-<p>Let’s assume that the provider micro-service registers via websockets and expects requests to the message-topic <code class="highlighter-rouge">/services/history</code>. With the following policy entry we can allow access to this resource:</p>
+<p>Let’s assume that the provider micro-service registers via websockets and expects requests to the message-topic
+<code class="highlighter-rouge">/services/history</code>. With the following policy entry we can allow access to this resource:</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">"subjects"</span><span class="p">:</span><span class="w"> </span><span class="p">{},</span><span class="w">
@@ -1801,21 +1827,37 @@
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
-<p>The first resource entry revokes any access to messages for subjects of this type. This is optional. The next entry allows the provider micro-service to read messages from the topic <code class="highlighter-rouge">/services/history</code>. Note that we’ve decided to insert another “namespace” <code class="highlighter-rouge">/services</code> here to distinguish these messages from other device faced messages. The last section than allows the provider micro-service to reply to the received requests with it’s 303 response.</p>
+<p>The first resource entry revokes any access to messages for subjects of this type. This is optional. The next entry
+allows the provider micro-service to read messages from the topic <code class="highlighter-rouge">/services/history</code>. Note that we’ve decided to insert
+another “namespace” <code class="highlighter-rouge">/services</code> here to distinguish these messages from other device faced messages. The last section
+than allows the provider micro-service to reply to the received requests with it’s 303 response.</p>
-<p>This can also be built against single features. Since features have to be stated explicitly in the policy, this is not as general but can provide a more fine-grained access control when using distinct policies for different things, or features with same names over multiple things.</p>
+<p>This can also be built against single features. Since features have to be stated explicitly in the policy, this is not
+as general but can provide a more fine-grained access control when using distinct policies for different things,
+or features with same names over multiple things.</p>
<h2 id="proxy-implementations">Proxy Implementations</h2>
-<p>The <a href="https://github.com/sourcelair/ceryx">ceryx proxy project</a> was used for the <a href="https://github.com/w4tsn/ceryx">PoC (or reference implementation)</a> of this pattern. It was enhanced with delegation features which still have to be contributed upstream. Have a look at the <a href="https://github.com/w4tsn/ceryx">forks source code</a> or the <a href="https://quay.io/repository/w4tsn/ceryx">corresponding container image</a> until then.</p>
+<p>The <a href="https://github.com/sourcelair/ceryx">ceryx proxy project</a> was used for the
+<a href="https://github.com/w4tsn/ceryx">PoC (or reference implementation)</a> of this pattern.
+It was enhanced with delegation features which still have to be contributed upstream.
+Have a look at the <a href="https://github.com/w4tsn/ceryx">forks source code</a> or
+the <a href="https://quay.io/repository/w4tsn/ceryx">corresponding container image</a> until then.</p>
-<p>The ceryx proxy is a modified nginx with a redis-database to store the randomly generated IDs correlating with prepared queries. It is not suited for this use-case on its own so capabilities to store queries (including Authentication) behind expiring random URLs was added, but not send upstream yet.</p>
+<p>The ceryx proxy is a modified nginx with a redis-database to store the randomly generated IDs correlating with prepared queries.
+It is not suited for this use-case on its own so capabilities to store queries (including Authentication) behind
+expiring random URLs was added, but not send upstream yet.</p>
<h2 id="known-uses">Known uses</h2>
-<p><strong><a href="https://www.othermo.de">othermo GmbH</a> uses this for a history-service</strong>: The history service connects to Ditto via websockets and hooks into things by answering specific <code class="highlighter-rouge">/history</code> messages. The messages API is translated to InfluxDB queries which then are stored with a randomly generated URL and expiration of 5 minutes at the high-performance proxy. The service then returns the random URL to the client which then follows the 303 to retrieve the actual data.</p>
+<p><strong><a href="https://www.othermo.de">othermo GmbH</a> uses this for a history-service</strong>: The history service connects to Ditto via
+websockets and hooks into things by answering specific <code class="highlighter-rouge">/history</code> messages. The messages API is translated to InfluxDB queries
+which then are stored with a randomly generated URL and expiration of 5 minutes at the high-performance proxy.
+The service then returns the random URL to the client which then follows the 303 to retrieve the actual data.</p>
-<p>The messages contain InfluxDB-similar query elements while the query is only constructed at the provider service. That’s because the provider service uses the databases specifics like Tags in InfluxDB to assign thingId, policy and path information in order to get the stored data into the right scopes and to be able to retrieve the correct sets of data.</p>
+<p>The messages contain InfluxDB-similar query elements while the query is only constructed at the provider service.
+That’s because the provider service uses the databases specifics like Tags in InfluxDB to assign thingId, policy and
+path information in order to get the stored data into the right scopes and to be able to retrieve the correct sets of data.</p>
<div class="tags">
@@ -1842,7 +1884,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 c44f03f..ad3fd14 100644
--- a/architecture-overview.html
+++ b/architecture-overview.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1762,9 +1765,9 @@
<a href="https://doc.akka.io/docs/akka/current/general/remoting.html">Akka remoting</a> which means that each service acts as server,
providing a TCP endpoint, as well as client sending data to other services.</p>
-<p>Therefore it is required that all Ditto microservices can reach each others port <code class="highlighter-rouge">2551</code>.</p>
+<p>Therefore, it is required that all Ditto microservices can reach each others port <code class="highlighter-rouge">2551</code>.</p>
-<p>Another consequence is that all messages which are send between Ditto microservices are in a way serializable and deserializable.
+<p>Another consequence is that all messages which are sent between Ditto microservices are in a way serializable and deserializable.
All Ditto <a href="basic-signals.html">signals</a> can be serialized from Java objects to JSON representation and deserialized back
from JSON to Java objects.</p>
@@ -1793,7 +1796,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 6883e3b..21961f6 100644
--- a/architecture-services-concierge.html
+++ b/architecture-services-concierge.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1779,7 +1782,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 1c56554..7b3d5fb 100644
--- a/architecture-services-connectivity.html
+++ b/architecture-services-connectivity.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1793,7 +1796,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 bd63c13..c98c98b 100644
--- a/architecture-services-gateway.html
+++ b/architecture-services-gateway.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1772,7 +1775,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 4474ebb..a54e309 100644
--- a/architecture-services-policies.html
+++ b/architecture-services-policies.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1726,7 +1729,7 @@
<p>The model of the policies service is defined around the entity <code class="highlighter-rouge">Policy</code>:</p>
<ul>
- <li><a href="https://github.com/eclipse/ditto/tree/master/model/policies/src/main/java/org/eclipse/ditto/model/policies">model</a></li>
+ <li><a href="https://github.com/eclipse/ditto/tree/master/model/policies/src/main/java/org/eclipse/ditto/model/policies">Policy model</a></li>
</ul>
<h2 id="signals">Signals</h2>
@@ -1772,7 +1775,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 203f8c8..7baa2bf 100644
--- a/architecture-services-things-search.html
+++ b/architecture-services-things-search.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,15 +1726,15 @@
<ul>
<li>updating an optimized search index of <code class="highlighter-rouge">Things</code> based on the <a href="basic-signals-event.html">events</a> emitted by the
-<a href="architecture-services-things.html">things</a> and <a href="architecture-services-policies.html">policies</a> services when entites
+<a href="architecture-services-things.html">things</a> and <a href="architecture-services-policies.html">policies</a> services when entities
are changed there</li>
<li>executing search queries against the search index in order to find out which <code class="highlighter-rouge">Things</code> match a given search</li>
</ul>
<h2 id="model">Model</h2>
-<p>The things-search service has no model (entity) by its own, but uses the model of <a href="architecture-services-things.html">things</a> and
-<a href="architecture-services-policies.html">policies</a> services.</p>
+<p>The things-search service has no model (entity) by its own, but uses the model of <a href="architecture-services-things.html">things</a>
+and <a href="architecture-services-policies.html">policies</a> services.</p>
<p>It however contains a model which can transform an <a href="#" data-toggle="tooltip" data-original-title="Resource Query Language">RQL</a>
search query into a Java domain model which is defined here:</p>
@@ -1816,7 +1819,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 56e5c60..82c55a4 100644
--- a/architecture-services-things.html
+++ b/architecture-services-things.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1726,7 +1729,7 @@
<p>The model of the things service is defined around the entities <code class="highlighter-rouge">Thing</code> and <code class="highlighter-rouge">Feature</code>:</p>
<ul>
- <li><a href="https://github.com/eclipse/ditto/tree/master/model/things/src/main/java/org/eclipse/ditto/model/things">model</a></li>
+ <li><a href="https://github.com/eclipse/ditto/tree/master/model/things/src/main/java/org/eclipse/ditto/model/things">Thing model</a></li>
</ul>
<h2 id="signals">Signals</h2>
@@ -1772,7 +1775,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 fe46f63..2584ec7 100644
--- a/basic-acknowledgements.html
+++ b/basic-acknowledgements.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1962,7 +1965,7 @@
This means that it is not possible to establish a second websocket connection with the same declared acknowledgements
before closing the first one.</p>
-<div class="alert alert-danger" role="alert"><i class="fa fa-exclamation-circle"></i> <b>Warning:</b> Therefore it is not recommended relying on the websocket API for high
+<div class="alert alert-danger" role="alert"><i class="fa fa-exclamation-circle"></i> <b>Warning:</b> Therefore, it is not recommended relying on the websocket API for high
availability scenarios.</div>
<h3 id="issuing-acks-via-connections">Issuing ACKs via connections</h3>
@@ -2409,7 +2412,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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
deleted file mode 100644
index c009efe..0000000
--- a/basic-acl.html
+++ /dev/null
@@ -1,1849 +0,0 @@
-<!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, authentication, authorization, auth, acl, access control">
-<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">
-<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="Eclipse 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="sandbox.html">Sandbox</a></li>
-
-
-
-
- <li><a href="https://github.com/eclipse/ditto" target="_blank">
- <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
- </a></li>
-
-
-
-
-
- <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
- <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
- </a></li>
-
-
-
-
-
- <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
- <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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="Access control list (ACL) - Deprecated">{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>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
-
- <option value="1.4">1.4</option>
-
- <option value="1.5">1.5</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_151.html">1.5.1</a></li>
-
-
-
-
-
-
- <li><a href="release_notes_150.html">1.5.0</a></li>
-
-
-
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
- <li class="subfolders">
- <a href="#"><span></span>Archive</a>
- <ul>
-
-
-
- <li><a href="release_notes_130.html">1.3.0</a></li>
-
-
-
-
-
- <li><a href="release_notes_121.html">1.2.1</a></li>
-
-
-
-
-
- <li><a href="release_notes_120.html">1.2.0</a></li>
-
-
-
-
-
- <li><a href="release_notes_115.html">1.1.5</a></li>
-
-
-
-
-
- <li><a href="release_notes_113.html">1.1.3</a></li>
-
-
-
-
-
- <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>
-
-
-
-
-
- <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><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 class="active"><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>
-
-
-
-
-
- <li><a href="basic-metadata.html">Thing Metadata</a></li>
-
-
-
-
-
- <li><a href="basic-errors.html">Errors</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>
-
-
-
-
-
- <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
-
-
-
-
- </ul>
- </li>
-
-
-
-
-
- <li class="subfolders">
- <a href="#"><span></span>Advanced concepts</a>
- <ul>
-
-
-
- <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
-
-
-
-
-
-
- <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-merge.html">Merge</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>
-
-
-
-
-
- <li><a href="protocol-specification-errors.html">Errors</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>
-
-
-
-
-
- <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
-
-
-
- </ul>
- </li>
-
-
-
- <li class="subfolders">
- <a href="#"><span></span>→ Things merge examples</a>
- <ul>
-
-
-
- <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
-
-
-
-
-
- <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
-</script>
-
- </div>
-
-
-
- <!-- Content Column -->
- <div class="col-md-9" id="tg-sb-content">
- <div class="post-header">
- <h1 class="post-title-main">Access control list (ACL) - Deprecated</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>Entries in 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> configure the
-permissions for subjects. A subject is identified by an arbitrary ID.</p>
-
-<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> The ACL concept is only supported for Ditto <strong>HTTP API version 1</strong>. <br />
- For Ditto <strong>HTTP API version 2</strong> we have introduced the <a href="basic-policy.html">Policies</a> concept.</div>
-
-<h2 id="authorization-subject">Authorization Subject</h2>
-
-<p>A <em>subject</em> can have following type of permission: read, write, administrate.</p>
-
-<ul>
- <li>A subject that has <a href="basic-acl.html#read">READ</a> permission is allowed to read all data of a Thing, i.e. its Attributes,
-Features and ACL.</li>
- <li><a href="basic-acl.html#write">WRITE</a> permission is required to be able to set data of the Thing or to send messages to a
-Thing or Feature.</li>
- <li>To be able to modify the ACL itself, a subject needs <a href="basic-acl.html#administrate">ADMINISTRATE</a> permission.</li>
-</ul>
-
-<p>When a Thing is initially created at least one entry of the ACL with READ, WRITE and ADMINISTRATE permission is
-mandatory and must be provided.
-If there is no ACL provided when creating a new Thing, a default ACL will be created.
-The default ACL entry consists of a subject ID (e.g. the ID of the currently logged in user), and all 3 permissions.</p>
-
-<p>Also, there must always be at least one entry with all permissions.
-The last entry cannot be deleted or changed to not include all permissions.</p>
-
-<h2 id="read">READ</h2>
-
-<p>Allows to read a Thing. This includes reading its ACL, Attributes, Features and their Properties.</p>
-
-<p>The forwarding of messages to Subscribers is also secured according to the ACL entries on the Things themselves.
-E.g. only entities with READ permission on the Thing will be notified about changes related to that Thing and its Features.</p>
-
-<h2 id="write">WRITE</h2>
-
-<p>Allows to write/modify a Thing.
-E.g. create/update/delete Things, Attributes, Features and their Properties, execute Feature operations.</p>
-
-<p>In order to send messages towards to or receive messages from a Thing one would need WRITE permission on the specific
-Thing.</p>
-
-<h2 id="administrate">ADMINISTRATE</h2>
-
-<p>Allows to modify the ACL of a Thing and to create/modify/delete its entries according to the restrictions mentioned before.</p>
-
-<h2 id="example-for-an-access-control-list">Example for an Access Control List</h2>
-
-<p>The following example shows the ACL JSON object of a Thing.</p>
-
-<p>The first authorization subject is the ID of the default nginx user “ditto”.
-The second one is the ID of another user “adam” who additionally has <code class="highlighter-rouge">WRITE</code> and <code class="highlighter-rouge">ADMINISTRATE</code> permission.</p>
-
-<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="s2">"acl"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
- </span><span class="s2">"ditto"</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">false</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">false</span><span class="w">
- </span><span class="p">},</span><span class="w">
- </span><span class="s2">"adam"</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></code></pre></div></div>
-
-
- <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">
- ©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <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/basic-apis.html b/basic-apis.html
index 13f4e60..06d2e39 100644
--- a/basic-apis.html
+++ b/basic-apis.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1796,11 +1799,6 @@
<td>✓</td>
<td>✓ (v2 only)</td>
</tr>
- <tr>
- <td>Access control via ACL</td>
- <td>✓</td>
- <td>✓ (v1 only)</td>
- </tr>
</tbody>
</table>
@@ -1868,7 +1866,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 848a6d6..12ba94f 100644
--- a/basic-auth.html
+++ b/basic-auth.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1729,7 +1732,7 @@
<p>On all APIs Ditto protects functionality and data by using</p>
<ul>
- <li><strong>Authentication</strong> to make sure the requester is the one she claims to be,</li>
+ <li><strong>Authentication</strong> to make sure the requester is the one he/she claims to be,</li>
<li><strong>Authorization</strong> to make sure the requester is allowed to see, use or change the information he wants to access.</li>
</ul>
@@ -1770,8 +1773,9 @@
<li>Establishing a <a href="httpapi-protocol-bindings-websocket.html">WebSocket</a> connection for bidirectional communication with
Ditto via <a href="protocol-overview.html">Ditto Protocol</a> JSON messages
<ul>
- <li>open: sending along the <code class="highlighter-rouge">Authorization</code> header containing the <code class="highlighter-rouge">Bearer</code> JWT token is not possible in the plain
-WebSocket API in the browser - Watch issue <a href="https://github.com/eclipse/ditto/issues/667">#661</a> for fixing that</li>
+ <li>sending along a JWT token as <code class="highlighter-rouge">Authorization</code> header with <code class="highlighter-rouge">Bearer</code> value (recommended)</li>
+ <li>sending along a JWT token as query parameter <code class="highlighter-rouge">access_token</code> (use only if the websocket client does not
+ support setting http headers e.g. plain WebSocket API of browsers)</li>
</ul>
</li>
<li>Opening a <a href="httpapi-sse.html">Server sent event</a> connection in order to receive change notifications of twins in the
@@ -1784,11 +1788,10 @@
<h2 id="authorization">Authorization</h2>
-<p>Authorization is implemented with an <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>
-(in API version 1) or a <a href="#" data-toggle="tooltip" data-original-title="A Policy enables developers to configure fine-grained access control in an easy way. A specific policy defines who (subject) is granted or revoked permissions (rights) on a specific resource. The resource can be defined as rough or as fine-grained as necessary for the respective use case. ">Policy</a>
+<p>Authorization is implemented with a <a href="#" data-toggle="tooltip" data-original-title="A Policy enables developers to configure fine-grained access control in an easy way. A specific policy defines who (subject) is granted or revoked permissions (rights) on a specific resource. The resource can be defined as rough or as fine-grained as necessary for the respective use case. ">Policy</a>
(in API version 2).</p>
-<p>Please find details at <a href="basic-acl.html">ACL</a> and <a href="basic-policy.html">Policies</a>.</p>
+<p>Please find details at <a href="basic-policy.html">Policies</a>.</p>
<h3 id="authorization-context-in-devops-commands">Authorization Context in DevOps Commands</h3>
@@ -1825,7 +1828,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 15decd6..fceeb99 100644
--- a/basic-changenotifications.html
+++ b/basic-changenotifications.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1758,8 +1761,8 @@
<h3 id="by-rql-expression">By RQL expression</h3>
-<p>If filtering by namespaces it not sufficient, Ditto also allows to provide an <a href="basic-rql.html">RQL expression</a> specifying a
-Thing payload based condition determining which events should be emitted and which don’t.</p>
+<p>If filtering by namespaces it not sufficient, Ditto also allows to provide an <a href="basic-rql.html">RQL expression</a> specifying
+a Thing payload based condition determining which events should be emitted and which don’t.</p>
<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> This filter is applied on the modified data of a Thing, data which was not changed will
not be considered when applying the filter.</div>
@@ -1812,7 +1815,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 d7f3ddc..95119a2 100644
--- a/basic-connections.html
+++ b/basic-connections.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1722,8 +1725,7 @@
<h2 id="connection-model">Connection model</h2>
<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> To get started with connections right away, consult the
- <a href="connectivity-manage-connections.html">Manage connections</a>
- page. </div>
+ <a href="connectivity-manage-connections.html">Manage connections</a> page. </div>
<p>You can integrate your Ditto instance with external messaging services such as
<a href="https://eclipse.org/hono/">Eclipse Hono</a>, a <a href="https://www.rabbitmq.com/">RabbitMQ</a> broker or an
@@ -1732,11 +1734,11 @@
<p>Additionally, you may invoke foreign HTTP endpoints by using the
<a href="connectivity-protocol-bindings-http.html">HTTP connection type</a>.</p>
-<p>A connection represents a communication channel for the exchange of messages between any service and Ditto. It
-requires a transport protocol, which is used to transmit <a href="protocol-overview.html">Ditto Protocol</a> messages. Ditto supports one-way and two-way
-communication over connections. This enables consumer/producer scenarios as well as fully-fledged command and response
-use cases. Nevertheless, those options might be limited by the transport protocol or the other endpoint’s
-capabilities.</p>
+<p>A connection represents a communication channel for the exchange of messages between any service and Ditto.
+It requires a transport protocol, which is used to transmit <a href="protocol-overview.html">Ditto Protocol</a> messages.
+Ditto supports one-way and two-way communication over connections. This enables consumer/producer scenarios
+as well as fully-fledged command and response use cases. Nevertheless, those options might be limited by
+the transport protocol or the other endpoint’s capabilities.</p>
<p>All connections are configured and supervised via Ditto’s
<a href="architecture-services-connectivity.html">Connectivity service</a>. The following model defines the connection itself:</p>
@@ -1747,7 +1749,7 @@
<p>The top design priority of this model is to be as generic as possible, while still allowing protocol specific
customizations and tweaks. This enables the implementations of different customizable connection types, and support
-for custom payload formats. Currently the following connection types are supported:</p>
+for custom payload formats. Currently, the following connection types are supported:</p>
<ul>
<li><a href="connectivity-protocol-bindings-amqp091.html">AMQP 0.9.1</a></li>
@@ -1775,11 +1777,14 @@
<p>Sources contain:</p>
<ul>
- <li>several addresses (depending on the <a href="#connection-types">connection type</a> those are interpreted differently, e.g. as queues, topics, etc.),</li>
+ <li>several addresses (depending on the <a href="#connection-types">connection type</a> those are interpreted differently,
+e.g. as queues, topics, etc.),</li>
<li>a consumer count defining how many consumers should be attached to each source address,</li>
- <li>an authorization context (see <a href="#authorization">authorization</a>) specifying which <a href="basic-acl.html#authorization-subject">authorization subject</a> is used to authorize messages from the source,</li>
+ <li>an authorization context (see <a href="#authorization">authorization</a>) specifying which
+<a href="basic-policy.html#subjects">authorization subject</a> is used to authorize messages from the source,</li>
<li>enforcement information that allows filtering the messages that are consumed in this source,</li>
- <li><a href="basic-acknowledgements.html#requesting-acks">acknowledgement requests</a> this source requires in order to ensure QoS 1 (“at least once”) processing of consumed messages before technically acknowledging them to the channel,</li>
+ <li><a href="basic-acknowledgements.html#requesting-acks">acknowledgement requests</a> this source requires in order
+to ensure QoS 1 (“at least once”) processing of consumed messages before technically acknowledging them to the channel,</li>
<li>declared labels of <a href="protocol-specification-acks.html">acknowledgements</a> the source is allowed to send,</li>
<li><a href="connectivity-header-mapping.html">header mapping</a> for mapping headers of source messages to internal headers, and</li>
<li>a reply-target to configure publication of any responses of incoming commands.</li>
@@ -1791,11 +1796,11 @@
the default mapping for <a href="protocol-overview.html">Ditto Protocol</a> messages.</p>
<p>During this mapping the digital twin of the device is determined i.e.
-which thing is accessed or modified as a result of the message. By default, no sanity check is done if this target thing
-corresponds to the device that originally sent the message. In some use cases this might be valid, but in other scenarios
-you might want to enforce that a device only sends data to its digital twin. Note that this could also be achieved by
-assigning a specific policy to each device and use <a href="#placeholders">placeholders</a> in the
-authorization subject, but this can get cumbersome to maintain for a large number of devices.</p>
+which thing is accessed or modified as a result of the message. By default, no sanity check is done if this target
+thing corresponds to the device that originally sent the message. In some use cases this might be valid, but
+in other scenarios you might want to enforce that a device only sends data to its digital twin.
+Note that this could also be achieved by assigning a specific policy to each device and use <a href="#placeholders">placeholders</a>
+in the authorization subject, but this can get cumbersome to maintain for a large number of devices.</p>
<p>With an enforcement, you can use a single policy for all devices
and still make sure that a device only modifies its associated digital twin. Enforcement is only feasible if the message
@@ -1876,7 +1881,8 @@
</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>.
+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-acknowledgement-requests">Source acknowledgement requests</h4>
@@ -1889,8 +1895,8 @@
<p>In order to process messages from sources with an “at least once” (or QoS 1) semantic, configure the source’s
<code class="highlighter-rouge">"acknowledgementRequests/includes"</code> to add the
-<a href="basic-acknowledgements.html#built-in-acknowledgement-labels">“twin-persisted”</a> acknowledgement request, which will cause
-that a consumed message over this source will technically be acknowledged, it the twin was
+<a href="basic-acknowledgements.html#built-in-acknowledgement-labels">“twin-persisted”</a> acknowledgement request, which will
+cause that a consumed message over this source will technically be acknowledged, it the twin was
successfully updated/persisted by Ditto.</p>
<p>How the technical acknowledgment is done is specific for the used <a href="#connection-types">connection type</a> and documented
@@ -1989,7 +1995,8 @@
The following reply targets are available to choose from:</p>
<ul>
<li><strong>response</strong>: Send back successful responses (e.g. responses after a Thing was successfully modified,
-but also responses for <a href="basic-signals-command.html#query-commands">query commands</a>). Includes positive <a href="protocol-specification-acks.html#acknowledgements-aggregating">acknowledgements</a>.</li>
+but also responses for <a href="basic-signals-command.html#query-commands">query commands</a>).
+Includes positive <a href="protocol-specification-acks.html#acknowledgements-aggregating">acknowledgements</a>.</li>
<li><strong>error</strong>: Send back error responses (e.g. thing not modifiable due to lacking permissions)</li>
<li><strong>nack</strong>: If negative <a href="protocol-specification-acks.html#acknowledgements-aggregating">acknowledgement</a> responses should be delivered.</li>
</ul>
@@ -2027,7 +2034,8 @@
<ul>
<li>one address (that is interpreted differently depending on the <a href="#connection-types">connection type</a>, e.g. as queue, topic, etc.),</li>
<li><a href="#target-topics-and-filtering">topics</a> that will be sent to the target,</li>
- <li>an authorization context (see <a href="#authorization">authorization</a>) specifying which <a href="basic-acl.html#authorization-subject">authorization subject</a> is used to authorize messages to the target, and</li>
+ <li>an authorization context (see <a href="#authorization">authorization</a>) specifying which
+<a href="basic-policy.html#subjects">authorization subject</a> is used to authorize messages to the target, and</li>
<li><a href="connectivity-header-mapping.html">header mapping</a> to compute external headers from Ditto protocol headers.</li>
</ul>
@@ -2085,7 +2093,7 @@
with <code class="highlighter-rouge">&</code>. You need to URL-encode the filter values before using them in a configuration.</p>
<p>For example, this way the connection session would register for all events in the namespace <code class="highlighter-rouge">org.eclipse.ditto</code> and which
-would match an attribute “counter” to be greater than 42. Additionally it would subscribe to messages in the namespace
+would match an attribute “counter” to be greater than 42. Additionally, it would subscribe to messages in the namespace
<code class="highlighter-rouge">org.eclipse.ditto</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">"address"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<target-address>"</span><span class="p">,</span><span class="w">
@@ -2211,8 +2219,8 @@
Ditto becomes the client in this case. Nevertheless, to access resources within Ditto, the connection must know on
whose behalf it is acting. This is controlled via the configured <code class="highlighter-rouge">authorizationContext</code>, which holds a list of
self-assigned authorization subjects. Before a connection can access a Ditto resource, one of its
-<code class="highlighter-rouge">authorizationSubject</code>s must be granted the access rights by an authorization mechanism such as
-<a href="basic-acl.html">ACLs</a> or <a href="basic-policy.html">Policies</a>.</p>
+<code class="highlighter-rouge">authorizationSubject</code>s must be granted the access rights by the authorization mechanism of a
+<a href="basic-policy.html">Policies</a>.</p>
<p>A connection target can only send data for things to which it has READ rights, as data flows from a thing to a target.
A connection source can only receive data for things to which it has WRITE rights, as data flows from a source to a thing.</p>
@@ -2230,14 +2238,16 @@
<p>The configuration of a connection allows to use placeholders at certain places. This allows more fine-grained control
over how messages are consumed or where they are published to. The general syntax of a placeholder is
-<code class="highlighter-rouge">{{ placeholder }}</code>. Have a look at the <a href="basic-placeholders.html">placeholders concept</a> for more details on that.</p>
+<code class="highlighter-rouge">{{ placeholder }}</code>. Have a look at the <a href="basic-placeholders.html">placeholders concept</a> for
+more details on that.</p>
<h3 id="placeholder-for-source-authorization-subjects">Placeholder for source authorization subjects</h3>
<p>Processing the messages received via a source using the <em>same fixed authorization subject</em> may not be
-suitable for every scenario. For example, if you want to declare fine-grained write permissions per device, this would not
-be possible with a fixed global subject. For this use case, we have introduced placeholder substitution for authorization subjects of
-source addresses that are resolved when processing messages from a source. Of course, this requires the sender of the
+suitable for every scenario. For example, if you want to declare fine-grained write permissions per device, this would
+not be possible with a fixed global subject. For this use case, we have introduced placeholder substitution for
+authorization subjects of source addresses that are resolved when processing messages from a source.
+Of course, this requires the sender of the
message to provide necessary information about the original issuer of the message.</p>
<div class="alert alert-warning" role="alert" style=""><i class="fa fa-warning"></i> <b>Important:</b> Only use this kind of placeholder if you trust the source of the message. The value from the header is used as the <strong>authorized subject</strong>.</div>
@@ -2258,8 +2268,8 @@
</span><span class="p">]</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
-<p>The placeholder is then replaced by the value from the message headers and the message is forwarded and processed under the
-subject <em>device:sensor-123</em>.
+<p>The placeholder is then replaced by the value from the message headers and the message is forwarded and processed under
+the subject <em>device:sensor-123</em>.
In case the header cannot be resolved or the header contains unexpected characters, an exception is thrown, which is sent
back to the sender as an error message, if a valid <em>reply-to</em> header was provided, otherwise the message is dropped.</p>
@@ -2267,7 +2277,8 @@
<p>Another use case for placeholders may be to publish twin events or live commands and events to a target address
containing thing-specific information e.g. you can distribute things from different namespaces to different target addresses.
-You can use the placeholders <code class="highlighter-rouge">{{ thing:id }}</code>, <code class="highlighter-rouge">{{ thing:namespace }}</code> and <code class="highlighter-rouge">{{ thing:name }}</code> in the target address for this purpose.
+You can use the placeholders <code class="highlighter-rouge">{{ thing:id }}</code>, <code class="highlighter-rouge">{{ thing:namespace }}</code>
+and <code class="highlighter-rouge">{{ thing:name }}</code> in the target address for this purpose.
For a thing with the ID <em>org.eclipse.ditto:device-123</em> these placeholders would be resolved as follows:</p>
<table>
@@ -2348,7 +2359,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 f93dfc4..c68931e 100644
--- a/basic-enrichment.html
+++ b/basic-enrichment.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1721,16 +1724,16 @@
<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>
+by <code class="highlighter-rouge">extraFields</code> to also be included in the sent message.</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>
+“temperature value was changed to 23.4 for the 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>
+<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>
@@ -1843,7 +1846,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-errors.html b/basic-errors.html
index 90d4d32..bb883da 100644
--- a/basic-errors.html
+++ b/basic-errors.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1726,9 +1729,22 @@
<script src="docson/widget.js" data-schema="../jsonschema/error.json"></script>
-<h3 id="error-codes">Error codes</h3>
+<h3 id="status">Status</h3>
-<p>A Ditto error defines an “error code” which is a string identifier that uniquely identifies the error.</p>
+<p>The “status” uses HTTP status codes semantics (see <a href="https://tools.ietf.org/html/rfc7231#section-6">RFC 7231</a>)
+to indicate whether a specific command has been successfully completed, or not.</p>
+
+<p>These “status” codes can be seen as API/contract which will be always the same for a specific error.<br />
+Use the “status” in order to identify an error, as the additional “error” and “description” might change
+without prior notice.</p>
+
+<h3 id="error">Error</h3>
+
+<p>A Ditto error contains an “error” code which is a string identifier that uniquely identifies the error.</p>
+
+<p>These error codes Ditto provides in addition to the HTTP <strong>status</strong> code are not to be considered as API and must
+therefore not be relied on.<br />
+They might change without prior notice.</p>
<p>Ditto itself uses the following prefixes for its error codes:</p>
@@ -1744,6 +1760,18 @@
<li><code class="highlighter-rouge">connectivity:</code> - for errors produced by the <a href="architecture-services-connectivity.html">connectivity</a> service</li>
</ul>
+<h3 id="message">Message</h3>
+
+<p>The error “message” contains a short message describing the encountered problem in plain english text.</p>
+
+<h3 id="description">Description</h3>
+
+<p>The optional error “description” describes in more detail how the error could be resolved.</p>
+
+<h3 id="href">Href</h3>
+
+<p>The optional href contains a link to Ditto documentation or external resources in order to help to resolve the error.</p>
+
<h2 id="examples">Examples</h2>
<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
@@ -1789,7 +1817,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 5e764dd..94df34a 100644
--- a/basic-feature.html
+++ b/basic-feature.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li class="active"><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1743,13 +1746,16 @@
<h3 id="feature-desired-properties">Feature desired properties</h3>
-<p>Desired properties represent the desired state of the properties. They are a tool to represent the desired target state of the properties. The <strong>desiredProperties</strong> related to Features are managed in form of a <strong>list of properties</strong>. These desired properties can be categorized,
-e.g. to manage the status, the configuration or any fault information.
+<p>Desired properties represent the desired state of the properties. They are a tool to represent the desired target state
+of the properties.
+The <strong>desiredProperties</strong> related to Features are managed in form of a <strong>list of properties</strong>. These desired properties
+can be categorized, e.g. to manage the status, the configuration or any fault information.
Feature desired properties are represented as one JSON object.</p>
<p>Each desired property itself can be either a simple/scalar value or a complex object; allowed is any JSON value.</p>
-<p>Please note however, that besides persisting the desired properties, and indexing the fields for search requests, filtering etc. for the time being, Ditto does not implement their further processing. Such functionality will come with future releases.</p>
+<p>Please note however, that besides persisting the desired properties, and indexing the fields for search requests, filtering
+etc. for the time being, Ditto does not implement their further processing. Such functionality will come with future releases.</p>
<h3 id="feature-definition">Feature definition</h3>
@@ -1802,10 +1808,7 @@
<h2 id="model-specification">Model specification</h2>
-<p>The feature model differs for API version 1 and 2:</p>
-
-<h3 id="v1">V1</h3>
-<script src="docson/widget.js" data-schema="../jsonschema/feature.json"></script>
+<p>The feature model API version 2:</p>
<h3 id="v2">V2</h3>
<script src="docson/widget.js" data-schema="../jsonschema/feature_v2.json"></script>
@@ -1813,13 +1816,13 @@
<h2 id="the-link-to-eclipse-vorto">The link to Eclipse Vorto</h2>
<blockquote>
- <p>Vorto is an open source tool that allows to create and manage technology agnostic, abstract device descriptions, so
-called information models. Information models describe the attributes and the capabilities of real world devices.
+ <p>Vorto is an open source tool that allows to create and manage technology agnostic, abstract device descriptions,
+so called information models. Information models describe the attributes and the capabilities of real world devices.
Source: <a href="http://www.eclipse.org/vorto/">http://www.eclipse.org/vorto/</a></p>
</blockquote>
-<p>Ditto’s feature definition may be mapped to the Vorto type system which is defined by so called “information models” and
-“function blocks”:</p>
+<p>Ditto’s feature definition may be mapped to the Vorto type system which is defined by so called “information models”
+and “function blocks”:</p>
<blockquote>
<p>Information models represent the capabilities of a particular type of device entirely.
An information model contains one or more function blocks.</p>
@@ -1993,7 +1996,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 f2307f7..f61d7b4 100644
--- a/basic-messages.html
+++ b/basic-messages.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1720,7 +1723,7 @@
<p>Messages <em>do not affect</em> the state of a digital twin or an actual device.
-Therefore Ditto does not handle messages like <a href="basic-signals-command.html">commands</a>: there are no responses which are
+Therefore, Ditto does not handle messages like <a href="basic-signals-command.html">commands</a>: there are no responses which are
produced by Ditto and no events which are emitted for messages.</p>
<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Ditto has no knowledge of the payload of messages but merely routes messages between
@@ -1801,8 +1804,7 @@
<p>To be able to receive Messages for a Thing, you need to have <code class="highlighter-rouge">READ</code> access on that Thing.
When a Message is sent to or from a Thing, <strong>every</strong> connected WebSocket or
-<a href="basic-connections.html#targets">connection target</a> with the correct
-access rights will receive the Message.</p>
+<a href="basic-connections.html#targets">connection target</a> with the correct access rights will receive the Message.</p>
<p>If there is more than one response to a message received by multiple consumers, only the
first response will be routed back to the initial issuer of a Message.</p>
@@ -1823,18 +1825,9 @@
<h2 id="permissions">Permissions</h2>
-<h3 id="api-version-1">API version 1</h3>
-
-<p>Permissions in API version 1 are simple for the Message API. If you want to receive Messages of a Thing,
-you need <code class="highlighter-rouge">READ</code> access on the Thing. To be able to send Messages to or from a Thing
-you need to have <code class="highlighter-rouge">WRITE</code> permissions.</p>
-
-<p>There is one sole exception, which are <a href="#claim-messages">Claim Messages</a>. You do
-not need the access rights for sending them.</p>
-
<h3 id="api-version-2">API version 2</h3>
-<p>Permissions in API version 2 can be more fine grained. In order to be able to receive all Messages of a Thing,
+<p>Permissions in API version 2 can be defined fine-grained. In order to be able to receive all Messages of a Thing,
you need <code class="highlighter-rouge">READ</code> permission for the <code class="highlighter-rouge">message:/</code> resource in the used <a href="basic-policy.html#message">Policy</a>.<br />
There can however be specified that you may only receive specific Messages (with a defined subject), also
expressed via <a href="basic-policy.html#message">Policy entry</a>.<br />
@@ -1881,7 +1874,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-metadata.html b/basic-metadata.html
index 32cf4e5..28d64a9 100644
--- a/basic-metadata.html
+++ b/basic-metadata.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1929,7 +1932,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 9f34e1b..1359f1f 100644
--- a/basic-namespaces-and-names.html
+++ b/basic-namespaces-and-names.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1719,8 +1722,8 @@
- <p>Ditto uses namespaces and names for the IDs of important entity types like Things or Policies. Due to the fact that those
-IDs often need to be set in the path of HTTP requests, we have restricted the set of allowed characters.</p>
+ <p>Ditto uses namespaces and names for the IDs of important entity types like Things or Policies. Due to the fact that
+those IDs often need to be set in the path of HTTP requests, we have restricted the set of allowed characters.</p>
<h2 id="namespace">Namespace</h2>
@@ -1788,8 +1791,9 @@
<h2 id="encoding-and-decoding">Encoding and decoding</h2>
-<p>If hex encoded characters or spaces are used in the Thing name, the protocol dependent de- or encoding must be taken into account. If a Thing is created with the ID <code class="highlighter-rouge">eclipse.ditto:foo bar</code> and is to be queried via the HTTP API, the space must be encoded accordingly:
-<code class="highlighter-rouge">GET /things/eclipse.ditto:foo%20bar</code>.</p>
+<p>If hex encoded characters or spaces are used in the Thing name, the protocol dependent de- or encoding must be
+taken into account. If a Thing is created with the ID <code class="highlighter-rouge">eclipse.ditto:foo bar</code> and is to be queried via the HTTP API,
+the space must be encoded accordingly: <code class="highlighter-rouge">GET /things/eclipse.ditto:foo%20bar</code>.</p>
<div class="tags">
@@ -1816,7 +1820,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 65c99b4..8af3a07 100644
--- a/basic-overview.html
+++ b/basic-overview.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1725,100 +1728,12 @@
<a href="#" data-toggle="tooltip" data-original-title="Internet of Things">IoT</a> have or should have.<br />
Its idea is to be as agnostic as possible when it comes to <code class="highlighter-rouge">Thing</code> data.</p>
-<p>Nevertheless two coarse elements are defined in order to structure <code class="highlighter-rouge">Thing</code>s (see also <a href="basic-thing.html">Thing</a>):</p>
+<p>Nevertheless, two coarse elements are defined in order to structure <code class="highlighter-rouge">Thing</code>s (see also <a href="basic-thing.html">Thing</a>):</p>
<ul>
- <li>Attributes: intended for managing static meta data of a <code class="highlighter-rouge">Thing</code> - as JSON object - which does not change frequently.</li>
+ <li>Attributes: intended for managing static metadata of a <code class="highlighter-rouge">Thing</code> - as JSON object - which does not change frequently.</li>
<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---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>
-
-<figure><img class="docimage" src="images/pages/basic/ditto-class-diagram-v1.svg" alt="Ditto Class Diagram" style="max-width: 600px" /><figcaption>Class diagram
-of Ditto's most basic entities in <b>API version 1.</b></figcaption></figure>
-
-<h3 id="json-format">JSON Format</h3>
-
-<p>Ditto persists Things as JSON and all of the APIs are also JSON based.</p>
-
-<p>In <strong>API version 1</strong> the most minimalistic representation of a Thing is for example the following:</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">"the.namespace:the-thing-id"</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">"subject-id"</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="p">}</span><span class="w">
-</span></code></pre></div></div>
-
-<p>Attributes and Features are optional (as shown in the class diagram above), thus in the example JSON above they are
-omitted.</p>
-
-<p>A minimalistic Thing with one attribute and one Feature 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">"the.namespace:the-thing-id"</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">"subject-id"</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">"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">"transmission"</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">"cur_speed"</span><span class="p">:</span><span class="w"> </span><span class="mi">90</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>
-
-<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
@@ -1828,7 +1743,7 @@
<figure><img class="docimage" src="images/pages/basic/ditto-class-diagram-v2.png" alt="Ditto Class Diagram" style="max-width: 600px" /><figcaption>Class diagram of Ditto's most basic entities in <b>API version 2.</b></figcaption></figure>
-<h3 id="json-format-1">JSON Format</h3>
+<h3 id="json-format">JSON Format</h3>
<p>In <strong>API version 2</strong> the most minimalistic representation of a Thing is for example the following:</p>
@@ -1841,7 +1756,7 @@
<p>Attributes and Features are optional (as also shown in the class diagram above), so in the example JSON above they are
omitted.</p>
-<p>A minimalistic Thing with one attribute, one Feature and a definition could look like this:</p>
+<p>A minimalistic Thing with one attribute, one Feature, and a definition 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">"the.namespace:the-thing-id"</span><span class="p">,</span><span class="w">
@@ -1885,7 +1800,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 8a48fb4..d8f87c4 100644
--- a/basic-placeholders.html
+++ b/basic-placeholders.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1978,7 +1981,8 @@
Followed are functions separated by the pipe (<code class="highlighter-rouge">|</code>) symbol - each function in the pipeline receives the value of the
previous expression (which may also be <code class="highlighter-rouge">empty</code>).</p>
-<p>The function either contains no parameters or contains parameters which are either string constants or could also be placeholders again.</p>
+<p>The function either contains no parameters or contains parameters which are either string constants or could also
+be placeholders again.</p>
<h3 id="function-library">Function library</h3>
@@ -2058,7 +2062,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 6a13bd9..0a96162 100644
--- a/basic-policy.html
+++ b/basic-policy.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1719,19 +1722,18 @@
- <p>A Policy enables developers to configure fine-grained access control for Things and other entities in an easy way.</p>
+ <p>A Policy enables developers to configure fine-grained access control for Things and other entities easily.</p>
-<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> The policy concept is only supported for Ditto <strong>HTTP API version 2</strong>. <br />
- Find the HTTP API reference at <a href="http-api-doc.html?urls.primaryName=api2#/Policies">Policies resources</a>.</div>
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> Find the HTTP API reference at <a href="http-api-doc.html?urls.primaryName=api2#/Policies">Policies resources</a>.</div>
<h2 id="authorization-concept">Authorization concept</h2>
<p>A specific policy provides someone (called subject), permission to read and/or write a given resource.</p>
-<div class="alert alert-success" role="alert"><i class="fa fa-check-square-o"></i> <b>Tip:</b> The write permission at the policy root resource (i.e. <code class="highlighter-rouge">policy:/</code>) allows to manage the
+<div class="alert alert-success" role="alert"><i class="fa fa-check-square-o"></i> <b>Tip:</b> Write permission at the policy root resource (i.e. <code class="highlighter-rouge">policy:/</code>) allows to manage the
policy itself.<br />Find an <a href="#example">example</a> at the end of the page.</div>
-<p>Please note, that in most cases it makes sense to grant read permission in addition to a write permission, because
+<p>Please note, that in most cases it makes sense to grant read permission in addition to write permission, because
<em>write does not imply read.</em></p>
<h2 id="model-specification">Model specification</h2>
@@ -2072,7 +2074,8 @@
<p>The Message resource (addressable as <code class="highlighter-rouge">message:/</code>) defines the access control for Messages.</p>
-<p>The access control definitions defined in a Policy’s Message resource will be applied to all Messages sent to or from Things referencing this Policy.</p>
+<p>The access control definitions defined in a Policy’s Message resource will be applied to all Messages sent to or from
+Things referencing this Policy.</p>
<ul>
<li>For sending messages to a Thing or its Features write permission is required</li>
@@ -2292,7 +2295,8 @@
<li>Via GET request at <code class="highlighter-rouge">/api/2/policies/<policyId></code>, and</li>
<li>Via GET request at <code class="highlighter-rouge">/api/2/things/{thingId}/policyId</code></li>
<li>At any Thing itself in its JSON representation.
-It is however not included by default, but can be retrieved by specifying the <code class="highlighter-rouge">/api/2/things/<thingId>?fields=_policy</code> query parameter.</li>
+It is however not included by default, but can be retrieved by specifying the <code class="highlighter-rouge">/api/2/things/<thingId>?fields=_policy</code>
+query parameter.</li>
</ul>
<div class="alert alert-success" role="alert"><i class="fa fa-check-square-o"></i> <b>Tip:</b> As soon as a sophisticated policy is described, you will only need to add a further <strong>subject</strong> entry to have for example a new group of users equally empowered as the initial one.</div>
@@ -2322,7 +2326,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 1bbe134..af06b46 100644
--- a/basic-rql.html
+++ b/basic-rql.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1730,7 +1733,8 @@
RQL is designed to have an extremely simple, but extensible grammar that can be written in a URL friendly query string.</p>
</blockquote>
-<p>An example helps more than a thousand words, so that would be the example of a simple RQL query querying for <code class="highlighter-rouge">foo="ditto"</code> and <code class="highlighter-rouge">bar<10</code>:</p>
+<p>An example helps more than a thousand words, so that would be the example of a simple RQL query querying
+for <code class="highlighter-rouge">foo="ditto"</code> and <code class="highlighter-rouge">bar<10</code>:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>and(eq(foo,"ditto"),lt(bar,10))
</code></pre></div></div>
@@ -1991,7 +1995,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 9e539a8..57d755c 100644
--- a/basic-search.html
+++ b/basic-search.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1771,7 +1774,8 @@
1-2 seconds. In rare cases the duration until consistency is reached again might be higher.</p>
<p>If it is important to know when a twin modification is reflected in the search index, request the
-<a href="basic-acknowledgements.html#built-in-acknowledgement-labels">built-in acknowledgement</a> <code class="highlighter-rouge">search-persisted</code> in the corresponding command.
+<a href="basic-acknowledgements.html#built-in-acknowledgement-labels">built-in acknowledgement</a> <code class="highlighter-rouge">search-persisted</code>
+in the corresponding command.
Search index update is successful if the status code of <code class="highlighter-rouge">search-persisted</code> in the command response is 204 “no content”.
Status codes at or above 400 indicate failed search index update due to client or server errors.</p>
@@ -1780,8 +1784,8 @@
<p>Queries can be made via Ditto’s APIs (<a href="httpapi-search.html">HTTP</a> or
<a href="protocol-specification-things-search.html">Ditto Protocol</a> e.g. via <a href="httpapi-protocol-bindings-websocket.html">WebSocket</a>).</p>
-<p><strong>Example:</strong> Search for all things located in “living-room”, reorder the list to start with the lowest thing ID as the first element,
-and return the first 5 results:</p>
+<p><strong>Example:</strong> Search for all things located in “living-room”, reorder the list to start with the lowest thing ID as
+the first element, 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: size(5),cursor(CURSOR_ID)
@@ -1789,8 +1793,8 @@
<h2 id="search-count-queries">Search count queries</h2>
-<p>The same syntax applies for search count queries - only the <a href="basic-rql.html#rql-sorting">sorting</a> and <a href="#rql-paging-deprecated">paging</a> makes no
-sense here, so there are not necessary to specify.</p>
+<p>The same syntax applies for search count queries - only the <a href="basic-rql.html#rql-sorting">sorting</a> and
+<a href="#rql-paging-deprecated">paging</a> makes no sense here, so there are not necessary to specify.</p>
<h2 id="namespaces">Namespaces</h2>
@@ -1816,8 +1820,8 @@
</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>
+<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>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>cursor(<cursor-id>)
</code></pre></div></div>
@@ -1825,7 +1829,8 @@
<code class="highlighter-rouge">cursor</code> of a previous response and marks the <strong>position after the last entry</strong> of the previous search. A response
includes no cursor if there are no more results.</p>
-<p>If a request has a <code class="highlighter-rouge">cursor</code> option, then any included <code class="highlighter-rouge">filter</code> or <code class="highlighter-rouge">sort</code> option may not differ from the original request of the cursor. Otherwise, the request is rejected.</p>
+<p>If a request has a <code class="highlighter-rouge">cursor</code> option, then any included <code class="highlighter-rouge">filter</code> or <code class="highlighter-rouge">sort</code> option may not differ from the original request
+of the cursor. Otherwise, the request is rejected.</p>
<p><strong>Example - return ten items with a cursor</strong></p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>option=size(10),cursor(<cursor-from-previous-result>)
@@ -1843,7 +1848,8 @@
<p>Limits the search results to <code class="highlighter-rouge"><count></code> items, starting with the item at index <code class="highlighter-rouge"><offset></code>.</p>
<ul>
- <li>if the paging option is not explicitly specified, the <strong>default</strong> value <code class="highlighter-rouge">limit(0,25)</code> is used, i.e. the first <code class="highlighter-rouge">25</code> results are returned.</li>
+ <li>if the paging option is not explicitly specified, the <strong>default</strong> value <code class="highlighter-rouge">limit(0,25)</code> is used,
+i.e. the first <code class="highlighter-rouge">25</code> results are returned.</li>
<li>the <strong>maximum</strong> allowed count is <code class="highlighter-rouge">200</code>.</li>
</ul>
@@ -1889,7 +1895,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/basic-signals-announcement.html b/basic-signals-announcement.html
index 11aca1d..b252faf 100644
--- a/basic-signals-announcement.html
+++ b/basic-signals-announcement.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1726,8 +1729,8 @@
<p>Announcements have the following characteristics:</p>
<ul>
<li>they are <strong>not</strong> persisted/appended into any data store</li>
- <li>they are published to interested and authorized parties via the <a href="httpapi-protocol-bindings-websocket.html">WebSocket API</a> as
-well as <a href="basic-connections.html#targets">connection targets</a> via <a href="basic-changenotifications.html">change notifications</a>.</li>
+ <li>they are published to interested and authorized parties via the <a href="httpapi-protocol-bindings-websocket.html">WebSocket API</a>
+as well as <a href="basic-connections.html#targets">connection targets</a> via <a href="basic-changenotifications.html">change notifications</a>.</li>
</ul>
@@ -1755,7 +1758,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 a30d4d1..4e29a1d 100644
--- a/basic-signals-command.html
+++ b/basic-signals-command.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1771,7 +1774,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 67d5b2e..9452d3d 100644
--- a/basic-signals-commandresponse.html
+++ b/basic-signals-commandresponse.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1750,7 +1753,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 63f236c..3f7b55c 100644
--- a/basic-signals-errorresponse.html
+++ b/basic-signals-errorresponse.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1720,14 +1723,18 @@
<p>If an issued <a href="basic-signals-command.html">command</a> or <a href="basic-messages.html">message</a> could not be applied, an
-appropriate error response conveys this information back to the issuer.
+appropriate error response conveys this <a href="basic-errors.html">error</a> information back to the issuer.<br />
Failure of a command or message can have various reasons, starting from missing permissions to internal server errors
during processing of the command.</p>
<p>The <a href="protocol-specification-errors.html">Ditto Protocol for Errors</a> defines how error responses look in Ditto Protocol.</p>
-<p>An overview of all Thing-related error responses can be found in the examples chapter
-<a href="protocol-examples-errorresponses.html">“Error responses”</a> of the Ditto Protocol.</p>
+<p>An overview of some possible error responses can be found in the examples chapters:</p>
+<ul>
+ <li><a href="protocol-examples-errorresponses.html">Things error response examples</a></li>
+ <li><a href="protocol-examples-policies-errorresponses.html">Policies error response examples</a></li>
+</ul>
+
<div class="tags">
@@ -1754,7 +1761,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 a89817e..5d71006 100644
--- a/basic-signals-event.html
+++ b/basic-signals-event.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1757,7 +1760,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 8a00962..7f35d03 100644
--- a/basic-signals.html
+++ b/basic-signals.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1802,7 +1805,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 b062654..d678b96 100644
--- a/basic-thing.html
+++ b/basic-thing.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1743,12 +1746,8 @@
<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>. (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
-<a href="#" data-toggle="tooltip" data-original-title="A Policy enables developers to configure fine-grained access control in an easy way. A specific policy defines who (subject) is granted or revoked permissions (rights) on a specific resource. The resource can be defined as rough or as fine-grained as necessary for the respective use case. ">Policy</a> defines which
+<p>A Thing in API version 2 contains a link to a <a href="basic-policy.html">Policy</a> in form of a <code class="highlighter-rouge">policyId</code>.
+This <a href="#" data-toggle="tooltip" data-original-title="A Policy enables developers to configure fine-grained access control in an easy way. A specific policy defines who (subject) is granted or revoked permissions (rights) on a specific resource. The resource can be defined as rough or as fine-grained as necessary for the respective use case. ">Policy</a> defines which
authenticated subjects may READ and WRITE the Thing or even parts of it (hierarchically specified).</p>
<h3 id="definition">Definition</h3>
@@ -1777,15 +1776,11 @@
<h3 id="model-specification">Model specification</h3>
-<h4 id="api-version-1---deprecated">API version 1 - Deprecated</h4>
-
-<script src="docson/widget.js" data-schema="../jsonschema/thing_v1.json"></script>
-
<h4 id="api-version-2">API version 2</h4>
<script src="docson/widget.js" data-schema="../jsonschema/thing_v2.json"></script>
-<h3 id="example-api-version-2">Example (API version 2)</h3>
+<h3 id="example">Example</h3>
<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">"the.namespace:theId"</span><span class="p">,</span><span class="w">
@@ -1844,7 +1839,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 8bea542..e931f3d 100644
--- a/blog.html
+++ b/blog.html
@@ -234,6 +234,21 @@
+ <h2><a class="post-link" href="2021-05-06-release-announcement-200.html">Announcing Eclipse Ditto Release 2.0.0</a></h2>
+ <span class="post-meta">Published by <img src="https://www.gravatar.com/avatar/19a9fd49b6778aef898249fb4f11bd24?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="https://github.com/thjaeckle" target="_blank">Thomas Jäckle</a> </span></span> on <time datetime="2021-05-06T00:00:00+00:00" itemprop="datePublished">May 6, 2021</time> - Tags:
+
+
+ <a href="tag_blog.html">blog</a>
+
+
+ </span>
+
+ <p> Today, ~1.5 years after release 1.0.0, the Eclipse Ditto team is happy to announce the availability of Eclipse Ditto 2.0.0. With the major version 2.0.0 the Ditto team removed technical debt and ended support for APIs which were deprecated long ago in order to have a better maintainable... </p>
+
+
+
+
+
<h2><a class="post-link" href="2021-03-31-ssh-tunneling-for-managed-connections.html">Support SSH tunneling for managed connections</a></h2>
<span class="post-meta">Published by <img src="https://www.gravatar.com/avatar/c6d7916bf0fd9cb08b047602bfc4deab?s=135" alt="A photo of Vadim Günther" 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/VadimGue" target="_blank">Vadim Günther</a> </span></span> on <time datetime="2021-03-31T00:00:00+00:00" itemprop="datePublished">Mar 31, 2021</time> - Tags:
@@ -391,21 +406,6 @@
-
-
- <h2><a class="post-link" href="2020-10-08-asynchronous-client-creation.html">Asynchronous Client Creation in Ditto Java Client 1.3.0</a></h2>
- <span class="post-meta">Published by <img src="https://www.gravatar.com/avatar/d923944b6a8c76e411ff838fb19acfa7?s=135" alt="A photo of Yufei Cai" 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/yufei-cai" target="_blank">Yufei Cai</a> </span></span> on <time datetime="2020-10-08T00:00:00+00:00" itemprop="datePublished">Oct 8, 2020</time> - Tags:
-
-
- <a href="tag_blog.html">blog</a>
-
-
- </span>
-
- <p> Before Ditto Java Client 1.3.0, a client object connects to a configured Ditto back-end during its creation. // create a client object and block until it connects to the Ditto back-end. final DittoClient client = DittoClients.newInstance(<span... </p>
-
-
-
<p><a href="feed.xml" class="btn btn-primary navbar-btn cursorNorm" role="button">RSS Subscribe</a></p>
<hr />
@@ -431,7 +431,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 401cbb0..09b63c7 100644
--- a/blog_archive.html
+++ b/blog_archive.html
@@ -236,6 +236,13 @@
<ul class="this">
+ <li><time>06 May</time><a href="2021-05-06-release-announcement-200.html">Announcing Eclipse Ditto Release 2.0.0</a></li>
+
+
+
+
+
+
<li><time>31 Mar</time><a href="2021-03-31-ssh-tunneling-for-managed-connections.html">Support SSH tunneling for managed connections</a></li>
@@ -550,7 +557,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 fe34db1..4e4dddb 100644
--- a/client-sdk-java.html
+++ b/client-sdk-java.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1779,7 +1782,6 @@
<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.eclipseprojects.io"</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>
@@ -1788,7 +1790,7 @@
<span class="o">.</span><span class="na">build</span><span class="o">())</span>
<span class="o">.</span><span class="na">build</span><span class="o">(),</span> <span class="n">authenticationProvider</span><span class="o">);</span>
-<span class="n">DisconnectedDittoClient</span> <span class="n">disconnectedDittoClient</span> <span class="o">=</span> <span class="n">DittoClients</span><span class="o">.</span><span class="na">newDisconnectedInstance</span><span class="o">(</span><span class="n">messagingProvider</span><span class="o">);</span>
+<span class="n">DisconnectedDittoClient</span> <span class="n">disconnectedDittoClient</span> <span class="o">=</span> <span class="n">DittoClients</span><span class="o">.</span><span class="na">newInstance</span><span class="o">(</span><span class="n">messagingProvider</span><span class="o">);</span>
<span class="n">disconnectedDittoClient</span><span class="o">.</span><span class="na">connect</span><span class="o">()</span>
<span class="o">.</span><span class="na">thenAccept</span><span class="o">(</span><span class="k">this</span><span class="o">::</span><span class="n">startUsingDittoClient</span><span class="o">)</span>
@@ -1995,7 +1997,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 a57f578..99a393c 100644
--- a/client-sdk-javascript.html
+++ b/client-sdk-javascript.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1737,14 +1740,6 @@
<h2 id="compatibility-with-eclipse-ditto">Compatibility with <a href="https://github.com/eclipse/ditto">Eclipse Ditto</a></h2>
-<p>The <code class="highlighter-rouge">@eclipse-ditto/ditto-javascript-client-<package>_<ditto-major.minor-version></code> modules
-will be compatible with the <code class="highlighter-rouge"><ditto-major.minor-version></code>, so e.g. <code class="highlighter-rouge">@eclipse-ditto/ditto-javascript-client-<package>_1.0</code>
-will be compatible with Eclipse Ditto 1.0.x. The javascript modules themselves use
-<a href="https://docs.npmjs.com/about-semantic-versioning">semantic versioning</a> for their
-api changes. All modules are released together, so if there is a version
-<code class="highlighter-rouge">@eclipse-ditto/ditto-javascript-client-api_1.0:1.0.1</code>, there’s also a release
-of <code class="highlighter-rouge">@eclipse-ditto/ditto-javascript-client-dom_1.0:1.0.1</code>.</p>
-
<p>The newest release of the JavaScript client will always try to cover as much API
functionality of the same Eclipse Ditto major version as possible. There might
however be missing features for which we would be very happy to accept contributions.</p>
@@ -1806,7 +1801,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 99b9751..fcf2e37 100644
--- a/client-sdk-overview.html
+++ b/client-sdk-overview.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,7 +1726,7 @@
<p>These SDKs make use of the <a href="protocol-specification.html">Ditto Protocol</a> to exchange messages with Eclipse Ditto.</p>
-<p>The following SDK are supported:</p>
+<p>The following SDKs are supported:</p>
<ul>
<li><a href="client-sdk-java.html">Java</a></li>
@@ -1753,7 +1756,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 52ccfc8..e8ba003 100644
--- a/connectivity-header-mapping.html
+++ b/connectivity-header-mapping.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1722,8 +1725,8 @@
<p>When receiving messages from external systems or sending messages to external systems, the external headers of the
messages can be mapped to and from Ditto protocol headers.</p>
-<p>That way the headers can be passed through Ditto, or defined Ditto protocol headers like for example <code class="highlighter-rouge">correlation-id</code> may be
-mapped to a header used for message correlation in the external system.</p>
+<p>That way the headers can be passed through Ditto, or defined Ditto protocol headers like for example <code class="highlighter-rouge">correlation-id</code>
+may be mapped to a header used for message correlation in the external system.</p>
<p>A header mapping can be defined individually for every source and target of a connection. For examples of a definition
see <a href="basic-connections.html#source-header-mapping">source header mapping</a>
@@ -1763,7 +1766,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 79de312..3d4a930 100644
--- a/connectivity-manage-connections.html
+++ b/connectivity-manage-connections.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1720,8 +1723,8 @@
<p>In order to manage (CRUD) connections in Ditto <a href="installation-operating.html#devops-commands">DevOps commands</a>
-have to be used. There is no separate HTTP API for managing the connections, as this is not a task for a developer using
-the digital twin APIs but more for a “DevOps engineer” creating new connections to external systems.</p>
+have to be used. There is no separate HTTP API for managing the connections, as this is not a task for a developer
+using the digital twin APIs but more for a “DevOps engineer” creating new connections to external systems.</p>
<p>All connection related piggyback commands use the following HTTP endpoint:</p>
@@ -1972,6 +1975,9 @@
<p>The default duration and the maximum amount of logs stored for one connection can be configured in Ditto’s connectivity
service configuration.</p>
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> When creating or opening an connection the logging is enabled per default. This allows
+to log possible errors on connection establishing.</div>
+
<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/connection"</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">
@@ -2091,7 +2097,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 a16c9eb..3a0e08f 100644
--- a/connectivity-mapping.html
+++ b/connectivity-mapping.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1725,8 +1728,9 @@
<h2 id="motivation">Motivation</h2>
-<p>Eclipse Ditto is about providing access to IoT devices via the <a href="intro-digitaltwins.html">digital twin</a> pattern. In order to
-provide structured APIs for different heterogeneous devices Ditto defines a lightweight JSON based <a href="basic-overview.html">model</a>.</p>
+<p>Eclipse Ditto is about providing access to IoT devices via the <a href="intro-digitaltwins.html">digital twin</a> pattern.
+In order to provide structured APIs for different heterogeneous devices Ditto defines a lightweight JSON based
+<a href="basic-overview.html">model</a>.</p>
<p>A <a href="basic-thing.html">Thing</a> might look like in the following example:</p>
@@ -1828,13 +1832,13 @@
<h3 id="javascript-mapper">JavaScript mapper</h3>
-<p>This mapper may be used whenever any inbound messages are not yet in <a href="protocol-overview.html">Ditto Protocol</a>. By using
- the built in <a href="#javascript-mapping-engine">JavaScript mapping engine</a> (based on Rhino) custom defined JavaScript scripts
- can be executed which are responsible for creating <a href="protocol-specification.html">Ditto Protocol JSON</a> message from
- arbitrary consumed payload.</p>
+<p>This mapper may be used whenever any inbound messages are not yet in <a href="protocol-overview.html">Ditto Protocol</a>.
+By using the built in <a href="#javascript-mapping-engine">JavaScript mapping engine</a> (based on Rhino) custom defined
+JavaScript scripts can be executed which are responsible for creating <a href="protocol-specification.html">Ditto Protocol JSON</a>
+message from arbitrary consumed payload.</p>
-<p>The same is possible for outbound messages in order to transform <a href="protocol-specification.html">Ditto Protocol JSON</a>
- messages (e.g. events or responses) to arbitrary other formats.</p>
+<p>The same is possible for outbound messages in order to transform <a href="protocol-specification.html">Ditto Protocol JSON</a>
+messages (e.g. events or responses) to arbitrary other formats.</p>
<h4 id="configuration-options">Configuration options</h4>
@@ -1892,13 +1896,13 @@
</ul>
<h3 id="connectionstatus-mapper">ConnectionStatus mapper</h3>
-<p>This mapper transforms the information from the <code class="highlighter-rouge">ttd</code> and <code class="highlighter-rouge">creation-time</code> message headers (see Eclipse Hono <a href="https://www.eclipse.org/hono/docs/concepts/device-notifications/">device
- notifications</a>) into a ModifyFeature
- command that complies with the <a href="https://vorto.eclipse.org/#/details/org.eclipse.ditto:ConnectionStatus:1.0.0">Vorto functionblock</a> <code class="highlighter-rouge">org.eclipse.ditto:ConnectionStatus</code>.</p>
+<p>This mapper transforms the information from the <code class="highlighter-rouge">ttd</code> and <code class="highlighter-rouge">creation-time</code> message headers
+(see Eclipse Hono <a href="https://www.eclipse.org/hono/docs/concepts/device-notifications/">device notifications</a>) into a
+ModifyFeature command that complies with the <a href="https://vorto.eclipse.org/#/details/org.eclipse.ditto:ConnectionStatus:1.0.0">Vorto functionblock</a> <code class="highlighter-rouge">org.eclipse.ditto:ConnectionStatus</code>.</p>
<p>The connectivity state of the device is then represented in a Feature.<br />
- It is mostly used in conjunction with another mapper that transforms the payload e.g.:<br />
- <code class="highlighter-rouge">"payloadMapping": [ "Ditto" , "connectionStatus" ]</code></p>
+It is mostly used in conjunction with another mapper that transforms the payload e.g.:<br />
+<code class="highlighter-rouge">"payloadMapping": [ "Ditto" , "connectionStatus" ]</code></p>
<p>Example of a resulting <code class="highlighter-rouge">ConnectionStatus</code> feature:</p>
<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
@@ -1978,8 +1982,8 @@
<li><code class="highlighter-rouge">outgoingContentType</code> (optional): The fallback content-type for outgoing message commands and responses without
the content-type header. Default to <code class="highlighter-rouge">text/plain; charset=UTF-8</code>.</li>
<li><code class="highlighter-rouge">incomingMessageHeaders</code> (optional): A JSON object containing the following headers needed to construct a message
-command or response envelope containing the incoming message as payload in the field <code class="highlighter-rouge">"value"</code>. Placeholder expressions
-reading from the protocol headers of incoming messages may be used.
+command or response envelope containing the incoming message as payload in the field <code class="highlighter-rouge">"value"</code>.
+Placeholder expressions reading from the protocol headers of incoming messages may be used.
<ul>
<li><code class="highlighter-rouge">content-type</code> (optional): The content type with which to encode the incoming message as payload.
Default to <code class="highlighter-rouge">{{ header:content-type | fn:default('application/octet-stream') }}</code>.
@@ -2054,11 +2058,13 @@
<h2 id="example-connection-with-mapping-conditions">Example connection with mapping conditions</h2>
-<p>The following example connection defines <code class="highlighter-rouge">incomingConditions</code> and <code class="highlighter-rouge">outgoingConditions</code>for the ConnectionStatus mapping engine.<br />
-Optional incomingConditions are validated before the mapping of inbound messages.<br />
+<p>The following example connection defines <code class="highlighter-rouge">incomingConditions</code> and <code class="highlighter-rouge">outgoingConditions</code>for the ConnectionStatus
+mapping engine.<br />
+Optional incomingConditions are validated before the mapping of inbound messages.<br />
Optional outgoingConditions are validated before the mapping of outbound messages.<br />
Conditional Mapping can be achieved by using <a href="basic-placeholders.html#function-expressions">function expressions</a>.
-When multiple incoming or outgoing conditions are set for one <code class="highlighter-rouge">mappingEngine</code>, all have to equal true for the mapping to be executed.</p>
+When multiple incoming or outgoing conditions are set for one <code class="highlighter-rouge">mappingEngine</code>,
+all have to equal true for the mapping to be executed.</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">"name"</span><span class="p">:</span><span class="w"> </span><span class="s2">"exampleConnection"</span><span class="p">,</span><span class="w">
@@ -2137,7 +2143,7 @@
<div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="cm">/**
* Builds a Ditto Protocol message from the passed parameters.
* @param {string} namespace - The namespace of the entity in java package notation, e.g.: "org.eclipse.ditto"
- * @param {string} id - The ID of the entity
+ * @param {string} name - The name of the entity, e.g.: "device"
* @param {string} group - The affected group/entity, one of: "things"
* @param {string} channel - The channel for the signal, one of: "twin"|"live"
* @param {string} criterion - The criterion to apply, one of: "commands"|"events"|"search"|"messages"|"errors"
@@ -2145,22 +2151,24 @@
* @param {string} path - The path which is affected by the message, e.g.: "/attributes"
* @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.
+ * @param {number} [status] - The status code that indicates the result of the command. If setting a status code,
+ * the Ditto Protocol Message will be interpreted as a response (e.g. content will be ignored when using 204).
+ * @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="nx">extra</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">name</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>
- <span class="nx">dittoProtocolMsg</span><span class="p">.</span><span class="nx">path</span> <span class="o">=</span> <span class="nx">path</span><span class="p">;</span>
- <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="k">return</span> <span class="p">{</span>
+ <span class="na">topic</span><span class="p">:</span> <span class="nx">namespace</span> <span class="o">+</span> <span class="s2">"/"</span> <span class="o">+</span> <span class="nx">name</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>
+ <span class="na">path</span><span class="p">:</span> <span class="nx">path</span><span class="p">,</span>
+ <span class="na">headers</span><span class="p">:</span> <span class="nx">dittoHeaders</span><span class="p">,</span>
+ <span class="na">value</span><span class="p">:</span> <span class="nx">value</span><span class="p">,</span>
+ <span class="na">status</span><span class="p">:</span> <span class="nx">status</span><span class="p">,</span>
+ <span class="na">extra</span><span class="p">:</span> <span class="nx">extra</span><span class="p">,</span>
+ <span class="p">};</span>
<span class="p">}</span>
<span class="cm">/**
@@ -2175,12 +2183,12 @@
*/</span>
<span class="kd">function</span> <span class="nx">buildExternalMsg</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">externalMsg</span> <span class="o">=</span> <span class="p">{};</span>
- <span class="nx">externalMsg</span><span class="p">.</span><span class="nx">headers</span> <span class="o">=</span> <span class="nx">headers</span><span class="p">;</span>
- <span class="nx">externalMsg</span><span class="p">.</span><span class="nx">textPayload</span> <span class="o">=</span> <span class="nx">textPayload</span><span class="p">;</span>
- <span class="nx">externalMsg</span><span class="p">.</span><span class="nx">bytePayload</span> <span class="o">=</span> <span class="nx">bytePayload</span><span class="p">;</span>
- <span class="nx">externalMsg</span><span class="p">.</span><span class="nx">contentType</span> <span class="o">=</span> <span class="nx">contentType</span><span class="p">;</span>
- <span class="k">return</span> <span class="nx">externalMsg</span><span class="p">;</span>
+ <span class="k">return</span> <span class="p">{</span>
+ <span class="na">headers</span><span class="p">:</span> <span class="nx">headers</span><span class="p">,</span>
+ <span class="na">textPayload</span><span class="p">:</span> <span class="nx">textPayload</span><span class="p">,</span>
+ <span class="na">bytePayload</span><span class="p">:</span> <span class="nx">bytePayload</span><span class="p">,</span>
+ <span class="na">contentType</span><span class="p">:</span> <span class="nx">contentType</span><span class="p">,</span>
+ <span class="p">};</span>
<span class="p">}</span>
<span class="cm">/**
@@ -2192,7 +2200,7 @@
*/</span>
<span class="kd">function</span> <span class="nx">arrayBufferToString</span><span class="p">(</span><span class="nx">arrayBuffer</span><span class="p">)</span> <span class="p">{</span>
- <span class="k">return</span> <span class="nb">String</span><span class="p">.</span><span class="nx">fromCharCode</span><span class="p">.</span><span class="nx">apply</span><span class="p">(</span><span class="kc">null</span><span class="p">,</span> <span class="k">new</span> <span class="nb">Uint8Array</span><span class="p">(</span><span class="nx">arrayBuffer</span><span class="p">));</span>
+ <span class="k">return</span> <span class="nb">String</span><span class="p">.</span><span class="nx">fromCharCode</span><span class="p">.</span><span class="nx">apply</span><span class="p">(</span><span class="kc">null</span><span class="p">,</span> <span class="k">new</span> <span class="nb">Uint8Array</span><span class="p">(</span><span class="nx">arrayBuffer</span><span class="p">));</span>
<span class="p">}</span>
<span class="cm">/**
@@ -2203,12 +2211,12 @@
*/</span>
<span class="kd">function</span> <span class="nx">stringToArrayBuffer</span><span class="p">(</span><span class="nx">string</span><span class="p">)</span> <span class="p">{</span>
- <span class="kd">let</span> <span class="nx">buf</span> <span class="o">=</span> <span class="k">new</span> <span class="nb">ArrayBuffer</span><span class="p">(</span><span class="nx">string</span><span class="p">.</span><span class="nx">length</span><span class="p">);</span>
- <span class="kd">let</span> <span class="nx">bufView</span> <span class="o">=</span> <span class="k">new</span> <span class="nb">Uint8Array</span><span class="p">(</span><span class="nx">buf</span><span class="p">);</span>
- <span class="k">for</span> <span class="p">(</span><span class="kd">let</span> <span class="nx">i</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="nx">strLen</span><span class="o">=</span><span class="nx">string</span><span class="p">.</span><span class="nx">length</span><span class="p">;</span> <span class="nx">i</span><span class="o"><</span><span class="nx">strLen</span><span class="p">;</span> <span class="nx">i</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span>
- <span class="nx">bufView</span><span class="p">[</span><span class="nx">i</span><span class="p">]</span> <span class="o">=</span> <span class="nx">string</span><span class="p">.</span><span class="nx">charCodeAt</span><span class="p">(</span><span class="nx">i</span><span class="p">);</span>
- <span class="p">}</span>
- <span class="k">return</span> <span class="nx">buf</span><span class="p">;</span>
+ <span class="kd">let</span> <span class="nx">buf</span> <span class="o">=</span> <span class="k">new</span> <span class="nb">ArrayBuffer</span><span class="p">(</span><span class="nx">string</span><span class="p">.</span><span class="nx">length</span><span class="p">);</span>
+ <span class="kd">let</span> <span class="nx">bufView</span> <span class="o">=</span> <span class="k">new</span> <span class="nb">Uint8Array</span><span class="p">(</span><span class="nx">buf</span><span class="p">);</span>
+ <span class="k">for</span> <span class="p">(</span><span class="kd">let</span> <span class="nx">i</span><span class="o">=</span><span class="mi">0</span><span class="p">,</span> <span class="nx">strLen</span><span class="o">=</span><span class="nx">string</span><span class="p">.</span><span class="nx">length</span><span class="p">;</span> <span class="nx">i</span><span class="o"><</span><span class="nx">strLen</span><span class="p">;</span> <span class="nx">i</span><span class="o">++</span><span class="p">)</span> <span class="p">{</span>
+ <span class="nx">bufView</span><span class="p">[</span><span class="nx">i</span><span class="p">]</span> <span class="o">=</span> <span class="nx">string</span><span class="p">.</span><span class="nx">charCodeAt</span><span class="p">(</span><span class="nx">i</span><span class="p">);</span>
+ <span class="p">}</span>
+ <span class="k">return</span> <span class="nx">buf</span><span class="p">;</span>
<span class="p">}</span>
<span class="cm">/**
@@ -2219,9 +2227,9 @@
*/</span>
<span class="kd">function</span> <span class="nx">asByteBuffer</span><span class="p">(</span><span class="nx">arrayBuffer</span><span class="p">)</span> <span class="p">{</span>
- <span class="kd">let</span> <span class="nx">byteBuffer</span> <span class="o">=</span> <span class="k">new</span> <span class="nb">ArrayBuffer</span><span class="p">(</span><span class="nx">arrayBuffer</span><span class="p">.</span><span class="nx">byteLength</span><span class="p">);</span>
- <span class="k">new</span> <span class="nb">Uint8Array</span><span class="p">(</span><span class="nx">byteBuffer</span><span class="p">).</span><span class="kd">set</span><span class="p">(</span><span class="k">new</span> <span class="nb">Uint8Array</span><span class="p">(</span><span class="nx">arrayBuffer</span><span class="p">));</span>
- <span class="k">return</span> <span class="nx">dcodeIO</span><span class="p">.</span><span class="nx">ByteBuffer</span><span class="p">.</span><span class="nx">wrap</span><span class="p">(</span><span class="nx">byteBuffer</span><span class="p">);</span>
+ <span class="kd">let</span> <span class="nx">byteBuffer</span> <span class="o">=</span> <span class="k">new</span> <span class="nb">ArrayBuffer</span><span class="p">(</span><span class="nx">arrayBuffer</span><span class="p">.</span><span class="nx">byteLength</span><span class="p">);</span>
+ <span class="k">new</span> <span class="nb">Uint8Array</span><span class="p">(</span><span class="nx">byteBuffer</span><span class="p">).</span><span class="kd">set</span><span class="p">(</span><span class="k">new</span> <span class="nb">Uint8Array</span><span class="p">(</span><span class="nx">arrayBuffer</span><span class="p">));</span>
+ <span class="k">return</span> <span class="nx">dcodeIO</span><span class="p">.</span><span class="nx">ByteBuffer</span><span class="p">.</span><span class="nx">wrap</span><span class="p">(</span><span class="nx">byteBuffer</span><span class="p">);</span>
<span class="p">}</span>
</code></pre></div></div>
@@ -2241,28 +2249,31 @@
* <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="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="c1">// ###</span>
- <span class="c1">// Insert your mapping logic here:</span>
- <span class="c1">// ###</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="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="c1">// ### Insert/adapt your mapping logic here.</span>
+ <span class="c1">// Use helper function Ditto.buildDittoProtocolMsg to build Ditto protocol message</span>
+ <span class="c1">// based on incoming payload.</span>
+ <span class="c1">// See https://www.eclipse.org/ditto/connectivity-mapping.html#helper-functions for details.</span>
+ <span class="c1">// ### example code assuming the Ditto protocol content type for incoming messages.</span>
+ <span class="k">if</span> <span class="p">(</span><span class="nx">contentType</span> <span class="o">===</span> <span class="s1">'application/vnd.eclipse.ditto+json'</span><span class="p">)</span> <span class="p">{</span>
+ <span class="c1">// Message is sent as Ditto protocol text payload and can be used directly</span>
+ <span class="k">return</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="p">}</span> <span class="k">else</span> <span class="k">if</span> <span class="p">(</span><span class="nx">contentType</span> <span class="o">===</span> <span class="s1">'application/octet-stream'</span><span class="p">)</span> <span class="p">{</span>
+ <span class="c1">// Message is sent as binary payload; assume Ditto protocol message (JSON).</span>
+ <span class="k">try</span> <span class="p">{</span>
+ <span class="k">return</span> <span class="nx">JSON</span><span class="p">.</span><span class="nx">parse</span><span class="p">(</span><span class="nx">Ditto</span><span class="p">.</span><span class="nx">arrayBufferToString</span><span class="p">(</span><span class="nx">bytePayload</span><span class="p">));</span>
+ <span class="p">}</span> <span class="k">catch</span> <span class="p">(</span><span class="nx">e</span><span class="p">)</span> <span class="p">{</span>
+ <span class="c1">// parsing failed (no JSON document); return null to drop the message</span>
+ <span class="k">return</span> <span class="kc">null</span><span class="p">;</span>
+ <span class="p">}</span>
+ <span class="p">}</span>
+ <span class="c1">// no mapping logic matched; return null to drop the message</span>
+ <span class="k">return</span> <span class="kc">null</span><span class="p">;</span>
<span class="p">}</span>
</code></pre></div></div>
@@ -2278,7 +2289,7 @@
<div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="cm">/**
* Maps the passed parameters which originated from a Ditto Protocol message to an external message.
* @param {string} namespace - The namespace of the entity in java package notation, e.g.: "org.eclipse.ditto"
- * @param {string} id - The ID of the entity
+ * @param {string} name - The name of the entity, e.g.: "device"
* @param {string} channel - The channel for the signal, one of: "twin"|"live"
* @param {string} group - The affected group/entity, one of: "things"
* @param {string} criterion - The criterion to apply, one of: "commands"|"events"|"search"|"messages"|"errors"
@@ -2286,43 +2297,48 @@
* @param {string} path - The path which is affected by the message, e.g.: "/attributes"
* @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.
+ * @param {number} [status] - The status code that indicates the result of the command. When this field is set,
+ * it indicates that the Ditto Protocol Message contains a response.
+ * @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
* <code>null</code> if the message could/should not be mapped
*/</span>
<span class="kd">function</span> <span class="nx">mapFromDittoProtocolMsg</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="nx">namespace</span><span class="p">,</span>
+ <span class="nx">name</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="c1">// ###</span>
- <span class="c1">// Insert your mapping logic here:</span>
- <span class="c1">// ###</span>
-
- <span class="k">return</span> <span class="nx">Ditto</span><span class="p">.</span><span class="nx">buildExternalMsg</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="c1">// ###</span>
+ <span class="c1">// Insert your mapping logic here</span>
+ <span class="c1">// ### example code using the Ditto protocol content type.</span>
+ <span class="kd">let</span> <span class="nx">headers</span> <span class="o">=</span> <span class="nx">dittoHeaders</span><span class="p">;</span>
+ <span class="kd">let</span> <span class="nx">textPayload</span> <span class="o">=</span> <span class="nx">JSON</span><span class="p">.</span><span class="nx">stringify</span><span class="p">(</span><span class="nx">Ditto</span><span class="p">.</span><span class="nx">buildDittoProtocolMsg</span><span class="p">(</span><span class="nx">namespace</span><span class="p">,</span> <span class="nx">name</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="kd">let</span> <span class="nx">bytePayload</span> <span class="o">=</span> <span class="kc">null</span><span class="p">;</span>
+ <span class="kd">let</span> <span class="nx">contentType</span> <span class="o">=</span> <span class="s1">'application/vnd.eclipse.ditto+json'</span><span class="p">;</span>
+ <span class="k">return</span> <span class="nx">Ditto</span><span class="p">.</span><span class="nx">buildExternalMsg</span><span class="p">(</span>
+ <span class="nx">headers</span><span class="p">,</span> <span class="c1">// The external headers Object containing header values</span>
+ <span class="nx">textPayload</span><span class="p">,</span> <span class="c1">// The external mapped String</span>
+ <span class="nx">bytePayload</span><span class="p">,</span> <span class="c1">// The external mapped byte[]</span>
+ <span class="nx">contentType</span> <span class="c1">// The returned Content-Type</span>
+ <span class="p">);</span>
<span class="p">}</span>
</code></pre></div></div>
<p>The result of the function has to be a JavaScript object or an array of JavaScript objects with the fields <code class="highlighter-rouge">headers</code>,
<code class="highlighter-rouge">textPayload</code>, <code class="highlighter-rouge">bytePayload</code> and <code class="highlighter-rouge">contentType</code>. That’s where the helper method <code class="highlighter-rouge">Ditto.buildExternalMsg</code> is useful: it
- explicitly defines which parameters are required for the external message.</p>
+explicitly defines which parameters are required for the external message.</p>
<h2 id="javascript-payload-types">JavaScript payload types</h2>
@@ -2335,11 +2351,11 @@
<div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">let</span> <span class="nx">value</span><span class="p">;</span>
<span class="k">if</span> <span class="p">(</span><span class="nx">contentType</span> <span class="o">===</span> <span class="s1">'application/json'</span><span class="p">)</span> <span class="p">{</span>
- <span class="kd">let</span> <span class="nx">parsedJson</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="nx">value</span> <span class="o">=</span> <span class="nx">parsedJson</span><span class="p">.</span><span class="nx">number1</span> <span class="o">+</span> <span class="nx">parsedJson</span><span class="p">[</span><span class="s1">'sub-field'</span><span class="p">];</span> <span class="c1">// remember to access JSON keys with dashes in a JS special way</span>
+ <span class="kd">let</span> <span class="nx">parsedJson</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="nx">value</span> <span class="o">=</span> <span class="nx">parsedJson</span><span class="p">.</span><span class="nx">number1</span> <span class="o">+</span> <span class="nx">parsedJson</span><span class="p">[</span><span class="s1">'sub-field'</span><span class="p">];</span> <span class="c1">// remember to access JSON keys with dashes in a JS special way</span>
<span class="p">}</span> <span class="k">else</span> <span class="p">{</span>
- <span class="c1">// a script may decide to not map other content-types than application/json</span>
- <span class="k">return</span> <span class="kc">null</span><span class="p">;</span>
+ <span class="c1">// a script may decide to not map other content-types than application/json</span>
+ <span class="k">return</span> <span class="kc">null</span><span class="p">;</span>
<span class="p">}</span>
<span class="c1">// proceed ...</span>
</code></pre></div></div>
@@ -2351,7 +2367,8 @@
<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray">TypedArrays</a> and
<a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/DataView">DataView</a>.</p>
-<p>What you get in the mapping scripts is a <code class="highlighter-rouge">bytePayload</code> of type <code class="highlighter-rouge">ArrayBuffer</code> which lets you work on the bytes in different ways:</p>
+<p>What you get in the mapping scripts is a <code class="highlighter-rouge">bytePayload</code> of type <code class="highlighter-rouge">ArrayBuffer</code> which lets you work on the bytes
+in different ways:</p>
<h4 id="typed-arrays">Typed Arrays</h4>
@@ -2359,7 +2376,8 @@
<p>A TypedArray [is] a view into an ArrayBuffer where every item has the same size and type.<br /> <a href="https://hacks.mozilla.org/2017/01/typedarray-or-dataview-understanding-byte-order/">source</a></p>
</blockquote>
-<p>With TypedArrays you can simply wrap the <code class="highlighter-rouge">bytePayload</code> <code class="highlighter-rouge">ArrayBuffer</code> and work on all the items e.g. as unsigned 8-bit integers:</p>
+<p>With TypedArrays you can simply wrap the <code class="highlighter-rouge">bytePayload</code> <code class="highlighter-rouge">ArrayBuffer</code> and work on all the items e.g.
+as unsigned 8-bit integers:</p>
<div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">let</span> <span class="nx">bytes</span> <span class="o">=</span> <span class="k">new</span> <span class="nb">Uint8Array</span><span class="p">(</span><span class="nx">bytePayload</span><span class="p">);</span>
<span class="nx">bytes</span><span class="p">[</span><span class="mi">0</span><span class="p">];</span> <span class="c1">// access the first byte</span>
@@ -2381,7 +2399,8 @@
<h4 id="bytebufferjs">ByteBuffer.js</h4>
-<p>Alternatively, Ditto’s JavaScript transformation may be loaded with the <a href="#helper-libraries">above mentioned</a> libraries, e.g. “bytebuffer.js”.<br />
+<p>Alternatively, Ditto’s JavaScript transformation may be loaded with the <a href="#helper-libraries">above mentioned</a> libraries,
+e.g. “bytebuffer.js”.<br />
With <code class="highlighter-rouge">ByteBuffer</code>, the content of an <code class="highlighter-rouge">ArrayBuffer</code> can be accessed in a buffered way:</p>
<div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">let</span> <span class="nx">byteBuf</span> <span class="o">=</span> <span class="nx">Ditto</span><span class="p">.</span><span class="nx">asByteBuffer</span><span class="p">(</span><span class="nx">bytePayload</span><span class="p">);</span>
@@ -2395,14 +2414,15 @@
<span class="nx">buf</span><span class="p">.</span><span class="nx">remaining</span><span class="p">();</span> <span class="c1">// gets the number of remaining readable bytes in the buffer</span>
</code></pre></div></div>
-<p>Check the <a href="https://github.com/dcodeIO/bytebuffer.js/wiki/API">ByteBuffer API documentation</a> to find out what is possible with that helper.</p>
+<p>Check the <a href="https://github.com/dcodeIO/bytebuffer.js/wiki/API">ByteBuffer API documentation</a> to find out what is possible
+with that helper.</p>
<h2 id="javascript-examples">JavaScript Examples</h2>
<h3 id="text-payload-example">Text payload example</h3>
-<p>Let’s assume your device sends telemetry data via <a href="https://www.eclipse.org/hono/">Eclipse Hono’s</a> MQTT adapter into the cloud.
-And that an example payload of your device is:</p>
+<p>Let’s assume your device sends telemetry data via <a href="https://www.eclipse.org/hono/">Eclipse Hono’s</a> MQTT adapter
+into the cloud. And that an example payload of your device is:</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">"temp"</span><span class="p">:</span><span class="w"> </span><span class="s2">"23.42 °C"</span><span class="p">,</span><span class="w">
@@ -2495,8 +2515,8 @@
<h3 id="bytes-payload-example">Bytes payload example</h3>
-<p>For this example, let’s assume your device sends telemetry data via <a href="https://www.eclipse.org/hono/">Eclipse Hono’s</a> HTTP adapter into the cloud.
-An example payload of your device - displayed as hexadecimal - is:</p>
+<p>For this example, let’s assume your device sends telemetry data via <a href="https://www.eclipse.org/hono/">Eclipse Hono’s</a>
+HTTP adapter into the cloud. An example payload of your device - displayed as hexadecimal - is:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>0x09EF03F72A
</code></pre></div></div>
@@ -2601,7 +2621,7 @@
<p>Beside the JavaScript based mapping - which can be configured/changed at runtime without the need of restarting the
connectivity service - there is also the possibility to implement a custom Java based mapper.</p>
-<p>The interface to be implemented is <code class="highlighter-rouge">org.eclipse.ditto.services.connectivity.mapping.MessageMapper</code> (<a href="https://github.com/eclipse/ditto/blob/master/services/connectivity/mapping/src/main/java/org/eclipse/ditto/services/connectivity/mapping/MessageMapper.java">find the source here</a>)
+<p>The interface to be implemented is <code class="highlighter-rouge">org.eclipse.ditto.connectivity.service.mapping.MessageMapper</code> (<a href="https://github.com/eclipse/ditto/blob/master/connectivity/service/mapping/src/main/java/org/eclipse/ditto/connectivity/service/mapping/MessageMapper.java">find the source here</a>)
with the following signature to implement (this is only for experts, the sources contain JavaDoc):</p>
<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">interface</span> <span class="nc">MessageMapper</span> <span class="o">{</span>
@@ -2615,8 +2635,8 @@
</code></pre></div></div>
<p>After instantiation of the custom <code class="highlighter-rouge">MessageMapper</code>, the <code class="highlighter-rouge">configure</code> method is called with all the <em>options</em> which were
-provided to the mapper in the <a href="connectivity-manage-connections.html#create-connection">configured connection</a>. Use them
-in order to pass in configurations, thresholds, etc.</p>
+provided to the mapper in the <a href="connectivity-manage-connections.html#create-connection">configured connection</a>.
+Use them in order to pass in configurations, thresholds, etc.</p>
<p>Then, simply implement both of the <code class="highlighter-rouge">map</code> methods:</p>
@@ -2674,7 +2694,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 45f81c4..12d2651 100644
--- a/connectivity-overview.html
+++ b/connectivity-overview.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1766,7 +1769,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 0672842..dc2fe01 100644
--- a/connectivity-protocol-bindings-amqp091.html
+++ b/connectivity-protocol-bindings-amqp091.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1911,7 +1914,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 9093c28..9bcbf72 100644
--- a/connectivity-protocol-bindings-amqp10.html
+++ b/connectivity-protocol-bindings-amqp10.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1957,7 +1960,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 a12c2ac..bd85484 100644
--- a/connectivity-protocol-bindings-http.html
+++ b/connectivity-protocol-bindings-http.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1742,8 +1745,8 @@
<li>PATCH</li>
</ul>
-<p>The specified <code class="highlighter-rouge"><http_path></code> contains the path - including optionally potential query parameters - to be appended to the configured
-<code class="highlighter-rouge">uri</code> of the connection.</p>
+<p>The specified <code class="highlighter-rouge"><http_path></code> contains the path - including optionally potential query parameters - to be appended to the
+configured <code class="highlighter-rouge">uri</code> of the connection.</p>
<p>The body of the HTTP request is either the outgoing <a href="protocol-specification.html">Ditto Protocol</a> message (e.g. an event)
or - if a <a href="connectivity-mapping.html">payload mapping</a> was specified in the connection - a transformed body.</p>
@@ -1964,7 +1967,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 066140f..c35a8fa 100644
--- a/connectivity-protocol-bindings-kafka2.html
+++ b/connectivity-protocol-bindings-kafka2.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1889,7 +1892,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 180fcc9..dafa671 100644
--- a/connectivity-protocol-bindings-mqtt.html
+++ b/connectivity-protocol-bindings-mqtt.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1857,7 +1860,16 @@
<h4 id="target-header-mapping">Target header mapping</h4>
-<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>
+<p>As MQTT 3.1.1 does not support headers in its protocol, a generic <a href="connectivity-header-mapping.html">header mapping</a> is
+not possible to configure here.</p>
+
+<p>However, if one of the following headers are contained in the header mapping, they are directly applied to the
+published MQTT message:</p>
+<ul>
+ <li><code class="highlighter-rouge">mqtt.topic</code>: overwrites the topic configured for the target</li>
+ <li><code class="highlighter-rouge">mqtt.qos</code>: overwrites the qos level configured for the target</li>
+ <li><code class="highlighter-rouge">mqtt.retain</code>: controls whether the MQTT retain flag is set on the published message</li>
+</ul>
<h4 id="target-acknowledgement-handling">Target acknowledgement handling</h4>
@@ -1900,7 +1912,11 @@
</span><span class="s2">"cleanSession"</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">"separatePublisherClient"</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">"publisherId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"my-awesome-mqtt-publisher-client-id"</span><span class="p">,</span><span class="w">
- </span><span class="s2">"reconnectForRedeliveryDelay"</span><span class="p">:</span><span class="w"> </span><span class="s2">"5s"</span><span class="w">
+ </span><span class="s2">"reconnectForRedeliveryDelay"</span><span class="p">:</span><span class="w"> </span><span class="s2">"5s"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"lastWillTopic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"my/last/will/topic"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"lastWillQos"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"lastWillRetain"</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">"lastWillMessage"</span><span class="p">:</span><span class="w"> </span><span class="s2">"my last will message"</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">
@@ -1944,9 +1960,9 @@
<h4 id="separatepublisherclient">separatePublisherClient</h4>
<p>Configures whether to create a separate physical client and connection to the MQTT broker for publishing messages, or not.
-By default (configured true), a single Ditto connection would open 2 MQTT connections/sessions: one for subscribing and one for publishing.
-If configured to <code class="highlighter-rouge">false</code>, the same MQTT connection/session is used both: for subscribing to messages, and for
-publishing messages.</p>
+By default (configured true), a single Ditto connection would open 2 MQTT connections/sessions: one for subscribing
+and one for publishing. If configured to <code class="highlighter-rouge">false</code>, the same MQTT connection/session is used both: for subscribing to
+messages, and for publishing messages.</p>
<p>Default: <code class="highlighter-rouge">true</code></p>
@@ -1974,6 +1990,45 @@
<p>Default: <code class="highlighter-rouge">60s</code> <a href="https://hivemq.github.io/hivemq-mqtt-client/docs/mqtt-operations/connect/#keep-alive">see here</a></p>
+<h4 id="lastwilltopic">lastWillTopic</h4>
+
+<p>Configures the topic which should be used on Last Will. This field is mandatory when Last Will should be enabled.</p>
+
+<h4 id="lastwillqos">lastWillQos</h4>
+
+<p>Configures the QoS which should be used on Last Will:</p>
+<ul>
+ <li><code class="highlighter-rouge">0</code> = QoS 0 (“at most once”)</li>
+ <li><code class="highlighter-rouge">1</code> = QoS 1 (“at least once”)</li>
+ <li><code class="highlighter-rouge">2</code> = QoS 2 (“exactly once”)</li>
+</ul>
+
+<p>Default: <code class="highlighter-rouge">0</code></p>
+
+<h4 id="lastwillretain">lastWillRetain</h4>
+
+<p>Configures if clients which are newly subscribed to the topic chosen in <a href="#lastwilltopic">Last Will topic</a> will
+receive this message immediately after they subscribe.</p>
+
+<p>Default: <code class="highlighter-rouge">false</code></p>
+
+<h4 id="lastwillmessage">lastWillMessage</h4>
+
+<p>Configures the message which should be published when the connection is disconnected ungracefully from the broker.
+The message will be published as UTF8-encoded text on the topic chosen in <a href="#lastwilltopic">Last Will topic</a>.</p>
+
+<p>Default: empty string</p>
+
+<h3 id="configure-last-will-message">Configure Last Will message</h3>
+
+<p>To notify other clients when the connection is disconnected ungracefully the <a href="http://docs.oasis-open.org/mqtt/mqtt/v3.1.1/os/mqtt-v3.1.1-os.html#_Toc398718028">Last Will feature</a>
+can be used. The message which will be published, is specified in the connection and stored
+in the broker when it connects. The message contains a topic, retained message flag, QoS, and the text payload to be
+published. These can be configured in the <a href="#specific-configuration">Specific Configuration</a> of the connection.
+The last will message is sent as text payload using UTF8 encoding.</p>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> This feature is enabled if the <em>last will topic</em> is set.</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
@@ -2089,7 +2144,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 1aed58f..755ba9e 100644
--- a/connectivity-protocol-bindings-mqtt5.html
+++ b/connectivity-protocol-bindings-mqtt5.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1789,7 +1792,7 @@
</ul>
<p>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, e. g.:</p>
+as to the user defined properties, e.g.:</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">"headerMapping"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
</span><span class="s2">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ header:mqtt.topic }}"</span><span class="p">,</span><span class="w">
@@ -1861,7 +1864,15 @@
<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>
+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>The following headers have a special meaning in that the values are applied directly to the published message:</p>
+<ul>
+ <li><code class="highlighter-rouge">mqtt.topic</code>: overwrites the topic configured for the target</li>
+ <li><code class="highlighter-rouge">mqtt.qos</code>: overwrites the qos level configured in the target</li>
+ <li><code class="highlighter-rouge">mqtt.retain</code>: controls whether the MQTT retain flag is set on the published message</li>
+</ul>
<h4 id="target-acknowledgement-handling">Target acknowledgement handling</h4>
@@ -1904,7 +1915,11 @@
</span><span class="s2">"cleanSession"</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">"separatePublisherClient"</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">"publisherId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"my-awesome-mqtt-publisher-client-id"</span><span class="p">,</span><span class="w">
- </span><span class="s2">"reconnectForRedeliveryDelay"</span><span class="p">:</span><span class="w"> </span><span class="s2">"5s"</span><span class="w">
+ </span><span class="s2">"reconnectForRedeliveryDelay"</span><span class="p">:</span><span class="w"> </span><span class="s2">"5s"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"lastWillTopic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"my/last/will/topic"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"lastWillQos"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"lastWillRetain"</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">"lastWillMessage"</span><span class="p">:</span><span class="w"> </span><span class="s2">"my last will message"</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">
@@ -1953,9 +1968,9 @@
<h4 id="separatepublisherclient">separatePublisherClient</h4>
<p>Configures whether to create a separate physical client and connection to the MQTT broker for publishing messages, or not.
-By default (configured to <code class="highlighter-rouge">true</code>), a single Ditto connection would open 2 MQTT connections/sessions: one for subscribing and one for publishing.
-If configured to <code class="highlighter-rouge">false</code>, the same MQTT connection/session is used both: for subscribing to messages, and for
-publishing messages.</p>
+By default (configured to <code class="highlighter-rouge">true</code>), a single Ditto connection would open 2 MQTT connections/sessions: one for subscribing
+and one for publishing. If configured to <code class="highlighter-rouge">false</code>, the same MQTT connection/session is used both: for subscribing
+to messages, and for publishing messages.</p>
<p>Default: <code class="highlighter-rouge">true</code></p>
@@ -1983,6 +1998,44 @@
<p>Default: <code class="highlighter-rouge">60s</code> <a href="https://hivemq.github.io/hivemq-mqtt-client/docs/mqtt-operations/connect/#keep-alive">see here</a></p>
+<h4 id="lastwilltopic">lastWillTopic</h4>
+
+<p>Configures the topic which should be used on Last Will. This field is mandatory when Last Will should be enabled.</p>
+
+<h4 id="lastwillqos">lastWillQos</h4>
+
+<p>Configures the QoS which should be used on Last Will:</p>
+<ul>
+ <li><code class="highlighter-rouge">0</code> = QoS 0 (“at most once”)</li>
+ <li><code class="highlighter-rouge">1</code> = QoS 1 (“at least once”)</li>
+ <li><code class="highlighter-rouge">2</code> = QoS 2 (“exactly once”)</li>
+</ul>
+
+<p>Default: <code class="highlighter-rouge">0</code></p>
+
+<h4 id="lastwillretain">lastWillRetain</h4>
+
+<p>Configures if clients which are newly subscribed to the topic chosen in <a href="#lastwilltopic">Last Will topic</a> will
+receive this message immediately after they subscribe.</p>
+
+<p>Default: <code class="highlighter-rouge">false</code></p>
+
+<h4 id="lastwillmessage">lastWillMessage</h4>
+
+<p>Configures the message which should be published when the connection is disconnected ungracefully from the broker.
+The message will be published as UTF8-encoded text on the topic chosen in <a href="#lastwilltopic">Last Will topic</a>.</p>
+
+<p>Default: empty string</p>
+
+<h3 id="configure-last-will-message">Configure Last Will message</h3>
+
+<p>To notify other clients when the connection is disconnected ungracefully the <a href="https://docs.oasis-open.org/mqtt/mqtt/v5.0/os/mqtt-v5.0-os.html#_Toc3901033">Last Will feature</a>
+can be used. The message which will be published, is specified in the connection and stored in the broker when it
+connects. The message contains a topic, retained message flag, QoS, and the text payload to be published. These can be
+configured in the <a href="#specific-configuration">Specific Configuration</a> of the connection.</p>
+
+<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> This feature is enabled if the <em>last will topic</em> is set.</div>
+
<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
@@ -2097,7 +2150,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/connectivity-ssh-tunneling.html b/connectivity-ssh-tunneling.html
index 08b4345..9072b21 100644
--- a/connectivity-ssh-tunneling.html
+++ b/connectivity-ssh-tunneling.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1831,7 +1834,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 7e65f13..a347a69 100644
--- a/connectivity-tls-certificates.html
+++ b/connectivity-tls-certificates.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1861,7 +1864,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 9cb14e7..38018c8 100644
--- a/feed.xml
+++ b/feed.xml
@@ -5,11 +5,103 @@
<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>Wed, 14 Apr 2021 12:30:06 +0000</pubDate>
- <lastBuildDate>Wed, 14 Apr 2021 12:30:06 +0000</lastBuildDate>
+ <pubDate>Thu, 06 May 2021 11:55:03 +0000</pubDate>
+ <lastBuildDate>Thu, 06 May 2021 11:55:03 +0000</lastBuildDate>
<generator>Jekyll v3.6.2</generator>
<item>
+ <title>Announcing Eclipse Ditto Release 2.0.0</title>
+ <description><p>Today, ~1.5 years after release <a href="2019-12-12-release-announcement-100.html">1.0.0</a>, the Eclipse Ditto team is happy to
+announce the availability of Eclipse Ditto <a href="https://projects.eclipse.org/projects/iot.ditto/releases/2.0.0">2.0.0</a>.</p>
+
+<p>With the major version 2.0.0 the Ditto team removed technical debt and ended support for APIs which were deprecated
+long ago in order to have a better maintainable codebase. However some awesome new features are included as well.</p>
+
+<h2 id="adoption">Adoption</h2>
+
+<p>Companies are willing to show their adoption of Eclipse Ditto publicly: <a href="https://iot.eclipse.org/adopters/?#iot.ditto">https://iot.eclipse.org/adopters/?#iot.ditto</a></p>
+
+<p>From our various <a href="feedback.html">feedback channels</a> we however know of more adoption.<br />
+If you are making use of Eclipse Ditto, it would be great to show this by adding your company name to that list of
+known adopters.<br />
+In the end, that’s one main way of measuring the success of the project.</p>
+
+<h2 id="changelog">Changelog</h2>
+
+<p>The main improvements and additions of Ditto 2.0.0 are:</p>
+
+<ul>
+ <li>Merge/PATCH updates of digital twins</li>
+ <li>Configurable OpenID Connect / OAuth2.0 claim extraction to be used for authorization</li>
+ <li>Establishing connections to endpoints (via AMQP, MQTT, HTTP) utilizing a Ditto managed SSH tunnel</li>
+ <li>Addition of a DevOps API in order to retrieve all known connections</li>
+ <li>Expiring policy subjects + publishing of announcement message prior to expiry</li>
+ <li>Addition of policy actions in order to inject a policy subject based on a provided JWT</li>
+ <li>Built-in acknowledgement for search updates to have the option of twin updates with strong consistency of the search index</li>
+ <li>Restoring active connection faster after a hard restart of the Ditto cluster via automatic prioritization of connections</li>
+ <li>Support for LastWill/Testament + retain flag for MQTT connections</li>
+</ul>
+
+<p>The step to a major version was done because of the following breaking API changes:</p>
+
+<ul>
+ <li>Removal of “API version 1” (deprecated in <a href="release_notes_110.html#deprecations">Ditto 1.1.0</a>)
+from Ditto’s Java APIs + HTTP API</li>
+ <li>Removal of code in Java APIs marked as <code class="highlighter-rouge">@Deprecated</code></li>
+ <li>Binary incompatible changes to Java APIs</li>
+ <li>Restructuring of Ditto’s Maven modules in order to simplify/ease further development</li>
+</ul>
+
+<p>The following non-functional enhancements are also included:</p>
+
+<ul>
+ <li>Improvement of stability during rolling updates</li>
+ <li>Addition of sharding concept for Ditto internal pub/sub enabling connection of e.g. tens of thousands Websocket Wessions</li>
+ <li>Background cleanup improvements in order to have less impact on DB roundtrip times</li>
+ <li>Update of third party libraries (e.g. Akka)</li>
+ <li>Documentation of deployment via K3S</li>
+</ul>
+
+<p>Please have a look at the <a href="release_notes_200.html">2.0.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>The Ditto JavaScript client release was published on <a href="https://www.npmjs.com/~eclipse_ditto">npmjs.com</a>:</p>
+<ul>
+ <li><a href="https://www.npmjs.com/package/@eclipse-ditto/ditto-javascript-client-dom">@eclipse-ditto/ditto-javascript-client-dom</a></li>
+ <li><a href="https://www.npmjs.com/package/@eclipse-ditto/ditto-javascript-client-node">@eclipse-ditto/ditto-javascript-client-node</a></li>
+</ul>
+
+<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>
+
+<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>
+</description>
+ <pubDate>Thu, 06 May 2021 00:00:00 +0000</pubDate>
+ <link>https://www.eclipse.org/ditto/2021-05-06-release-announcement-200.html</link>
+ <guid isPermaLink="true">https://www.eclipse.org/ditto/2021-05-06-release-announcement-200.html</guid>
+
+ <category>blog</category>
+
+
+ </item>
+
+ <item>
<title>Support SSH tunneling for managed connections</title>
<description><p>With the upcoming release of Eclipse Ditto <strong>version 2.0.0</strong> it will be possible to</p>
@@ -259,7 +351,7 @@
<p>This can be achieved by configuring an outgoing JavaScript payload mapper in the message connection:</p>
<div class="language-javascript highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">function</span> <span class="nx">mapFromDittoProtocolMsg</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">name</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>
@@ -273,7 +365,7 @@
<span class="kd">let</span> <span class="nx">headers</span> <span class="o">=</span> <span class="nx">dittoHeaders</span><span class="p">;</span>
<span class="kd">let</span> <span class="nx">textPayload</span> <span class="o">=</span> <span class="kc">null</span><span class="p">;</span>
- <span class="kd">let</span> <span class="nx">bytePayload</span> <span class="o">=</span> <span class="nx">Ditto</span><span class="p">.</span><span class="nx">stringToArrayBuffer</span><span class="p">(</span><span class="nx">Ditto</span><span class="p">.</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">toString</span><span class="p">());</span>
+ <span class="kd">let</span> <span class="nx">bytePayload</span> <span class="o">=</span> <span class="nx">Ditto</span><span class="p">.</span><span class="nx">stringToArrayBuffer</span><span class="p">(</span><span class="nx">Ditto</span><span class="p">.</span><span class="nx">buildDittoProtocolMsg</span><span class="p">(</span><span class="nx">namespace</span><span class="p">,</span> <span class="nx">name</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">toString</span><span class="p">());</span>
<span class="kd">let</span> <span class="nx">contentType</span> <span class="o">=</span> <span class="s1">'application/octet-stream'</span><span class="p">;</span>
<span class="k">return</span> <span class="nx">Ditto</span><span class="p">.</span><span class="nx">buildExternalMsg</span><span class="p">(</span>
@@ -1513,94 +1605,5 @@
</item>
- <item>
- <title>Asynchronous Client Creation in Ditto Java Client 1.3.0</title>
- <description><p>Before <a href="https://github.com/eclipse/ditto-clients/tree/master/java">Ditto Java Client</a> 1.3.0,
-a client object connects to a configured Ditto back-end during its creation.</p>
-
-<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="c1">// create a client object and block until it connects to the Ditto back-end.</span>
-<span class="kd">final</span> <span class="n">DittoClient</span> <span class="n">client</span> <span class="o">=</span> <span class="n">DittoClients</span><span class="o">.</span><span class="na">newInstance</span><span class="o">(</span><span class="n">messagingProvider</span><span class="o">);</span>
-</code></pre></div></div>
-
-<p>There are several problems with the approach.</p>
-<ol>
- <li>The calling thread blocks waiting for IO, namely the authentication process
-and establishment of a websocket.</li>
- <li>If the client is configured to reconnect, then an incorrect end-ponit configuration
-makes the factory method block forever.</li>
- <li>If the client is not configured to reconnect, then the factory method will throw
-an exception. But it is not possible to give the client reference to the exception
-handler, since the client creation did not complete. Consequently the exception handler
-has no simple way to free all resources allocated for the client.</li>
-</ol>
-
-<p>1.3.0 addresses these problems by introducing an asynchronous client creation interface.</p>
-
-<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">public</span> <span class="kd">final</span> <span class="kd">class</span> <span class="nc">DittoClients</span> <span class="o">{</span>
-
- <span class="kd">public</span> <span class="kd">static</span> <span class="n">DisconnectedDittoClient</span> <span class="nf">newDisconnectedInstance</span><span class="o">(</span><span class="n">MessagingProvider</span> <span class="n">mp</span><span class="o">);</span>
-<span class="o">}</span>
-
-<span class="kd">public</span> <span class="kd">interface</span> <span class="nc">DisconnectedDittoClient</span> <span class="o">{</span>
-
- <span class="n">CompletionStage</span><span class="o">&lt;</span><span class="n">DittoClient</span><span class="o">&gt;</span> <span class="nf">connect</span><span class="o">();</span>
-
- <span class="kt">void</span> <span class="nf">destroy</span><span class="o">();</span>
-<span class="o">}</span>
-</code></pre></div></div>
-
-<p>The method <code class="highlighter-rouge">DittoClients.newDisconnectedInstance(MessagingProvider)</code> creates a <code class="highlighter-rouge">DisconnectedDittoClient</code>
-object. The <code class="highlighter-rouge">DisconnectedDittoClient</code> has references to all resources allocated for the client and
-can free them via the <code class="highlighter-rouge">destroy()</code> method. The <code class="highlighter-rouge">DisconnectedDittoClient</code> object offers no method to
-interact with the Ditto API. By calling <code class="highlighter-rouge">connect()</code>, one obtains a future that yields a familiar
-<code class="highlighter-rouge">DittoClient</code> object upon completion. One might use the asynchronous client creation interface thus:</p>
-
-<div class="language-java highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="kd">final</span> <span class="n">DisconnectedDittoClient</span> <span class="n">disconnectedClient</span> <span class="o">=</span>
- <span class="n">DittoClients</span><span class="o">.</span><span class="na">newDisconnectedInstance</span><span class="o">(</span><span class="n">messagingProvider</span><span class="o">);</span>
-
-<span class="n">disconnectedClient</span><span class="o">.</span><span class="na">connect</span><span class="o">()</span>
- <span class="o">.</span><span class="na">thenAccept</span><span class="o">(</span><span class="k">this</span><span class="o">::</span><span class="n">startUsingDittoClient</span><span class="o">)</span>
- <span class="o">.</span><span class="na">exceptionally</span><span class="o">(</span><span class="n">exception</span> <span class="o">-&gt;</span> <span class="o">{</span>
- <span class="k">this</span><span class="o">.</span><span class="na">handleConnectionFailure</span><span class="o">(</span><span class="n">exception</span><span class="o">);</span>
- <span class="n">disconnectedClient</span><span class="o">.</span><span class="na">destroy</span><span class="o">();</span>
- <span class="k">return</span> <span class="kc">null</span><span class="o">;</span>
- <span class="o">});</span>
-</code></pre></div></div>
-
-<p>The asynchronous client creation interface has the following advantages.</p>
-
-<ol>
- <li>
- <p>The calling thread does not block.</p>
- </li>
- <li>
- <p>Even if configured to reconnect, the user can receive connection errors via
-the connection error handler in <code class="highlighter-rouge">MessagingConfiguration</code> and shut down the client
-at will.</p>
- </li>
- <li>
- <p>When initial reconnection is disabled, the method <code class="highlighter-rouge">DisconnectedDittoClient.connect()</code>
-returns a failed future on connection error. It is possible to reference the
-<code class="highlighter-rouge">DittoDisconnectedClient</code> object in the future’s error handler, where the client can
-be destroyed.</p>
- </li>
-</ol>
-
-<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>
-</description>
- <pubDate>Thu, 08 Oct 2020 00:00:00 +0000</pubDate>
- <link>https://www.eclipse.org/ditto/2020-10-08-asynchronous-client-creation.html</link>
- <guid isPermaLink="true">https://www.eclipse.org/ditto/2020-10-08-asynchronous-client-creation.html</guid>
-
- <category>blog</category>
-
-
- </item>
-
</channel>
</rss>
diff --git a/feedback.html b/feedback.html
index befba58..ecc9c43 100644
--- a/feedback.html
+++ b/feedback.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1757,7 +1760,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 a708425..2cc7ba7 100644
--- a/glossary.html
+++ b/glossary.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1717,9 +1720,7 @@
<dt>Asset</dt>
<dd>An asset can be anything from a tangible and physical device to the more intangible such as the reputation of a company. In our context we define an asset as any item, entity, application or even system of applications that can be registered at Eclipse Ditto using the <code class="highlighter-rouge">Thing</code> concept.</dd>
<dt>Thing</dt>
- <dd>A Thing is a generic entity and is mostly used to cluster multiple Features and manage the access to the data and functionality the Thing represents. A Thing may have additional meta data (Attributes) that describes the Thing in more detail.</dd>
- <dt>ACL</dt>
- <dd>An access control list (ACL) holds the current status on who (subject) is permitted to which extent (read, write, administrate) to manage a Thing.</dd>
+ <dd>A Thing is a generic entity and is mostly used to cluster multiple Features and manage the access to the data and functionality the Thing represents. A Thing may have additional metadata (Attributes) that describes the Thing in more detail.</dd>
<dt>Policy</dt>
<dd>A Policy enables developers to configure fine-grained access control in an easy way. A specific policy defines who (subject) is granted or revoked permissions (rights) on a specific resource. The resource can be defined as rough or as fine-grained as necessary for the respective use case.</dd>
<dt>Attributes</dt>
@@ -1755,7 +1756,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 0ebd4df..4759a67 100644
--- a/http-api-doc.html
+++ b/http-api-doc.html
@@ -219,7 +219,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
@@ -255,7 +255,6 @@
// Build a system
window.ui = SwaggerUIBundle({
urls: [
- {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/httpapi-concepts.html b/httpapi-concepts.html
index 1adb804..b522a10 100644
--- a/httpapi-concepts.html
+++ b/httpapi-concepts.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1727,18 +1730,15 @@
<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 deprecated API
-version <code class="highlighter-rouge">1</code> and API version <code class="highlighter-rouge">2</code>.</p>
+<p>Ditto’s HTTP API is versioned in the URL: <code class="highlighter-rouge">/api/<apiVersion></code>. Currently, Ditto only provides API version <code class="highlighter-rouge">2</code>.<br />
+API version 1 was deprecated and deleted as of Ditto version 2.0.0</p>
<p>The API version is a promise that no HTTP resources (the static ones defined by Ditto itself) are modified in an
-incompatible/breaking way. As the HTTP resources reflect the JSON structure of the <code class="highlighter-rouge">Thing</code> entity, that also applies for
-this entity. In API version 1, the JSON structure of the <code class="highlighter-rouge">Thing</code> entity won’t be changed in a breaking way
-(e.g. by removing or renaming a JSON field).</p>
+incompatible/breaking way. As the HTTP resources reflect the JSON structure of the <code class="highlighter-rouge">Thing</code> entity, that also applies
+for this entity.</p>
-<p>That is also the reason for Ditto having already 2 API versions. In API 2 the <code class="highlighter-rouge">Thing</code> structure was changed to no longer
-contain the <a href="basic-acl.html">ACL</a> inline as payload of the Thing. Instead, the authorization information in API 2 is
-managed by <a href="basic-policy.html">Policies</a>. The <code class="highlighter-rouge">acl</code> field was removed from the structure of the <code class="highlighter-rouge">Thing</code> and the
-<code class="highlighter-rouge">policyId</code> was added - that’s why Ditto had to make this change in an API version 2.</p>
+<p>In API 2 the <code class="highlighter-rouge">Thing</code> structure contains a <a href="basic-policy.html">Policy</a> where the authorization information is
+managed.</p>
<h2 id="endpoints">Endpoints</h2>
@@ -1746,125 +1746,10 @@
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---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 />
-A <code class="highlighter-rouge">Thing</code> in API 1 has the following JSON structure:</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">""</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="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="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="p">}</span><span class="w">
-</span><span class="p">}</span><span class="w">
-</span></code></pre></div></div>
-
-<p>This maps to the following HTTP API endpoints:</p>
-
-<ul>
- <li><code class="highlighter-rouge">/things/{thingId}</code>: accessing complete <code class="highlighter-rouge">Thing</code></li>
- <li><code class="highlighter-rouge">/things/{thingId}/acl</code>: accessing the ACL of the <code class="highlighter-rouge">Thing</code></li>
- <li><code class="highlighter-rouge">/things/{thingId}/attributes</code>: accessing the attributes of the <code class="highlighter-rouge">Thing</code></li>
- <li><code class="highlighter-rouge">/things/{thingId}/features</code>: accessing the features of the <code class="highlighter-rouge">Thing</code></li>
-</ul>
-
-<h4 id="things-in-api-1---dynamic-part"><code class="highlighter-rouge">/things</code> in API 1 - dynamic part</h4>
-
-<p>Additionally to that “static part” of the HTTP API which is defined by Ditto, the API is dynamically enhanced by the
-JSON structure of the Thing.<br /></p>
-
-<div class="alert alert-info" role="alert"><i class="fa fa-info-circle"></i> <b>Note:</b> This automatically turns each small aspect of a <strong>digital twin</strong> into an API endpoint.</div>
-
-<p>For example for a <code class="highlighter-rouge">Thing</code> with following 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">"{thingId}"</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">"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">
- </span><span class="s2">"some"</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">"serialNo"</span><span class="p">:</span><span class="w"> </span><span class="mi">4711</span><span class="w">
- </span><span class="p">}</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">"lamp"</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">"on"</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">"color"</span><span class="p">:</span><span class="w"> </span><span class="s2">"blue"</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>The following additional API endpoints are automatically available:</p>
-
-<ul>
- <li><code class="highlighter-rouge">/things/{thingId}/acl/userId</code>: accessing the ACL entry for user <code class="highlighter-rouge">userId</code> of the specific thing</li>
- <li><code class="highlighter-rouge">/things/{thingId}/attributes/manufacturer</code>: accessing the attribute <code class="highlighter-rouge">manufacturer</code> of the specific thing</li>
- <li><code class="highlighter-rouge">/things/{thingId}/attributes/complex</code>: accessing the attribute <code class="highlighter-rouge">complex</code> of the specific thing</li>
- <li><code class="highlighter-rouge">/things/{thingId}/attributes/complex/some</code>: accessing the attribute <code class="highlighter-rouge">complex/some</code> of the specific thing</li>
- <li><code class="highlighter-rouge">/things/{thingId}/attributes/complex/serialNo</code>: accessing the attribute <code class="highlighter-rouge">complex/serialNo</code> of the specific thing</li>
- <li><code class="highlighter-rouge">/things/{thingId}/features/lamp</code>: accessing the feature <code class="highlighter-rouge">lamp</code> of the specific thing</li>
- <li><code class="highlighter-rouge">/things/{thingId}/features/lamp/properties</code>: accessing all properties of the feature <code class="highlighter-rouge">lamp</code> of the specific thing</li>
- <li><code class="highlighter-rouge">/things/{thingId}/features/lamp/properties/on</code>: accessing the <code class="highlighter-rouge">on</code> property of the feature <code class="highlighter-rouge">lamp</code> of the specific
-thing</li>
- <li><code class="highlighter-rouge">/things/{thingId}/features/lamp/properties/color</code>: accessing the <code class="highlighter-rouge">color</code> properties of the feature <code class="highlighter-rouge">lamp</code> of the
-specific thing</li>
-</ul>
-
<h3 id="api-version-2">API version 2</h3>
-<p>In API version 2, a <code class="highlighter-rouge">Thing</code> does no longer contain information about the authorization in an
-inlined <a href="basic-acl.html">ACL</a>, but contains a <code class="highlighter-rouge">policyId</code>, which points to a <code class="highlighter-rouge">Policy</code> managed as another entity. Its API
-endpoint is <code class="highlighter-rouge">/policies</code>.</p>
+<p>In API version 2, a <code class="highlighter-rouge">Thing</code> contains a <code class="highlighter-rouge">policyId</code>, which points to a <code class="highlighter-rouge">Policy</code> managed as another entity.
+Its API endpoint is <code class="highlighter-rouge">/policies</code>.</p>
<h4 id="things-in-api-2"><code class="highlighter-rouge">/things</code> in API 2</h4>
@@ -2505,7 +2390,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 4b6834b..da7e8e7 100644
--- a/httpapi-messages.html
+++ b/httpapi-messages.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1749,7 +1752,7 @@
today:</p>
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">--request</span> POST <span class="se">\</span>
- <span class="nt">--url</span> http://localhost:8080/api/1/things/org.eclipse.ditto:smartcoffee/inbox/messages/ask <span class="se">\</span>
+ <span class="nt">--url</span> http://localhost:8080/api/2/things/org.eclipse.ditto:smartcoffee/inbox/messages/ask <span class="se">\</span>
<span class="nt">--header</span> <span class="s1">'content-type: text/plain'</span> <span class="se">\</span>
<span class="nt">--header</span> <span class="s1">'Authorization: Basic ZGl0dG86ZGl0dG8='</span> <span class="se">\</span>
<span class="nt">--data</span> <span class="s1">'Hey, how are you?'</span>
@@ -1772,7 +1775,7 @@
before closing the HTTP request with a timeout:</p>
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">--request</span> POST <span class="se">\</span>
- <span class="nt">--url</span> http://localhost:8080/api/1/things/org.eclipse.ditto:smartcoffee/inbox/messages/ask.question?timeout<span class="o">=</span>0 <span class="se">\</span>
+ <span class="nt">--url</span> http://localhost:8080/api/2/things/org.eclipse.ditto:smartcoffee/inbox/messages/ask.question?timeout<span class="o">=</span>0 <span class="se">\</span>
<span class="nt">--header</span> <span class="s1">'content-type: text/plain'</span> <span class="se">\</span>
<span class="nt">--header</span> <span class="s1">'Authorization: Basic ZGl0dG86ZGl0dG8='</span> <span class="se">\</span>
<span class="nt">--data</span> <span class="s1">'Hey, how are you?'</span>
@@ -1795,7 +1798,7 @@
how we can ask the <em>water-tank</em> Feature of our Thing <em>smartcoffee</em> to heat up:</p>
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">--request</span> POST <span class="se">\</span>
- <span class="nt">--url</span> http://localhost:8080/api/1/things/org.eclipse.ditto:smartcoffee/features/water-tank/inbox/messages/action <span class="se">\</span>
+ <span class="nt">--url</span> http://localhost:8080/api/2/things/org.eclipse.ditto:smartcoffee/features/water-tank/inbox/messages/action <span class="se">\</span>
<span class="nt">--header</span> <span class="s1">'content-type: text/plain'</span> <span class="se">\</span>
<span class="nt">--header</span> <span class="s1">'Authorization: Basic ZGl0dG86ZGl0dG8='</span> <span class="se">\</span>
<span class="nt">--data</span> <span class="s1">'heatUp'</span>
@@ -1808,7 +1811,7 @@
Thing smartcoffee, which needs to inform about something:</p>
<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">--request</span> POST <span class="se">\</span>
- <span class="nt">--url</span> http://localhost:8080/api/1/things/org.eclipse.ditto:smartcoffee/outbox/messages/inform <span class="se">\</span>
+ <span class="nt">--url</span> http://localhost:8080/api/2/things/org.eclipse.ditto:smartcoffee/outbox/messages/inform <span class="se">\</span>
<span class="nt">--header</span> <span class="s1">'correlation-id: an-unique-string-for-this-message'</span> <span class="se">\</span>
<span class="nt">--header</span> <span class="s1">'content-type: text/plain'</span> <span class="se">\</span>
<span class="nt">--header</span> <span class="s1">'Authorization: Basic ZGl0dG86ZGl0dG8='</span> <span class="se">\</span>
@@ -1841,7 +1844,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 349008e..6fa2b97 100644
--- a/httpapi-overview.html
+++ b/httpapi-overview.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1733,7 +1736,8 @@
<h2 id="content-type">Content Type</h2>
-<p>Currently, only content-type <code class="highlighter-rouge">application/json</code> is supported.</p>
+<p>Currently, the content-type <code class="highlighter-rouge">application/json</code> is supported for all REST resources except the <em>PATCH</em> resource.
+There the content-type has to be <code class="highlighter-rouge">application/merge-patch+json</code>.</p>
@@ -1761,7 +1765,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/httpapi-protocol-bindings-cloudevents.html b/httpapi-protocol-bindings-cloudevents.html
index 7cf7221..64057ca 100644
--- a/httpapi-protocol-bindings-cloudevents.html
+++ b/httpapi-protocol-bindings-cloudevents.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1729,10 +1732,9 @@
<h2 id="cloud-events-endpoint">Cloud Events endpoint</h2>
-<p>The Cloud Events endpoint is accessible at these URLs (depending on which API version to use):</p>
+<p>The Cloud Events endpoint is accessible at the following URL:</p>
-<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/1/cloudevents
-http://localhost:8080/api/2/cloudevents
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/2/cloudevents
</code></pre></div></div>
<h3 id="authentication">Authentication</h3>
@@ -1848,7 +1850,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 f16e365..521d87e 100644
--- a/httpapi-protocol-bindings-websocket.html
+++ b/httpapi-protocol-bindings-websocket.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1719,8 +1722,8 @@
- <p><a href="protocol-overview.html">Ditto Protocol</a> messages can be sent <em>as is</em> as <a href="https://tools.ietf.org/html/rfc6455">WebSocket</a> message.
-The Ditto Protocol JSON must be sent as <code class="highlighter-rouge">UTF-8</code> encoded String payload.</p>
+ <p><a href="protocol-overview.html">Ditto Protocol</a> messages can be sent <em>as is</em> as <a href="https://tools.ietf.org/html/rfc6455">WebSocket</a>
+message. The Ditto Protocol JSON must be sent as <code class="highlighter-rouge">UTF-8</code> encoded String payload.</p>
<h2 id="websocket-features">WebSocket features</h2>
@@ -1750,10 +1753,10 @@
<p>When sending a command via WebSocket you will receive a corresponding response (the response can be related to the
request by the <code class="highlighter-rouge">correlation-id</code> header). <br />
-The response indicates the success or the failure of the command and, depending on the command type, contains the result
-payload.</p>
+The response indicates the success or the failure of the command and, depending on the command type, contains the
+result payload.</p>
-<p>Please find examples of commands and their response pattern at <a href="protocol-examples.html">Protocol examples</a>.</p>
+<p>Please find examples of commands, and their response pattern at <a href="protocol-examples.html">Protocol examples</a>.</p>
<h3 id="request-receiving-eventschange-notifications">Request receiving events/change notifications</h3>
@@ -1765,15 +1768,15 @@
<h3 id="request-receiving-messages">Request receiving messages</h3>
-<p><a href="basic-messages.html">Messages</a> can be sent both via the <a href="httpapi-overview.html">HTTP API</a> and the WebSocket. Receiving
-messages and answering to them however can only be done via the WebSocket.</p>
+<p><a href="basic-messages.html">Messages</a> can be sent both via the <a href="httpapi-overview.html">HTTP API</a> and the WebSocket.
+Receiving messages and answering to them however can only be done via the WebSocket.</p>
<p>See <a href="#request-messages">request messages</a> for subscribing/unsubscribing for receiving messages.</p>
<h3 id="request-receiving-live-commands--events">Request receiving live commands + events</h3>
-<p>In order to receive <a href="protocol-twinlive.html">live commands and events</a>, the WebSocket API can be used. The Ditto Protocol
-messages are the same as for the “twin” channel, only with <em>live</em> as channel in the
+<p>In order to receive <a href="protocol-twinlive.html">live commands and events</a>, the WebSocket API can be used.
+The Ditto Protocol messages are the same as for the “twin” channel, only with <em>live</em> as channel in the
<a href="protocol-specification-topic.html">topic</a>.</p>
<p>See <a href="#request-live-commands">request live commands</a> and <a href="#request-live-events">request live events</a> for
@@ -1781,10 +1784,9 @@
<h2 id="websocket-endpoint">WebSocket endpoint</h2>
-<p>The WebSocket endpoint is accessible at these URLs (depending on which API version to use):</p>
+<p>The WebSocket endpoint is accessible at the following URL:</p>
-<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ws://localhost:8080/ws/1
-ws://localhost:8080/ws/2
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ws://localhost:8080/ws/2
</code></pre></div></div>
<h3 id="authentication">Authentication</h3>
@@ -1954,8 +1956,8 @@
<h3 id="enrichment">Enrichment</h3>
-<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>
+<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>
@@ -2092,7 +2094,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 eed20e4..138127e 100644
--- a/httpapi-search.html
+++ b/httpapi-search.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1725,10 +1728,10 @@
<a href="http-api-doc.html?urls.primaryName=api2#/Search">Search resources</a>.</div>
<p>The concepts of the <a href="basic-rql.html#rql-filter">RQL expression</a>, <a href="basic-rql.html#rql-sorting">RQL sorting</a> and
-<a href="basic-search.html#rql-paging-deprecated">RQL paging</a> are mapped to HTTP as query parameters which are added to <code class="highlighter-rouge">GET</code> requests
-to the search endpoint:</p>
+<a href="basic-search.html#rql-paging-deprecated">RQL paging</a> are mapped to HTTP as query parameters which are added to
+<code class="highlighter-rouge">GET</code> requests to the search endpoint:</p>
-<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/<1|2>/search/things
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/2/search/things
</code></pre></div></div>
<p>If the <code class="highlighter-rouge">filter</code> parameter is omitted, the result contains all <code class="highlighter-rouge">Things</code> the authenticated user is
@@ -1751,9 +1754,10 @@
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>GET .../search/things?filter=eq(attributes/location,"living-room")&namespaces=org.eclipse.ditto,foo.bar
</code></pre></div></div>
-<p>The HTTP search API can also profit from the <a href="httpapi-concepts.html#partial-requests">partial request</a> concept of the API:<br />
-additionally to a <code class="highlighter-rouge">filter</code> and <code class="highlighter-rouge">options</code>, a <code class="highlighter-rouge">fields</code> paramter may be specified in order to select which data of the result
-set to retrieve.</p>
+<p>The HTTP search API can also profit from the <a href="httpapi-concepts.html#partial-requests">partial request</a> concept
+of the API:<br />
+Additionally to a <code class="highlighter-rouge">filter</code> and <code class="highlighter-rouge">options</code>, a <code class="highlighter-rouge">fields</code> parameter may be specified in order to select which data
+of the result set to retrieve.</p>
<p>Example which only returns <code class="highlighter-rouge">thingId</code> and the <code class="highlighter-rouge">manufacturer</code> attribute of the found Things:</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>GET .../search/things?filter=eq(attributes/location,"living-room")&fields=thingId,attributes/manufacturer
@@ -1768,7 +1772,7 @@
<h2 id="search-count">Search count</h2>
<p>Search counts can be made against this endpoint:</p>
-<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/<1|2>/search/things/count
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/2/search/things/count
</code></pre></div></div>
<p>Complex example:</p>
@@ -1808,7 +1812,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 d5fb1ff..722a0ab 100644
--- a/httpapi-sse.html
+++ b/httpapi-sse.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1741,17 +1744,18 @@
<h2 id="sse-api-things">SSE API <code class="highlighter-rouge">/things</code></h2>
<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
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/2/things
</code></pre></div></div>
<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>
+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>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>
+<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>
@@ -1765,7 +1769,7 @@
<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
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/2/things?namespaces=org.eclipse.ditto.one,org.eclipse.test&filter=gt
(attributes/counter,42)
</code></pre></div></div>
@@ -1774,36 +1778,35 @@
<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>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/2/things?ids=<thingId1>,<thingId2>
</code></pre></div></div>
<h4 id="fields-projection">Fields projection</h4>
-<p>Additionally using the <code class="highlighter-rouge">fields</code> parameter of the <a href="httpapi-concepts.html#partial-requests">partial request</a> feature, only
-specific parts can be watched for changes, e.g.:</p>
-<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/<1|2>/things?fields=thingId,attributes
+<p>Additionally, using the <code class="highlighter-rouge">fields</code> parameter of the <a href="httpapi-concepts.html#partial-requests">partial request</a> feature,
+only specific parts can be watched for changes, e.g.:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/2/things?fields=thingId,attributes
</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
- visible for which thing the change was made.</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 visible for which thing the change was made.</div>
<h4 id="field-enrichment">Field enrichment</h4>
<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
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/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")
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/2/things?extraFields=attributes/location&filter=eq(attributes/location,"kitchen")
</code></pre></div></div>
-<p>For combined usage of <code class="highlighter-rouge">fields</code> and <code class="highlighter-rouge">extraFields</code> one needs to specify all fields, selected as extra fields, for the field projection, too.
-This is required to allow filtering based on extra fields but still omit them in the payload.
+<p>For combined usage of <code class="highlighter-rouge">fields</code> and <code class="highlighter-rouge">extraFields</code> one needs to specify all fields, selected as extra fields, for the
+field projection, too. This is required to allow filtering based on extra fields but still omit them in the payload.
An example without filtering would look like this:</p>
-<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/<1|2>/things?fields=thingId,attributes&extraFields=attributes
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/2/things?fields=thingId,attributes&extraFields=attributes
</code></pre></div></div>
<h4 id="filtering-by-namespaces">Filtering by namespaces</h4>
@@ -1811,15 +1814,15 @@
<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
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/2/things?namespaces=org.eclipse.ditto.one,org.eclipse.test
</code></pre></div></div>
<h4 id="filtering-by-rql-expression">Filtering by RQL expression</h4>
-<p>As also described in <a href="basic-changenotifications.html#by-rql-expression">change notifications</a>, it is additionally possible
-to specify an RQL expression expressing on which occasions to emit an event via the SSE API. Simply specify the <code class="highlighter-rouge">filter</code>
-parameter with an <a href="basic-rql.html">RQL expression</a>, e.g.:</p>
-<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/<1|2>/things?filter=gt(attributes/counter,42)
+<p>As also described in <a href="basic-changenotifications.html#by-rql-expression">change notifications</a>, it is additionally
+possible to specify an RQL expression expressing on which occasions to emit an event via the SSE API.
+Simply specify the <code class="highlighter-rouge">filter</code> parameter with an <a href="basic-rql.html">RQL expression</a>, e.g.:</p>
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/2/things?filter=gt(attributes/counter,42)
</code></pre></div></div>
<h3 id="example-for-sse-on-things">Example for SSE on Things</h3>
@@ -1846,9 +1849,9 @@
</span><span class="p">}</span><span class="w">
</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
-for changes on the feature <code class="highlighter-rouge">lamp</code>:</p>
+<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 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/2/things?ids=org.eclipse.ditto:fancy-thing&fields=thingId,features/lamp'</span><span class="p">,</span> <span class="p">{</span> <span class="na">withCredentials</span><span class="p">:</span> <span class="kc">true</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>
@@ -1857,13 +1860,13 @@
</code></pre></div></div>
<p>By defining <code class="highlighter-rouge">{ withCredentials: true }</code> at the <code class="highlighter-rouge">new EventSource()</code>, the browser credentials (<code class="highlighter-rouge">Authorization</code> header) of
-the already authenticated browser against that domain are sent along, this works for Basic Auth as well as for JWT based
-authentication using a <code class="highlighter-rouge">Bearer</code> token.</p>
+the already authenticated browser against that domain are sent along, this works for Basic Auth as well as for
+JWT based authentication using a <code class="highlighter-rouge">Bearer</code> token.</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
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>PUT /api/2/things/org.eclipse.ditto:fancy-thing/features/lamp/properties/on
payload: true
</code></pre></div></div>
@@ -1883,7 +1886,7 @@
<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
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/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>.
@@ -1909,13 +1912,13 @@
<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)
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/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
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/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>
@@ -1924,13 +1927,13 @@
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)
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/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
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>http://localhost:8080/api/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>
@@ -1995,7 +1998,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 91a103c..663ce23 100644
--- a/index.html
+++ b/index.html
@@ -255,7 +255,7 @@
</div>
<div class="panel-body">
<h4>Organize your set of digital twins</h4>
- <p>Support finding and selecting sets of digital twins by providing search functionality on meta data and state data.</p>
+ <p>Support finding and selecting sets of digital twins by providing search functionality on metadata and state data.</p>
<!--<a href="#" class="btn btn-primary">Learn More</a>-->
</div>
</div>
@@ -281,7 +281,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 7a327c5..7eb9401 100644
--- a/installation-building.html
+++ b/installation-building.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1780,7 +1783,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 5cdc10d..d8c5922 100644
--- a/installation-operating.html
+++ b/installation-operating.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1747,8 +1750,8 @@
<p>Each of Ditto’s microservice has many options for configuration, e.g. timeouts, cache sizes, etc.</p>
-<p>In order to have a look at all possible configuration options and what default values they have, here are the configuration
-files of Ditto’s microservices:</p>
+<p>In order to have a look at all possible configuration options and what default values they have, here are the
+configuration files of Ditto’s microservices:</p>
<ul>
<li>Policies: <a href="https://github.com/eclipse/ditto/blob/master/services/policies/starter/src/main/resources/policies.conf">policies.conf</a></li>
<li>Things: <a href="https://github.com/eclipse/ditto/blob/master/services/things/starter/src/main/resources/things.conf">things.conf</a></li>
@@ -1789,8 +1792,8 @@
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>
+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#subjects">policies</a> as “Subject ID”.</p>
@@ -1857,8 +1860,8 @@
the OIDC provider <a href="https://www.keycloak.org/">keycloak</a>, a project like <a href="https://github.com/keycloak/keycloak-gatekeeper">keycloak-gatekeeper</a>
may be put in front of Ditto to handle the token-logic.</p>
-<p><strong>If the chosen OIDC provider uses a self-signed certificate</strong>, the certificate has to be retrieved and configured for the
-akka-http ssl configuration.</p>
+<p><strong>If the chosen OIDC provider uses a self-signed certificate</strong>, the certificate has to be retrieved and configured for
+the akka-http ssl configuration.</p>
<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>ssl-config {
trustManager = {
@@ -1891,8 +1894,8 @@
<h3 id="configuring">Configuring</h3>
-<p>In the default configuration, each Ditto service opens a HTTP endpoint, where it provides the Prometheus metrics on port
-<code class="highlighter-rouge">9095</code>. This can be changed via the environment variable <code class="highlighter-rouge">PROMETHEUS_PORT</code>.</p>
+<p>In the default configuration, each Ditto service opens a HTTP endpoint, where it provides the Prometheus metrics
+on port <code class="highlighter-rouge">9095</code>. This can be changed via the environment variable <code class="highlighter-rouge">PROMETHEUS_PORT</code>.</p>
<p>Ditto will automatically publish gathered metrics at the endpoint <code class="highlighter-rouge">http://<container-host-or-ip>:9095/</code>.</p>
@@ -1918,11 +1921,11 @@
# TYPE jvm_memory_buffer_pool_usage gauge
jvm_memory_buffer_pool_usage{component="system-metrics",pool="direct",measure="used"} 396336.0
# TYPE roundtrip_http_seconds histogram
-roundtrip_http_seconds_bucket{le="0.05",ditto_request_path="/api/1/things/x",ditto_request_method="PUT",ditto_statusCode="201",segment="overall"} 1.0
-roundtrip_http_seconds_sum{ditto_request_path="/api/1/things/x",ditto_statusCode="201",ditto_request_method="PUT",segment="overall"} 0.038273024
-roundtrip_http_seconds_bucket{le="0.001",ditto_request_path="/api/1/things/x",ditto_request_method="PUT",ditto_statusCode="204",segment="overall"} 0.0
-roundtrip_http_seconds_bucket{le="0.1",ditto_request_path="/api/1/things/x",ditto_request_method="PUT",ditto_statusCode="204",segment="overall"} 7.0
-roundtrip_http_seconds_sum{ditto_request_path="/api/1/things/x",ditto_statusCode="204",ditto_request_method="PUT",segment="overall"} 0.828899328
+roundtrip_http_seconds_bucket{le="0.05",ditto_request_path="/api/2/things/x",ditto_request_method="PUT",ditto_statusCode="201",segment="overall"} 1.0
+roundtrip_http_seconds_sum{ditto_request_path="/api/2/things/x",ditto_statusCode="201",ditto_request_method="PUT",segment="overall"} 0.038273024
+roundtrip_http_seconds_bucket{le="0.001",ditto_request_path="/api/2/things/x",ditto_request_method="PUT",ditto_statusCode="204",segment="overall"} 0.0
+roundtrip_http_seconds_bucket{le="0.1",ditto_request_path="/api/2/things/x",ditto_request_method="PUT",ditto_statusCode="204",segment="overall"} 7.0
+roundtrip_http_seconds_sum{ditto_request_path="/api/2/things/x",ditto_statusCode="204",ditto_request_method="PUT",segment="overall"} 0.828899328
# TYPE jvm_gc_promotion histogram
jvm_gc_promotion_sum{space="old"} 7315456.0
# TYPE jvm_gc_seconds histogram
@@ -2675,7 +2678,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 f687d1f..3c812b7 100644
--- a/installation-running.html
+++ b/installation-running.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1760,7 +1763,8 @@
<p>The running port on which Ditto can be accessed is described in the Readme of the respective deployment section.</p>
-<p>If you want to change the MongoDB config or Ditto config please have a look here: <a href="installation-operating.html">Operating Ditto</a></p>
+<p>If you want to change the MongoDB config or Ditto config please have a look here:
+<a href="installation-operating.html">Operating Ditto</a></p>
<h3 id="managed-mongodb-service">Managed MongoDB service</h3>
<p>When using a managed MongoDB service the following recommendations should be taken into account:</p>
@@ -1805,7 +1809,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 9ff3e86..c3e5b11 100644
--- a/intro-digitaltwins.html
+++ b/intro-digitaltwins.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1721,9 +1724,9 @@
<div class="bs-callout bs-callout-primary"><strong>TL;DR</strong><br />Digital twins are a pattern for simplifying IoT solution development.</div>
-<p>The problem with the term <strong>digital twin</strong> is that there are many different understandings of what it means. Furthermore
-the term was previously mostly used and coined by marketing. The term was/is missing a technical foundation of what to
-expect from a framework for digital twins.</p>
+<p>The problem with the term <strong>digital twin</strong> is that there are many different understandings of what it means.
+Furthermore, the term was previously mostly used and coined by marketing. The term was/is missing a
+technical foundation of what to expect from a framework for digital twins.</p>
<p>Eclipse Ditto provides such a framework for digital twins and this page describes how Ditto defines/sees digital twins
from a technical perspective.</p>
@@ -1783,7 +1786,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 d03cb58..9db6f8a 100644
--- a/intro-hello-world.html
+++ b/intro-hello-world.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1719,11 +1722,13 @@
- <p>After <a href="installation-running.html">starting Ditto</a>, we have a HTTP and WebSocket API for your <a href="intro-digitaltwins.html">digital twins</a> at our hands.</p>
+ <p>After <a href="installation-running.html">starting Ditto</a>, we have a HTTP and WebSocket API for your
+<a href="intro-digitaltwins.html">digital twins</a> at our hands.</p>
<h2 id="example">Example</h2>
-<p>Assume we want to create a digital twin for a car. The twin should hold static metadata and dynamic state data. The state data should change as often as its real world counterpart does.</p>
+<p>Assume we want to create a digital twin for a car. The twin should hold static metadata and dynamic state data.
+The state data should change as often as its real world counterpart does.</p>
<p>Those static and dynamic types of data are mapped in the Ditto model to “attributes” (for static metadata), “features”
(for dynamic state data) and “definition” (to link a model the thing follows,
@@ -1765,8 +1770,8 @@
<p>Inside “attributes” (the metadata) we can add as much JSON keys as we like with any JSON value we need.</p>
-<p>Inside “features” (the state data) we can add as much features as we like - but each feature needs to have a “properties” JSON object.
-Inside that JSON object we can add as much JSON keys as we like with any JSON value we need.</p>
+<p>Inside “features” (the state data) we can add as much features as we like - but each feature needs to have
+a “properties” JSON object. Inside that JSON object we can add as much JSON keys as we like with any JSON value we need.</p>
<p>Inside “definition” we can add one JSON string value.</p>
@@ -1776,7 +1781,7 @@
Those credentials have been created by default in the <a href="https://github.com/nginx/nginx">nginx</a> started via “docker”.
(See <a href="https://github.com/eclipse/ditto/blob/master/deployment/docker/README.md">ditto/deployment/docker/README.md</a>)</p>
-<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-u</span> ditto:ditto <span class="nt">-X</span> PUT <span class="nt">-d</span> <span class="s1">'{
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-u</span> ditto:ditto <span class="nt">-X</span> PUT <span class="nt">-H</span> <span class="s1">'Content-Type: application/json'</span> <span class="nt">-d</span> <span class="s1">'{
"definition": "digitaltwin:DigitaltwinExample:1.0.0",
"attributes": {
"manufacturer": "ACME",
@@ -1804,11 +1809,11 @@
}
}
}
- }'</span> <span class="s1">'http://localhost:8080/api/1/things/org.eclipse.ditto:fancy-car'</span>
+ }'</span> <span class="s1">'http://localhost:8080/api/2/things/org.eclipse.ditto:fancy-car'</span>
</code></pre></div></div>
-<p>The result is a digital twin in Thing notation. The Thing ID is <code class="highlighter-rouge">org.eclipse.ditto:fancy-car</code>. An ID must always contain a
-namespace before the <code class="highlighter-rouge">:</code>. That way Things are easier to organize.</p>
+<p>The result is a digital twin in Thing notation. The Thing ID is <code class="highlighter-rouge">org.eclipse.ditto:fancy-car</code>.
+An ID must always contain a namespace before the <code class="highlighter-rouge">:</code>. That way Things are easier to organize.</p>
<h2 id="querying-an-existing-thing">Querying an existing Thing</h2>
@@ -1817,10 +1822,10 @@
<p>For Things we know the ID of, we can simply query them by their ID:</p>
-<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-u</span> ditto:ditto <span class="nt">-X</span> GET <span class="s1">'http://localhost:8080/api/1/things/org.eclipse.ditto:fancy-car'</span>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-u</span> ditto:ditto <span class="nt">-X</span> GET <span class="s1">'http://localhost:8080/api/2/things/org.eclipse.ditto:fancy-car'</span>
<span class="c"># if you have python installed, that's how to get a prettier response:</span>
-curl <span class="nt">-u</span> ditto:ditto <span class="nt">-X</span> GET <span class="s1">'http://localhost:8080/api/1/things/org.eclipse.ditto:fancy-car'</span> | python <span class="nt">-m</span> json.tool
+curl <span class="nt">-u</span> ditto:ditto <span class="nt">-X</span> GET <span class="s1">'http://localhost:8080/api/2/things/org.eclipse.ditto:fancy-car'</span> | python <span class="nt">-m</span> json.tool
</code></pre></div></div>
<h2 id="querying-one-specific-state-value">Querying one specific state value</h2>
@@ -1829,14 +1834,14 @@
<p>That way we can for example just retrieve the <code class="highlighter-rouge">cur_speed</code> of our fancy car:</p>
-<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-u</span> ditto:ditto <span class="nt">-X</span> GET <span class="s1">'http://localhost:8080/api/1/things/org.eclipse.ditto:fancy-car/features/transmission/properties/cur_speed'</span>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-u</span> ditto:ditto <span class="nt">-X</span> GET <span class="s1">'http://localhost:8080/api/2/things/org.eclipse.ditto:fancy-car/features/transmission/properties/cur_speed'</span>
</code></pre></div></div>
<h2 id="updating-one-specific-state-value">Updating one specific state value</h2>
<p>We can just as easy use the HTTP API to update one attribute or feature property, e.g. update the <code class="highlighter-rouge">cur_speed</code> to <code class="highlighter-rouge">77</code>:</p>
-<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-u</span> ditto:ditto <span class="nt">-X</span> PUT <span class="nt">-d</span> <span class="s1">'77'</span> <span class="s1">'http://localhost:8080/api/1/things/org.eclipse.ditto:fancy-car/features/transmission/properties/cur_speed'</span>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-u</span> ditto:ditto <span class="nt">-X</span> PUT <span class="nt">-H</span> <span class="s1">'Content-Type: application/json'</span> <span class="nt">-d</span> <span class="s1">'77'</span> <span class="s1">'http://localhost:8080/api/2/things/org.eclipse.ditto:fancy-car/features/transmission/properties/cur_speed'</span>
</code></pre></div></div>
<h2 id="searching-for-all-things">Searching for all Things</h2>
@@ -1844,7 +1849,7 @@
<p>When we lost the overview which Things we have already created, we can use the <code class="highlighter-rouge">search</code> HTTP endpoint,
e.g. searching all Things with the same <code class="highlighter-rouge">manufacturer</code> named <code class="highlighter-rouge">"ACME"</code>:</p>
-<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-u</span> ditto:ditto <span class="nt">-X</span> GET <span class="s1">'http://localhost:8080/api/1/search/things?filter=eq(attributes/manufacturer,"ACME")'</span>
+<div class="language-bash highlighter-rouge"><div class="highlight"><pre class="highlight"><code>curl <span class="nt">-u</span> ditto:ditto <span class="nt">-X</span> GET <span class="s1">'http://localhost:8080/api/2/search/things?filter=eq(attributes/manufacturer,"ACME")'</span>
</code></pre></div></div>
@@ -1872,7 +1877,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 f3a5c48..a22bc32 100644
--- a/intro-overview.html
+++ b/intro-overview.html
@@ -218,17 +218,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -278,6 +280,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -289,19 +298,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -505,12 +513,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -970,6 +972,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1008,12 +1017,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1728,15 +1731,15 @@
A digital twin is a virtual, cloud based, representation of his real world counterpart
(real world “Things”, e.g. devices like sensors, smart heating, connected cars, smart grids, EV charging stations, …).</p>
-<p>The technology mirrors potentially millions and billions of digital twins residing in the digital world with physical “<strong>Things</strong>”.
-This simplifies developing IoT solutions for software developers as they do not need to know how or where
-exactly the physical “Things” are connected.</p>
+<p>The technology mirrors potentially millions and billions of digital twins residing in the digital world
+with physical “<strong>Things</strong>”. This simplifies developing IoT solutions for software developers as they do not need
+to know how or where exactly the physical “Things” are connected.</p>
<p>With Ditto a thing can just be used as any other web service via its digital twin.</p>
<h2 id="what-is-it-not">What is it not?</h2>
-<p>Ditto is not another fully-fledged IoT platform. It does not provide software running on IoT gateways and it does not
+<p>Ditto is not another fully-fledged IoT platform. It does not provide software running on IoT gateways, and it does not
define or implement an IoT protocol in order to communicate with devices.</p>
<p>Its focus lies on back end scenarios by providing web APIs in order to simplify working with already connected (e.g.
@@ -1801,7 +1804,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/jsonschema/error.json b/jsonschema/error.json
index 0f8c6ef..0002035 100644
--- a/jsonschema/error.json
+++ b/jsonschema/error.json
@@ -12,7 +12,7 @@
"error": {
"type": "string",
"title": "Error code",
- "description": "The error code or identifier that uniquely identifies the error e.g. `things:features.notfound`."
+ "description": "The error code or identifier that uniquely identifies the error.\nThis code is not to be considered as API and must therefore not be relied on.\nIt might change without prior notice."
},
"message": {
"type": "string",
diff --git a/jsonschema/protocol-error_response.json b/jsonschema/protocol-error_response.json
index c7320db..57bc3fd 100644
--- a/jsonschema/protocol-error_response.json
+++ b/jsonschema/protocol-error_response.json
@@ -6,7 +6,7 @@
"properties": {
"topic": {
"type": "string",
- "description": "Contains the topic of the error including on which channel it was issued."
+ "description": "Contains the topic of the error including on which channel it was issued: `<namespace>/<name>/<group>/<optional-channel>/errors`\n* for Thing related errors: `<namespace>/<name>/things/twin/errors`\n* for Policy related errors: `<namespace>/<name>/policies/errors`"
},
"headers": {
"type": "object",
@@ -35,7 +35,7 @@
"error": {
"type": "string",
"title": "Error code",
- "description": "The error code or identifier that uniquely identifies the error e.g. `things:features.notfound`."
+ "description": "The error code or identifier that uniquely identifies the error.\nThis code is not to be considered as API and must therefore not be relied on.\nIt might change without prior notice."
},
"message": {
"type": "string",
@@ -64,5 +64,5 @@
"description": "The status code that indicates the result of the command. 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" ]
+ "required": [ "topic", "headers", "path", "value","status" ]
}
diff --git a/openapi/README.md b/openapi/README.md
index 580e5db..92a7926 100644
--- a/openapi/README.md
+++ b/openapi/README.md
@@ -2,7 +2,7 @@
This folder contains the OpenAPI [OpenAPI](https://www.openapis.org) [Specification version 2](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md) documentation for Eclipse Ditto.
-You can view it as nicely rendered HTML by importing one of the files (for API version 1 or 2) into the [Swagger Online Editor](https://editor.swagger.io).
+You can view it as nicely rendered HTML by importing the file for API version 2 into the [Swagger Online Editor](https://editor.swagger.io).
### Extend/update api docs
@@ -16,9 +16,6 @@
// go to sources
$ cd sources
-// only v1
-$ npm run build-v1
-
// only v2
$ npm run build-v2
diff --git a/openapi/ditto-api-2.yml b/openapi/ditto-api-2.yml
index 71cedb1..1251986 100644
--- a/openapi/ditto-api-2.yml
+++ b/openapi/ditto-api-2.yml
@@ -8,7 +8,7 @@
The Eclipse Ditto HTTP API uses response status codes (see [RFC 7231](https://tools.ietf.org/html/rfc7231#section-6))
to indicate whether a specific request has been successfully completed, or not.
- However, the descriptions we provide additionally to the status code (e.g. in our API docs, or error codes like. "things.entitiy.tooLarge") might change without advance notice. These are not be considered as official API, and must therefore not be applied in your applications or tests.
+ However, the descriptions we provide additionally to the status code (e.g. in our API docs, or error codes like. "things:thing.tooLarge") might change without advance notice. These are not be considered as official API, and must therefore not be applied in your applications or tests.
servers:
- url: 'https://ditto.eclipseprojects.io/api/2'
description: online Ditto Sandbox
@@ -1066,15 +1066,9 @@
'412':
$ref: '#/components/responses/PreconditionFailed'
put:
- summary: Create or update the policy ID of a thing
+ summary: Update the policy ID of a thing
description: |-
- 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 the policy ID of the thing identified by the `thingId` path parameter.
### Update
If the thing already has a `policyId` you can assign it to an existing policy by setting the new `policyId`
@@ -1089,19 +1083,6 @@
- $ref: '#/components/parameters/TimeoutParam'
- $ref: '#/components/parameters/ResponseRequiredParam'
responses:
- '201':
- description: 'The policy ID was successfully created. Note: You will need to create the policy content separately.'
- headers:
- ETag:
- description: |-
- The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
- "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
- schema:
- type: string
- content:
- application/json:
- schema:
- type: string
'204':
description: The policy ID was successfully updated.
headers:
diff --git a/openapi/sources/api-2-index.yml b/openapi/sources/api-2-index.yml
index b8bef46..be7cc86 100644
--- a/openapi/sources/api-2-index.yml
+++ b/openapi/sources/api-2-index.yml
@@ -18,7 +18,7 @@
The Eclipse Ditto HTTP API uses response status codes (see [RFC 7231](https://tools.ietf.org/html/rfc7231#section-6))
to indicate whether a specific request has been successfully completed, or not.
- However, the descriptions we provide additionally to the status code (e.g. in our API docs, or error codes like. "things.entitiy.tooLarge") might change without advance notice. These are not be considered as official API, and must therefore not be applied in your applications or tests.
+ The information Ditto provides additionally to the status code (e.g. in API docs, or error codes like. "things:thing.tooLarge") might change without advance notice. These are not be considered as official API, and must therefore not be applied in your applications or tests.
servers:
- url: https://ditto.eclipseprojects.io/api/2
diff --git a/openapi/sources/package.json b/openapi/sources/package.json
index d1d86cc..83d9df2 100644
--- a/openapi/sources/package.json
+++ b/openapi/sources/package.json
@@ -1,7 +1,6 @@
{
"scripts": {
- "build": "npm run build-v1 && npm run build-v2",
- "build-v1": "swagger-cli bundle api-1-index.yml --outfile ../ditto-api-1.yml --type yaml",
+ "build": "npm run build-v2",
"build-v2": "swagger-cli bundle api-2-index.yml --outfile ../ditto-api-2.yml --type yaml"
},
"dependencies": {
diff --git a/openapi/sources/parameters/timeoutParam.yml b/openapi/sources/parameters/timeoutParam.yml
index 4d9c6b1..7036239 100644
--- a/openapi/sources/parameters/timeoutParam.yml
+++ b/openapi/sources/parameters/timeoutParam.yml
@@ -15,9 +15,8 @@
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`.
+ The default (if omitted) and maximum timeout is `60s`. A value of `0` applies fire and forget semantics for
+ the command resulting in setting `response-required=false`.
required: false
schema:
type: string
\ No newline at end of file
diff --git a/openapi/sources/paths/things/policyId.yml b/openapi/sources/paths/things/policyId.yml
index 92cdd36..2200167 100644
--- a/openapi/sources/paths/things/policyId.yml
+++ b/openapi/sources/paths/things/policyId.yml
@@ -58,15 +58,9 @@
'412':
$ref: '../../responses/preconditionFailed.yml'
put:
- summary: Create or update the policy ID of a thing
+ summary: Update the policy ID of a thing
description: |-
- 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 the policy ID of the thing identified by the `thingId` path parameter.
### Update
If the thing already has a `policyId` you can assign it to an existing policy by setting the new `policyId`
@@ -81,20 +75,6 @@
- $ref: '../../parameters/timeoutParam.yml'
- $ref: '../../parameters/responseRequiredParam.yml'
responses:
- '201':
- description: |-
- The policy ID was successfully created. Note: You will need to create the policy content separately.
- headers:
- ETag:
- description: |-
- The (current server-side) ETag for this (sub-)resource. For top-level resources it is in the format
- "rev:[revision]", for sub-resources it has the format "hash:[calculated-hash]".
- schema:
- type: string
- content:
- application/json:
- schema:
- type: string
'204':
description: The policy ID was successfully updated.
headers:
@@ -207,4 +187,4 @@
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
\ No newline at end of file
+ required: true
diff --git a/presentations.html b/presentations.html
index c63786e..a96608b 100644
--- a/presentations.html
+++ b/presentations.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1793,7 +1796,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 bc16381..cc3ce87 100644
--- a/protocol-bindings.html
+++ b/protocol-bindings.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1737,8 +1740,8 @@
<h2 id="content-type">Content Type</h2>
-<p>When sending messages towards Ditto, the following content type has to be specified in a protocol-specific way given that
-the messages are already in <a href="protocol-overview.html">Ditto Protocol</a> format.</p>
+<p>When sending messages towards Ditto, the following content type has to be specified in a protocol-specific way given
+that the messages are already in <a href="protocol-overview.html">Ditto Protocol</a> format.</p>
<p>All <a href="basic-changenotifications.html">change notifications</a> emitted by Ditto will also contain the <code class="highlighter-rouge">content-type</code>:</p>
@@ -1773,7 +1776,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 3038373..7948ed6 100644
--- a/protocol-examples-createattribute.html
+++ b/protocol-examples-createattribute.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="modifyattribute">ModifyAttribute</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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">"/attributes/location"</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">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
@@ -1736,8 +1741,10 @@
<h2 id="modifyattributeresponse">ModifyAttributeResponse</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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">"/attributes/location"</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">
@@ -1746,8 +1753,10 @@
<h2 id="attributecreated">AttributeCreated</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"/attributes/location"</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">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
@@ -1775,7 +1784,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 3a1d9af..9667fd7 100644
--- a/protocol-examples-createattributes.html
+++ b/protocol-examples-createattributes.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="modifyattributes">ModifyAttributes</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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">"/attributes"</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">"location"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
@@ -1738,8 +1743,10 @@
<h2 id="modifyattributesresponse">ModifyAttributesResponse</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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">"/attributes"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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">
@@ -1749,8 +1756,10 @@
<h2 id="attributescreated">AttributesCreated</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"/attributes"</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">"location"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
@@ -1780,7 +1789,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 639bab8..d45699a 100644
--- a/protocol-examples-createdefinition.html
+++ b/protocol-examples-createdefinition.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,11 +1726,13 @@
<h2 id="modifyfeaturedefinition">ModifyFeatureDefinition</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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/accelerometer/definition"</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">"com.acme:accelerometer:1.0.0"</span><span class="w">
+ </span><span class="s2">"org.eclipse.ditto:accelerometer:1.0.0"</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>
@@ -1735,8 +1740,10 @@
<h2 id="modifyfeaturedefinitionresponse">ModifyFeatureDefinitionResponse</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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/accelerometer/definition"</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">
@@ -1745,11 +1752,13 @@
<h2 id="featuredefinitioncreated">FeatureDefinitionCreated</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/definition"</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">"com.acme:accelerometer:1.0.0"</span><span class="w">
+ </span><span class="s2">"org.eclipse.ditto:accelerometer:1.0.0"</span><span class="w">
</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">
@@ -1773,7 +1782,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-createdesiredproperties.html b/protocol-examples-createdesiredproperties.html
index 3ed6ba0..af6248e 100644
--- a/protocol-examples-createdesiredproperties.html
+++ b/protocol-examples-createdesiredproperties.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="modifyfeaturedesiredproperties">ModifyFeatureDesiredProperties</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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/accelerometer/desiredProperties"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w">
@@ -1738,8 +1743,10 @@
<h2 id="modifyfeaturedesiredpropertiesresponse">ModifyFeatureDesiredPropertiesResponse</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties"</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">
@@ -1748,8 +1755,10 @@
<h2 id="featuredesiredpropertiescreated">FeatureDesiredPropertiesCreated</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w">
@@ -1778,7 +1787,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-createdesiredproperty.html b/protocol-examples-createdesiredproperty.html
index 766d42b..5f91699 100644
--- a/protocol-examples-createdesiredproperty.html
+++ b/protocol-examples-createdesiredproperty.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="modifyfeaturedesiredproperty">ModifyFeatureDesiredProperty</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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/accelerometer/desiredProperties/x"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">42</span><span class="w">
</span><span class="p">}</span><span class="w">
@@ -1733,8 +1738,10 @@
<h2 id="modifyfeaturedesiredpropertyresponse">ModifyFeatureDesiredPropertyResponse</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties/x"</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">
@@ -1743,8 +1750,10 @@
<h2 id="featuredesiredpropertycreated">FeatureDesiredPropertyCreated</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties/x"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">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">1</span><span class="w">
@@ -1768,7 +1777,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 6bb06b3..42e6b4d 100644
--- a/protocol-examples-createfeature.html
+++ b/protocol-examples-createfeature.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="modifyfeature">ModifyFeature</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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/accelerometer"</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">"properties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
@@ -1746,8 +1751,10 @@
<h2 id="modifyfeatureresponse">ModifyFeatureResponse</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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/accelerometer"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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">
@@ -1757,8 +1764,10 @@
<h2 id="featurecreated">FeatureCreated</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer"</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">"properties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
@@ -1796,7 +1805,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 1626f43..d6119b4 100644
--- a/protocol-examples-createfeatures.html
+++ b/protocol-examples-createfeatures.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="modifyfeatures">ModifyFeatures</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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"</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">"accelerometer"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
@@ -1748,8 +1753,10 @@
<h2 id="modifyfeaturesresponse">ModifyFeaturesResponse</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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">
@@ -1759,8 +1766,10 @@
<h2 id="featurescreated">FeaturesCreated</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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"</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">"accelerometer"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
@@ -1800,7 +1809,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 15cf0df..a69bc2d 100644
--- a/protocol-examples-createproperties.html
+++ b/protocol-examples-createproperties.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="modifyfeatureproperties">ModifyFeatureProperties</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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/accelerometer/properties"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
@@ -1738,8 +1743,10 @@
<h2 id="modifyfeaturepropertiesresponse">ModifyFeaturePropertiesResponse</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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/accelerometer/properties"</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">
@@ -1748,8 +1755,10 @@
<h2 id="featurepropertiescreated">FeaturePropertiesCreated</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/properties"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
@@ -1779,7 +1788,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 0767452..d02cf6e 100644
--- a/protocol-examples-createproperty.html
+++ b/protocol-examples-createproperty.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="modifyfeatureproperty">ModifyFeatureProperty</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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/accelerometer/properties/x"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">42</span><span class="w">
</span><span class="p">}</span><span class="w">
@@ -1733,8 +1738,10 @@
<h2 id="modifyfeaturepropertyresponse">ModifyFeaturePropertyResponse</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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/accelerometer/properties/x"</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">
@@ -1743,8 +1750,10 @@
<h2 id="featurepropertycreated">FeaturePropertyCreated</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/properties/x"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">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">1</span><span class="w">
@@ -1769,7 +1778,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 eae4182..543e967 100644
--- a/protocol-examples-creatething.html
+++ b/protocol-examples-creatething.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1722,16 +1725,18 @@
<h2 id="creatething">CreateThing</h2>
-<p>Creates a new Thing with ID <code class="highlighter-rouge">com.acme:xdk_53</code> that uses an existing Policy with ID <code class="highlighter-rouge">com.acme:the_policy_id</code>.</p>
+<p>Creates a new Thing with ID <code class="highlighter-rouge">org.eclipse.ditto:fancy-thing_53</code> that uses an existing Policy with ID <code class="highlighter-rouge">org.eclipse.ditto:the_policy_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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/xdk_53/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:xdk_53"</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">"definition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:XDKmodel:1.0.0"</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:fancy-thing_53"</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:the_policy_id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:SomeModel:1.0.0"</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="p">{</span><span class="w">
</span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
@@ -1758,13 +1763,15 @@
<h2 id="createthingresponse">CreateThingResponse</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:xdk_53"</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">"definition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:XDKmodel:1.0.0"</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:fancy-thing_53"</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:the_policy_id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:SomeModel:1.0.0"</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="p">{</span><span class="w">
</span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
@@ -1792,12 +1799,14 @@
<h2 id="thingcreated">ThingCreated</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:xdk_53"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:fancy-thing_53"</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:the_policy_id"</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="p">{</span><span class="w">
</span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
@@ -1832,15 +1841,17 @@
<h3 id="creatething-with-copied-policy-by-policy-id">CreateThing with copied Policy by Policy ID</h3>
-<p>Creates a new Thing with ID <code class="highlighter-rouge">com.acme:xdk_53</code> with a Policy copied from the Policy with ID <code class="highlighter-rouge">com.acme:the_policy_id_to_copy</code>.</p>
+<p>Creates a new Thing with ID <code class="highlighter-rouge">org.eclipse.ditto:fancy-thing_53</code> with a Policy copied from the Policy with ID <code class="highlighter-rouge">org.eclipse.ditto:the_policy_id_to_copy</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/xdk_53/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:xdk_53"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:fancy-thing_53"</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:the_policy_id"</span><span class="p">,</span><span class="w">
</span><span class="s2">"_copyPolicyFrom"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com:acme:the_policy_id_to_copy"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span><span class="p">}</span><span class="w">
@@ -1848,16 +1859,18 @@
<h3 id="creatething-with-copied-policy-by-thing-reference">CreateThing with copied Policy by Thing reference</h3>
-<p>Creates a new Thing with ID <code class="highlighter-rouge">com.acme:xdk_53</code> with a Policy copied from a Thing with ID <code class="highlighter-rouge">com.acme:xdk_52</code>.</p>
+<p>Creates a new Thing with ID <code class="highlighter-rouge">org.eclipse.ditto:fancy-thing_53</code> with a Policy copied from a Thing with ID <code class="highlighter-rouge">org.eclipse.ditto:fancy-thing_52</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme/xdk_53/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:xdk_53"</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">"_copyPolicyFrom"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ ref:things/com:acme:xdk_52/policyId }}"</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_53"</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:the_policy_id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"_copyPolicyFrom"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ ref:things/com:acme:fancy-thing_52/policyId }}"</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>
@@ -1880,7 +1893,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 4285964..b7a56b0 100644
--- a/protocol-examples-createthingdefinition.html
+++ b/protocol-examples-createthingdefinition.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="modifythingdefinition">ModifyThingDefinition</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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">"/definition"</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">"digitaltwin:DigitaltwinExample:1.0.0"</span><span class="w">
</span><span class="p">}</span><span class="w">
@@ -1733,8 +1738,10 @@
<h2 id="modifythingdefinitionresponse">ModifyThingDefinitionResponse</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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">"/definition"</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">"digitaltwin:DigitaltwinExample:1.0.0"</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">
@@ -1744,8 +1751,10 @@
<h2 id="definitioncreated">DefinitionCreated</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"/definition"</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">"digitaltwin:DigitaltwinExample:1.0.0"</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">2</span><span class="w">
@@ -1770,7 +1779,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 f9945b6..6e8bcbf 100644
--- a/protocol-examples-deleteattribute.html
+++ b/protocol-examples-deleteattribute.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="deleteattribute">DeleteAttribute</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"/attributes/location"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
@@ -1732,8 +1737,10 @@
<h2 id="deleteattributeresponse">DeleteAttributeResponse</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"/attributes/location"</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">
@@ -1742,8 +1749,10 @@
<h2 id="attributedeleted">AttributeDeleted</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/deleted"</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/events/deleted"</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">"<preserved-command-correlation-id>"</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">"/attributes/location"</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">
@@ -1767,7 +1776,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 a628cd2..135423c 100644
--- a/protocol-examples-deleteattributes.html
+++ b/protocol-examples-deleteattributes.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="deleteattributes">DeleteAttributes</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"/attributes"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
@@ -1732,8 +1737,10 @@
<h2 id="deleteattributesresponse">DeleteAttributesResponse</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"/attributes"</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">
@@ -1742,8 +1749,10 @@
<h2 id="attributesdeleted">AttributesDeleted</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/deleted"</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/events/deleted"</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">"<preserved-command-correlation-id>"</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">"/attributes"</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">
@@ -1767,7 +1776,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 ef8730b..fbc19b7 100644
--- a/protocol-examples-deletedefinition.html
+++ b/protocol-examples-deletedefinition.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="deletefeaturedefinition">DeleteFeatureDefinition</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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/accelerometer/definition"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
@@ -1732,8 +1737,10 @@
<h2 id="deletefeaturedefinitionresponse">DeleteFeatureDefinitionResponse</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/definition"</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">
@@ -1742,8 +1749,10 @@
<h2 id="featuredefinitiondeleted">FeatureDefinitionDeleted</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/deleted"</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/events/deleted"</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">"<preserved-command-correlation-id>"</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/accelerometer/definition"</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">
@@ -1767,7 +1776,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-deletedesiredproperties.html b/protocol-examples-deletedesiredproperties.html
index a273e10..fda1f19 100644
--- a/protocol-examples-deletedesiredproperties.html
+++ b/protocol-examples-deletedesiredproperties.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="deletefeaturedesiredproperties">DeleteFeatureDesiredProperties</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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/accelerometer/desiredProperties"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
@@ -1732,8 +1737,10 @@
<h2 id="deletefeaturedesiredpropertiesresponse">DeleteFeatureDesiredPropertiesResponse</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties"</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">
@@ -1742,8 +1749,10 @@
<h2 id="featuredesiredpropertiesdeleted">FeatureDesiredPropertiesDeleted</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/deleted"</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/events/deleted"</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">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties"</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">
@@ -1766,7 +1775,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-deletedesiredproperty.html b/protocol-examples-deletedesiredproperty.html
index 096915b..3216f7e 100644
--- a/protocol-examples-deletedesiredproperty.html
+++ b/protocol-examples-deletedesiredproperty.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="deletefeaturedesiredproperty">DeleteFeatureDesiredProperty</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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/accelerometer/desiredProperties/x"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
@@ -1732,8 +1737,10 @@
<h2 id="deletefeaturedesiredpropertyresponse">DeleteFeatureDesiredPropertyResponse</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties/x"</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">
@@ -1742,8 +1749,10 @@
<h2 id="featuredesiredpropertydeleted">FeatureDesiredPropertyDeleted</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/deleted"</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/events/deleted"</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">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties/x"</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">
@@ -1766,7 +1775,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 2e33f88..ee1800b 100644
--- a/protocol-examples-deletefeature.html
+++ b/protocol-examples-deletefeature.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="deletefeature">DeleteFeature</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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/accelerometer"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
@@ -1732,8 +1737,10 @@
<h2 id="deletefeatureresponse">DeleteFeatureResponse</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer"</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">
@@ -1742,8 +1749,10 @@
<h2 id="featuredeleted">FeatureDeleted</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/deleted"</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/events/deleted"</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">"<preserved-command-correlation-id>"</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/accelerometer"</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">
@@ -1767,7 +1776,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 35e7839..ae77d2d 100644
--- a/protocol-examples-deletefeatures.html
+++ b/protocol-examples-deletefeatures.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="deletefeatures">DeleteFeatures</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
@@ -1732,8 +1737,10 @@
<h2 id="deletefeaturesresponse">DeleteFeaturesResponse</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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"</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">
@@ -1742,8 +1749,10 @@
<h2 id="featuresdeleted">FeaturesDeleted</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/deleted"</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/events/deleted"</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">"<preserved-command-correlation-id>"</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"</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">
@@ -1767,7 +1776,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 3a6ff5f..3bdce81 100644
--- a/protocol-examples-deleteproperties.html
+++ b/protocol-examples-deleteproperties.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="deletefeatureproperties">DeleteFeatureProperties</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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/accelerometer/properties"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
@@ -1732,8 +1737,10 @@
<h2 id="deletefeaturepropertiesresponse">DeleteFeaturePropertiesResponse</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/properties"</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">
@@ -1742,8 +1749,10 @@
<h2 id="featurepropertiesdeleted">FeaturePropertiesDeleted</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/deleted"</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/events/deleted"</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">"<preserved-command-correlation-id>"</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/accelerometer/properties"</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">
@@ -1767,7 +1776,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 7cb54aa..eba777d 100644
--- a/protocol-examples-deleteproperty.html
+++ b/protocol-examples-deleteproperty.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="deletefeatureproperty">DeleteFeatureProperty</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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/accelerometer/properties/x"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
@@ -1732,8 +1737,10 @@
<h2 id="deletefeaturepropertyresponse">DeleteFeaturePropertyResponse</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/properties/x"</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">
@@ -1742,8 +1749,10 @@
<h2 id="featurepropertydeleted">FeaturePropertyDeleted</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/deleted"</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/events/deleted"</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">"<preserved-command-correlation-id>"</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/accelerometer/properties/x"</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">
@@ -1767,7 +1776,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 7267acb..a986444 100644
--- a/protocol-examples-deletething.html
+++ b/protocol-examples-deletething.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="deletething">DeleteThing</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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>
@@ -1732,8 +1737,10 @@
<h2 id="deletethingresponse">DeleteThingResponse</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
@@ -1742,8 +1749,10 @@
<h2 id="thingdeleted">ThingDeleted</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/deleted"</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/events/deleted"</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">"<preserved-command-correlation-id>"</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">"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">
@@ -1767,7 +1776,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 b546606..5f02ee5 100644
--- a/protocol-examples-deletethingdefinition.html
+++ b/protocol-examples-deletethingdefinition.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="deletethingdefinition">DeleteThingDefinition</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"/definition"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
@@ -1732,8 +1737,10 @@
<h2 id="deletethingdefinitionresponse">DeleteThingDefinitionResponse</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"/definition"</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">
@@ -1742,8 +1749,10 @@
<h2 id="definitiondeleted">DefinitionDeleted</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/deleted"</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/events/deleted"</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">"<preserved-command-correlation-id>"</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">"/definition"</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">3</span><span class="w">
</span><span class="p">}</span><span class="w">
@@ -1767,7 +1776,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 eafccf3..bba3d46 100644
--- a/protocol-examples-errorresponses.html
+++ b/protocol-examples-errorresponses.html
@@ -6,7 +6,7 @@
<meta name="viewport" content="width=device-width, initial-scale=1">
<meta name="description" content="">
<meta name="keywords" content=" examples, things error responses, error responses">
-<title> Error responses • Eclipse Ditto™ • a digital twin framework</title>
+<title> Things 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">
@@ -183,7 +183,7 @@
searchInput: document.getElementById('search-input'),
resultsContainer: document.getElementById('results-container'),
dataSource: 'search.json',
- searchResultTemplate: '<li><a href="{url}" title="Error responses">{title}</a></li>',
+ searchResultTemplate: '<li><a href="{url}" title="Things error responses">{title}</a></li>',
noResultsText: 'No results found.',
limit: 10,
fuzzy: true,
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1679,7 +1682,7 @@
<!-- Content Column -->
<div class="col-md-9" id="tg-sb-content">
<div class="post-header">
- <h1 class="post-title-main">Error responses</h1>
+ <h1 class="post-title-main">Things error responses</h1>
</div>
@@ -1719,128 +1722,24 @@
-
-<h2 id="thingerrorresponse">ThingErrorResponse</h2>
+ <p>The following listed example errors do not claim to be a complete list of all available and possible error responses.<br />
+Also, their texts and <strong>error</strong> codes might be outdated.</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">"unknown/unknown/things/twin/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">"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">"things:thing.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 Thing with ID 'com.acme:xdk_53' 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 Thing 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="thingsaclentryinvalid">things:acl.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/things/twin/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">"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">"things:acl.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 Access Control List Entry is invalid."</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="thingsaclinvalid">things:acl.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/things/twin/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">"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">"things:acl.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 Access Control List of the Thing with ID 'com.acme:xdk_53' 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">"There always has to be at least one ACL Entry with <READ, WRITE, ADMINISTRATE> 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">400</span><span class="w">
-</span><span class="p">}</span><span class="w">
-</span></code></pre></div></div>
-
-<h2 id="thingsaclmodificationinvalid">things:acl.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/things/twin/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">"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">"things:acl.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 modified Access Control List of the Thing with ID 'com.acme:xdk_53' 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">"There always has to be at least one ACL Entry with <READ, WRITE, ADMINISTRATE> 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="thingsaclnotallowed">things:acl.not.allowed</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/things/twin/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">"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">"things:acl.not.allowed"</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 schema version of the Thing with ID 'com.acme:xdk_53' does not allow Access Control List."</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">"Things in schema version 2 and higher use policies for permission management."</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="thingsaclnotfound">things:acl.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/things/twin/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">"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">"things:acl.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 ACL Entry for the Authorization Subject 'the_acl_subject' on the Thing with ID 'com.acme:xdk_53' could not be found."</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 Thing and the authorized subject of your request was correct."</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="thingsaclnotmodifiable">things:acl.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/things/twin/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">"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">"things:acl.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 Access Control List of the Thing with ID 'com.acme:xdk_53' could not be modified."</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 thing was correct and you have sufficient permissions. If you wanted to modify the complete Thing, try modifying it without also changing the Access Control List ('acl')."</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>
+<p>In order to find out all currently available errors, please inspect Ditto’s codebase and look at all implementations of
+the <code class="highlighter-rouge">ThingException</code> interface.</p>
<h2 id="thingsattributenotmodifiable">things:attribute.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/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:attribute.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 Attribute with name '/location' on the Thing with ID 'com.acme:xdk_53' could not be modified as the requester had insufficient permissions (WRITE is required)."</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 Attribute with name '/location' on the Thing with ID 'org.eclipse.ditto:fancy-thing' could not be modified as the requester had insufficient permissions (WRITE is required)."</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 Thing 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">
@@ -1850,13 +1749,15 @@
<h2 id="thingsattributesnotfound">things:attributes.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/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:attributes.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 Attributes of the Thing with ID 'com.acme:xdk_53' could not be found or the requester had insufficient permissions to access it."</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 Attributes of the Thing with ID 'org.eclipse.ditto:fancy-thing' could not be found or the 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 Thing 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">
@@ -1866,13 +1767,15 @@
<h2 id="thingsattributesnotmodifiable">things:attributes.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/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:attributes.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 Attributes on the Thing with ID 'com.acme:xdk_53' could not be modified as the requester had insufficient permissions (WRITE is required)."</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 Attributes on the Thing with ID 'org.eclipse.ditto:fancy-thing' could not be modified as the requester had insufficient permissions (WRITE is required)."</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 Thing 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">
@@ -1882,13 +1785,15 @@
<h2 id="thingsfeaturenotfound">things:feature.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/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:feature.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 Feature with ID 'accelerometer' on the Thing with ID 'com.acme:xdk_53' could not be found or the requester had insufficient permissions to access it."</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 Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' could not be found or the 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 Thing and the ID of your requested Feature 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">
@@ -1898,13 +1803,15 @@
<h2 id="thingsfeaturenotmodifiable">things:feature.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/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:feature.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 Feature with ID 'accelerometer' on the Thing with ID 'com.acme:xdk_53' could not be modified as the requester had insufficient permissions to modify it (WRITE is required)."</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 Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' could not be modified as the requester had insufficient permissions to modify it (WRITE is required)."</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 Thing and the ID of your requested Feature 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">
@@ -1914,13 +1821,15 @@
<h2 id="thingsfeaturepropertiesnotfound">things:feature.properties.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/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:feature.properties.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 Properties of the Feature with ID 'accelerometer' on the Thing with ID 'com.acme:xdk_53' do not exist or the requester had insufficient permissions to access it."</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 Properties of the Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' do not exist or the 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 Thing and the Feature ID 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">
@@ -1930,13 +1839,15 @@
<h2 id="thingsfeaturepropertiesnotmodifiable">things:feature.properties.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/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:feature.properties.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 Properties of the Feature with ID 'accelerometer' on the Thing with ID 'com.acme:xdk_53' cannot be modified as the requester had insufficient permissions to modify it (WRITE is required)."</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 Properties of the Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' cannot be modified as the requester had insufficient permissions to modify it (WRITE is required)."</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 Thing and the Feature ID 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">
@@ -1946,13 +1857,15 @@
<h2 id="thingsfeaturepropertynotfound">things:feature.property.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/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:feature.property.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 Property with JSON Pointer '/x' of the Feature with ID 'accelerometer' on the Thing with ID 'com.acme:xdk_53' does not exist or the requester had insufficient permissions to access it."</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 Property with JSON Pointer '/x' of the Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' does not exist or the 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 Thing, the Feature ID and the key of your requested property 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">
@@ -1962,13 +1875,15 @@
<h2 id="thingsfeaturepropertynotmodifiable">things:feature.property.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/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:feature.property.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 Property with JSON Pointer '/x' of the Feature with ID 'accelerometer' on the Thing with ID 'com.acme:xdk_53' could not be modified as the requester had insufficient permissions to modify it (WRITE is required)."</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 Property with JSON Pointer '/x' of the Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' could not be modified as the requester had insufficient permissions to modify it (WRITE is required)."</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 Thing, the Feature ID and the key of your requested property 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">
@@ -1978,13 +1893,15 @@
<h2 id="thingsfeaturedesiredpropertiesnotfound">things:feature.desiredProperties.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/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:feature.desiredProperties.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 desired properties of the Feature with ID 'accelerometer' on the Thing with ID 'com.acme:xdk_53' do not exist or the requester had insufficient permissions to access it."</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 desired properties of the Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' do not exist or the 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 Thing and the Feature ID 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">
@@ -1994,13 +1911,15 @@
<h2 id="thingsfeaturedesiredpropertiesnotmodifiable">things:feature.desiredProperties.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/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:feature.desiredProperties.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 desired properties of the Feature with ID 'accelerometer' on the Thing with ID 'com.acme:xdk_53' cannot be modified as the requester had insufficient permissions to modify it (WRITE is required)."</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 desired properties of the Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' cannot be modified as the requester had insufficient permissions to modify it (WRITE is required)."</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 Thing and the Feature ID 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">
@@ -2010,13 +1929,15 @@
<h2 id="thingsfeaturedesiredpropertynotfound">things:feature.desiredProperty.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/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:feature.desiredProperty.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 desired property with JSON Pointer '/x' of the Feature with ID 'accelerometer' on the Thing with ID 'com.acme:xdk_53' does not exist or the requester had insufficient permissions to access it."</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 desired property with JSON Pointer '/x' of the Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' does not exist or the 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 Thing, the Feature ID and the key of your requested desired property 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">
@@ -2026,13 +1947,15 @@
<h2 id="thingsfeaturedesiredpropertynotmodifiable">things:feature.desiredProperty.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/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:feature.desiredProperty.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 desired property with JSON Pointer '/x' of the Feature with ID 'accelerometer' on the Thing with ID 'com.acme:xdk_53' could not be modified as the requester had insufficient permissions to modify it (WRITE is required)."</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 desired property with JSON Pointer '/x' of the Feature with ID 'accelerometer' on the Thing with ID 'org.eclipse.ditto:fancy-thing' could not be modified as the requester had insufficient permissions to modify it (WRITE is required)."</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 Thing, the Feature ID and the key of your requested desired property 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">
@@ -2042,13 +1965,15 @@
<h2 id="thingsfeaturesnotfound">things:features.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/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:features.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 Features on the Thing with ID 'com.acme:xdk_53' do not exist or the requester had insufficient permissions to access it."</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 Features on the Thing with ID 'org.eclipse.ditto:fancy-thing' do not exist or the 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 Thing 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">
@@ -2058,13 +1983,15 @@
<h2 id="thingsfeaturesnotmodifiable">things:features.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/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:features.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 Features on the Thing with ID 'com.acme:xdk_53' cannot be modified as requester had insufficient permissions to modify it (WRITE is required)."</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 Features on the Thing with ID 'org.eclipse.ditto:fancy-thing' cannot be modified as requester had insufficient permissions to modify it (WRITE is required)."</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 Thing 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">
@@ -2074,8 +2001,10 @@
<h2 id="thingsidinvalid">things: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/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
@@ -2091,8 +2020,10 @@
<h2 id="thingsidnotsettable">things:id.notsettable</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/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
@@ -2107,13 +2038,15 @@
<h2 id="thingspolicynotallowed">things:policy.notallowed</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/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:policy.notallowed"</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 Thing with ID 'com.acme:xdk_53' could not be modified as it contained an inline Policy"</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 Thing with ID 'org.eclipse.ditto:fancy-thing' could not be modified as it contained an inline Policy"</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">"Once a Thing with inline Policy is created it can't be modified with another Policy. Use the Policy resources to modify the existing 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">400</span><span class="w">
@@ -2123,13 +2056,15 @@
<h2 id="thingspolicyidnotmodifiable">things:policyId.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/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:policyId.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 ID of the Thing with ID 'com.acme:xdk_53' could not be modified as the requester had insufficient permissions (WRITE is required)."</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 ID of the Thing with ID 'org.eclipse.ditto:fancy-thing' could not be modified as the requester had insufficient permissions (WRITE is required)."</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 Thing 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">
@@ -2139,13 +2074,15 @@
<h2 id="thingsthingconflict">things:thing.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/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:thing.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 Thing with ID 'com.acme:xdk_53' already exists"</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 Thing with ID 'org.eclipse.ditto:fancy-thing' 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 Thing 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">
@@ -2155,13 +2092,15 @@
<h2 id="thingsthingnotcreatable">things:thing.notcreatable</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/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:thing.notcreatable"</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 Thing with ID 'com.acme:xdk_53' could not be created as the Policy with ID 'com.acme:the_policy_id' is not existing."</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 Thing with ID 'org.eclipse.ditto:fancy-thing' could not be created as the Policy with ID 'org.eclipse.ditto:the_policy_id' is not existing."</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 you created the Thing with is correct and that the Policy is existing."</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">
@@ -2171,13 +2110,15 @@
<h2 id="thingsthingnotdeletable">things:thing.notdeletable</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/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:thing.notdeletable"</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 Thing with ID 'com.acme:xdk_53' could not be deleted as the requester had insufficient permissions ( WRITE on root resource is required)."</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 Thing with ID 'org.eclipse.ditto:fancy-thing' could not be deleted as the requester had insufficient permissions ( WRITE on root resource is required)."</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 Thing 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">
@@ -2187,13 +2128,15 @@
<h2 id="thingsthingnotfound">things:thing.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/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:thing.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 Thing with ID 'com.acme:xdk_53' could not be found or requester had insufficient permissions to access it."</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 Thing with ID 'org.eclipse.ditto:fancy-thing' 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 Thing 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">
@@ -2203,13 +2146,15 @@
<h2 id="thingsthingnotmodifiable">things:thing.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/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:thing.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 Thing with ID 'com.acme:xdk_53' could not be modified as the requester had insufficient permissions (WRITE is required)."</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 Thing with ID 'org.eclipse.ditto:fancy-thing' could not be modified as the requester had insufficient permissions (WRITE is required)."</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 Thing 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">
@@ -2219,13 +2164,15 @@
<h2 id="thingsthingtoomanymodifyingrequests">things:thing.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/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:thing.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 Thing with ID 'com.acme:xdk_53'."</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 Thing with ID 'org.eclipse.ditto:fancy-thing'."</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 Thing or re-structure your Thing in multiple Things 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">
@@ -2235,13 +2182,15 @@
<h2 id="thingsthingunavailable">things:thing.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/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"things:thing.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 Thing with ID 'com.acme:xdk_53' is not available, please try again later."</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 Thing with ID 'org.eclipse.ditto:fancy-thing' 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 Thing 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">
@@ -2251,7 +2200,7 @@
<h2 id="thingsidnotdeletable">things:id.notdeletable</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/things/twin/errors"</span><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/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">"response-required"</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">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/json"</span><span class="w">
@@ -2270,7 +2219,7 @@
<h2 id="thingspolicyidnotdeletable">things:policyId.notdeletable</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/things/twin/errors"</span><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/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">"response-required"</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">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/json"</span><span class="w">
@@ -2304,7 +2253,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-mergeattribute.html b/protocol-examples-mergeattribute.html
index 4278f1f..a0014fd 100644
--- a/protocol-examples-mergeattribute.html
+++ b/protocol-examples-mergeattribute.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1722,9 +1725,10 @@
<h2 id="merge-thing-command-at-attributeslocation">Merge thing command at /attributes/location</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/merge"</span><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/commands/merge"</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/merge-patch+json"</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/merge-patch+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">"<command-correlation-id>"</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">"/attributes/location"</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">
@@ -1737,8 +1741,10 @@
<h2 id="merge-thing-command-response-at-attributeslocation">Merge thing command response at /attributes/location</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/merge"</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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">"<preserved-command-correlation-id>"</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">"/attributes/location"</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">
@@ -1747,7 +1753,7 @@
<h2 id="thing-merged-event-at-attributeslocation">Thing merged event at /attributes/location</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/merged"</span><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/merged"</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/merge-patch+json"</span><span class="w">
</span><span class="p">},</span><span class="w">
@@ -1764,9 +1770,10 @@
<h2 id="merge-thing-command-deleting-attributeslocation">Merge thing command deleting /attributes/location</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/merge"</span><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/commands/merge"</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/merge-patch+json"</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/merge-patch+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">"<command-correlation-id>"</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">"/attributes/location"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
@@ -1791,7 +1798,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-mergeattributes.html b/protocol-examples-mergeattributes.html
index 52e7d64..5bf25ca 100644
--- a/protocol-examples-mergeattributes.html
+++ b/protocol-examples-mergeattributes.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1722,9 +1725,10 @@
<h2 id="merge-thing-command-at-attributes">Merge thing command at /attributes</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/merge"</span><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/commands/merge"</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/merge-patch+json"</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/merge-patch+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">"<command-correlation-id>"</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">"/attributes"</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">
@@ -1739,8 +1743,10 @@
<h2 id="merge-thing-command-response-at-attributes">Merge thing command response at /attributes</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/merge"</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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">"<preserved-command-correlation-id>"</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">"/attributes"</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">
@@ -1749,7 +1755,7 @@
<h2 id="thing-merged-event-at-attributes">Thing merged event at /attributes</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/merged"</span><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/merged"</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/merge-patch+json"</span><span class="w">
</span><span class="p">},</span><span class="w">
@@ -1768,9 +1774,10 @@
<h2 id="merge-thing-command-deleting-attributes">Merge thing command deleting /attributes</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/merge"</span><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/commands/merge"</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/merge-patch+json"</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/merge-patch+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">"<command-correlation-id>"</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">"/attributes"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
@@ -1795,7 +1802,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-mergedesiredproperties.html b/protocol-examples-mergedesiredproperties.html
index 330fbf5..60a71d9 100644
--- a/protocol-examples-mergedesiredproperties.html
+++ b/protocol-examples-mergedesiredproperties.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1722,9 +1725,10 @@
<h2 id="merge-thing-command-at-featuresaccelerometerdesiredproperties">Merge thing command at /features/accelerometer/desiredProperties</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/merge"</span><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/commands/merge"</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/merge-patch+json"</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/merge-patch+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">"<command-correlation-id>"</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/accelerometer/desiredProperties"</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">
@@ -1739,8 +1743,10 @@
<h2 id="merge-thing-command-response-at-featuresaccelerometerdesiredproperties">Merge thing command response at /features/accelerometer/desiredProperties</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/merge"</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties"</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">
@@ -1749,7 +1755,7 @@
<h2 id="thing-merged-event-at-featuresaccelerometerdesiredproperties">Thing merged event at /features/accelerometer/desiredProperties</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/merged"</span><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/merged"</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/merge-patch+json"</span><span class="w">
</span><span class="p">},</span><span class="w">
@@ -1768,9 +1774,10 @@
<h2 id="merge-thing-command-deleting-featuresaccelerometerdesiredproperties">Merge thing command deleting /features/accelerometer/desiredProperties</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/merge"</span><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/commands/merge"</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/merge-patch+json"</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/merge-patch+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">"<command-correlation-id>"</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/accelerometer/desiredProperties"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
@@ -1795,7 +1802,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-mergedesiredproperty.html b/protocol-examples-mergedesiredproperty.html
index b768b53..18a03c2 100644
--- a/protocol-examples-mergedesiredproperty.html
+++ b/protocol-examples-mergedesiredproperty.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1722,9 +1725,10 @@
<h2 id="merge-thing-command-at-featuresaccelerometerdesiredpropertiesx">Merge thing command at /features/accelerometer/desiredProperties/x</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/merge"</span><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/commands/merge"</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/merge-patch+json"</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/merge-patch+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">"<command-correlation-id>"</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/accelerometer/desiredProperties/x"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">42</span><span class="w">
@@ -1734,8 +1738,10 @@
<h2 id="merge-thing-command-response-at-featuresaccelerometerdesiredpropertiesx">Merge thing command response at /features/accelerometer/desiredProperties/x</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/merge"</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties/x"</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">
@@ -1744,7 +1750,7 @@
<h2 id="thing-merged-event-at-featuresaccelerometerdesiredpropertiesx">Thing merged event at /features/accelerometer/desiredProperties/x</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/merged"</span><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/merged"</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/merge-patch+json"</span><span class="w">
</span><span class="p">},</span><span class="w">
@@ -1758,9 +1764,10 @@
<h2 id="merge-thing-command-deleting-featuresaccelerometerdesiredpropertiesx">Merge thing command deleting /features/accelerometer/desiredProperties/x</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/merge"</span><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/commands/merge"</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/merge-patch+json"</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/merge-patch+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">"<command-correlation-id>"</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/accelerometer/desiredProperties/x"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
@@ -1785,7 +1792,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-mergefeature.html b/protocol-examples-mergefeature.html
index 8c2394e..fd768a2 100644
--- a/protocol-examples-mergefeature.html
+++ b/protocol-examples-mergefeature.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1722,14 +1725,15 @@
<h2 id="merge-thing-command-at-featuresaccelerometer">Merge thing command at /features/accelerometer</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/merge"</span><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/commands/merge"</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/merge-patch+json"</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/merge-patch+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">"<command-correlation-id>"</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/accelerometer"</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">"definition"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
- </span><span class="s2">"com.acme:accelerometer:1.0.0"</span><span class="w">
+ </span><span class="s2">"org.eclipse.ditto:accelerometer:1.0.0"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
@@ -1744,8 +1748,10 @@
<h2 id="merge-thing-command-response-at-featuresaccelerometer">Merge thing command response at /features/accelerometer</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/merge"</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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">"<preserved-command-correlation-id>"</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/accelerometer"</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">
@@ -1754,14 +1760,14 @@
<h2 id="thing-merged-event-at-featuresaccelerometer">Thing merged event at /features/accelerometer</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/merged"</span><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/merged"</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/merge-patch+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">"/features/accelerometer"</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">"definition"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
- </span><span class="s2">"com.acme:accelerometer:1.0.0"</span><span class="w">
+ </span><span class="s2">"org.eclipse.ditto:accelerometer:1.0.0"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
@@ -1778,9 +1784,10 @@
<h2 id="merge-thing-command-deleting-featuresaccelerometer">Merge thing command deleting /features/accelerometer</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/merge"</span><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/commands/merge"</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/merge-patch+json"</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/merge-patch+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">"<command-correlation-id>"</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/accelerometer"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
@@ -1805,7 +1812,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-mergefeaturedefinition.html b/protocol-examples-mergefeaturedefinition.html
index 333bcb9..4640ada 100644
--- a/protocol-examples-mergefeaturedefinition.html
+++ b/protocol-examples-mergefeaturedefinition.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1722,13 +1725,14 @@
<h2 id="merge-thing-command-at-featuresaccelerometerdefinition">Merge thing command at /features/accelerometer/definition</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/merge"</span><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/commands/merge"</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/merge-patch+json"</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/merge-patch+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">"<command-correlation-id>"</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/accelerometer/definition"</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">"com.acme:accelerometer:1.0.0"</span><span class="w">
+ </span><span class="s2">"org.eclipse.ditto:accelerometer:1.0.0"</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>
@@ -1736,8 +1740,10 @@
<h2 id="merge-thing-command-response-at-featuresaccelerometerdefinition">Merge thing command response at /features/accelerometer/definition</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/merge"</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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">"<preserved-command-correlation-id>"</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/accelerometer/definition"</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">
@@ -1746,13 +1752,13 @@
<h2 id="thing-merged-event-at-featuresaccelerometerdefinition">Thing merged event at /features/accelerometer/definition</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/merged"</span><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/merged"</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/merge-patch+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">"/features/accelerometer/definition"</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">"com.acme:accelerometer:1.0.0"</span><span class="w">
+ </span><span class="s2">"org.eclipse.ditto:accelerometer:1.0.0"</span><span class="w">
</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">42</span><span class="p">,</span><span class="w">
</span><span class="s2">"timestamp"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2021-01-18T09:42:12Z"</span><span class="w">
@@ -1762,9 +1768,10 @@
<h2 id="merge-thing-command-deleting-featuresaccelerometerdefinition">Merge thing command deleting /features/accelerometer/definition</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/merge"</span><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/commands/merge"</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/merge-patch+json"</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/merge-patch+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">"<command-correlation-id>"</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/accelerometer/definition"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
@@ -1789,7 +1796,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-mergefeatures.html b/protocol-examples-mergefeatures.html
index d9be35d..3465b0f 100644
--- a/protocol-examples-mergefeatures.html
+++ b/protocol-examples-mergefeatures.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1722,15 +1725,16 @@
<h2 id="merge-thing-command-at-features">Merge thing command at /features</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/merge"</span><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/commands/merge"</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/merge-patch+json"</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/merge-patch+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">"<command-correlation-id>"</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"</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">"accelerometer"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
</span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
- </span><span class="s2">"com.acme:accelerometer:1.0.0"</span><span class="w">
+ </span><span class="s2">"org.eclipse.ditto:accelerometer:1.0.0"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
@@ -1746,8 +1750,10 @@
<h2 id="merge-thing-command-response-at-features">Merge thing command response at /features</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/merge"</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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">"<preserved-command-correlation-id>"</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"</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">
@@ -1756,7 +1762,7 @@
<h2 id="thing-merged-event-at-features">Thing merged event at /features</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/merged"</span><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/merged"</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/merge-patch+json"</span><span class="w">
</span><span class="p">},</span><span class="w">
@@ -1764,7 +1770,7 @@
</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">"accelerometer"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
</span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
- </span><span class="s2">"com.acme:accelerometer:1.0.0"</span><span class="w">
+ </span><span class="s2">"org.eclipse.ditto:accelerometer:1.0.0"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
@@ -1782,9 +1788,10 @@
<h2 id="merge-thing-command-deleting-features">Merge thing command deleting /features</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/merge"</span><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/commands/merge"</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/merge-patch+json"</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/merge-patch+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">"<command-correlation-id>"</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"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
@@ -1809,7 +1816,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-mergepolicyid.html b/protocol-examples-mergepolicyid.html
index 9856a43..ab7faf8 100644
--- a/protocol-examples-mergepolicyid.html
+++ b/protocol-examples-mergepolicyid.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1722,20 +1725,23 @@
<h2 id="merge-thing-command-at-policyid">Merge thing command at /policyId</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/merge"</span><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/commands/merge"</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/merge-patch+json"</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/merge-patch+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">"<command-correlation-id>"</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="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:the_policy_id"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
<h2 id="merge-thing-command-response-at-policyid">Merge thing command response at /policyId</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/merge"</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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">"<preserved-command-correlation-id>"</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">
@@ -1744,12 +1750,12 @@
<h2 id="thing-merged-event-at-policyid">Thing merged event at /policyId</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/merged"</span><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/merged"</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/merge-patch+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">"/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">"value"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto: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">42</span><span class="p">,</span><span class="w">
</span><span class="s2">"timestamp"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2021-01-18T09:42:12Z"</span><span class="w">
</span><span class="p">}</span><span class="w">
@@ -1773,7 +1779,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-mergeproperties.html b/protocol-examples-mergeproperties.html
index e7eaa02..9a131bc 100644
--- a/protocol-examples-mergeproperties.html
+++ b/protocol-examples-mergeproperties.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1722,9 +1725,10 @@
<h2 id="merge-thing-command-at-featuresaccelerometerproperties">Merge thing command at /features/accelerometer/properties</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/merge"</span><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/commands/merge"</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/merge-patch+json"</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/merge-patch+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">"<command-correlation-id>"</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/accelerometer/properties"</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">
@@ -1739,8 +1743,10 @@
<h2 id="merge-thing-command-response-at-featuresaccelerometerproperties">Merge thing command response at /features/accelerometer/properties</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/merge"</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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">"<preserved-command-correlation-id>"</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/accelerometer/properties"</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">
@@ -1749,7 +1755,7 @@
<h2 id="thing-merged-event-at-featuresaccelerometerproperties">Thing merged event at /features/accelerometer/properties</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/merged"</span><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/merged"</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/merge-patch+json"</span><span class="w">
</span><span class="p">},</span><span class="w">
@@ -1768,9 +1774,10 @@
<h2 id="merge-thing-command-deleting-featuresaccelerometerproperties">Merge thing command deleting /features/accelerometer/properties</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/merge"</span><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/commands/merge"</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/merge-patch+json"</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/merge-patch+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">"<command-correlation-id>"</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/accelerometer/properties"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
@@ -1795,7 +1802,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-mergeproperty.html b/protocol-examples-mergeproperty.html
index ecf933b..ec49d6c 100644
--- a/protocol-examples-mergeproperty.html
+++ b/protocol-examples-mergeproperty.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1722,9 +1725,10 @@
<h2 id="merge-thing-command-at-featuresaccelerometerpropertiesx">Merge thing command at /features/accelerometer/properties/x</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/merge"</span><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/commands/merge"</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/merge-patch+json"</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/merge-patch+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">"<command-correlation-id>"</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/accelerometer/properties/x"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">42</span><span class="w">
@@ -1734,8 +1738,10 @@
<h2 id="merge-thing-command-response-at-featuresaccelerometerpropertiesx">Merge thing command response at /features/accelerometer/properties/x</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/merge"</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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">"<preserved-command-correlation-id>"</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/accelerometer/properties/x"</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">
@@ -1744,7 +1750,7 @@
<h2 id="thing-merged-event-at-featuresaccelerometerpropertiesx">Thing merged event at /features/accelerometer/properties/x</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/merged"</span><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/merged"</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/merge-patch+json"</span><span class="w">
</span><span class="p">},</span><span class="w">
@@ -1758,9 +1764,10 @@
<h2 id="merge-thing-command-deleting-featuresaccelerometerpropertiesx">Merge thing command deleting /features/accelerometer/properties/x</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/merge"</span><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/commands/merge"</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/merge-patch+json"</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/merge-patch+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">"<command-correlation-id>"</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/accelerometer/properties/x"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
@@ -1785,7 +1792,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-mergething.html b/protocol-examples-mergething.html
index f54a196..a89d3af 100644
--- a/protocol-examples-mergething.html
+++ b/protocol-examples-mergething.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1722,15 +1725,16 @@
<h2 id="merge-thing-command-at-">Merge thing command at /</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/merge"</span><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/commands/merge"</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/merge-patch+json"</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/merge-patch+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">"<command-correlation-id>"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:xdk_53"</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">"definition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:XDKmodel:1.0.0"</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:fancy-thing_53"</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:the_policy_id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:SomeModel:1.0.0"</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="p">{</span><span class="w">
</span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
@@ -1740,7 +1744,7 @@
</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">"accelerometer"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
</span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
- </span><span class="s2">"com.acme:accelerometer:1.0.0"</span><span class="w">
+ </span><span class="s2">"org.eclipse.ditto:accelerometer:1.0.0"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
@@ -1757,8 +1761,10 @@
<h2 id="merge-thing-command-response-at-">Merge thing command response at /</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/merge"</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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">"<preserved-command-correlation-id>"</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">
@@ -1767,15 +1773,15 @@
<h2 id="thing-merged-event-at-">Thing merged event at /</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/merged"</span><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/merged"</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/merge-patch+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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:xdk_53"</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">"definition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:XDKmodel:1.0.0"</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:fancy-thing_53"</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:the_policy_id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:SomeModel:1.0.0"</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="p">{</span><span class="w">
</span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
@@ -1785,7 +1791,7 @@
</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">"accelerometer"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
</span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
- </span><span class="s2">"com.acme:accelerometer:1.0.0"</span><span class="w">
+ </span><span class="s2">"org.eclipse.ditto:accelerometer:1.0.0"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
@@ -1819,7 +1825,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-mergethingdefinition.html b/protocol-examples-mergethingdefinition.html
index 12b1354..2655bf7 100644
--- a/protocol-examples-mergethingdefinition.html
+++ b/protocol-examples-mergethingdefinition.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1722,20 +1725,23 @@
<h2 id="merge-thing-command-at-definition">Merge thing command at /definition</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/merge"</span><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/commands/merge"</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/merge-patch+json"</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/merge-patch+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">"<command-correlation-id>"</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">"/definition"</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:XDKmodel:1.0.0"</span><span class="w">
+ </span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:SomeModel:1.0.0"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
<h2 id="merge-thing-command-response-at-definition">Merge thing command response at /definition</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/merge"</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/commands/merge"</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">"<preserved-command-correlation-id>"</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">"/definition"</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">
@@ -1744,12 +1750,12 @@
<h2 id="thing-merged-event-at-definition">Thing merged event at /definition</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/merged"</span><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/merged"</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/merge-patch+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">"/definition"</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:XDKmodel:1.0.0"</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">"org.eclipse.ditto:SomeModel:1.0.0"</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">42</span><span class="p">,</span><span class="w">
</span><span class="s2">"timestamp"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2021-01-18T09:42:12Z"</span><span class="w">
</span><span class="p">}</span><span class="w">
@@ -1758,9 +1764,10 @@
<h2 id="merge-thing-command-deleting-definition">Merge thing command deleting /definition</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/merge"</span><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/commands/merge"</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/merge-patch+json"</span><span class="w">
+ </span><span class="s2">"content-type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"application/merge-patch+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">"<command-correlation-id>"</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">"/definition"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</span><span class="w">
@@ -1785,7 +1792,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 3397dd3..e365de9 100644
--- a/protocol-examples-modifyattribute.html
+++ b/protocol-examples-modifyattribute.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="modifyattribute">ModifyAttribute</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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">"/attributes/location"</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">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
@@ -1736,8 +1741,10 @@
<h2 id="modifyattributeresponse">ModifyAttributeResponse</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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">"/attributes/location"</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">
@@ -1746,8 +1753,10 @@
<h2 id="attributemodified">AttributeModified</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">"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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"/attributes/location"</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">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
@@ -1775,7 +1784,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 ade5426..1cb38cf 100644
--- a/protocol-examples-modifyattributes.html
+++ b/protocol-examples-modifyattributes.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="modifyattributes">ModifyAttributes</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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">"/attributes"</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">"location"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
@@ -1738,8 +1743,10 @@
<h2 id="modifyattributesresponse">ModifyAttributesResponse</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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">"/attributes"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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">
@@ -1749,8 +1756,10 @@
<h2 id="attributesmodified">AttributesModified</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">"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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"/attributes"</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">"location"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
@@ -1780,7 +1789,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 b7ab58d..5fe692a 100644
--- a/protocol-examples-modifydefinition.html
+++ b/protocol-examples-modifydefinition.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,11 +1726,13 @@
<h2 id="modifyfeaturedefinition">ModifyFeatureDefinition</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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/accelerometer/definition"</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">"com.acme:accelerometer:1.0.0"</span><span class="w">
+ </span><span class="s2">"org.eclipse.ditto:accelerometer:1.0.0"</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>
@@ -1735,8 +1740,10 @@
<h2 id="modifyfeaturedefinitionresponse">ModifyFeatureDefinitionResponse</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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/accelerometer/definition"</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">
@@ -1745,11 +1752,13 @@
<h2 id="featuredefinitionmodified">FeatureDefinitionModified</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">"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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/definition"</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">"com.acme:accelerometer:1.0.0"</span><span class="w">
+ </span><span class="s2">"org.eclipse.ditto:accelerometer:1.0.0"</span><span class="w">
</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">
@@ -1773,7 +1782,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-modifydesiredproperties.html b/protocol-examples-modifydesiredproperties.html
index 97a8511..f736311 100644
--- a/protocol-examples-modifydesiredproperties.html
+++ b/protocol-examples-modifydesiredproperties.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="modifyfeaturedesiredproperties">ModifyFeatureDesiredProperties</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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/accelerometer/desiredProperties"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w">
@@ -1738,8 +1743,10 @@
<h2 id="modifyfeaturedesiredpropertiesresponse">ModifyFeatureDesiredPropertiesResponse</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties"</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">
@@ -1748,8 +1755,10 @@
<h2 id="featuredesiredpropertiesmodified">FeatureDesiredPropertiesModified</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">"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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w">
@@ -1778,7 +1787,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-modifydesiredproperty.html b/protocol-examples-modifydesiredproperty.html
index 050ccb4..d72c142 100644
--- a/protocol-examples-modifydesiredproperty.html
+++ b/protocol-examples-modifydesiredproperty.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="modifyfeaturedesiredproperty">ModifyFeatureDesiredProperty</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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/accelerometer/desiredProperties/x"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">42</span><span class="w">
</span><span class="p">}</span><span class="w">
@@ -1733,8 +1738,10 @@
<h2 id="modifyfeaturedesiredpropertyresponse">ModifyFeatureDesiredPropertyResponse</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties/x"</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">
@@ -1743,8 +1750,10 @@
<h2 id="featuredesiredpropertymodified">FeatureDesiredPropertyModified</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">"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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties/x"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">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">1</span><span class="w">
@@ -1768,7 +1777,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 8d7997e..ab36cf7 100644
--- a/protocol-examples-modifyfeature.html
+++ b/protocol-examples-modifyfeature.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="modifyfeature">ModifyFeature</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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/accelerometer"</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">"properties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
@@ -1746,8 +1751,10 @@
<h2 id="modifyfeatureresponse">ModifyFeatureResponse</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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/accelerometer"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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">
@@ -1757,8 +1764,10 @@
<h2 id="featuremodified">FeatureModified</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">"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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer"</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">"properties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
@@ -1796,7 +1805,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 a5d9bb9..397d00f 100644
--- a/protocol-examples-modifyfeatures.html
+++ b/protocol-examples-modifyfeatures.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="modifyfeatures">ModifyFeatures</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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"</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">"accelerometer"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
@@ -1748,8 +1753,10 @@
<h2 id="modifyfeaturesresponse">ModifyFeaturesResponse</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="kc">null</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">
@@ -1759,8 +1766,10 @@
<h2 id="featuresmodified">FeaturesModified</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">"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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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"</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">"accelerometer"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
@@ -1800,7 +1809,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 c928576..6c70019 100644
--- a/protocol-examples-modifypolicyid.html
+++ b/protocol-examples-modifypolicyid.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,18 +1726,22 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto: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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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">
@@ -1743,10 +1750,12 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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">"value"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto: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>
@@ -1754,10 +1763,12 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"value"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto: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>
@@ -1765,10 +1776,12 @@
<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">"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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"value"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto: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>
@@ -1791,7 +1804,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 e13a620..a509283 100644
--- a/protocol-examples-modifyproperties.html
+++ b/protocol-examples-modifyproperties.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="modifyfeatureproperties">ModifyFeatureProperties</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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/accelerometer/properties"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
@@ -1738,8 +1743,10 @@
<h2 id="modifyfeaturepropertiesresponse">ModifyFeaturePropertiesResponse</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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/accelerometer/properties"</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">
@@ -1748,8 +1755,10 @@
<h2 id="featurepropertiesmodified">FeaturePropertiesModified</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">"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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/properties"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
@@ -1779,7 +1788,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 aec4c45..3611c19 100644
--- a/protocol-examples-modifyproperty.html
+++ b/protocol-examples-modifyproperty.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="modifyfeatureproperty">ModifyFeatureProperty</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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/accelerometer/properties/x"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">42</span><span class="w">
</span><span class="p">}</span><span class="w">
@@ -1733,8 +1738,10 @@
<h2 id="modifyfeaturepropertyresponse">ModifyFeaturePropertyResponse</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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/accelerometer/properties/x"</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">
@@ -1743,8 +1750,10 @@
<h2 id="featurepropertymodified">FeaturePropertyModified</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">"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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/properties/x"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">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">1</span><span class="w">
@@ -1769,7 +1778,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 fcce2e1..bf39da9 100644
--- a/protocol-examples-modifything.html
+++ b/protocol-examples-modifything.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,13 +1726,15 @@
<h2 id="modifything">ModifyThing</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:xdk_53"</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">"definition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:XDKmodel:1.0.0"</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:fancy-thing_53"</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:the_policy_id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"definition"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:SomeModel:1.0.0"</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="p">{</span><span class="w">
</span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
@@ -1759,8 +1764,10 @@
<h2 id="modifythingresponse">ModifyThingResponse</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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">
@@ -1769,12 +1776,14 @@
<h2 id="thingmodified">ThingModified</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">"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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:xdk_53"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:fancy-thing_53"</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:the_policy_id"</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="p">{</span><span class="w">
</span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
@@ -1811,16 +1820,18 @@
<h3 id="modifything-with-copied-policy-by-policy-id">ModifyThing with copied Policy by Policy ID</h3>
-<p>If no Thing with ID <code class="highlighter-rouge">com.acme:xdk_53</code> exists, this command will create a new Thing with ID <code class="highlighter-rouge">com.acme:xdk_53</code> with a
-Policy copied from the Policy with ID <code class="highlighter-rouge">com.acme:the_policy_id_to_copy</code>.</p>
+<p>If no Thing with ID <code class="highlighter-rouge">org.eclipse.ditto:fancy-thing_53</code> exists, this command will create a new Thing with ID <code class="highlighter-rouge">org.eclipse.ditto:fancy-thing_53</code> with a
+Policy copied from the Policy with ID <code class="highlighter-rouge">org.eclipse.ditto:the_policy_id_to_copy</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">"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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:xdk_53"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:fancy-thing_53"</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:the_policy_id"</span><span class="p">,</span><span class="w">
</span><span class="s2">"_copyPolicyFrom"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com:acme:the_policy_id_to_copy"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span><span class="p">}</span><span class="w">
@@ -1828,17 +1839,19 @@
<h3 id="modifything-with-copied-policy-by-thing-reference">ModifyThing with copied Policy by Thing reference</h3>
-<p>If no Thing with ID <code class="highlighter-rouge">com.acme:xdk_53</code> exists, this command will create a new Thing with ID <code class="highlighter-rouge">com.acme:xdk_53</code> with a
-Policy copied from a Thing with ID <code class="highlighter-rouge">com.acme:xdk_52</code>.</p>
+<p>If no Thing with ID <code class="highlighter-rouge">org.eclipse.ditto:fancy-thing_53</code> exists, this command will create a new Thing with ID <code class="highlighter-rouge">org.eclipse.ditto:fancy-thing_53</code> with a
+Policy copied from a Thing with ID <code class="highlighter-rouge">org.eclipse.ditto:fancy-thing_52</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">"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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:xdk_53"</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">"_copyPolicyFrom"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ ref:things/com:acme:xdk_52/policyId }}"</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_53"</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:the_policy_id"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"_copyPolicyFrom"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{ ref:things/com:acme:fancy-thing_52/policyId }}"</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>
@@ -1861,7 +1874,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 a45b2e5..354edb4 100644
--- a/protocol-examples-modifythingdefinition.html
+++ b/protocol-examples-modifythingdefinition.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="modifythingdefinition">ModifyThingDefinition</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<command-correlation-id>"</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">"/definition"</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">"digitaltwin:DigitaltwinExample:1.0.0"</span><span class="w">
</span><span class="p">}</span><span class="w">
@@ -1733,8 +1738,10 @@
<h2 id="modifythingdefinitionresponse">ModifyThingDefinitionResponse</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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/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">"<preserved-command-correlation-id>"</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">"/definition"</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">
@@ -1743,8 +1750,10 @@
<h2 id="definitionmodified">DefinitionModified</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">"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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"/definition"</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">"digitaltwin:DigitaltwinExample:1.0.0"</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">3</span><span class="w">
@@ -1769,7 +1778,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-policies-announcement-subjectDeletion.html b/protocol-examples-policies-announcement-subjectDeletion.html
index a29eba3..ba41c80 100644
--- a/protocol-examples-policies-announcement-subjectDeletion.html
+++ b/protocol-examples-policies-announcement-subjectDeletion.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,10 +1726,9 @@
<h2 id="subjectdeletionannouncement">SubjectDeletionAnnouncement</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/announcements/subjectDeletion"</span><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/the_policy_id/policies/announcements/subjectDeletion"</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">"2cef2741-a503-4e54-ac19-ee7fc8504c92"</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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<some-correlation-id>"</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">
@@ -1757,7 +1759,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 943bb59..eada199 100644
--- a/protocol-examples-policies-createpolicy.html
+++ b/protocol-examples-policies-createpolicy.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,13 +1726,13 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"policyId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto: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">
@@ -1755,13 +1758,13 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"policyId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto: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">
@@ -1803,7 +1806,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 a7bf697..b68af7f 100644
--- a/protocol-examples-policies-createpolicyentry.html
+++ b/protocol-examples-policies-createpolicyentry.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,9 +1726,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">
@@ -1752,9 +1755,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
@@ -1779,7 +1782,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 822bb56..e5dc2b2 100644
--- a/protocol-examples-policies-createresource.html
+++ b/protocol-examples-policies-createresource.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,9 +1726,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">
@@ -1741,9 +1744,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
@@ -1768,7 +1771,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 6719622..86c351a 100644
--- a/protocol-examples-policies-createsubject.html
+++ b/protocol-examples-policies-createsubject.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,9 +1726,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">
@@ -1737,9 +1740,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
@@ -1764,7 +1767,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 d5c393c..be9d453 100644
--- a/protocol-examples-policies-deletepolicy.html
+++ b/protocol-examples-policies-deletepolicy.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,9 +1726,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">
@@ -1734,9 +1737,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
@@ -1761,7 +1764,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 656e7b9..a8b8d94 100644
--- a/protocol-examples-policies-deletepolicyentry.html
+++ b/protocol-examples-policies-deletepolicyentry.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,9 +1726,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">
@@ -1734,9 +1737,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
@@ -1761,7 +1764,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 e3debe1..8730770 100644
--- a/protocol-examples-policies-deleteresource.html
+++ b/protocol-examples-policies-deleteresource.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,9 +1726,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">
@@ -1734,9 +1737,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
@@ -1761,7 +1764,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 42a69c8..ffb80d8 100644
--- a/protocol-examples-policies-deletesubject.html
+++ b/protocol-examples-policies-deletesubject.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,9 +1726,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">
@@ -1734,9 +1737,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
@@ -1761,7 +1764,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 e9d7323..2b31b05 100644
--- a/protocol-examples-policies-errorresponses.html
+++ b/protocol-examples-policies-errorresponses.html
@@ -6,7 +6,7 @@
<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>
+<title> Policies 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">
@@ -183,7 +183,7 @@
searchInput: document.getElementById('search-input'),
resultsContainer: document.getElementById('results-container'),
dataSource: 'search.json',
- searchResultTemplate: '<li><a href="{url}" title="Error responses">{title}</a></li>',
+ searchResultTemplate: '<li><a href="{url}" title="Policies error responses">{title}</a></li>',
noResultsText: 'No results found.',
limit: 10,
fuzzy: true,
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1679,7 +1682,7 @@
<!-- Content Column -->
<div class="col-md-9" id="tg-sb-content">
<div class="post-header">
- <h1 class="post-title-main">Error responses</h1>
+ <h1 class="post-title-main">Policies error responses</h1>
</div>
@@ -1719,13 +1722,18 @@
-
+ <p>The following listed example errors do not claim to be a complete list of all available and possible error responses.<br />
+Also, their texts and <strong>error</strong> codes might be outdated.</p>
+
+<p>In order to find out all currently available errors, please inspect Ditto’s codebase and look at all implementations of
+the <code class="highlighter-rouge">PolicyException</code> interface.</p>
+
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/the_policy_id/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
@@ -1742,15 +1750,15 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/the_policy_id/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The Policy with ID 'org.eclipse.ditto: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">
@@ -1760,15 +1768,15 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/the_policy_id/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The Policy with ID 'org.eclipse.ditto: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">
@@ -1778,15 +1786,15 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/the_policy_id/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The Policy with ID 'org.eclipse.ditto: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">
@@ -1796,15 +1804,15 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/the_policy_id/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The Policy with ID 'org.eclipse.ditto: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">
@@ -1814,15 +1822,15 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/the_policy_id/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"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 'org.eclipse.ditto: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">
@@ -1832,15 +1840,15 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/the_policy_id/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The Policy with ID 'org.eclipse.ditto: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">
@@ -1850,9 +1858,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/the_policy_id/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
@@ -1868,15 +1876,15 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/the_policy_id/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The PolicyEntry with Label 'the_label' on the Policy with ID 'org.eclipse.ditto: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">
@@ -1886,15 +1894,15 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/the_policy_id/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The PolicyEntry with Label 'the_label' on the Policy with ID 'org.eclipse.ditto: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">
@@ -1904,15 +1912,15 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/the_policy_id/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"message"</span><span class="p">:</span><span class="w"> </span><span class="s2">"The PolicyEntry with Label 'the_label' on the Policy with ID 'org.eclipse.ditto: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">
@@ -1922,15 +1930,15 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/the_policy_id/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"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 'org.eclipse.ditto: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">
@@ -1940,15 +1948,15 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/the_policy_id/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"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 'org.eclipse.ditto: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">
@@ -1958,15 +1966,15 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/the_policy_id/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"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 'org.eclipse.ditto: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">
@@ -1976,15 +1984,15 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/the_policy_id/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"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 'org.eclipse.ditto: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">
@@ -1994,9 +2002,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/the_policy_id/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
@@ -2012,15 +2020,15 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/the_policy_id/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"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 'org.eclipse.ditto: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">
@@ -2030,15 +2038,15 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/the_policy_id/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"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 'org.eclipse.ditto: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">
@@ -2048,15 +2056,15 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/the_policy_id/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"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 'org.eclipse.ditto: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">
@@ -2066,15 +2074,15 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/the_policy_id/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"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 'org.eclipse.ditto: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">
@@ -2099,7 +2107,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 255ea42..acd0457 100644
--- a/protocol-examples-policies-modifypolicy.html
+++ b/protocol-examples-policies-modifypolicy.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,13 +1726,13 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"policyId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto: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">
@@ -1755,9 +1758,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
@@ -1782,7 +1785,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 26ff84d..42c5765 100644
--- a/protocol-examples-policies-modifypolicyentries.html
+++ b/protocol-examples-policies-modifypolicyentries.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,9 +1726,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">
@@ -1774,9 +1777,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
@@ -1801,7 +1804,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 37ec829..c068f29 100644
--- a/protocol-examples-policies-modifypolicyentry.html
+++ b/protocol-examples-policies-modifypolicyentry.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,9 +1726,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">
@@ -1752,9 +1755,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
@@ -1779,7 +1782,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 2cec08a..0ba63bc 100644
--- a/protocol-examples-policies-modifyresource.html
+++ b/protocol-examples-policies-modifyresource.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,9 +1726,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">
@@ -1741,9 +1744,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
@@ -1768,7 +1771,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 68877fd..48f9d28 100644
--- a/protocol-examples-policies-modifyresources.html
+++ b/protocol-examples-policies-modifyresources.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,9 +1726,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">
@@ -1744,9 +1747,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
@@ -1771,7 +1774,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 825afed..f00de43 100644
--- a/protocol-examples-policies-modifysubject.html
+++ b/protocol-examples-policies-modifysubject.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,9 +1726,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">
@@ -1737,9 +1740,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
@@ -1764,7 +1767,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 ecef90e..379f0a6 100644
--- a/protocol-examples-policies-modifysubjects.html
+++ b/protocol-examples-policies-modifysubjects.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,9 +1726,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">
@@ -1740,9 +1743,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
@@ -1767,7 +1770,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 a3b083d..18ba368 100644
--- a/protocol-examples-policies-retrievepolicy.html
+++ b/protocol-examples-policies-retrievepolicy.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,9 +1726,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">
@@ -1734,13 +1737,13 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"policyId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto: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">
@@ -1782,7 +1785,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 54fcd1a..410a732 100644
--- a/protocol-examples-policies-retrievepolicyentries.html
+++ b/protocol-examples-policies-retrievepolicyentries.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,9 +1726,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">
@@ -1734,9 +1737,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
@@ -1795,7 +1798,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 05cb481..da070fc 100644
--- a/protocol-examples-policies-retrievepolicyentry.html
+++ b/protocol-examples-policies-retrievepolicyentry.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,9 +1726,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">
@@ -1734,9 +1737,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
@@ -1777,7 +1780,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 abf61dc..65ac58c 100644
--- a/protocol-examples-policies-retrieveresource.html
+++ b/protocol-examples-policies-retrieveresource.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,9 +1726,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">
@@ -1734,9 +1737,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
@@ -1768,7 +1771,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 6672f99..eaafebf 100644
--- a/protocol-examples-policies-retrieveresources.html
+++ b/protocol-examples-policies-retrieveresources.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,9 +1726,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">
@@ -1734,9 +1737,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
@@ -1770,7 +1773,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 3309d5d..5673178 100644
--- a/protocol-examples-policies-retrievesubject.html
+++ b/protocol-examples-policies-retrievesubject.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,9 +1726,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">
@@ -1734,9 +1737,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
@@ -1764,7 +1767,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 192fc23..f80b880 100644
--- a/protocol-examples-policies-retrievesubjects.html
+++ b/protocol-examples-policies-retrievesubjects.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,9 +1726,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">
@@ -1734,9 +1737,9 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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/json"</span><span class="w">
+ </span><span class="s2">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">
@@ -1766,7 +1769,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 9298fee..57309e1 100644
--- a/protocol-examples-retrieveattribute.html
+++ b/protocol-examples-retrieveattribute.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="retrieveattribute">RetrieveAttribute</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"/attributes/location"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
@@ -1732,8 +1737,10 @@
<h2 id="retrieveattributeresponse">RetrieveAttributeResponse</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"/attributes/location"</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">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
@@ -1761,7 +1768,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 c7f8245..a6b4f26 100644
--- a/protocol-examples-retrieveattributes.html
+++ b/protocol-examples-retrieveattributes.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="retrieveattributes">RetrieveAttributes</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"/attributes"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
@@ -1732,8 +1737,10 @@
<h2 id="retrieveattributesresponse">RetrieveAttributesResponse</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"/attributes"</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">"location"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
@@ -1763,7 +1770,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 f5c0f5a..b92e263 100644
--- a/protocol-examples-retrievedefinition.html
+++ b/protocol-examples-retrievedefinition.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="retrievefeaturedefinition">RetrieveFeatureDefinition</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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/accelerometer/definition"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
@@ -1732,11 +1737,13 @@
<h2 id="retrievefeaturedefinitionresponse">RetrieveFeatureDefinitionResponse</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/definition"</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">"com.acme:accelerometer:1.0.0"</span><span class="w">
+ </span><span class="s2">"org.eclipse.ditto:accelerometer:1.0.0"</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">
@@ -1760,7 +1767,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-retrievedesiredproperties.html b/protocol-examples-retrievedesiredproperties.html
index 06a32b3..3d02e21 100644
--- a/protocol-examples-retrievedesiredproperties.html
+++ b/protocol-examples-retrievedesiredproperties.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="retrievefeaturedesiredproperties">RetrieveFeatureDesiredProperties</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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/accelerometer/desiredProperties"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
@@ -1732,8 +1737,10 @@
<h2 id="retrievefeaturedesiredpropertiesresponse">RetrieveFeatureDesiredPropertiesResponse</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mi">4</span><span class="p">,</span><span class="w">
@@ -1762,7 +1769,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-examples-retrievedesiredproperty.html b/protocol-examples-retrievedesiredproperty.html
index ef0fa38..1405254 100644
--- a/protocol-examples-retrievedesiredproperty.html
+++ b/protocol-examples-retrievedesiredproperty.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="retrievefeaturedesiredproperty">RetrieveFeatureDesiredProperty</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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/accelerometer/desiredProperties/x"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
@@ -1732,8 +1737,10 @@
<h2 id="retrievefeaturedesiredpropertyresponse">RetrieveFeatureDesiredPropertyResponse</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/desiredProperties/x"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">42</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">
@@ -1757,7 +1764,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 55f67a8..9d47126 100644
--- a/protocol-examples-retrievefeature.html
+++ b/protocol-examples-retrievefeature.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="retrievefeature">RetrieveFeature</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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/accelerometer"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
@@ -1732,8 +1737,10 @@
<h2 id="retrievefeatureresponse">RetrieveFeatureResponse</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer"</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">"properties"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
@@ -1771,7 +1778,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 420b13d..39395f0 100644
--- a/protocol-examples-retrievefeatures.html
+++ b/protocol-examples-retrievefeatures.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="retrievefeatures">RetrieveFeatures</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
@@ -1732,8 +1737,10 @@
<h2 id="retrievefeaturesresponse">RetrieveFeaturesResponse</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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"</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">"accelerometer"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span><span class="w">
@@ -1773,7 +1780,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 9e6b237..dce38bf 100644
--- a/protocol-examples-retrieveproperties.html
+++ b/protocol-examples-retrieveproperties.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="retrievefeatureproperties">RetrieveFeatureProperties</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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/accelerometer/properties"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
@@ -1732,8 +1737,10 @@
<h2 id="retrievefeaturepropertiesresponse">RetrieveFeaturePropertiesResponse</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/properties"</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">"x"</span><span class="p">:</span><span class="w"> </span><span class="mf">3.141</span><span class="p">,</span><span class="w">
@@ -1763,7 +1770,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 4ba442e..f29122d 100644
--- a/protocol-examples-retrieveproperty.html
+++ b/protocol-examples-retrieveproperty.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="retrievefeatureproperty">RetrieveFeatureProperty</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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/accelerometer/properties/x"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
@@ -1732,8 +1737,10 @@
<h2 id="retrievefeaturepropertyresponse">RetrieveFeaturePropertyResponse</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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/accelerometer/properties/x"</span><span class="p">,</span><span class="w">
</span><span class="s2">"value"</span><span class="p">:</span><span class="w"> </span><span class="mi">42</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">
@@ -1758,7 +1765,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 6336f06..f3f014a 100644
--- a/protocol-examples-retrievething.html
+++ b/protocol-examples-retrievething.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="retrievething">RetrieveThing</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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>
@@ -1732,8 +1737,10 @@
<h2 id="retrievething">RetrieveThing</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"fields"</span><span class="p">:</span><span class="w"> </span><span class="s2">"thingId,attributes(location)"</span><span class="w">
</span><span class="p">}</span><span class="w">
@@ -1742,12 +1749,14 @@
<h2 id="retrievethingresponse">RetrieveThingResponse</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:xdk_53"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:fancy-thing_53"</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:the_policy_id"</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="p">{</span><span class="w">
</span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
@@ -1793,7 +1802,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 d404233..9cd3f03 100644
--- a/protocol-examples-retrievethingdefinition.html
+++ b/protocol-examples-retrievethingdefinition.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,8 +1726,10 @@
<h2 id="retrievedefinition">RetrieveDefinition</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<command-correlation-id>"</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">"/definition"</span><span class="w">
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
@@ -1732,8 +1737,10 @@
<h2 id="retrieveattributeresponse">RetrieveAttributeResponse</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/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/fancy-thing/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"/definition"</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">"digitaltwin:DigitaltwinExample:1.0.0"</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">
@@ -1758,7 +1765,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 a517da1..71d5702 100644
--- a/protocol-examples-retrievethings.html
+++ b/protocol-examples-retrievethings.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1724,13 +1727,15 @@
<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/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">"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">"<command-correlation-id>"</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">"thingIds"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w">
- </span><span class="s2">"com.acme:xdk_53"</span><span class="p">,</span><span class="w">
- </span><span class="s2">"com.acme:xdk_58"</span><span class="p">,</span><span class="w">
- </span><span class="s2">"com.acme:xdk_67"</span><span class="w">
+ </span><span class="s2">"org.eclipse.ditto:fancy-thing_53"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"org.eclipse.ditto:fancy-thing_58"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"org.eclipse.ditto:fancy-thing_67"</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">
@@ -1739,12 +1744,14 @@
<h2 id="retrievethingsresponse">RetrieveThingsResponse</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/_/things/twin/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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/_/things/twin/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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"<preserved-command-correlation-id>"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"com.acme:xdk_53"</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">"thingId"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto:fancy-thing_53"</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:the_policy_id"</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="p">{</span><span class="w">
</span><span class="s2">"latitude"</span><span class="p">:</span><span class="w"> </span><span class="mf">44.673856</span><span class="p">,</span><span class="w">
@@ -1790,7 +1797,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 1cab75f..bc8e84a 100644
--- a/protocol-examples-search.html
+++ b/protocol-examples-search.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1862,7 +1865,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 b94c34d..94c440a 100644
--- a/protocol-examples.html
+++ b/protocol-examples.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1723,10 +1726,11 @@
<h2 id="command">Command</h2>
-<p>Each example always starts with a command message that initiates an operation at Ditto (e.g. create a thing, retrieve a thing).</p>
+<p>Each example always starts with a command message that initiates an operation at Ditto
+(e.g. create a thing, retrieve a thing).</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/xdk_58/things/twin/commands/modify"</span><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/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="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">
@@ -1738,7 +1742,8 @@
<h2 id="response">Response</h2>
-<p>A command always has a response which either reports the success or the failure. The example contains the success response.
+<p>A command always has a response which either reports the success or the failure.
+The example contains the success response.
See Thing Error responses for examples of messages that will be returned in case of an error.</p>
<div class="language-json highlighter-rouge"><div class="highlight"><pre class="highlight"><code><span class="p">{</span><span class="w">
@@ -1755,10 +1760,11 @@
<h2 id="event">Event</h2>
-<p>If Ditto triggers an event (e.g. Thing created, Attribute modified) as a result of the executed command, an example of such an event is also demonstrated.</p>
+<p>If Ditto triggers an event (e.g. Thing created, Attribute modified) as a result of the executed command,
+an example of such an event is also demonstrated.</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_id_3141/things/twin/events/modified"</span><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/thing_name_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="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">
@@ -1779,7 +1785,7 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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">
@@ -1791,7 +1797,7 @@
<p>And here is an example for a failed ACK (aka NACK, 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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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">
@@ -1804,7 +1810,7 @@
<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">"topic"</span><span class="p">:</span><span class="w"> </span><span class="s2">"org.eclipse.ditto/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">
@@ -1844,7 +1850,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 4c92039..239dfbc 100644
--- a/protocol-overview.html
+++ b/protocol-overview.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1760,7 +1763,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 d0ea21f..91e4e05 100644
--- a/protocol-specification-acks.html
+++ b/protocol-specification-acks.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1784,7 +1787,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-errors.html b/protocol-specification-errors.html
index 929cb66..40e4ab2 100644
--- a/protocol-specification-errors.html
+++ b/protocol-specification-errors.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li class="active"><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li class="active"><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1719,14 +1722,22 @@
- <p>Ditto Protocol messages of <a href="basic-errors.html">errors</a> transport information about encountered
-errors, e.g. client errors or server errors:</p>
+ <p>Ditto Protocol messages of <a href="basic-signals-errorresponse.html">error responses</a> transport information about encountered
+<a href="basic-errors.html">errors</a>, e.g. client errors or server errors:</p>
<script src="docson/widget.js" data-schema="../jsonschema/protocol-error_response.json"></script>
-<h2 id="example">Example</h2>
+<p>The <strong>error</strong> codes Ditto provides in addition to the HTTP <strong>status</strong> code
+(e.g. error codes like “things:thing.tooLarge”) is not to be considered as API and must therefore not be relied on.<br />
+It might change without prior notice.</p>
-<p>Examples for error responses can be found <a href="protocol-examples-errorresponses.html">here</a>.</p>
+<h2 id="examples">Examples</h2>
+
+<p>Examples for error responses can be found here:</p>
+<ul>
+ <li><a href="protocol-examples-errorresponses.html">Things error response examples</a></li>
+ <li><a href="protocol-examples-policies-errorresponses.html">Policies error response examples</a></li>
+</ul>
<div class="tags">
@@ -1753,7 +1764,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-policies-announcement.html b/protocol-specification-policies-announcement.html
index 644b85a..6545f1a 100644
--- a/protocol-specification-policies-announcement.html
+++ b/protocol-specification-policies-announcement.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1788,7 +1791,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 eecf251..68324af 100644
--- a/protocol-specification-policies-create-or-modify.html
+++ b/protocol-specification-policies-create-or-modify.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1722,7 +1725,7 @@
<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>
+JSON representation provided in the <code class="highlighter-rouge">value</code>.</p>
<h3 id="command">Command</h3>
@@ -1792,8 +1795,8 @@
<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>
+<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>
@@ -1936,11 +1939,11 @@
<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.
+<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 `
+<label><code class="highlighter-rouge"> in the </code>path` 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>
+If you specify an existing label, the respective Policy entry will be updated.</label></p>
<h3 id="command-3">Command</h3>
@@ -2081,8 +2084,8 @@
<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>
+<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>
@@ -2296,47 +2299,6 @@
<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">
@@ -2362,7 +2324,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 90c012b..b7f91c7 100644
--- a/protocol-specification-policies-delete.html
+++ b/protocol-specification-policies-delete.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1966,47 +1969,6 @@
<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">
@@ -2032,7 +1994,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 200ee18..1554fee 100644
--- a/protocol-specification-policies-retrieve.html
+++ b/protocol-specification-policies-retrieve.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1720,7 +1723,7 @@
<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>
+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>
@@ -2189,47 +2192,6 @@
<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">
@@ -2255,7 +2217,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 e1c3937..5e465b7 100644
--- a/protocol-specification-policies.html
+++ b/protocol-specification-policies.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1748,38 +1751,22 @@
<script src="docson/widget.js" data-schema="../jsonschema/policy.json"></script>
-<h2 id="common-error-responses-for-policies">Common error responses for Policies</h2>
+<h2 id="commands">Commands</h2>
-<p>These error responses can occur independent of the command that was sent:</p>
+<p>The following Policy commands are available:</p>
+<ul>
+ <li><a href="protocol-specification-policies-create-or-modify.html">create/modify commands</a></li>
+ <li><a href="protocol-specification-policies-retrieve.html">retrieve commands</a></li>
+ <li><a href="protocol-specification-policies-delete.html">delete commands</a></li>
+</ul>
-<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>
+<h3 id="common-errors-to-commands">Common errors to commands</h3>
-<h2 id="common-errors">Common errors</h2>
+<p>Each Policy command could also result in an <a href="protocol-specification-errors.html">error</a> response.<br />
+The <code class="highlighter-rouge">"topic"</code> of such errors differ from the command <code class="highlighter-rouge">"topic"</code> - correlation is however possible via the
+<code class="highlighter-rouge">"correlation-id"</code> header which is preserved in the error message.</p>
+
+<p>The following table contains common error codes for Policy commands:</p>
<table>
<thead>
@@ -1799,7 +1786,7 @@
</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>
+ <td>Forbidden - The Policy could not be modified/deleted/retrieved as the requester had insufficient permissions.</td>
</tr>
<tr>
<td><code class="highlighter-rouge">404</code></td>
@@ -1807,20 +1794,21 @@
</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>
+ <td>Precondition Failed - A precondition for reading or writing the (sub-)resource failed. This will happen for write requests, if you specified an <code class="highlighter-rouge">If-Match</code> or <code class="highlighter-rouge">If-None-Match</code> 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>
+ <td>Request Entity Too Large - The created or modified Policy is larger than the configured limit (defaults to 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>
+ <td><code class="highlighter-rouge">429</code></td>
+ <td>Too many modifying requests are already outstanding to a specific Policy.</td>
</tr>
</tbody>
</table>
+
<div class="tags">
<b>Tags: </b>
@@ -1845,7 +1833,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 f16b934..3e90e98 100644
--- a/protocol-specification-things-create-or-modify.html
+++ b/protocol-specification-things-create-or-modify.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1726,10 +1729,10 @@
<p>This command creates the thing specified by the <code class="highlighter-rouge"><namespace></code> and <code class="highlighter-rouge"><thingId></code> in the topic defined by the JSON in the
value.
-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> of the created Thing
-must include at least one subject authorized to READ, WRITE and ADMINISTRATE permissions.
-If no ACL is provided within the command, a default ACL with an entry for the authorized subject with all permissions
-set to true will be created.</p>
+The <a href="#" data-toggle="tooltip" data-original-title="A Policy enables developers to configure fine-grained access control in an easy way. A specific policy defines who (subject) is granted or revoked permissions (rights) on a specific resource. The resource can be defined as rough or as fine-grained as necessary for the respective use case. ">Policy</a> of the created
+Thing must include at least one subject authorized to have READ, WRITE permissions.
+If no Policy is provided within the command, a default Policy with an entry for the authorized subject with
+all permissions set to true will be created.</p>
<h3 id="command">Command</h3>
@@ -1792,16 +1795,6 @@
<td><code class="highlighter-rouge">201</code></td>
<td>Success - the thing was created successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">409</code></td>
- <td>Conflict - a thing with the given ID already exists.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -1865,8 +1858,6 @@
</table>
<p>For modifying an existing thing, the authorized subject needs WRITE permission.<br />
-If the update is targeting 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>,
-the authorized subject additionally needs ADMINISTRATE permission.<br />
If the thing does not yet exist, the same rules apply as described for the <a href="#create-a-thing">create command</a>.</p>
<h3 id="response-1">Response</h3>
@@ -1910,21 +1901,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - the Thing was modified successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The Thing could not be modified as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The Thing was not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2030,21 +2006,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - Attributes were modified successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The Attributes could not be modified as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The Thing or Attributes were not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2177,21 +2138,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - The Attribute was modified successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The Attribute could not be modified as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The Thing or Attribute was not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2323,21 +2269,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - The definition was modified successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The definition could not be modified as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The Thing or definition was not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2469,21 +2400,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - The Features were modified successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The Features could not be modified as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The Thing or Features were not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2614,21 +2530,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - the Feature was modified successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The Feature could not be modified as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The Thing or Feature was not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2759,21 +2660,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - the Definition was modified successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The Definition could not be modified as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The Thing, Feature or Definition was not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2904,21 +2790,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - the Properties were modified successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The Properties could not be modified as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The Properties were not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -3049,21 +2920,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - the desired Properties were modified successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The desired Properties could not be modified as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The desired Properties were not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -3202,24 +3058,6 @@
<td>Success - the Property was modified successfully.</td>
<td> </td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The Property could not be modified as the requester had insufficient permissions (‘WRITE’ is required).</td>
- <td> </td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The Thing or Property was not found or requester had insufficient permissions.</td>
- <td> </td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- <td> </td>
- </tr>
</tbody>
</table>
@@ -3359,24 +3197,6 @@
<td>Success - the desired Property was modified successfully.</td>
<td> </td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The desired Property could not be modified as the requester had insufficient permissions (‘WRITE’ is required).</td>
- <td> </td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The Thing or desired Property was not found or requester had insufficient permissions.</td>
- <td> </td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- <td> </td>
- </tr>
</tbody>
</table>
@@ -3461,7 +3281,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 65f8e75..8835565 100644
--- a/protocol-specification-things-delete.html
+++ b/protocol-specification-things-delete.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1778,21 +1781,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - the Thing was deleted successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Deletable - the Thing could not be deleted.</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - the Thing was not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -1878,21 +1866,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - Attributes were deleted successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The Attributes could not be deleted as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The Thing or Attributes were not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -1978,21 +1951,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - The Attribute was deleted successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The Attribute could not be deleted as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The Thing or Attribute was not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2078,21 +2036,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - The definition was deleted successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The definition could not be deleted as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The Thing or definition was not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2178,21 +2121,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - The Features were deleted successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The Features could not be deleted as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The Thing or Features were not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2278,21 +2206,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - the Feature was deleted successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The Feature could not be deleted as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The Thing or Feature was not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2379,21 +2292,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - the Definition was deleted successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The Definition could not be deleted as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The Thing, Feature or Definition was not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2480,21 +2378,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - the Properties were deleted successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The Properties could not be deleted as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The Properties were not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2581,21 +2464,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - the desired Properties were deleted successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The desired Properties could not be deleted as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The desired Properties were not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2681,21 +2549,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - the Property was deleted successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The Property could not be deleted as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The Thing or Property was not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2781,21 +2634,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - the desired Property was deleted successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The desired Property could not be deleted as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The Thing or desired Property was not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2850,7 +2688,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/protocol-specification-things-merge.html b/protocol-specification-things-merge.html
index ac71ac5..947fb42 100644
--- a/protocol-specification-things-merge.html
+++ b/protocol-specification-things-merge.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1786,16 +1789,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - the thing was merged successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - Could not be merged as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -1889,21 +1882,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - attributes were merged successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The attributes could not be merged as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The thing or attributes were not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -1997,21 +1975,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - The attribute was merged successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The attribute could not be merged as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The thing or attribute was not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2104,21 +2067,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - The definition was merged successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The definition could not be merged as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The thing or definition was not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2182,31 +2130,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - The definition was merged successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">400</code></td>
- <td>Policy ID invalid - The provided policyId is not valid.</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">400</code></td>
- <td>Not Deletable - The policyId of a thing cannot be deleted.</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The definition could not be merged as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The thing or definition was not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2300,21 +2223,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - The features were modified successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The features could not be merged as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The thing or features were not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2406,21 +2314,6 @@
<td><code class="highlighter-rouge">201</code></td>
<td>Success - The feature was created successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The feature could not be merged as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The thing or feature was not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2512,21 +2405,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - the definition was merged successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The definition could not be merged as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The thing, feature or definition was not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2618,21 +2496,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - the properties were modified successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The properties could not be merged as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The properties were not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2724,21 +2587,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - the desired properties were modified successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The desired properties could not be merged as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The desired properties were not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2831,21 +2679,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - the property was merged successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The property could not be merged as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The thing or property was not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2938,21 +2771,6 @@
<td><code class="highlighter-rouge">204</code></td>
<td>Success - the desired property was merged successfully.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">403</code></td>
- <td>Not Modifiable - The desired property could not be merged as the requester had insufficient permissions (‘WRITE’ is required).</td>
- </tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - The thing or desired property was not found or requester had insufficient permissions.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -3008,7 +2826,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 66cd1a9..13f7b03 100644
--- a/protocol-specification-things-messages.html
+++ b/protocol-specification-things-messages.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -2004,7 +2007,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 d9291cb..c99fa78 100644
--- a/protocol-specification-things-retrieve.html
+++ b/protocol-specification-things-retrieve.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1789,16 +1792,6 @@
<td><code class="highlighter-rouge">200</code></td>
<td>Success.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - the requested Thing does not exist or the requesting user does not have enough permission to retrieve it.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -1878,16 +1871,6 @@
<td><code class="highlighter-rouge">200</code></td>
<td>Success.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - the requested Things do not exist or the requesting user does not have enough permission to retrieve it.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -1955,16 +1938,6 @@
<td><code class="highlighter-rouge">200</code></td>
<td>Success.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - the requested Attributes do not exist or the requesting user does not have enough permission to retrieve it.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2033,16 +2006,6 @@
<td><code class="highlighter-rouge">200</code></td>
<td>Success.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - the requested Attribute does not exist or the requesting user does not have enough permission to retrieve it.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2110,16 +2073,6 @@
<td><code class="highlighter-rouge">200</code></td>
<td>Success.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - the requested Definition does not exist or the requesting user does not have enough permission to retrieve it.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2187,16 +2140,6 @@
<td><code class="highlighter-rouge">200</code></td>
<td>Success.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - the requested Features do not exist or the requesting user does not have enough permission to retrieve it.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2265,16 +2208,6 @@
<td><code class="highlighter-rouge">200</code></td>
<td>Success.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - the requested Feature does not exist or the requesting user does not have enough permission to retrieve it.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2343,16 +2276,6 @@
<td><code class="highlighter-rouge">200</code></td>
<td>Success.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - the requested Definition does not exist or requester has insufficient permissions to retrieve it.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2421,16 +2344,6 @@
<td><code class="highlighter-rouge">200</code></td>
<td>Success.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - the requested Properties do not exist or the requesting user does not have enough permission to retrieve it.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2499,16 +2412,6 @@
<td><code class="highlighter-rouge">200</code></td>
<td>Success.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - the requested desired Properties do not exist or the requesting user does not have enough permission to retrieve it.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2577,16 +2480,6 @@
<td><code class="highlighter-rouge">200</code></td>
<td>Success.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - the requested Property does not exist or the requesting user does not have enough permission to retrieve it.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2655,16 +2548,6 @@
<td><code class="highlighter-rouge">200</code></td>
<td>Success.</td>
</tr>
- <tr>
- <td> </td>
- <td><code class="highlighter-rouge">404</code></td>
- <td>Not Found - the requested desired Property does not exist or the requesting user does not have enough permission to retrieve it.</td>
- </tr>
- <tr>
- <td> </td>
- <td> </td>
- <td>See <a href="protocol-examples-errorresponses.html">Thing Error Responses</a> for examples of other error responses.</td>
- </tr>
</tbody>
</table>
@@ -2697,7 +2580,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 378e5c3..dfde6fe 100644
--- a/protocol-specification-things-search.html
+++ b/protocol-specification-things-search.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1719,8 +1722,8 @@
- <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.
+ <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
@@ -1806,8 +1809,8 @@
<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
+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.
@@ -2108,7 +2111,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 8df7729..5f82249 100644
--- a/protocol-specification-things.html
+++ b/protocol-specification-things.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li class="active"><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1746,45 +1749,63 @@
<h2 id="thing-representation">Thing representation</h2>
-<h3 id="api-version-1">API version 1</h3>
-
-<p>The representation of a <code class="highlighter-rouge">Thing</code> in <strong>API version 1</strong> is specified as follows:</p>
-
-<script src="docson/widget.js" data-schema="../jsonschema/thing_v1.json"></script>
-
-<h3 id="api-version-2">API version 2</h3>
-
<p>The representation of a <code class="highlighter-rouge">Thing</code> in <strong>API version 2</strong> is specified as follows:</p>
<script src="docson/widget.js" data-schema="../jsonschema/thing_v2.json"></script>
-<h2 id="common-error-responses-for-things">Common error responses for Things</h2>
+<h2 id="commands">Commands</h2>
-<p>These error responses can occur independent of the command that was sent:</p>
+<p>The following Thing commands are available:</p>
+<ul>
+ <li><a href="protocol-specification-things-create-or-modify.html">create/modify commands</a></li>
+ <li><a href="protocol-specification-things-merge.html">merge commands</a></li>
+ <li><a href="protocol-specification-things-retrieve.html">retrieve commands</a></li>
+ <li><a href="protocol-specification-things-delete.html">delete commands</a></li>
+</ul>
+
+<h3 id="common-errors-to-commands">Common errors to commands</h3>
+
+<p>Each Thing command could also result in an <a href="protocol-specification-errors.html">error</a> response.<br />
+The <code class="highlighter-rouge">"topic"</code> of such errors differ from the command <code class="highlighter-rouge">"topic"</code> - correlation is however possible via the
+<code class="highlighter-rouge">"correlation-id"</code> header which is preserved in the error message.</p>
+
+<p>The following table contains common error codes for Thing commands:</p>
<table>
<thead>
<tr>
- <th>status</th>
- <th>error</th>
- <th>message</th>
+ <th><strong>status</strong></th>
+ <th>Value</th>
</tr>
</thead>
<tbody>
<tr>
<td><code class="highlighter-rouge">400</code></td>
- <td><code class="highlighter-rouge">things:id.invalid</code></td>
- <td>The Thing ID <code class="highlighter-rouge"><thingId></code> is not valid!</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 Thing 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 Thing 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 <code class="highlighter-rouge">If-Match</code> or <code class="highlighter-rouge">If-None-Match</code> 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 configured limit (defaults to 100 kB).</td>
</tr>
<tr>
<td><code class="highlighter-rouge">429</code></td>
- <td><code class="highlighter-rouge">things:thing.toomanymodifyingrequests </code></td>
- <td>Too many modifying requests are already outstanding to the Thing with ID <code class="highlighter-rouge"><thingId></code>.</td>
- </tr>
- <tr>
- <td><code class="highlighter-rouge">503</code></td>
- <td><code class="highlighter-rouge">things:thing.unavailable</code></td>
- <td>The Thing with the given ID is not available, please try again later.</td>
+ <td>Too many modifying requests are already outstanding to a specific Thing.</td>
</tr>
</tbody>
</table>
@@ -1814,7 +1835,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 b9186ec..60a5197 100644
--- a/protocol-specification-topic.html
+++ b/protocol-specification-topic.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1754,8 +1757,8 @@
<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>
+<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>
@@ -1766,8 +1769,8 @@
<p>When addressing the <em>twin</em> channel, the <code class="highlighter-rouge">{criterion}</code> (e.g. a <strong>command</strong>) together with the optional <code class="highlighter-rouge">{action}</code> is
applied to the digital representation, the <strong>digital twin</strong>, of a <code class="highlighter-rouge">Thing</code>.
-Ditto enforces that <strong>digital twins</strong> can only be accessed in an <a href="basic-auth.html">authorized way</a> and responds with an
-error if the required permissions are not met.
+Ditto enforces that <strong>digital twins</strong> can only be accessed in an <a href="basic-auth.html">authorized way</a> and responds with
+an error if the required permissions are not met.
Addressing on the <em>twin</em> channel means addressing the backend representation of a <code class="highlighter-rouge">Thing</code> which might be outdated, but
roundtrips to actual devices are saved (e.g. a device in sleep mode must not be waken up in order to retrieve its last
reported state).</p>
@@ -1849,8 +1852,8 @@
<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
-Protocol message.</p>
+<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>
@@ -1879,8 +1882,8 @@
<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,
-provided that it conforms to <a href="https://tools.ietf.org/html/rfc3986">RFC-3986</a> (URI).</p>
+<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>
@@ -1930,7 +1933,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 791763a..8de74c8 100644
--- a/protocol-specification.html
+++ b/protocol-specification.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1925,7 +1928,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 86ae2dd..1e7f37b 100644
--- a/protocol-twinlive.html
+++ b/protocol-twinlive.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1744,7 +1747,7 @@
<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>
+Therefore, Policy commands have no <em>channel</em> in the Ditto Protocol format specification.</p>
<div class="tags">
@@ -1771,7 +1774,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 3c28533..c9b0b48 100644
--- a/release_notes_010-M1.html
+++ b/release_notes_010-M1.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1750,7 +1753,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 ca2f93f..0ba18c5 100644
--- a/release_notes_010-M3.html
+++ b/release_notes_010-M3.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1806,7 +1809,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 79e4cd6..9e7e16b 100644
--- a/release_notes_020-M1.html
+++ b/release_notes_020-M1.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1791,7 +1794,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 cdd689b..7e3c146 100644
--- a/release_notes_030-M1.html
+++ b/release_notes_030-M1.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1802,7 +1805,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 71cc9c6..04bdb8a 100644
--- a/release_notes_030-M2.html
+++ b/release_notes_030-M2.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1799,7 +1802,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 4bcf1ef..9564720 100644
--- a/release_notes_080-M1.html
+++ b/release_notes_080-M1.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1821,7 +1824,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 5e7df9f..75a815b 100644
--- a/release_notes_080-M2.html
+++ b/release_notes_080-M2.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1805,7 +1808,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 095a682..ffee538 100644
--- a/release_notes_080-M3.html
+++ b/release_notes_080-M3.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1809,7 +1812,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 1b99905..12e0e78 100644
--- a/release_notes_080.html
+++ b/release_notes_080.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1774,7 +1777,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---deprecated">API version 1 and 2</a> the
+<p>We however can already guarantee that at the HTTP API for API version 1 and 2 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
@@ -1815,7 +1818,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 603ea00..eeae223 100644
--- a/release_notes_090-M1.html
+++ b/release_notes_090-M1.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1787,7 +1790,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 c1e7ca2..fef4a5d 100644
--- a/release_notes_090-M2.html
+++ b/release_notes_090-M2.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1788,7 +1791,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 731148b..007ddc0 100644
--- a/release_notes_090.html
+++ b/release_notes_090.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1807,7 +1810,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---deprecated">API version 1 and 2</a> the
+<p>We however can already guarantee that at the HTTP API for API version 1 and 2 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
@@ -1845,7 +1848,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 f822105..e8b2aa9 100644
--- a/release_notes_100-M1a.html
+++ b/release_notes_100-M1a.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1806,7 +1809,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 047f229..1a334f3 100644
--- a/release_notes_100-M2.html
+++ b/release_notes_100-M2.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1823,7 +1826,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 32cf376..d78ef75 100644
--- a/release_notes_100.html
+++ b/release_notes_100.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1826,7 +1829,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 162ee01..84d7fce 100644
--- a/release_notes_110.html
+++ b/release_notes_110.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1821,7 +1824,7 @@
<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
+<p>Now that Ditto has a full replacement for ACLs, 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>
@@ -1867,7 +1870,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 4eef0b4..4b7b086 100644
--- a/release_notes_111.html
+++ b/release_notes_111.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1765,7 +1768,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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
index b75488e..f47e8cf 100644
--- a/release_notes_112.html
+++ b/release_notes_112.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1781,7 +1784,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_113.html b/release_notes_113.html
index 22386ba..837c086 100644
--- a/release_notes_113.html
+++ b/release_notes_113.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1781,7 +1784,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_115.html b/release_notes_115.html
index 2cabb15..61c7629 100644
--- a/release_notes_115.html
+++ b/release_notes_115.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1769,7 +1772,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_120.html b/release_notes_120.html
index 003ca9a..0fe64e8 100644
--- a/release_notes_120.html
+++ b/release_notes_120.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1841,7 +1844,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_121.html b/release_notes_121.html
index 7927c5b..648e164 100644
--- a/release_notes_121.html
+++ b/release_notes_121.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1768,7 +1771,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_130.html b/release_notes_130.html
index 5338bec..e75b69f 100644
--- a/release_notes_130.html
+++ b/release_notes_130.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li class="active"><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1858,7 +1861,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_140.html b/release_notes_140.html
index bb16ae8..ef68d0c 100644
--- a/release_notes_140.html
+++ b/release_notes_140.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li class="active"><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li class="active"><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1749,7 +1752,7 @@
<h4 id="placeholder-topicentityid-renamed-to-topicentityname"><a href="https://github.com/eclipse/ditto/pull/859">Placeholder topic:entityId renamed to topic:entityName</a></h4>
<p>The placeholder <code class="highlighter-rouge">topic:entityId</code> was not named correctly. It was resolved with the
-name of an entity and not the complete ID. Therefore a new placeholder
+name of an entity and not the complete ID. Therefore, a new placeholder
<code class="highlighter-rouge">topic:entityName</code> is introduced which reflects correctly what it means.</p>
<h3 id="new-features">New features</h3>
@@ -1835,7 +1838,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_150.html b/release_notes_150.html
index c857449..70ec43c 100644
--- a/release_notes_150.html
+++ b/release_notes_150.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1869,7 +1872,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_151.html b/release_notes_151.html
index 01a8249..f46ac72 100644
--- a/release_notes_151.html
+++ b/release_notes_151.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li class="active"><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1757,7 +1760,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/release_notes_200.html b/release_notes_200.html
new file mode 100644
index 0000000..df906b5
--- /dev/null
+++ b/release_notes_200.html
@@ -0,0 +1,2464 @@
+<!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 2.0.0 of Eclipse Ditto, released on 06.05.2021">
+<meta name="keywords" content="release_notes, release notes, announcements, changelog">
+<title> Release notes 2.0.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="Eclipse 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="sandbox.html">Sandbox</a></li>
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
+ </a></li>
+
+
+
+
+
+ <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
+ <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 2.0.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="2.0">2.0</option>
+
+ <option value="1.5">1.5</option>
+
+ <option value="1.4">1.4</option>
+
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</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_200.html">2.0.0</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_151.html">1.5.1</a></li>
+
+
+
+
+
+
+ <li><a href="release_notes_150.html">1.5.0</a></li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Archive</a>
+ <ul>
+
+
+
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_130.html">1.3.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_121.html">1.2.1</a></li>
+
+
+
+
+
+ <li><a href="release_notes_120.html">1.2.0</a></li>
+
+
+
+
+
+ <li><a href="release_notes_115.html">1.1.5</a></li>
+
+
+
+
+
+ <li><a href="release_notes_113.html">1.1.3</a></li>
+
+
+
+
+
+ <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>
+
+
+
+
+
+ <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><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-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>
+
+
+
+
+
+ <li><a href="basic-metadata.html">Thing Metadata</a></li>
+
+
+
+
+
+ <li><a href="basic-errors.html">Errors</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>
+
+
+
+
+
+ <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
+
+
+
+
+ </ul>
+ </li>
+
+
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>Advanced concepts</a>
+ <ul>
+
+
+
+ <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
+
+
+
+
+
+
+ <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-errors.html">Errors</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-merge.html">Merge</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>
+
+
+
+
+
+ <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
+
+
+
+ </ul>
+ </li>
+
+
+
+ <li class="subfolders">
+ <a href="#"><span></span>→ Things merge examples</a>
+ <ul>
+
+
+
+ <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
+
+
+
+
+
+ <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
+
+
+
+
+
+ <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
+</script>
+
+ </div>
+
+
+
+ <!-- Content Column -->
+ <div class="col-md-9" id="tg-sb-content">
+ <div class="post-header">
+ <h1 class="post-title-main">Release notes 2.0.0</h1>
+</div>
+
+
+
+<div class="post-content">
+
+
+ <div class="summary">Version 2.0.0 of Eclipse Ditto, released on 06.05.2021</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 Ditto’s second major release.</p>
+
+<p>This release is completely <a href="https://www.eclipse.org/projects/handbook/#ip">IP (intellectual property) checked by the Eclipse Foundation</a>
+meaning that project code as well as all used dependencies were “[…] reviewed to ensure that the copyrights
+expressed are correct, licensing is valid and compatible, and that other issues have been uncovered and properly
+investigated.”</p>
+
+<h2 id="changelog">Changelog</h2>
+
+<p>Eclipse Ditto 2.0.0 focuses on the following areas:</p>
+
+<ul>
+ <li>Merge/PATCH updates of digital twins</li>
+ <li>Configurable OpenID Connect / OAuth2.0 claim extraction to be used for authorization</li>
+ <li>Establishing connections to endpoints (via AMQP, MQTT, HTTP) utilizing a Ditto managed SSH tunnel</li>
+ <li>Addition of a DevOps API in order to retrieve all known connections</li>
+ <li>Expiring policy subjects + publishing of announcement message prior to expiry</li>
+ <li>Addition of policy actions in order to inject a policy subject based on a provided JWT</li>
+ <li>Built-in acknowledgement for search updates to have the option of twin updates with strong consistency of the search index</li>
+ <li>Restoring active connections faster after a hard restart of the Ditto cluster via automatic prioritization of connections</li>
+ <li>Support for LastWill/Testament + retain flag for MQTT connections</li>
+ <li>Provide JWT tokens to Websocket endpoint with browser APIs</li>
+</ul>
+
+<p>The step to a major version was done because of the following breaking API changes:</p>
+
+<ul>
+ <li>Removal of “API version 1” (deprecated in <a href="release_notes_110.html#deprecations">Ditto 1.1.0</a>)
+from Ditto’s Java APIs + HTTP API</li>
+ <li>Removal of code in Java APIs marked as <code class="highlighter-rouge">@Deprecated</code></li>
+ <li>Binary incompatible changes to Java APIs</li>
+ <li>Restructuring of Ditto’s Maven modules in order to simplify/ease further development</li>
+</ul>
+
+<p>The following non-functional enhancements are also included:</p>
+
+<ul>
+ <li>Improvement of stability during rolling updates</li>
+ <li>Addition of sharding concept for Ditto internal pub/sub enabling connection of e.g. tens of thousands websocket sessions</li>
+ <li>Background cleanup improvements in order to have less impact on DB roundtrip times</li>
+ <li>Update of third party libraries (e.g. Akka)</li>
+ <li>Documentation of deployment via K3S</li>
+</ul>
+
+<h3 id="changes">Changes</h3>
+
+<h4 id="removal-of-api-version-1-acl-based-authorization">Removal of API version 1 (ACL based authorization)</h4>
+
+<p>The <a href="basic-policy.html">Policy based</a> authorization is already available and stable since Ditto 1.0.0. This policy based
+authorization is more flexible and more powerful than the <a href="release_notes_110.html#deprecations">deprecated</a> ACL based
+authorization.<br />
+Having this well established replacement, the ACL based authorization and with that API version 1
+(in which a <a href="basic-thing.html">thing</a> contained an <code class="highlighter-rouge">acl</code> entry), is removed from Ditto 2.0.0.</p>
+
+<p>All documentation of the ACL based approach was deleted, but is still available by accessing version picker in Ditto’s
+documentation, selecting a 1.x Ditto version.</p>
+
+<p>The HTTP API <code class="highlighter-rouge">/api/1</code> and <code class="highlighter-rouge">/ws/1</code> (for the WebSocket) was also removed, using these endpoints will fail with Ditto 2.0.0.</p>
+
+<p><a href="basic-thing.html">Things</a> which still contain an <code class="highlighter-rouge">acl</code> entry (instead of a <code class="highlighter-rouge">policyId</code>) can no longer be used in
+Ditto 2.0.0. If you need to migrate “things” from API 1 to API version 2, please have a look at the<br />
+<a href="#migrate-api-1-things-to-api-2">migration notes</a>.</p>
+
+<h4 id="removal-of-deprecated-code--binary-incompatible-changes-to-java-apis">Removal of deprecated code + binary incompatible changes to Java APIs</h4>
+
+<p>In order to not break binary compatibility in Ditto 1.x, existing APIs were marked as <code class="highlighter-rouge">@Deprecated</code> with a comment
+pointing to an alternative implementation to use instead. Now, these deprecated APIs are removed from Ditto’s codebase.</p>
+
+<p>Some changes to the codebase which could not be done in Ditto 1.x without breaking binary compatibility were also done.</p>
+
+<h4 id="removed-content-type-header-mapping-for-connection-targets"><a href="https://github.com/eclipse/ditto/pull/934">Removed content-type header mapping for connection targets</a></h4>
+
+<p>Removed the default header mapping of <code class="highlighter-rouge">content-type</code> for new connection targets. The header mapping led to irritating
+results, when payload mapping and header mapping disagreed on the actual <code class="highlighter-rouge">content-type</code>. Existing connections will still
+keep the “old” default and map the <code class="highlighter-rouge">content-type</code> header.</p>
+
+<p>If you need to keep the old behavior, please have a look at the
+<a href="#content-type-header-mapping-in-connection-targets">migration notes</a>.</p>
+
+<h4 id="openid-connect-configuration-change">OpenID Connect configuration change</h4>
+
+<p>For supporting <a href="https://github.com/eclipse/ditto/issues/512">Configurable OpenID Connect / OAuth2.0 claim extraction</a>,
+the configuration format was changed, please have a look at the<br />
+<a href="#openid-connect-configuration-for-gateway">migration notes</a>.</p>
+
+<h4 id="removal-of-header-x-ditto-dummy-auth">Removal of header <code class="highlighter-rouge">x-ditto-dummy-auth</code></h4>
+
+<p>The HTTP header / query param <code class="highlighter-rouge">x-ditto-dummy-auth</code> which was already an alias for the
+<a href="installation-operating.html#pre-authentication">pre-authentication provider</a> header <code class="highlighter-rouge">x-ditto-pre-authenticated</code> has
+been removed from Ditto 2.0.<br />
+Please use the header <code class="highlighter-rouge">x-ditto-pre-authenticated</code> instead.</p>
+
+<h4 id="removed-default-source-header-mapping-for-mqtt-connections">Removed default source header mapping for MQTT connections</h4>
+
+<p>The default source header mapping of MQTT connections was removed. The headers <code class="highlighter-rouge">mqtt.topic</code>, <code class="highlighter-rouge">mqtt.qos</code>
+and <code class="highlighter-rouge">mqtt.retain</code> now must explicitly be added to the source header mapping if they are required for further processing.</p>
+
+<h4 id="restructuring-of-dittos-maven-modules">Restructuring of Ditto’s Maven modules</h4>
+
+<p>Ditto’s modules were adjusted to be structured in a more functional way. In Ditto 1.x the modules were structured
+in a more technical way.</p>
+
+<p>This table shows the old modules and in which module the old ones can be found in Ditto 2.0.0:</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Ditto 1.x module</th>
+ <th>Ditto 2.x module</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><code class="highlighter-rouge">ditto-model</code></td>
+ <td><code class="highlighter-rouge">-</code> (was pom only)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-base</code></td>
+ <td><code class="highlighter-rouge">ditto-base/ditto-base-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-cleanup</code></td>
+ <td><code class="highlighter-rouge">-</code> (was internal API)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-connectivity</code></td>
+ <td><code class="highlighter-rouge">ditto-connectivity/ditto-connectivity-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-devops</code></td>
+ <td><code class="highlighter-rouge">ditto-devops/ditto-devops-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-enforcers</code></td>
+ <td><code class="highlighter-rouge">ditto-policies/ditto-policies-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-jwt</code></td>
+ <td><code class="highlighter-rouge">ditto-jwt/ditto-jwt-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-messages</code></td>
+ <td><code class="highlighter-rouge">ditto-messages/ditto-messages-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-namespaces</code></td>
+ <td><code class="highlighter-rouge">ditto-base/ditto-base-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-policies</code></td>
+ <td><code class="highlighter-rouge">ditto-policies/ditto-policies-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-query</code></td>
+ <td><code class="highlighter-rouge">ditto-rql/ditto-rql-query</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-rql</code></td>
+ <td><code class="highlighter-rouge">ditto-rql/ditto-rql-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-rql-parser</code></td>
+ <td><code class="highlighter-rouge">ditto-rql/ditto-rql-parser</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-things</code></td>
+ <td><code class="highlighter-rouge">ditto-things/ditto-things-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-thingsearch</code></td>
+ <td><code class="highlighter-rouge">ditto-thingsearch/ditto-thingsearch-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-model-thingsearch-parser</code></td>
+ <td><code class="highlighter-rouge">ditto-rql/ditto-rql-parser</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">ditto-protocol-adapter</code></td>
+ <td><code class="highlighter-rouge">ditto-protocol</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">ditto-signals</code></td>
+ <td><code class="highlighter-rouge">-</code> (was pom only)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-signals-base</code></td>
+ <td><code class="highlighter-rouge">ditto-base/ditto-base-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-signals-acks</code></td>
+ <td><code class="highlighter-rouge">-</code> (was pom only)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-acks-base</code></td>
+ <td><code class="highlighter-rouge">ditto-base/ditto-base-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-acks-things</code></td>
+ <td><code class="highlighter-rouge">ditto-things/ditto-things-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-signals-announcements</code></td>
+ <td><code class="highlighter-rouge">-</code> (was pom only)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-announcements-base</code></td>
+ <td><code class="highlighter-rouge">ditto-base/ditto-base-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-announcements-policies</code></td>
+ <td><code class="highlighter-rouge">ditto-policies/ditto-policies-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-signals-commands</code></td>
+ <td><code class="highlighter-rouge">-</code> (was pom only)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-commands-base</code></td>
+ <td><code class="highlighter-rouge">ditto-base/ditto-base-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-commands-cleanup</code></td>
+ <td><code class="highlighter-rouge">-</code> (was internal API)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-commands-common</code></td>
+ <td><code class="highlighter-rouge">-</code> (was internal API)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-commands-connectivity</code></td>
+ <td><code class="highlighter-rouge">ditto-connectivity/ditto-connectivity-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-commands-devops</code></td>
+ <td><code class="highlighter-rouge">-</code> (was internal API and is merged into ditto-base/ditto-base-api)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-commands-messages</code></td>
+ <td><code class="highlighter-rouge">ditto-messages/ditto-messages-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-commands-namespaces</code></td>
+ <td><code class="highlighter-rouge">ditto-base/ditto-base-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-commands-policies</code></td>
+ <td><code class="highlighter-rouge">ditto-policies/ditto-policies-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-commands-things</code></td>
+ <td><code class="highlighter-rouge">ditto-things/ditto-things-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-commands-thingsearch</code></td>
+ <td><code class="highlighter-rouge">ditto-thingsearch/ditto-thingsearch-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">- ditto-signals-events</code></td>
+ <td><code class="highlighter-rouge">-</code> (was pom only)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-events-base</code></td>
+ <td><code class="highlighter-rouge">ditto-base/ditto-base-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-events-connectivity</code></td>
+ <td><code class="highlighter-rouge">ditto-connectivity/ditto-connectivity-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-events-policies</code></td>
+ <td><code class="highlighter-rouge">ditto-policies/ditto-policies-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-events-things</code></td>
+ <td><code class="highlighter-rouge">ditto-things/ditto-things-model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">-- ditto-signals-events-thingsearch</code></td>
+ <td><code class="highlighter-rouge">ditto-thingsearch/ditto-thingsearch-model</code></td>
+ </tr>
+ </tbody>
+</table>
+
+<h4 id="restructuring-of-dittos-java-packages">Restructuring of Ditto’s Java packages</h4>
+
+<p>When updating from Ditto 1.x Java APIs (e.g. also when using the <a href="#ditto-java-client">Ditto Java client</a>), the following
+packages were renamed:</p>
+
+<table>
+ <thead>
+ <tr>
+ <th>Ditto 1.x package</th>
+ <th>Ditto 2.x package</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.base</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.base.model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.cleanup</code></td>
+ <td><code class="highlighter-rouge">-</code> (was internal API)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.connectivity</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.connectivity.model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.devops</code></td>
+ <td><code class="highlighter-rouge">-</code> (was internal API and is merged into ditto-base/ditto-base-api)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.enforcers</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.policies.model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.jwt</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.jwt.model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.messages</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.messages.model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.namespaces</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.base.model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.policies</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.policies.model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.query</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.rql.query</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.rql</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.rql.model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.rqlparser</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.rql.parser</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.things</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.things.model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.thingsearch</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.thingsearch.model</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.thingsearchparser</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.rql.parser.thingsearch</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.model.protocoladapter</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.protocol</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.base</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.base.model.signals</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.acks.base</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.base.model.signals.acks</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.acks.things</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.things.model.signals.acks</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.announcements.base</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.base.model.signals.announcements</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.announcements.policies</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.policies.model.signals.announcements</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.commands.base</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.base.model.signals.commands</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.commands.cleanup</code></td>
+ <td><code class="highlighter-rouge">-</code> (was internal API)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.commands.common</code></td>
+ <td><code class="highlighter-rouge">-</code> (was internal API)</td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.commands.connectivity</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.connectivity.model.signals.commands</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.commands.devops</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.devops.model.signals.commands</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.commands.messages</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.messages.model.signals.commands</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.commands.namespaces</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.base.model.signals.commands</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.commands.policies</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.policies.model.signals.commands</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.commands.things</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.things.model.signals.commands</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.commands.thingsearch</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.thingsearch.model.signals.commands</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.events.base</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.base.model.signals.events</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.events.connectivity</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.connectivity.model.signals.events</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.events.policies</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.policies.model.signals.events</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.events.things</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.things.model.signals.events</code></td>
+ </tr>
+ <tr>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.signals.events.thingsearch</code></td>
+ <td><code class="highlighter-rouge">org.eclipse.ditto.thingsearch.model.signals.events</code></td>
+ </tr>
+ </tbody>
+</table>
+
+<h4 id="ditto-java-client">Ditto Java client</h4>
+
+<p>New Java client instances are instantiated differently, please have a look at the<br />
+<a href="#ditto-java-client-instantiation">migration notes</a>.</p>
+
+<p>In addition, all APIs which returned a <code class="highlighter-rouge">CompletableFuture</code> were adjusted to return a <code class="highlighter-rouge">CompletionStage</code> instead,
+please have a look at the<br />
+<a href="#ditto-java-client-completionstage-apis">migration notes</a>.</p>
+
+<h4 id="ditto-javascript-client">Ditto JavaScript client</h4>
+
+<p>Starting with Ditto 2.0.0, the releases of the <a href="https://github.com/eclipse/ditto-clients/tree/master/javascript">Ditto JavaScript client</a>
+are in sync with Ditto releases.<br />
+In oder to have a simplified usage of the JS client, the “api” module must no longer be explicitly imported,
+simply directly import one of the following 2 npm modules:</p>
+<ul>
+ <li><a href="https://www.npmjs.com/package/@eclipse-ditto/ditto-javascript-client-node">ditto-javascript-client-node</a></li>
+ <li><a href="https://www.npmjs.com/package/@eclipse-ditto/ditto-javascript-client-dom">ditto-javascript-client-dom</a></li>
+</ul>
+
+<h3 id="new-features">New features</h3>
+
+<h4 id="mergepatch-updates-of-digital-twins"><a href="https://github.com/eclipse/ditto/issues/288">Merge/PATCH updates of digital twins</a></h4>
+
+<p>This new feature allows updating parts of a thing without affecting existing parts. You may now for example update an
+attribute, add a new property to a feature and delete a property of a different feature in a <em>single request</em>. The new
+merge functionality is available via the HTTP API and the all channels using the Ditto Protocol. See
+<a href="httpapi-concepts.html#merge-updates">Merge updates via HTTP</a>
+or the <a href="protocol-specification-things-merge.html">Merge protocol specification</a> for more details and examples.</p>
+
+<h4 id="configurable-openid-connect--oauth20-claim-extraction"><a href="https://github.com/eclipse/ditto/issues/512">Configurable OpenID Connect / OAuth2.0 claim extraction</a></h4>
+
+<p>OpenID Connect support has been extended; Previously, only the <code class="highlighter-rouge">sub</code> field from a JWT was injected as an authorization subject.
+This is now configurable: The Ditto Gateway config takes a list of placeholder strings that are used to construct authorization subjects.<br />
+See <a href="installation-operating.html#openid-connect">OpenID Connect</a></p>
+
+<h4 id="establishing-connections-to-endpoints-via-ssh-tunnel"><a href="https://github.com/eclipse/ditto/issues/985">Establishing connections to endpoints via SSH tunnel</a></h4>
+
+<p>Add support for connecting to an external system from Ditto via an SSH tunnel.</p>
+
+<h4 id="devops-api-to-retrieve-all-known-connections"><a href="https://github.com/eclipse/ditto/issues/605">DevOps API to retrieve all known connections</a></h4>
+
+<p>Adds a new <a href="connectivity-manage-connections.html#retrieve-ids-of-all-connections">DevOps command</a> to list all
+configured, non-deleted connections.</p>
+
+<h4 id="expiring-policy-subjects"><a href="https://github.com/eclipse/ditto/issues/890">Expiring policy subjects</a></h4>
+
+<p>In order to give access for a certain “authorized subject” only until a fixed timestamp, a Policy subject can
+optionally be provided with an <a href="basic-policy.html#expiring-policy-subjects">“expiry” timestamp</a>
+(being an ISO-8601 string).</p>
+
+<h4 id="publishing-of-announcement-message-prior-to-policy-expiry"><a href="https://github.com/eclipse/ditto/issues/964">Publishing of announcement message prior to policy expiry</a></h4>
+
+<p>For “expiring” policy subjects it is useful to get an <a href="basic-signals-announcement.html">announcement</a> message prior
+to the actual expiry in order to be able to prolong the temporary access rights.</p>
+
+<h4 id="addition-of-policy-actions-in-order-to-inject-a-policy-subject"><a href="https://github.com/eclipse/ditto/issues/926">Addition of policy actions in order to inject a policy subject</a></h4>
+
+<p>New <a href="basic-policy.html#action-activatetokenintegration">policy HTTP API</a> to inject authorization subjects based on
+the <a href="#" data-toggle="tooltip" data-original-title="JSON Web Token (JWT)">JWT</a> of the HTTP request.</p>
+
+<h4 id="built-in-acknowledgement-for-search-updates--strong-consistency-of-the-search-index"><a href="https://github.com/eclipse/ditto/issues/914">Built-in acknowledgement for search updates / strong consistency of the search index</a></h4>
+
+<p>Ditto’s search index is only eventually consistent. Applications that rely on search to for twin interactions which
+need to know when a change is reflected in the search index, may request the new built-in
+<a href="basic-acknowledgements.html#built-in-acknowledgement-labels"><code class="highlighter-rouge">"search-persisted"</code></a> acknowledgement label.</p>
+
+<h4 id="restoring-active-connection-faster-after-a-hard-restart-of-the-ditto-cluster"><a href="https://github.com/eclipse/ditto/pull/1018">Restoring active connection faster after a hard restart of the Ditto cluster</a></h4>
+
+<p>Prioritize very active <a href="basic-connections.html">connections</a> over inactive connections for reconnecting:<br />
+The higher the priority, the earlier it will be reconnected on startup.</p>
+
+<h4 id="support-for-last-will-for-mqtt-connections"><a href="https://github.com/eclipse/ditto/issues/1021">Support for “Last Will” for MQTT connections</a></h4>
+
+<p>Adds “Last Will” support for managed MQTT connections</p>
+
+<h4 id="allow-setting-retain-flag-for-mqtt-connections"><a href="https://github.com/eclipse/ditto/issues/1029">Allow setting retain flag for MQTT connections</a></h4>
+
+<p>The <code class="highlighter-rouge">retain</code> flag of MQTT messages published via a managed connection is set according to a message header.</p>
+
+<h4 id="provide-jwt-tokens-to-websocket-endpoint-with-browser-apis"><a href="https://github.com/eclipse/ditto/issues/667">Provide JWT tokens to Websocket endpoint with browser APIs</a></h4>
+
+<p>Prior to Ditto 2.0 it was only possible to pass a JWT to the <code class="highlighter-rouge">/ws</code> endpoint with the <code class="highlighter-rouge">Authorization</code> header.<br />
+As this however is not possible to influence in the browser based JavaScript API of <code class="highlighter-rouge">WebSocket</code>, it was not possible
+to authenticate easily running a web application connecting against Ditto.</p>
+
+<p>This is now possible by supplying the JWT via a <a href="basic-auth.html#single-sign-on-sso">query-parameter <code class="highlighter-rouge">access_token</code></a>.</p>
+
+<h3 id="bugfixes">Bugfixes</h3>
+
+<p>Several bugs in Ditto 1.5.x were fixed for 2.0.0.<br />
+This is a complete list of the</p>
+<ul>
+ <li><a href="https://github.com/eclipse/ditto/pulls?q=is:pr+milestone:2.0.0-M1">merged pull requests for milestone 2.0.0-M1</a></li>
+ <li><a href="https://github.com/eclipse/ditto/pulls?q=is:pr+milestone:2.0.0-M2">merged pull requests for milestone 2.0.0-M2</a></li>
+ <li><a href="https://github.com/eclipse/ditto/pulls?q=is:pr+milestone:2.0.0">merged pull requests for milestone 2.0.0</a></li>
+</ul>
+
+<p>Here as well for the Ditto Java Client: <a href="https://github.com/eclipse/ditto-clients/pulls?q=is:pr+milestone:2.0.0">merged pull requests for milestone 2.0.0</a></p>
+
+<h4 id="content-type-of-a-ditto-protocol-json-message-did-not-describe-its-value"><a href="https://github.com/eclipse/ditto/pull/987">“content-type” of a Ditto Protocol JSON message did not describe its “value”</a></h4>
+
+<p>The <code class="highlighter-rouge">"content-type"</code> field in <a href="protocol-specification.html#headers">Ditto Protocol headers</a> was intended to identify the
+type of the <a href="protocol-specification.html#value"><code class="highlighter-rouge">"value"</code></a>. This was not consequently ensured which has now been fixed.</p>
+
+<h4 id="password-encodingdecoding-for-amqp-10-connections-with-special-characters"><a href="https://github.com/eclipse/ditto/pull/996">Password encoding/decoding for AMQP 1.0 connections with special characters</a></h4>
+
+<p>When passwords contained a <code class="highlighter-rouge">+</code> sign, they were wrongly decoded for
+<a href="connectivity-protocol-bindings-amqp10.html">AMQP 1.0 connections</a>.</p>
+
+<h4 id="merging-extrafields-into-thing-payload-when-using-normalization-mapper"><a href="https://github.com/eclipse/ditto/issues/947">Merging “extraFields” into thing payload when using “normalization” mapper</a></h4>
+
+<p>When selecting <a href="basic-connections.html#target-topics-and-enrichment">extra</a> via “enrichment”, the actual value of an
+event could be overwritten by the “extra” data. The event data now always has priority.</p>
+
+<h2 id="migration-notes">Migration notes</h2>
+
+<h3 id="migrate-api-1-things-to-api-2">Migrate API 1 things to API 2</h3>
+
+<p>In order to migrate existing <a href="basic-thing.html">things</a> from API version 1 to API version 2
+(from having a <code class="highlighter-rouge">acl</code> to having a <code class="highlighter-rouge">policyId</code>) simply perform the following steps <strong>prior to updating to Ditto 2.0.0</strong>:</p>
+<ul>
+ <li>Retrieve the to-be-migrated thing <strong>via API 1</strong> <code class="highlighter-rouge">GET /api/1/things/<the-namespace>:<the-name></code></li>
+ <li>Save the content of the <code class="highlighter-rouge">"acl"</code> field in the returned Thing JSON</li>
+ <li>Create a new <a href="basic-policy.html">policy</a> based on the retrieved ACL content
+ <ul>
+ <li>tip: when creating the policy, use the same ID as for the thing</li>
+ <li>for the policy <a href="basic-policy.html#subjects">subject</a>, use the map “keys” of the ACL JSON object, prepending the
+required <code class="highlighter-rouge"><subject-issuer></code> prefix</li>
+ <li>choose the permissions in the <a href="basic-policy.html#which-resources-can-be-controlled">resources</a> according to your
+needs</li>
+ </ul>
+ </li>
+ <li>Update the thing <strong>via API 2</strong> <code class="highlighter-rouge">PUT /api/2/things/<the-namespace>:<the-name></code> and set the <code class="highlighter-rouge">"policyId"</code> to the just
+created policy id</li>
+ <li>You can now only access the thing via API 2</li>
+ <li>After all API 1 things were migrated, you can safely update to Ditto 2.0.0</li>
+</ul>
+
+<h3 id="content-type-header-mapping-in-connection-targets">“content-type” header mapping in connection targets</h3>
+
+<p>Due to the
+<a href="https://github.com/eclipse/ditto/pull/934">removed default content-type header mapping for connection targets</a>,
+it might be necessary to update the way connection targets are created in case you create connection targets without
+explicit <code class="highlighter-rouge">headerMapping</code> and rely on a specific content-type on the receiving side. The request to create connection
+targets can be updated to contain the “old” default 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">"targetActorSelection"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/system/sharding/connection"</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="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">"connectivity.commands:createConnection"</span><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">"targets"</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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{header:correlation-id}}"</span><span class="p">,</span><span class="w">
+ </span><span class="s2">"reply-to"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{header:reply-to}}"</span><span class="w">
+ </span><span class="p">},</span><span class="w">
+ </span><span class="err">//</span><span class="w"> </span><span class="err">...</span><span class="w">
+ </span><span class="p">}]</span><span class="w">
+ </span><span class="err">//</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><span class="p">}</span><span class="w">
+</span></code></pre></div></div>
+
+<h3 id="openid-connect-configuration-for-gateway">OpenID Connect configuration for gateway</h3>
+
+<p>The oauth configuration section of the Gateway service has been altered to support
+<a href="https://github.com/eclipse/ditto/issues/512">arbitrary claims for authorization subjects</a>.
+The <code class="highlighter-rouge">openid-connect-issuers</code> map now takes key-object pairs rather than key-string pairs:</p>
+
+<p>old:</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>oauth = {
+ openid-connect-issuers = {
+ someissuer = "https://example.com"
+ }
+}
+</code></pre></div></div>
+
+<p>new:</p>
+
+<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>oauth = {
+ openid-connect-issuers = {
+ someissuer = {
+ issuer = "https://example.com"
+ }
+ }
+}
+</code></pre></div></div>
+
+<p>The <code class="highlighter-rouge">auth-subjects</code> field is optional. When not supplied, the ‘old’ behaviour (using the JWT <code class="highlighter-rouge">sub</code> field) remains.</p>
+
+<h3 id="header-mapping-for-mqtt-connections">Header mapping for MQTT connections</h3>
+
+<p>Prior to this release, <a href="connectivity-protocol-bindings-mqtt.html">MQTT 3.1.1</a> and
+<a href="connectivity-protocol-bindings-mqtt5.html">MQTT 5</a> always contained 3 headers for consumed messages via
+<a href="basic-connections.html#sources">connection sources</a> (subscribed MQTT topics):</p>
+<ul>
+ <li><code class="highlighter-rouge">mqtt.topic</code></li>
+ <li><code class="highlighter-rouge">mqtt.qos</code></li>
+ <li><code class="highlighter-rouge">mqtt.retain</code></li>
+</ul>
+
+<p>Those headers could be e.g. used in the
+<a href="connectivity-mapping.html#javascript-mapping-engine">JavaScript payload mapping engine</a> in order to find out on
+which topic a consumed MQTT message was received.</p>
+
+<p>These headers are not longer implicitly mapped, but instead have to be mapped via
+<a href="connectivity-header-mapping.html">header mapping</a> manually.</p>
+
+<p>An example <a href="connectivity-protocol-bindings-mqtt.html#source-header-mapping">source header mapping</a> is provided
+in the documentation.</p>
+
+<h3 id="ditto-java-client-instantiation">Ditto Java Client instantiation</h3>
+
+<p>The synchronous instantiation of the Ditto Java Client has been removed from its Factory class <code class="highlighter-rouge">DittoClients</code>.
+To get a <code class="highlighter-rouge">DittoClient</code> instantiate a <code class="highlighter-rouge">DisconnectedDittoClient</code> via <code class="highlighter-rouge">DittoClients.newInstance(messagingProvider)</code> first
+and call <code class="highlighter-rouge">connect()</code> on it.<br />
+This call returns a <code class="highlighter-rouge">CompletionStage</code> which finally resolves to a connected <code class="highlighter-rouge">DittoClient</code>.</p>
+
+<h2 id="roadmap">Roadmap</h2>
+
+<p>Looking forward, the current plans for Ditto 2.1.0 are:</p>
+
+<ul>
+ <li><a href="https://github.com/eclipse/ditto/issues/586">Support for consuming messages from Apache Kafka</a></li>
+ <li><a href="https://github.com/eclipse/ditto/issues/298">Let policies import other policies to enable re-use when securing things</a></li>
+</ul>
+
+
+ <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">
+ ©2021 Eclipse Ditto™.
+ Site last generated: May 6, 2021 <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/release_notes_next.html b/release_notes_next.html
deleted file mode 100644
index e3a74ad..0000000
--- a/release_notes_next.html
+++ /dev/null
@@ -1,1875 +0,0 @@
-<!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 x.x.x of Eclipse Ditto, released on dd.MM.yyyy">
-<meta name="keywords" content="release_notes, release notes, announcements, changelog">
-<title> Release notes x.x.x • 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="Eclipse 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="sandbox.html">Sandbox</a></li>
-
-
-
-
- <li><a href="https://github.com/eclipse/ditto" target="_blank">
- <img src="images/GitHub-Mark-Light-32px.png" alt="Sources at GitHub">
- </a></li>
-
-
-
-
-
- <li><a href="https://github.com/eclipse/ditto-clients" target="_blank">
- <img src="images/GitHub-Mark-Light-32px.png" alt="SDK sources at GitHub">SDKs
- </a></li>
-
-
-
-
-
- <li><a href="https://github.com/eclipse/ditto-examples" target="_blank">
- <img src="images/GitHub-Mark-Light-32px.png" alt="Example sources at 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 x.x.x">{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>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
-
- <option value="1.4">1.4</option>
-
- <option value="1.5">1.5</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_151.html">1.5.1</a></li>
-
-
-
-
-
-
- <li><a href="release_notes_150.html">1.5.0</a></li>
-
-
-
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
- <li class="subfolders">
- <a href="#"><span></span>Archive</a>
- <ul>
-
-
-
- <li><a href="release_notes_130.html">1.3.0</a></li>
-
-
-
-
-
- <li><a href="release_notes_121.html">1.2.1</a></li>
-
-
-
-
-
- <li><a href="release_notes_120.html">1.2.0</a></li>
-
-
-
-
-
- <li><a href="release_notes_115.html">1.1.5</a></li>
-
-
-
-
-
- <li><a href="release_notes_113.html">1.1.3</a></li>
-
-
-
-
-
- <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>
-
-
-
-
-
- <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><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>
-
-
-
-
-
- <li><a href="basic-metadata.html">Thing Metadata</a></li>
-
-
-
-
-
- <li><a href="basic-errors.html">Errors</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>
-
-
-
-
-
- <li><a href="basic-signals-announcement.html">Announcement</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 / QoS</a></li>
-
-
-
-
- </ul>
- </li>
-
-
-
-
-
- <li class="subfolders">
- <a href="#"><span></span>Advanced concepts</a>
- <ul>
-
-
-
- <li><a href="advanced-data-by-pass.html">Data By-Pass</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-protocol-bindings-cloudevents.html">Cloud Events HTTP 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>
-
-
-
-
-
-
- <li><a href="connectivity-ssh-tunneling.html">SSH tunneling</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-merge.html">Merge</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>
-
-
-
-
-
- <li><a href="protocol-specification-errors.html">Errors</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>
-
-
-
-
-
- <li><a href="protocol-specification-policies-announcement.html">Announcement</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-createdesiredproperties.html">Create desired Feature Properties</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-deletedesiredproperties.html">Delete desired Feature Properties</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-modifydesiredproperties.html">Modify desired Feature Properties</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-retrievedesiredproperties.html">Retrieve desired Feature Properties</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-createdesiredproperty.html">Create a single desired Property</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-deletedesiredproperty.html">Delete a single desired Property</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-modifydesiredproperty.html">Modify a single desired Property</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-retrievedesiredproperty.html">Retrieve a single desired Property</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-errorresponses.html">Error responses</a></li>
-
-
-
- </ul>
- </li>
-
-
-
- <li class="subfolders">
- <a href="#"><span></span>→ Things merge examples</a>
- <ul>
-
-
-
- <li><a href="protocol-examples-mergething.html">Merge a Thing</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-mergepolicyid.html">Merge the Policy ID of a Thing</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-mergeattributes.html">Merge Attributes</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-mergeattribute.html">Merge a single Attribute</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-mergethingdefinition.html">Merge a Definition</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-mergefeatures.html">Merge Features</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-mergefeature.html">Merge a single Feature</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-mergefeaturedefinition.html">Merge Feature Definition</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-mergeproperties.html">Merge Feature Properties</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-mergeproperty.html">Merge a single Property</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-mergedesiredproperties.html">Merge desired Feature Properties</a></li>
-
-
-
-
-
- <li><a href="protocol-examples-mergedesiredproperty.html">Merge a single desired 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>
-
-
-
-
-
- <li><a href="protocol-examples-policies-announcement-subjectDeletion.html">Announcement for subject deletion</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");
-</script>
-
- </div>
-
-
-
- <!-- Content Column -->
- <div class="col-md-9" id="tg-sb-content">
- <div class="post-header">
- <h1 class="post-title-main">Release notes x.x.x</h1>
-</div>
-
-
-
-<div class="post-content">
-
-
- <div class="summary">Version x.x.x of Eclipse Ditto, released on dd.MM.yyyy</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>
-
-
-
-
-
-
-
-
-
- <h2 id="changelog">Changelog</h2>
-
-<h3 id="changes">Changes</h3>
-
-<h4 id="removed-content-type-header-mapping-for-connection-targets"><a href="https://github.com/eclipse/ditto/pull/934">Removed content-type header mapping for connection targets</a></h4>
-
-<p>Removed the default header mapping of <code class="highlighter-rouge">content-type</code> for new connection targets. The header mapping led to irritating
-results, when payload mapping and header mapping disagreed on the actual <code class="highlighter-rouge">content-type</code>. Existing connections will still
-keep the “old” default and map the <code class="highlighter-rouge">content-type</code> header.</p>
-
-<h3 id="new-features">New features</h3>
-
-<h4 id="merge-updates"><a href="https://github.com/eclipse/ditto/issues/288">Merge updates</a></h4>
-
-<p>This new feature allows updating parts of a thing without affecting existing parts. You may now for example update an
-attribute, add a new property to a feature and delete a property of a different feature in a <em>single request</em>. The new
-merge functionality is available via the HTTP API and the all channels using the Ditto Protocol. See
-<a href="httpapi-concepts.html#merge-updates">Merge updates via HTTP</a>
-or the <a href="protocol-specification-things-merge.html">Merge protocol specification</a> for more details and examples.</p>
-
-<h4 id="oidc-added-support-for-arbitrary-claims-for-authorization-subjects"><a href="https://github.com/eclipse/ditto/issues/512">OIDC: Added support for arbitrary claims for authorization subjects</a></h4>
-
-<p>OpenID Connect support has been extended; Previously, only the <code class="highlighter-rouge">sub</code> field from a JWT was injected as an authorization subject.
-This is now configurable: The Ditto Gateway config takes a list of placeholder strings that are used to construct authorization subjects.
-See <a href="installation-operating.html#openid-connect">OpenID Connect</a></p>
-
-<h3 id="bugfixes">Bugfixes</h3>
-
-<h2 id="migration-notes">Migration notes</h2>
-
-<h3 id="content-type-header-mapping-in-connection-targets">content-type header mapping in connection targets</h3>
-
-<p>Due to
-the <a href="https://github.com/eclipse/ditto/pull/934">removed default content-type header mapping for connection targets</a>, it
-might be necessary to update the way connection targets are created in case you create connection targets without
-explicit
-<code class="highlighter-rouge">headerMapping</code> and rely on a specific content-type on the receiving side. The request to create connection targets
-can be updated to contain the “old” default 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">"targetActorSelection"</span><span class="p">:</span><span class="w"> </span><span class="s2">"/system/sharding/connection"</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="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">"connectivity.commands:createConnection"</span><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">"targets"</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">"correlation-id"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{header:correlation-id}}"</span><span class="p">,</span><span class="w">
- </span><span class="s2">"reply-to"</span><span class="p">:</span><span class="w"> </span><span class="s2">"{{header:reply-to}}"</span><span class="w">
- </span><span class="p">},</span><span class="w">
- </span><span class="err">//</span><span class="w"> </span><span class="err">...</span><span class="w">
- </span><span class="p">}]</span><span class="w">
- </span><span class="err">//</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><span class="p">}</span><span class="w">
-</span></code></pre></div></div>
-
-<h3 id="openid-connect-configuration-for-gateway">OpenID Connect configuration for gateway</h3>
-
-<p>The oauth configuration section of the Gateway service has been altered to support
-<a href="https://github.com/eclipse/ditto/issues/512">arbitrary claims for authorization subjects</a>. The <code class="highlighter-rouge">openid-connect-issuers</code> map now takes
-key-object pairs rather than key-string pairs:</p>
-
-<p>old:</p>
-
-<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>oauth = {
- openid-connect-issuers = {
- someissuer = "https://example.com"
- }
-}
-</code></pre></div></div>
-
-<p>new:</p>
-
-<div class="highlighter-rouge"><div class="highlight"><pre class="highlight"><code>
-oauth = {
- openid-connect-issuers = {
- someissuer = {
- issuer = "https://example.com"
- }
- }
-}
-
-</code></pre></div></div>
-
-<p>The <code class="highlighter-rouge">auth-subjects</code> field is optional. When not supplied, the ‘old’ behaviour (using the JWT <code class="highlighter-rouge">sub</code> field) remains.</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">
- ©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <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 ef55150..28dd7f7 100644
--- a/sandbox.html
+++ b/sandbox.html
@@ -218,17 +218,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -278,6 +280,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -289,19 +298,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -505,12 +513,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -970,6 +972,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1008,12 +1017,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1721,8 +1724,8 @@
- <p>The Ditto team provides a <a href="https://ditto.eclipseprojects.io">sandbox</a> which may be used by everyone wanting to try out Ditto
-without starting it locally.</p>
+ <p>The Ditto team provides a <a href="https://ditto.eclipseprojects.io">sandbox</a> which may be used by everyone wanting to
+try out Ditto without starting it locally.</p>
<div class="alert alert-danger" role="alert"><i class="fa fa-exclamation-circle"></i> <b>Warning:</b> The Ditto sandbox is not set up in a highly available manner and may experience
downtimes. Also, the sandbox will be reset from time to time without prior notice.</div>
@@ -1740,10 +1743,10 @@
<h3 id="http-api-documentation">HTTP API documentation</h3>
-<p>The online <a href="https://ditto.eclipseprojects.io/apidoc/">HTTP API documentation</a> of the sandbox implements the OAuth2.0 “authorization code”
-flow.<br />
-Simply click the green <code class="highlighter-rouge">Authorize</code> button, check the checkbox <code class="highlighter-rouge">openid</code> and click the <code class="highlighter-rouge">Authorize</code> button. Your browser will
-ask you if the Ditto sandbox may access your Google identity which you should acknowledge.<br />
+<p>The online <a href="https://ditto.eclipseprojects.io/apidoc/">HTTP API documentation</a> of the sandbox implements the OAuth2.0
+“authorization code” flow.<br />
+Simply click the green <code class="highlighter-rouge">Authorize</code> button, check the checkbox <code class="highlighter-rouge">openid</code> and click the <code class="highlighter-rouge">Authorize</code> button.
+Your browser will ask you if the Ditto sandbox may access your Google identity which you should acknowledge.<br />
Afterwards you should be authenticated with your Google user (and therefore your Google ID).</p>
<p>You can try out the API now. For example, expand the <a href="https://ditto.eclipseprojects.io/apidoc/#!/Things/put_things_thingId">PUT /things/{thingId}</a>
@@ -1783,11 +1786,11 @@
</span><span class="p">}</span><span class="w">
</span></code></pre></div></div>
-<h3 id="programatically-access-the-http-api">Programatically access the HTTP API</h3>
+<h3 id="programmatically-access-the-http-api">Programmatically access the HTTP API</h3>
-<p>If you want to programatically (e.g. in a script running on a RaspberryPi) access the sandbox, we currently have to disappoint
-you. As there is no possibility to obtain a Google JWT with plain username/password and we currently have no other authentication
-provider configured in the sandbox, we have no possibility to authenticate a script.</p>
+<p>If you want to programmatically (e.g. in a script running on a RaspberryPi) access the sandbox, we currently have
+to disappoint you. As there is no possibility to obtain a Google JWT with plain username/password and we currently
+have no other authentication provider configured in the sandbox, we have no possibility to authenticate a script.</p>
<div class="tags">
@@ -1806,7 +1809,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 3c32e84..a51f34e 100644
--- a/search.json
+++ b/search.json
@@ -103,17 +103,6 @@
{
-"title": "Access control list (ACL) - Deprecated",
-"tags": "model",
-"keywords": "authentication, authorization, auth, acl, access control",
-"url": "basic-acl.html",
-"summary": ""
-}
-,
-
-
-
-{
"title": "APIs",
"tags": "model",
"keywords": "API, HTTP, HTTPS, JWT, REST, websocket, WSS",
@@ -1417,11 +1406,11 @@
{
-"title": "Release notes x.x.x",
+"title": "Release notes 2.0.0",
"tags": "release_notes",
"keywords": "release notes, announcements, changelog",
-"url": "release_notes_next.html",
-"summary": "Version x.x.x of Eclipse Ditto, released on dd.MM.yyyy"
+"url": "release_notes_200.html",
+"summary": "Version 2.0.0 of Eclipse Ditto, released on 06.05.2021"
}
,
@@ -1488,6 +1477,16 @@
{
+"title": "Announcing Eclipse Ditto Release 2.0.0",
+"tags": "blog",
+"keywords": "",
+"url": "2021-05-06-release-announcement-200.html",
+"summary": ""
+}
+,
+
+
+{
"title": "Support SSH tunneling for managed connections",
"tags": "blogarchitectureconnectivity",
"keywords": "",
diff --git a/sitemap.xml b/sitemap.xml
index 865deb0..ad0de7f 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -3,6 +3,12 @@
<url>
+ <loc>https://www.eclipse.org/ditto/2021-05-06-release-announcement-200.html</loc>
+ </url>
+
+
+
+ <url>
<loc>https://www.eclipse.org/ditto/2021-03-31-ssh-tunneling-for-managed-connections.html</loc>
</url>
@@ -302,12 +308,6 @@
<url>
- <loc>https://www.eclipse.org/ditto/basic-acl.html</loc>
- </url>
-
-
-
- <url>
<loc>https://www.eclipse.org/ditto/basic-apis.html</loc>
</url>
@@ -1096,7 +1096,7 @@
<url>
- <loc>https://www.eclipse.org/ditto/release_notes_next.html</loc>
+ <loc>https://www.eclipse.org/ditto/release_notes_200.html</loc>
</url>
diff --git a/slides/2018_02_07-virtualiot-meetup/index.html b/slides/2018_02_07-virtualiot-meetup/index.html
index 8011cc4..3879ba0 100644
--- a/slides/2018_02_07-virtualiot-meetup/index.html
+++ b/slides/2018_02_07-virtualiot-meetup/index.html
@@ -283,7 +283,7 @@
</ul>
<br />
<br />
- <img src="../../images/pages/basic/ditto-class-diagram-v1.svg" alt="Ditto class diagram v1" class="fragment"/>
+ <img src="../../images/pages/basic/ditto-class-diagram-v2.png" alt="Ditto class diagram v2" class="fragment"/>
<a href="https://www.eclipse.org/ditto/basic-overview.html#domain-model">→ docs</a>
</section>
<section id="ditto-3" style="clear: both;">
diff --git a/tag_advanced.html b/tag_advanced.html
index 0706f72..9246e36 100644
--- a/tag_advanced.html
+++ b/tag_advanced.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1783,10 +1786,6 @@
-
-
-
-
@@ -2631,6 +2630,10 @@
+
+
+
+
</tbody>
</table>
@@ -2653,7 +2656,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
diff --git a/tag_architecture.html b/tag_architecture.html
index 64a1701..e8690a2 100644
--- a/tag_architecture.html
+++ b/tag_architecture.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1777,7 +1780,7 @@
<tr><td><a href="architecture-services-policies.html">Policies service</a></td>
<td><span class="label label-default">Page</span></td>
- <td> The “policies” service takes care of persisting Policies. Model The model of the policies service is defined around the entity Policy: model Signals Other services can communicate with the policies service via: commands: containing commands and command responses which are processed... </td>
+ <td> The “policies” service takes care of persisting Policies. Model The model of the policies service is defined around the entity Policy: Policy model Signals Other services can communicate with the policies service via: commands: containing commands and command responses which are... </td>
</tr>
@@ -1787,7 +1790,7 @@
<tr><td><a href="architecture-services-things-search.html">Things-Search service</a></td>
<td><span class="label label-default">Page</span></td>
- <td> The “things-search” service takes care of: updating an optimized search index of Things based on the events emitted by the things and policies services when entites are changed there executing search queries against the search index in order to find out which Things match... </td>
+ <td> The “things-search” service takes care of: updating an optimized search index of Things based on the events emitted by the things and policies services when entities are changed there executing search queries against the search index in order to find out which Things match... </td>
</tr>
@@ -1799,7 +1802,7 @@
<tr><td><a href="architecture-services-things.html">Things service</a></td>
<td><span class="label label-default">Page</span></td>
- <td> The “things” service takes care of persisting Things and Features. Model The model of the things service is defined around the entities Thing and Feature: model Signals Other services can communicate with the things service via: commands: containing commands... </td>
+ <td> The “things” service takes care of persisting Things and Features. Model The model of the things service is defined around the entities Thing and Feature: Thing model Signals Other services can communicate with the things service via: commands: containing... </td>
</tr>
@@ -1819,10 +1822,6 @@
-
-
-
-
@@ -2489,6 +2488,10 @@
+
+
+
+
<tr><td><a href="2021-03-31-ssh-tunneling-for-managed-connections.html">Support SSH tunneling for managed connections</a></td>
<td><span class="label label-primary">Post</span></td>
@@ -2701,7 +2704,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 39c0065..6edd651 100644
--- a/tag_blog.html
+++ b/tag_blog.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1777,10 +1780,6 @@
-
-
-
-
@@ -2446,6 +2445,16 @@
+ <tr><td><a href="2021-05-06-release-announcement-200.html">Announcing Eclipse Ditto Release 2.0.0</a></td>
+ <td><span class="label label-primary">Post</span></td>
+ <td> Today, ~1.5 years after release 1.0.0, the Eclipse Ditto team is happy to announce the availability of Eclipse Ditto 2.0.0. With the major version 2.0.0 the Ditto team removed technical debt and ended support for APIs which were deprecated long ago in order to have a better maintainable... </td>
+ </tr>
+
+
+
+
+
+
<tr><td><a href="2021-03-31-ssh-tunneling-for-managed-connections.html">Support SSH tunneling for managed connections</a></td>
<td><span class="label label-primary">Post</span></td>
<td> With the upcoming release of Eclipse Ditto version 2.0.0 it will be possible to SSH tunneling for managed connections With the upcoming release of Eclipse Ditto version 2.0.0, managed connections support establishing an SSH tunnel, which is then used to connect to the actual target endpoint. This is useful... </td>
@@ -2602,7 +2611,7 @@
<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>
+ <td> Today the Eclipse Ditto team 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... </td>
</tr>
@@ -2887,7 +2896,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 c7a91bb..c3d8fd4 100644
--- a/tag_client_sdk.html
+++ b/tag_client_sdk.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1777,10 +1780,6 @@
-
-
-
-
@@ -1897,7 +1896,7 @@
These SDKs make use of the Ditto Protocol to exchange messages with Eclipse Ditto.
-The following SDK are supported:
+The following SDKs are supported:
Java
@@ -2653,6 +2652,10 @@
+
+
+
+
</tbody>
</table>
@@ -2675,7 +2678,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 b0476c6..220912b 100644
--- a/tag_connectivity.html
+++ b/tag_connectivity.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1783,10 +1786,6 @@
-
-
-
-
@@ -2545,6 +2544,10 @@
+
+
+
+
<tr><td><a href="2021-03-31-ssh-tunneling-for-managed-connections.html">Support SSH tunneling for managed connections</a></td>
<td><span class="label label-primary">Post</span></td>
@@ -2779,7 +2782,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 9d30ec3..3f53882 100644
--- a/tag_getting_started.html
+++ b/tag_getting_started.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1777,10 +1780,6 @@
-
-
-
-
@@ -2059,7 +2058,7 @@
<tr><td><a href="intro-digitaltwins.html">Digital twins</a></td>
<td><span class="label label-default">Page</span></td>
- <td> TL;DRDigital twins are a pattern for simplifying IoT solution development. The problem with the term digital twin is that there are many different understandings of what it means. Furthermore the term was previously mostly used and coined by marketing. The term was/is missing a technical foundation of... </td>
+ <td> TL;DRDigital twins are a pattern for simplifying IoT solution development. The problem with the term digital twin is that there are many different understandings of what it means. Furthermore, the term was previously mostly used and coined by marketing. The term was/is missing a technical foundation of... </td>
</tr>
@@ -2675,6 +2674,10 @@
+
+
+
+
</tbody>
</table>
@@ -2697,7 +2700,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 c6157ab..5e373cc 100644
--- a/tag_http.html
+++ b/tag_http.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1777,10 +1780,6 @@
-
-
-
-
@@ -1967,7 +1966,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 deprecated API version 1 and API... </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 only provides API version 2. API version... </td>
</tr>
@@ -2505,6 +2504,10 @@
+
+
+
+
<tr><td><a href="2021-02-04-merge-feature.html">Support merge functionality for things resources</a></td>
<td><span class="label label-primary">Post</span></td>
@@ -2695,7 +2698,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 6ddb756..a0ecce3 100644
--- a/tag_installation.html
+++ b/tag_installation.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1777,10 +1780,6 @@
-
-
-
-
@@ -2643,6 +2642,10 @@
+
+
+
+
</tbody>
</table>
@@ -2665,7 +2668,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 2a33591..52f2aef 100644
--- a/tag_model.html
+++ b/tag_model.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1775,16 +1778,6 @@
- <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>
-
-
-
-
-
-
<tr><td><a href="basic-apis.html">APIs</a></td>
<td><span class="label label-default">Page</span></td>
<td> Ditto provides two ways to interact with: A REST-like HTTP API with a sophisticated resource layout that allows to create, read, update and delete Things and the Thing’s data. A JSON-based WebSocket API implementing the Ditto Protocol. HTTP API or WebSocket? The two ways... </td>
@@ -1797,7 +1790,7 @@
<tr><td><a href="basic-auth.html">Authentication and authorization</a></td>
<td><span class="label label-default">Page</span></td>
- <td> You can integrate your solutions with Ditto via the HTTP API or via WebSocket. On all APIs Ditto protects functionality and data by using Authentication to make sure the requester is the one she claims to be, Authorization to make sure the requester is allowed to... </td>
+ <td> You can integrate your solutions with Ditto via the HTTP API or via WebSocket. On all APIs Ditto protects functionality and data by using Authentication to make sure the requester is the one he/she claims to be, Authorization to make sure the requester is allowed to... </td>
</tr>
@@ -1827,7 +1820,7 @@
<tr><td><a href="basic-errors.html">Errors</a></td>
<td><span class="label label-default">Page</span></td>
- <td> Errors are datatypes containing information about occurred failures which were either cause by the user or appeared in the server. Error model specification Error codes A Ditto error defines an “error code” which is a string identifier that uniquely identifies the error. Ditto itself uses... </td>
+ <td> Errors are datatypes containing information about occurred failures which were either cause by the user or appeared in the server. Error model specification Status The “status” uses HTTP status codes semantics (see RFC 7231) to indicate whether a specific command has been successfully completed,... </td>
</tr>
@@ -1847,7 +1840,7 @@
<tr><td><a href="basic-messages.html">Messages</a></td>
<td><span class="label label-default">Page</span></td>
- <td> Messages do not affect the state of a digital twin or an actual device. Therefore Ditto does not handle messages like commands: there are no responses which are produced by Ditto and no events which are emitted for messages. Note: Ditto has no... </td>
+ <td> Messages do not affect the state of a digital twin or an actual device. Therefore, Ditto does not handle messages like commands: there are no responses which are produced by Ditto and no events which are emitted for messages. Note: Ditto has no... </td>
</tr>
@@ -1877,7 +1870,7 @@
<tr><td><a href="basic-overview.html">Basic concepts overview</a></td>
<td><span class="label label-default">Page</span></td>
- <td> Domain model Eclipse Ditto does not claim to know exactly which structure Things in the IoT have or should have. Its idea is to be as agnostic as possible when it comes to Thing data. Nevertheless two coarse elements are defined in... </td>
+ <td> Domain model Eclipse Ditto does not claim to know exactly which structure Things in the IoT have or should have. Its idea is to be as agnostic as possible when it comes to Thing data. Nevertheless, two coarse elements are defined in... </td>
</tr>
@@ -1891,7 +1884,7 @@
<tr><td><a href="basic-policy.html">Policy</a></td>
<td><span class="label label-default">Page</span></td>
- <td> A Policy enables developers to configure fine-grained access control for Things and other entities in an easy way. Note: The policy concept is only supported for Ditto HTTP API version 2. Find the HTTP API reference at Policies resources. Authorization... </td>
+ <td> A Policy enables developers to configure fine-grained access control for Things and other entities easily. Note: Find the HTTP API reference at Policies resources. Authorization concept A specific policy provides someone (called subject), permission to read and/or write a given resource. <div... </td>
</tr>
@@ -2703,6 +2696,10 @@
+
+
+
+
</tbody>
</table>
@@ -2725,7 +2722,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 8eb86c7..2594e9a 100644
--- a/tag_news.html
+++ b/tag_news.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1777,10 +1780,6 @@
-
-
-
-
@@ -2625,6 +2624,10 @@
+
+
+
+
</tbody>
</table>
@@ -2647,7 +2650,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 e7d6bf7..1c44cc0 100644
--- a/tag_protocol.html
+++ b/tag_protocol.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1777,10 +1780,6 @@
-
-
-
-
@@ -1793,7 +1792,7 @@
<tr><td><a href="basic-enrichment.html">Signal enrichment</a></td>
<td><span class="label label-default">Page</span></td>
- <td> 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 default, so when they are subscribed... </td>
+ <td> 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 message. Events, for example, only contain the actually changed data by default, so when they are subscribed to... </td>
</tr>
@@ -2279,7 +2278,7 @@
<tr><td><a href="protocol-examples.html">Protocol examples</a></td>
<td><span class="label label-default">Page</span></td>
- <td> The structure of the examples in this section is as follows: Command Each example always starts with a command message that initiates an operation at Ditto (e.g. create a thing, retrieve a thing). { "topic": "com.acme/xdk_58/things/twin/commands/modify", <span... </td>
+ <td> The structure of the examples in this section is as follows: Command Each example always starts with a command message that initiates an operation at Ditto (e.g. create a thing, retrieve a thing). { "topic": "org.eclipse.ditto/fancy-thing/things/twin/commands/modify", <span... </td>
</tr>
@@ -2309,15 +2308,7 @@
<tr><td><a href="protocol-specification-errors.html">Protocol specification for errors</a></td>
<td><span class="label label-default">Page</span></td>
- <td> Ditto Protocol messages of errors transport information about encountered
-errors, e.g. client errors or server errors:
-
-
-
-Example
-
-Examples for error responses can be found here.
- </td>
+ <td> Ditto Protocol messages of error responses transport information about encountered errors, e.g. client errors or server errors: The error codes Ditto provides in addition to the HTTP status code (e.g. error codes like “things:thing.tooLarge”) is not to be considered as API and must therefore not... </td>
</tr>
@@ -2357,7 +2348,7 @@
<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>
+ <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>
@@ -2653,6 +2644,10 @@
+
+
+
+
<tr><td><a href="2021-02-04-merge-feature.html">Support merge functionality for things resources</a></td>
<td><span class="label label-primary">Post</span></td>
@@ -2841,7 +2836,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 6384f76..536fd04 100644
--- a/tag_release_notes.html
+++ b/tag_release_notes.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1777,10 +1780,6 @@
-
-
-
-
@@ -2555,9 +2554,9 @@
- <tr><td><a href="release_notes_next.html">Release notes x.x.x</a></td>
+ <tr><td><a href="release_notes_200.html">Release notes 2.0.0</a></td>
<td><span class="label label-default">Page</span></td>
- <td> Version x.x.x of Eclipse Ditto, released on dd.MM.yyyy </td>
+ <td> Version 2.0.0 of Eclipse Ditto, released on 06.05.2021 </td>
</tr>
@@ -2787,6 +2786,10 @@
+
+
+
+
</tbody>
</table>
@@ -2809,7 +2812,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 70ea3c8..0423cfe 100644
--- a/tag_rql.html
+++ b/tag_rql.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1777,10 +1780,6 @@
-
-
-
-
<tr><td><a href="basic-changenotifications.html">Change notifications</a></td>
@@ -2635,6 +2634,10 @@
+
+
+
+
<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>
@@ -2713,7 +2716,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 eed8d90..b2bbef8 100644
--- a/tag_search.html
+++ b/tag_search.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1759,7 +1762,7 @@
<tr><td><a href="architecture-services-things-search.html">Things-Search service</a></td>
<td><span class="label label-default">Page</span></td>
- <td> The “things-search” service takes care of: updating an optimized search index of Things based on the events emitted by the things and policies services when entites are changed there executing search queries against the search index in order to find out which Things match... </td>
+ <td> The “things-search” service takes care of: updating an optimized search index of Things based on the events emitted by the things and policies services when entities are changed there executing search queries against the search index in order to find out which Things match... </td>
</tr>
@@ -1783,10 +1786,6 @@
-
-
-
-
@@ -2661,6 +2660,10 @@
+
+
+
+
</tbody>
</table>
@@ -2683,7 +2686,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 4df5d2e..1217a37 100644
--- a/tag_signal.html
+++ b/tag_signal.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1777,10 +1780,6 @@
-
-
-
-
@@ -1876,7 +1875,7 @@
<tr><td><a href="basic-signals-errorresponse.html">Error response</a></td>
<td><span class="label label-default">Page</span></td>
- <td> If an issued command or message could not be applied, an appropriate error response conveys this information back to the issuer. Failure of a command or message can have various reasons, starting from missing permissions to internal server errors during processing of the command. The Ditto Protocol... </td>
+ <td> If an issued command or message could not be applied, an appropriate error response conveys this error information back to the issuer. Failure of a command or message can have various reasons, starting from missing permissions to internal server errors during processing of the command. The... </td>
</tr>
@@ -2666,6 +2665,10 @@
+
+
+
+
</tbody>
</table>
@@ -2688,7 +2691,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <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 a90998c..cd09eeb 100644
--- a/tag_troubleshooting.html
+++ b/tag_troubleshooting.html
@@ -216,17 +216,19 @@
<option value="">development</option>
- <option value="1.0">1.0</option>
+ <option value="2.0">2.0</option>
- <option value="1.1">1.1</option>
-
- <option value="1.2">1.2</option>
-
- <option value="1.3">1.3</option>
+ <option value="1.5">1.5</option>
<option value="1.4">1.4</option>
- <option value="1.5">1.5</option>
+ <option value="1.3">1.3</option>
+
+ <option value="1.2">1.2</option>
+
+ <option value="1.1">1.1</option>
+
+ <option value="1.0">1.0</option>
</select>
</div>
@@ -276,6 +278,13 @@
+ <li><a href="release_notes_200.html">2.0.0</a></li>
+
+
+
+
+
+
<li><a href="release_notes_151.html">1.5.1</a></li>
@@ -287,19 +296,18 @@
-
-
-
- <li><a href="release_notes_140.html">1.4.0</a></li>
-
-
-
<li class="subfolders">
<a href="#"><span></span>Archive</a>
<ul>
+ <li><a href="release_notes_140.html">1.4.0</a></li>
+
+
+
+
+
<li><a href="release_notes_130.html">1.3.0</a></li>
@@ -503,12 +511,6 @@
- <li><a href="basic-acl.html">Access Control List (ACL)</a></li>
-
-
-
-
-
<li><a href="basic-feature.html">Feature</a></li>
@@ -968,6 +970,13 @@
+ <li><a href="protocol-specification-errors.html">Errors</a></li>
+
+
+
+
+
+
<li><a href="protocol-specification-things.html">Things group</a></li>
@@ -1006,12 +1015,6 @@
-
-
- <li><a href="protocol-specification-errors.html">Errors</a></li>
-
-
-
</ul>
</li>
@@ -1777,10 +1780,6 @@
-
-
-
-
@@ -2639,6 +2638,10 @@
+
+
+
+
</tbody>
</table>
@@ -2661,7 +2664,7 @@
</div>
<p class="notice">
©2021 Eclipse Ditto™.
- Site last generated: Apr 14, 2021 <br />
+ Site last generated: May 6, 2021 <br />
</p>
<div class="quickLinks">
<a href="https://www.eclipse.org/legal/privacy.php" target="_blank">
