Cloud Services API ReferenceIndustrial ScenariosIndustry SolutionsSaaS Basic Service of Commercial LightingLighting Group ManagementModify Custom Group

Modify Custom Group

Last Updated on : 2023-06-21 07:12:55download

Modify a custom group, including the group information and devices in the group.

API address

PUT: /v1.0/iot-02/lighting/groups/package

Request parameter

Description of body

Parameter name	Type	IN	Required	Description
spaceId	String	body	true	The ID of a specified space.
name	String	body	true	The name of a specified group.
groupPackageId	String	body	true	The ID of a specified custom group.
deviceIds	String[]	body	true	The list of device IDs that need to be changed. The device IDs that are already in the group will be deleted, and those not in the group will be added.
ownerId	String	body	false	The ID of a specified home group.
groupConfigs	String	body	false	The extension parameter.

Return parameter

Parameter name	Type	Description
groupPackageId	String	The ID of a specified custom group.
taskId	String	The number of device status. If the value of null is returned, the task is completed without showing the time-consuming operation.
expiredSeconds	long	The remaining seconds before the task expires. If the value of null is returned, the task is completed without showing the time-consuming operation.
groupIds	long[]	The ID of a specified device group.

Request example

PUT: /v1.0/iot-02/lighting/groups/package

{
  "spaceId": "146886924268113****",
  "name": "Custom Group 123456",
  "deviceIds": [
    "vdevo16400687183****"
  ],
  "ownerId": "4536****",
  "groupPackageId": "147564952996027****",
  "groupConfigs": "test-update"
}

Return example

{
    "result": {
        "expiredSeconds": 10,
        "groupPackageId": "147564952996027****",
        "taskId": "147565544970447****"
    },
    "t": 1640658650274,
    "success": true
}

Error code

For more information, see error code.

Prev DocLighting Group Management

Next DocCreate Custom Group