本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 執行大量匯出任務
<a name="running-bulk-operations-export"></a>

 大量匯出是將中繼資料從 AWS IoT SiteWise 工作區移至 Amazon S3 儲存貯體的動作。

當您將 AWS IoT SiteWise 內容大量匯出至 Amazon S3 時，您可以指定篩選條件來限制您要匯出的特定資產模型和資產。

篩選條件必須在 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 匯出動作：

**從 匯出資料 AWS IoT SiteWise 至 Amazon S3**

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`為您自己的傳輸檔案名稱。