Todos los productos
Search
Centro de documentos

IoT Platform:QueryDeviceDistributeDetail

Última actualización: Sep 04, 2026

Consulta el resultado de una tarea de distribución de dispositivos completada.

Notas de uso

  • Esta operación solo admite el siguiente endpoint: iot.cn-shanghai.aliyuncs.com.

  • Cada cuenta de Alibaba Cloud puede ejecutar un máximo de 5 consultas por segundo (QPS).

    Nota

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

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos que ejecute esta operación en OpenAPI Explorer. OpenAPI Explorer 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í

QueryDeviceDistributeDetail

La operación que desea realizar. Establezca el valor en QueryDeviceDistributeDetail.

JobId

String

Sí

UbmsMHmkqv0PiAG****010001

El ID único global de la tarea de distribución.

Además de los parámetros de solicitud específicos de la operación enumerados a continuación, también debe especificar los parámetros de solicitud comunes. Para obtener más información, consulte Parámetros comunes.

Parámetros de respuesta

Parámetro Tipo Ejemplo Descripción
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.

File String https://iotx-***.oss-cn-shanghai.aliyuncs.com/job***/7u***

La URL del archivo de OSS que contiene el resultado de la distribución. Esta URL es válida durante 10 minutos.

RequestId String E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565

El ID de la solicitud.

Success Boolean true

Indica si la llamada se realizó correctamente.

  • true: La llamada se realizó correctamente.
  • false: La llamada falló.

Ejemplos

Solicitudes de ejemplo

http(s)://iot.cn-shanghai.aliyuncs.com/? Action=QueryDeviceDistributeDetail
&JobId=UbmsMHmkqv0PiAG****010001
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

<QueryDeviceDistributeDetailResponse>
  <RequestId>E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565</RequestId>
  <File>https://iotx-***.oss-cn-shanghai.aliyuncs.com/job***/7u***</File>
  <Success>true</Success>
</QueryDeviceDistributeDetailResponse>

Formato JSON

{
    "RequestId": "E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565",
    "File": "https://iotx-***.oss-cn-shanghai.aliyuncs.com/job***/7u***",
    "Success": true
}

Códigos de error

Para obtener una lista de códigos de error, visite el Centro de errores de API.