Configure storage settings (console) - Amazon IoT SiteWise
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

Configure storage settings (console)

The following procedure shows you how to configure the storage settings to replicate data to the cold tier in the Amazon IoT SiteWise console.

To configure storage settings in the console

  1. Navigate to the Amazon IoT SiteWise console.

  2. In the navigation pane, under Settings, choose Storage.

  3. In the upper-right corner, choose Edit.

  4. On the Edit storage page, do the following:

    1. For Storage settings, choose Enable cold tier storage. The cold tier storage is disabled by default.

    2. For S3 bucket location, enter the name of an existing Amazon S3 bucket and a prefix.

      • Amazon S3 uses the prefix as a folder name in the Amazon S3 bucket. The prefix must have 1-255 characters and end with a forward slash (/). Your Amazon IoT SiteWise data is saved in this folder.

      • If you don't have an Amazon S3 bucket, choose View, and then create one in the Amazon S3 console. For more information, see Create your first S3 bucket in the Amazon S3 User Guide.

    3. For S3 access role, do one of the following:

      • Choose Create a role from an Amazon managed template, Amazon automatically creates an IAM role that allows Amazon IoT SiteWise to send data to Amazon S3.

      • Choose Use an existing role, and then choose the role that you created from the list.

        • You must use the same Amazon S3 bucket name for the S3 bucket location that you used in the previous step and in your IAM policy.

        • Make sure that your role has the permissions shown in the following example.

          Example permissions policy

          { "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 with the name of your Amazon S3 bucket.

    4. (Optional) For Hot tier settings, do the following.

      1. If you want to set a retention period for how long your data is stored in the hot tier before it's deleted, choose Enable retention period.

      2. To configure a retention period, enter a whole number and choose a unit. The retention period must be greater than or equal to 30 days.

      Amazon IoT SiteWise will delete any data in the hot tier that's older than the retention period. If you don't set a retention period, your data is stored indefinitely.

    5. (Optional) For Amazon IoT Analytics integration, do the following.

      1. If you want to use Amazon IoT Analytics to query your data, choose Enabled Amazon IoT Analytics data store.

      2. Amazon IoT SiteWise generates a name for your data store or you can enter a different name.

      Amazon IoT SiteWise automatically creates a data store in Amazon IoT Analytics to save your data. To query the data, you can use Amazon IoT Analytics to create datasets. For more information, see Working with Amazon IoT SiteWise data in the Amazon IoT Analytics User Guide.

    6. Choose Save.

In the Amazon IoT SiteWise storage section, the Cold tier storage can be one of the following values:

  • Enabled – Amazon IoT SiteWise replicates your data to the specified Amazon S3 bucket.

  • Enabling – Amazon IoT SiteWise is processing your request to enable the cold tier storage. This process can take several minutes to complete.

  • Enable_Failed – Amazon IoT SiteWise couldn't process your request to enable the cold tier storage. If you enabled Amazon IoT SiteWise to send logs to Amazon CloudWatch Logs, you can use these logs to troubleshoot issues. For more information, see Monitoring Amazon IoT SiteWise with Amazon CloudWatch Logs.

  • Disabled – The cold tier storage is disabled.