DeleteConsumerGroup - IoT Platform: Central de Documentação do Alibaba Cloud

Exclui um grupo de consumidores ao configurar uma assinatura do lado do servidor AMQP.

Limites

Não é possível excluir o grupo de consumidores padrão fornecido pelo IoT Platform.
Caso o grupo de consumidores esteja associado a uma assinatura AMQP, desassocie-o antes da exclusão. Se a assinatura possuir vários grupos de consumidores, utilize a operação DeleteConsumerGroupSubscribeRelation para remover o grupo desejado. Quando houver apenas um grupo, chame a operação UpdateSubscribeRelation para alterá-lo ou a operação DeleteSubscribeRelation para excluir a assinatura inteira.
Cada conta Alibaba Cloud permite no máximo 5 consultas por segundo (QPS).

Nota
Usuários RAM de uma conta Alibaba Cloud compartilham a cota dessa conta.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parameter	Type	Required	Example	Description
Action	String	Yes	DeleteConsumerGroup	Operação a ser executada. Defina o valor como DeleteConsumerGroup.
GroupId	String	Yes	nJRaJPn5U1JITGf******	ID do grupo de consumidores. Após chamar a operação CreateConsumerGroup para criar um grupo, o sistema retorna seu ID. Para consultar o ID pelo nome do grupo, utilize a operação QueryConsumerGroupList. Alternativamente, acesse o console do IoT Platform,e escolha Rules > Server-side Subscription > Consumer Groups para visualizar o ID do grupo de consumidores.
IotInstanceId	String	No	iot-cn-0pp1n8t****	ID da instância. Visualize o ID da instância na página Overview do console do IoT Platform. Importante Se a instância possuir um ID, configure este parâmetro obrigatoriamente. A ausência deste valor causa falha na chamada. Caso a instância não tenha página de Overview ou ID, não é necessário definir este parâmetro. Para mais informações, consulte Overview.

Além dos parâmetros específicos descritos acima, especifique os parâmetros comuns de solicitação ao chamar esta operação. Para mais detalhes, consulte Parâmetros comuns de solicitação.

Parâmetros de resposta

Parameter	Type	Example	Description
Code	String	iot.system.SystemException	Código de erro retornado em caso de falha na chamada. Para mais informações, consulte Códigos de erro.
ErrorMessage	String	A system exception occurred.	Mensagem de erro retornada quando a chamada falha.
RequestId	String	73B9DF43-7780-47DE-8BED-077729D28BD2	ID da solicitação.
Success	Boolean	true	Indica se a chamada foi bem-sucedida. true: Chamada bem-sucedida. false: Falha na chamada.

Exemplos

Exemplo de solicitação

https://iot.cn-shanghai.aliyuncs.com/?Action=DeleteConsumerGroup
&GroupId=nJRaJPn5U1JITGf******
&<Common request parameters>

Exemplo de resposta de sucesso

Formato XML

<DeleteConsumerGroupResponse>
    <RequestId>73B9DF43-7780-47DE-8BED-077729D28BD2</RequestId>
    <Success>true</Success>
</DeleteConsumerGroupResponse>

Formato JSON

{
  "RequestId": "73B9DF43-7780-47DE-8BED-077729D28BD2",
  "Success": true
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o Centro de Erros de API.