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

Observações de uso

Cada região aceita no máximo oito instâncias do Message Queue for Apache RocketMQ.

Limite de QPS

Cada conta Alibaba Cloud pode chamar esta operação até 10 vezes por segundo. Se as solicitações por segundo excederem o limite de consultas por segundo (QPS), o sistema acionará throttling, o que pode interromper seus serviços. Para obter mais informações, consulte Limites de QPS.

Autorização

Por padrão, apenas contas Alibaba Cloud podem chamar esta operação. Usuários do Resource Access Management (RAM) precisam das permissões necessárias para executar essa chamada. A tabela a seguir descreve as permissões obrigatórias. Para obter mais informações, consulte Políticas e exemplos.

API

Action

Resource

OnsInstanceUpdate

mq:QueryInstanceBaseInfo

mq:UpdateInstance

acs:mq:::{instanceId}

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Exemplo	Descrição
Action	String	Sim	OnsInstanceUpdate	Operação a ser executada. Defina o valor como OnsInstanceUpdate.
Remark	String	Não	Updateddescription	Nova descrição da instância. Sem esse parâmetro, a descrição permanece inalterada.
InstanceName	String	Sim	Updatedname	Novo nome da instância. Configure este parâmetro conforme as regras: O nome deve ser exclusivo na região de implantação da instância. Deve ter entre 3 e 64 caracteres, contendo letras, dígitos, hifens (-), sublinhados (_) ou caracteres chineses. Sem esse parâmetro, o nome da instância permanece inalterado.
InstanceId	String	Sim	MQ_INST_188077086902****_BXSuW61e	ID da instância cujo nome ou descrição será atualizado.

Parâmetros de resposta

Parâmetro	Tipo	Exemplo	Descrição
RequestId	String	A07E3902-B92E-44A6-B6C5-6AA111111****	ID da solicitação. Parâmetro comum com identificador exclusivo para solução de problemas.

Exemplos

Exemplos de solicitações

http(s)://ons.cn-hangzhou.aliyuncs.com/?Action=OnsInstanceUpdate
&InstanceId=MQ_INST_188077086902****_BXSuW61e
&InstanceName=Updatedname
&Remark=Updateddescription
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

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

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, visite a Central de Erros de API.

Atualize o nome e a descrição de uma instância pelo console

Além da operação OnsInstanceUpdate, use o console do Message Queue for Apache RocketMQ para atualizar o nome e a descrição da instância. Para detalhes sobre esse procedimento, consulte Gerencie instâncias.