Konfigurasikan pengaturan penyimpanan

Untuk mengkonfigurasi pengaturan penyimpanan di konsol

1. Navigasikan ke konsol AWS IoT SiteWise tersebut.

2. Di panel navigasi, di bawah Pengaturan, pilih Penyimpanan.

3. Di sudut kanan atas, pilih Edit.

4. Pada halaman Edit penyimpanan, lakukan hal berikut:

5. Untuk pengaturan Hot tier, lakukan hal berikut:

   • Jika Anda ingin menetapkan periode retensi untuk berapa lama data disimpan di hot tier sebelum dihapus, dan dipindahkan ke penyimpanan tingkat hangat yang dikelola layanan, pilih Aktifkan periode retensi.

   • Untuk mengonfigurasi periode retensi, masukkan bilangan bulat dan pilih unit. Periode retensi harus lebih besar dari atau sama dengan 30 hari.

   AWS IoT SiteWise menghapus data apa pun di tingkat panas yang lebih lama dari periode retensi. Jika Anda tidak menetapkan periode retensi, data Anda disimpan tanpa batas waktu.

6. (Disarankan) Untuk pengaturan tingkat hangat, lakukan hal berikut:

   • Untuk memilih penyimpanan tingkat hangat, pilih Saya mengonfirmasi keikutsertaan penyimpanan tingkat hangat untuk memilih penyimpanan tingkat hangat.

   • (Opsional) Untuk mengonfigurasi periode retensi, masukkan bilangan bulat dan pilih unit. Periode retensi harus lebih besar dari atau sama dengan 365 hari.

   AWS IoT SiteWise menghapus data di tingkat hangat yang ada lebih awal dari periode retensi. Jika Anda tidak menetapkan periode retensi, data Anda disimpan tanpa batas waktu.

   catatan

   • Saat Anda memilih tingkat hangat, konfigurasi hanya akan ditampilkan sekali.

   • Untuk mengatur retensi tingkat panas, Anda harus memiliki penyimpanan tingkat hangat atau dingin. Untuk efisiensi biaya dan pengambilan data historis, AWS IoT SiteWise rekomendasikan agar Anda menyimpan data jangka panjang di tingkat hangat.

   • Untuk mengatur retensi tingkat hangat, Anda harus memiliki penyimpanan tingkat dingin.

7. Pilih Simpan untuk menyimpan pengaturan penyimpanan Anda.

Konfigurasikan pengaturan penyimpanan menggunakan AWS CLI penyimpanan tingkat dingin yang ada

• Jalankan perintah berikut untuk mengkonfigurasi pengaturan penyimpanan. Ganti file-name dengan nama file yang berisi konfigurasi AWS IoT SiteWise penyimpanan.

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

  contoh AWS IoT SiteWise konfigurasi penyimpanan

  • Ganti bucket-name dengan nama bucket Amazon S3 Anda.

  • Ganti prefix dengan awalan Amazon S3 Anda.

  • Ganti aws-account-id dengan ID AWS akun Anda.

  • Ganti role-name dengan nama peran akses Amazon S3 yang memungkinkan AWS IoT SiteWise untuk mengirim data ke Amazon S3.

  • Ganti hot-tier-retention-in-days dengan bilangan bulat lebih besar dari atau sama dengan 30 hari.

  • Ganti warm-tier-retention-in-days dengan bilangan bulat lebih besar dari atau sama dengan 365 hari.

  catatan

  AWS IoT SiteWise akan menghapus data apa pun di tingkat hangat yang lebih tua dari periode retensi tingkat dingin. Jika Anda tidak menetapkan periode retensi, data Anda disimpan tanpa batas waktu.

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

  contoh response

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

Untuk mengkonfigurasi pengaturan penyimpanan di konsol

1. Navigasikan ke konsol AWS IoT SiteWise tersebut.

2. Di panel navigasi, di bawah Pengaturan, pilih Penyimpanan.

3. Di sudut kanan atas, pilih Edit.

4. Pada halaman Edit penyimpanan, lakukan hal berikut:

   1. Untuk pengaturan Penyimpanan, pilih Aktifkan penyimpanan tingkat dingin. Penyimpanan tingkat dingin dinonaktifkan secara default.

   2. Untuk lokasi bucket S3, masukkan nama bucket Amazon S3 yang ada dan awalan.

      catatan

      • Amazon S3 menggunakan awalan sebagai nama folder di bucket Amazon S3. Awalan harus memiliki 1-255 karakter dan diakhiri dengan garis miring (/). AWS IoT SiteWise Data Anda disimpan di folder ini.

      • Jika Anda tidak memiliki bucket Amazon S3, pilih View, lalu buat bucket di konsol Amazon S3. Untuk informasi selengkapnya, lihat Membuat bucket S3 pertama Anda di Panduan Pengguna Amazon S3.

   3. Untuk peran akses S3, lakukan salah satu hal berikut:

      • Pilih Buat peran dari templat AWS terkelola, AWS secara otomatis membuat IAM peran yang memungkinkan AWS IoT SiteWise untuk mengirim data ke Amazon S3.

      • Pilih Gunakan peran yang ada, lalu pilih peran yang Anda buat dari daftar.

        catatan

        • Anda harus menggunakan nama bucket Amazon S3 yang sama untuk lokasi bucket S3 yang Anda gunakan pada langkah sebelumnya dan dalam kebijakan Anda. IAM

        • Pastikan peran Anda memiliki izin yang ditunjukkan dalam contoh berikut.

          contoh kebijakan izin:

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

          Ganti bucket-name dengan nama keranjang Amazon S3.

        • Jika bucket S3 dienkripsi menggunakan kunci yang dikelola pelanggan, KMS KMS kunci tersebut harus memiliki kebijakan akses dengan IAM peran dan operasi. kms:Decrypt kms:GenerateDataKey

   4. Untuk mengatur hot tier, lihat Langkah 5 diKonfigurasikan pengaturan penyimpanan untuk tingkat hangat (konsol).

   5. (Opsional) Untuk AWS IoT Analytics integrasi, lakukan hal berikut.

      1. Jika Anda AWS IoT Analytics ingin menggunakan kueri data Anda, pilih Penyimpanan AWS IoT Analytics data yang diaktifkan.

      2. AWS IoT SiteWise menghasilkan nama untuk penyimpanan data Anda atau Anda dapat memasukkan nama yang berbeda.

      AWS IoT SiteWise secara otomatis membuat penyimpanan data AWS IoT Analytics untuk menyimpan data Anda. Untuk menanyakan data, Anda dapat menggunakan AWS IoT Analytics untuk membuat kumpulan data. Untuk informasi selengkapnya, lihat Bekerja dengan AWS IoT SiteWise data di Panduan AWS IoT Analytics Pengguna.

   6. Pilih Simpan.

Untuk mengkonfigurasi pengaturan penyimpanan menggunakan AWS CLI

1. Untuk mengekspor data ke bucket Amazon S3 di akun Anda, jalankan perintah berikut untuk mengonfigurasi pengaturan penyimpanan. Ganti file-name dengan nama file yang berisi konfigurasi AWS IoT SiteWise penyimpanan.

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

   contoh AWS IoT SiteWise konfigurasi penyimpanan

   • Ganti bucket-name dengan nama bucket Amazon S3 Anda.

   • Ganti prefix dengan awalan Amazon S3 Anda.

   • Ganti aws-account-id dengan ID AWS akun Anda.

   • Ganti role-name dengan nama peran akses Amazon S3 yang memungkinkan AWS IoT SiteWise untuk mengirim data ke Amazon S3.

   • Ganti retention-in-days dengan bilangan bulat lebih besar dari atau sama dengan 30 hari.

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

   catatan

   • Anda harus menggunakan nama bucket Amazon S3 yang sama dalam konfigurasi dan AWS IoT SiteWise IAM kebijakan penyimpanan.

   • Pastikan peran Anda memiliki izin yang ditunjukkan dalam contoh berikut.

     contoh kebijakan izin:

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

     Ganti bucket-name dengan nama keranjang Amazon S3.

   • Jika bucket S3 dienkripsi menggunakan kunci yang dikelola pelanggan, KMS KMS kunci tersebut harus memiliki kebijakan akses dengan IAM peran dan operasi. kms:Decrypt kms:GenerateDataKey

   contoh response

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

   catatan

   Diperlukan beberapa menit AWS IoT SiteWise untuk memperbarui konfigurasi penyimpanan.

2. Untuk mengambil informasi konfigurasi penyimpanan, jalankan perintah berikut.

   aws iotsitewise describe-storage-configuration

   contoh 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. Untuk berhenti mengekspor data ke bucket Amazon S3, jalankan perintah berikut untuk mengonfigurasi pengaturan penyimpanan.

   aws iotsitewise put-storage-configuration --storage-type SITEWISE_DEFAULT_STORAGE

   catatan

   Secara default, data Anda hanya disimpan di tingkat panas AWS IoT SiteWise.

   contoh response

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

4. Untuk mengambil informasi konfigurasi penyimpanan, jalankan perintah berikut.

   aws iotsitewise describe-storage-configuration

   contoh response

   {
         "storageType": "SITEWISE_DEFAULT_STORAGE",
         "configurationStatus": {
             "state": "ACTIVE"
         },
         "lastUpdateDate": "2021-03-30T15:57:14-07:00"
     }