OnsGroupConsumerUpdate - : Central de Documentação do Alibaba Cloud

Observação

Use esta operação para definir se os consumidores de um grupo específico podem ler mensagens. Esse recurso é útil quando você precisa impedir a leitura de mensagens por consumidores de determinado grupo.

Limite de solicitações

Cada conta Alibaba Cloud pode chamar esta operação até 10 vezes por segundo. Se o volume de chamadas atingir esse limite em um segundo, as novas solicitações falharão e poderão interromper seus serviços. Para obter informações sobre os limites de cada operação, consulte Limites de solicitação de API.

Autorização

Por padrão, contas Alibaba Cloud têm permissão para chamar esta operação. Usuários do Resource Access Management (RAM) precisam receber as autorizações necessárias antes de executá-la. A tabela a seguir descreve as permissões obrigatórias para usuários RAM. Para saber como conceder permissões, consulte Políticas.

API

Action

Recurso em instância com namespace

Recurso em instância sem namespace

OnsGroupConsumerUpdate

mq:QueryInstanceBaseInfo

mq:UpdateGroupConsumer

acs:mq:::{instanceId}%{groupId}

acs:mq:::{groupId}

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	OnsGroupConsumerUpdate	Operação a ser executada. Defina o valor como OnsGroupConsumerUpdate.
GroupId	String	Sim	GID_test_groupId	ID do grupo de consumidores cujas permissões de leitura você deseja configurar.
ReadEnable	Boolean	Sim	true	Define se o grupo de consumidores tem autorização para ler mensagens. Valores válidos: true: O grupo de consumidores pode ler mensagens. false: O grupo de consumidores não pode ler mensagens. Valor padrão: true.
InstanceId	String	Sim	MQ_INST_111111111111_DOxxxxxx	ID da instância do Message Queue for Apache RocketMQ que contém o grupo de consumidores especificado.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	A07E3902-B92E-44A6-B6C5-6AA111111****	ID da solicitação. O sistema gera um ID exclusivo para cada solicitação. Use esse ID para solucionar problemas.

Exemplos

Exemplos de solicitações

http(s)://ons.cn-hangzhou.aliyuncs.com/?Action=OnsGroupConsumerUpdate
&GroupId=GID_test_groupId
&InstanceId=MQ_INST_111111111111_DOxxxxxx
&ReadEnable=true
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

HTTP/1.1 200 OK
Content-Type:application/xml

<OnsGroupConsumerUpdateResponse>
<RequestId>A07E3902-B92E-44A6-B6C5-6AA111111****</RequestId>
</OnsGroupConsumerUpdateResponse>

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 de API.