DeleteGroupId

Updated at:
Copy as MD

Deletes a group ID.

Debug

You can call this operation in OpenAPI Explorer without manually calculating signatures. After a successful call, OpenAPI Explorer automatically generates SDK sample code.

Request parameters

Name Type Required Example Description
Action String Yes DeleteGroupId

The operation that you want to perform. Set the value to DeleteGroupId.

GroupId String Yes GID_test

The group ID to delete.

InstanceId String Yes mqtt-cn-0pp1ldu****

The ID of the instance to which the group ID belongs.

RegionId String Yes cn-hangzhou

The region where the instance resides.

Note For more information, see Common parameters and How to call an operation.

Returned data

Name Type Example Description
RequestId String 0621DDD7-F0E9-4D35-8900-518116D6AA58

The request ID.

Examples

Sample request

http(s)://onsmqtt.cn-hangzhou.aliyuncs.com/?Action=DeleteGroupId
&GroupId=GID_test
&InstanceId=mqtt-cn-0pp1ldu****
&RegionId=cn-hangzhou
&<Common request parameters>

Sample response

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 code Error message Description
500 DeleteGroupIdError Failed to delete GroupId. Try again later. The request to delete the group ID failed. Try again later.
500 InternalError An error occurred while processing your request. Try again later. An error occurred in the MQTT backend service. Try again.
400 ParameterFieldCheckFailed Failed to validate the parameters. The parameters may be missing or invalid. Parameter verification failed. A 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. Permission verification for the resource failed. Check the ownership and authorization policies of the instance, topic, and group ID.
400 InstancePermissionCheckFailed An error occurred while validating the permissions of the instance. Please verify the account that created the instance and its permissions settings. Permission verification for the instance failed. Confirm the ownership and authorization policies of the MQTT instance.
400 InstanceNotFound Failed to find the instance. The instanceId may be invalid. The instance cannot be found.
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. Permission verification for the resource failed. Check the ownership and authorization policies of the instance, topic, and group ID.

For a complete list of error codes, visit the Error Center.