Exclui um grupo.
Observações de uso
Chame esta operação para excluir um grupo e desalocar os recursos associados. Por exemplo, após desativar uma aplicação, exclua os grupos que ela utilizava.
Após a exclusão, o backend do Message Queue for Apache RocketMQ desaloca os recursos do grupo. Esse processo pode levar muito tempo. Não crie imediatamente um novo grupo com o mesmo nome do grupo excluído. Se o sistema falhar ao excluir o grupo especificado, solucione o problema com base no código de erro retornado.
Após a exclusão de um grupo, os consumidores pertencentes a ele param imediatamente de receber mensagens. Tenha cautela ao chamar esta operação.
Limite de solicitações
Cada conta Alibaba Cloud pode chamar esta operação até 10 vezes por segundo. Se a quantidade de solicitações enviadas em um segundo atingir esse limite, as novas solicitações falharão, o que pode interromper seus serviços. Para obter 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 chamar esta operação. Um usuário do Resource Access Management (RAM) só poderá chamá-la após receber as permissões necessárias. A tabela a seguir descreve as permissões obrigatórias para um usuário RAM chamar esta operação. 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 |
|
OnsGroupDelete |
mq:QueryInstanceBaseInfo mq:DeleteGroup |
acs:mq:::{instanceId}%{groupId} |
acs:mq:::{groupId} |
Parâmetros da solicitação
|
Parâmetro |
Tipo |
Obrigatório |
Exemplo |
Descrição |
|
Action |
String |
Sim |
OnsGroupDelete |
A operação a ser executada. Defina o valor como OnsGroupDelete. |
|
GroupId |
String |
Sim |
GID_test_groupId |
O ID do grupo de consumidores a ser excluído. |
|
InstanceId |
String |
Sim |
MQ_INST_111111111111_DOxxxxxx |
O ID da instância do Message Queue for Apache RocketMQ que contém o grupo especificado. |
Parâmetros de resposta
|
Parâmetro |
Tipo |
Exemplo |
Descrição |
|
RequestId |
String |
A07E3902-B92E-44A6-B6C5-6AA111111**** |
O ID da solicitação. O sistema gera um identificador único para cada solicitação. Use esse ID para solucionar problemas. |
Exemplos
Exemplos de solicitações
http(s)://ons.cn-hangzhou.aliyuncs.com/?Action=OnsGroupDelete
&GroupId=GID_test_groupId
&InstanceId=MQ_INST_111111111111_DOxxxxxx
&<Common request parameters>Exemplos de respostas de sucesso
Formato XML
HTTP/1.1 200 OK
Content-Type:application/xml
<OnsGroupDeleteResponse>
<RequestId>A07E3902-B92E-44A6-B6C5-6AA111111****</RequestId>
</OnsGroupDeleteResponse>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, acesse a Central de Erros da API.
Exclua um grupo no console
Também é possível excluir um grupo no Message Queue for Apache RocketMQ console. Para obter mais informações, consulte Gerencie grupos.