一括エクスポートジョブの実行

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

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

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

注記

リクエストには複数のフィルターを含めることができます。一括オペレーションでは、いずれかのフィルターに一致するアセットモデルとアセットがエクスポートされます。

フィルターを指定しない場合、一括オペレーションはすべてのアセットモデルとアセットをエクスポートします。

例 フィルター付きのリクエスト本文

{
      "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:::your-S3-bucket-location"
          }
      }
}

メタデータのエクスポート (コンソール）

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

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

1. AWS IoT SiteWise コンソールに移動します。

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

3. 新しいエクスポートを選択してエクスポートプロセスを開始します。

4. メタデータのエクスポートページで、次の操作を行います。

   • エクスポートジョブの名前を入力します。これは、Amazon S3 バケット内のエクスポートされたファイルに使用される名前です。

   • エクスポートするリソースを選択すると、ジョブのフィルターが設定されます。

     • すべてのアセットとアセットモデルをエクスポートします。アセットとアセットモデルにフィルターを使用します。

     • アセットをエクスポートします。アセットをフィルタリングします。

       • エクスポートフィルターに使用するアセットを選択します。

       • （オプション) 子または関連するアセットモデルを追加します。

     • アセットモデルをエクスポートします。アセットモデルでフィルタリングします。

       • エクスポートフィルターに使用するアセットモデルを選択します。

       • （オプション) 子孫、関連するアセット、またはその両方を追加します。

     • [次へ] をクリックします。

   • Amazon S3 バケットに移動します。

     • Amazon S3 を参照 を選択して、Amazon S3 バケットとファイルを表示します。

     • ファイルを配置する必要がある Amazon S3 バケットに移動します。

     • [次へ] をクリックします。

   • エクスポートジョブを確認し、エクスポート を選択します。

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

メタデータのエクスポート時にフィルターを使用するさまざまな方法については、「」を参照してくださいメタデータのエクスポート例。

メタデータのエクスポート (AWS CLI）

次の手順では、 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:::your-S3-bucket-location"
           }
       }
   }

   メタデータ転送ジョブの送信先として Amazon S3 バケットを必ず指定してください。

   注記

   この例では、すべてのアセットモデルとアセットをエクスポートします。エクスポートを特定のアセットモデルまたはアセットに制限するには、リクエスト本文にフィルターを含めることができます。エクスポートフィルターの適用の詳細については、「」を参照してくださいメタデータのエクスポート例。

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

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

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

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