QueryImportedDeviceByApplyId - IoT Platform - Centro de documentación de Alibaba Cloud

Consulta la lista de dispositivos importados en lote mediante el ID de solicitud.

Límites de QPS

Esta operación de API admite hasta 50 llamadas por segundo por cuenta.

Nota

Los usuarios de RAM comparten la cuota de la cuenta de Alibaba Cloud.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para mayor comodidad, se recomienda ejecutar esta operación en OpenAPI Explorer. Esta herramienta genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro	Tipo	Obligatorio	Ejemplo	Descripción
Action	String	Sí	QueryImportedDeviceByApplyId	La operación que desea ejecutar. Establezca el valor como QueryImportedDeviceByApplyId.
ApplyId	Long	Sí	1295006	El ID de la solicitud. Llame a la operación BatchImportDevice para obtener este identificador.
PageNo	Integer	Sí	1	El número de página que se devolverá. Valores válidos: de 1 a 10000.
PageSize	Integer	Sí	10	La cantidad de entradas que se devolverán en cada página. Valor predeterminado: 10. Valor máximo: 50.
IotInstanceId	String	No	iot-1n8t****	El ID de la instancia. Encuentre el ID en la página Overview de la consola de IoT Platform. Importante Si su instancia tiene un ID, debe especificarlo; de lo contrario, la llamada fallará. Si no se generó una página Overview o un ID para su instancia, no es necesario especificar este parámetro. Para obtener más información, consulte Descripción general.

Además de los parámetros específicos de la operación, debe especificar los parámetros de solicitud comunes al ejecutar esta operación. Para obtener más información, consulte Parámetros comunes.

Parámetros de respuesta

Parámetro	Tipo	Ejemplo	Descripción
TotalPage	Integer	100	El número total de páginas devueltas.
PageNo	Integer	1	El número de la página devuelta.
PageSize	Integer	10	La cantidad de entradas devueltas por página.
RequestId	String	E4C0FF92-2A86-41DB-92D3-73B60310D25E	El ID de la solicitud.
ProductKey	String	a1BwAGV****	La clave ProductKey del producto al que pertenece el dispositivo.
DeviceList	Array of device		Los detalles de los dispositivos devueltos.
device
DeviceName	String	light	El nombre (DeviceName) del dispositivo. Importante Mantenga esta información confidencial.
DeviceSecret	String	b4d43f7******10ba5e5	El secreto (DeviceSecret) del dispositivo. Importante Mantenga esta información confidencial.
ProductKey	String	a1BwAGV****	La clave ProductKey del producto al que pertenece el dispositivo.
Sn	String	QC4******001	El número de serie (SN) del dispositivo. Nota Si no se especificó un SN para el dispositivo, este parámetro estará vacío.
Code	String	iot.system.SystemException	El código de error devuelto si la llamada falla. Para obtener más información, consulte Códigos de error.
ErrorMessage	String	A system exception occurred.	El mensaje de error devuelto si la llamada falla.
Success	Boolean	true	Indica si la llamada se realizó correctamente. Valores válidos: true: La llamada fue exitosa. false: La llamada falló.

Ejemplos

Solicitudes de ejemplo

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

Respuestas exitosas de ejemplo

Formato 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>

Formato 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
}

Códigos de error

HttpCode	Código de error	Mensaje de error	Descripción
200	iot.device.DeviceApplyIsNotFound	The application ID for the device does not exist.	El ID de solicitud especificado no existe.

Para obtener una lista de códigos de error, consulte Códigos de error del servicio.