PutLifecycleConfiguration - Sistem File Elastis Amazon
Sintaks PermintaanURIParameter PermintaanIsi PermintaanSintaksis ResponsElemen ResponsKesalahanContohLihat Juga

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

PutLifecycleConfiguration

Gunakan tindakan ini untuk mengelola penyimpanan untuk sistem file Anda. A LifecycleConfiguration terdiri dari satu atau lebih LifecyclePolicy objek yang mendefinisikan sebagai berikut:

  • TransitionToIA— Kapan harus memindahkan file dalam sistem file dari penyimpanan utama (kelas penyimpanan standar) ke penyimpanan Akses Jarang (IA).

  • TransitionToArchive— Kapan harus memindahkan file dalam sistem file dari kelas penyimpanan mereka saat ini (baik IA atau penyimpanan Standar) ke penyimpanan Arsip.

    Sistem file tidak dapat bertransisi ke penyimpanan Arsip sebelum beralih ke penyimpanan IA. Oleh karena itu, TransitionToArchive tidak boleh diatur atau harus lebih lambat dari TransitionTo IA.

    catatan

    Kelas penyimpanan Arsip hanya tersedia untuk sistem file yang menggunakan mode throughput Elastis dan mode kinerja Tujuan Umum.

  • TransitionToPrimaryStorageClass— Apakah akan memindahkan file dalam sistem file kembali ke penyimpanan utama (kelas penyimpanan standar) setelah diakses di penyimpanan IA atau Arsip.

Untuk informasi selengkapnya, lihat Mengelola penyimpanan sistem file.

Setiap sistem EFS file Amazon mendukung satu konfigurasi siklus hidup, yang berlaku untuk semua file dalam sistem file. Jika LifecycleConfiguration objek sudah ada untuk sistem file yang ditentukan, PutLifecycleConfiguration panggilan memodifikasi konfigurasi yang ada. PutLifecycleConfigurationPanggilan dengan LifecyclePolicies array kosong di badan permintaan menghapus semua yang adaLifecycleConfiguration. Dalam permintaan, tentukan yang berikut ini:

  • ID untuk sistem file yang Anda aktifkan, nonaktifkan, atau modifikasi manajemen siklus hidup.

  • LifecyclePoliciesArray LifecyclePolicy objek yang menentukan kapan harus memindahkan file ke penyimpanan IA, ke penyimpanan Arsip, dan kembali ke penyimpanan utama.

    catatan

    Amazon EFS mengharuskan setiap LifecyclePolicy objek hanya memiliki satu transisi, sehingga LifecyclePolicies array perlu terstruktur dengan LifecyclePolicy objek terpisah. Lihat contoh permintaan di bagian berikut untuk informasi selengkapnya.

Operasi ini memerlukan izin untuk elasticfilesystem:PutLifecycleConfiguration operasi.

Untuk menerapkan LifecycleConfiguration objek ke sistem file terenkripsi, Anda memerlukan AWS Key Management Service izin yang sama seperti ketika Anda membuat sistem file terenkripsi.

Sintaks Permintaan

PUT /2015-02-01/file-systems/FileSystemId/lifecycle-configuration HTTP/1.1
Content-type: application/json

{
   "LifecyclePolicies": [ 
      { 
         "TransitionToArchive": "string",
         "TransitionToIA": "string",
         "TransitionToPrimaryStorageClass": "string"
      }
   ]
}

URIParameter Permintaan

Permintaan menggunakan URI parameter berikut.

FileSystemId

ID dari sistem file tempat Anda membuat LifecycleConfiguration objek (String).

Batasan Panjang: Panjang maksimum 128.

Pola: ^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

Wajib: Ya

Isi Permintaan

Permintaan menerima data berikut dalam JSON format.

LifecyclePolicies

Sebuah array LifecyclePolicy objek yang mendefinisikan LifecycleConfiguration objek sistem file. LifecycleConfigurationObjek menginformasikan manajemen siklus hidup berikut ini:

  • TransitionToIA— Kapan harus memindahkan file dalam sistem file dari penyimpanan utama (kelas penyimpanan standar) ke penyimpanan Akses Jarang (IA).

  • TransitionToArchive— Kapan harus memindahkan file dalam sistem file dari kelas penyimpanan mereka saat ini (baik IA atau penyimpanan Standar) ke penyimpanan Arsip.

    Sistem file tidak dapat bertransisi ke penyimpanan Arsip sebelum beralih ke penyimpanan IA. Oleh karena itu, TransitionToArchive tidak boleh diatur atau harus lebih lambat dari TransitionTo IA.

    catatan

    Kelas penyimpanan Arsip hanya tersedia untuk sistem file yang menggunakan mode throughput Elastis dan mode kinerja Tujuan Umum.

  • TransitionToPrimaryStorageClass— Apakah akan memindahkan file dalam sistem file kembali ke penyimpanan utama (kelas penyimpanan standar) setelah diakses di penyimpanan IA atau Arsip.

catatan

Saat menggunakan put-lifecycle-configuration CLI perintah atau PutLifecycleConfiguration API tindakan, Amazon EFS mengharuskan setiap LifecyclePolicy objek hanya memiliki satu transisi. Ini berarti bahwa dalam badan permintaan, LifecyclePolicies harus terstruktur sebagai array LifecyclePolicy objek, satu objek untuk setiap transisi penyimpanan. Lihat contoh permintaan di bagian berikut untuk informasi selengkapnya.

Tipe: Array objek LifecyclePolicy

Anggota Array: Jumlah maksimum 3 item.

Wajib: Ya

Sintaksis Respons

HTTP/1.1 200
Content-type: application/json

{
   "LifecyclePolicies": [ 
      { 
         "TransitionToArchive": "string",
         "TransitionToIA": "string",
         "TransitionToPrimaryStorageClass": "string"
      }
   ]
}

Elemen Respons

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Data berikut dikembalikan dalam JSON format oleh layanan.

LifecyclePolicies

Array kebijakan manajemen siklus hidup. EFSmendukung maksimal satu kebijakan per sistem file.

Tipe: Array objek LifecyclePolicy

Anggota Array: Jumlah maksimum 3 item.

Kesalahan

BadRequest

Dikembalikan jika permintaan salah bentuk atau berisi kesalahan seperti nilai parameter yang tidak valid atau parameter wajib yang hilang.

HTTPKode Status: 400

FileSystemNotFound

Dikembalikan jika FileSystemId nilai yang ditentukan tidak ada di pemohon. Akun AWS

HTTPKode Status: 404

IncorrectFileSystemLifeCycleState

Dikembalikan jika status siklus hidup sistem file tidak “tersedia”.

HTTPKode Status: 409

InternalServerError

Dikembalikan jika terjadi kesalahan di sisi server.

HTTPKode Status: 500

Contoh

Buat konfigurasi siklus hidup

Contoh berikut membuat LifecyclePolicy objek menggunakan PutLifecycleConfiguration tindakan. Contoh ini membuat kebijakan siklus hidup yang menginstruksikan EFS untuk melakukan hal berikut:

  • Pindahkan semua file dalam sistem file yang belum diakses di penyimpanan Standar dalam 30 hari terakhir ke penyimpanan IA.

  • Pindahkan semua file dalam sistem file yang belum diakses di penyimpanan Standar dalam 90 hari terakhir ke penyimpanan Arsip.

  • Pindahkan file kembali ke penyimpanan Standar setelah diakses di penyimpanan IA atau Arsip. Kelas penyimpanan Arsip hanya tersedia untuk sistem file yang menggunakan mode throughput Elastis dan mode kinerja Tujuan Umum.

Untuk informasi selengkapnya, lihat kelas EFS penyimpanan dan Mengelola penyimpanan sistem file.

Permintaan Sampel


PUT /2015-02-01/file-systems/fs-0123456789abcdefb/lifecycle-configuration HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20181122T232908Z
Authorization: <...>
Content-type: application/json
Content-Length: 86

{
   "LifecyclePolicies": [
      {
         "TransitionToArchive": "AFTER_90_DAYS"
      },
      {
         "TransitionToIA": "AFTER_30_DAYS"
      },
      {
         "TransitionToPrimaryStorage": "AFTER_1_ACCESS"
      }
   ]
}

Contoh Respons

HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-type: application/json
Content-Length: 86

{
    "LifecyclePolicies": [
      {
         "TransitionToArchive": "AFTER_90_DAYS"
      },
      {
         "TransitionToIA": "AFTER_30_DAYS"
      },
      {
         "TransitionToPrimaryStorage": "AFTER_1_ACCESS"
      }
    ]
}

put-lifecycle-configuration CLIPermintaan contoh

Contoh ini menggambarkan salah satu penggunaan. PutLifecycleConfiguration

Permintaan Sampel

aws efs put-lifecycle-configuration \
   --file-system-id fs-0123456789abcdefb \
   --lifecycle-policies "[{"TransitionToArchive":"AFTER_90_DAYS"},
     {"TransitionToIA":"AFTER_30_DAYS"},
     {"TransitionToPrimaryStorageClass":"AFTER_1_ACCESS"}]  
   --region us-west-2 \
   --profile adminuser

Contoh Respons

{
   "LifecyclePolicies": [
       {
           "TransitionToArchive": "AFTER_90_DAYS"
       },
       {
           "TransitionToIA": "AFTER_30_DAYS"
       },
       {
           "TransitionToPrimaryStorageClass": "AFTER_1_ACCESS"
       }
   ]
}

Nonaktifkan manajemen siklus hidup

Contoh berikut menonaktifkan manajemen siklus hidup untuk sistem file yang ditentukan.

Permintaan Sampel


PUT /2015-02-01/file-systems/fs-01234567/lifecycle-configuration HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20181122T232908Z
Authorization: <...>
Content-type: application/json
Content-Length: 86

{
   "LifecyclePolicies": [ ]
}

Contoh Respons


HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-type: application/json
Content-Length: 86

{
   "LifecyclePolicies": [ ]
}

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan ini API di salah satu bahasa khusus AWS SDKs, lihat berikut ini: