All Products
Search
Document Center

ApsaraMQ for MQTT:DeleteGroupId

Last Updated:Mar 25, 2024

Deletes a group from an ApsaraMQ for MQTT instance.

Operation description

Each successful call to the DeleteGroupId operation increases the messaging transactions per second (TPS) by one. This affects the billing of your instance. For more information, see Billing rules.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
GroupIdstringYes

The ID of the group that you want to delete.

GID_test
InstanceIdstringYes

The ID of the ApsaraMQ for MQTT instance from which you want to delete a group.

mqtt-cn-0pp1ldu****
Note For information about other parameters, see Common parameters and Endpoints .

Response parameters

ParameterTypeDescriptionExample
object
RequestIdstring

The request ID. This parameter is a common parameter.

0621DDD7-F0E9-4D35-8900-518116D6****

Examples

Sample success responses

JSONformat

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

Error codes

HTTP status codeError codeError message
400ParameterFieldCheckFailedFailed to validate the parameters. The parameters may be missing or invalid.
400PermissionCheckFailedAn error occurred while validating the resource permissions. Please check the account that created the instance, topic, and GroupId, and check their permission settings.
400InstancePermissionCheckFailedAn error occurred while validating the permissions of the instance. Please verify the account that created the instance and its permissions settings.
400InstanceNotFoundFailed to find the instance. The instanceId may be invalid.
400ResourcePermissionCheckFailedAn error occurred while validating the resource permissions. Please check the account that created the instance, topic, and GroupId, and check their permission settings.
500DeleteGroupIdErrorFailed to delete GroupId. Try again later.
500InternalErrorAn error occurred while processing your request. Try again later.

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
No change history