View a markdown version of this page

Siklus hidup GET Bucket (Tidak digunakan lagi) - Amazon Simple Storage Service
DeskripsiPermohonanResponsKesalahan KhususContohSumber Daya Terkait

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)

Deskripsi

penting

Untuk versi terbaru dari API ini, lihat GetBucketLifecycleConfiguration. 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 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 di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon.

Permohonan

Sintaksis

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

Parameter Permintaan

Implementasi operasi ini tidak menggunakan parameter permintaan.

Header Permintaan

Implementasi operasi ini hanya menggunakan header permintaan yang umum untuk semua operasi. Untuk informasi selengkapnya, lihat Header Permintaan Umum.

Elemen permintaan

Implementasi operasi ini tidak menggunakan elemen permintaan.

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 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

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. Waktu kelayakan objek dihitung sebagai waktu pembuatan+jumlah hari dengan waktu yang dihasilkan dibulatkan ke tengah malam UTC hari berikutnya.

Jenis: Non-negative Integer saat digunakan denganTransition, Integer Positif saat digunakan denganExpiration.

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.

Jenis: Integer Positif

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.

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

  • 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.

    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, maka Amazon S3 akan mengganti versi tersebut.

    catatan

    Untuk mengatur kedaluwarsa untuk objek noncurrent, Anda harus menggunakan NoncurrentVersionExpiration tindakan.

Tipe: Kontainer

Anak-anak: Hari atau Tanggal

Leluhur: Aturan

 Ya, jika tag induk ditentukan
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 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 di Panduan Pengguna Layanan Penyimpanan Sederhana Amazon.

Tipe: String

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

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

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

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.

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.

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 keSTANDARD_IA,ONEZONE_IA, atau kelas penyimpanan.

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.

Tipe: Kontainer

Anak-anak: NoncurrentDays dan StorageClass

Leluhur: Aturan

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

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

Tipe: String

Leluhur: Aturan

 Ya
Rule

Wadah untuk aturan siklus hidup.

Tipe: Kontainer

Leluhur: 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 atau Dinonaktifkan

 Ya
StorageClass

Menentukan kelas penyimpanan Amazon S3 yang ingin Anda transisi objek.

Tipe: String

Leluhur: Transisi dan NoncurrentVersionTransition

Nilai yang valid: STANDARD_IA | ONEZONE_IA |

Ya
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.

  • Saat bucket Anda mengaktifkan versi (atau pembuatan versi ditangguhkan), Amazon S3 hanya mentransisi versi terkini dari objek yang diidentifikasi dalam aturan.

    catatan

    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.

Tipe: Kontainer

Anak-anak: Hari atau Tanggal, dan StorageClass

Leluhur: Aturan

 Ya, jika tidak ada tindakan lain yang hadir di Rule

Kesalahan Khusus

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, lihatTanggapan kesalahan.

Contoh

Contoh 1: Mengambil Sub-Sumber Daya Siklus Hidup

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

Permintaan Sampel

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

Contoh Respons

HTTP/1.1 200 OK
x-amz-id-2: ITnGT1y4RyTmXa3rPi4hklTXouTf0hccUjo0iCPjz6FnfIutBj3M7fPGlWO2SEWp
x-amz-request-id: 51991C342C575321
Date: Thu, 15 Nov 2012 00:17:23 GMT
Server: AmazonS3
Content-Length: 358

<?xml version="1.0" encoding="UTF-8"?>
<LifecycleConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
    <Rule>
        <ID>Archive and then delete rule</ID>
        <Prefix>projectdocs/</Prefix>
        <Status>Enabled</Status>
       <Transition>
           <Days>30</Days>
           <StorageClass>STANDARD_IA</StorageClass>
        </Transition>
        <Transition>
           <Days>365</Days>
           <StorageClass>GLACIER</StorageClass>
        </Transition>
        <Expiration>
           <Days>3650</Days>
        </Expiration>
    </Rule>
</LifecycleConfiguration>