OnsInstanceCreate - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Une instance est une machine virtuelle (VM) qui stocke les informations relatives aux topics et aux groupes de Message Queue for Apache RocketMQ. Appelez cette opération pour créer les ressources de service nécessaires au déploiement de votre activité métier. Avant d'appeler cette opération, tenez compte des limites suivantes :

Vous pouvez déployer au maximum huit instances Message Queue for Apache RocketMQ par région.
Cette opération permet uniquement de créer une instance Standard Edition. Utilisez la console Message Queue for Apache RocketMQ pour créer une instance Standard Edition ou Enterprise Platinum Edition. Pour savoir comment créer une instance Message Queue for Apache RocketMQ, consultez la rubrique Manage instances.

Limite de QPS

Chaque compte Alibaba Cloud peut appeler cette opération jusqu'à 10 fois par seconde. Si le nombre de requêtes envoyées par seconde dépasse la limite de requêtes par seconde (QPS), un mécanisme de limitation du débit (throttling) se déclenche, ce qui peut interrompre votre activité. Pour plus d'informations, consultez la rubrique QPS limits.

Autorisation

Par défaut, seuls les comptes Alibaba Cloud peuvent appeler cette opération. Un utilisateur RAM (Resource Access Management) ne peut l'appeler qu'après avoir reçu l'autorisation requise. Le tableau ci-dessous décrit l'autorisation nécessaire pour appeler cette opération. Pour plus d'informations, consultez la rubrique Policies and examples.

API	Action	Resource
OnsInstanceCreate	mq:CreateInstance	acs:mq:::*

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	OnsInstanceCreate	L'action à effectuer. Définissez la valeur sur OnsInstanceCreate.
Remark	String	No	Description	La description de l'instance.
InstanceName	String	Yes	Test	Le nom de l'instance. Configurez ce paramètre en respectant les règles suivantes : Le nom de l'instance doit être unique dans la région où elle est déployée. Le nom doit comporter entre 3 et 64 caractères et peut contenir des lettres, des chiffres, des traits d'union (-), des traits de soulignement (_) et des caractères chinois.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	A07E3902-B92E-44A6-B6C5-6AA111111****	L'ID de la requête. Il s'agit d'un paramètre commun. Chaque requête possède un ID unique que vous pouvez utiliser pour le dépannage.
Data	Object		Les résultats renvoyés.
InstanceId	String	MQ_INST_188077086902****_BXSuW61e	L'ID de l'instance créée.
InstanceType	Integer	1	L'édition de l'instance créée. Valeur valide : 1 : Standard Edition

Exemples

Exemple de requête

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

Exemple de réponse réussie

Format 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>

Format JSON

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

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

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez le API Error Center.

Créer une instance via la console

Outre l'appel de l'opération OnsInstanceCreate, vous pouvez utiliser la console Message Queue for Apache RocketMQ pour créer une instance. Pour savoir comment créer une instance via la console Message Queue for Apache RocketMQ, consultez la rubrique Manage instances.