V2.5 Remove Device from Device Group¶

Remove devices from device groups.

Request Format¶

POST https://{apigw-address}/connect-service/v2.5/deviceGroups?action=removeDeviceFromDeviceGroup

Request Parameters (URI)¶

Name	Location (Path/Query)	Mandatory/Optional	Data Type	Description
orgId	Query	Mandatory	String	The organization ID which the asset belongs to. How to get orgId>>

Request Parameters (Body)¶

Name	Mandatory/Optional	Data Type	Description
groupId	Mandatory	String	Device group ID
deviceIdentifier	Mandatory	Struct	See DeviceIdentifier Struct.

DeviceIdentifier Struct ¶

Name	Data Type	Description
assetId	String	The asset ID. How to get assetId>>
productKey	String	Product Key.
deviceKey	String	Device Key.

Response Parameters¶

Name	Data Type	Description
code	Number	Return code of a request.
msg	String	The explanation to the return code. Its value is `OK` if the request is
requestId	String	A unique ID to identify a request.
successSize	Integer	The number of sucessfully created devices.
totalSize	Integer	The total number of devices to be created.
data	Device Struct Array	For more information, see Device Struct.

Device Struct ¶

Name	Data Type	Description
code	number	Failed or succeeded to create an alert. 0: succeeded, -1: failed.
msg	String	Returns `OK` if successful. Other returned values indicate failure.
data	String	The information about creating device groups.

Samples¶

Request Sample¶

url: https://{apigw-address}/connect-service/v2.5/deviceGroups?action=removeDeviceFromDeviceGroup&orgId=yourOrgId&groupId=yourGroupId
method: POST

Return Sample¶

{
    "code": 0,
    "msg": "OK",
    "requestId": "requestId",
    "data": [
        {
            "code": 0,
            "msg": "OK",
            "data": "DeviceIdentifier(assetId=null, productKey=productKey, deviceKey=deviceKey)"
        }
    ],
    "successSize": 1,
    "totalSize": 1
}