Exclui um tópico.
Observações de uso
Chame esta operação para excluir um tópico e desalocar os recursos associados. Por exemplo, após desativar uma aplicação, exclua os tópicos que ela utilizava.
Após a exclusão, o backend do Message Queue for Apache RocketMQ desaloca os recursos correspondentes. Como esse processo pode levar tempo considerável, não crie imediatamente um novo tópico com o mesmo nome do item excluído. Se o sistema falhar ao excluir o tópico especificado, solucione o problema com base no código de erro retornado.
A exclusão do tópico remove todas as relações de publicação e assinatura associadas a ele. Tenha cautela ao executar esta operação.
Limite de solicitações
Cada conta Alibaba Cloud pode chamar esta operação até 10 vezes por segundo. Se o número de solicitações enviadas em 1 segundo atingir o limite, as novas requisições falharão, o que pode interromper seus serviços. Para mais informações sobre os limites de cada operação, consulte Limites de taxa da API.
Autorização
Por padrão, apenas contas Alibaba Cloud podem executar esta operação. Um usuário do Resource Access Management (RAM) precisa receber as permissões necessárias antes de chamá-la. A tabela a seguir detalha as permissões obrigatórias para o usuário RAM. Para saber como conceder permissões, consulte Políticas e exemplos.
|
API |
Action |
Recurso em uma instância com namespace |
Recurso em uma instância sem namespace |
|
OnsTopicDelete |
mq:QueryInstanceBaseInfo mq:DeleteTopic |
acs:mq:::{instanceId}%{topic} |
acs:mq:::{topic} |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Exemplo |
Descrição |
|
Action |
String |
Sim |
OnsTopicDelete |
A operação a ser executada. Defina o valor como OnsTopicDelete. |
|
Topic |
String |
Sim |
test |
O nome do tópico a ser excluído. |
|
InstanceId |
String |
Sim |
MQ_INST_188077086902****_BXSuW61e |
O ID da instância do Message Queue for Apache RocketMQ que contém o tópico especificado. |
Parâmetros de resposta
|
Parâmetro |
Tipo |
Exemplo |
Descrição |
|
RequestId |
String |
4189D4A6-231A-4028-8D89-F66A76C1**** |
O ID da solicitação. O sistema gera um ID exclusivo para cada requisição. Use esse identificador para solucionar problemas. |
Exemplos
Exemplos de solicitações
http(s)://ons.cn-zhangjiakou.aliyuncs.com/?Action=OnsTopicDelete
&InstanceId=MQ_INST_188077086902****_BXSuW61e
&Topic=test
&<Common request parameters>Exemplos de respostas de sucesso
Formato XML
HTTP/1.1 200 OK
Content-Type:application/xml
<OnsTopicDeleteResponse>
<RequestId>4189D4A6-231A-4028-8D89-F66A76C1****</RequestId>
</OnsTopicDeleteResponse>Formato JSON
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "4189D4A6-231A-4028-8D89-F66A76C1****"
}Códigos de erro
Para obter uma lista de códigos de erro, visite a Central de Erros da API.
Exclua um tópico no console
Também é possível excluir um tópico pelo Message Queue for Apache RocketMQ console. Para mais detalhes, consulte Gerencie tópicos.