設定冷層的儲存設定 (AWS CLI) - AWS IoT SiteWise
(可選) 建立 AWS IoT Analytics 資料倉庫 (AWS CLI)

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

設定冷層的儲存設定 (AWS CLI)

下列程序說明如何設定儲存區設定，以便使用將資料複製到冷層 AWS CLI。

若要使用來設定儲存設定 AWS CLI

  1. 若要將資料匯出到帳戶中的 Amazon S3 儲存貯體，請執行以下命令來設定儲存設定。將檔案名稱取代為包含 AWS IoT SiteWise 儲存配置的檔案名稱。

    aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json
    範例 AWS IoT SiteWise 儲存設定

    • 將儲存貯體名稱取代為您的 Amazon S3 儲存貯體名稱。

    • 將前綴替換為您的 Amazon S3 前綴。

    • 請aws-account-id以您的 AWS 帳號 ID 取代。

    • 將角色名稱取代 AWS IoT SiteWise 為允許將資料傳送到 Amazon S3 的 Amazon S3 存取角色的名稱。

    • 以大於或等於 30 天的整數取retention-in-days代。

    {
      "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
      }
  }
    注意

    • 您必須在 AWS IoT SiteWise 儲存組態和 IAM 政策中使用相同的 Amazon 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/*"
              ]
          }
      ]
  }

      將儲存貯體名稱取代為您的 Amazon S3 儲存貯體的名稱。

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

    更新儲存設定可能需 AWS 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
    注意

    依預設，您的資料只會儲存在的常用層 AWS 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"
  }

(可選) 建立 AWS IoT Analytics 資料倉庫 (AWS CLI)

AWS IoT Analytics 資料存放區是可擴充且可查詢的儲存庫，可接收和儲存資料。您可以使用 AWS IoT SiteWise 主控台或 AWS IoT Analytics API 建立 AWS IoT Analytics 資料存放區以儲存資 AWS IoT SiteWise 料。若要查詢資料，請使用建立資料集 AWS IoT Analytics。若要取得更多資訊，請參閱《使用指南》中的AWS IoT Analytics 〈處理資 AWS IoT SiteWise 料〉。

下列步驟 AWS CLI 可用於在中建立資料倉庫 AWS IoT Analytics。

若要建立資料倉庫，請執行下列命令。以包含資料倉庫規劃的檔案名稱取代檔案名稱。

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

  • 您必須指定現有 Amazon S3 儲存貯體的名稱。如果您沒有 Amazon S3 儲存貯體，請先建立一個儲存貯體。如需詳細資訊，請參閱 Amazon S3 使用者指南中的建立您的第一個 S3 儲存貯體。

  • 您必須在 AWS IoT SiteWise 儲存組態、IAM 政策和 AWS IoT Analytics 資料存放區組態中使用相同的 Amazon S3 儲存貯體名稱。

範例 AWS IoT Analytics 資料倉庫規劃

使用您的資料存放區名稱data-store-name和 Amazon S3 儲存貯體名稱取代和 S3 AWS 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
      }
  }