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

# アセットとモデルを使用した一括オペレーション
<a name="bulk-operations-assets-and-models"></a>

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

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


**Topics**
+ [主要な概念と用語](#bulk-operations-terminology)
+ [サポートされている機能](#bulk-operations-functionality)
+ [一括操作の前提条件](bulk-operations-prereqs.md)
+ [一括インポートジョブを実行する](running-bulk-operations-import.md)
+ [一括エクスポートジョブを実行する](running-bulk-operations-export.md)
+ [ジョブの進捗状況追跡とエラー処理](jobs-progress-error-handling.md)
+ [メタデータのインポート例](bulk-operations-import-metadata-example.md)
+ [メタデータのエクスポート例](bulk-operations-export-filter-examples.md)
+ [AWS IoT SiteWise メタデータ転送ジョブスキーマ](bulk-operations-schema.md)

## 主要な概念と用語
<a name="bulk-operations-terminology"></a>

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` の実行時に作成されたオブジェクト。

## サポートされている機能
<a name="bulk-operations-functionality"></a>

このトピックでは、一括操作を実行するときにできることについて説明します。一括操作は、以下の機能をサポートしています。
+ **最上位リソースの作成:** ID を定義しないアセットまたはアセットモデル、または ID が既存のものと一致しないアセットモデルをインポートすると、新しいリソースとして作成されます。
+ **最上位リソースの置換:** ID が既存のものと一致するアセットまたはアセットモデルをインポートすると、既存のリソースが置き換えられます。
+ **サブリソースの作成、置換、または削除:** インポートによってアセットやアセットモデルなどの最上位のリソースが置き換えられると、新しい定義によって、プロパティ、階層、複合モデルなど、すべてのサブリソースが置き換えられます。

  例えば、一括インポート中にアセットモデルを更新し、更新されたバージョンで元は存在しなかったプロパティが定義されると、新しいプロパティが作成されます。既に存在するプロパティが定義された場合、既存のプロパティが更新されます。更新されたアセットモデルで元々存在するプロパティが省略された場合、そのプロパティは削除されます。
+ **最上位以外のリソースの削除:** 一括操作ではアセットまたはアセットモデルは削除されません。一括オペレーションは、作成または更新のみを行います。