Reflect changes of PR #895
Prioritisation of assignments via mgmt-API (see https://github.com/eclipse/hawkbit/pull/895)
Signed-off-by: Dominic Schabel <dominic.schabel@bosch-si.com>
diff --git a/apis/dmf_api/index.html b/apis/dmf_api/index.html
index 1a23623..7b5d814 100644
--- a/apis/dmf_api/index.html
+++ b/apis/dmf_api/index.html
@@ -10,7 +10,7 @@
<meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
<meta http-equiv="X-UA-Compatible" content="IE=10" />
<title>Device Management Federation API - Eclipse hawkBit</title>
- <meta name="generator" content="Hugo 0.56.0" />
+ <meta name="generator" content="Hugo 0.56.3" />
<meta name="description" content="IoT. Update. Device.">
@@ -506,7 +506,7 @@
</tbody>
</table>
-<p>Example headers</p>
+<p>Example headers and payload:</p>
<table>
<thead>
@@ -524,6 +524,91 @@
</tbody>
</table>
+<p>Payload Template (optional):</p>
+
+<pre><code class="language-json">{
+ "name": "String"
+}
+</code></pre>
+
+<p>The “name” property specifies the name of the thing, which by default is the thing ID. This property is optional.</p>
+
+<h3 id="thing-removed">THING_REMOVED</h3>
+
+<p>Message to request the deletion of a provisioning target.</p>
+
+<table>
+<thead>
+<tr>
+<th>Header</th>
+<th>Description</th>
+<th>Type</th>
+<th>Mandatory</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td>type</td>
+<td>Type of the message</td>
+<td>Fixed string “THING_REMOVED”</td>
+<td>true</td>
+</tr>
+
+<tr>
+<td>thingId</td>
+<td>The ID of the registered provisioning target</td>
+<td>String</td>
+<td>true</td>
+</tr>
+
+<tr>
+<td>tenant</td>
+<td>The tenant this provisioning target belongs to</td>
+<td>String</td>
+<td>false</td>
+</tr>
+</tbody>
+</table>
+
+<table>
+<thead>
+<tr>
+<th>Message Properties</th>
+<th>Description</th>
+<th>Type</th>
+<th>Mandatory</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td>content_type</td>
+<td>The content type of the payload</td>
+<td>String</td>
+<td>true</td>
+</tr>
+</tbody>
+</table>
+
+<p>Example headers</p>
+
+<table>
+<thead>
+<tr>
+<th>Header</th>
+<th>MessageProperties</th>
+</tr>
+</thead>
+
+<tbody>
+<tr>
+<td>type=THING_REMOVED <br /> tenant=tenant123 <br /> thingId=abc</td>
+<td>content_type=application/json</td>
+</tr>
+</tbody>
+</table>
+
<h3 id="update-attributes">UPDATE_ATTRIBUTES</h3>
<p>Message to update target attributes. This message can be send in response to a _REQUEST_ATTRIBUTES<em>UPDATE</em> event, sent by hawkBit.</p>
@@ -1152,6 +1237,8 @@
<p>If <code>multi.assignments.enabled</code> is enabled, this message is sent instead of DOWNLOAD_AND_INSTALL, DOWNLOAD, or CANCEL_DOWNLOAD
by hawkBit to initialize update, download, or cancel task(s).</p>
+<p>With weight, one can set the priority to the action. The higher the weight, the higher is the priority of an action.</p>
+
<table>
<thead>
<tr>
@@ -1217,6 +1304,7 @@
<pre><code class="language-json">[{
"topic": "String",
+"weight": long,
"action": {
"actionId": long,
"targetSecurityToken": "String",
@@ -1249,6 +1337,7 @@
},
{
"topic": "String",
+"weight": long,
"action": {
"actionId": long,
"targetSecurityToken": "String",
@@ -1301,6 +1390,7 @@
<pre><code class="language-json">[{
"topic": "DOWNLOAD_AND_INSTALL",
+"weight": 600,
"action": {
"actionId":137,
"targetSecurityToken":"bH7XXAprK1ChnLfKSdtlsp7NOlPnZAYY",
@@ -1333,6 +1423,7 @@
},
{
"topic": "DOWNLOAD",
+"weight": 500,
"action": {
"actionId":138,
"targetSecurityToken":"bH7XXAprK1ChnLfKSdtlsp7NOlPnZAYY",
diff --git a/concepts/rollout-management/index.html b/concepts/rollout-management/index.html
index d647bda..3292942 100644
--- a/concepts/rollout-management/index.html
+++ b/concepts/rollout-management/index.html
@@ -10,7 +10,7 @@
<meta name="viewport" content="width=device-width,user-scalable=no,initial-scale=1,maximum-scale=1">
<meta http-equiv="X-UA-Compatible" content="IE=10" />
<title>Rollout Management - Eclipse hawkBit</title>
- <meta name="generator" content="Hugo 0.56.0" />
+ <meta name="generator" content="Hugo 0.56.3" />
<meta name="description" content="IoT. Update. Device.">
@@ -456,6 +456,10 @@
<p>One of the main paradigms of Eclipse hawkBit is, that a Distribution Set represents the currently installed software of a device. Hence, a device can have only one Distribution Set assigned/installed at a time. With <em>Multi-Assignments</em> enabled, this paradigm shifts. Multi-Assignments allows to assign multiple Distribution Sets to a device simultaneously, without cancelling each other. As a consequence, an operator can trigger multiple campaigns addressing the same devices in parallel.</p>
+<h3 id="action-weight">Action weight</h3>
+
+<p>To differentiate between important and less important updates a property called <em>weight</em> is used. When multi-assignments is enabled every action has a weight value between (and including) 0 and 1000. The higher the weight the more important is the assignment represented by the action. Also when defining a <em>rollout</em> or an <em>auto-assignment</em> and multi-assignments is enabled a weight value has to be provided. This value is passed to the actions created during the execution of these <em>rollouts</em> and <em>auto-assignments</em>. If no weight was provided the highest value of 1000 is used instead.</p>
+
<h3 id="consequences">Consequences</h3>
<p>While this feature provides more flexibility to the user and enables new use-cases, there are also some consequences one should be aware of:</p>
@@ -465,13 +469,12 @@
<ul>
<li>This feature is in beta and may change unannounced.</li>
<li>For now, this feature is <strong>opt-in only</strong>. Once activated, it cannot be deactivated.</li>
-<li>Currently, there is no mechanism to hint devices to process the actions in a certain order.</li>
</ul>
<p><strong>Minor</strong></p>
<ul>
-<li>While on DMF-API a MULTI_ACTION request is sent, DDI-API only exposes the oldest open action.</li>
+<li>While on DMF-API a MULTI_ACTION request is sent, DDI-API only exposes the next action which has the highest priority in the list of open actions(according to their weight property).</li>
<li>All information regarding the currently assigned or installed Distribution Set does only respect the last assignment, as well as the last successfully installed Distribution set. This also affects:
<ul>
diff --git a/rest-api/distributionsets-api-guide/index.html b/rest-api/distributionsets-api-guide/index.html
index df33d13..a3d3d81 100644
--- a/rest-api/distributionsets-api-guide/index.html
+++ b/rest-api/distributionsets-api-guide/index.html
@@ -634,26 +634,26 @@
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">HTTP/1.1 200 OK
-Content-Length: 2279
+Content-Length: 2299
Content-Type: application/json;charset=UTF-8
{
"content" : [ {
"createdBy" : "bumlux",
- "createdAt" : 1567757255341,
+ "createdAt" : 1575375127783,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757255344,
+ "lastModifiedAt" : 1575375127787,
"name" : "DS",
- "description" : "Updated Desc: fringilla cum ad at duis tristique ad sapien vitae purus",
+ "description" : "Updated Desc: porta a semper nulla fames duis condimentum a massa himenaeos",
"version" : "1.0",
"modules" : [ {
"createdBy" : "bumlux",
- "createdAt" : 1567757255335,
+ "createdAt" : 1575375127697,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757255349,
+ "lastModifiedAt" : 1575375127794,
"name" : "Firmware",
- "description" : "Updated Desc: fringilla cum ad at duis tristique ad sapien vitae purus",
- "version" : "1.0.97",
+ "description" : "Updated Desc: porta a semper nulla fames duis condimentum a massa himenaeos",
+ "version" : "1.0.17",
"type" : "os",
"vendor" : "vendor Limited Inc, California",
"deleted" : false,
@@ -665,12 +665,12 @@
"id" : 202
}, {
"createdBy" : "bumlux",
- "createdAt" : 1567757255332,
+ "createdAt" : 1575375127692,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757255347,
+ "lastModifiedAt" : 1575375127791,
"name" : "app runtime",
- "description" : "Updated Desc: fringilla cum ad at duis tristique ad sapien vitae purus",
- "version" : "1.0.92",
+ "description" : "Updated Desc: porta a semper nulla fames duis condimentum a massa himenaeos",
+ "version" : "1.0.71",
"type" : "runtime",
"vendor" : "vendor GmbH, Stuttgart, Germany",
"deleted" : false,
@@ -682,12 +682,12 @@
"id" : 201
}, {
"createdBy" : "bumlux",
- "createdAt" : 1567757255330,
+ "createdAt" : 1575375127687,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757255350,
+ "lastModifiedAt" : 1575375127804,
"name" : "application",
- "description" : "Updated Desc: fringilla cum ad at duis tristique ad sapien vitae purus",
- "version" : "1.0.79",
+ "description" : "Updated Desc: porta a semper nulla fames duis condimentum a massa himenaeos",
+ "version" : "1.0.53",
"type" : "application",
"vendor" : "vendor Limited, California",
"deleted" : false,
@@ -787,7 +787,7 @@
-d '[ {
"requiredMigrationStep" : false,
"name" : "one",
- "description" : "nisl nullam senectus ultricies metus nam sagittis nostra cras etiam",
+ "description" : "felis eleifend class ligula phasellus justo nunc ridiculus fermentum montes",
"type" : "test_default_ds_type",
"version" : "one",
"modules" : [ {
@@ -798,7 +798,7 @@
}, {
"requiredMigrationStep" : false,
"name" : "two",
- "description" : "lacus bibendum pharetra nam magnis torquent nibh natoque et montes",
+ "description" : "praesent sagittis sem tempus mauris volutpat quis et sodales potenti",
"type" : "test_default_ds_type",
"version" : "two",
"modules" : [ {
@@ -809,7 +809,7 @@
}, {
"requiredMigrationStep" : true,
"name" : "three",
- "description" : "nostra felis mus diam auctor aptent curae non dis libero",
+ "description" : "vitae sagittis est etiam vel ut sociis scelerisque purus blandit",
"type" : "test_default_ds_type",
"version" : "three",
"modules" : [ {
@@ -826,14 +826,14 @@
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">POST /rest/v1/distributionsets/ HTTP/1.1
+Content-Length: 803
Content-Type: application/json;charset=UTF-8
-Content-Length: 785
Host: management-api.host.com
[ {
"requiredMigrationStep" : false,
"name" : "one",
- "description" : "nisl nullam senectus ultricies metus nam sagittis nostra cras etiam",
+ "description" : "felis eleifend class ligula phasellus justo nunc ridiculus fermentum montes",
"type" : "test_default_ds_type",
"version" : "one",
"modules" : [ {
@@ -844,7 +844,7 @@
}, {
"requiredMigrationStep" : false,
"name" : "two",
- "description" : "lacus bibendum pharetra nam magnis torquent nibh natoque et montes",
+ "description" : "praesent sagittis sem tempus mauris volutpat quis et sodales potenti",
"type" : "test_default_ds_type",
"version" : "two",
"modules" : [ {
@@ -855,7 +855,7 @@
}, {
"requiredMigrationStep" : true,
"name" : "three",
- "description" : "nostra felis mus diam auctor aptent curae non dis libero",
+ "description" : "vitae sagittis est etiam vel ut sociis scelerisque purus blandit",
"type" : "test_default_ds_type",
"version" : "three",
"modules" : [ {
@@ -1026,24 +1026,24 @@
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">HTTP/1.1 201 Created
-Content-Length: 4625
Content-Type: application/hal+json;charset=UTF-8
+Content-Length: 4634
[ {
"createdBy" : "bumlux",
- "createdAt" : 1567757255261,
+ "createdAt" : 1575375127569,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757255261,
+ "lastModifiedAt" : 1575375127569,
"name" : "one",
- "description" : "nisl nullam senectus ultricies metus nam sagittis nostra cras etiam",
+ "description" : "felis eleifend class ligula phasellus justo nunc ridiculus fermentum montes",
"version" : "one",
"modules" : [ {
"createdBy" : "bumlux",
- "createdAt" : 1567757255240,
+ "createdAt" : 1575375127530,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757255240,
+ "lastModifiedAt" : 1575375127530,
"name" : "os",
- "description" : "risus hac quam montes sociis sagittis ac erat cras pellentesque",
+ "description" : "porta diam venenatis nisl volutpat fermentum laoreet id potenti eu",
"version" : "1.0",
"type" : "os",
"vendor" : "Vendor Limited, California",
@@ -1056,11 +1056,11 @@
"id" : 199
}, {
"createdBy" : "bumlux",
- "createdAt" : 1567757255237,
+ "createdAt" : 1575375127526,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757255237,
+ "lastModifiedAt" : 1575375127526,
"name" : "application",
- "description" : "himenaeos est penatibus per nascetur nibh interdum nascetur interdum rhoncus",
+ "description" : "faucibus mollis sociis in venenatis morbi cubilia tincidunt sociis est",
"version" : "1.0",
"type" : "application",
"vendor" : "Vendor Limited, California",
@@ -1078,25 +1078,25 @@
"deleted" : false,
"_links" : {
"self" : {
- "href" : "https://management-api.host.com/rest/v1/distributionsets/63"
+ "href" : "https://management-api.host.com/rest/v1/distributionsets/64"
}
},
- "id" : 63
+ "id" : 64
}, {
"createdBy" : "bumlux",
- "createdAt" : 1567757255263,
+ "createdAt" : 1575375127572,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757255263,
+ "lastModifiedAt" : 1575375127572,
"name" : "two",
- "description" : "lacus bibendum pharetra nam magnis torquent nibh natoque et montes",
+ "description" : "praesent sagittis sem tempus mauris volutpat quis et sodales potenti",
"version" : "two",
"modules" : [ {
"createdBy" : "bumlux",
- "createdAt" : 1567757255240,
+ "createdAt" : 1575375127530,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757255240,
+ "lastModifiedAt" : 1575375127530,
"name" : "os",
- "description" : "risus hac quam montes sociis sagittis ac erat cras pellentesque",
+ "description" : "porta diam venenatis nisl volutpat fermentum laoreet id potenti eu",
"version" : "1.0",
"type" : "os",
"vendor" : "Vendor Limited, California",
@@ -1109,11 +1109,11 @@
"id" : 199
}, {
"createdBy" : "bumlux",
- "createdAt" : 1567757255237,
+ "createdAt" : 1575375127526,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757255237,
+ "lastModifiedAt" : 1575375127526,
"name" : "application",
- "description" : "himenaeos est penatibus per nascetur nibh interdum nascetur interdum rhoncus",
+ "description" : "faucibus mollis sociis in venenatis morbi cubilia tincidunt sociis est",
"version" : "1.0",
"type" : "application",
"vendor" : "Vendor Limited, California",
@@ -1137,19 +1137,19 @@
"id" : 62
}, {
"createdBy" : "bumlux",
- "createdAt" : 1567757255265,
+ "createdAt" : 1575375127575,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757255265,
+ "lastModifiedAt" : 1575375127575,
"name" : "three",
- "description" : "nostra felis mus diam auctor aptent curae non dis libero",
+ "description" : "vitae sagittis est etiam vel ut sociis scelerisque purus blandit",
"version" : "three",
"modules" : [ {
"createdBy" : "bumlux",
- "createdAt" : 1567757255240,
+ "createdAt" : 1575375127530,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757255240,
+ "lastModifiedAt" : 1575375127530,
"name" : "os",
- "description" : "risus hac quam montes sociis sagittis ac erat cras pellentesque",
+ "description" : "porta diam venenatis nisl volutpat fermentum laoreet id potenti eu",
"version" : "1.0",
"type" : "os",
"vendor" : "Vendor Limited, California",
@@ -1162,11 +1162,11 @@
"id" : 199
}, {
"createdBy" : "bumlux",
- "createdAt" : 1567757255237,
+ "createdAt" : 1575375127526,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757255237,
+ "lastModifiedAt" : 1575375127526,
"name" : "application",
- "description" : "himenaeos est penatibus per nascetur nibh interdum nascetur interdum rhoncus",
+ "description" : "faucibus mollis sociis in venenatis morbi cubilia tincidunt sociis est",
"version" : "1.0",
"type" : "application",
"vendor" : "Vendor Limited, California",
@@ -1184,10 +1184,10 @@
"deleted" : false,
"_links" : {
"self" : {
- "href" : "https://management-api.host.com/rest/v1/distributionsets/64"
+ "href" : "https://management-api.host.com/rest/v1/distributionsets/63"
}
},
- "id" : 64
+ "id" : 63
} ]</code></pre>
</div>
</div>
@@ -1541,25 +1541,25 @@
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">HTTP/1.1 200 OK
-Content-Length: 2520
+Content-Length: 2541
Content-Type: application/json;charset=UTF-8
{
"createdBy" : "bumlux",
- "createdAt" : 1567757253671,
+ "createdAt" : 1575375124627,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757253674,
+ "lastModifiedAt" : 1575375124631,
"name" : "DS",
- "description" : "Updated Desc: fringilla cum ad at duis tristique ad sapien vitae purus",
+ "description" : "Updated Desc: porta a semper nulla fames duis condimentum a massa himenaeos",
"version" : "1.0",
"modules" : [ {
"createdBy" : "bumlux",
- "createdAt" : 1567757253655,
+ "createdAt" : 1575375124612,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757253678,
+ "lastModifiedAt" : 1575375124637,
"name" : "application",
- "description" : "Updated Desc: fringilla cum ad at duis tristique ad sapien vitae purus",
- "version" : "1.0.27",
+ "description" : "Updated Desc: porta a semper nulla fames duis condimentum a massa himenaeos",
+ "version" : "1.0.54",
"type" : "application",
"vendor" : "vendor Limited, California",
"deleted" : false,
@@ -1571,12 +1571,12 @@
"id" : 142
}, {
"createdBy" : "bumlux",
- "createdAt" : 1567757253662,
+ "createdAt" : 1575375124619,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757253677,
+ "lastModifiedAt" : 1575375124635,
"name" : "Firmware",
- "description" : "Updated Desc: fringilla cum ad at duis tristique ad sapien vitae purus",
- "version" : "1.0.88",
+ "description" : "Updated Desc: porta a semper nulla fames duis condimentum a massa himenaeos",
+ "version" : "1.0.66",
"type" : "os",
"vendor" : "vendor Limited Inc, California",
"deleted" : false,
@@ -1588,12 +1588,12 @@
"id" : 144
}, {
"createdBy" : "bumlux",
- "createdAt" : 1567757253659,
+ "createdAt" : 1575375124616,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757253680,
+ "lastModifiedAt" : 1575375124640,
"name" : "app runtime",
- "description" : "Updated Desc: fringilla cum ad at duis tristique ad sapien vitae purus",
- "version" : "1.0.0",
+ "description" : "Updated Desc: porta a semper nulla fames duis condimentum a massa himenaeos",
+ "version" : "1.0.36",
"type" : "runtime",
"vendor" : "vendor GmbH, Stuttgart, Germany",
"deleted" : false,
@@ -1923,25 +1923,25 @@
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">HTTP/1.1 200 OK
-Content-Length: 2489
Content-Type: application/json;charset=UTF-8
+Content-Length: 2503
{
"createdBy" : "bumlux",
- "createdAt" : 1567757254060,
+ "createdAt" : 1575375125097,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757254075,
+ "lastModifiedAt" : 1575375125117,
"name" : "another Name",
"description" : "a new description",
"version" : "another Version",
"modules" : [ {
"createdBy" : "bumlux",
- "createdAt" : 1567757254052,
+ "createdAt" : 1575375125086,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757254067,
+ "lastModifiedAt" : 1575375125107,
"name" : "app runtime",
- "description" : "Updated Desc: fringilla cum ad at duis tristique ad sapien vitae purus",
- "version" : "1.0.82",
+ "description" : "Updated Desc: porta a semper nulla fames duis condimentum a massa himenaeos",
+ "version" : "1.0.52",
"type" : "runtime",
"vendor" : "vendor GmbH, Stuttgart, Germany",
"deleted" : false,
@@ -1953,12 +1953,12 @@
"id" : 161
}, {
"createdBy" : "bumlux",
- "createdAt" : 1567757254050,
+ "createdAt" : 1575375125082,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757254066,
+ "lastModifiedAt" : 1575375125105,
"name" : "application",
- "description" : "Updated Desc: fringilla cum ad at duis tristique ad sapien vitae purus",
- "version" : "1.0.19",
+ "description" : "Updated Desc: porta a semper nulla fames duis condimentum a massa himenaeos",
+ "version" : "1.0.84",
"type" : "application",
"vendor" : "vendor Limited, California",
"deleted" : false,
@@ -1970,12 +1970,12 @@
"id" : 160
}, {
"createdBy" : "bumlux",
- "createdAt" : 1567757254055,
+ "createdAt" : 1575375125088,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757254064,
+ "lastModifiedAt" : 1575375125103,
"name" : "Firmware",
- "description" : "Updated Desc: fringilla cum ad at duis tristique ad sapien vitae purus",
- "version" : "1.0.86",
+ "description" : "Updated Desc: porta a semper nulla fames duis condimentum a massa himenaeos",
+ "version" : "1.0.5",
"type" : "os",
"vendor" : "vendor Limited Inc, California",
"deleted" : false,
@@ -2279,18 +2279,18 @@
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">HTTP/1.1 200 OK
-Content-Length: 1620
Content-Type: application/json;charset=UTF-8
+Content-Length: 1635
{
"content" : [ {
"createdBy" : "bumlux",
- "createdAt" : 1567757254654,
+ "createdAt" : 1575375126243,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757254678,
+ "lastModifiedAt" : 1575375126313,
"name" : "application",
- "description" : "Updated Desc: fringilla cum ad at duis tristique ad sapien vitae purus",
- "version" : "1.0.39",
+ "description" : "Updated Desc: porta a semper nulla fames duis condimentum a massa himenaeos",
+ "version" : "1.0.14",
"type" : "application",
"vendor" : "vendor Limited, California",
"deleted" : false,
@@ -2302,12 +2302,12 @@
"id" : 178
}, {
"createdBy" : "bumlux",
- "createdAt" : 1567757254656,
+ "createdAt" : 1575375126247,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757254674,
+ "lastModifiedAt" : 1575375126306,
"name" : "app runtime",
- "description" : "Updated Desc: fringilla cum ad at duis tristique ad sapien vitae purus",
- "version" : "1.0.31",
+ "description" : "Updated Desc: porta a semper nulla fames duis condimentum a massa himenaeos",
+ "version" : "1.0.65",
"type" : "runtime",
"vendor" : "vendor GmbH, Stuttgart, Germany",
"deleted" : false,
@@ -2319,12 +2319,12 @@
"id" : 179
}, {
"createdBy" : "bumlux",
- "createdAt" : 1567757254659,
+ "createdAt" : 1575375126250,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757254676,
+ "lastModifiedAt" : 1575375126310,
"name" : "Firmware",
- "description" : "Updated Desc: fringilla cum ad at duis tristique ad sapien vitae purus",
- "version" : "1.0.59",
+ "description" : "Updated Desc: porta a semper nulla fames duis condimentum a massa himenaeos",
+ "version" : "1.0.26",
"type" : "os",
"vendor" : "vendor Limited Inc, California",
"deleted" : false,
@@ -2834,13 +2834,13 @@
{
"content" : [ {
"createdBy" : "bumlux",
- "createdAt" : 1567757253398,
+ "createdAt" : 1575375124424,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757253501,
+ "lastModifiedAt" : 1575375124447,
"name" : "targetExist",
"controllerId" : "targetExist",
"updateStatus" : "pending",
- "securityToken" : "9517ba8d715f90b229fe6c814b32acd0",
+ "securityToken" : "7e0eb62aa73347b9efabb377dc541594",
"requestAttributes" : true,
"_links" : {
"self" : {
@@ -2926,46 +2926,46 @@
-d '[ {
"maintenanceWindow" : {
"duration" : "00:10:00",
- "schedule" : "34 47 11 6 9 ? 2019",
- "timezone" : "+02:00"
+ "schedule" : "5 52 14 3 12 ? 2019",
+ "timezone" : "+01:00"
},
- "forcetime" : 1567757254500,
+ "forcetime" : 1575375125747,
"id" : "target1",
"type" : "timeforced"
}, {
"maintenanceWindow" : {
"duration" : "00:10:00",
- "schedule" : "34 47 11 6 9 ? 2019",
- "timezone" : "+02:00"
+ "schedule" : "5 52 14 3 12 ? 2019",
+ "timezone" : "+01:00"
},
- "forcetime" : 1567757254500,
+ "forcetime" : 1575375125747,
"id" : "target2",
"type" : "timeforced"
}, {
"maintenanceWindow" : {
"duration" : "00:10:00",
- "schedule" : "34 47 11 6 9 ? 2019",
- "timezone" : "+02:00"
+ "schedule" : "5 52 14 3 12 ? 2019",
+ "timezone" : "+01:00"
},
- "forcetime" : 1567757254500,
+ "forcetime" : 1575375125747,
"id" : "target3",
"type" : "timeforced"
}, {
"maintenanceWindow" : {
"duration" : "00:10:00",
- "schedule" : "34 47 11 6 9 ? 2019",
- "timezone" : "+02:00"
+ "schedule" : "5 52 14 3 12 ? 2019",
+ "timezone" : "+01:00"
},
- "forcetime" : 1567757254500,
+ "forcetime" : 1575375125747,
"id" : "target4",
"type" : "timeforced"
}, {
"maintenanceWindow" : {
"duration" : "00:10:00",
- "schedule" : "34 47 11 6 9 ? 2019",
- "timezone" : "+02:00"
+ "schedule" : "5 52 14 3 12 ? 2019",
+ "timezone" : "+01:00"
},
- "forcetime" : 1567757254500,
+ "forcetime" : 1575375125747,
"id" : "target5",
"type" : "timeforced"
} ]'</code></pre>
@@ -2984,46 +2984,46 @@
[ {
"maintenanceWindow" : {
"duration" : "00:10:00",
- "schedule" : "34 47 11 6 9 ? 2019",
- "timezone" : "+02:00"
+ "schedule" : "5 52 14 3 12 ? 2019",
+ "timezone" : "+01:00"
},
- "forcetime" : 1567757254500,
+ "forcetime" : 1575375125747,
"id" : "target1",
"type" : "timeforced"
}, {
"maintenanceWindow" : {
"duration" : "00:10:00",
- "schedule" : "34 47 11 6 9 ? 2019",
- "timezone" : "+02:00"
+ "schedule" : "5 52 14 3 12 ? 2019",
+ "timezone" : "+01:00"
},
- "forcetime" : 1567757254500,
+ "forcetime" : 1575375125747,
"id" : "target2",
"type" : "timeforced"
}, {
"maintenanceWindow" : {
"duration" : "00:10:00",
- "schedule" : "34 47 11 6 9 ? 2019",
- "timezone" : "+02:00"
+ "schedule" : "5 52 14 3 12 ? 2019",
+ "timezone" : "+01:00"
},
- "forcetime" : 1567757254500,
+ "forcetime" : 1575375125747,
"id" : "target3",
"type" : "timeforced"
}, {
"maintenanceWindow" : {
"duration" : "00:10:00",
- "schedule" : "34 47 11 6 9 ? 2019",
- "timezone" : "+02:00"
+ "schedule" : "5 52 14 3 12 ? 2019",
+ "timezone" : "+01:00"
},
- "forcetime" : 1567757254500,
+ "forcetime" : 1575375125747,
"id" : "target4",
"type" : "timeforced"
}, {
"maintenanceWindow" : {
"duration" : "00:10:00",
- "schedule" : "34 47 11 6 9 ? 2019",
- "timezone" : "+02:00"
+ "schedule" : "5 52 14 3 12 ? 2019",
+ "timezone" : "+01:00"
},
- "forcetime" : 1567757254500,
+ "forcetime" : 1575375125747,
"id" : "target5",
"type" : "timeforced"
} ]</code></pre>
@@ -3093,53 +3093,60 @@
</thead>
<tbody>
<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">[]forcetime</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Forcetime in milliseconds.</p></td>
-<td class="tableblock halign-left valign-top"></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">X</p></td>
-</tr>
-<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">[]id</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">[].id</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">String</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The technical identifier of the entity</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">X</p></td>
</tr>
<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">[]maintenanceWindow</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">[].weight</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Importance of the assignment.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">0 - 1000</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">when multi-assignment is enabled</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">[].forcetime</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Forcetime in milliseconds.</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">[].maintenanceWindow</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Object</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Separation of download and install by defining a maintenance window for the installation.</p></td>
<td class="tableblock halign-left valign-top"></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">X</p></td>
+<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">[]maintenanceWindow.schedule</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">[].maintenanceWindow.schedule</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">String</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Schedule for the maintenance window start in quartz cron notation, such as '0 15 10 * * ? 2018' for 10:15am every day during the year 2018.</p></td>
<td class="tableblock halign-left valign-top"></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">X</p></td>
+<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">[]maintenanceWindow.duration</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">[].maintenanceWindow.duration</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">String</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Duration of the window, such as '02:00:00' for 2 hours.</p></td>
<td class="tableblock halign-left valign-top"></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">X</p></td>
+<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">[]maintenanceWindow.timezone</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">[].maintenanceWindow.timezone</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">String</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A time-zone offset from Greenwich/UTC, such as '+02:00'.</p></td>
<td class="tableblock halign-left valign-top"></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">X</p></td>
+<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">[]type</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">[].type</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">String</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The type of the forcetime.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The type of the assignment.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">['soft', 'forced','timeforced', 'downloadonly']</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">X</p></td>
+<td class="tableblock halign-left valign-top"></td>
</tr>
</tbody>
</table>
@@ -3231,17 +3238,17 @@
}, {
"_links" : {
"self" : {
- "href" : "https://management-api.host.com/rest/v1/targets/target4/actions/54"
- }
- },
- "id" : 54
- }, {
- "_links" : {
- "self" : {
- "href" : "https://management-api.host.com/rest/v1/targets/target5/actions/55"
+ "href" : "https://management-api.host.com/rest/v1/targets/target4/actions/55"
}
},
"id" : 55
+ }, {
+ "_links" : {
+ "self" : {
+ "href" : "https://management-api.host.com/rest/v1/targets/target5/actions/54"
+ }
+ },
+ "id" : 54
} ],
"assigned" : 4,
"total" : 5
@@ -3463,14 +3470,14 @@
{
"content" : [ {
"createdBy" : "bumlux",
- "createdAt" : 1567757254768,
+ "createdAt" : 1575375126509,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757254785,
+ "lastModifiedAt" : 1575375126536,
"name" : "targetExist",
"controllerId" : "targetExist",
"updateStatus" : "in_sync",
- "installedAt" : 1567757254783,
- "securityToken" : "9ca9c49ecbbf7cba5f70e723c3750f4e",
+ "installedAt" : 1575375126533,
+ "securityToken" : "fba6703fc96a70cc11db9de8aecb6e8d",
"requestAttributes" : true,
"_links" : {
"self" : {
@@ -3677,19 +3684,20 @@
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">HTTP/1.1 200 OK
-Content-Length: 849
+Content-Length: 911
Content-Type: application/json;charset=UTF-8
{
"content" : [ {
"createdBy" : "bumlux",
- "createdAt" : 1567757254412,
+ "createdAt" : 1575375125599,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757254412,
+ "lastModifiedAt" : 1575375125599,
"name" : "filter1",
"query" : "name==a",
"autoAssignDistributionSet" : 53,
"autoAssignActionType" : null,
+ "autoAssignWeight" : null,
"_links" : {
"self" : {
"href" : "https://management-api.host.com/rest/v1/targetfilters/10"
@@ -3698,13 +3706,14 @@
"id" : 10
}, {
"createdBy" : "bumlux",
- "createdAt" : 1567757254415,
+ "createdAt" : 1575375125605,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757254415,
+ "lastModifiedAt" : 1575375125605,
"name" : "filter2",
"query" : "name==b",
"autoAssignDistributionSet" : 53,
"autoAssignActionType" : null,
+ "autoAssignWeight" : null,
"_links" : {
"self" : {
"href" : "https://management-api.host.com/rest/v1/targetfilters/11"
diff --git a/rest-api/rollout-api-guide/index.html b/rest-api/rollout-api-guide/index.html
index 08b1d46..ba2a741 100644
--- a/rest-api/rollout-api-guide/index.html
+++ b/rest-api/rollout-api-guide/index.html
@@ -562,6 +562,12 @@
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">content[].weight</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Weight of the resulting Actions</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">content[].deleted</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Boolean</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Deleted flag, used for soft deleted entities</p></td>
@@ -636,14 +642,14 @@
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
-Content-Length: 578
+Content-Length: 598
{
"content" : [ {
"createdBy" : "bumlux",
- "createdAt" : 1564644177252,
+ "createdAt" : 1575375111947,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1564644177385,
+ "lastModifiedAt" : 1575375112053,
"name" : "exampleRollout",
"description" : "exampleDescription",
"targetFilterQuery" : "controllerId==exampleTarget*",
@@ -652,6 +658,7 @@
"totalTargets" : 20,
"deleted" : false,
"type" : "forced",
+ "weight" : 400,
"_links" : {
"self" : {
"href" : "https://management-api.host.com/rest/v1/rollouts/15"
@@ -802,6 +809,12 @@
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">weight</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Weight of the resulting Actions</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">deleted</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Boolean</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Deleted flag, used for soft deleted entities</p></td>
@@ -918,13 +931,13 @@
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
-Content-Length: 1359
+Content-Length: 1377
{
"createdBy" : "bumlux",
- "createdAt" : 1564644107815,
+ "createdAt" : 1575375107322,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1564644108005,
+ "lastModifiedAt" : 1575375107520,
"name" : "exampleRollout",
"description" : "exampleDescription",
"targetFilterQuery" : "controllerId==exampleTarget*",
@@ -941,6 +954,7 @@
},
"deleted" : false,
"type" : "forced",
+ "weight" : 400,
"_links" : {
"start" : {
"href" : "https://management-api.host.com/rest/v1/rollouts/2/start"
@@ -1065,6 +1079,7 @@
"expression" : "",
"action" : "PAUSE"
},
+ "type" : "forced",
"errorCondition" : {
"condition" : "THRESHOLD",
"expression" : "80"
@@ -1079,7 +1094,7 @@
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">POST /rest/v1/rollouts HTTP/1.1
Content-Type: application/hal+json;charset=UTF-8
-Content-Length: 490
+Content-Length: 511
Accept: application/hal+json
Host: management-api.host.com
@@ -1101,6 +1116,7 @@
"expression" : "",
"action" : "PAUSE"
},
+ "type" : "forced",
"errorCondition" : {
"condition" : "THRESHOLD",
"expression" : "80"
@@ -1137,6 +1153,27 @@
<td class="tableblock halign-left valign-top"><p class="tableblock">X</p></td>
</tr>
<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">weight</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Weight of the resulting Actions</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">0 - 1000</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">when multi-assignment is enabled</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">name</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">String</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The name of the entity</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">X</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">type</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">String</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">the type of this rollout</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">['soft', 'forced', 'timeforced', 'downloadonly']</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">distributionSetId</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">the ID of distributionset of this rollout</p></td>
@@ -1285,6 +1322,12 @@
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">weight</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Weight of the resulting Actions</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">deleted</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Boolean</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Deleted flag, used for soft deleted entities</p></td>
@@ -1405,9 +1448,9 @@
{
"createdBy" : "bumlux",
- "createdAt" : 1564644129892,
+ "createdAt" : 1575375109751,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1564644129892,
+ "lastModifiedAt" : 1575375109751,
"name" : "exampleRollout",
"description" : "Rollout for all named targets",
"targetFilterQuery" : "id==targets-*",
@@ -1617,6 +1660,13 @@
<td class="tableblock halign-left valign-top"><p class="tableblock">X</p></td>
</tr>
<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">weight</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Weight of the resulting Actions</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">0 - 1000</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">when multi-assignment is enabled</p></td>
+</tr>
+<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">distributionSetId</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">the ID of distributionset of this rollout</p></td>
@@ -1877,6 +1927,12 @@
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">weight</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Weight of the resulting Actions</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">deleted</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Boolean</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Deleted flag, used for soft deleted entities</p></td>
@@ -1997,9 +2053,9 @@
{
"createdBy" : "bumlux",
- "createdAt" : 1564644140321,
+ "createdAt" : 1575375110189,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1564644140321,
+ "lastModifiedAt" : 1575375110189,
"name" : "exampleRolloutWithDefinedGroups",
"description" : "Rollout for all named targets",
"targetFilterQuery" : "id==targets-*",
@@ -2964,9 +3020,9 @@
{
"content" : [ {
"createdBy" : "bumlux",
- "createdAt" : 1564644166652,
+ "createdAt" : 1575375111387,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1564644166782,
+ "lastModifiedAt" : 1575375111478,
"name" : "group-1",
"description" : "group-1",
"successCondition" : {
@@ -2997,9 +3053,9 @@
"id" : 113
}, {
"createdBy" : "bumlux",
- "createdAt" : 1564644166654,
+ "createdAt" : 1575375111388,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1564644166783,
+ "lastModifiedAt" : 1575375111478,
"name" : "group-2",
"description" : "group-2",
"successCondition" : {
@@ -3030,9 +3086,9 @@
"id" : 114
}, {
"createdBy" : "bumlux",
- "createdAt" : 1564644166655,
+ "createdAt" : 1575375111388,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1564644166784,
+ "lastModifiedAt" : 1575375111480,
"name" : "group-3",
"description" : "group-3",
"successCondition" : {
@@ -3063,9 +3119,9 @@
"id" : 115
}, {
"createdBy" : "bumlux",
- "createdAt" : 1564644166657,
+ "createdAt" : 1575375111390,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1564644166785,
+ "lastModifiedAt" : 1575375111480,
"name" : "group-4",
"description" : "group-4",
"successCondition" : {
@@ -3096,9 +3152,9 @@
"id" : 116
}, {
"createdBy" : "bumlux",
- "createdAt" : 1564644166658,
+ "createdAt" : 1575375111391,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1564644166786,
+ "lastModifiedAt" : 1575375111481,
"name" : "group-5",
"description" : "group-5",
"successCondition" : {
@@ -3129,9 +3185,9 @@
"id" : 117
}, {
"createdBy" : "bumlux",
- "createdAt" : 1564644166659,
+ "createdAt" : 1575375111391,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1564644166787,
+ "lastModifiedAt" : 1575375111482,
"name" : "group-6",
"description" : "group-6",
"successCondition" : {
@@ -3162,9 +3218,9 @@
"id" : 118
}, {
"createdBy" : "bumlux",
- "createdAt" : 1564644166660,
+ "createdAt" : 1575375111392,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1564644166788,
+ "lastModifiedAt" : 1575375111482,
"name" : "group-7",
"description" : "group-7",
"successCondition" : {
@@ -3195,9 +3251,9 @@
"id" : 119
}, {
"createdBy" : "bumlux",
- "createdAt" : 1564644166661,
+ "createdAt" : 1575375111393,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1564644166789,
+ "lastModifiedAt" : 1575375111483,
"name" : "group-8",
"description" : "group-8",
"successCondition" : {
@@ -3228,9 +3284,9 @@
"id" : 120
}, {
"createdBy" : "bumlux",
- "createdAt" : 1564644166662,
+ "createdAt" : 1575375111394,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1564644166790,
+ "lastModifiedAt" : 1575375111483,
"name" : "group-9",
"description" : "group-9",
"successCondition" : {
@@ -3261,9 +3317,9 @@
"id" : 121
}, {
"createdBy" : "bumlux",
- "createdAt" : 1564644166663,
+ "createdAt" : 1575375111394,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1564644166791,
+ "lastModifiedAt" : 1575375111484,
"name" : "group-10",
"description" : "group-10",
"successCondition" : {
@@ -3589,9 +3645,9 @@
{
"createdBy" : "bumlux",
- "createdAt" : 1564644182519,
+ "createdAt" : 1575375112191,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1564644182628,
+ "lastModifiedAt" : 1575375112293,
"name" : "group-1",
"description" : "group-1",
"successCondition" : {
@@ -3918,14 +3974,14 @@
{
"content" : [ {
"createdBy" : "bumlux",
- "createdAt" : 1564644171915,
+ "createdAt" : 1575375111594,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1564644171915,
+ "lastModifiedAt" : 1575375111594,
"name" : "exampleTarget-00000",
"description" : "exampleTarget0",
"controllerId" : "exampleTarget-00000",
"updateStatus" : "unknown",
- "securityToken" : "ec332b452b9661ba156e12eed7ad3b5a",
+ "securityToken" : "3525f99ba0427b0bb90d1fd9d4f6e768",
"requestAttributes" : true,
"_links" : {
"self" : {
@@ -3934,14 +3990,14 @@
}
}, {
"createdBy" : "bumlux",
- "createdAt" : 1564644171916,
+ "createdAt" : 1575375111595,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1564644171916,
+ "lastModifiedAt" : 1575375111595,
"name" : "exampleTarget-00001",
"description" : "exampleTarget1",
"controllerId" : "exampleTarget-00001",
"updateStatus" : "unknown",
- "securityToken" : "4a4d756f0be0cef975d36ac300d682c2",
+ "securityToken" : "59dd0e26dd6ebeaca1528d2247f753f8",
"requestAttributes" : true,
"_links" : {
"self" : {
@@ -4066,7 +4122,7 @@
</div>
<div id="footer">
<div id="footer-text">
-Last updated 2018-06-21 11:05:51 +02:00
+Last updated 2019-04-23 14:00:53 +02:00
</div>
</div>
</body>
diff --git a/rest-api/rootcontroller-api-guide/index.html b/rest-api/rootcontroller-api-guide/index.html
index 4c5b4ac..c47940f 100644
--- a/rest-api/rootcontroller-api-guide/index.html
+++ b/rest-api/rootcontroller-api-guide/index.html
@@ -438,7 +438,7 @@
<div class="sect2">
<h3 id="_implementation_notes"><a class="link" href="#_implementation_notes">Implementation notes</a></h3>
<div class="paragraph">
-<p>This base resource can be regularly polled by the controller on the provisioning target or device in order to retrieve actions that need to be executed. Those are provided as a list of links to more detailed information about the action. The resource supports Etag based modification checks in order to save traffic. Note: deployments have to be confirmed in order to move on to the next action. Cancellations have to be confirmed or rejected.</p>
+<p>This base resource can be regularly polled by the controller on the provisioning target or device in order to retrieve actions that need to be executed. Those are provided as a list of links to give more detailed information about the action. Links are only available for initial configuration or open actions, respectively. The resource supports Etag based modification checks in order to save traffic. Note: deployments have to be confirmed in order to move on to the next action. Cancellations have to be confirmed or rejected.</p>
</div>
</div>
<div class="sect2">
@@ -535,7 +535,7 @@
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">_links.configData</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Object</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">configuration data as key/value list</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Link which is provided whenever the provisioning target or device is supposed to push its configuration data (aka. "controller attributes") to the server. Only shown for the initial configuration, after a successful update action, or if requested explicitly (e.g. via the management UI).</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
</tbody>
@@ -557,7 +557,7 @@
},
"_links" : {
"deploymentBase" : {
- "href" : "https://ddi-api.host.com/TENANT_ID/controller/v1/CONTROLLER_ID/deploymentBase/82?c=-2056072439"
+ "href" : "https://ddi-api.host.com/TENANT_ID/controller/v1/CONTROLLER_ID/deploymentBase/84?c=-2054225397"
},
"configData" : {
"href" : "https://ddi-api.host.com/TENANT_ID/controller/v1/CONTROLLER_ID/configData"
@@ -615,7 +615,7 @@
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">_links.configData</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Object</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">configuration data as key/value list</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Link which is provided whenever the provisioning target or device is supposed to push its configuration data (aka. "controller attributes") to the server. Only shown for the initial configuration, after a successful update action, or if requested explicitly (e.g. via the management UI).</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
</tbody>
@@ -637,7 +637,7 @@
},
"_links" : {
"cancelAction" : {
- "href" : "https://ddi-api.host.com/TENANT_ID/controller/v1/CONTROLLER_ID/cancelAction/80"
+ "href" : "https://ddi-api.host.com/TENANT_ID/controller/v1/CONTROLLER_ID/cancelAction/82"
},
"configData" : {
"href" : "https://ddi-api.host.com/TENANT_ID/controller/v1/CONTROLLER_ID/configData"
@@ -714,7 +714,7 @@
<h4 id="_curl_2"><a class="link" href="#_curl_2">Curl</a></h4>
<div class="listingblock">
<div class="content">
-<pre class="highlight"><code class="language-bash" data-lang="bash">$ curl 'https://ddi-api.host.com/TENANT_ID/controller/v1/CONTROLLER_ID/cancelAction/85' -i -X GET \
+<pre class="highlight"><code class="language-bash" data-lang="bash">$ curl 'https://ddi-api.host.com/TENANT_ID/controller/v1/CONTROLLER_ID/cancelAction/87' -i -X GET \
-H 'Accept: application/hal+json'</code></pre>
</div>
</div>
@@ -723,7 +723,7 @@
<h4 id="_request_url_2"><a class="link" href="#_request_url_2">Request URL</a></h4>
<div class="listingblock">
<div class="content">
-<pre class="highlight nowrap"><code class="language-http" data-lang="http">GET /TENANT_ID/controller/v1/CONTROLLER_ID/cancelAction/85 HTTP/1.1
+<pre class="highlight nowrap"><code class="language-http" data-lang="http">GET /TENANT_ID/controller/v1/CONTROLLER_ID/cancelAction/87 HTTP/1.1
Host: ddi-api.host.com
Accept: application/hal+json</code></pre>
</div>
@@ -809,9 +809,9 @@
Content-Type: application/hal+json;charset=UTF-8
{
- "id" : "85",
+ "id" : "87",
"cancelAction" : {
- "stopId" : "85"
+ "stopId" : "87"
}
}</code></pre>
</div>
@@ -884,10 +884,10 @@
<h4 id="_curl_3"><a class="link" href="#_curl_3">Curl</a></h4>
<div class="listingblock">
<div class="content">
-<pre class="highlight"><code class="language-bash" data-lang="bash">$ curl 'https://ddi-api.host.com/TENANT_ID/controller/v1/CONTROLLER_ID/cancelAction/88/feedback' -i -X POST \
+<pre class="highlight"><code class="language-bash" data-lang="bash">$ curl 'https://ddi-api.host.com/TENANT_ID/controller/v1/CONTROLLER_ID/cancelAction/90/feedback' -i -X POST \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
- "id" : "88",
+ "id" : "90",
"time" : "20140511T121314",
"status" : {
"result" : {
@@ -904,13 +904,13 @@
<h4 id="_request_url_3"><a class="link" href="#_request_url_3">Request URL</a></h4>
<div class="listingblock">
<div class="content">
-<pre class="highlight nowrap"><code class="language-http" data-lang="http">POST /TENANT_ID/controller/v1/CONTROLLER_ID/cancelAction/88/feedback HTTP/1.1
+<pre class="highlight nowrap"><code class="language-http" data-lang="http">POST /TENANT_ID/controller/v1/CONTROLLER_ID/cancelAction/90/feedback HTTP/1.1
Content-Length: 184
Host: ddi-api.host.com
Content-Type: application/json;charset=UTF-8
{
- "id" : "88",
+ "id" : "90",
"time" : "20140511T121314",
"status" : {
"result" : {
@@ -1251,7 +1251,7 @@
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">data</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Object</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">configuration data as key/value list</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Link which is provided whenever the provisioning target or device is supposed to push its configuration data (aka. "controller attributes") to the server. Only shown for the initial configuration, after a successful update action, or if requested explicitly (e.g. via the management UI).</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">X</p></td>
</tr>
@@ -1349,7 +1349,7 @@
<h4 id="_curl_5"><a class="link" href="#_curl_5">Curl</a></h4>
<div class="listingblock">
<div class="content">
-<pre class="highlight"><code class="language-bash" data-lang="bash">$ curl 'https://ddi-api.host.com/TENANT_ID/controller/v1/CONTROLLER_ID/deploymentBase/83?actionHistory=10' -i -X GET \
+<pre class="highlight"><code class="language-bash" data-lang="bash">$ curl 'https://ddi-api.host.com/TENANT_ID/controller/v1/CONTROLLER_ID/deploymentBase/85?actionHistory=10' -i -X GET \
-H 'Accept: application/hal+json'</code></pre>
</div>
</div>
@@ -1358,7 +1358,7 @@
<h4 id="_request_url_5"><a class="link" href="#_request_url_5">Request URL</a></h4>
<div class="listingblock">
<div class="content">
-<pre class="highlight nowrap"><code class="language-http" data-lang="http">GET /TENANT_ID/controller/v1/CONTROLLER_ID/deploymentBase/83?actionHistory=10 HTTP/1.1
+<pre class="highlight nowrap"><code class="language-http" data-lang="http">GET /TENANT_ID/controller/v1/CONTROLLER_ID/deploymentBase/85?actionHistory=10 HTTP/1.1
Host: ddi-api.host.com
Accept: application/hal+json</code></pre>
</div>
@@ -1606,155 +1606,106 @@
Content-Length: 7203
{
- "id" : "83",
+ "id" : "85",
"deployment" : {
"download" : "forced",
"update" : "forced",
"maintenanceWindow" : "available",
"chunks" : [ {
"part" : "bApp",
- "version" : "1.0.56",
+ "version" : "1.0.84",
"name" : "oneapplication",
"artifacts" : [ {
"filename" : "binary.tgz",
"hashes" : {
- "sha1" : "8a7392fdfb2ce521a1ddcc17dec89c991e7a76d7",
- "md5" : "b3e0fb6c0b8217586737bf125e0a290f",
- "sha256" : "67d7ed83397981d19a08dde1b0830c83723ba1b3d06b6596f3b5024d30f4c8ae"
+ "sha1" : "5c74de49835c1c33b3f53023d6cde111d11d7366",
+ "md5" : "032b8d8fe93b9dd73e21b71038e8c590",
+ "sha256" : "56201a455531a0acc90fe5666d25e3b09a9bf95e419a8aa2f41d74ce1e2e2c1d"
},
- "size" : 11,
+ "size" : 12,
"_links" : {
"download" : {
- "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/305/filename/binary.tgz"
+ "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/311/filename/binary.tgz"
},
"download-http" : {
- "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/305/filename/binary.tgz"
+ "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/311/filename/binary.tgz"
},
"md5sum-http" : {
- "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/305/filename/binary.tgz.MD5SUM"
+ "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/311/filename/binary.tgz.MD5SUM"
},
"md5sum" : {
- "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/305/filename/binary.tgz.MD5SUM"
+ "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/311/filename/binary.tgz.MD5SUM"
}
}
}, {
"filename" : "file.signature",
"hashes" : {
- "sha1" : "8a7392fdfb2ce521a1ddcc17dec89c991e7a76d7",
- "md5" : "b3e0fb6c0b8217586737bf125e0a290f",
- "sha256" : "67d7ed83397981d19a08dde1b0830c83723ba1b3d06b6596f3b5024d30f4c8ae"
+ "sha1" : "5c74de49835c1c33b3f53023d6cde111d11d7366",
+ "md5" : "032b8d8fe93b9dd73e21b71038e8c590",
+ "sha256" : "56201a455531a0acc90fe5666d25e3b09a9bf95e419a8aa2f41d74ce1e2e2c1d"
},
- "size" : 11,
+ "size" : 12,
"_links" : {
"download" : {
- "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/305/filename/file.signature"
+ "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/311/filename/file.signature"
},
"download-http" : {
- "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/305/filename/file.signature"
+ "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/311/filename/file.signature"
},
"md5sum-http" : {
- "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/305/filename/file.signature.MD5SUM"
+ "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/311/filename/file.signature.MD5SUM"
},
"md5sum" : {
- "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/305/filename/file.signature.MD5SUM"
+ "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/311/filename/file.signature.MD5SUM"
}
}
} ]
}, {
"part" : "jvm",
- "version" : "1.0.13",
+ "version" : "1.0.3",
"name" : "oneapp runtime",
"artifacts" : [ {
"filename" : "binary.tgz",
"hashes" : {
- "sha1" : "3be71354ef02334c31dfa9bce91cde1c6fc22115",
- "md5" : "5b0d83b772a785fc5d78e66e4e03528c",
- "sha256" : "5a5936a2d54f0d795eeeae60b7a6a4644c286f19dd220af688903a995c8b1898"
+ "sha1" : "1f32153e216d920f9d64f1ccb0fa9d9b6d78afae",
+ "md5" : "d98058461fcbd731aa294b5823353454",
+ "sha256" : "c732ca39001c48f1f7c0b17e0bcf3536a98f36d8cc57af25937afaa9fdcc135c"
},
- "size" : 15,
+ "size" : 11,
"_links" : {
"download" : {
- "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/306/filename/binary.tgz"
+ "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/312/filename/binary.tgz"
},
"download-http" : {
- "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/306/filename/binary.tgz"
+ "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/312/filename/binary.tgz"
},
"md5sum-http" : {
- "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/306/filename/binary.tgz.MD5SUM"
+ "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/312/filename/binary.tgz.MD5SUM"
},
"md5sum" : {
- "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/306/filename/binary.tgz.MD5SUM"
+ "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/312/filename/binary.tgz.MD5SUM"
}
}
}, {
"filename" : "file.signature",
"hashes" : {
- "sha1" : "3be71354ef02334c31dfa9bce91cde1c6fc22115",
- "md5" : "5b0d83b772a785fc5d78e66e4e03528c",
- "sha256" : "5a5936a2d54f0d795eeeae60b7a6a4644c286f19dd220af688903a995c8b1898"
- },
- "size" : 15,
- "_links" : {
- "download" : {
- "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/306/filename/file.signature"
- },
- "download-http" : {
- "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/306/filename/file.signature"
- },
- "md5sum-http" : {
- "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/306/filename/file.signature.MD5SUM"
- },
- "md5sum" : {
- "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/306/filename/file.signature.MD5SUM"
- }
- }
- } ]
- }, {
- "part" : "os",
- "version" : "1.0.6",
- "name" : "one Firmware",
- "artifacts" : [ {
- "filename" : "binary.tgz",
- "hashes" : {
- "sha1" : "e72107909de2b6dbb9b36141c64af58f3f95abe2",
- "md5" : "a61b237485ffdab37df7324bcb52a9e4",
- "sha256" : "0605827450ec3eba08322b8d91159100f012638d64c063d94831fe2013b1eb8f"
+ "sha1" : "1f32153e216d920f9d64f1ccb0fa9d9b6d78afae",
+ "md5" : "d98058461fcbd731aa294b5823353454",
+ "sha256" : "c732ca39001c48f1f7c0b17e0bcf3536a98f36d8cc57af25937afaa9fdcc135c"
},
"size" : 11,
"_links" : {
"download" : {
- "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/307/filename/binary.tgz"
+ "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/312/filename/file.signature"
},
"download-http" : {
- "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/307/filename/binary.tgz"
+ "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/312/filename/file.signature"
},
"md5sum-http" : {
- "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/307/filename/binary.tgz.MD5SUM"
+ "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/312/filename/file.signature.MD5SUM"
},
"md5sum" : {
- "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/307/filename/binary.tgz.MD5SUM"
- }
- }
- }, {
- "filename" : "file.signature",
- "hashes" : {
- "sha1" : "e72107909de2b6dbb9b36141c64af58f3f95abe2",
- "md5" : "a61b237485ffdab37df7324bcb52a9e4",
- "sha256" : "0605827450ec3eba08322b8d91159100f012638d64c063d94831fe2013b1eb8f"
- },
- "size" : 11,
- "_links" : {
- "download" : {
- "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/307/filename/file.signature"
- },
- "download-http" : {
- "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/307/filename/file.signature"
- },
- "md5sum-http" : {
- "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/307/filename/file.signature.MD5SUM"
- },
- "md5sum" : {
- "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/307/filename/file.signature.MD5SUM"
+ "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/312/filename/file.signature.MD5SUM"
}
}
} ],
@@ -1762,6 +1713,55 @@
"key" : "aMetadataKey",
"value" : "Metadata value as defined in software module"
} ]
+ }, {
+ "part" : "os",
+ "version" : "1.0.20",
+ "name" : "one Firmware",
+ "artifacts" : [ {
+ "filename" : "binary.tgz",
+ "hashes" : {
+ "sha1" : "5fcb2fcef539ba21b8583862f63bca902176cb1a",
+ "md5" : "19ae3ecf79b18a9541457d0e01233134",
+ "sha256" : "c0952a23bb4af93104c1b5e34ea445b78951c01800066084338be284dd870fc9"
+ },
+ "size" : 11,
+ "_links" : {
+ "download" : {
+ "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/313/filename/binary.tgz"
+ },
+ "download-http" : {
+ "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/313/filename/binary.tgz"
+ },
+ "md5sum-http" : {
+ "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/313/filename/binary.tgz.MD5SUM"
+ },
+ "md5sum" : {
+ "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/313/filename/binary.tgz.MD5SUM"
+ }
+ }
+ }, {
+ "filename" : "file.signature",
+ "hashes" : {
+ "sha1" : "5fcb2fcef539ba21b8583862f63bca902176cb1a",
+ "md5" : "19ae3ecf79b18a9541457d0e01233134",
+ "sha256" : "c0952a23bb4af93104c1b5e34ea445b78951c01800066084338be284dd870fc9"
+ },
+ "size" : 11,
+ "_links" : {
+ "download" : {
+ "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/313/filename/file.signature"
+ },
+ "download-http" : {
+ "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/313/filename/file.signature"
+ },
+ "md5sum-http" : {
+ "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/313/filename/file.signature.MD5SUM"
+ },
+ "md5sum" : {
+ "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/313/filename/file.signature.MD5SUM"
+ }
+ }
+ } ]
} ]
},
"actionHistory" : {
@@ -1789,28 +1789,28 @@
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">HTTP/1.1 200 OK
+Content-Length: 495
Content-Type: application/hal+json;charset=UTF-8
-Content-Length: 496
{
- "id" : "86",
+ "id" : "88",
"deployment" : {
"download" : "forced",
"update" : "skip",
"maintenanceWindow" : "unavailable",
"chunks" : [ {
- "part" : "jvm",
- "version" : "1.0.38",
- "name" : "oneapp runtime",
- "artifacts" : [ ]
- }, {
"part" : "bApp",
- "version" : "1.0.71",
+ "version" : "1.0.9",
"name" : "oneapplication",
"artifacts" : [ ]
}, {
+ "part" : "jvm",
+ "version" : "1.0.20",
+ "name" : "oneapp runtime",
+ "artifacts" : [ ]
+ }, {
"part" : "os",
- "version" : "1.0.88",
+ "version" : "1.0.74",
"name" : "one Firmware",
"artifacts" : [ ]
} ]
@@ -1886,11 +1886,11 @@
<h4 id="_curl_6"><a class="link" href="#_curl_6">Curl</a></h4>
<div class="listingblock">
<div class="content">
-<pre class="highlight"><code class="language-bash" data-lang="bash">$ curl 'https://ddi-api.host.com/TENANT_ID/controller/v1/CONTROLLER_ID/deploymentBase/84/feedback' -i -X POST \
+<pre class="highlight"><code class="language-bash" data-lang="bash">$ curl 'https://ddi-api.host.com/TENANT_ID/controller/v1/CONTROLLER_ID/deploymentBase/86/feedback' -i -X POST \
-H 'Content-Type: application/json;charset=UTF-8' \
-H 'Accept: application/hal+json' \
-d '{
- "id" : "84",
+ "id" : "86",
"time" : "20140511T121314",
"status" : {
"result" : {
@@ -1911,14 +1911,14 @@
<h4 id="_request_url_6"><a class="link" href="#_request_url_6">Request URL</a></h4>
<div class="listingblock">
<div class="content">
-<pre class="highlight nowrap"><code class="language-http" data-lang="http">POST /TENANT_ID/controller/v1/CONTROLLER_ID/deploymentBase/84/feedback HTTP/1.1
+<pre class="highlight nowrap"><code class="language-http" data-lang="http">POST /TENANT_ID/controller/v1/CONTROLLER_ID/deploymentBase/86/feedback HTTP/1.1
Content-Length: 250
Host: ddi-api.host.com
Content-Type: application/json;charset=UTF-8
Accept: application/hal+json
{
- "id" : "84",
+ "id" : "86",
"time" : "20140511T121314",
"status" : {
"result" : {
@@ -2124,7 +2124,7 @@
<h4 id="_curl_7"><a class="link" href="#_curl_7">Curl</a></h4>
<div class="listingblock">
<div class="content">
-<pre class="highlight"><code class="language-bash" data-lang="bash">$ curl 'https://ddi-api.host.com/TENANT_ID/controller/v1/CONTROLLER_ID/softwaremodules/318/artifacts' -i -X GET \
+<pre class="highlight"><code class="language-bash" data-lang="bash">$ curl 'https://ddi-api.host.com/TENANT_ID/controller/v1/CONTROLLER_ID/softwaremodules/323/artifacts' -i -X GET \
-H 'Accept: application/hal+json'</code></pre>
</div>
</div>
@@ -2133,7 +2133,7 @@
<h4 id="_request_url_7"><a class="link" href="#_request_url_7">Request URL</a></h4>
<div class="listingblock">
<div class="content">
-<pre class="highlight nowrap"><code class="language-http" data-lang="http">GET /TENANT_ID/controller/v1/CONTROLLER_ID/softwaremodules/318/artifacts HTTP/1.1
+<pre class="highlight nowrap"><code class="language-http" data-lang="http">GET /TENANT_ID/controller/v1/CONTROLLER_ID/softwaremodules/323/artifacts HTTP/1.1
Host: ddi-api.host.com
Accept: application/hal+json</code></pre>
</div>
@@ -2263,23 +2263,23 @@
[ {
"filename" : "binaryFile",
"hashes" : {
- "sha1" : "116c563c060b5bcad6ac6ff984cd1296781b0d45",
- "md5" : "5873ddc4e14c924c81e2f22c2ca0d050",
- "sha256" : "9c165676477947163e67585c17a59a7ed980689ee7872b25afa799d11f17f9b6"
+ "sha1" : "d4f62413897d7760e680377fd8987439191c0969",
+ "md5" : "a5861dc581c335b5bd0686b66e3d8e29",
+ "sha256" : "1e4438fdd390feb24a837bc6d25b29d398520110c03a9c4107372f1e63563d21"
},
"size" : 11,
"_links" : {
"download" : {
- "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/318/filename/binaryFile"
+ "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/323/filename/binaryFile"
},
"download-http" : {
- "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/318/filename/binaryFile"
+ "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/323/filename/binaryFile"
},
"md5sum-http" : {
- "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/318/filename/binaryFile.MD5SUM"
+ "href" : "http://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/323/filename/binaryFile.MD5SUM"
},
"md5sum" : {
- "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/318/filename/binaryFile.MD5SUM"
+ "href" : "https://link-to-cdn.com/api/v1/TENANT_ID/download/controller/CONTROLLER_ID/softwaremodules/323/filename/binaryFile.MD5SUM"
}
}
} ]</code></pre>
@@ -2392,7 +2392,7 @@
</div>
<div id="footer">
<div id="footer-text">
-Last updated 2019-04-23 14:00:53 +02:00
+Last updated 2019-11-08 15:42:25 +01:00
</div>
</div>
</body>
diff --git a/rest-api/targetfilters-api-guide/index.html b/rest-api/targetfilters-api-guide/index.html
index 0118272..9838f93 100644
--- a/rest-api/targetfilters-api-guide/index.html
+++ b/rest-api/targetfilters-api-guide/index.html
@@ -607,19 +607,20 @@
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">HTTP/1.1 200 OK
-Content-Length: 451
+Content-Length: 482
Content-Type: application/hal+json;charset=UTF-8
{
"content" : [ {
"createdBy" : "bumlux",
- "createdAt" : 1564644050389,
+ "createdAt" : 1575375100006,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1564644050398,
+ "lastModifiedAt" : 1575375100013,
"name" : "filter1",
"query" : "name==*",
"autoAssignDistributionSet" : 13,
"autoAssignActionType" : "forced",
+ "autoAssignWeight" : null,
"_links" : {
"self" : {
"href" : "https://management-api.host.com/rest/v1/targetfilters/2"
@@ -814,6 +815,12 @@
<td class="tableblock halign-left valign-top"><p class="tableblock">['forced', 'soft', 'downloadonly']</p></td>
</tr>
<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">autoAssignWeight</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Weight of the resulting Actions</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">createdAt</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Entity was originally created at (timestamp UTC in milliseconds)</p></td>
@@ -851,18 +858,19 @@
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">HTTP/1.1 201 Created
-Content-Length: 484
Content-Type: application/hal+json;charset=UTF-8
+Content-Length: 513
{
"createdBy" : "bumlux",
- "createdAt" : 1564644055537,
+ "createdAt" : 1575375100126,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1564644055537,
+ "lastModifiedAt" : 1575375100126,
"name" : "filter1",
"query" : "name==*",
"autoAssignDistributionSet" : null,
"autoAssignActionType" : null,
+ "autoAssignWeight" : null,
"_links" : {
"self" : {
"href" : "https://management-api.host.com/rest/v1/targetfilters/3"
@@ -1156,6 +1164,12 @@
<td class="tableblock halign-left valign-top"><p class="tableblock">['forced', 'soft', 'downloadonly']</p></td>
</tr>
<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">autoAssignWeight</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Weight of the resulting Actions</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">createdAt</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Entity was originally created at (timestamp UTC in milliseconds)</p></td>
@@ -1193,18 +1207,19 @@
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">HTTP/1.1 200 OK
+Content-Length: 515
Content-Type: application/hal+json;charset=UTF-8
-Content-Length: 486
{
"createdBy" : "bumlux",
- "createdAt" : 1564644065981,
+ "createdAt" : 1575375100388,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1564644066000,
+ "lastModifiedAt" : 1575375100392,
"name" : "filter1",
"query" : "name==*",
"autoAssignDistributionSet" : 14,
"autoAssignActionType" : "forced",
+ "autoAssignWeight" : null,
"_links" : {
"self" : {
"href" : "https://management-api.host.com/rest/v1/targetfilters/5"
@@ -1425,6 +1440,12 @@
<td class="tableblock halign-left valign-top"><p class="tableblock">['forced', 'soft', 'downloadonly']</p></td>
</tr>
<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">autoAssignWeight</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Weight of the resulting Actions</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">createdAt</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Entity was originally created at (timestamp UTC in milliseconds)</p></td>
@@ -1463,17 +1484,18 @@
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
-Content-Length: 506
+Content-Length: 535
{
"createdBy" : "bumlux",
- "createdAt" : 1564644060655,
+ "createdAt" : 1575375100220,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1564644060664,
+ "lastModifiedAt" : 1575375100231,
"name" : "newFilterName",
"query" : "attribute.hwRevision==2",
"autoAssignDistributionSet" : null,
"autoAssignActionType" : null,
+ "autoAssignWeight" : null,
"_links" : {
"self" : {
"href" : "https://management-api.host.com/rest/v1/targetfilters/4"
@@ -1722,25 +1744,25 @@
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">HTTP/1.1 200 OK
-Content-Length: 2374
Content-Type: application/hal+json;charset=UTF-8
+Content-Length: 2373
{
"createdBy" : "bumlux",
- "createdAt" : 1564644081602,
+ "createdAt" : 1575375100769,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1564644081611,
+ "lastModifiedAt" : 1575375100774,
"name" : "DS",
"description" : "The descption of the distribution set.",
"version" : "1.0",
"modules" : [ {
"createdBy" : "bumlux",
- "createdAt" : 1564644081561,
+ "createdAt" : 1575375100745,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1564644081696,
+ "lastModifiedAt" : 1575375100805,
"name" : "application",
"description" : "Description of the software module",
- "version" : "1.0.54",
+ "version" : "1.0.73",
"type" : "application",
"vendor" : "vendor Limited, California",
"deleted" : false,
@@ -1752,12 +1774,12 @@
"id" : 46
}, {
"createdBy" : "bumlux",
- "createdAt" : 1564644081569,
+ "createdAt" : 1575375100750,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1564644081644,
+ "lastModifiedAt" : 1575375100785,
"name" : "app runtime",
"description" : "Description of the software module",
- "version" : "1.0.57",
+ "version" : "1.0.89",
"type" : "runtime",
"vendor" : "vendor GmbH, Stuttgart, Germany",
"deleted" : false,
@@ -1769,12 +1791,12 @@
"id" : 47
}, {
"createdBy" : "bumlux",
- "createdAt" : 1564644081579,
+ "createdAt" : 1575375100755,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1564644081669,
+ "lastModifiedAt" : 1575375100795,
"name" : "Firmware",
"description" : "Description of the software module",
- "version" : "1.0.54",
+ "version" : "1.0.6",
"type" : "os",
"vendor" : "vendor Limited Inc, California",
"deleted" : false,
@@ -1881,7 +1903,8 @@
<pre class="highlight"><code class="language-bash" data-lang="bash">$ curl 'https://management-api.host.com/rest/v1/targetfilters/7/autoAssignDS' -i -X POST \
-H 'Content-Type: application/json' \
-d '{
- "id" : "15",
+ "weight" : 200,
+ "id" : 15,
"type" : "soft"
}'</code></pre>
</div>
@@ -1892,12 +1915,13 @@
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">POST /rest/v1/targetfilters/7/autoAssignDS HTTP/1.1
+Content-Length: 52
Content-Type: application/json
-Content-Length: 36
Host: management-api.host.com
{
- "id" : "15",
+ "weight" : 200,
+ "id" : 15,
"type" : "soft"
}</code></pre>
</div>
@@ -1946,7 +1970,7 @@
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">id</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">String</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Id of the distribution set.</p></td>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">X</p></td>
@@ -1958,6 +1982,13 @@
<td class="tableblock halign-left valign-top"><p class="tableblock">['forced', 'soft', 'downloadonly']</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">weight</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Weight of the resulting Actions</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">0 - 1000</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">when multi-assignment is enabled</p></td>
+</tr>
</tbody>
</table>
</div>
@@ -2013,6 +2044,12 @@
<td class="tableblock halign-left valign-top"><p class="tableblock">['forced', 'soft', 'downloadonly']</p></td>
</tr>
<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">autoAssignWeight</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Weight of the resulting Actions</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">createdAt</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Entity was originally created at (timestamp UTC in milliseconds)</p></td>
@@ -2050,18 +2087,19 @@
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">HTTP/1.1 200 OK
-Content-Length: 484
Content-Type: application/hal+json;charset=UTF-8
+Content-Length: 512
{
"createdBy" : "bumlux",
- "createdAt" : 1564644076311,
+ "createdAt" : 1575375100568,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1564644076419,
+ "lastModifiedAt" : 1575375100653,
"name" : "filter1",
"query" : "name==*",
"autoAssignDistributionSet" : 15,
"autoAssignActionType" : "soft",
+ "autoAssignWeight" : 200,
"_links" : {
"self" : {
"href" : "https://management-api.host.com/rest/v1/targetfilters/7"
@@ -2308,7 +2346,7 @@
</div>
<div id="footer">
<div id="footer-text">
-Last updated 2018-06-11 15:04:18 +02:00
+Last updated 2019-04-23 14:00:53 +02:00
</div>
</div>
</body>
diff --git a/rest-api/targets-api-guide/index.html b/rest-api/targets-api-guide/index.html
index 42762bc..55830bd 100644
--- a/rest-api/targets-api-guide/index.html
+++ b/rest-api/targets-api-guide/index.html
@@ -431,7 +431,8 @@
<li><a href="#_get_rest_v1_targets_targetid_actions_actionid">GET /rest/v1/targets/{targetId}/actions/{actionId}</a></li>
<li><a href="#_get_rest_v1_targets_targetid_actions_actionid_status">GET /rest/v1/targets/{targetId}/actions/{actionId}/status</a></li>
<li><a href="#_get_rest_v1_targets_targetid_assignedds">GET /rest/v1/targets/{targetId}/assignedDS</a></li>
-<li><a href="#_post_rest_v1_targets_targetid_assignedds">POST /rest/v1/targets/{targetId}/assignedDS</a></li>
+<li><a href="#_post_rest_v1_targets_targetid_assignedds_assign_single_distribution_set">POST /rest/v1/targets/{targetId}/assignedDS (assign single distribution set)</a></li>
+<li><a href="#_post_rest_v1_targets_targetid_assignedds_assign_multiple_distribution_sets">POST /rest/v1/targets/{targetId}/assignedDS (assign multiple distribution sets)</a></li>
<li><a href="#_get_rest_v1_targets_targetid_attributes">GET /rest/v1/targets/{targetId}/attributes</a></li>
<li><a href="#_get_rest_v1_targets_targetid_installedds">GET /rest/v1/targets/{targetId}/installedDS</a></li>
<li><a href="#_get_rest_v1_targets_targetid_metadata">GET /rest/v1/targets/{targetId}/metadata</a></li>
@@ -654,18 +655,18 @@
{
"content" : [ {
"createdBy" : "bumlux",
- "createdAt" : 1567757259926,
+ "createdAt" : 1575375135775,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757259942,
+ "lastModifiedAt" : 1575375135794,
"name" : "137",
"description" : "My name is 137",
"controllerId" : "137",
"updateStatus" : "in_sync",
- "lastControllerRequestAt" : 1567757259926,
- "installedAt" : 1567757259939,
+ "lastControllerRequestAt" : 1575375135774,
+ "installedAt" : 1575375135792,
"ipAddress" : "192.168.0.1",
"address" : "http://192.168.0.1",
- "securityToken" : "63a2992c898e0eceb14d1c315421a3fe",
+ "securityToken" : "8723720a4f227fafde56205d1add2a61",
"requestAttributes" : true,
"_links" : {
"self" : {
@@ -941,9 +942,9 @@
[ {
"createdBy" : "bumlux",
- "createdAt" : 1567757259692,
+ "createdAt" : 1575375135426,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757259692,
+ "lastModifiedAt" : 1575375135426,
"name" : "controllerId",
"description" : "test",
"controllerId" : "123456",
@@ -1361,23 +1362,23 @@
{
"createdBy" : "bumlux",
- "createdAt" : 1567757260825,
+ "createdAt" : 1575375136890,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757260840,
+ "lastModifiedAt" : 1575375136906,
"name" : "137",
"description" : "My name is 137",
"controllerId" : "137",
"updateStatus" : "in_sync",
- "lastControllerRequestAt" : 1567757260824,
- "installedAt" : 1567757260838,
+ "lastControllerRequestAt" : 1575375136889,
+ "installedAt" : 1575375136904,
"ipAddress" : "192.168.0.1",
"address" : "http://192.168.0.1",
"pollStatus" : {
- "lastRequestAt" : 1567757260824,
- "nextExpectedRequestAt" : 1567800460824,
+ "lastRequestAt" : 1575375136889,
+ "nextExpectedRequestAt" : 1575418336889,
"overdue" : false
},
- "securityToken" : "71a37bf7d41a3c5ec5bb195b8e1fe431",
+ "securityToken" : "e050e9f1a52a60dc7686d1fe92beac85",
"requestAttributes" : true,
"_links" : {
"self" : {
@@ -1767,20 +1768,20 @@
{
"createdBy" : "bumlux",
- "createdAt" : 1567757260056,
+ "createdAt" : 1575375135905,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757260080,
+ "lastModifiedAt" : 1575375135943,
"name" : "newTargetName",
"description" : "I've been updated",
"controllerId" : "137",
"updateStatus" : "in_sync",
- "lastControllerRequestAt" : 1567757260055,
- "installedAt" : 1567757260068,
+ "lastControllerRequestAt" : 1575375135904,
+ "installedAt" : 1575375135924,
"ipAddress" : "192.168.0.1",
"address" : "https://192.168.0.1",
"pollStatus" : {
- "lastRequestAt" : 1567757260055,
- "nextExpectedRequestAt" : 1567800460055,
+ "lastRequestAt" : 1575375135904,
+ "nextExpectedRequestAt" : 1575418335904,
"overdue" : false
},
"securityToken" : "2345678DGGDGFTDzztgf",
@@ -2056,6 +2057,12 @@
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">content[].weight</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Weight of the action showing the importance of the update.</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">content[].maintenanceWindow</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Object</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Separation of download and install by defining a maintenance window for the installation.</p></td>
@@ -2094,22 +2101,23 @@
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
-Content-Length: 411
+Content-Length: 431
{
"content" : [ {
"createdBy" : "bumlux",
- "createdAt" : 1567757260574,
+ "createdAt" : 1575375136619,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757260583,
+ "lastModifiedAt" : 1575375136628,
"type" : "update",
"status" : "finished",
+ "weight" : 600,
"_links" : {
"self" : {
- "href" : "https://management-api.host.com/rest/v1/targets/137/actions/69"
+ "href" : "https://management-api.host.com/rest/v1/targets/137/actions/71"
}
},
- "id" : 69,
+ "id" : 71,
"forceType" : "forced"
} ],
"total" : 1,
@@ -2123,29 +2131,30 @@
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">HTTP/1.1 200 OK
-Content-Length: 583
Content-Type: application/hal+json;charset=UTF-8
+Content-Length: 605
{
"content" : [ {
"createdBy" : "bumlux",
- "createdAt" : 1567757261470,
+ "createdAt" : 1575375137478,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757261535,
+ "lastModifiedAt" : 1575375137486,
"type" : "update",
"status" : "finished",
+ "weight" : 600,
"maintenanceWindow" : {
- "schedule" : "41 9 10 6 9 ? 2019",
+ "schedule" : "17 14 13 3 12 ? 2019",
"duration" : "00:01:00",
- "timezone" : "+02:00",
- "nextStartAt" : 1567757381000
+ "timezone" : "+01:00",
+ "nextStartAt" : 1575375257000
},
"_links" : {
"self" : {
- "href" : "https://management-api.host.com/rest/v1/targets/137/actions/73"
+ "href" : "https://management-api.host.com/rest/v1/targets/137/actions/75"
}
},
- "id" : 73,
+ "id" : 75,
"forceType" : "forced"
} ],
"total" : 1,
@@ -2221,7 +2230,7 @@
<h4 id="_curl_7"><a class="link" href="#_curl_7">Curl</a></h4>
<div class="listingblock">
<div class="content">
-<pre class="highlight"><code class="language-bash" data-lang="bash">$ curl 'https://management-api.host.com/rest/v1/targets/137/actions/63' -i -X PUT \
+<pre class="highlight"><code class="language-bash" data-lang="bash">$ curl 'https://management-api.host.com/rest/v1/targets/137/actions/65' -i -X PUT \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
"forceType" : "forced"
@@ -2233,7 +2242,7 @@
<h4 id="_request_url_7"><a class="link" href="#_request_url_7">Request URL</a></h4>
<div class="listingblock">
<div class="content">
-<pre class="highlight nowrap"><code class="language-http" data-lang="http">PUT /rest/v1/targets/137/actions/63 HTTP/1.1
+<pre class="highlight nowrap"><code class="language-http" data-lang="http">PUT /rest/v1/targets/137/actions/65 HTTP/1.1
Content-Length: 28
Content-Type: application/json;charset=UTF-8
Host: management-api.host.com
@@ -2393,23 +2402,23 @@
{
"createdBy" : "bumlux",
- "createdAt" : 1567757259825,
+ "createdAt" : 1575375135649,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757259834,
+ "lastModifiedAt" : 1575375135662,
"type" : "update",
"status" : "pending",
"_links" : {
"self" : {
- "href" : "https://management-api.host.com/rest/v1/targets/137/actions/63"
+ "href" : "https://management-api.host.com/rest/v1/targets/137/actions/65"
},
"distributionset" : {
- "href" : "https://management-api.host.com/rest/v1/distributionsets/70"
+ "href" : "https://management-api.host.com/rest/v1/distributionsets/72"
},
"status" : {
- "href" : "https://management-api.host.com/rest/v1/targets/137/actions/63/status?offset=0&limit=50&sort=id:DESC"
+ "href" : "https://management-api.host.com/rest/v1/targets/137/actions/65/status?offset=0&limit=50&sort=id:DESC"
}
},
- "id" : 63,
+ "id" : 65,
"forceType" : "forced"
}</code></pre>
</div>
@@ -2497,7 +2506,7 @@
<h4 id="_curl_8"><a class="link" href="#_curl_8">Curl</a></h4>
<div class="listingblock">
<div class="content">
-<pre class="highlight"><code class="language-bash" data-lang="bash">$ curl 'https://management-api.host.com/rest/v1/targets/137/actions/62' -i -X DELETE</code></pre>
+<pre class="highlight"><code class="language-bash" data-lang="bash">$ curl 'https://management-api.host.com/rest/v1/targets/137/actions/64' -i -X DELETE</code></pre>
</div>
</div>
</div>
@@ -2505,7 +2514,7 @@
<h4 id="_request_url_8"><a class="link" href="#_request_url_8">Request URL</a></h4>
<div class="listingblock">
<div class="content">
-<pre class="highlight nowrap"><code class="language-http" data-lang="http">DELETE /rest/v1/targets/137/actions/62 HTTP/1.1
+<pre class="highlight nowrap"><code class="language-http" data-lang="http">DELETE /rest/v1/targets/137/actions/64 HTTP/1.1
Host: management-api.host.com</code></pre>
</div>
</div>
@@ -2648,7 +2657,7 @@
<h4 id="_curl_9"><a class="link" href="#_curl_9">Curl</a></h4>
<div class="listingblock">
<div class="content">
-<pre class="highlight"><code class="language-bash" data-lang="bash">$ curl 'https://management-api.host.com/rest/v1/targets/137/actions/72' -i -X GET</code></pre>
+<pre class="highlight"><code class="language-bash" data-lang="bash">$ curl 'https://management-api.host.com/rest/v1/targets/137/actions/74' -i -X GET</code></pre>
</div>
</div>
</div>
@@ -2656,7 +2665,7 @@
<h4 id="_request_url_9"><a class="link" href="#_request_url_9">Request URL</a></h4>
<div class="listingblock">
<div class="content">
-<pre class="highlight nowrap"><code class="language-http" data-lang="http">GET /rest/v1/targets/137/actions/72 HTTP/1.1
+<pre class="highlight nowrap"><code class="language-http" data-lang="http">GET /rest/v1/targets/137/actions/74 HTTP/1.1
Host: management-api.host.com</code></pre>
</div>
</div>
@@ -2726,6 +2735,12 @@
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">weight</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Weight of the action showing the importance of the update.</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">lastModifiedBy</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">String</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Entity was last modified by User, AMQP-Controller, anonymous etc.)</p></td>
@@ -2811,29 +2826,30 @@
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">HTTP/1.1 200 OK
-Content-Length: 619
+Content-Length: 625
Content-Type: application/hal+json;charset=UTF-8
{
"createdBy" : "bumlux",
- "createdAt" : 1567757261276,
+ "createdAt" : 1575375137309,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757261285,
+ "lastModifiedAt" : 1575375137318,
"type" : "update",
"status" : "finished",
- "forceTime" : 1567757261271,
+ "forceTime" : 0,
+ "weight" : 600,
"_links" : {
"self" : {
- "href" : "https://management-api.host.com/rest/v1/targets/137/actions/72"
+ "href" : "https://management-api.host.com/rest/v1/targets/137/actions/74"
},
"distributionset" : {
- "href" : "https://management-api.host.com/rest/v1/distributionsets/79"
+ "href" : "https://management-api.host.com/rest/v1/distributionsets/81"
},
"status" : {
- "href" : "https://management-api.host.com/rest/v1/targets/137/actions/72/status?offset=0&limit=50&sort=id:DESC"
+ "href" : "https://management-api.host.com/rest/v1/targets/137/actions/74/status?offset=0&limit=50&sort=id:DESC"
}
},
- "id" : 72,
+ "id" : 74,
"forceType" : "timeforced"
}</code></pre>
</div>
@@ -2844,22 +2860,23 @@
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">HTTP/1.1 200 OK
-Content-Length: 779
Content-Type: application/hal+json;charset=UTF-8
+Content-Length: 787
{
"createdBy" : "bumlux",
- "createdAt" : 1567757259059,
+ "createdAt" : 1575375134485,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757259120,
+ "lastModifiedAt" : 1575375134595,
"type" : "update",
"status" : "finished",
- "forceTime" : 1567757259016,
+ "forceTime" : 0,
+ "weight" : 600,
"maintenanceWindow" : {
- "schedule" : "38 9 10 6 9 ? 2019",
+ "schedule" : "14 14 13 3 12 ? 2019",
"duration" : "00:01:00",
- "timezone" : "+02:00",
- "nextStartAt" : 1567757378000
+ "timezone" : "+01:00",
+ "nextStartAt" : 1575375254000
},
"_links" : {
"self" : {
@@ -3021,7 +3038,7 @@
<h4 id="_request_parameter_example_4"><a class="link" href="#_request_parameter_example_4">Request parameter example</a></h4>
<div class="listingblock">
<div class="content">
-<pre class="highlight nowrap"><code class="language-http" data-lang="http">GET /rest/v1/targets/137/actions/66/status?limit=10&sort=id:ASC&offset=0 HTTP/1.1
+<pre class="highlight nowrap"><code class="language-http" data-lang="http">GET /rest/v1/targets/137/actions/68/status?limit=10&sort=id:ASC&offset=0 HTTP/1.1
Host: management-api.host.com</code></pre>
</div>
</div>
@@ -3104,12 +3121,12 @@
"content" : [ {
"type" : "finished",
"messages" : [ null ],
- "reportedAt" : 1567757259258,
+ "reportedAt" : 1575375134775,
"id" : 31
}, {
"type" : "running",
"messages" : [ null ],
- "reportedAt" : 1567757259252,
+ "reportedAt" : 1575375134764,
"id" : 30
} ],
"total" : 2,
@@ -3348,63 +3365,63 @@
{
"createdBy" : "bumlux",
- "createdAt" : 1567757260429,
+ "createdAt" : 1575375136436,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757260432,
+ "lastModifiedAt" : 1575375136440,
"name" : "DS",
"description" : "The descption of the distribution set.",
"version" : "1.0",
"modules" : [ {
"createdBy" : "bumlux",
- "createdAt" : 1567757260423,
+ "createdAt" : 1575375136422,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757260439,
- "name" : "Firmware",
- "description" : "Description of the software module",
- "version" : "1.0.98",
- "type" : "os",
- "vendor" : "vendor Limited Inc, California",
- "deleted" : false,
- "_links" : {
- "self" : {
- "href" : "https://management-api.host.com/rest/v1/softwaremodules/232"
- }
- },
- "id" : 232
- }, {
- "createdBy" : "bumlux",
- "createdAt" : 1567757260418,
- "lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757260446,
+ "lastModifiedAt" : 1575375136467,
"name" : "application",
"description" : "Description of the software module",
- "version" : "1.0.19",
+ "version" : "1.0.4",
"type" : "application",
"vendor" : "vendor Limited, California",
"deleted" : false,
"_links" : {
"self" : {
- "href" : "https://management-api.host.com/rest/v1/softwaremodules/230"
+ "href" : "https://management-api.host.com/rest/v1/softwaremodules/236"
}
},
- "id" : 230
+ "id" : 236
}, {
"createdBy" : "bumlux",
- "createdAt" : 1567757260420,
+ "createdAt" : 1575375136425,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757260452,
+ "lastModifiedAt" : 1575375136450,
"name" : "app runtime",
"description" : "Description of the software module",
- "version" : "1.0.6",
+ "version" : "1.0.10",
"type" : "runtime",
"vendor" : "vendor GmbH, Stuttgart, Germany",
"deleted" : false,
"_links" : {
"self" : {
- "href" : "https://management-api.host.com/rest/v1/softwaremodules/231"
+ "href" : "https://management-api.host.com/rest/v1/softwaremodules/237"
}
},
- "id" : 231
+ "id" : 237
+ }, {
+ "createdBy" : "bumlux",
+ "createdAt" : 1575375136429,
+ "lastModifiedBy" : "bumlux",
+ "lastModifiedAt" : 1575375136459,
+ "name" : "Firmware",
+ "description" : "Description of the software module",
+ "version" : "1.0.78",
+ "type" : "os",
+ "vendor" : "vendor Limited Inc, California",
+ "deleted" : false,
+ "_links" : {
+ "self" : {
+ "href" : "https://management-api.host.com/rest/v1/softwaremodules/238"
+ }
+ },
+ "id" : 238
} ],
"requiredMigrationStep" : false,
"type" : "test_default_ds_type",
@@ -3412,21 +3429,21 @@
"deleted" : false,
"_links" : {
"self" : {
- "href" : "https://management-api.host.com/rest/v1/distributionsets/75"
+ "href" : "https://management-api.host.com/rest/v1/distributionsets/77"
},
"modules" : {
- "href" : "https://management-api.host.com/rest/v1/distributionsets/75/assignedSM?offset=0&limit=50{&sort}",
+ "href" : "https://management-api.host.com/rest/v1/distributionsets/77/assignedSM?offset=0&limit=50{&sort}",
"templated" : true
},
"type" : {
- "href" : "https://management-api.host.com/rest/v1/distributionsettypes/360"
+ "href" : "https://management-api.host.com/rest/v1/distributionsettypes/364"
},
"metadata" : {
- "href" : "https://management-api.host.com/rest/v1/distributionsets/75/metadata?offset=0&limit=50{&sort,q}",
+ "href" : "https://management-api.host.com/rest/v1/distributionsets/77/metadata?offset=0&limit=50{&sort,q}",
"templated" : true
}
},
- "id" : 75
+ "id" : 77
}</code></pre>
</div>
</div>
@@ -3489,7 +3506,7 @@
</div>
</div>
<div class="sect1">
-<h2 id="_post_rest_v1_targets_targetid_assignedds"><a class="link" href="#_post_rest_v1_targets_targetid_assignedds">POST /rest/v1/targets/{targetId}/assignedDS</a></h2>
+<h2 id="_post_rest_v1_targets_targetid_assignedds_assign_single_distribution_set"><a class="link" href="#_post_rest_v1_targets_targetid_assignedds_assign_single_distribution_set">POST /rest/v1/targets/{targetId}/assignedDS (assign single distribution set)</a></h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="_implementation_notes_12"><a class="link" href="#_implementation_notes_12">Implementation Notes</a></h3>
@@ -3498,7 +3515,7 @@
</div>
</div>
<div class="sect2">
-<h3 id="_asssin_distribution_set_to_target"><a class="link" href="#_asssin_distribution_set_to_target">Asssin distribution set to target</a></h3>
+<h3 id="_assign_distribution_set_to_target"><a class="link" href="#_assign_distribution_set_to_target">Assign distribution set to target</a></h3>
<div class="sect3">
<h4 id="_curl_12"><a class="link" href="#_curl_12">Curl</a></h4>
<div class="listingblock">
@@ -3508,10 +3525,10 @@
-d '{
"maintenanceWindow" : {
"duration" : "00:10:00",
- "schedule" : "39 47 11 6 9 ? 2019",
- "timezone" : "+02:00"
+ "schedule" : "14 52 14 3 12 ? 2019",
+ "timezone" : "+01:00"
},
- "forcetime" : 1567757259356,
+ "forcetime" : 1575375134918,
"id" : 68,
"type" : "timeforced"
}'</code></pre>
@@ -3581,13 +3598,6 @@
</thead>
<tbody>
<tr>
-<td class="tableblock halign-left valign-top"><p class="tableblock">forcetime</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">Forcetime in milliseconds.</p></td>
-<td class="tableblock halign-left valign-top"></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">X</p></td>
-</tr>
-<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">id</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The technical identifier of the entity</p></td>
@@ -3595,39 +3605,53 @@
<td class="tableblock halign-left valign-top"><p class="tableblock">X</p></td>
</tr>
<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">weight</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Importance of the assignment.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">0 - 1000</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">when multi-assignment is enabled</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">forcetime</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Forcetime in milliseconds.</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">maintenanceWindow</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Object</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Separation of download and install by defining a maintenance window for the installation.</p></td>
<td class="tableblock halign-left valign-top"></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">X</p></td>
+<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">maintenanceWindow.schedule</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">String</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Schedule for the maintenance window start in quartz cron notation, such as '0 15 10 * * ? 2018' for 10:15am every day during the year 2018.</p></td>
<td class="tableblock halign-left valign-top"></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">X</p></td>
+<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">maintenanceWindow.duration</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">String</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Duration of the window, such as '02:00:00' for 2 hours.</p></td>
<td class="tableblock halign-left valign-top"></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">X</p></td>
+<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">maintenanceWindow.timezone</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">String</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">A time-zone offset from Greenwich/UTC, such as '+02:00'.</p></td>
<td class="tableblock halign-left valign-top"></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">X</p></td>
+<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock">type</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">String</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">The type of the forcetime.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The type of the assignment.</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">['soft', 'forced','timeforced', 'downloadonly']</p></td>
-<td class="tableblock halign-left valign-top"><p class="tableblock">X</p></td>
+<td class="tableblock halign-left valign-top"></td>
</tr>
</tbody>
</table>
@@ -3637,17 +3661,17 @@
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">POST /rest/v1/targets/137/assignedDS HTTP/1.1
-Content-Length: 197
+Content-Length: 198
Content-Type: application/json;charset=UTF-8
Host: management-api.host.com
{
"maintenanceWindow" : {
"duration" : "00:10:00",
- "schedule" : "39 47 11 6 9 ? 2019",
- "timezone" : "+02:00"
+ "schedule" : "14 52 14 3 12 ? 2019",
+ "timezone" : "+01:00"
},
- "forcetime" : 1567757259356,
+ "forcetime" : 1575375134918,
"id" : 68,
"type" : "timeforced"
}</code></pre>
@@ -3806,30 +3830,37 @@
</div>
</div>
<div class="sect1">
-<h2 id="_get_rest_v1_targets_targetid_attributes"><a class="link" href="#_get_rest_v1_targets_targetid_attributes">GET /rest/v1/targets/{targetId}/attributes</a></h2>
+<h2 id="_post_rest_v1_targets_targetid_assignedds_assign_multiple_distribution_sets"><a class="link" href="#_post_rest_v1_targets_targetid_assignedds_assign_multiple_distribution_sets">POST /rest/v1/targets/{targetId}/assignedDS (assign multiple distribution sets)</a></h2>
<div class="sectionbody">
<div class="sect2">
<h3 id="_implementation_notes_13"><a class="link" href="#_implementation_notes_13">Implementation Notes</a></h3>
<div class="paragraph">
-<p>Handles the GET request of retrieving the attributes of a specific target. Reponse is a key/value list. Required Permission: READ_TARGET</p>
+<p>Handles the POST request for assigning multiple distribution sets to a specific target (only allowed id 'multi assignments' is enabled). Required Permission: READ_REPOSITORY and UPDATE_TARGET</p>
</div>
</div>
<div class="sect2">
-<h3 id="_get_attributes_of_target"><a class="link" href="#_get_attributes_of_target">Get attributes of target</a></h3>
+<h3 id="_assign_distribution_sets_to_target"><a class="link" href="#_assign_distribution_sets_to_target">Assign distribution sets to target</a></h3>
<div class="sect3">
<h4 id="_curl_13"><a class="link" href="#_curl_13">Curl</a></h4>
<div class="listingblock">
<div class="content">
-<pre class="highlight"><code class="language-bash" data-lang="bash">$ curl 'https://management-api.host.com/rest/v1/targets/137/attributes' -i -X GET</code></pre>
-</div>
-</div>
-</div>
-<div class="sect3">
-<h4 id="_request_url_13"><a class="link" href="#_request_url_13">Request URL</a></h4>
-<div class="listingblock">
-<div class="content">
-<pre class="highlight nowrap"><code class="language-http" data-lang="http">GET /rest/v1/targets/137/attributes HTTP/1.1
-Host: management-api.host.com</code></pre>
+<pre class="highlight"><code class="language-bash" data-lang="bash">$ curl 'https://management-api.host.com/rest/v1/targets/137/assignedDS' -i -X POST \
+ -H 'Content-Type: application/json;charset=UTF-8' \
+ -d '[ {
+ "maintenanceWindow" : {
+ "duration" : "00:10:00",
+ "schedule" : "15 52 14 3 12 ? 2019",
+ "timezone" : "+01:00"
+ },
+ "weight" : 500,
+ "forcetime" : 1575375135147,
+ "id" : 70,
+ "type" : "timeforced"
+}, {
+ "weight" : 800,
+ "id" : 69,
+ "type" : "forced"
+} ]'</code></pre>
</div>
</div>
</div>
@@ -3854,14 +3885,348 @@
</tbody>
</table>
</div>
+<div class="sect3">
+<h4 id="_request_query_parameter_5"><a class="link" href="#_request_query_parameter_5">Request query parameter</a></h4>
+<table class="tableblock frame-all grid-all spread">
+<colgroup>
+<col style="width: 50%;">
+<col style="width: 50%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Parameter</th>
+<th class="tableblock halign-left valign-top">Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>offline</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Offline update (set param to true) that is only reported but not managed by the service, e.g. defaults set in factory, manual updates or migrations from other update systems. A completed action is added to the history of the target(s). Target is set to IN_SYNC state as both assigend and installed DS are set. Note: only executed if the target has currently no running update.</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="sect3">
+<h4 id="_request_fields_5"><a class="link" href="#_request_fields_5">Request fields</a></h4>
+<table class="tableblock frame-all grid-all spread">
+<colgroup>
+<col style="width: 20%;">
+<col style="width: 20%;">
+<col style="width: 20%;">
+<col style="width: 20%;">
+<col style="width: 20%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Path</th>
+<th class="tableblock halign-left valign-top">Type</th>
+<th class="tableblock halign-left valign-top">Description</th>
+<th class="tableblock halign-left valign-top">Allowed Values</th>
+<th class="tableblock halign-left valign-top">Mandatory</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">[].id</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The technical identifier of the entity</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">X</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">[].weight</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Importance of the assignment.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">0 - 1000</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">when multi-assignment is enabled</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">[].forcetime</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Forcetime in milliseconds.</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">[].maintenanceWindow</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Object</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Separation of download and install by defining a maintenance window for the installation.</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">[].maintenanceWindow.schedule</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">String</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Schedule for the maintenance window start in quartz cron notation, such as '0 15 10 * * ? 2018' for 10:15am every day during the year 2018.</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">[].maintenanceWindow.duration</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">String</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Duration of the window, such as '02:00:00' for 2 hours.</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">[].maintenanceWindow.timezone</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">String</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">A time-zone offset from Greenwich/UTC, such as '+02:00'.</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">[].type</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">String</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The type of the assignment.</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="sect3">
+<h4 id="_request_url_13"><a class="link" href="#_request_url_13">Request URL</a></h4>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight nowrap"><code class="language-http" data-lang="http">POST /rest/v1/targets/137/assignedDS HTTP/1.1
+Content-Type: application/json;charset=UTF-8
+Content-Length: 276
+Host: management-api.host.com
+
+[ {
+ "maintenanceWindow" : {
+ "duration" : "00:10:00",
+ "schedule" : "15 52 14 3 12 ? 2019",
+ "timezone" : "+01:00"
+ },
+ "weight" : 500,
+ "forcetime" : 1575375135147,
+ "id" : 70,
+ "type" : "timeforced"
+}, {
+ "weight" : 800,
+ "id" : 69,
+ "type" : "forced"
+} ]</code></pre>
+</div>
+</div>
+</div>
</div>
<div class="sect2">
<h3 id="_response_status_200_11"><a class="link" href="#_response_status_200_11">Response (Status 200)</a></h3>
<div class="sect3">
+<h4 id="_response_fields_11"><a class="link" href="#_response_fields_11">Response fields</a></h4>
+<table class="tableblock frame-all grid-all spread">
+<colgroup>
+<col style="width: 25%;">
+<col style="width: 25%;">
+<col style="width: 25%;">
+<col style="width: 25%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Path</th>
+<th class="tableblock halign-left valign-top">Type</th>
+<th class="tableblock halign-left valign-top">Description</th>
+<th class="tableblock halign-left valign-top">Allowed Values</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">assigned</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Targets that now have this distribution set assigned.</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">alreadyAssigned</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Targets that had this distribution set already assigned (in "offline" case this includes targets that have arbitrary updates running)</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">assignedActions</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Array</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The newly created actions as a result of this assignment</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">assignedActions.[].id</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">ID of the action.</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">assignedActions.[]._links.self</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Object</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The link to the action.</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">total</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Number</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Overall assigned as part of this request.</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+</tbody>
+</table>
+</div>
+<div class="sect3">
<h4 id="_response_example_13"><a class="link" href="#_response_example_13">Response example</a></h4>
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">HTTP/1.1 200 OK
+Content-Length: 390
+Content-Type: application/hal+json;charset=UTF-8
+
+{
+ "alreadyAssigned" : 0,
+ "assignedActions" : [ {
+ "_links" : {
+ "self" : {
+ "href" : "https://management-api.host.com/rest/v1/targets/137/actions/63"
+ }
+ },
+ "id" : 63
+ }, {
+ "_links" : {
+ "self" : {
+ "href" : "https://management-api.host.com/rest/v1/targets/137/actions/62"
+ }
+ },
+ "id" : 62
+ } ],
+ "assigned" : 2,
+ "total" : 2
+}</code></pre>
+</div>
+</div>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_error_responses_13"><a class="link" href="#_error_responses_13">Error responses</a></h3>
+<table class="tableblock frame-all grid-all spread">
+<colgroup>
+<col style="width: 33%;">
+<col style="width: 33%;">
+<col style="width: 33%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">HTTP Status Code</th>
+<th class="tableblock halign-left valign-top">Reason</th>
+<th class="tableblock halign-left valign-top">Response Model</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>400 Bad Request</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Bad Request - e.g. invalid parameters or 'multi assignments' is disabled</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>401 Unauthorized</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The request requires user authentication.</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>403 Forbidden</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Insufficient permissions, entity is not allowed to be changed (i.e. read-only) or data volume restriction applies.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">See <a href="#error-body">Error body</a></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>404 Not Found</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Not Found Target.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">See <a href="#error-body">Error body</a></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>405 Method Not Allowed</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The http request method is not allowed on the resource.</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>406 Not Acceptable</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">In case accept header is specified and not application/json.</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>409 Conflict</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">E.g. in case an entity is created or modified by another user in another request at the same time. You may retry your modification request.</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">See <a href="#error-body">Error body</a></p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>415 Unsupported Media Type</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The request was attempt with a media-type which is not supported by the server for this resource.</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock"><code>429 Too Many Request</code></p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Too many requests. The server will refuse further attempts and the client has to wait another second.</p></td>
+<td class="tableblock halign-left valign-top"></td>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
+</div>
+<div class="sect1">
+<h2 id="_get_rest_v1_targets_targetid_attributes"><a class="link" href="#_get_rest_v1_targets_targetid_attributes">GET /rest/v1/targets/{targetId}/attributes</a></h2>
+<div class="sectionbody">
+<div class="sect2">
+<h3 id="_implementation_notes_14"><a class="link" href="#_implementation_notes_14">Implementation Notes</a></h3>
+<div class="paragraph">
+<p>Handles the GET request of retrieving the attributes of a specific target. Reponse is a key/value list. Required Permission: READ_TARGET</p>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_get_attributes_of_target"><a class="link" href="#_get_attributes_of_target">Get attributes of target</a></h3>
+<div class="sect3">
+<h4 id="_curl_14"><a class="link" href="#_curl_14">Curl</a></h4>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight"><code class="language-bash" data-lang="bash">$ curl 'https://management-api.host.com/rest/v1/targets/137/attributes' -i -X GET</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_request_url_14"><a class="link" href="#_request_url_14">Request URL</a></h4>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight nowrap"><code class="language-http" data-lang="http">GET /rest/v1/targets/137/attributes HTTP/1.1
+Host: management-api.host.com</code></pre>
+</div>
+</div>
+</div>
+<div class="sect3">
+<h4 id="_request_path_parameter_12"><a class="link" href="#_request_path_parameter_12">Request path parameter</a></h4>
+<table class="tableblock frame-all grid-all spread">
+<colgroup>
+<col style="width: 50%;">
+<col style="width: 50%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Parameter</th>
+<th class="tableblock halign-left valign-top">Description</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">targetId</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The technical identifier of the entity</p></td>
+</tr>
+</tbody>
+</table>
+</div>
+</div>
+<div class="sect2">
+<h3 id="_response_status_200_12"><a class="link" href="#_response_status_200_12">Response (Status 200)</a></h3>
+<div class="sect3">
+<h4 id="_response_example_14"><a class="link" href="#_response_example_14">Response example</a></h4>
+<div class="listingblock">
+<div class="content">
+<pre class="highlight nowrap"><code class="language-http" data-lang="http">HTTP/1.1 200 OK
Content-Type: application/hal+json;charset=UTF-8
Content-Length: 28
@@ -3874,7 +4239,7 @@
</div>
</div>
<div class="sect2">
-<h3 id="_error_responses_13"><a class="link" href="#_error_responses_13">Error responses</a></h3>
+<h3 id="_error_responses_14"><a class="link" href="#_error_responses_14">Error responses</a></h3>
<table class="tableblock frame-all grid-all spread">
<colgroup>
<col style="width: 33%;">
@@ -3933,7 +4298,7 @@
<h2 id="_get_rest_v1_targets_targetid_installedds"><a class="link" href="#_get_rest_v1_targets_targetid_installedds">GET /rest/v1/targets/{targetId}/installedDS</a></h2>
<div class="sectionbody">
<div class="sect2">
-<h3 id="_implementation_notes_14"><a class="link" href="#_implementation_notes_14">Implementation Notes</a></h3>
+<h3 id="_implementation_notes_15"><a class="link" href="#_implementation_notes_15">Implementation Notes</a></h3>
<div class="paragraph">
<p>Handles the GET request of retrieving the installed distribution set of an specific target. Required Permission: READ_TARGET</p>
</div>
@@ -3941,7 +4306,7 @@
<div class="sect2">
<h3 id="_get_installed_distribution_set_of_target"><a class="link" href="#_get_installed_distribution_set_of_target">Get installed distribution set of target</a></h3>
<div class="sect3">
-<h4 id="_curl_14"><a class="link" href="#_curl_14">Curl</a></h4>
+<h4 id="_curl_15"><a class="link" href="#_curl_15">Curl</a></h4>
<div class="listingblock">
<div class="content">
<pre class="highlight"><code class="language-bash" data-lang="bash">$ curl 'https://management-api.host.com/rest/v1/targets/137/installedDS' -i -X GET</code></pre>
@@ -3949,7 +4314,7 @@
</div>
</div>
<div class="sect3">
-<h4 id="_request_url_14"><a class="link" href="#_request_url_14">Request URL</a></h4>
+<h4 id="_request_url_15"><a class="link" href="#_request_url_15">Request URL</a></h4>
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">GET /rest/v1/targets/137/installedDS HTTP/1.1
@@ -3958,7 +4323,7 @@
</div>
</div>
<div class="sect3">
-<h4 id="_request_path_parameter_12"><a class="link" href="#_request_path_parameter_12">Request path parameter</a></h4>
+<h4 id="_request_path_parameter_13"><a class="link" href="#_request_path_parameter_13">Request path parameter</a></h4>
<table class="tableblock frame-all grid-all spread">
<colgroup>
<col style="width: 50%;">
@@ -3980,9 +4345,9 @@
</div>
</div>
<div class="sect2">
-<h3 id="_response_status_200_12"><a class="link" href="#_response_status_200_12">Response (Status 200)</a></h3>
+<h3 id="_response_status_200_13"><a class="link" href="#_response_status_200_13">Response (Status 200)</a></h3>
<div class="sect3">
-<h4 id="_response_fields_11"><a class="link" href="#_response_fields_11">Response fields</a></h4>
+<h4 id="_response_fields_12"><a class="link" href="#_response_fields_12">Response fields</a></h4>
<table class="tableblock frame-all grid-all spread">
<colgroup>
<col style="width: 25%;">
@@ -4093,72 +4458,72 @@
</table>
</div>
<div class="sect3">
-<h4 id="_response_example_14"><a class="link" href="#_response_example_14">Response example</a></h4>
+<h4 id="_response_example_15"><a class="link" href="#_response_example_15">Response example</a></h4>
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">HTTP/1.1 200 OK
+Content-Length: 2381
Content-Type: application/hal+json;charset=UTF-8
-Content-Length: 2379
{
"createdBy" : "bumlux",
- "createdAt" : 1567757260304,
+ "createdAt" : 1575375136248,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757260307,
+ "lastModifiedAt" : 1575375136252,
"name" : "DS",
"description" : "The descption of the distribution set.",
"version" : "1.0",
"modules" : [ {
"createdBy" : "bumlux",
- "createdAt" : 1567757260294,
+ "createdAt" : 1575375136222,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757260321,
- "name" : "app runtime",
- "description" : "Description of the software module",
- "version" : "1.0.38",
- "type" : "runtime",
- "vendor" : "vendor GmbH, Stuttgart, Germany",
- "deleted" : false,
- "_links" : {
- "self" : {
- "href" : "https://management-api.host.com/rest/v1/softwaremodules/228"
- }
- },
- "id" : 228
- }, {
- "createdBy" : "bumlux",
- "createdAt" : 1567757260291,
- "lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757260329,
+ "lastModifiedAt" : 1575375136263,
"name" : "application",
"description" : "Description of the software module",
- "version" : "1.0.7",
+ "version" : "1.0.71",
"type" : "application",
"vendor" : "vendor Limited, California",
"deleted" : false,
"_links" : {
"self" : {
- "href" : "https://management-api.host.com/rest/v1/softwaremodules/227"
+ "href" : "https://management-api.host.com/rest/v1/softwaremodules/233"
}
},
- "id" : 227
+ "id" : 233
}, {
"createdBy" : "bumlux",
- "createdAt" : 1567757260297,
+ "createdAt" : 1575375136226,
"lastModifiedBy" : "bumlux",
- "lastModifiedAt" : 1567757260315,
+ "lastModifiedAt" : 1575375136272,
+ "name" : "app runtime",
+ "description" : "Description of the software module",
+ "version" : "1.0.72",
+ "type" : "runtime",
+ "vendor" : "vendor GmbH, Stuttgart, Germany",
+ "deleted" : false,
+ "_links" : {
+ "self" : {
+ "href" : "https://management-api.host.com/rest/v1/softwaremodules/234"
+ }
+ },
+ "id" : 234
+ }, {
+ "createdBy" : "bumlux",
+ "createdAt" : 1575375136230,
+ "lastModifiedBy" : "bumlux",
+ "lastModifiedAt" : 1575375136282,
"name" : "Firmware",
"description" : "Description of the software module",
- "version" : "1.0.7",
+ "version" : "1.0.14",
"type" : "os",
"vendor" : "vendor Limited Inc, California",
"deleted" : false,
"_links" : {
"self" : {
- "href" : "https://management-api.host.com/rest/v1/softwaremodules/229"
+ "href" : "https://management-api.host.com/rest/v1/softwaremodules/235"
}
},
- "id" : 229
+ "id" : 235
} ],
"requiredMigrationStep" : false,
"type" : "test_default_ds_type",
@@ -4166,28 +4531,28 @@
"deleted" : false,
"_links" : {
"self" : {
- "href" : "https://management-api.host.com/rest/v1/distributionsets/74"
+ "href" : "https://management-api.host.com/rest/v1/distributionsets/76"
},
"modules" : {
- "href" : "https://management-api.host.com/rest/v1/distributionsets/74/assignedSM?offset=0&limit=50{&sort}",
+ "href" : "https://management-api.host.com/rest/v1/distributionsets/76/assignedSM?offset=0&limit=50{&sort}",
"templated" : true
},
"type" : {
- "href" : "https://management-api.host.com/rest/v1/distributionsettypes/356"
+ "href" : "https://management-api.host.com/rest/v1/distributionsettypes/360"
},
"metadata" : {
- "href" : "https://management-api.host.com/rest/v1/distributionsets/74/metadata?offset=0&limit=50{&sort,q}",
+ "href" : "https://management-api.host.com/rest/v1/distributionsets/76/metadata?offset=0&limit=50{&sort,q}",
"templated" : true
}
},
- "id" : 74
+ "id" : 76
}</code></pre>
</div>
</div>
</div>
</div>
<div class="sect2">
-<h3 id="_error_responses_14"><a class="link" href="#_error_responses_14">Error responses</a></h3>
+<h3 id="_error_responses_15"><a class="link" href="#_error_responses_15">Error responses</a></h3>
<table class="tableblock frame-all grid-all spread">
<colgroup>
<col style="width: 33%;">
@@ -4246,7 +4611,7 @@
<h2 id="_get_rest_v1_targets_targetid_metadata"><a class="link" href="#_get_rest_v1_targets_targetid_metadata">GET /rest/v1/targets/{targetId}/metadata</a></h2>
<div class="sectionbody">
<div class="sect2">
-<h3 id="_implementation_notes_15"><a class="link" href="#_implementation_notes_15">Implementation Notes</a></h3>
+<h3 id="_implementation_notes_16"><a class="link" href="#_implementation_notes_16">Implementation Notes</a></h3>
<div class="paragraph">
<p>Get a paged list of meta data for a target. Required permission: READ_REPOSITORY</p>
</div>
@@ -4254,7 +4619,7 @@
<div class="sect2">
<h3 id="_get_a_paged_list_of_meta_data"><a class="link" href="#_get_a_paged_list_of_meta_data">Get a paged list of meta data</a></h3>
<div class="sect3">
-<h4 id="_curl_15"><a class="link" href="#_curl_15">Curl</a></h4>
+<h4 id="_curl_16"><a class="link" href="#_curl_16">Curl</a></h4>
<div class="listingblock">
<div class="content">
<pre class="highlight"><code class="language-bash" data-lang="bash">$ curl 'https://management-api.host.com/rest/v1/targets/137/metadata' -i -X GET</code></pre>
@@ -4262,7 +4627,7 @@
</div>
</div>
<div class="sect3">
-<h4 id="_request_url_15"><a class="link" href="#_request_url_15">Request URL</a></h4>
+<h4 id="_request_url_16"><a class="link" href="#_request_url_16">Request URL</a></h4>
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">GET /rest/v1/targets/137/metadata HTTP/1.1
@@ -4271,7 +4636,7 @@
</div>
</div>
<div class="sect3">
-<h4 id="_request_path_parameter_13"><a class="link" href="#_request_path_parameter_13">Request path parameter</a></h4>
+<h4 id="_request_path_parameter_14"><a class="link" href="#_request_path_parameter_14">Request path parameter</a></h4>
<table class="tableblock frame-all grid-all spread">
<colgroup>
<col style="width: 50%;">
@@ -4292,7 +4657,7 @@
</table>
</div>
<div class="sect3">
-<h4 id="_request_query_parameter_5"><a class="link" href="#_request_query_parameter_5">Request query parameter</a></h4>
+<h4 id="_request_query_parameter_6"><a class="link" href="#_request_query_parameter_6">Request query parameter</a></h4>
<table class="tableblock frame-all grid-all spread">
<colgroup>
<col style="width: 50%;">
@@ -4335,9 +4700,9 @@
</div>
</div>
<div class="sect2">
-<h3 id="_response_status_200_13"><a class="link" href="#_response_status_200_13">Response (Status 200)</a></h3>
+<h3 id="_response_status_200_14"><a class="link" href="#_response_status_200_14">Response (Status 200)</a></h3>
<div class="sect3">
-<h4 id="_response_fields_12"><a class="link" href="#_response_fields_12">Response fields</a></h4>
+<h4 id="_response_fields_13"><a class="link" href="#_response_fields_13">Response fields</a></h4>
<table class="tableblock frame-all grid-all spread">
<colgroup>
<col style="width: 25%;">
@@ -4388,7 +4753,7 @@
</table>
</div>
<div class="sect3">
-<h4 id="_response_example_15"><a class="link" href="#_response_example_15">Response example</a></h4>
+<h4 id="_response_example_16"><a class="link" href="#_response_example_16">Response example</a></h4>
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">HTTP/1.1 200 OK
@@ -4417,7 +4782,7 @@
</div>
</div>
<div class="sect2">
-<h3 id="_error_responses_15"><a class="link" href="#_error_responses_15">Error responses</a></h3>
+<h3 id="_error_responses_16"><a class="link" href="#_error_responses_16">Error responses</a></h3>
<table class="tableblock frame-all grid-all spread">
<colgroup>
<col style="width: 33%;">
@@ -4471,7 +4836,7 @@
<h2 id="_post_rest_v1_targets_targetid_metadata"><a class="link" href="#_post_rest_v1_targets_targetid_metadata">POST /rest/v1/targets/{targetId}/metadata</a></h2>
<div class="sectionbody">
<div class="sect2">
-<h3 id="_implementation_notes_16"><a class="link" href="#_implementation_notes_16">Implementation Notes</a></h3>
+<h3 id="_implementation_notes_17"><a class="link" href="#_implementation_notes_17">Implementation Notes</a></h3>
<div class="paragraph">
<p>Create a list of meta data entries Required permissions: READ_REPOSITORY and UPDATE_TARGET</p>
</div>
@@ -4479,7 +4844,7 @@
<div class="sect2">
<h3 id="_create_a_list_of_meta_data_entries"><a class="link" href="#_create_a_list_of_meta_data_entries">Create a list of meta data entries</a></h3>
<div class="sect3">
-<h4 id="_curl_16"><a class="link" href="#_curl_16">CURL</a></h4>
+<h4 id="_curl_17"><a class="link" href="#_curl_17">CURL</a></h4>
<div class="listingblock">
<div class="content">
<pre class="highlight"><code class="language-bash" data-lang="bash">$ curl 'https://management-api.host.com/rest/v1/targets/137/metadata' -i -X POST \
@@ -4495,7 +4860,7 @@
</div>
</div>
<div class="sect3">
-<h4 id="_request_url_16"><a class="link" href="#_request_url_16">Request URL</a></h4>
+<h4 id="_request_url_17"><a class="link" href="#_request_url_17">Request URL</a></h4>
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">POST /rest/v1/targets/137/metadata HTTP/1.1
@@ -4514,7 +4879,7 @@
</div>
</div>
<div class="sect3">
-<h4 id="_request_path_parameter_14"><a class="link" href="#_request_path_parameter_14">Request path parameter</a></h4>
+<h4 id="_request_path_parameter_15"><a class="link" href="#_request_path_parameter_15">Request path parameter</a></h4>
<table class="tableblock frame-all grid-all spread">
<colgroup>
<col style="width: 50%;">
@@ -4535,7 +4900,7 @@
</table>
</div>
<div class="sect3">
-<h4 id="_request_fields_5"><a class="link" href="#_request_fields_5">Request fields</a></h4>
+<h4 id="_request_fields_6"><a class="link" href="#_request_fields_6">Request fields</a></h4>
<table class="tableblock frame-all grid-all spread">
<colgroup>
<col style="width: 20%;">
@@ -4573,9 +4938,9 @@
</div>
</div>
<div class="sect2">
-<h3 id="_response_status_200_14"><a class="link" href="#_response_status_200_14">Response (Status 200)</a></h3>
+<h3 id="_response_status_200_15"><a class="link" href="#_response_status_200_15">Response (Status 200)</a></h3>
<div class="sect3">
-<h4 id="_response_example_16"><a class="link" href="#_response_example_16">Response example</a></h4>
+<h4 id="_response_example_17"><a class="link" href="#_response_example_17">Response example</a></h4>
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">HTTP/1.1 201 Created
@@ -4594,7 +4959,7 @@
</div>
</div>
<div class="sect2">
-<h3 id="_error_responses_16"><a class="link" href="#_error_responses_16">Error responses</a></h3>
+<h3 id="_error_responses_17"><a class="link" href="#_error_responses_17">Error responses</a></h3>
<table class="tableblock frame-all grid-all spread">
<colgroup>
<col style="width: 33%;">
@@ -4663,7 +5028,7 @@
<h2 id="_delete_rest_v1_targets_targetid_metadata_metadatakey"><a class="link" href="#_delete_rest_v1_targets_targetid_metadata_metadatakey">DELETE /rest/v1/targets/{targetId}/metadata/{metadataKey}</a></h2>
<div class="sectionbody">
<div class="sect2">
-<h3 id="_implementation_notes_17"><a class="link" href="#_implementation_notes_17">Implementation Notes</a></h3>
+<h3 id="_implementation_notes_18"><a class="link" href="#_implementation_notes_18">Implementation Notes</a></h3>
<div class="paragraph">
<p>Delete a single meta data. Required permission: UPDATE_REPOSITORY</p>
</div>
@@ -4671,7 +5036,7 @@
<div class="sect2">
<h3 id="_delete_a_single_meta_data"><a class="link" href="#_delete_a_single_meta_data">Delete a single meta data</a></h3>
<div class="sect3">
-<h4 id="_curl_17"><a class="link" href="#_curl_17">CURL</a></h4>
+<h4 id="_curl_18"><a class="link" href="#_curl_18">CURL</a></h4>
<div class="listingblock">
<div class="content">
<pre class="highlight"><code class="language-bash" data-lang="bash">$ curl 'https://management-api.host.com/rest/v1/targets/137/metadata/knownKey' -i -X DELETE</code></pre>
@@ -4679,7 +5044,7 @@
</div>
</div>
<div class="sect3">
-<h4 id="_request_url_17"><a class="link" href="#_request_url_17">Request URL</a></h4>
+<h4 id="_request_url_18"><a class="link" href="#_request_url_18">Request URL</a></h4>
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">DELETE /rest/v1/targets/137/metadata/knownKey HTTP/1.1
@@ -4688,7 +5053,7 @@
</div>
</div>
<div class="sect3">
-<h4 id="_request_path_parameter_15"><a class="link" href="#_request_path_parameter_15">Request path parameter</a></h4>
+<h4 id="_request_path_parameter_16"><a class="link" href="#_request_path_parameter_16">Request path parameter</a></h4>
<table class="tableblock frame-all grid-all spread">
<colgroup>
<col style="width: 50%;">
@@ -4714,9 +5079,9 @@
</div>
</div>
<div class="sect2">
-<h3 id="_response_status_200_15"><a class="link" href="#_response_status_200_15">Response (Status 200)</a></h3>
+<h3 id="_response_status_200_16"><a class="link" href="#_response_status_200_16">Response (Status 200)</a></h3>
<div class="sect3">
-<h4 id="_response_example_17"><a class="link" href="#_response_example_17">Response example</a></h4>
+<h4 id="_response_example_18"><a class="link" href="#_response_example_18">Response example</a></h4>
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">HTTP/1.1 200 OK</code></pre>
@@ -4725,7 +5090,7 @@
</div>
</div>
<div class="sect2">
-<h3 id="_error_responses_17"><a class="link" href="#_error_responses_17">Error responses</a></h3>
+<h3 id="_error_responses_18"><a class="link" href="#_error_responses_18">Error responses</a></h3>
<table class="tableblock frame-all grid-all spread">
<colgroup>
<col style="width: 33%;">
@@ -4784,7 +5149,7 @@
<h2 id="_get_rest_v1_targets_targetid_metadata_metadatakey"><a class="link" href="#_get_rest_v1_targets_targetid_metadata_metadatakey">GET /rest/v1/targets/{targetId}/metadata/{metadataKey}</a></h2>
<div class="sectionbody">
<div class="sect2">
-<h3 id="_implementation_notes_18"><a class="link" href="#_implementation_notes_18">Implementation Notes</a></h3>
+<h3 id="_implementation_notes_19"><a class="link" href="#_implementation_notes_19">Implementation Notes</a></h3>
<div class="paragraph">
<p>Get a single meta data value for a meta data key. Required permission: READ_REPOSITORY</p>
</div>
@@ -4792,7 +5157,7 @@
<div class="sect2">
<h3 id="_get_a_single_meta_data_value"><a class="link" href="#_get_a_single_meta_data_value">Get a single meta data value</a></h3>
<div class="sect3">
-<h4 id="_curl_18"><a class="link" href="#_curl_18">Curl</a></h4>
+<h4 id="_curl_19"><a class="link" href="#_curl_19">Curl</a></h4>
<div class="listingblock">
<div class="content">
<pre class="highlight"><code class="language-bash" data-lang="bash">$ curl 'https://management-api.host.com/rest/v1/targets/137/metadata/knownKey' -i -X GET</code></pre>
@@ -4800,7 +5165,7 @@
</div>
</div>
<div class="sect3">
-<h4 id="_request_url_18"><a class="link" href="#_request_url_18">Request URL</a></h4>
+<h4 id="_request_url_19"><a class="link" href="#_request_url_19">Request URL</a></h4>
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">GET /rest/v1/targets/137/metadata/knownKey HTTP/1.1
@@ -4809,7 +5174,7 @@
</div>
</div>
<div class="sect3">
-<h4 id="_request_path_parameter_16"><a class="link" href="#_request_path_parameter_16">Request path parameter</a></h4>
+<h4 id="_request_path_parameter_17"><a class="link" href="#_request_path_parameter_17">Request path parameter</a></h4>
<table class="tableblock frame-all grid-all spread">
<colgroup>
<col style="width: 50%;">
@@ -4835,9 +5200,9 @@
</div>
</div>
<div class="sect2">
-<h3 id="_response_status_200_16"><a class="link" href="#_response_status_200_16">Response (Status 200)</a></h3>
+<h3 id="_response_status_200_17"><a class="link" href="#_response_status_200_17">Response (Status 200)</a></h3>
<div class="sect3">
-<h4 id="_response_fields_13"><a class="link" href="#_response_fields_13">Response fields</a></h4>
+<h4 id="_response_fields_14"><a class="link" href="#_response_fields_14">Response fields</a></h4>
<table class="tableblock frame-all grid-all spread">
<colgroup>
<col style="width: 25%;">
@@ -4870,7 +5235,7 @@
</table>
</div>
<div class="sect3">
-<h4 id="_response_example_18"><a class="link" href="#_response_example_18">Response example</a></h4>
+<h4 id="_response_example_19"><a class="link" href="#_response_example_19">Response example</a></h4>
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">HTTP/1.1 200 OK
@@ -4886,7 +5251,7 @@
</div>
</div>
<div class="sect2">
-<h3 id="_error_responses_18"><a class="link" href="#_error_responses_18">Error responses</a></h3>
+<h3 id="_error_responses_19"><a class="link" href="#_error_responses_19">Error responses</a></h3>
<table class="tableblock frame-all grid-all spread">
<colgroup>
<col style="width: 33%;">
@@ -4940,7 +5305,7 @@
<h2 id="_put_rest_v1_targets_targetid_metadata_metadatakey"><a class="link" href="#_put_rest_v1_targets_targetid_metadata_metadatakey">PUT /rest/v1/targets/{targetId}/metadata/{metadataKey}</a></h2>
<div class="sectionbody">
<div class="sect2">
-<h3 id="_implementation_notes_19"><a class="link" href="#_implementation_notes_19">Implementation Notes</a></h3>
+<h3 id="_implementation_notes_20"><a class="link" href="#_implementation_notes_20">Implementation Notes</a></h3>
<div class="paragraph">
<p>Update a single meta data value for speficic key. Required permission: UPDATE_REPOSITORY</p>
</div>
@@ -4948,7 +5313,7 @@
<div class="sect2">
<h3 id="_update_a_single_meta_data_value"><a class="link" href="#_update_a_single_meta_data_value">Update a single meta data value</a></h3>
<div class="sect3">
-<h4 id="_curl_19"><a class="link" href="#_curl_19">Curl</a></h4>
+<h4 id="_curl_20"><a class="link" href="#_curl_20">Curl</a></h4>
<div class="listingblock">
<div class="content">
<pre class="highlight"><code class="language-bash" data-lang="bash">$ curl 'https://management-api.host.com/rest/v1/targets/137/metadata/knownKey' -i -X PUT \
@@ -4961,7 +5326,7 @@
</div>
</div>
<div class="sect3">
-<h4 id="_request_url_19"><a class="link" href="#_request_url_19">Request URL</a></h4>
+<h4 id="_request_url_20"><a class="link" href="#_request_url_20">Request URL</a></h4>
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">PUT /rest/v1/targets/137/metadata/knownKey HTTP/1.1
@@ -4977,7 +5342,7 @@
</div>
</div>
<div class="sect3">
-<h4 id="_request_path_parameter_17"><a class="link" href="#_request_path_parameter_17">Request path parameter</a></h4>
+<h4 id="_request_path_parameter_18"><a class="link" href="#_request_path_parameter_18">Request path parameter</a></h4>
<table class="tableblock frame-all grid-all spread">
<colgroup>
<col style="width: 50%;">
@@ -5002,7 +5367,7 @@
</table>
</div>
<div class="sect3">
-<h4 id="_request_fields_6"><a class="link" href="#_request_fields_6">Request fields</a></h4>
+<h4 id="_request_fields_7"><a class="link" href="#_request_fields_7">Request fields</a></h4>
<table class="tableblock frame-all grid-all spread">
<colgroup>
<col style="width: 20%;">
@@ -5040,9 +5405,9 @@
</div>
</div>
<div class="sect2">
-<h3 id="_response_status_200_17"><a class="link" href="#_response_status_200_17">Response (Status 200)</a></h3>
+<h3 id="_response_status_200_18"><a class="link" href="#_response_status_200_18">Response (Status 200)</a></h3>
<div class="sect3">
-<h4 id="_response_fields_14"><a class="link" href="#_response_fields_14">Response fields</a></h4>
+<h4 id="_response_fields_15"><a class="link" href="#_response_fields_15">Response fields</a></h4>
<table class="tableblock frame-all grid-all spread">
<colgroup>
<col style="width: 25%;">
@@ -5075,7 +5440,7 @@
</table>
</div>
<div class="sect3">
-<h4 id="_response_example_19"><a class="link" href="#_response_example_19">Response example</a></h4>
+<h4 id="_response_example_20"><a class="link" href="#_response_example_20">Response example</a></h4>
<div class="listingblock">
<div class="content">
<pre class="highlight nowrap"><code class="language-http" data-lang="http">HTTP/1.1 200 OK
@@ -5091,7 +5456,7 @@
</div>
</div>
<div class="sect2">
-<h3 id="_error_responses_19"><a class="link" href="#_error_responses_19">Error responses</a></h3>
+<h3 id="_error_responses_20"><a class="link" href="#_error_responses_20">Error responses</a></h3>
<table class="tableblock frame-all grid-all spread">
<colgroup>
<col style="width: 33%;">
@@ -5210,7 +5575,7 @@
</div>
<div id="footer">
<div id="footer-text">
-Last updated 2019-08-20 15:06:10 +02:00
+Last updated 2019-10-24 12:32:01 +02:00
</div>
</div>
</body>
