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

# 一括エクスポートジョブを実行する
<a name="running-bulk-operations-export"></a>

 一括エクスポートは、 AWS IoT SiteWise ワークスペースから Amazon S3 バケットにメタデータを移動するアクションです。

Amazon S3 への AWS IoT SiteWise コンテンツの一括エクスポートを実行する場合、エクスポートする特定のアセットモデルとアセットを制限するフィルターを指定できます。

フィルターは、JSON リクエストのソースセクション内の `iotSiteWiseConfiguration` セクションで指定する必要があります。

**注記**  
 複数のフィルターをリクエストに含めることができます。一括オペレーションでは、いずれかのフィルターに一致するアセットモデルとアセットがエクスポートされます。  
 フィルターを指定しなかった場合、一括オペレーションはすべてのアセットモデルとアセットをエクスポートします。

**Example フィルターを使用したリクエスト本文**  

```
{
      "metadataTransferJobId": "your-transfer-job-id",
      "sources": [
       {
        "type": "iotsitewise",
        "iotSiteWiseConfiguration": {
          "filters": [
           {
              "filterByAssetModel": {
                  "assetModelId": "asset model ID"
              }
            },
            {
              "filterByAssetModel": {
                  "assetModelId": "asset model ID",
                  "includeAssets": true
              }
            },
            {
              "filterByAssetModel": {
                  "assetModelId": "asset model ID",
                  "includeOffspring": true
               }
             }
           ]
          }
        }
       ],
       "destination": {
          "type": "s3",
          "s3Configuration": {
            "location": "arn:aws:s3:::amzn-s3-demo-bucket"
          }
      }
}
```

## メタデータをエクスポート (コンソール)
<a name="export-metadata-console"></a>

次の手順で、コンソールのエクスポートアクションについて説明します。

**でエクスポートジョブを作成する AWS IoT SiteWise コンソール**

1.  [AWS IoT SiteWise コンソール](https://console.aws.amazon.com/iotsitewise/)に移動します。

1. ナビゲーションペインから **[一括オペレーション 新規]** を選択します。

1. **[新規エクスポート]** を選択して、エクスポートプロセスを開始します。

1. **[メタデータをエクスポート]** ページで、以下の操作を行います。
   +  エクスポートジョブの名前を入力します。これは、Amazon S3 バケットでエクスポートされたファイルに使用される名前です。
   + エクスポートするリソースを選択します。これによって、ジョブのフィルターが設定されます。
     + すべてのアセットとアセットモデルをエクスポートします。アセットとアセットモデルにフィルターを使用します。
     + アセットをエクスポートします。アセットをフィルタリングします。
       + エクスポートフィルターに使用するアセットを選択します。
       + (オプション) 子または関連するアセットモデルを追加します。
     + アセットモデルをエクスポートします。アセットモデルをフィルタリングします。
       + エクスポートフィルターに使用するアセットモデルを選択します。
       + (オプション) 子、または関連するアセット、またはその両方を追加します。
     + [**次へ**] を選択します。
   + Amazon S3 バケットに移動します。
     + **[Amazon S3 を参照]** を選択して、Amazon S3 バケットとファイルを表示します。
     + ファイルを配置する必要がある Amazon S3 バケットに移動します。
     + [**次へ**] を選択します。
   + エクスポートジョブを確認して、**[エクスポート]** を選択します。

1. の ** SiteWise メタデータページの一括オペレーション**では、新しく作成されたインポートジョブが**ジョブの進行状況**テーブル AWS IoT SiteWise コンソール に表示されます。

メタデータのエクスポート時にフィルターを使用するさまざまな方法については、「[メタデータのエクスポート例](bulk-operations-export-filter-examples.md)」を参照してください。

## メタデータをエクスポート (AWS CLI)
<a name="export-metadata-cli"></a>

次の手順では、 AWS CLI エクスポートアクションについて説明します。

**から Amazon S3 AWS IoT SiteWise にデータをエクスポートする**

1. リクエスト本文を含んだ JSON ファイルを作成します。リクエスト本文では、転送ジョブの送信元と送信先を指定します。次の例はリクエスト本文の例を示しています。

   ```
   {
       "metadataTransferJobId": "{{your-transfer-job-Id}}",
       "sources": [{
           "type": "iotsitewise"
       }],
       "destination": {
           "type": "s3",
           "s3Configuration": {
               "location": "arn:aws:s3:::{{amzn-s3-demo-bucket}}"
           }
       }
   }
   ```

   メタデータ転送ジョブの送信先として Amazon S3 バケットを必ず指定してください。
**注記**  
この例では、すべてのアセットモデルとアセットをエクスポートします。エクスポートを特定のアセットモデルまたはアセットに制限するには、リクエスト本文にフィルターを含めることができます。エクスポートフィルターの適用の詳細については、「[メタデータのエクスポート例](bulk-operations-export-filter-examples.md)」を参照してください。

1. 次のステップで使用するリクエスト本文ファイルを保存します。この例では、ファイル名は `createMetadataTransferJobExport.json` です。

1. 次の AWS CLI コマンド`CreateMetadataTransferJob`を実行して を呼び出します。

   ```
   aws iottwinmaker create-metadata-transfer-job --region us-east-1 \ 
            --cli-input-json file://createMetadataTransferJobExport.json
   ```

   入力 JSON ファイル `createMetadataTransferJobExport.json` をユーザー独自の転送ファイル名に置き換えます。