一括エクスポートジョブを実行する - AWS IoT SiteWise
メタデータのエクスポート (コンソール）メタデータのエクスポート (AWS CLI）

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

一括エクスポートジョブを実行する

一括エクスポートは、 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:::amzn-s3-demo-bucket"
          }
      }
}

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

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

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

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

  2. ナビゲーションペインから「一括操作」を選択します。

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

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

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

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

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

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

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

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

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

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

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

      • [Next (次へ)] を選択します。

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

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

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

      • [Next (次へ)] を選択します。

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

  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:::amzn-s3-demo-bucket"
        }
    }
}

    メタデータ転送ジョブの送信先として 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に置き換えます。