Deletes a Message Queue for Apache RocketMQ instance.

Usage notes

You can call this operation when you need to deallocate resources. For example, after you unpublish an application, you can deallocate the resources that were used for the application.

An instance can be deleted only when the instance does not contain topics and groups.

Note After an instance is deleted, the instance cannot be recovered. Exercise caution when you call this operation.

QPS limit

Each Alibaba Cloud account can call this operation up to 10 times per second. If the number of requests that you send each second to call this operation exceeds the queries per second (QPS) limit, throttling is triggered. This may interrupt your business. For more information, see QPS limits.


By default, only Alibaba Cloud accounts can call this operation. A Resource Access Management (RAM) user can call this operation only after the RAM user is granted the required permissions. The following table describes the permissions that are required to call this operation. For more information, see Policies and examples.








Request parameters

Parameter Type Required Example Description
Action String Yes OnsInstanceDelete

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

InstanceId String Yes MQ_INST_188077086902****_BXSuW61e

The ID of the instance.

Response parameters

Parameter Type Example Description
RequestId String A07E3902-B92E-44A6-B6C5-6AA111111****

The ID of the request. This parameter is a common parameter. Each request has a unique ID. You can use this ID to troubleshoot issues.


Sample requests

&<Common request parameters>

Sample success responses

XML format

HTTP/1.1 200 OK


JSON format

HTTP/1.1 200 OK

  "RequestId" : "A07E3902-B92E-44A6-B6C5-6AA111111****"

Error codes

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

Delete an instance by using the console

Besides calling the OnsInstanceDelete operation, you can use the Message Queue for Apache RocketMQ console to delete an instance. For information about how to use the Message Queue for Apache RocketMQ console to delete an instance, see Manage instances.