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

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

Limites

Não é possível modifique o grupo de consumidores padrão fornecido pelo IoT Platform.
Cada conta Alibaba Cloud pode execute no máximo 5 consultas por segundo (QPS).

Nota
Os 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 que você chame 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

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	UpdateConsumerGroup	A operação que você deseja realizar. Defina o valor como UpdateConsumerGroup.
GroupId	String	Sim	nJRaJPn5U1JITGf******	O ID do grupo de consumidores. Após chamar a operação CreateConsumerGroup para crie um grupo de consumidores, o ID do grupo é retornado. É possível obter o ID do grupo de consumidores pelo nome chamando a operação QueryConsumerGroupList. Alternativamente, acesse o console do IoT Platform,e escolha Rules > Server-side Subscription > Consumer Groups para visualize o ID do grupo de consumidores.
NewGroupName	String	Sim	Consumer group 2	O novo nome do grupo de consumidores. O nome deve ter entre 4 e 30 caracteres e pode conter letras, dígitos e sublinhados (_).
IotInstanceId	String	Não	iot-cn-0pp1n8t****	O ID da instância. Visualize o ID da instância na página Overview do console do IoT Platform. Importante Se a sua instância possuir um ID, configure este parâmetro obrigatoriamente. A chamada falhará caso ele não seja defina. Caso a instância não tenha uma página Overview ou ID, não é necessário defina este parâmetro. Para mais informações, consulte Overview.

Além dos parâmetros específicos da operação listados 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

Parâmetro	Tipo	Exemplo	Descrição
Code	String	iot.system.SystemException	O código de erro retornado se a chamada falhar. Para mais informações, consulte Códigos de erro.
ErrorMessage	String	A system exception occurred.	A mensagem de erro retornada quando a chamada falha.
RequestId	String	73B9DF43-7780-47DE-8BED-077729D28BD2	O ID da solicitação.
Success	Boolean	true	Indica se a chamada foi bem-sucedida. true: A chamada teve sucesso. false: A chamada falhou.

Exemplos

Exemplos de solicitações

https://iot.cn-shanghai.aliyuncs.com/?Action=UpdateConsumerGroup
&GroupId=nJRaJPn5U1JITGf******
&GroupName=Consumer group 2
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

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.