設定儲存區設定

在主控台中設定儲存設定

1. 導覽至 AWS IoT SiteWise 主控台。

2. 在功能窗格的 [設定] 下，選擇 [儲存空間]。

3. 在右上角，選擇 Edit (編輯)。

4. 在 [編輯儲存空間] 頁面上，執行下列動作：

5. 對於熱層設定，請執行下列動作：

   • 如果您想要設定資料在刪除資料並移至服務管理暖層儲存體之前儲存在常用層中的時間長度的保留期間，請選擇 [啟用保留期]。

   • 若要設定保留期間，請輸入整數並選擇單位。保留期必須大於或等於 30 天。

   AWS IoT SiteWise 刪除常用層中早於保留期限的任何資料。如果您未設定保留期限，系統就會無限期儲存您的資料。

6. (建議使用) 對於「暖」層設定，請執行下列動作：

   • 若要選擇加入暖階層儲存體，請選取 [我確認選擇加入暖層儲存體] 以選擇加入暖階層儲存體。

   • (選擇性) 若要設定保留期間，請輸入整數並選擇單位。保留期必須大於或等於 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 使用您的 Amazon 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
      }
  }

  範例 response

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

在主控台中設定儲存設定

1. 導覽至 AWS IoT SiteWise 主控台。

2. 在功能窗格的 [設定] 下，選擇 [儲存空間]。

3. 在右上角，選擇 Edit (編輯)。

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政策中使用的 S3 儲存貯體位置，您必須使用相同的 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/*"
                        ]
                    }
                ]
            }

          Replace (取代) bucket-name 使用您的 Amazon S3 存儲桶的名稱。

        • 如果 S3 儲存貯體使用客戶受管KMS金鑰加密，則該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. 選擇 Save (儲存)。

若要使用來設定儲存設定 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 使用您的 Amazon 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
         }
     }

   注意

   • 您必須在 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/*"
                   ]
               }
           ]
       }

     Replace (取代) bucket-name 使用您的 Amazon S3 存儲桶的名稱。

   • 如果 S3 儲存貯體使用客戶受管KMS金鑰加密，則該KMS金鑰必須具有IAM角色kms:Decrypt和kms:GenerateDataKey操作的存取政策。

   範例 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"
     }