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

Crea una tarea para distribuir un producto a una instancia especificada.

Notas de uso

Esta operación solo puede invocarse mediante el siguiente endpoint: iot.cn-shanghai.aliyuncs.com.
No es posible usar esta operación para distribuir un producto entre cuentas distintas.
Una tarea de distribución de productos no distribuye los dispositivos asociados al producto.
Después de distribuir un producto, no se pueden modificar su modelo TSL ni sus scripts.
Cada cuenta de Alibaba Cloud puede crear un máximo de 10 tareas para distribuir productos o dispositivos. Para obtener más información sobre cómo crear una tarea de distribución de dispositivos, consulte CreateDeviceDistributeJob.
Cada cuenta de Alibaba Cloud puede ejecutar un máximo de 2 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 mayor comodidad, se recomienda invocar esta operación desde 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í	CreateProductDistributeJob	La operación que se desea ejecutar. Establezca el valor en CreateProductDistributeJob.
ProductKey	String	Sí	a1BwAGV****	El ProductKey del producto que se va a publicar.
SourceInstanceId	String	Sí	iot-cn-st2***	El ID de la instancia de origen a la que pertenece el producto. Los ID de las instancias públicas en diferentes regiones: China (Shanghai): iotx-oxssharez200. Japan (Tokyo): iotx-oxssharez300. Singapore (Singapore): iotx-oxssharez400. US (Silicon Valley): iotx-oxssharez500. US (Virginia): iotx-oxssharez600. Germany (Frankfurt): iotx-oxssharez700. Los ID de las instancias Enterprise Edition: 1. Inicie sesión en la consola de IoT Platform. Seleccione una región en la lista desplegable de la esquina superior izquierda de la barra de navegación superior. 2. En la página Overview, haga clic en el nombre de la instancia. En la página Instance Details, consulte el ID de la instancia en la sección Basic Information.
TargetInstanceId	String	Sí	iot-cn-6ja***	El ID de la instancia de destino donde se distribuirá 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 a la que pertenece el producto. Inicie sesión en la consola de IoT Platform, haga clic en la foto de perfil y luego consulte el Account ID en la página Security Settings. Los parámetros TargetUid y TargetAliyunId no pueden estar vacíos al mismo tiempo.
TargetAliyunId	String	No	io****@example.com	La cuenta de Alibaba Cloud a la que pertenece el producto. Inicie sesión en la consola de IoT Platform, haga clic en la foto de perfil y luego consulte la Logon Account en la página Security Settings. Los parámetros TargetUid y TargetAliyunId no pueden estar vacíos al mismo tiempo.

Además de los parámetros de solicitud específicos de la operación mencionados anteriormente, debe especificar los parámetros de solicitud comunes al invocar esta operación. Para obtener más información, consulte Parámetros de solicitud 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.
JobId	String	UbmsMHmkqv0PiAG****010001	El ID de la tarea devuelto si la llamada es exitosa. Este ID identifica la tarea de forma global.
RequestId	String	E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565	El ID de la solicitud.
Success	Boolean	true	Indica si la llamada fue exitosa. true: La llamada fue exitosa. false: La llamada falló.

Ejemplos

Solicitudes de ejemplo

http(s)://iot.cn-shanghai.aliyuncs.com/?Action=CreateProductDistributeJob
&ProductKey=a1BwAGV****
&SourceInstanceId=iot-cn-st2***
&TargetInstanceId=iot-cn-6ja***
&TargetAliyunId=io****@example.com
&<Common request parameters>

Respuestas exitosas de ejemplo

Formato XML

<CreateProductDistributeJobResponse>
  <RequestId>E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565</RequestId>
  <JobId>UbmsMHmkqv0PiAG****010001</JobId>
  <Success>true</Success>
</CreateProductDistributeJobResponse>

Formato JSON

{
    "RequestId": "E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565",
    "JobId": "UbmsMHmkqv0PiAG****010001",
    "Success": true
}

Códigos de error

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