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

Limpa as mensagens acumuladas de um grupo de consumidores ao utilizar 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	ResetConsumerGroupPosition	A operação que você deseja realizar. Defina o valor como ResetConsumerGroupPosition.
GroupId	String	Sim	nJRaJPn5U1JITGf******	O ID do grupo de consumidores. Após chamar a operação CreateConsumerGroup para criar um grupo de consumidores, o ID do grupo é retornado. É possível obter o ID do grupo de consumidores pelo nome do grupo chamando 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	Não	iot-cn-0pp1n8t****	O ID da instância. Visualize o ID da instância na página Overview no console do IoT Platform. Importante Se a sua instância possuir um ID, configure este parâmetro obrigatoriamente. A chamada falhará caso este parâmetro não seja definido. Caso sua instância não tenha uma página Overview ou ID, não é necessário definir 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	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	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=ResetConsumerGroupPosition
&GroupId=nJRaJPn5U1JITGf******
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

Formato JSON

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

Códigos de erro

Para obter uma lista de códigos de erro, visite a Central de Erros de API.