調用該接口復制指定產品的物模型到目標產品。
使用說明
- 如果目標產品已發布，需先調用接口CancelReleaseProduct取消該產品發布，才能調用本接口復制物模型。
- 目標產品和物模型源產品的品類（CategoryKey）必須相同。您可調用QueryProduct接口，從返回結果中查看產品的CategoryKey。
- 要復制的物模型版本號必須傳入，即必須傳入請求參數SourceModelVersion的值，否則調用接口會失敗。
QPS限制
單個阿里云賬號調用該接口的每秒請求數（QPS）最大限制為5。
說明 單個阿里云賬號下的所有RAM用戶共享該阿里云賬號的配額。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
| 名稱 | 類型 | 是否必選 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | CopyThingModel | 系統規定參數。取值：CopyThingModel。 |
| SourceProductKey | String | 是 | a1BwAGV**** | 要復制的物模型所屬產品的ProductKey。 可以在物聯網平臺控制臺產品頁查看，或調用QueryProductList查看ProductKey的取值。 |
| TargetProductKey | String | 是 | a1BwwG0**** | 目標產品的ProductKey。 可以在物聯網平臺控制臺產品頁查看，或調用QueryProductList查看ProductKey的取值。 |
| IotInstanceId | String | 否 | iot_instc_pu****_c*-v64******** | 實例ID。您可在物聯網平臺控制臺的實例概覽頁面，查看當前實例的ID。 重要
實例的更多信息，請參見實例概述。 |
| ResourceGroupId | String | 否 | rg-acfm4l5tcwd**** | 資源組ID。 重要 目前，物聯網平臺僅支持實例維度的資源組管理。請求參數ResourceGroupId配置已無效，無需再傳入。
|
| SourceModelVersion | String | 否 | V1.0.0 | 要復制的物模型版本號。 可以調用ListThingModelVersion，查看源物模型的版本號。 |
調用API時，除了本文介紹的該API的特有請求參數，還需傳入公共請求參數。公共請求參數說明，請參見公共參數文檔。
返回數據
| 名稱 | 類型 | 示例值 | 描述 |
|---|---|---|---|
| Code | String | iot.system.SystemException | 調用失敗時，返回的錯誤碼。更多信息，請參見錯誤碼。 |
| ErrorMessage | String | 系統異常 | 調用失敗時，返回的出錯信息。 |
| RequestId | String | E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565 | 阿里云為該請求生成的唯一標識符。 |
| Success | Boolean | true | 表示是否調用成功。
|
示例
請求示例
https://iot.cn-shanghai.aliyuncs.com/?Action=CopyThingModel
&ProductKeySource=a1rYuVF****
&ProductKeyTarget=a1bPo9p****
&SourceModelVersion=v1.0.0
&<公共請求參數>正常返回示例
XML格式
<CopyThingModelResponse>
<RequestId>9E76053E-26ED-4AB4-AE58-8AFC3F1E7E8E</RequestId>
<Success>true</Success>
</CopyThingModelResponse>JSON格式
{
"RequestId": "9E76053E-26ED-4AB4-AE58-8AFC3F1E7E8E",
"Success": true
}