OnsGroupCreate - - Centre de documentation Alibaba Cloud

Remarques sur l'utilisation

Lorsque vous déployez une nouvelle application ou mettez en œuvre une nouvelle logique métier, vous avez besoin de nouveaux groupes. Appelez cette opération pour créer un groupe.

Limites des requêtes

Chaque compte Alibaba Cloud peut appeler cette opération jusqu'à 10 fois par seconde. Si le nombre de requêtes envoyées pour appeler cette opération en une seconde atteint la limite, les nouvelles requêtes échouent. Cela risque d'interrompre vos activités commerciales. Pour connaître la limite de requêtes de chaque opération, consultez les Limites de débit des API.

Autorisation

Par défaut, seuls les comptes Alibaba Cloud peuvent appeler cette opération. Un utilisateur RAM (Resource Access Management) ne peut appeler cette opération qu'après avoir reçu les autorisations nécessaires. Le tableau ci-dessous décrit les autorisations qui doivent être accordées à un utilisateur RAM pour appeler cette opération. Pour savoir comment accorder des autorisations, consultez les Politiques et exemples.

API

Action

Resource

OnsGroupCreate

mq:QueryInstanceBaseInfo

mq:CreateGroup

acs:mq:::{instanceId}

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	OnsGroupCreate	L'opération que vous souhaitez effectuer. Définissez la valeur sur OnsGroupCreate.
GroupId	String	Yes	GID_test_groupId	L'ID du groupe que vous souhaitez créer. Spécifiez l'ID de groupe en respectant les règles suivantes : L'ID doit comporter entre 2 et 64 caractères et ne peut contenir que des lettres, des chiffres, des traits d'union (-) et des traits de soulignement (_). Si l'instance Message Queue for Apache RocketMQ dans laquelle vous souhaitez créer le groupe utilise un namespace, l'ID de groupe doit être unique au sein de l'instance. L'ID de groupe ne peut pas être identique à un ID de groupe ou à un nom de topic existant dans l'instance. L'ID de groupe peut être identique à un ID de groupe ou à un nom de topic dans une autre instance utilisant un namespace. Par exemple, si l'instance A et l'instance B utilisent des namespaces différents, un ID de groupe dans l'instance A peut être identique à un ID de groupe ou à un nom de topic dans l'instance B. Si l'instance n'utilise pas de namespace, l'ID de groupe doit être globalement unique dans toutes les instances et régions. L'ID de groupe ne peut pas être identique à un ID de groupe ou à un nom de topic existant dans les instances Message Queue for Apache RocketMQ de votre compte Alibaba Cloud. Remarque Une fois le groupe créé, l'ID de groupe ne peut pas être modifié. Pour vérifier si une instance utilise un namespace, connectez-vous à la console Message Queue for Apache RocketMQ, accédez à la page Instance Details, puis consultez la valeur du champ Namespace dans la section Basic Information.
Remark	String	No	test	La description du groupe.
InstanceId	String	Yes	MQ_INST_111111111111_DOxxxxxx	L'ID de l'instance Message Queue for Apache RocketMQ dans laquelle vous souhaitez créer le groupe.
GroupType	String	No	tcp	Le protocole via lequel les clients du groupe communiquent avec le broker Message Queue for Apache RocketMQ. Tous les clients d'un groupe communiquent avec le broker Message Queue for Apache RocketMQ via le même protocole. Vous devez créer des groupes distincts pour les clients TCP et les clients HTTP. Valeurs valides : tcp : Les clients du groupe publient ou reçoivent des messages via TCP. Il s'agit de la valeur par défaut. http : Les clients du groupe publient ou reçoivent des messages via HTTP.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	A07E3902-B92E-44A6-B6C5-6AA111111****	L'ID de la requête. Le système génère un ID unique pour chaque requête. Vous pouvez résoudre les problèmes en vous basant sur l'ID de requête.

Exemples

Exemples de requêtes

http(s)://ons.cn-hangzhou.aliyuncs.com/?Action=OnsGroupCreate
&GroupId=GID_test_groupId
&InstanceId=MQ_INST_111111111111_DOxxxxxx
&Remark=test
&GroupType=tcp
&<Common request parameters>

Exemples de réponses réussies

XML format

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

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

JSON format

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

{
  "RequestId" : "A07E3902-B92E-44A6-B6C5-6AA111111****"
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, visitez le Centre d'erreurs API.

Créer un groupe dans la console

Vous pouvez également créer un groupe dans la Message Queue for Apache RocketMQ console. Pour plus d'informations, consultez la rubrique Gérer les groupes.