Tous les produits
Search
Centre de documentation

IoT Platform:QueryImportedDeviceByApplyId

Dernière mise à jour :Aug 10, 2026

Interroge la liste des appareils importés par lot à l'aide de l'ID de demande.

Limites QPS

Vous pouvez appeler cette opération d'API jusqu'à 50 fois par seconde par compte.

Remarque

Les utilisateurs RAM partagent le quota du compte Alibaba Cloud.

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 QueryImportedDeviceByApplyId

L'opération que vous souhaitez effectuer. Définissez la valeur sur QueryImportedDeviceByApplyId.

ApplyId Long Yes 1295006

L'ID de la demande. Appelez l'opération BatchImportDevice pour obtenir l'ID de la demande.

PageNo Integer Yes 1

Le numéro de la page à renvoyer. Valeurs valides : 1 à 10000.

PageSize Integer Yes 10

Le nombre d'entrées à renvoyer par page. Valeur par défaut : 10. Valeur maximale : 50.

IotInstanceId String No iot-1n8t****

L'ID de l'instance. Vous trouverez l'ID sur la page Overview de la console IoT Platform.

Important
  • Si votre instance possède un ID, vous devez le spécifier. Sinon, l'appel échoue.
  • Si aucune page Overview ou aucun ID n'est généré pour votre instance, vous n'avez pas besoin de spécifier ce paramètre.

Pour plus d'informations, consultez la section Overview.

En plus des paramètres de requête spécifiques à l'opération, vous devez spécifier les paramètres de requête communs lorsque vous appelez cette opération. Pour plus d'informations, consultez la section Common parameters.

Paramètres de réponse

Parameter Type Example Description
TotalPage Integer 100

Le nombre total de pages renvoyées.

PageNo Integer 1

Le numéro de la page renvoyée.

PageSize Integer 10

Le nombre d'entrées renvoyées par page.

RequestId String E4C0FF92-2A86-41DB-92D3-73B60310D25E

L'ID de la requête.

ProductKey String a1BwAGV****

La ProductKey du produit auquel l'appareil appartient.

DeviceList Array of device

Les détails des appareils renvoyés.

device
DeviceName String light

Le DeviceName de l'appareil.

Important

Gardez ces informations confidentielles.

DeviceSecret String b4d43f7******10ba5e5

Le DeviceSecret de l'appareil.

Important

Gardez ces informations confidentielles.

ProductKey String a1BwAGV****

La ProductKey du produit auquel l'appareil appartient.

Sn String QC4******001

Le numéro de série (SN) de l'appareil.

Remarque Si vous ne spécifiez pas de SN pour l'appareil, ce paramètre est vide.
Code String iot.system.SystemException

Le code d'erreur renvoyé en cas d'échec de l'appel. Pour plus d'informations, consultez la section Error codes.

ErrorMessage String A system exception occurred.

Le message d'erreur renvoyé en cas d'échec de l'appel.

Success Boolean true

Indique si l'appel a réussi. Valeurs valides :

  • true : L'appel a réussi.
  • false : L'appel a échoué.

Exemples

Exemples de requêtes

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=QueryImportedDeviceByApplyId
&ApplyId=1295006
&PageNo=1
&PageSize=10
&IotInstanceId=iot-1n8t****
&<Common request parameters>

Exemples de réponses réussies

Format XML

<QueryImportedDeviceByApplyIdResponse>
  <TotalPage>100</TotalPage>
  <PageSize>10</PageSize>
  <PageNo>1</PageNo>
  <RequestId>E4C0FF92-2A86-41DB-92D3-73B60310D25E</RequestId>
  <ProductKey>a1BwAGV****</ProductKey>
  <DeviceList>
        <device>
              <DeviceSecret>b4d43f7******10ba5e5</DeviceSecret>
              <Sn>QC4******001</Sn>
              <ProductKey>a1BwAGV****</ProductKey>
              <DeviceName>light</DeviceName>
        </device>
  </DeviceList>
  <Success>true</Success>
</QueryImportedDeviceByApplyIdResponse>

Format JSON

{
    "TotalPage": 100,
    "PageSize": 10,
    "PageNo": 1,
    "RequestId": "E4C0FF92-2A86-41DB-92D3-73B60310D25E",
    "ProductKey": "a1BwAGV****",
    "DeviceList": {
        "device": {
            "DeviceSecret": "b4d43f7******10ba5e5",
            "Sn": "QC4******001",
            "ProductKey": "a1BwAGV****",
            "DeviceName": "light"
        }
    },
    "Success": true
}

Codes d'erreur

HttpCode Error code Error message Description
200 iot.device.DeviceApplyIsNotFound The application ID for the device does not exist. The specified application ID does not exist.

Pour obtenir la liste des codes d'erreur, consultez la section Codes d'erreur de service.