Copia un modelo de Thing Specification Language (TSL) de un producto de origen a un producto de destino.
Notas de uso
Si el producto de destino ya está publicado, debe llamar a la operación CancelReleaseProduct para cancelar su publicación antes de copiar un modelo TSL del producto de origen.
Las categorías del producto de origen y del producto de destino deben ser iguales. La categoría del producto se indica mediante el parámetro CategoryKey. Para consultar el parámetro CategoryKey de un producto, llame a la operación QueryProduct.
Debe especificar la versión del modelo TSL que desea copiar mediante el parámetro SourceModelVersion en la solicitud. De lo contrario, la operación CopyThingModel fallará.
Límites de QPS
Puede llamar a esta operación de API hasta cinco veces por segundo por cuenta.
Los usuarios de Resource Access Management (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í | CopyThingModel | La operación que se va a ejecutar. Establezca el valor en CopyThingModel. |
SourceProductKey | String | Sí | a1BwAGV**** | El ProductKey del producto de origen. Puede consultar el ProductKey en la página Products de la consola de IoT Platform. También puede obtenerlo mediante la operación QueryProductList. |
TargetProductKey | String | Sí | a1BwwG0**** | El ProductKey del producto de destino. Puede consultar el ProductKey en la página Products de la consola de IoT Platform. También puede obtenerlo mediante la operación QueryProductList. |
IotInstanceId | String | No | iot_instc_pu**_c-v64* | El ID de la instancia. Puede consultar el ID de la instancia en la pestaña Overview de la consola de IoT Platform. Importante
Para obtener más información sobre las instancias, consulte Descripción general. |
ResourceGroupId | String | No | rg-acfm4l5tcwd**** | El ID del resource group. Importante IoT Platform solo admite la gestión de resource groups por instancia. El parámetro ResourceGroupId no es válido. No es necesario especificar este parámetro. |
SourceModelVersion | String | No | V1.0.0 | La versión del modelo TSL que se va a copiar. Puede llamar a la operación ListThingModelVersion para consultar las versiones del modelo TSL de un producto. |
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 llamar a esta operación. Para obtener más información sobre los parámetros de solicitud comunes, 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 solicitud falla. Para obtener más información sobre los códigos de error, consulte Códigos de error. |
ErrorMessage | String | A system exception occurred. | El mensaje de error devuelto si la solicitud falla. |
RequestId | String | E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565 | El ID de la solicitud. |
Success | Boolean | true | Indica si la solicitud se completó correctamente. Valores válidos:
|
Ejemplos
Solicitudes de ejemplo
https://iot.cn-shanghai.aliyuncs.com/?Action=CopyThingModel
&ProductKeySource=a1rYuVF****
&ProductKeyTarget=a1bPo9p****
&SourceModelVersion=v1.0.0
&<Common request parameters>Respuestas exitosas de ejemplo
Formato XML
<CopyThingModelResponse>
<RequestId>9E76053E-26ED-4AB4-AE58-8AFC3F1E7E8E</RequestId>
<Success>true</Success>
</CopyThingModelResponse>Formato JSON
{
"RequestId": "9E76053E-26ED-4AB4-AE58-8AFC3F1E7E8E",
"Success": true
}Códigos de error
Para obtener una lista de códigos de error, consulte Códigos de error del servicio.