DeleteGroupId - - 阿里雲

Deletes a group ID from a ApsaraMQ forMQTT instance.

Note

Each successful call to the DeleteGroupId operation is calculated as a message transaction per second (TPS). This way, you are billed for the call. For more information, see Billing.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter	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 that you want to delete.
InstanceId	String	Yes	mqtt-cn-0pp1ldu****	The ID of the ApsaraMQ forMQTT instance to which the group ID belongs.
RegionId	String	Yes	cn-hangzhou	The region ID of the ApsaraMQ forMQTT instance to which the group ID belongs.

Note

For more information about these parameters, see Common parameters and Endpoints.

Response parameters

Parameter	Type	Example	Description
RequestId	String	0621DDD7-F0E9-4D35-8900-518116D6****	The ID of the request.

Examples

Sample requests

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

Sample success responses

XML format

<DeleteGroupIdResponse>
  <RequestId>0621DDD7-F0E9-4D35-8900-518116D6****</RequestId>
</DeleteGroupIdResponse>

JSON format

{
  "RequestId": "0621DDD7-F0E9-4D35-8900-518116D6****"
}

Error codes

HTTP status code	Error code	Error message	Description
500	DeleteGroupIdError	Failed to delete GroupId. Try again later.	The error message returned because the request to delete the group ID failed. Please try again.
500	InternalError	An error occurred while processing your request. Try again later.	The error message returned because an internal error occurred to the ApsaraMQ forMQTT instance. Please try again.
400	ParameterFieldCheckFailed	Failed to validate the parameters. The parameters may be missing or invalid.	The error message returned because parameter verification failed. 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 resource permission verification failed. Check the permissions 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.	The error message returned because instance permission verification failed. Check the ownership and authorization policy of the ApsaraMQ forMQTT instance.
400	InstanceNotFound	Failed to find the instance. The instanceId may be invalid.	The error message returned because the specified instance is not 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.	The error message returned because resource permission verification failed. Check the permissions and authorization policies of the instance, topic, and group ID.

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