すべてのプロダクト
Search

このプロダクト

    IoT Platform:CopyThingModel

    ドキュメントセンター

    IoT Platform:CopyThingModel

    最終更新日:Apr 17, 2025

    ソースプロダクトからデスティネーションプロダクトに Thing Specification Language（TSL）モデルをコピーします。

    使用上の注意

    • デスティネーションプロダクトが公開されている場合は、CancelReleaseProduct 操作を呼び出して、デスティネーションプロダクトの公開を停止してから、ソースプロダクトからデスティネーションプロダクトに TSL モデルをコピーする必要があります。

    • ソースプロダクトとデスティネーションプロダクトのカテゴリは同じである必要があります。プロダクトカテゴリは、CategoryKey パラメーターによって示されます。QueryProduct 操作を呼び出して、プロダクトの CategoryKey パラメーターを表示できます。

    • リクエストで SourceModelVersion パラメーターを使用して、コピーする TSL モデルのバージョンを指定する必要があります。指定しないと、CopyThingModel 操作は失敗します。

    QPS 制限

    この API 操作は、アカウントごとに 1 秒あたり最大 5 回呼び出すことができます。

    説明

    Alibaba Cloud アカウントの Resource Access Management（RAM）ユーザーは、アカウントのクォータを共有します。

    デバッグ

    OpenAPI Explorer は署名値を自動的に計算します。便宜上、OpenAPI Explorer でこの操作を呼び出すことをお勧めします。OpenAPI Explorer は、さまざまな SDK の操作のサンプルコードを動的に生成します。

    リクエストパラメーター

    パラメーター

    タイプ

    必須

    例

    説明

    Action

    String

    はい

    CopyThingModel

    実行する操作。値を CopyThingModel に設定します。

    SourceProductKey

    String

    はい

    a1BwAGV****

    ソースプロダクトの ProductKey。

    IoT Platform コンソールの [プロダクト] ページで ProductKey を表示できます。また、QueryProductList 操作を呼び出すことによって ProductKey を取得することもできます。

    TargetProductKey

    String

    はい

    a1BwwG0****

    デスティネーションプロダクトの ProductKey。

    IoT Platform コンソールの [プロダクト] ページで ProductKey を表示できます。ProductKey は、QueryProductList 操作を呼び出すことによっても取得できます。

    IotInstanceId

    String

    いいえ

    iot_instc_pu****_c*-v64********

    インスタンス ID。IoT Platform コンソールの 概要 タブでインスタンス ID を表示できます。

    重要

    • インスタンスに ID がある場合は、このパラメーターを指定する必要があります。このパラメーターを指定しないと、リクエストは失敗します。

    • IoT Platform コンソールに 概要 タブまたはインスタンス ID が表示されない場合は、このパラメーターを指定する必要はありません。

    インスタンスの詳細については、「概要」をご参照ください。

    ResourceGroupId

    String

    いいえ

    rg-acfm4l5tcwd****

    リソースグループ ID。

    重要

    IoT Platform は、インスタンスごとのみリソースグループ管理をサポートしています。ResourceGroupId は無効です。このパラメーターを指定する必要はありません。

    SourceModelVersion

    String

    いいえ

    V1.0.0

    コピーする TSL モデルのバージョン。

    ListThingModelVersion 操作を呼び出して、プロダクトの TSL モデルバージョンを表示できます。

    上記の操作固有のリクエストパラメーターに加えて、この操作を呼び出すときは、共通リクエストパラメーターを指定する必要があります。共通リクエストパラメーターの詳細については、「共通パラメーター」をご参照ください。

    レスポンスパラメーター

    パラメーター

    タイプ

    例

    説明

    Code

    String

    iot.system.SystemException

    リクエストが失敗した場合に返されるエラーコード。エラーコードの詳細については、「エラーコード」をご参照ください。

    ErrorMessage

    String

    システム例外が発生しました。

    リクエストが失敗した場合に返されるエラーメッセージ。

    RequestId

    String

    E55E50B7-40EE-4B6B-8BBE-D3ED55CCF565

    リクエスト ID。

    Success

    Boolean

    true

    リクエストが成功したかどうかを示します。有効な値：

    • true

    • false

    例

    リクエストの例

    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
}

    エラーコード

    エラーコードのリストについては、「サービスエラーコード」をご参照ください。