You can call this operation to delete a Group ID.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | DeleteGroupId | The operation that you want to perform. Value: DeleteGroupId |
GroupId | String | Yes | GID_test | The Group ID that you want to delete. |
InstanceId | String | Yes | mqtt-cn-0pp1ldu automatic snapshot policies * | The ID of the instance to which the Group ID you want to delete belongs. |
Region ID | String | Yes | cn-hangzhou | The region of the instance to which the Group ID you want to delete belongs. |
Note For more information about these parameters, see Common parameters and Make API requests.
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | Cost | The ID of the request, which is a common parameter. Each request has a unique ID. |
Examples
Sample requests
http(s)://onsmqtt.cn-hangzhou.aliyuncs.com/? Action=DeleteGroupId
&GroupId=GID_test
&InstanceId=mqtt-cn-0pp1ldu static website hosting *
&RegionId=cn-hangzhou
&<Common request parameters>
Sample success responses
XML
format
<DeleteGroupIdResponse>
<RequestId>0621DDD7-F0E9-4D35-8900-518116D6AA58</RequestId>
</DeleteGroupIdResponse>
JSON
format
{
"RequestId": "0621DDD7-F0E9-4D35-8900-518116D6AA58"
}
Error codes
HTTP status code | Error | Error message | Description |
---|---|---|---|
500 | DeleteGroupIdError | Failed to delete GroupId. Try again later. | The request to delete a Group ID failed. Try again later. |
500 | InternalError | An error occurred while processing your request. Try again later. | The MQTT backend service is abnormal. Please try again. |
400 | ParameterFieldCheckFailed | Failed to validate the parameters. The parameters may be missing or invalid. | The parameter verification fails. This parameter may be missing or invalid. |
400 | PermissionCheckFailed | An error occurred while validating the resource permissions. Please check the account that created the instance, topic, and GroupId, and check their permission settings. | The error message returned because the resource permission verification failed. Check the instance, Topic, and Group ID for their permissions and authorization policies. |
400 | InstancePermissionCheckFailed | An error occurred while validating the permissions of the instance. Please verify the account that created the instance and its permissions settings. | The error message returned because the instance permission verification fails. Check the ownership and authorization policy of the MQTT instance. |
400 | InstanceNotFound | Failed to find the instance. The instanceId may be invalid. | Unable to find instance. |
400 | ResourcePermissionCheckFailed | An error occurred while validating the resource permissions. Please check the account that created the instance, topic, and GroupId, and check their permission settings. | The error message returned because the resource permission verification failed. Check the instance, Topic, and Group ID for their permissions and authorization policies. |
For a list of error codes, visit the API Error Center.