View a markdown version of this page

Siklus hidup PUT Bucket (Tidak digunakan lagi) - Amazon Simple Storage Service
DeskripsiPermintaanResponsContohSumber Daya Terkait

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

Siklus hidup PUT Bucket (Tidak digunakan lagi)

Deskripsi

penting

Untuk versi terbaru dari API ini, lihat PutBucketLifecycleConfiguration. Versi ini sudah tidak digunakan lagi. Konfigurasi siklus hidup yang ada akan berfungsi. Untuk konfigurasi siklus hidup baru, gunakan API yang diperbarui.

Membuat konfigurasi siklus hidup baru untuk bucket atau mengganti konfigurasi siklus hidup yang ada. Untuk informasi tentang konfigurasi siklus hidup, lihat Manajemen Siklus Hidup Ob jek di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon.

Izin

Secara default, semua sumber daya Amazon S3, termasuk bucket, objek, dan subsumber daya terkait (misalnya, konfigurasi siklus hidup dan konfigurasi situs web) bersifat pribadi. Hanya pemilik sumber daya, Akun AWS yang membuat sumber daya, yang dapat mengaksesnya. Pemilik sumber daya dapat secara opsional memberikan izin akses kepada orang lain dengan menulis kebijakan akses. Untuk operasi ini, pengguna harus mendapatkan s3:PutLifecycleConfiguration izin.

Anda juga dapat secara eksplisit menolak izin. Penolakan eksplisit juga menggantikan izin lainnya. Jika Anda ingin mencegah pengguna atau akun menghapus atau menghapus objek dari bucket Anda, Anda harus menolak izin mereka untuk tindakan berikut:

  • s3:DeleteObject

  • s3:DeleteObjectVersion

  • s3:PutLifecycleConfiguration

Untuk informasi selengkapnya tentang izin, lihat M engelola Izin Akses ke Sumber Daya Amazon S3 Anda di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon.

Permintaan

Sintaksis

PUT /?lifecycle HTTP/1.1
Host: bucketname.s3.amazonaws.com
Content-Length: length
Date: date
Authorization: authorization string 
Content-MD5: MD5

Lifecycle configuration in the request body

Untuk detail tentang string otorisasi, lihatPermintaan Otentikasi (AWS Versi Tanda Tangan 4).

Parameter Permintaan

Implementasi operasi ini tidak menggunakan parameter permintaan.

Header Permintaan

Nama Deskripsi Diperlukan
Content-MD5

Intisari data MD5 128-bit yang dikodekan base64. Anda harus menggunakan header ini sebagai pemeriksaan integritas pesan untuk memverifikasi bahwa badan permintaan tidak rusak saat transit. Untuk informasi lebih lanjut, lihat RFC 1864.

Tipe: String

Default: Tidak Ada

 Ya

Isi Permintaan

Dalam permintaan, Anda menentukan konfigurasi siklus hidup di badan permintaan. Konfigurasi siklus hidup ditentukan sebagai XML. Berikut ini adalah contoh konfigurasi siklus hidup dasar. Ini menentukan satu aturan. Aturan Prefix dalam mengidentifikasi objek yang berlaku aturan. Aturan ini juga menentukan dua tindakan (TransitiondanExpiration). Setiap tindakan menentukan garis waktu kapan Amazon S3 harus melakukan tindakan. Men Status unjukkan apakah aturan diaktifkan atau dinonaktifkan.

<LifecycleConfiguration>
    <Rule>
        <ID>sample-rule</ID>
        <Prefix>key-prefix</Prefix>
        <Status>rule-status</Status>
        <Transition>        
           <Date>value</Date>        
           <StorageClass>storage class</StorageClass>       
        </Transition>    
        <Expiration>
           <Days>value</Days>
        </Expiration>
    </Rule>
</LifecycleConfiguration>

Jika status bucket Anda diaktifkan versi atau ditangguhkan versi, Anda dapat memiliki banyak versi dari objek yang sama: satu versi saat ini dan nol atau lebih versi noncurrent. Konfigurasi siklus hidup berikut menentukan tindakan (NoncurrentVersionTransition,NoncurrentVersionExpiration) yang khusus untuk versi objek noncurrent.

<LifecycleConfiguration>
    <Rule>
        <ID>sample-rule</ID>
        <Prefix>key-prefix</Prefix>
        <Status>rule-status</Status>
        <NoncurrentVersionTransition>      
           <NoncurrentDays>value</NoncurrentDays>      
           <StorageClass>storage class</StorageClass>   
        </NoncurrentVersionTransition>    
        <NoncurrentVersionExpiration>     
           <NoncurrentDays>value</NoncurrentDays>    
        </NoncurrentVersionExpiration> 
    </Rule>
</LifecycleConfiguration>

Anda dapat menggunakan unggahan multibagian API untuk mengunggah objek besar dalam beberapa bagian. Untuk informasi selengkapnya tentang unggahan multipart, lihat Ikhtisar Unggahan Multipart di Panduan Pengguna Layanan Peny impanan Sederhana Amazon. Dengan konfigurasi siklus hidup, Anda dapat memberi tahu Amazon S3 untuk membatalkan upload multipart yang tidak lengkap, yang diidentifikasi oleh awalan nama kunci yang ditentukan dalam aturan, jika tidak selesai dalam jumlah hari yang ditentukan. Saat Amazon S3 membatalkan unggahan multipart, Amazon S3 akan menghapus semua bagian yang terkait dengan unggahan. Ini memastikan bahwa Anda tidak memiliki unggahan multipart yang tidak lengkap yang meninggalkan bagian yang disimpan di Amazon S3, jadi Anda tidak perlu membayar biaya penyimpanan untuk itu. Berikut ini adalah contoh konfigurasi siklus hidup yang menentukan aturan dengan tindakan AbortIncompleteMultipartUpload. Tindakan ini memberitahu Amazon S3 untuk membatalkan unggahan multipart yang tidak lengkap tujuh hari setelah inisiasi.

<LifecycleConfiguration>
    <Rule>
        <ID>sample-rule</ID>
        <Prefix>SomeKeyPrefix/</Prefix>
        <Status>rule-status</Status>
        <AbortIncompleteMultipartUpload>
          <DaysAfterInitiation>7</DaysAfterInitiation>
        </AbortIncompleteMultipartUpload>
    </Rule>
</LifecycleConfiguration>

Tabel berikut menjelaskan elemen XML dalam konfigurasi siklus hidup.

Nama Deskripsi Diperlukan
AbortIncompleteMultipartUpload

Wadah untuk menentukan kapan unggahan multipart yang tidak lengkap memenuhi syarat untuk operasi pembatalan.

Anak: DaysAfterInitiation

Tipe: Kontainer

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 tentu di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon.

Nilai tanggal harus sesuai dengan format ISO 8601. Waktunya adalah selalu tengah malam UTC.

Tipe: String

Leluhur: Expiration atau Transition

 Ya, jika Days dan tidak ExpiredObjectDeleteMarker ada
Days

Menentukan jumlah hari setelah pembuatan objek ketika tindakan aturan tertentu berlaku.

Jenis: Integer Nonnegatif saat digunakan denganTransition, Integer Positif saat digunakan dengan Expiration

Leluhur:Expiration, Transition

 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.

Jenis: Integer Positif

Leluhur: AbortIncompleteMultipartUpload

 Ya, jika tag induk ditentukan
Expiration

Tindakan ini menentukan periode dalam masa pakai objek saat Amazon S3 harus mengambil tindakan kedaluwarsa yang sesuai. Tindakan yang dilakukan Amazon S3 tergantung pada apakah bucket diaktifkan versi.

  • Jika pembuatan versi belum pernah diaktifkan pada bucket, Amazon S3 menghapus satu-satunya salinan objek secara permanen.

  • Jika bucket diaktifkan versi (atau pembuatan versi ditangguhkan), tindakan hanya berlaku untuk versi objek saat ini. Bucket berkemampuan versi dapat memiliki banyak versi dari objek yang sama: satu versi saat ini dan nol atau lebih versi noncurrent.

    Alih-alih menghapus versi saat ini, Amazon S3 menjadikannya versi noncurrent dengan menambahkan penanda hapus sebagai versi baru saat ini.

    penting

    Jika status bucket ditangguhkan versi, Amazon S3 membuat penanda hapus dengan ID versi. null Jika Anda memiliki versi dengan ID versinull, Amazon S3 akan mengganti versi tersebut.

    catatan

    Untuk mengatur kedaluwarsa untuk objek noncurrent, gunakan NoncurrentVersionExpiration tindakan.

Tipe: Kontainer

Anak-anak: Hari atau Tanggal

Leluhur: Aturan

 Ya, jika tidak ada tindakan lain yang hadir diRule.
ID

Pengidentifikasi unik untuk aturan. Nilai tidak boleh lebih dari 255 karakter.

Tipe: String

Leluhur: Aturan

 Tidak
LifecycleConfiguration

Wadah untuk aturan siklus hidup. Anda dapat menambahkan sebanyak 1000 aturan.

Tipe: Kontainer

Anak-anak: Aturan

Leluhur: Tidak ada

 Ya
ExpiredObjectDeleteMarker

Pada bucket berversi (bucket yang diaktifkan versi atau yang ditangguhkan versi), Anda dapat menambahkan elemen ini dalam konfigurasi siklus hidup untuk memberi tahu Amazon S3 menghapus penanda penghapusan objek yang kedaluwarsa. Sebagai contoh, lihat Contoh 8: Menghapus Penanda Penghapusan Objek Kedaluwarsa di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon. Jangan menambahkannya ke bucket tanpa versi, karena jenis bucket itu tidak dapat menyertakan penanda hapus.

Tipe: String

Nilai yang valid: true | false (nilainya false diperbolehkan, tetapi tidak ada operasi, yang berarti Amazon S3 tidak akan mengambil tindakan)

Leluhur: Expiration

 Ya, jika Date dan tidak Days ada
NoncurrentDays

Menentukan jumlah hari suatu obyek menjadi tidak terkini sebelum Amazon S3 dapat melakukan tindakan terkait. Untuk informasi tentang perhitungan hari noncurrent, lihat Cara Amazon S3 Menghitung Saat Objek Menjadi Tidak Current di Panduan Pengguna Layanan Peny impanan Sederhana Amazon.

Jenis: Integer Nonnegatif saat digunakan denganNoncurrentVersionTransition, Integer Positif saat digunakan dengan NoncurrentVersionExpiration

Leluhur: NoncurrentVersionExpiration atau NoncurrentVersionTransition

 Ya
NoncurrentVersionExpiration

Menentukan kapan versi objek noncurrent kedaluwarsa. Setelah kedaluwarsa, Amazon S3 menghapus versi objek noncurrent secara permanen.

Setel tindakan konfigurasi siklus hidup ini pada bucket yang mengaktifkan (atau ditangguhkan) pembuatan versi untuk memberi tahu Amazon S3 agar menghapus versi objek noncurrent pada periode tertentu dalam masa pakai objek.

Tipe: Kontainer

Anak-anak: NoncurrentDays

Leluhur: Aturan

 Ya, jika tidak ada tindakan lain yang hadir di Rule
NoncurrentVersionTransition

Wadah untuk aturan transisi yang menjelaskan kapan objek noncurrent transisi ke kelasSTANDARD_IA,ONEZONE_IA, atau penyimpanan.

Jika bucket Anda mengaktifkan versi (atau jika pembuatan versi ditangguhkan), Anda dapat mengatur tindakan ini untuk memberi tahu Amazon S3 agar melakukan transisi versi objek noncurrent pada periode tertentu dalam masa pakai objek.

Tipe: Kontainer

Anak-anak: NoncurrentDays dan StorageClass

Leluhur: Aturan

 Ya, jika tidak ada tindakan lain yang hadir di Rule
Prefix

Awalan kunci objek yang mengidentifikasi satu atau lebih objek yang berlaku aturan.

Tipe: String

Leluhur: Aturan

 Ya
Rule

Wadah untuk aturan siklus hidup. Konfigurasi siklus hidup dapat berisi sebanyak 1000 aturan.

Tipe: Kontainer

Ancestor:LifecycleConfiguration

 Ya
Status

Jika diaktifkan, Amazon S3 mengeksekusi aturan seperti yang dijadwalkan. Jika dinonaktifkan, Amazon S3 mengabaikan aturan tersebut.

Tipe: String

Leluhur: Aturan

Nilai yang valid: Diaktifkan, Dinonaktifkan

 Ya
StorageClass

Menentukan kelas penyimpanan Amazon S3 yang Anda inginkan untuk transisi objek.

Tipe: String

Leluhur: Transisi dan NoncurrentVersionTransition

Nilai yang valid: STANDARD_IA | ONEZONE_IA | GLACIER

Ya

Elemen ini diperlukan hanya jika Anda menentukan satu atau kedua leluhurnya.
Transition

Tindakan ini menentukan periode dalam masa pakai objek saat Amazon S3 harus mentransisikannya ke kelasSTANDARD_IA,ONEZONE_IA, atau penyimpanan. Ketika tindakan ini berlaku, apa yang dilakukan Amazon S3 bergantung pada apakah bucket diaktifkan versi.

  • Jika pembuatan versi belum pernah diaktifkan pada bucket, Amazon S3 mengalihkan satu-satunya salinan objek ke kelas penyimpanan yang ditentukan.

  • Jika bucket Anda mengaktifkan versi (atau pembuatan versi ditangguhkan), Amazon S3 hanya mengalihkan versi objek saat ini yang diidentifikasi dalam aturan.

    catatan

    Bucket berkemampuan versi dapat memiliki banyak versi objek. Tindakan ini tidak berpengaruh pada versi objek noncurrent. Untuk transisi objek noncurrent, Anda harus menggunakan NoncurrentVersionTransition tindakan.

Tipe: Kontainer

Anak-anak: Hari atau Tanggal, dan StorageClass

Leluhur: Aturan

 Ya, jika tidak ada tindakan lain yang hadir di Rule

Respons

Header Respons

Implementasi operasi ini hanya menggunakan header respons yang umum untuk sebagian besar respons. Untuk informasi selengkapnya, lihat Header Respons Umum.

Elemen Respons

Implementasi operasi ini tidak mengembalikan elemen respons.

Kesalahan Khusus

Implementasi operasi ini tidak mengembalikan kesalahan khusus. Untuk informasi umum tentang kesalahan Amazon S3 dan daftar kode kesalahan, lihat Respons Kesalahan.

Contoh

Contoh 1: Menambahkan Konfigurasi Siklus Hidup ke Bucket yang Tidak Versioning-enabled

Konfigurasi siklus hidup berikut menentukan dua aturan, masing-masing dengan satu tindakan.

  • Tindakan Transition memberitahu Amazon S3 untuk melakukan transisi objek dengan awalan “documents/” ke kelas penyimpanan 30 hari setelah pembuatan.

  • Tindakan Kedaluwarsa memberitahu Amazon S3 untuk menghapus objek dengan awalan “logs/” 365 hari setelah pembuatan.


<LifecycleConfiguration>
  <Rule>
    <ID>id1</ID>
    <Prefix>documents/</Prefix>
    <Status>Enabled</Status>
    <Transition>
      <Days>30</Days>
      <StorageClass>GLACIER</StorageClass>
    </Transition>
  </Rule>
  <Rule>
    <ID>id2</ID>
    <Prefix>logs/</Prefix>
    <Status>Enabled</Status>
    <Expiration>
      <Days>365</Days>
    </Expiration>
  </Rule>
</LifecycleConfiguration>

Berikut ini adalah contoh PUT /?lifecycle permintaan yang menambahkan konfigurasi siklus hidup sebelumnya ke examplebucket bucket.

PUT /?lifecycle HTTP/1.1
Host: examplebucket.s3.amazonaws.com 
x-amz-date: Wed, 14 May 2014 02:11:21 GMT
Content-MD5: q6yJDlIkcBaGGfb3QLY69A==
Authorization: authorization string
Content-Length: 415

<LifecycleConfiguration>
  <Rule>
    <ID>id1</ID>
    <Prefix>documents/</Prefix>
    <Status>Enabled</Status>
    <Transition>
      <Days>30</Days>
      <StorageClass>GLACIER</StorageClass>
    </Transition>
  </Rule>
  <Rule>
    <ID>id2</ID>
    <Prefix>logs/</Prefix>
    <Status>Enabled</Status>
    <Expiration>
      <Days>365</Days>
    </Expiration>
  </Rule>
</LifecycleConfiguration>

Berikut ini adalah contoh respons.

HTTP/1.1 200 OK
x-amz-id-2: r+qR7+nhXtJDDIJ0JJYcd+1j5nM/rUFiiiZ/fNbDOsd3JUE8NWMLNHXmvPfwMpdc
x-amz-request-id: 9E26D08072A8EF9E
Date: Wed, 14 May 2014 02:11:22 GMT
Content-Length: 0
Server: AmazonS3

Contoh 2: Menambahkan Konfigurasi Siklus Hidup ke Versioning-enabled Bucket

Konfigurasi siklus hidup berikut menentukan dua aturan, masing-masing dengan satu tindakan untuk dilakukan Amazon S3. Anda menentukan tindakan ini ketika bucket Anda diaktifkan versi atau pembuatan versi ditangguhkan:

  • T NoncurrentVersionExpiration indakan memberitahu Amazon S3 untuk mengakhiri versi objek noncurrent dengan awalan “logs/” 100 hari setelah objek menjadi noncurrent.

  • T NoncurrentVersionTransition indakan memberitahu Amazon S3 untuk mentransisikan versi objek noncurrent dengan awalan “documents/” ke kelas penyimpanan 30 hari setelah objek menjadi noncurrent.

<LifeCycleConfiguration>
  <Rule>
    <ID>DeleteAfterBecomingNonCurrent</ID>
    <Prefix>logs/</Prefix>
    <Status>Enabled</Status>
    <NoncurrentVersionExpiration>
      <NoncurrentDays>100</NoncurrentDays>
    </NoncurrentVersionExpiration>
  </Rule>
  <Rule>
    <ID>TransitionAfterBecomingNonCurrent</ID>
    <Prefix>documents/</Prefix>
    <Status>Enabled</Status>
    <NoncurrentVersionTransition>
      <NoncurrentDays>30</NoncurrentDays>
      <StorageClass>GLACIER</StorageClass>
    </NoncurrentVersionTransition>
  </Rule>
</LifeCycleConfiguration>

Berikut ini adalah contoh PUT /?lifecycle permintaan yang menambahkan konfigurasi siklus hidup sebelumnya ke examplebucket bucket.

PUT /?lifecycle HTTP/1.1
Host: examplebucket.s3.amazonaws.com 
x-amz-date: Wed, 14 May 2014 02:21:48 GMT
Content-MD5: 96rxH9mDqVNKkaZDddgnw==
Authorization: authorization string
Content-Length: 598

<LifeCycleConfiguration>
  <Rule>
    <ID>DeleteAfterBecomingNonCurrent</ID>
    <Prefix>logs/</Prefix>
    <Status>Enabled</Status>
    <NoncurrentVersionExpiration>
      <NoncurrentDays>1</NoncurrentDays>
    </NoncurrentVersionExpiration>
  </Rule>
  <Rule>
    <ID>TransitionSoonAfterBecomingNonCurrent</ID>
    <Prefix>documents/</Prefix>
    <Status>Enabled</Status>
    <NoncurrentVersionTransition>
      <NoncurrentDays>0</NoncurrentDays>
      <StorageClass>GLACIER</StorageClass>
    </NoncurrentVersionTransition>
  </Rule>
</LifeCycleConfiguration>

Berikut ini adalah contoh respons.

HTTP/1.1 200 OK
x-amz-id-2: aXQ+KbIrmMmoO//3bMdDTw/CnjArwje+J49Hf+j44yRb/VmbIkgIO5A+PT98Cp/6k07hf+LD2mY=
x-amz-request-id: 02D7EC4C10381EB1
Date: Wed, 14 May 2014 02:21:50 GMT
Content-Length: 0
Server: AmazonS3

Contoh Tambahan

Untuk contoh lebih lanjut tentang transisi objek ke kelas penyimpanan seperti STANDARD_IA atau ONEZONE_IA, lihat Contoh Konfigurasi Siklus Hidup. https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html#lifecycle-configuration-examples