本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 运行批量导出作业
<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. `CreateMetadataTransferJob`通过运行以下 AWS CLI 命令来调用：

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

   使用您自己的传输文件名称替换输入 JSON 文件 `createMetadataTransferJobExport.json`。