QueryClientIds - IoT Platform - Centre de documentation Alibaba Cloud

Limites

Chaque compte Alibaba Cloud peut effectuer au maximum 10 requêtes par seconde (QPS).

Remarque

Les utilisateurs RAM partagent le quota du compte Alibaba Cloud.

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

Parameter	Type	Required	Example	Description
Action	String	Yes	QueryClientIds	Opération à effectuer. Définissez la valeur sur QueryClientIds.
IotId	String	Yes	y4u2weAIrpp****WHMle1234	ID de l'appareil. Appelez l'opération QueryDeviceInfo pour obtenir le IotId.
IotInstanceId	String	No	iot-a****13l	ID de l'instance. Vous pouvez le trouver 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 échoue. 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.

Vous devez également 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

Parameter	Type	Example	Description
Code	String	Success	Code d'erreur renvoyé en cas d'échec de l'appel. Pour plus d'informations, consultez Codes d'erreur.
Data	Struct		ClientIDs renvoyés en cas de succès. Pour plus d'informations, consultez DynamicRegClientIds.
DynamicRegClientIds	Array of DynamicRegClientId		Liste des ClientIDs.
ClientId	String	9rSzYt4js92********f000112	ClientID de l'appareil.
CreateTime	Long	1636514022424	Heure de création du ClientID.
IotId	String	y4u2weAI********HMle1234	ID de l'appareil.
ErrorMessage	String	request parameter error	Message d'erreur renvoyé en cas d'échec de l'appel.
RequestId	String	89F22330-BAEE-**-**-41BA46D6E267	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

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=QueryClientIds
&IotId=y4u2weAIrpp****WHMle1234
&<Common request parameters>

Exemples de réponses réussies

Format XML

<QueryClientIdsResponse>
  <RequestId>CA991E7C-BDE7-5887-B3B7-E08C68C0D346</RequestId>
  <Data>
        <IotId>kRLP***0000</IotId>
        <DynamicRegClientIds>
              <CreateTime>1635847637823</CreateTime>
              <ClientId>K19uYV***000100</ClientId>
        </DynamicRegClientIds>
        <DynamicRegClientIds>
              <CreateTime>1635846982286</CreateTime>
              <ClientId>bpQwyW***000100</ClientId>
        </DynamicRegClientIds>
        <DynamicRegClientIds>
              <CreateTime>1635847426368</CreateTime>
              <ClientId>ntnIvez***000100</ClientId>
        </DynamicRegClientIds>
  </Data>
  <Success>true</Success>
</QueryClientIdsResponse>

Format JSON

{
    "RequestId": "CA991E7C-BDE7-5887-B3B7-E08C68C0D346",
    "Data": {
        "IotId": "kRLP***0000",
        "DynamicRegClientIds": [
            {
                "CreateTime": 1635847637823,
                "ClientId": "K19uYV***000100"
            },
            {
                "CreateTime": 1635846982286,
                "ClientId": "bpQwyW***000100"
            },
            {
                "CreateTime": 1635847426368,
                "ClientId": "ntnIvez***000100"
            }
        ]
    },
    "Success": true
}

Codes d'erreur

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