运行批量导出任务

批量导出是将元数据从 AWS IoT SiteWise 工作空间移动到 Amazon S3 存储桶的操作。

将 AWS IoT SiteWise 内容批量导出到 Amazon S3 时，您可以指定筛选条件来限制要导出的特定资产模型和资产。

必须在 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 存储桶中导出的文件所使用的名称。

   • 选择要导出的资源，这将为任务设置筛选条件：

     • 导出所有资产和资产模型。对资产和资产模型使用筛选器。

     • 导出资产。筛选您的资产。

       • 选择要用于导出筛选器的资源。

       • （可选）添加后代或关联的资产模型。

     • 导出资产模型。根据您的资产模型进行筛选。

       • 选择要用于导出筛选器的资产模型。

       • （可选）添加后代或关联资产，或两者兼而有之。

     • 选择下一步。

   • 导航到亚马逊 S3 存储桶：

     • 选择 “浏览亚马逊 S3” 以查看亚马逊 S3 存储桶和文件。

     • 导航到必须存放文件的 Amazon S3 存储桶。

     • 选择下一步。

   • 查看导出任务并选择导出。

5. 的 SiteWise 元数据批量操作页面在作业进度表中 AWS IoT SiteWise 控制台 显示新创建的导入任务。

有关导出元数据时使用筛选器的不同方法，请参阅导出元数据示例。

导出元数据 (AWS CLI)

以下过程解释了 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:::your-S3-bucket-location"
           }
       }
   }

   请务必将您的 Amazon S3 存储桶指定为元数据传输任务的目的地。

   注意

   此示例将导出您的所有资产模型和资产。要将导出限制为特定的资产模型或资产，您可以在请求正文中加入筛选器。有关应用导出筛选器的更多信息，请参阅导出元数据示例。

2. 保存您的请求正文文件，以便在下一步中使用。在本示例中，文件命名为 createMetadataTransferJobExport.json。

3. CreateMetadataTransferJob通过运行以下 AWS CLI 命令来调用：

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

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