All Products
Search
Document Center

OnsTopicDelete

Last Updated: Sep 13, 2019

You can call this operation to delete specified topics under your account.

Description

This operation is called when resources are recycled, for example, when applications are deprecated. Resources must be recycled on the MQ backend after a topic is deleted. This process takes time. Therefore, we recommend that you do not create a topic immediately after deleting one. If the deletion failed, take measures based on the error code that is returned. When calling this operation, pay attention to the following:

  • By default, only primary accounts can call this operation. RAM sub-accounts can call this operation only after being authorized.

  • If a topic is deleted, all published subscriptions under the topic are cleared. Therefore, call this operation cautiously.

Request parameters

Name Type Required Description
PreventCache Long Yes The parameter used for CSRF verification, which can be set to the current system time. Unit: ms
InstanceId String No The ID of the instance.
Topic String Yes The topic you want to delete.

Response parameters

Name Type Description
RequestId String A common parameter. Each request has a unique ID for troubleshooting and location.
HelpUrl String A help link.

Examples

For more information about sample codes, see API sample code and endpoints.