配置存储设置

若要配置控制台中的存储设置

1. 导航到 AWS IoT SiteWise 控制台。

2. 在导航窗格中的设置下，选择存储。

3. 在右上角，选择 编辑。

4. 在编辑存储页面中，执行以下操作：

5. 对于热门等级设置，请执行以下操作：

   • 如果要为数据在删除之前在热层中存储的时间设置保留期，并移至服务托管的温层存储，请选择启用保留期。

   • 要配置保留期，请输入整数并选择单位。保留期必须大于或等于 30 天。

   AWS IoT SiteWise 删除热门层中所有早于保留期的数据。如果未设置保留期，则数据将无限期存储。

6. （推荐）对于 Warm 等级设置，请执行以下操作：

   • 要选择使用温层存储，请选择我确认加入温层存储，选择加入温层存储。

   • （可选）要配置保留期，请输入整数并选择一个单位。保留期必须大于或等于 365 天。

   AWS IoT SiteWise 删除在保留期之前存在的温层中的数据。如果未设置保留期，则数据将无限期存储。

   注意

   • 当您选择使用暖层时，配置仅显示一次。

   • 要设置热层保留期，您必须有温层或冷层存储。为了提高成本效益和检索历史数据， AWS IoT SiteWise 建议您将长期数据存储在温层。

   • 要设置热层保留，必须有冷层存储。

7. 选择 “保存” 以保存您的存储设置。

使用 AWS CLI 现有冷层存储配置存储设置

• 运行以下命令来配置存储设置。Replace（替换） file-name 使用包含 AWS IoT SiteWise 存储配置的文件的名称。

  aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json

  例 AWS IoT SiteWise 存储配置

  • Replace（替换） bucket-name 使用您的 Amazon S3 存储桶名称。

  • Replace（替换） prefix 使用您的亚马逊 S3 前缀。

  • Replace（替换） aws-account-id 使用您的 AWS 账户 ID。

  • Replace（替换） role-name 使用允许 AWS IoT SiteWise 向 Amazon S3 发送数据的 Amazon S3 访问角色的名称。

  • Replace（替换） hot-tier-retention-in-days 整数大于或等于 30 天。

  • Replace（替换） warm-tier-retention-in-days 整数大于或等于 365 天。

  注意

  AWS 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"
                }
            },
      "disassociatedDataStorage": "ENABLED",
      "retentionPeriod": {
        "numberOfDays": hot-tier-retention-in-days
      },
      "warmTier": "ENABLED",
      "warmTierRetentionPeriod": {
        "numberOfDays": warm-tier-retention-in-days
      }
  }

  例 响应

  {
        "storageType": "MULTI_LAYER_STORAGE",
        "configurationStatus": {
          "state": "UPDATE_IN_PROGRESS"
         }
  }

若要配置控制台中的存储设置

1. 导航到 AWS IoT SiteWise 控制台。

2. 在导航窗格中的设置下，选择存储。

3. 在右上角，选择 编辑。

4. 在编辑存储页面中，执行以下操作：

   1. 对于 存储设置，选择 启用冷层存储。默认情况下，冷层存储处于禁用状态。

   2. 对于 S3 存储桶位置，输入现有 Amazon S3 存储桶的名称和前缀。

      注意

      • Amazon S3 使用前缀作为 Amazon S3 存储桶中的文件夹名称。前缀必须包含 1-255 个字符，并以正斜杠 (/) 结尾。您的 AWS IoT SiteWise 数据将保存在此文件夹中。

      • 如果您没有 Amazon S3 存储桶，请选择 查看，然后在 Amazon S3 控制台中创建一个存储桶。有关更多信息，请参阅 Amazon S3 用户指南中的创建您的第一个 S3 存储桶。

   3. 对于 S3 访问角色，执行下列操作之一：

      • 选择从 AWS 托管模板创建角色， AWS 自动创建一个允许 AWS IoT SiteWise 向 Amazon S3 发送数据的IAM角色。

      • 选择使用现有角色，然后从列表中选择您创建的角色。

        注意

        • 您必须使用与上一步和IAM策略中相同的 Amaz on S3 存储桶名称作为 S3 存储桶位置。

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

          例 权限策略：

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

          Replace（替换） bucket-name 使用您的 Amazon S3 存储桶的名称。

        • 如果使用客户托管KMS密钥对 S3 存储桶进行加密，则该KMS密钥必须具有具有IAM角色kms:Decrypt和kms:GenerateDataKey操作的访问策略。

   4. 要设置热门等级，请参阅中的步骤 5 配置暖层（控制台）的存储设置。

   5. （可选）对于 AWS IoT Analytics 集成，请执行以下操作。

      1. 如果要使用 AWS IoT Analytics 来查询数据，请选择已启用 AWS IoT Analytics 数据存储。

      2. AWS IoT SiteWise 为您的数据存储生成一个名称，也可以输入其他名称。

      AWS IoT SiteWise 自动在中创建数据存储 AWS IoT Analytics 以保存您的数据。要查询数据，您可以使用 AWS IoT Analytics 创建数据集。有关更多信息，请参阅《AWS IoT Analytics 用户指南》中的使用 AWS IoT SiteWise 数据。

   6. 选择保存。

要使用配置存储设置 AWS CLI

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

   aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json

   例 AWS IoT SiteWise 存储配置

   • Replace（替换） bucket-name 使用您的 Amazon S3 存储桶名称。

   • Replace（替换） prefix 使用您的亚马逊 S3 前缀。

   • Replace（替换） aws-account-id 使用您的 AWS 账户 ID。

   • Replace（替换） role-name 使用允许 AWS IoT SiteWise 向 Amazon S3 发送数据的 Amazon S3 访问角色的名称。

   • Replace（替换） 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 AWS 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/*"
                   ]
               }
           ]
       }

     Replace（替换） bucket-name 使用您的 Amazon S3 存储桶的名称。

   • 如果使用客户托管KMS密钥对 S3 存储桶进行加密，则该KMS密钥必须具有具有IAM角色kms:Decrypt和kms:GenerateDataKey操作的访问策略。

   例 响应

   {
       "storageType": "MULTI_LAYER_STORAGE",
       "retentionPeriod": {
           "numberOfDays": 100,
           "unlimited": false
       },
       "configurationStatus": {
           "state": "UPDATE_IN_PROGRESS"
       }
   }

   注意

   更新存储配置可能需要几分钟。 AWS 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

   注意

   默认情况下，您的数据仅存储在热门层中 AWS 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"
     }