Consulta la lista de productos distribuidos en distintas regiones o instancias.
Notas de uso
Esta operación solo admite el siguiente endpoint: iot.cn-shanghai.aliyuncs.com.
Límites de QPS
Cada cuenta de Alibaba Cloud puede invocar esta operación hasta cinco veces por segundo.
Los usuarios de RAM comparten la cuota de la cuenta de Alibaba Cloud.
Depuración
Parámetros de solicitud
| Parámetro | Tipo | Obligatorio | Ejemplo | Descripción |
| Action | String | Sí | ListDistributedProduct |
La operación que se va a ejecutar. Establezca el valor en ListDistributedProduct. |
| CurrentPage | Integer | Sí | 1 |
El número de página a devolver. Valor predeterminado: 1. |
| PageSize | Integer | Sí | 5 |
El número de entradas a devolver por página. Valor máximo: 200. |
| SourceInstanceId | String | No | iot-060*** |
El ID de la instancia de origen a la que pertenece el producto.
|
| ProductKey | String | No | a1BwAGV**** |
La clave ProductKey del producto. |
| TargetInstanceId | String | No | iot-cn-6ja*** |
El ID de la instancia de destino a la que se distribuye el producto. Para obtener más información sobre los ID de instancia, consulte la descripción del parámetro SourceInstanceId. |
| TargetUid | String | No | 198*** |
El ID de la cuenta de Alibaba Cloud propietaria del producto. Para obtener este ID, inicie sesión en la consola de IoT Platform, haga clic en la imagen de perfil y luego consulte el account ID en la página Security Settings. |
Además de los parámetros específicos de la operación mencionados anteriormente, 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. |
| Data | Struct |
La lista de productos devuelta cuando la llamada es exitosa. Para obtener más información, consulte la sección "Info" de este tema. |
|
| Info | Array of items |
Los detalles de distribución del producto. |
|
| items | |||
| GmtCreate | Long | 1581595942 |
La hora en que se creó la tarea de distribución. |
| ProductKey | String | a1BwAGV**** |
La clave ProductKey del producto. |
| SourceInstanceId | String | iot-cn-6ja*** |
El ID de la instancia de origen a la que pertenece el producto. |
| SourceInstanceName | String | myproInstance |
El nombre de la instancia de origen a la que pertenece el producto. |
| SourceRegion | String | cn-shanghai |
La región de origen a la que pertenece el producto. |
| SourceUid | String | 198*** |
El ID de la cuenta de Alibaba Cloud utilizada para distribuir el producto. La distribución entre regiones e instancias solo se admite dentro de la misma cuenta. El valor es idéntico al de TargetUid. |
| TargetAliyunId | String | io****@example.com |
El nombre de la cuenta de Alibaba Cloud a la que se distribuye el producto. |
| TargetInstanceId | String | iot-cn-09k*** |
El ID de la instancia de destino a la que se distribuye el producto. |
| TargetInstanceName | String | newinstance |
El nombre de la instancia de destino a la que se distribuye el producto. |
| TargetRegion | String | cn-shenzhen |
La región de destino a la que se distribuye el producto. |
| TargetUid | String | 198*** |
El ID de la cuenta de Alibaba Cloud a la que se distribuye el producto. La distribución entre regiones e instancias solo se admite dentro de la misma cuenta. El valor es idéntico al de TargetUid. |
| Total | Integer | 10 |
El número total de productos devueltos. |
| ErrorMessage | String | A system exception occurred. |
El mensaje de error devuelto si la llamada falla. |
| RequestId | String | E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565 |
El ID de la solicitud. |
| Success | Boolean | true |
Indica si la llamada fue exitosa. Valores válidos:
|
Ejemplos
Solicitudes de ejemplo
http(s)://iot.cn-shanghai.aliyuncs.com/?Action=ListDistributedProduct
&CurrentPage=1
&PageSize=5
&TargetUid=198***
&<Common request parameters>Respuestas exitosas de ejemplo
Formato XML
<ListDistributedProductResponse>
<RequestId>E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565</RequestId>
<Data>
<Total>10</Total>
<Info>
<items>
<TargetRegion>cn-shenzhen</TargetRegion>
<SourceInstanceName>myproInstance</SourceInstanceName>
<TargetAliyunId>io****@example.com</TargetAliyunId>
<GmtCreate>1581595942</GmtCreate>
<SourceUid>198***</SourceUid>
<TargetInstanceName>newinstance</TargetInstanceName>
<TargetInstanceId>iot-cn-09k***</TargetInstanceId>
<TargetUid>198***</TargetUid>
<SourceRegion>cn-shanghai</SourceRegion>
<SourceInstanceId>iot-cn-6ja***</SourceInstanceId>
<ProductKey>a1BwAGV****</ProductKey>
</items>
</Info>
</Data>
<Success>true</Success>
</ListDistributedProductResponse>Formato JSON
{
"RequestId": "E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565",
"Data": {
"Total": 10,
"Info": {
"items": [{
"TargetRegion": "cn-shenzhen",
"SourceInstanceName": "myproInstance",
"TargetAliyunId": "io****@example.com",
"GmtCreate": 1581595942,
"SourceUid": "198***",
"TargetInstanceName": "newinstance",
"TargetInstanceId": "iot-cn-09k***",
"TargetUid": "198***",
"SourceRegion": "cn-shanghai",
"SourceInstanceId": "iot-cn-6ja***",
"ProductKey": "a1BwAGV****"
}]
}
},
"Success": true
}Códigos de error
Para obtener una lista de códigos de error, consulte Códigos de error del servicio.