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

Cria um grupo de consumidores necessário para uma assinatura do lado do servidor AMQP.

Limites

Cada conta Alibaba Cloud pode executar 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	CreateConsumerGroup	A operação a ser executada. Defina o valor como CreateConsumerGroup.
GroupName	String	Sim	Consumer group 1	Nome do grupo de consumidores. Deve ter entre 4 e 30 caracteres e pode conter letras, dígitos e sublinhados (_).
IotInstanceId	String	Não	iot-cn-0pp1n8t****	ID da instância. Visualize o ID da instância na página Overview no console do IoT Platform. Importante Se a instância tiver um ID, configure este parâmetro. Caso contrário, a chamada falhará. Se a instância não tiver uma página Overview ou ID, não é necessário definir este parâmetro. Para mais informações, consulte Visão geral.

Além dos parâmetros específicos desta operação, especifique também os parâmetros de solicitação comuns. Para mais informações, consulte Parâmetros de solicitação comuns.

Parâmetros de resposta

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

Exemplos

Exemplos de solicitações

https://iot.cn-shanghai.aliyuncs.com/?Action=CreateConsumerGroup
&GroupName=Consumer group 1
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<CreateConsumerGroupResponse>
    <GroupId>nJRaJPn5U1JITGf******</GroupId>
    <RequestId>73B9DF43-7780-47DE-8BED-077729D28BD2</RequestId>
    <Success>true</Success>
</CreateConsumerGroupResponse>

Formato JSON

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

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.