本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
配置存储设置 (Amazon CLI)
以下过程介绍如何配置存储设置以将替换为冷层Amazon CLI。
使用配置存储设置Amazon CLI
-
要将替换为您账户中的 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 } }注意
-
您必须在存储桶中使用相同的 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可能需要几分钟时间。
-
-
要检索存储配置信息,请运行以下命令。
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" }
-
要停止将数据导出到 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" } }
-
要检索存储配置信息,请运行以下命令。
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 存储桶,请先创建一个。有关更多信息,请参阅 Ama zon S3 用户指南中的。
-
您必须在存储配置、IAM 策略和Amazon IoT Analytics数据Amazon IoT SiteWise存储配置中使用相同的 Amazon S3 存储桶名称。
例 Amazon IoT Analytics数据存储配置
将 s3 存储段名称替换
和 Amazon S3 存储桶名称。data-store-name
为您的Amazon IoT Analytics数据存储名称
{ "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 } }