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

# Siklus hidup GET Bucket (Tidak digunakan lagi)
<a name="v1-rel-RESTBucketGETlifecycle"></a>

## Deskripsi
<a name="v1-rel-RESTBucketGETlifecycle_Description"></a>



 

**penting**  
Untuk versi terbaru dari API ini, lihat [ GetBucketLifecycleConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html). Jika Anda mengonfigurasi siklus hidup bucket menggunakan <filter>elemen, Anda akan melihat versi terbaru dari topik ini. Topik ini disediakan untuk kompatibilitas mundur. 

Mengembalikan informasi `lifecycle` konfigurasi yang ditetapkan pada bucket. Untuk informasi tentang konfigurasi siklus hidup, buka Manajemen Siklus [ Hidup Ob ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html) jek di Panduan Pengguna Layanan Penyimpanan Sederhana * Amazon*. 

Untuk menggunakan operasi ini, Anda harus memiliki izin untuk melakukan `s3:GetLifecycleConfiguration` tindakan. Pemilik bucket memiliki izin ini secara default. Pemilik bucket dapat memberikan izin ini kepada orang lain. Untuk informasi selengkapnya tentang izin, lihat M [ engelola Izin Akses ke Sumber Daya Amazon S3 Anda ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html) di Panduan Pengguna Layanan Penyimpanan Sederhana * Amazon*.

## Permohonan
<a name="v1-rel-RESTBucketGETlifecycle-requests"></a>

### Sintaksis
<a name="v1-rel-RESTBucketGETlifecycle-requests-syntax"></a>

```
1. GET /?lifecycle HTTP/1.1
2. Host: {{bucketname}}.s3.amazonaws.com
3. Date: {{date}}
4. Authorization: {{authorization string}} (see Permintaan Otentikasi (AWS Versi Tanda Tangan 4))
```

### Parameter Permintaan
<a name="v1-rel-RESTBucketGETlifecycle-requests-request-parameters"></a>

Implementasi operasi ini tidak menggunakan parameter permintaan.

### Header Permintaan
<a name="v1-rel-RESTBucketGETlifecycle-requests-request-headers"></a>

Implementasi operasi ini hanya menggunakan header permintaan yang umum untuk semua operasi. Untuk informasi selengkapnya, lihat [ Header Permintaan Umum. ](RESTCommonRequestHeaders.md)

### Elemen permintaan
<a name="v1-rel-RESTBucketGETlifecycle-requests-request-elements"></a>

Implementasi operasi ini tidak menggunakan elemen permintaan.

## Respons
<a name="v1-rel-RESTBucketGETlifecycle-responses"></a>

### Header Respons
<a name="v1-rel-RESTBucketGETlifecycle-responses-response-headers"></a>

Implementasi operasi ini hanya menggunakan header respons yang umum untuk sebagian besar respons. Untuk informasi selengkapnya, lihat [ Header Respons Umum. ](RESTCommonResponseHeaders.md)

### Elemen Respons
<a name="v1-rel-RESTBucketGETlifecycle-responses-response-elements"></a>

Implementasi ini `GET` mengembalikan elemen respons berikut.


|  Nama  |  Deskripsi  | Diperlukan | 
| --- | --- | --- | 
|  AbortIncompleteMultipartUpload  | Wadah untuk menentukan kapan unggahan multipart yang tidak lengkap memenuhi syarat untuk operasi pembatalan.Anak: `DaysAfterInitiation`<br />Tipe: Kontainer<br />Leluhur: `Rule` | Ya, jika tidak ada tindakan lain yang ditentukan untuk aturan | 
|  Date  | Tanggal kapan Anda ingin Amazon S3 mengambil tindakan. Untuk informasi selengkapnya, lihat [ Aturan Siklus Hidup: Berdasarkan Tanggal Ter ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html#intro-lifecycle-rules-date) tentu di Panduan Pengguna Layanan Penyimpanan Sederhana * Amazon*.<br />Nilai tanggal harus sesuai dengan format ISO 8601. Waktunya adalah selalu tengah malam UTC. <br />Tipe: String<br />Leluhur: `Expiration` atau `Transition` | Ya, jika Days dan tidak ExpiredObjectDeleteMarker ada | 
|  Days  | Menentukan jumlah hari setelah pembuatan objek ketika tindakan aturan tertentu berlaku. Waktu kelayakan objek dihitung sebagai waktu pembuatan\+jumlah hari dengan waktu yang dihasilkan dibulatkan ke tengah malam UTC hari berikutnya.<br />Jenis: Non-negative Integer saat digunakan dengan`Transition`, Integer Positif saat digunakan dengan`Expiration`.<br />Leluhur: `Transition` atau `Expiration` | Ya, jika Date dan tidak ExpiredObjectDeleteMarker ada | 
|  DaysAfterInitiation  | Menentukan jumlah hari setelah memulai upload multipart ketika upload multipart harus diselesaikan. Jika tidak selesai dengan jumlah hari yang ditentukan, itu memenuhi syarat untuk operasi pembatalan dan Amazon S3 membatalkan unggahan multipart yang tidak lengkap.<br />Jenis: Integer Positif<br />Leluhur: `AbortIncompleteMultipartUpload` | Ya, jika Date tidak ada | 
|  Expiration  | Tindakan ini menentukan periode dalam masa pakai objek saat Amazon S3 harus mengambil tindakan kedaluwarsa yang sesuai. Tindakan kedaluwarsa hanya terjadi pada objek yang memenuhi syarat sesuai dengan periode yang ditentukan dalam anak `Date` atau `Days` elemen. Tindakan yang dilakukan Amazon S3 tergantung pada apakah bucket diaktifkan pembuatan versi. <br /> +  Jika pembuatan versi belum pernah diaktifkan pada bucket, Amazon S3 menghapus satu-satunya salinan objek secara permanen.  <br />+  Jika tidak, jika bucket Anda mengaktifkan versi (atau pembuatan versi ditangguhkan), tindakan hanya berlaku untuk versi objek saat ini. Bucket yang diaktifkan versi atau ditangguhkan versi dapat memiliki banyak versi dari objek yang sama: satu versi saat ini, dan nol atau lebih versi noncurrent. <br />Alih-alih menghapus versi saat ini, Amazon S3 menjadikannya versi noncurrent dengan menambahkan penanda hapus sebagai versi baru saat ini.  <br />  Jika status bucket ditangguhkan versi, Amazon S3 membuat penanda hapus dengan ID versi. `null` Jika Anda memiliki versi dengan ID versi`null`, maka Amazon S3 akan mengganti versi tersebut.   <br />  Untuk mengatur kedaluwarsa untuk objek noncurrent, Anda harus menggunakan `NoncurrentVersionExpiration` tindakan.  <br />Tipe: Kontainer<br />Anak-anak: Hari atau Tanggal<br />Leluhur: Aturan | Ya, jika tag induk ditentukan | 
|  ID  | Pengidentifikasi unik untuk aturan. Nilai tidak boleh lebih dari 255 karakter.<br />Tipe: String<br />Leluhur: Aturan | Tidak | 
| LifecycleConfiguration  | Wadah untuk aturan siklus hidup. Anda dapat menambahkan sebanyak 1000 aturan.<br />Tipe: Kontainer<br />Anak-anak: Aturan<br />Leluhur: Tidak ada | Ya | 
| ExpiredObjectDeleteMarker | Pada bucket berversi (bucket versioning-enabled atau versioning-bucket), elemen ini menunjukkan apakah Amazon S3 akan menghapus penanda penghapusan objek yang kedaluwarsa di bucket. Sebagai contoh, buka [ Contoh 8: Tentukan Tindakan Kedaluwarsa untuk Menghapus Penanda Penghapusan Objek Kedaluwarsa ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html#lifecycle-config-conceptual-ex8) di Panduan Pengguna Layanan Penyimpanan Sederhana * Amazon*.<br />Tipe: String <br />Nilai yang valid: true \| false (nilai false diperbolehkan tetapi tidak ada operasi, Amazon S3 tidak mengambil tindakan jika nilainya salah)<br />Leluhur: `Expiration` | Ya, jika Date dan tidak Days ada | 
| NoncurrentDays  | Menentukan jumlah hari suatu objek tidak berjalan sebelum Amazon S3 dapat melakukan tindakan terkait. Untuk informasi tentang menghitung hari noncurrent, lihat Aturan [ Siklus Hidup Berdasarkan Jumlah Hari ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html#intro-lifecycle-actions-number-of-days) di Panduan * Pengguna Layanan * Penyimpanan Sederhana Amazon.<br />Jenis: Integer Nonnegatif saat digunakan dengan`NoncurrentVersionTransition`, Integer Positif saat digunakan dengan `NoncurrentVersionExpiration`<br />Leluhur: `NoncurrentVersionExpiration` atau `NoncurrentVersionTransition` | Ya, hanya jika leluhur hadir | 
| NoncurrentVersionExpiration  | Menentukan kapan versi objek noncurrent kedaluwarsa. Setelah kedaluwarsa, Amazon S3 menghapus versi objek noncurrent secara permanen. <br />Tetapkan tindakan konfigurasi siklus hidup ini pada bucket yang mengaktifkan (atau ditangguhkan) pembuatan versi untuk meminta agar Amazon S3 menghapus versi objek noncurrent pada periode tertentu dalam masa pakai objek.<br />Tipe: Kontainer<br />Anak-anak: NoncurrentDays <br />Leluhur: Aturan | Ya, jika tidak ada tindakan lain yang hadir di Rule | 
| NoncurrentVersionTransition | Wadah untuk aturan transisi yang menjelaskan kapan objek noncurrent transisi ke`STANDARD_IA`,`ONEZONE_IA`, atau kelas penyimpanan. <br />Jika bucket Anda mengaktifkan versi (atau pembuatan versi ditangguhkan), Anda dapat mengatur tindakan ini untuk meminta Amazon S3 untuk mentransisi versi objek noncurrent ke kelas penyimpanan pada periode tertentu dalam masa pakai objek.<br />Tipe: Kontainer<br />Anak-anak: NoncurrentDays dan StorageClass<br />Leluhur: Aturan | Ya, jika tidak ada tindakan lain yang hadir di Rule | 
|  Prefix  | Awalan kunci objek mengidentifikasi satu atau lebih objek yang berlaku aturan.<br />Tipe: String<br />Leluhur: Aturan | Ya | 
| Rule  | Wadah untuk aturan siklus hidup.<br />Tipe: Kontainer<br />Leluhur: LifecycleConfiguration | Ya | 
|  Status  | Jika Diaktifkan, Amazon S3 mengeksekusi aturan seperti yang dijadwalkan. Jika Dinonaktifkan, Amazon S3 mengabaikan aturan tersebut.<br />Tipe: String<br />Leluhur: Aturan<br />Nilai yang valid: Diaktifkan atau Dinonaktifkan | Ya | 
|  StorageClass  | Menentukan kelas penyimpanan Amazon S3 yang ingin Anda transisi objek.<br />Tipe: String<br />Leluhur: Transisi dan NoncurrentVersionTransition<br />Nilai yang valid: `STANDARD_IA` \| `ONEZONE_IA` \|  | Ya | 
|  Transition  | Tindakan ini menentukan periode dalam masa pakai objek saat Amazon S3 harus mentransisikannya ke kelas`STANDARD_IA`,`ONEZONE_IA`, atau penyimpanan. Ketika tindakan ini berlaku, apa yang dilakukan Amazon S3 bergantung pada apakah bucket diaktifkan versi.<br /> +  Jika pembuatan versi belum pernah diaktifkan pada bucket, Amazon S3 mengalihkan satu-satunya salinan objek ke kelas penyimpanan yang ditentukan.  <br />+  Saat bucket Anda mengaktifkan versi (atau pembuatan versi ditangguhkan), Amazon S3 hanya mentransisi versi terkini dari objek yang diidentifikasi dalam aturan. <br />  Bucket yang diaktifkan versi atau suspensi versi dapat berisi banyak versi objek. Tindakan ini tidak berpengaruh pada versi objek noncurrent. Untuk transisi objek noncurrent, Anda harus menggunakan `NoncurrentVersionTransition` tindakan.  <br />Tipe: Kontainer<br />Anak-anak: Hari atau Tanggal, dan StorageClass<br />Leluhur: Aturan | Ya, jika tidak ada tindakan lain yang hadir di Rule | 

## Kesalahan Khusus
<a name="v1-rel-RESTBucketGETlifecycle-special-errors"></a>


| Kode Kesalahan | Deskripsi | Kode Status HTTP | Awalan Kode Kesalahan SOAP | 
| --- | --- | --- | --- | 
| NoSuchLifecycleConfiguration | Konfigurasi siklus hidup tidak ada.  | 404 Tidak Ditemukan | Klien | 

Untuk informasi umum tentang kesalahan Amazon S3 dan daftar kode kesalahan, lihat[Tanggapan kesalahan](ErrorResponses.md).

## Contoh
<a name="v1-rel-RESTBucketGETlifecycle-examples"></a>

### Contoh 1: Mengambil Sub-Sumber Daya Siklus Hidup
<a name="v1-rel-RESTBucketGETlifecycle-examples-example-1-retrieve-lifecycle-subresource-"></a>

Contoh ini adalah permintaan GET untuk mengambil `lifecycle` subresource dari bucket yang ditentukan, dan contoh respons dengan konfigurasi siklus hidup yang dikembalikan. 

#### Permintaan Sampel
<a name="v1-rel-RESTBucketGETlifecycle-examples-example-1-retrieve-lifecycle-subresource--sample-request"></a>

```
1. GET /?lifecycle HTTP/1.1
2. Host: examplebucket.s3.amazonaws.com
3. x-amz-date: Thu, 15 Nov 2012 00:17:21 GMT
4. Authorization: {{signatureValue}}
```

#### Contoh Respons
<a name="v1-rel-RESTBucketGETlifecycle-examples-example-1-retrieve-lifecycle-subresource--sample-response"></a>

```
 1. HTTP/1.1 200 OK
 2. x-amz-id-2: ITnGT1y4RyTmXa3rPi4hklTXouTf0hccUjo0iCPjz6FnfIutBj3M7fPGlWO2SEWp
 3. x-amz-request-id: 51991C342C575321
 4. Date: Thu, 15 Nov 2012 00:17:23 GMT
 5. Server: AmazonS3
 6. Content-Length: 358
 7. 
 8. <?xml version="1.0" encoding="UTF-8"?>
 9. <LifecycleConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
10.     <Rule>
11.         <ID>Archive and then delete rule</ID>
12.         <Prefix>projectdocs/</Prefix>
13.         <Status>Enabled</Status>
14.        <Transition>
15.            <Days>30</Days>
16.            <StorageClass>STANDARD_IA</StorageClass>
17.         </Transition>
18.         <Transition>
19.            <Days>365</Days>
20.            <StorageClass>GLACIER</StorageClass>
21.         </Transition>
22.         <Expiration>
23.            <Days>3650</Days>
24.         </Expiration>
25.     </Rule>
26. </LifecycleConfiguration>
```

## Sumber Daya Terkait
<a name="v1-rel-RESTBucketGETlifecycle-related-resources"></a>
+ [PutBucketLifecycleConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html)
+ [DeleteBucketLifecycle](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html)