OnsInstanceCreate - - Centro de documentación de Alibaba Cloud

Cree una instancia de Message Queue for Apache RocketMQ.

Notas de uso

Una instancia es una máquina virtual que almacena información sobre los topics y grupos de Message Queue for Apache RocketMQ. Llame a esta operación cuando necesite crear recursos de servicio para el negocio que desea publicar en una nueva versión. Antes de llamar a esta operación, tenga en cuenta los límites a continuación:

Se pueden desplegar un máximo de ocho instancias de Message Queue for Apache RocketMQ en cada región.
Esta operación solo permite crear una instancia Standard Edition. Desde la consola de Message Queue for Apache RocketMQ puede crear tanto una instancia Standard Edition como una Enterprise Platinum Edition. Para obtener más información sobre cómo crear una instancia de Message Queue for Apache RocketMQ, consulte Gestionar instancias.

Límite de QPS

Cada cuenta de Alibaba Cloud puede llamar a esta operación hasta 10 veces por segundo. Si el número de solicitudes enviadas por segundo supera el límite de consultas por segundo (QPS), se activa el estrangulamiento. Esto podría interrumpir su negocio. Para obtener más información, consulte Límites de QPS.

Autorización

De forma predeterminada, solo las cuentas de Alibaba Cloud pueden llamar a esta operación. Un usuario de Resource Access Management (RAM) solo puede llamar a esta operación después de que se le haya otorgado el permiso obligatorio. La tabla a continuación describe el permiso necesario para llamar a esta operación. Para obtener más información, consulte Políticas y ejemplos.

API	Acción	Recurso
OnsInstanceCreate	mq:CreateInstance	acs:mq:::*

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	OnsInstanceCreate	La operación que desea realizar. Establezca el valor en OnsInstanceCreate.
Remark	String	No	Description	La descripción de la instancia.
InstanceName	String	Sí	Test	El nombre de la instancia. Configure este parámetro según las reglas a continuación: El nombre de la instancia debe ser único en la región where se despliega. El nombre debe tener entre 3 y 64 caracteres de longitud y puede contener letras, dígitos, guiones (-), guiones bajos (_) y caracteres chinos.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
RequestId	String	A07E3902-B92E-44A6-B6C5-6AA111111****	El ID de la solicitud. Este es un parámetro común. Cada solicitud tiene un ID único que puede utilizar para solucionar problemas.
Data	Object		Los resultados devueltos.
InstanceId	String	MQ_INST_188077086902****_BXSuW61e	El ID de la instancia creada.
InstanceType	Integer	1	La edición de la instancia creada. Valor válido: 1: Standard Edition

Ejemplos

Solicitudes de ejemplo

http(s)://ons.cn-hangzhou.aliyuncs.com/?Action=OnsInstanceCreate
&InstanceName=Test
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

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

<OnsInstanceCreateResponse>
<Data>
    <InstanceId>MQ_INST_188077086902****_BXSuW61e</InstanceId>
    <InstanceType>1</InstanceType>
</Data>
<RequestId>A07E3902-B92E-44A6-B6C5-6AA111111****</RequestId>
</OnsInstanceCreateResponse>

Formato JSON

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

{
  "Data" : {
    "InstanceId" : "MQ_INST_188077086902****_BXSuW61e",
    "InstanceType" : 1
  },
  "RequestId" : "A07E3902-B92E-44A6-B6C5-6AA111111****"
}

Códigos de error

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

Crear una instancia mediante la consola

Además de llamar a la operación OnsInstanceCreate, puede usar la consola de Message Queue for Apache RocketMQ para crear una instancia. Para obtener información sobre cómo crear una instancia desde la consola de Message Queue for Apache RocketMQ, consulte Gestionar instancias.