QueryDeviceGroupTagList - IoT Platform - Centre de documentation Alibaba Cloud

Interroge les tags d'un groupe.

Limites

Chaque compte Alibaba Cloud peut exécuter un maximum de 500 requêtes par seconde (QPS).

Remarque

Les utilisateurs RAM d'un compte Alibaba Cloud partagent le quota du compte.

Débogage

Alibaba Cloud met à votre disposition OpenAPI Explorer pour simplifier l'utilisation des API. OpenAPI Explorer calcule automatiquement la valeur de la 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 la requête

Parameter	Type	Required	Example	Description
Action	String	Yes	QueryDeviceGroupTagList	L'opération que vous souhaitez effectuer. Définissez la valeur sur QueryDeviceGroupTagList.
GroupId	String	Yes	W16X8Tvdosec****	L'ID du groupe. L'ID est l'identifiant global unique (GUID) du groupe.
IotInstanceId	String	No	iot_instc_pu***_c-v64********	L'ID de l'instance. Vous pouvez consulter l'ID de l'instance sur la page Overview de la console IoT Platform. Important Si votre instance possède un ID, vous devez configurer ce paramètre. Si vous ne définissez pas ce paramètre, l'appel échouera. Si votre instance ne possède pas de page Overview ou d'ID, vous n'avez pas besoin de définir ce paramètre. Pour plus d'informations, consultez Overview.
GroupType	String	No	LINK_PLATFORM_DYNAMIC	Le type du groupe. Si vous définissez la valeur sur LINK_PLATFORM_DYNAMIC, un groupe dynamique est interrogé. Si vous ne spécifiez pas ce paramètre, un groupe statique est interrogé par défaut.

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

Paramètres de la 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 Codes d'erreur.
Data	Array of GroupTagInfo		Les informations de tag renvoyées en cas de réussite de l'appel. Pour plus d'informations, consultez le paramètre GroupTagInfo ci-dessous.
GroupTagInfo
TagKey	String	room1	La clé du tag.
TagValue	String	bulb	La valeur du tag.
ErrorMessage	String	A system exception occurred.	Le message d'erreur renvoyé en cas d'échec de l'appel.
RequestId	String	214154FF-9D47-4E3F-AAAD-F4CE67F41060	L'ID de la requête.
Success	Boolean	true	Indique si l'appel a réussi. true : L'appel a réussi. false : L'appel a échoué.

Exemples

Exemples de requêtes

https://iot.cn-shanghai.aliyuncs.com/?Action=QueryDeviceGroupTagList
&GroupId=W16X8Tvdosec****
&<Common request parameters>

Exemples de réponses réussies

Format XML

<QueryDeviceGroupTagListResponse>
      <Data>
            <GroupTagInfo>
                  <TagValue>bulb</TagValue>
                  <TagKey>room1</TagKey>
            </GroupTagInfo>
      </Data>
      <RequestId>214154FF-9D47-4E3F-AAAD-F4CE67F41060</RequestId>
      <Success>true</Success>
</QueryDeviceGroupTagListResponse>

Format JSON

{
    "Data":{
        "GroupTagInfo":[
            {
                "TagValue":"bulb",
                "TagKey":"room1"
            }
        ]
    },
    "RequestId":"214154FF-9D47-4E3F-AAAD-F4CE67F41060",
    "Success":true
}

Codes d'erreur

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