CreateProductTags - IoT Platform - Centre de documentation Alibaba Cloud

Crée des tags pour un produit.

Remarques relatives à l'utilisation

Vous pouvez créer jusqu'à 10 tags pour un produit en un seul appel.
Chaque produit peut comporter au maximum 100 tags.

Important

Spécifiez les clés et les valeurs des tags, faute de quoi l'appel échouera. Pour plus d'informations sur les valeurs des tags, consultez la section « Paramètres de requête » de cette rubrique.

Limites de QPS

Chaque compte Alibaba Cloud est limité à 500 requêtes par seconde (QPS).

Remarque

Les utilisateurs RAM (Resource Access Management) d'un compte Alibaba Cloud partagent le quota de ce compte.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	CreateProductTags	L'opération à exécuter. Définissez la valeur sur CreateProductTags.
ProductKey	String	Yes	a1BwAGV****	Le ProductKey du produit. Un ProductKey est un GUID attribué par IoT Platform à un produit. Utilisez la console IoT Platform ou appelez l'opération QueryProductList pour afficher les informations concernant tous les produits de votre compte.
IotInstanceId	String	No	iot_instc_pu***_c-v64********	L'ID de l'instance. Vous pouvez consulter cet identifiant sur la page Overview de la console IoT Platform. Important Si votre instance possède un ID, vous devez le spécifier pour ce paramètre, sinon l'appel échouera. Si aucune page Overview ni aucun ID n'a été généré pour votre instance, il n'est pas nécessaire de configurer ce paramètre. Pour plus d'informations, consultez la page Overview.
ProductTag.N.TagKey	String	No	room	Les clés des tags du produit. Chaque clé doit comporter entre 1 et 30 caractères et peut contenir des lettres, des chiffres et des points (.). Important `abc` est une clé réservée par IoT Platform. Vous ne pouvez pas définir une clé sur `abc`. Si vous définissez une `clé` sur abc, celle-ci sera automatiquement filtrée lors de la consultation des tags.
ProductTag.N.TagValue	String	No	TagValue	Les valeurs des tags du produit. Chaque valeur de tag doit comporter entre 1 et 128 caractères et peut contenir des lettres, des chiffres, des traits de soulignement (_) et des traits d'union (-).

Outre les paramètres de requête spécifiques à cette opération, vous devez spécifier les paramètres de requête communs lors de l'appel. Pour plus d'informations, consultez la page Paramètres de requête communs.

Paramètres de réponse

Parameter	Type	Example	Description
Code	String	iot.system.SystemException	Le code d'erreur renvoyé en cas d'échec de l'appel. Pour plus d'informations, consultez la page Codes d'erreur.
ErrorMessage	String	A system exception occurred.	Le message d'erreur renvoyé si la requête échoue.
InvalidProductTags	Array of ProductTag		Les tags de produit non valides renvoyés en cas d'échec de l'appel.
ProductTag
TagKey	String	room	La clé du tag.
TagValue	String	123$	La valeur du tag.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	L'ID de la requête.
Success	Boolean	true	Indique si l'appel a réussi. true : L'appel a réussi. Les tags ont été associés au produit. false : L'appel a échoué. Cette valeur indique que les tags n'ont pas pu être associés au produit.

Exemples

Exemple de requête

https://iot.cn-shanghai.aliyuncs.com/?Action=CreateProductTags
&ProductKey=a1h7knJ****
&ProductTag.1.TagKey=first
&ProductTag.1.TagValue=value1
&ProductTag.2.TagKey=second
&ProductTag.2.TagValue=value2
&<Common request parameters>

Exemple de réponse réussie

Format XML

<CreateProductTagsResponse>
      <RequestId>57b144cf-09fc-4916-a272-a62902d5b207</RequestId>
      <Success>true</Success>
</CreateProductTagsResponse>

Format JSON

{
  "RequestId": "354A4F9B-6B01-4498-8084-867F59720BA5",
  "Success": true
}

Codes d'erreur

Pour obtenir la liste des codes d'erreur, consultez la page Codes d'erreur de service.