配置冷层的存储设置 (Amazon CLI) - Amazon IoT SiteWise
（可选）创建 Amazon IoT Analytics 数据存储 (Amazon CLI)
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

配置冷层的存储设置 (Amazon CLI)

以下过程演示如何配置存储设置以使用 Amazon CLI将数据复制到冷层。

使用配置存储设置 Amazon CLI

  1. 要将数据导出到您账户中的 Amazon S3 存储桶，请运行以下命令以配置存储设置。将文件名替换为包含 Amazon IoT SiteWise 存储配置的文件的名称。

    aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json
    例 Amazon IoT SiteWise 存储配置

    • 将 bucket-name 替换为您的 Amazon S3 存储桶的名称。

    • 将前缀替换为您的 Amazon S3 前缀。

    • aws-account-id替换为您的 Amazon 账户 ID。

    • 将角色名称替换为允许 Amazon IoT SiteWise 向 Amazon S3 发送数据的 Amazon S3 访问角色的名称。

    • retention-in-days替换为大于或等于 30 天的整数。

    {
      "storageType": "MULTI_LAYER_STORAGE",
      "multiLayerStorage": {
          "customerManagedS3Storage": {
              "s3ResourceArn": "arn:aws:s3:::bucket-name/prefix/",
              "roleArn": "arn:aws:iam::aws-account-id:role/role-name"
          }
      }, 
      "retentionPeriod": { 
          "numberOfDays": retention-in-days,
          "unlimited": false
      }
  }
    注意

    • 您必须在存储配置和 IAM 策略中使用相同的 Amazon S3 Amazon IoT SiteWise 存储桶名称。

    • 确保您的角色具有以下示例中显示的权限。

      例 权限策略：
      {
      "Version": "2012-10-17",
      "Statement": [
          {
              "Effect": "Allow",
              "Action": [
                  "s3:PutObject",
                  "s3:GetObject",
                  "s3:DeleteObject",
                  "s3:GetBucketLocation",
                  "s3:ListBucket"
              ],
              "Resource": [
                  "arn:aws:s3:::bucket-name",
                  "arn:aws:s3:::bucket-name/*"
              ]
          }
      ]
  }

      将 bucket-name 替换为您的 Amazon S3 存储桶的名称。

    例 响应
    {
    "storageType": "MULTI_LAYER_STORAGE",
    "retentionPeriod": {
        "numberOfDays": 100,
        "unlimited": false
    },
    "configurationStatus": {
        "state": "UPDATE_IN_PROGRESS"
    }
}
    注意

    更新存储配置可能需要几分钟。 Amazon IoT SiteWise

  2. 若要检索存储配置信息，请运行以下命令。

    aws iotsitewise describe-storage-configuration
    例 响应
    {
      "storageType": "MULTI_LAYER_STORAGE",
      "multiLayerStorage": {
          "customerManagedS3Storage": {
              "s3ResourceArn": "arn:aws:s3:::DOC-EXAMPLE-BUCKET/torque/",
              "roleArn": "arn:aws:iam::123456789012:role/SWAccessS3Role"
          }
      },
      "retentionPeriod": { 
          "numberOfDays": 100,
          "unlimited": false
      },
      "configurationStatus": {
          "state": "ACTIVE"
      },
      "lastUpdateDate": "2021-03-30T15:54:14-07:00"
  }

  3. 要停止将数据导出到 Amazon S3 存储桶，请运行以下命令以配置存储设置。

    aws iotsitewise put-storage-configuration --storage-type SITEWISE_DEFAULT_STORAGE
    注意

    默认情况下，您的数据仅存储在热门层中 Amazon IoT SiteWise。

    例 响应
    {
      "storageType": "SITEWISE_DEFAULT_STORAGE",
      "configurationStatus": {
          "state": "UPDATE_IN_PROGRESS"
      }
  }

  4. 若要检索存储配置信息，请运行以下命令。

    aws iotsitewise describe-storage-configuration
    例 响应
    {
      "storageType": "SITEWISE_DEFAULT_STORAGE",
      "configurationStatus": {
          "state": "ACTIVE"
      },
      "lastUpdateDate": "2021-03-30T15:57:14-07:00"
  }

（可选）创建 Amazon IoT Analytics 数据存储 (Amazon CLI)

Amazon IoT Analytics 数据存储是一种可扩展且可查询的存储库，用于接收和存储数据。您可以使用 Amazon IoT SiteWise 控制台或 Amazon IoT Analytics API 创建 Amazon IoT Analytics 数据存储以保存 Amazon IoT SiteWise 数据。要查询数据，请使用创建数据集 Amazon IoT Analytics。有关更多信息，请参阅《Amazon IoT Analytics 用户指南》中的使用 Amazon IoT SiteWise 数据。

以下步骤 Amazon CLI 用于在中创建数据存储 Amazon IoT Analytics。

若要创建数据集，运行以下命令。将 file-name 替换为包含数据存储配置的文件的名称。

aws iotanalytics create-datastore --cli-input-json file://file-name.json
注意

  • 您必须指定现有 Amazon S3 存储桶的名称。如果没有 Amazon S3 存储桶，请先创建一个。有关更多信息，请参阅 Amazon S3 用户指南中的创建您的第一个 S3 存储桶。

  • 您必须在存储配置、IAM 策略和 Amazon IoT Analytics 数据 Amazon IoT SiteWise 存储配置中使用相同的 Amazon S3 存储桶名称。

例 Amazon IoT Analytics 数据存储配置

将 s3 存储桶名称替换data-store-name为您的 Amazon IoT Analytics 数据存储名称和 Amazon S3 存储桶名称。

{
      "datastoreName": "data-store-name",
      "datastoreStorage": {
          "iotSiteWiseMultiLayerStorage": {
              "customerManagedS3Storage": {
                  "bucket": "s3-bucket-name"
              }
          }
      },
      "retentionPeriod": {
          "numberOfDays": 90
      }
  }
例 响应
{
      "datastoreName": "datastore_IoTSiteWise_demo",
      "datastoreArn": "arn:aws:iotanalytics:us-west-2:123456789012:datastore/datastore_IoTSiteWise_demo",
      "retentionPeriod": {
          "numberOfDays": 90,
          "unlimited": false
      }
  }