QueryDeviceGroupByDevice - IoT Platform - Centre de documentation Alibaba Cloud

Limites

Un appareil peut appartenir à 10 groupes au maximum.
Chaque compte Alibaba Cloud est limité à 50 requêtes par seconde (QPS).

Remarque
Les utilisateurs RAM d'un compte Alibaba Cloud partagent le quota de ce compte.

Débogage

Appelez cette opération dans OpenAPI Explorer pour calculer automatiquement la valeur de signature et générer des exemples de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	QueryDeviceGroupByDevice	Opération à effectuer. Définissez la valeur sur QueryDeviceGroupByDevice.
DeviceName	String	Yes	test456	Nom de l'appareil (DeviceName).
ProductKey	String	Yes	a1SKk9K****	Clé produit (ProductKey) du produit auquel l'appareil appartient.
IotInstanceId	String	No	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, vous devez configurer ce paramètre. À défaut, l'appel échouera. Si votre instance ne dispose pas de page Overview ou d'ID, il n'est pas nécessaire de définir ce paramètre. Pour plus d'informations, consultez Overview.

Outre les paramètres de requête spécifiques à l'opération, vous devez spécifier les paramètres de requête communs lors de l'appel à cette opération. Pour plus d'informations, consultez Common request 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, consultez Error codes.
ErrorMessage	String	A system exception occurred.	Message d'erreur renvoyé en cas d'échec de l'appel.
GroupInfos	Array of GroupInfo		Informations sur le groupe renvoyées en cas de succès de l'appel. Pour plus d'informations, consultez GroupInfo.
GroupInfo
GroupDesc	String	father desc	Description du groupe.
GroupId	String	6a3FF2XE2BKa****	ID du groupe.
GroupName	String	father1543152336554	Nom du groupe.
GroupType	String	LINK_PLATFORM_DYNAMIC	Type du groupe.
UtcCreate	String	2018-11-25T13:25:37.000Z	Date de création du groupe.
RequestId	String	7941C8CD-7764-4A94-8CD9-E2762D4A73AC	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

Exemple de requête

https://iot.cn-shanghai.aliyuncs.com/?Action=QueryDeviceGroupByDevice
&DeviceName=test456
&ProductKey=a1SKk9K****
&<Common request parameters>

Exemple de réponse en cas de succès

XML format

<QueryDeviceGroupByDeviceResponse>
  <RequestId>7941C8CD-7764-4A94-8CD9-E2762D4A73AC</RequestId>
  <GroupInfos>
        <GroupInfo>
              <GroupDesc>father desc</GroupDesc>
              <GroupName>father1543152336554</GroupName>
              <UtcCreate>2018-11-25T13:25:37.000Z</UtcCreate>
              <GroupId>6a3FF2XE2BKa***</GroupId>
              <GroupType>LINK_PLATFORM_DYNAMIC</GroupType>
        </GroupInfo>
  </GroupInfos>
  <Success>true</Success>
</QueryDeviceGroupByDeviceResponse>

JSON format

{
  "RequestId": "7941C8CD-7764-4A94-8CD9-E2762D4A73AC",
  "GroupInfos": {
    "GroupInfo": [
      {
        "GroupDesc": "father desc",
        "GroupName": "father1543152336554",
        "UtcCreate": "2018-11-25T13:25:37.000Z",
        "GroupId": "6a3FF2XE2BKa***",
        "GroupType":"LINK_PLATFORM_DYNAMIC"
      }
    ]
  },
  "Success": true
}

Codes d'erreur

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