Deleting a Device Group
Typical Scenario
If a device group is no longer needed on the platform due to group changes, an application can call this API to delete a specified device group.
API Function
This API is used by an application to delete the configuration information about a device group by device group ID on the platform.
API Description
1 | void deleteDeviceGroup(String devGroupId, String accessAppId, String accessToken) throws NorthApiException
|
Parameter Description
| Parameter | Mandatory or Optional | Type | Location | Description |
|---|---|---|---|---|
| devGroupId | Mandatory | String | path | Identifies a device group. The value of this parameter is returned by the platform after the device group is added. |
| accessAppId | Optional | String | query | If the device group belongs to the current application, set this parameter to null. Otherwise, set this parameter to the ID of the authorized application. |
| accessToken | Mandatory | String | header | If the Periodically Refreshing a Token API is called, set this parameter to null. Otherwise, set this parameter to the accessToken obtained by the Authentication API. |
Response Parameters
void
Error Codes
| HTTP Status Code | Error Code | Error Description | Remarks |
|---|---|---|---|
| 200 | 100203 | The application does not exist. | The application does not exist. Recommended handling:
|
| 200 | 100217 | The application has not been authorized. | The application has not been authorized. Recommended handling: In scenarios where applications are not authorized, ensure that request parameter appId is null. |
| 200 | 100603 | The device group does not exist. | The device group does not exist. Recommended handling: Check whether the device group ID is correct. |
| 403 | 1010009 | The application calls the API at a frequency that exceeds the flow control threshold. | The application calls the API at a frequency that exceeds the flow control threshold (100 calls per minute by default). Recommended handling: Contact IoT platform maintenance personnel to adjust the flow control threshold or control the API call frequency. |
| 403 | 1010005 | Invalid access token or application ID. | The access token is invalid. Recommended handling: Check whether accessToken carried in the API request is correct. |
| 500 | 50252 | Internal server error. | An internal server error occurs. Recommended handling: An internal error occurs on the IoT platform. Contact IoT platform maintenance personnel. |
Last Article: Creating a Device Group
Next Article: Modifying a Device Group
Did this article solve your problem?
Thank you for your score！Your feedback would help us improve the website.