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).
NotaLos usuarios RAM de una cuenta de Alibaba Cloud comparten la cuota de dicha cuenta.
Depuración
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 |
|
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.
|
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.