UpdateProductTags - IoT Platform - Centre de documentation Alibaba Cloud

Met à jour les tags de produit.

Notes d'utilisation

Vous pouvez mettre à jour jusqu'à 10 tags par appel.

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 QPS

Chaque compte Alibaba Cloud peut effectuer jusqu'à 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

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	UpdateProductTags	Opération à effectuer. Définissez la valeur sur UpdateProductTags.
ProductKey	String	Oui	a1BwAGV****	Clé ProductKey du produit. Il s'agit d'un GUID attribué par IoT Platform au produit. Utilisez la console IoT Platform ou appelez l'opération QueryProductList pour afficher les informations de tous les produits associés à votre compte.
IotInstanceId	String	Non	iot_instc_pu***_c-v64********	ID de l'instance. Consultez l'ID de l'instance sur la page Overview de la console IoT Platform. Important Si votre instance possède un ID, spécifiez-le pour ce paramètre, sans quoi l'appel échouera. Si aucune page Overview ni aucun ID n'est généré pour votre instance, ne configurez pas ce paramètre. Pour plus d'informations, consultez la page Overview.
ProductTag.N.TagValue	String	Non	202	Nouvelles valeurs des tags de 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 (-).
ProductTag.N.TagKey	String	Non	room	Clés des tags de produit. Chaque clé doit comporter entre 1 et 30 caractères et peut contenir des lettres, des chiffres et des points (.). Remarque Chaque clé de tag spécifiée doit déjà exister. Chaque valeur de tag spécifiée doit être unique.

Outre les paramètres de requête spécifiques à l'opération présentés ci-dessus, spécifiez les paramètres de requête communs lors de l'appel à cette opération. Pour plus d'informations, consultez la page Paramètres de requête communs.

Paramètres de réponse

Paramètre	Type	Exemple	Description
Code	String	iot.system.SystemException	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.	Message d'erreur renvoyé en cas d'échec de la requête.
InvalidProductTags	Array of ProductTag		Tags de produit non valides renvoyés en cas d'échec de l'appel. Les détails figurent dans le paramètre ProductTag.
ProductTag
TagKey	String	room	Clé du tag.
TagValue	String	123	Valeur du tag.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	ID de la requête.
Success	Boolean	true	Indique si l'appel a réussi. true : réussite false : échec

Exemples

Exemple de requête

https://iot.cn-shanghai.aliyuncs.com/?Action=UpdateProductTags
&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

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

Format JSON

{
  "RequestId": "92586B4B-FF78-494A-A22C-368E4293FBB7",
  "Success": true
}

Codes d'erreur

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