OnsInstanceUpdate - - Centro de documentación de Alibaba Cloud

Actualice el nombre y la descripción de una instancia de Message Queue for Apache RocketMQ.

Notas de uso

Se puede desplegar un máximo de ocho instancias de Message Queue for Apache RocketMQ en cada región.

Límite de QPS

Cada cuenta de Alibaba Cloud puede invocar esta operación hasta 10 veces por segundo. Si la cantidad de solicitudes que envía cada segundo para invocar esta operación supera el límite de consultas por segundo (QPS), se activa el estrangulamiento. Esto podría interrumpir su servicio. Para obtener más información, consulte Límites de QPS.

Autorización

De forma predeterminada, solo las cuentas de Alibaba Cloud pueden invocar esta operación. Un usuario de Resource Access Management (RAM) puede invocar esta operación únicamente después de que se le hayan otorgado los permisos obligatorios. La siguiente tabla describe los permisos obligatorios para invocar esta operación. Para obtener más información, consulte Directivas y ejemplos.

API

Acción

Recurso

OnsInstanceUpdate

mq:QueryInstanceBaseInfo

mq:UpdateInstance

acs:mq:::{instanceId}

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	OnsInstanceUpdate	La operación que desea realizar. Establezca el valor en OnsInstanceUpdate.
Remark	String	No	Updateddescription	La descripción actualizada de la instancia. Si no configure este parámetro, la descripción de la instancia permanecerá sin cambios.
InstanceName	String	Sí	Updatedname	El nombre actualizado de la instancia. Configure este parámetro según las siguientes reglas: El nombre de la instancia debe ser único en la región where se despliega la instancia. El nombre debe tener entre 3 y 64 caracteres de longitud y puede contener letras, dígitos, guiones (-), guiones bajos (_) y caracteres chinos. Si no configure este parámetro, el nombre de la instancia permanecerá sin cambios.
InstanceId	String	Sí	MQ_INST_188077086902****_BXSuW61e	El ID de la instancia cuyo nombre o descripción desea actualizar.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	A07E3902-B92E-44A6-B6C5-6AA111111****	El ID de la solicitud. Este parámetro es un parámetro común. Cada solicitud tiene un ID único. Puede usar este ID para solucionar problemas.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

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 error

Para consultar una lista de códigos de error, visite el Centro de errores de API.

Actualice el nombre y la descripción de una instancia mediante la consola

Además de invocar la operación OnsInstanceUpdate, puede usar la consola de Message Queue for Apache RocketMQ para actualizar el nombre y la descripción de una instancia. Para obtener información sobre cómo usar la consola de Message Queue for Apache RocketMQ con este fin, consulte Gestionar instancias.