アセットとモデルによる一括オペレーション - AWS IoT SiteWise
主要な概念と用語サポートされている機能

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

アセットとモデルによる一括オペレーション

多数のアセットまたはアセットモデルを使用するには、一括操作を使用してリソースを別の場所に一括インポートおよびエクスポートします。例えば、Amazon S3 バケット内のアセットまたはアセットモデルを定義するデータファイルを作成し、一括インポートを使用して で作成または更新できます AWS IoT SiteWise。または、 に多数のアセットまたはアセットモデルがある場合は AWS IoT SiteWise、それらを Amazon S3 にエクスポートできます。

注記

で一括オペレーションを実行する AWS IoT SiteWise には、 で オペレーションを呼び出します AWS IoT TwinMaker API。これは、 AWS IoT TwinMaker ワークスペースを設定 AWS IoT TwinMaker または作成しなくても実行できます。必要なのは、 AWS IoT SiteWise コンテンツを配置できる Amazon S3 バケットだけです。

トピック

主要な概念と用語

AWS IoT SiteWise 一括インポートおよびエクスポート機能は、以下の概念と用語に依存しています。

  • インポート: Amazon S3 バケット内のファイルから にアセットまたはアセットモデルを移動するアクション AWS IoT SiteWise。

  • エクスポート: アセットまたはアセットモデルを から AWS IoT SiteWise Amazon S3 バケットに移動するアクション。

  • ソース : コンテンツの移動元の の開始場所。

    例えば、Amazon S3 バケットはインポートソースであり、 AWS IoT SiteWise はエクスポートソースです。

  • 送信先 : コンテンツの移動先となる の希望の場所。

    例えば、Amazon S3 バケットはエクスポート先であり、 はインポート先 AWS IoT SiteWise です。

  • AWS IoT SiteWise スキーマ : このスキーマは、 からメタデータをインポートおよびエクスポートするために使用されます AWS IoT SiteWise。

  • 最上位リソース： アセットやアセットモデルなど、個別に作成または更新できる AWS IoT SiteWise リソース。

  • サブリソース： 最上位 AWS IoT SiteWise リソース内のネストされたリソース。例としては、プロパティ、階層、複合モデルなどがあります。

  • メタデータ: リソースを正常にインポートまたはエクスポートするために必要なキー情報。メタデータの例としては、アセットとアセットモデルの定義があります。

  • metadataTransferJob: の実行時に作成されたオブジェクトCreateMetadataTransferJob。

サポートされている機能

このトピックでは、一括オペレーションを実行するときに実行できる操作について説明します。一括オペレーションは、次の機能をサポートしています。

  • 最上位のリソース作成： ID を定義しないアセットまたはアセットモデルをインポートする場合、または ID が既存のものと一致しない場合、新しいリソースとして作成されます。

  • 最上位のリソース置換： ID が既存のリソースと一致するアセットまたはアセットモデルをインポートすると、既存のリソースが置き換えられます。

  • サブリソースの作成、置換、削除： インポートがアセットやアセットモデルなどの最上位のリソースを置き換えると、プロパティ、階層、複合モデルなどのすべてのサブリソースが新しい定義に置き換えられます。

    例えば、一括インポート中にアセットモデルを更新し、更新されたバージョンで元の に存在しなかったプロパティを定義すると、新しいプロパティが作成されます。既に存在するプロパティを定義すると、既存のプロパティが更新されます。更新されたアセットモデルが元の に存在するプロパティを省略すると、 プロパティは削除されます。

  • 最上位リソースの削除なし： 一括オペレーションでは、アセットまたはアセットモデルは削除されません。一括オペレーションは、作成または更新のみを行います。