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

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

配置存储设置 (Amazon CLI）

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

使用配置存储设置Amazon CLI

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

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

    例 Amazon IoT SiteWise存储配置

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

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

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

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

    • Replaceretention-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 S3 存储桶名Amazon IoT SiteWise存储配置和 IAM 策略。

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

      例 权限策略

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

      Replacebucket-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）

网络 ACL 和安全组都允许 (因此可到达您的实例) 的发起 ping 的Amazon IoT Analyticsdata store 是一个可扩展且可查询的存储库，用于接收和存储数据。您可以使用Amazon IoT SiteWise控制台或Amazon IoT Analytics用于创建Amazon IoT Analytics数据存储来保存你的Amazon IoT SiteWiseDATA。要查询数据，您需要使用创建数据集Amazon IoT Analytics. 有关更多信息，请参阅 。使用Amazon IoT SiteWise数据中的Amazon IoT Analytics用户指南.

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

要创建数据存储，请运行以下命令。Replace文件名称使用包含数据存储配置的文件的名称。

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

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

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

例 Amazon IoT Analytics数据存储配置

Replacedata-store-name和s3-bucket-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
      }
  }