Todos os produtos
Search
Central de documentação

:OnsInstanceDelete

Última atualização: Jul 08, 2026

Exclui uma instância do Message Queue for Apache RocketMQ.

Observações de uso

Chame esta operação para liberar recursos. Por exemplo, após despublicar um aplicativo, libere os recursos que ele utilizava.

Só é possível excluir uma instância se ela não contiver tópicos nem grupos.

Nota

Não é possível recuperar uma instância excluída. Tenha cuidado ao chamar esta operação.

Limite de QPS

Cada conta Alibaba Cloud pode chamar esta operação até 10 vezes por segundo. Se a quantidade de requisições enviadas por segundo ultrapassar o limite de consultas por segundo (QPS), o sistema ativa o throttling, o que pode interromper seus serviços. Para mais detalhes, consulte Limites de QPS.

Autorização

Por padrão, apenas contas Alibaba Cloud podem chamar esta operação. Um usuário do Resource Access Management (RAM) precisa receber as permissões necessárias antes de executá-la. A tabela a seguir detalha as permissões exigidas. Para mais informações, consulte Políticas e exemplos.

API

Action

Resource

OnsInstanceDelete

mq:QueryInstanceBaseInfo

mq:DeleteInstance

acs:mq:::{instanceId}

Parâmetros da requisição

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

OnsInstanceDelete

A operação a ser executada. Defina o valor como OnsInstanceDelete.

InstanceId

String

Sim

MQ_INST_188077086902****_BXSuW61e

O ID da instância.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

A07E3902-B92E-44A6-B6C5-6AA111111****

O ID da requisição. Este parâmetro comum atribui um ID exclusivo a cada requisição, útil para solucionar problemas.

Exemplos

Exemplos de requisições

http(s)://ons.cn-hangzhou.aliyuncs.com/?Action=OnsInstanceDelete
&InstanceId=MQ_INST_188077086902****_BXSuW61e
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<OnsInstanceDeleteResponse>
<RequestId>A07E3902-B92E-44A6-B6C5-6AA111111****</RequestId>
</OnsInstanceDeleteResponse>

Formato JSON

HTTP/1.1 200 OK
Content-Type:application/json

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

Códigos de erro

Para obter uma lista de códigos de erro, visite a Central de Erros de API.

Exclua uma instância pelo console

Além de chamar a operação OnsInstanceDelete, você pode excluir uma instância diretamente pelo console do Message Queue for Apache RocketMQ. Para saber como executar esse procedimento no console, consulte Gerencie instâncias.