Mengatur Kebijakan Pengambilan Data (PUT policy) - Amazon S3 Glacier
DeskripsiPermintaanResponsContohBagian Terkait

Halaman ini hanya untuk pelanggan lama dari layanan S3 Glacier menggunakan Vaults dan asli dari 2012. REST API

Jika Anda mencari solusi penyimpanan arsip, kami sarankan untuk menggunakan kelas penyimpanan S3 Glacier di Amazon S3, Pengambilan Instan Gletser S3, Pengambilan Fleksibel Gletser S3, dan S3 Glacier Deep Archive. Untuk mempelajari lebih lanjut tentang opsi penyimpanan ini, lihat Kelas penyimpanan S3 Glacier dan Penyimpanan data jangka panjang menggunakan kelas penyimpanan S3 Glacier di Panduan Pengguna Amazon S3. Kelas penyimpanan ini menggunakan Amazon S3API, tersedia di semua wilayah, dan dapat dikelola dalam konsol Amazon S3. Mereka menawarkan fitur seperti Analisis Biaya Penyimpanan, Lensa Penyimpanan, fitur enkripsi opsional canggih, dan banyak lagi.

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

Mengatur Kebijakan Pengambilan Data (PUT policy)

Deskripsi

Operasi menetapkan, lalu menerapkan kebijakan pengambilan data di Wilayah AWS yang ditentukan dalam permintaan PUT. Anda dapat menetapkan satu kebijakan per Wilayah AWS untuk Akun AWS. Kebijakan ini diterapkan dalam beberapa menit setelah operasi PUT berhasil.

Operasi kebijakan yang ditetapkan tidak memengaruhi pengambilan tugas yang sedang berlangsung sebelum kebijakan diterapkan. Untuk informasi selengkapnya tentang kebijakan pengambilan data, lihat Kebijakan Pengambilan Data Gletser S3.

Permintaan

Sintaksis

Untuk menetapkan kebijakan pengambilan data, kirim permintaan HTTP PUT ke URI kebijakan pengambilan data seperti yang ditunjukkan dalam contoh sintaks berikut.

PUT /AccountId/policies/data-retrieval HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
Content-Length: Length
x-amz-glacier-version: 2012-06-01
			
{
  "Policy":
    {
      "Rules":[
         {
             "Strategy": String,
             "BytesPerHour": Number          
         }
       ]
    }
}

catatan

Nilai AccountId adalah ID Akun AWS. Nilai ini harus sesuai dengan ID Akun AWS yang terkait dengan kredensial yang digunakan untuk menandatangani permintaan. Anda dapat menentukan ID Akun AWS atau secara opsional satu '-' (tanda hubung), dalam hal ini, Amazon S3 Glacier menggunakan ID Akun AWS yang terkait dengan kredensial yang digunakan untuk menandatangani permintaan. Jika Anda menentukan ID akun, jangan sertakan tanda hubung ('-') di ID.

Parameter Permintaan

Operasi ini tidak menggunakan parameter permintaan.

Header Permintaan

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

Isi Permintaan

Isi permintaan berisi bidang JSON berikut.

BytesPerHour

Jumlah maksimum byte yang dapat diambil dalam satu jam.

Bidang ini hanya diperlukan jika nilai bidang Strategy (Strategi) adalah BytesPerHour. Operasi PUT Anda akan ditolak jika bidang Strategy (Strategi) tidak ditetapkan ke BytesPerHour dan Anda menetapkan kolom ini.

Jenis: Jumlah

Wajib: Ya, jika bidang Strategy (Strategi) diatur keBytesPerHour. Jika tidak, tidak.

Nilai valid: Nilai bilangan bulat minimum 1. Nilai bilangan bulat maksimum 2^63 - 1 inklusif.

Aturan

Aturan kebijakan. Meskipun ini adalah tipe daftar, saat ini hanya harus ada satu aturan, yang berisi bidang Strategi dan secara opsional bidang BytesPerHour.

Jenis: Susunan

Wajib: Ya

Strategi

Tipe kebijakan pengambilan data yang ditetapkan.

Jenis: Tali

Wajib: Ya

Nilai yang valid: BytesPerHour|FreeTier|None. BytesPerHour sama dengan memilih Max Retrieval Rate (Tingkat Pengambilan Maks.) di konsol. FreeTier sama dengan memilih Free Tier Only (Hanya Tingkat Gratis) di konsol. None sama dengan memilih No Retrieval Policy (Tidak Ada Kebijakan) di konsol. Untuk informasi selengkapnya tentang memilih kebijakan pengambilan data di konsol, lihat Kebijakan Pengambilan Data Gletser S3.

Respons

Sintaksis

HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date

Header Respons

Operasi ini hanya menggunakan header respons yang umum untuk sebagian besar respons. Untuk informasi tentang header permintaan umum, lihat Header Respons Umum.

Isi Respons

Operasi ini tidak mengembalikan isi respons.

Kesalahan

Untuk informasi tentang pengecualian dan pesan kesalahan Amazon S3 Glacier, lihat Respons Kesalahan.

Contoh

Contoh Permintaan

Contoh berikut mengirimkan permintaan HTTP PUT dengan bidang Strategy (Strategi) diatur ke BytesPerHour. 

PUT /-/policies/data-retrieval HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
			
{
  "Policy":
    {
      "Rules":[
         {
             "Strategy":"BytesPerHour",
             "BytesPerHour":10737418240       
          }
       ]
    }
}

Contoh berikut mengirimkan permintaan HTTP PUT dengan bidang Strategy (Strategi) diatur ke FreeTier. 

PUT /-/policies/data-retrieval HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
			
{
  "Policy":
    {
      "Rules":[
         {
             "Strategy":"FreeTier"   
          }
       ]
    }
}

Contoh berikut mengirimkan permintaan HTTP PUT dengan bidang Strategy (Strategi) diatur ke None. 

PUT /-/policies/data-retrieval HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
			
{
  "Policy":
    {
      "Rules":[
         {
             "Strategy":"None"   
          }
       ]
    }
}

Contoh Respons

Jika permintaan berhasil, Amazon S3 Glacier (S3 Glacier) menetapkan kebijakan dan mengembalikan HTTP 204 No Content seperti yang ditampilkan dalam contoh berikut.

HTTP/1.1 204 No Content
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT