QueryDeviceGroupList - IoT Platform - Centre de documentation Alibaba Cloud

Limites

Chaque compte Alibaba Cloud peut exécuter un maximum de 100 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 signature. Pour plus de commodité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. 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	QueryDeviceGroupList	L'opération à effectuer. Définissez la valeur sur QueryDeviceGroupList.
IotInstanceId	String	Non	iot_instc_pu***_c-v64********	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. À défaut, l'appel échouera. Si votre instance ne dispose pas de page Overview ou d'ID, vous n'avez pas besoin de définir ce paramètre. Pour plus d'informations, consultez Overview.
PageSize	Integer	Non	10	Nombre d'entrées à renvoyer par page. Valeur maximale : 200. Valeur par défaut : 10.
SuperGroupId	String	Non	8vDubXr4nUvZkNgk9mle010200	ID du groupe parent. Spécifiez ce paramètre pour interroger les sous-groupes d'un groupe parent.
GroupName	String	Non	GroupName1	Nom du groupe. Si vous spécifiez ce paramètre, le système recherche les groupes par nom. Une recherche floue par nom de groupe est possible. Si vous omettez ce paramètre, le système interroge tous les groupes.
CurrentPage	Integer	Non	1	Numéro de la page à renvoyer. Valeur par défaut : 1.
GroupTypes.N	RepeatList	Non	LINK_PLATFORM_DYNAMIC	Type du groupe à interroger. Définissez la valeur sur LINK_PLATFORM_DYNAMIC. Cette valeur indique un groupe dynamique. Si vous ne spécifiez pas ce paramètre, un groupe statique est interrogé par défaut.

Outre les paramètres de requête spécifiques à l'opération présentés 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 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 Codes d'erreur.
CurrentPage	Integer	1	Numéro de la page actuelle.
Data	Array of GroupInfo		Informations sur le groupe renvoyées si l'appel aboutit. Pour plus d'informations, consultez GroupInfo. Remarque Les groupes renvoyés sont triés par ordre chronologique inverse selon leur date de création.
GroupInfo
GroupDesc	String	usefulGroup	Description du groupe.
GroupId	String	Kzt9FD8wje8o****	ID du groupe.
GroupName	String	test1	Nom du groupe.
GroupType	String	LINK_PLATFORM_DYNAMIC	Type du groupe.
UtcCreate	String	2018-10-09T02:58:34.000Z	Heure de création du groupe.
ErrorMessage	String	A system exception occurred.	Message d'erreur renvoyé en cas d'échec de l'appel.
PageCount	Integer	3	Nombre total de pages.
PageSize	Integer	10	Nombre d'entrées renvoyées par page.
RequestId	String	BEFCA316-D6C7-470C-81ED-1FF4FFD4AA0D	ID de la requête.
Success	Boolean	true	Indique si l'appel a abouti. true : L'appel a abouti. false : L'appel a échoué.
Total	Integer	24	Nombre total d'enregistrements renvoyés.

Exemples

Exemple de requête

https://iot.cn-shanghai.aliyuncs.com/?Action=QueryDeviceGroupList
&PageSize=10
&CurrentPage=1
&GroupTypes.1=LINK_PLATFORM_DYNAMIC
&<Common request parameters>

Exemple de réponse en cas de succès

Format XML

<QueryDeviceGroupListResponse>
  <PageCount>3</PageCount>
  <Data>
        <GroupInfo>
              <GroupName>test1</GroupName>
              <UtcCreate>2021-10-01T02:58:34.000Z</UtcCreate>
              <GroupId>Kzt9FD8wje8o***</GroupId>
              <GroupType>LINK_PLATFORM_DYNAMIC</GroupType>
        </GroupInfo>
        <GroupInfo>
              <GroupName>test2</GroupName>
              <UtcCreate>2021-10-01T02:56:40.000Z</UtcCreate>
              <GroupId>0ayrSQ3DSd7***</GroupId>
              <GroupType>LINK_PLATFORM_DYNAMIC</GroupType>
        </GroupInfo>
        <GroupInfo>
              <GroupDesc>Test</GroupDesc>
              <GroupName>test3</GroupName>
              <UtcCreate>2021-10-01T05:38:27.000Z</UtcCreate>
              <GroupId>oWXlIQeFZtzC***</GroupId>
              <GroupType>LINK_PLATFORM_DYNAMIC</GroupType>
        </GroupInfo>
        <GroupInfo>
              <GroupName>ylv0915</GroupName>
              <UtcCreate>2021-10-01T04:51:56.000Z</UtcCreate>
              <GroupId>SfEiVapLPUjB***</GroupId>
              <GroupType>LINK_PLATFORM_DYNAMIC</GroupType>
        </GroupInfo>
        <GroupInfo>
              <GroupName>ydlv</GroupName>
              <UtcCreate>2021-10-01T14:35:51.000Z</UtcCreate>
              <GroupId>z2S2h9NsDTZm***</GroupId>
              <GroupType>LINK_PLATFORM_DYNAMIC</GroupType>
        </GroupInfo>
        <GroupInfo>
              <GroupName>ldh_group_3</GroupName>
              <UtcCreate>2021-10-01T12:26:20.000Z</UtcCreate>
              <GroupId>chn5fkjin***</GroupId>
              <GroupType>LINK_PLATFORM_DYNAMIC</GroupType>
        </GroupInfo>
        <GroupInfo>
              <GroupDesc>ddd</GroupDesc>
              <GroupName>ylvgisbim</GroupName>
              <UtcCreate>2021-10-01T11:41:20.000Z</UtcCreate>
              <GroupId>ncUZ8DjWYaB9***</GroupId>
              <GroupType>LINK_PLATFORM_DYNAMIC</GroupType>
        </GroupInfo>
        <GroupInfo>
              <GroupName>abc</GroupName>
              <UtcCreate>2021-10-01T09:14:30.000Z</UtcCreate>
              <GroupId>zpdvwxzBdt4F***</GroupId>
              <GroupType>LINK_PLATFORM_DYNAMIC</GroupType>
        </GroupInfo>
        <GroupInfo>
              <GroupName>test11</GroupName>
              <UtcCreate>2021-10-01T07:22:39.000Z</UtcCreate>
              <GroupId>BTaudF16X2xK***</GroupId>
              <GroupType>LINK_PLATFORM_DYNAMIC</GroupType>
        </GroupInfo>
        <GroupInfo>
              <GroupName>testy</GroupName>
              <UtcCreate>2021-10-01T01:58:06.000Z</UtcCreate>
              <GroupId>PrTm3VOeggPw***</GroupId>
              <GroupType>LINK_PLATFORM_DYNAMIC</GroupType>
        </GroupInfo>
  </Data>
  <PageSize>10</PageSize>
  <RequestId>BEFCA316-D6C7-470C-81ED-1FF4FFD4AA0D</RequestId>
  <CurrentPage>1</CurrentPage>
  <Success>true</Success>
  <Total>24</Total>
</QueryDeviceGroupListResponse>

Format JSON

{
    "PageCount":3,
    "Data":{
        "GroupInfo":[
            {
                "GroupName":"test1",
                "UtcCreate":"2021-10-01T02:58:34.000Z",
                "GroupId":"Kzt9FD8wje8o***",
                "GroupType": "LINK_PLATFORM_DYNAMIC"
            },
            {
                "GroupName":"test2",
                "UtcCreate":"2021-10-01T02:56:40.000Z",
                "GroupId":"0ayrSQ3DSd7***",
                "GroupType": "LINK_PLATFORM_DYNAMIC"
            },
            {
                "GroupDesc":"Test",
                "GroupName":"test3",
                "UtcCreate":"2021-10-01T05:38:27.000Z",
                "GroupId":"oWXlIQeFZtzC***",
                "GroupType":"LINK_PLATFORM_DYNAMIC"
            },
            {
                "GroupName":"ylv0915",
                "UtcCreate":"2021-10-01T04:51:56.000Z",
                "GroupId":"SfEiVapLPUjB***",
                "GroupType": "LINK_PLATFORM_DYNAMIC"
            },
            {
                "GroupName":"ydlv",
                "UtcCreate":"2021-10-01T14:35:51.000Z",
                "GroupId":"z2S2h9NsDTZm***",
                "GroupType": "LINK_PLATFORM_DYNAMIC"
            },
            {
                "GroupName":"ldh_group_3",
                "UtcCreate":"2021-10-01T12:26:20.000Z",
                "GroupId":"chn5fkjin***",
                "GroupType": "LINK_PLATFORM_DYNAMIC"
            },
            {
                "GroupDesc":"ddd",
                "GroupName":"ylvgisbim",
                "UtcCreate":"2021-10-01T11:41:20.000Z",
                "GroupId":"ncUZ8DjWYaB9***",
                "GroupType": "LINK_PLATFORM_DYNAMIC"
            },
            {
                "GroupName":"abc",
                "UtcCreate":"2021-10-01T09:14:30.000Z",
                "GroupId":"zpdvwxzBdt4F***",
                "GroupType": "LINK_PLATFORM_DYNAMIC"
            },
            {
                "GroupName":"test11",
                "UtcCreate":"2021-10-01T07:22:39.000Z",
                "GroupId":"BTaudF16X2xK***",
                "GroupType": "LINK_PLATFORM_DYNAMIC"
            },
            {
                "GroupName":"testy",
                "UtcCreate":"2021-10-01T01:58:06.000Z",
                "GroupId":"PrTm3VOeggPw***",
                "GroupType": "LINK_PLATFORM_DYNAMIC"
            }
        ]
    },
    "PageSize":10,
    "RequestId":"BEFCA316-D6C7-470C-81ED-1FF4FFD4AA0D",
    "CurrentPage":1,
    "Success":true,
    "Total":24
}

Codes d'erreur

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