SetDeviceGroupTags - IoT Platform - Centre de documentation Alibaba Cloud

Ajoute, met à jour ou supprime des tags de groupe.

Notes d'utilisation

Un groupe d'appareils peut comporter au maximum 100 tags.

Limites QPS

Chaque compte Alibaba Cloud peut exécuter jusqu'à 50 requêtes par seconde (QPS).

Remarque

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

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. OpenAPI Explorer génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	SetDeviceGroupTags	L'opération à effectuer. Définissez la valeur sur SetDeviceGroupTags.
GroupId	String	Yes	W16X8Tvdosec****	ID du groupe. Il s'agit de l'identifiant global unique (GUID) du groupe.
IotInstanceId	String	No	iot_instc_pu***_c-v64********	ID de l'instance. Sur la page Overview de la console IoT Platform, vous pouvez consulter l'ID de l'instance. Important Si votre instance possède un ID, vous devez spécifier cet ID pour ce paramètre. Sinon, l'appel échoue. Si la page Overview ou l'ID de l'instance n'est pas affiché dans la console IoT Platform, vous n'avez pas besoin de configurer ce paramètre. Pour plus d'informations sur l'instance, consultez Overview.
TagString	String	No	[{"tagKey":"h1","tagValue":"rr"},{"tagKey":"7h","tagValue":"rr"}]	Données de tag au format JSON. Le paramètre TagString spécifie plusieurs tags sous forme de paires clé-valeur. Vous devez spécifier tagKey et tagValue pour chaque tag. tagKey : clé du tag. La clé doit comporter entre 2 et 30 caractères et peut contenir des lettres, des chiffres et des points (.). tagValue : valeur du tag. Chaque valeur peut contenir des lettres, des chiffres, des traits de soulignement (_) et des traits d'union (-). La valeur doit comporter entre 1 et 128 caractères. Séparez plusieurs tags par des virgules (,). Exemple : `[{"tagKey":"h1","tagValue":"rr"},{"tagKey":"7h","tagValue":"rr"}]` Si vous spécifiez une nouvelle valeur pour un tag existant, la nouvelle valeur écrase la valeur d'origine. Pour supprimer un tag, inutile de spécifier sa clé et sa valeur. Important `abc` est une clé réservée par IoT Platform. Vous ne pouvez pas définir tagKey sur abc. Si vous définissez `tagKey` sur abc, le tag abc est automatiquement filtré lors de l'interrogation des tags.
GroupType	String	No	LINK_PLATFORM_DYNAMIC	Type de groupe. Vous n'avez pas besoin de configurer ce paramètre.

En plus des paramètres de requête spécifiques à l'opération ci-dessus, vous devez spécifier des paramètres de requête communs lors de l'appel de cette opération. Pour plus d'informations sur les paramètres de requête communs, consultez Common parameters.

Paramètres de réponse

Parameter	Type	Example	Description
Code	String	iot.system.SystemException	Code d'erreur renvoyé en cas d'échec de l'appel. Pour plus d'informations sur les codes d'erreur, consultez Error codes.
ErrorMessage	String	A system exception occurred.	Message d'erreur renvoyé en cas d'échec de l'appel.
RequestId	String	12CFDAF1-99D9-42E0-8C2F-F281DA5E8953	ID de la requête.
Success	Boolean	true	Indique si l'appel a réussi. Valeurs possibles : true : L'appel a réussi. false : L'appel a échoué.

Exemples

Exemples de requêtes

https://iot.cn-shanghai.aliyuncs.com/?Action=SetDeviceGroupTags
&GroupId=W16X8Tvdosec****
&TagString=[{"tagKey":"h1","tagValue":"rr"},{"tagKey":"7h","tagValue":"rr"}]
&<Common request parameters>

Exemples de réponses réussies

XML format

<SetDeviceGroupTagsResponse>
      <RequestId>12CFDAF1-99D9-42E0-8C2F-F281DA5E8953</RequestId>
      <Success>true</Success>
</SetDeviceGroupTagsResponse>

JSON format

{
    "RequestId":"12CFDAF1-99D9-42E0-8C2F-F281DA5E8953",
    "Success":true
}

Codes d'erreur

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