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

# PutLifecycleConfiguration
<a name="API_PutLifecycleConfiguration"></a>

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](https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html).

Setiap sistem file Amazon EFS 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. `PutLifecycleConfiguration`Panggilan dengan `LifecyclePolicies` array kosong di badan permintaan menghapus semua yang ada`LifecycleConfiguration`. Dalam permintaan, tentukan yang berikut ini: 
+ ID untuk sistem file yang Anda aktifkan, nonaktifkan, atau modifikasi manajemen siklus hidup.
+ `LifecyclePolicies`Array `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.

## Minta Sintaks
<a name="API_PutLifecycleConfiguration_RequestSyntax"></a>

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

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

## Parameter Permintaan URI
<a name="API_PutLifecycleConfiguration_RequestParameters"></a>

Permintaan menggunakan parameter URI berikut.

 ** [FileSystemId](#API_PutLifecycleConfiguration_RequestSyntax) **   <a name="efs-PutLifecycleConfiguration-request-uri-FileSystemId"></a>
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
<a name="API_PutLifecycleConfiguration_RequestBody"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [LifecyclePolicies](#API_PutLifecycleConfiguration_RequestSyntax) **   <a name="efs-PutLifecycleConfiguration-request-LifecyclePolicies"></a>
Sebuah array `LifecyclePolicy` objek yang mendefinisikan `LifecycleConfiguration` objek sistem file. `LifecycleConfiguration`Objek 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.
Saat menggunakan perintah `put-lifecycle-configuration` CLI atau tindakan `PutLifecycleConfiguration` API, 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](API_LifecyclePolicy.md)  
Anggota Array: Jumlah maksimum 3 item.  
Wajib: Ya

## Sintaksis Respons
<a name="API_PutLifecycleConfiguration_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

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

## Elemen Respons
<a name="API_PutLifecycleConfiguration_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [LifecyclePolicies](#API_PutLifecycleConfiguration_ResponseSyntax) **   <a name="efs-PutLifecycleConfiguration-response-LifecyclePolicies"></a>
Array kebijakan manajemen siklus hidup. EFS mendukung maksimal satu kebijakan per sistem file.  
Tipe: Array objek [LifecyclePolicy](API_LifecyclePolicy.md)  
Anggota Array: Jumlah maksimum 3 item.

## Kesalahan
<a name="API_PutLifecycleConfiguration_Errors"></a>

 ** BadRequest **   
Dikembalikan jika permintaan salah bentuk atau berisi kesalahan seperti nilai parameter yang tidak valid atau parameter wajib yang hilang.    
 ** ErrorCode **   
Kode kesalahan adalah string yang secara unik mengidentifikasi kondisi kesalahan. Ini dimaksudkan untuk dibaca dan dipahami oleh program yang mendeteksi dan menangani kesalahan berdasarkan tipe.   
 ** Message **   
Pesan kesalahan berisi deskripsi umum kondisi kesalahan dalam bahasa Inggris. Ini ditujukan untuk audiens manusia. Program sederhana menampilkan pesan secara langsung kepada pengguna akhir jika mereka mengalami kondisi kesalahan yang tidak mereka ketahui atau tidak peduli untuk menanganinya. Program-program canggih dengan penanganan kesalahan yang lebih lengkap dan internasionalisasi yang tepat lebih cenderung mengabaikan pesan kesalahan.
Kode Status HTTP: 400

 ** FileSystemNotFound **   
Dikembalikan jika `FileSystemId` nilai yang ditentukan tidak ada di pemohon. Akun AWS    
 ** ErrorCode **   
Kode kesalahan adalah string yang secara unik mengidentifikasi kondisi kesalahan. Ini dimaksudkan untuk dibaca dan dipahami oleh program yang mendeteksi dan menangani kesalahan berdasarkan tipe.   
 ** Message **   
Pesan kesalahan berisi deskripsi umum kondisi kesalahan dalam bahasa Inggris. Ini ditujukan untuk audiens manusia. Program sederhana menampilkan pesan secara langsung kepada pengguna akhir jika mereka mengalami kondisi kesalahan yang tidak mereka ketahui atau tidak peduli untuk menanganinya. Program-program canggih dengan penanganan kesalahan yang lebih lengkap dan internasionalisasi yang tepat lebih cenderung mengabaikan pesan kesalahan.
Kode Status HTTP: 404

 ** IncorrectFileSystemLifeCycleState **   
Dikembalikan jika status siklus hidup sistem file tidak “tersedia”.    
 ** ErrorCode **   
Kode kesalahan adalah string yang secara unik mengidentifikasi kondisi kesalahan. Ini dimaksudkan untuk dibaca dan dipahami oleh program yang mendeteksi dan menangani kesalahan berdasarkan tipe.   
 ** Message **   
Pesan kesalahan berisi deskripsi umum kondisi kesalahan dalam bahasa Inggris. Ini ditujukan untuk audiens manusia. Program sederhana menampilkan pesan secara langsung kepada pengguna akhir jika mereka mengalami kondisi kesalahan yang tidak mereka ketahui atau tidak peduli untuk menanganinya. Program-program canggih dengan penanganan kesalahan yang lebih lengkap dan internasionalisasi yang tepat lebih cenderung mengabaikan pesan kesalahan.
Kode Status HTTP: 409

 ** InternalServerError **   
Dikembalikan jika terjadi kesalahan di sisi server.    
 ** ErrorCode **   
Kode kesalahan adalah string yang secara unik mengidentifikasi kondisi kesalahan. Ini dimaksudkan untuk dibaca dan dipahami oleh program yang mendeteksi dan menangani kesalahan berdasarkan tipe.   
 ** Message **   
Pesan kesalahan berisi deskripsi umum kondisi kesalahan dalam bahasa Inggris. Ini ditujukan untuk audiens manusia. Program sederhana menampilkan pesan secara langsung kepada pengguna akhir jika mereka mengalami kondisi kesalahan yang tidak mereka ketahui atau tidak peduli untuk menanganinya. Program-program canggih dengan penanganan kesalahan yang lebih lengkap dan internasionalisasi yang tepat lebih cenderung mengabaikan pesan kesalahan.
Kode Status HTTP: 500

## Contoh
<a name="API_PutLifecycleConfiguration_Examples"></a>

### Buat konfigurasi siklus hidup
<a name="API_PutLifecycleConfiguration_Example_1"></a>

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 penyimpanan EFS](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html) dan [Mengelola penyimpanan sistem file](https://docs.aws.amazon.com/efs/latest/ug/lifecycle-management-efs.html).

#### Permintaan Sampel
<a name="API_PutLifecycleConfiguration_Example_1_Request"></a>

```
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
<a name="API_PutLifecycleConfiguration_Example_1_Response"></a>

```
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"
      }
    ]
}
```

### Contoh Permintaan CLI put-lifecycle-configuration
<a name="API_PutLifecycleConfiguration_Example_2"></a>

Contoh ini menggambarkan salah satu penggunaan. PutLifecycleConfiguration

#### Permintaan Sampel
<a name="API_PutLifecycleConfiguration_Example_2_Request"></a>

```
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
<a name="API_PutLifecycleConfiguration_Example_2_Response"></a>

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

### Nonaktifkan manajemen siklus hidup
<a name="API_PutLifecycleConfiguration_Example_3"></a>

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

#### Permintaan Sampel
<a name="API_PutLifecycleConfiguration_Example_3_Request"></a>

```
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
<a name="API_PutLifecycleConfiguration_Example_3_Response"></a>

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

{
   "LifecyclePolicies": [ ]
}
```

## Lihat Juga
<a name="API_PutLifecycleConfiguration_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) 
+  [AWS SDK untuk V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) 
+  [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/elasticfilesystem-2015-02-01/PutLifecycleConfiguration)