OnsTopicCreate - - Centre de documentation Alibaba Cloud

Notes d'utilisation

Appelez cette opération pour créer un topic afin de répondre à vos besoins métier lors du déploiement d'une nouvelle application ou de l'extension de votre activité.

Limites de requêtes

Chaque compte Alibaba Cloud peut appeler cette opération jusqu'à 10 fois par seconde. Si le nombre de requêtes envoyées en une seconde atteint la limite, les nouvelles requêtes échouent, ce qui peut interrompre votre activité. Pour plus d'informations sur les limites de débit de chaque opération, consultez 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 créer un topic via cette opération qu'après avoir reçu les autorisations requises. Le tableau suivant décrit les autorisations à accorder à un utilisateur RAM pour appeler cette opération. Pour savoir comment accorder des autorisations, consultez Politiques et exemples.

API

Action

Resource in an instance that uses a namespace

Resource in an instance that does not use a namespace

OnsTopicCreate

mq:QueryInstanceBaseInfo

mq:CreateTopic

acs:mq:*:*:{instanceId}%{topic}

acs:mq:*:*:{topic}

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	OnsTopicCreate	L'opération à effectuer. Définissez la valeur sur OnsTopicCreate.
Topic	String	Yes	test	Le nom du topic à créer. Il doit respecter les règles suivantes : Le nom doit comporter entre 3 et 64 caractères et peut contenir des lettres, des chiffres, des traits d'union (-) et des traits de soulignement (_). Le nom du topic ne peut pas commencer par CID ou GID, car il s'agit de préfixes réservés aux ID de groupe. Si l'instance dans laquelle vous souhaitez créer le topic utilise un namespace, le nom du topic doit être unique au sein de l'instance. Le nom du topic ne peut pas être identique à un nom de topic ou à un ID de groupe existant dans l'instance. Toutefois, le nom du topic peut être identique à un nom de topic ou à un ID de groupe présent dans une autre instance utilisant un namespace différent. Par exemple, si l'instance A et l'instance B utilisent des namespaces différents, un nom de topic dans l'instance A peut être identique à un nom de topic ou à un ID de groupe dans l'instance B. Si l'instance dans laquelle vous souhaitez créer le topic n'utilise pas de namespace, le nom du topic doit être globalement unique across instances et régions. Le nom du topic ne peut pas être identique à un nom de topic ou à un ID de groupe existant dans Message Queue for Apache RocketMQ au sein de votre compte Alibaba Cloud. Remarque 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.
MessageType	Integer	Yes	0	Le type de message. Valeurs valides : 0 : messages normaux 1 : messages partiellement ordonnés 2 : messages globalement ordonnés 4 : messages transactionnels 5 : messages planifiés ou différés Pour plus d'informations sur les types de messages, consultez Présentation.
Remark	String	No	Test	La description du topic.
InstanceId	String	Yes	MQ_INST_188077086902****_BXSuW61e	L'ID de l'instance dans laquelle vous souhaitez créer le topic.

Paramètres de réponse

Parameter	Type	Example	Description
RequestId	String	B6949B58-223E-4B75-B4FE-7797C15E****	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-zhangjiakou.aliyuncs.com/?Action=OnsTopicCreate
&InstanceId=MQ_INST_188077086902****_BXSuW61e
&MessageType=0
&Topic=test
&<Common request parameters>

Exemples de réponses réussies

XML format

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

<OnsTopicCreateResponse>
<RequestId>B6949B58-223E-4B75-B4FE-7797C15E****</RequestId>
</OnsTopicCreateResponse>

JSON format

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

{
  "RequestId" : "B6949B58-223E-4B75-B4FE-7797C15E****"
}

Codes d'erreur

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

Créer un topic dans la console

Dans la console Message Queue for Apache RocketMQ, vous pouvez également créer un topic dans une instance. Pour plus d'informations, consultez Gérer les topics.