Recent changes to CreateDeviceGroup

CreateDeviceGroup modified by Jim

Jim — Thu, 04 Jan 2018 09:49:15 -0000

--- v3
+++ v4
@@ -1,25 +1,21 @@
 ### Create new Device Group ###

-Creates one or more new device groups in the domain of the owner identified by the apikey. A device my be part of several groups and it is possible to add not yet existing devices to a group.
+Creates a new device groups in the domain of the owner identified by the apikey. A device my be part of several groups and it is possible to add not yet existing devices to a group.

 Path: cs-ws/resources/admin/devicegroup        Method: POST

 Parameters

 * apikey
+* overwrite true|false ... allows to overwrite existing groups

 Data

 ~~~~~~
-<devicegroups>
-    <devicegroup name="...">
-        <device_name>...</device_name>
-        <device_name>...</device_name>
-    </devicegroup>
-    <devicegroup name="...">
-        ...
-    </devicegroup>
-</devicegroups>
+<devicegroup name="...">
+    <device_name>...</device_name>
+    <device_name>...</device_name>
+</devicegroup>
 ~~~~~~

 Errors:

CreateDeviceGroup modified by Jim

Jim — Thu, 04 Jan 2018 09:28:54 -0000

--- v2
+++ v3
@@ -1,6 +1,6 @@
 ### Create new Device Group ###

-Creates one or more new device groups in the domain of the owner identified by the apikey. This service is called either by an admin application or by the device to create itself in the platform. A device my be part of several groups and it is possible to add not yet existing devices to a group.
+Creates one or more new device groups in the domain of the owner identified by the apikey. A device my be part of several groups and it is possible to add not yet existing devices to a group.

 Path: cs-ws/resources/admin/devicegroup        Method: POST

CreateDeviceGroup modified by Jim

Jim — Thu, 04 Jan 2018 09:15:47 -0000

--- v1
+++ v2
@@ -1,6 +1,6 @@
 ### Create new Device Group ###

-Creates one or more new device groups in the domain of the owner identified by the apikey. This service is called either by an admin application or by the device to create itself in the platform.
+Creates one or more new device groups in the domain of the owner identified by the apikey. This service is called either by an admin application or by the device to create itself in the platform. A device my be part of several groups and it is possible to add not yet existing devices to a group.

 Path: cs-ws/resources/admin/devicegroup        Method: POST

CreateDeviceGroup modified by Jim

Jim — Thu, 04 Jan 2018 09:13:42 -0000

Create new Device Group

Creates one or more new device groups in the domain of the owner identified by the apikey. This service is called either by an admin application or by the device to create itself in the platform.

Path: cs-ws/resources/admin/devicegroup Method: POST

Parameters

apikey

Data

<devicegroups>
    <devicegroup name="...">
        <device_name>...</device_name>
        <device_name>...</device_name>
    </devicegroup>
    <devicegroup name="...">
        ...
    </devicegroup>
</devicegroups>

Errors:

401 UNAUTHORIZED if key is invalid or not admin key
409 CONFLICT if devicegroup already exists

Example

POST http://localhost/cs-ws/resources/admin/devicegroup?apikey=1234 HTTP/1.1
<devicegroups>
    <devicegroup name="DevGroup1">
        <device_name>D1</device_name>
        <device_name>D3</device_name>
    </devicegroup>
</devicegroups>

HTTP/1.1 200 OK