配置存储设置 (Amazon CLI) - Amazon IoT SiteWise
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 Amazon Web Services 服务入门

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

配置存储设置 (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存储配置
    • 将存储桶名称替换为您的 Amazon S3 存储桶名称。

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

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

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

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

      注意

      Amazon IoT SiteWise将删除热层中任何早于保留期的数据。如果您未设置保留期,则您的数据将无限期存储。

    { "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 S3Amazon 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/*" ] } ] }

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

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

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

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

    aws iotsitewise describe-storage-configuration
    例 response
    { "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。

    例 response
    { "storageType": "SITEWISE_DEFAULT_STORAGE", "configurationStatus": { "state": "UPDATE_IN_PROGRESS" } }
  4. 要检索存储配置信息,请运行以下命令。

    aws iotsitewise describe-storage-configuration
    例 response
    { "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。

要创建数据存储,请运行以下命令。将文件名替换为包含数据存储配置的文件的名称。

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 } }
例 response
{ "datastoreName": "datastore_IoTSiteWise_demo", "datastoreArn": "arn:aws:iotanalytics:us-west-2:123456789012:datastore/datastore_IoTSiteWise_demo", "retentionPeriod": { "numberOfDays": 90, "unlimited": false } }