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

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

Jika Anda mencari solusi penyimpanan arsip, sebaiknya gunakan kelas penyimpanan Amazon Glacier di Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval, dan S3 Glacier Deep Archive. Untuk mempelajari lebih lanjut tentang opsi penyimpanan ini, lihat kelas penyimpanan Amazon Glacier.

Amazon Glacier (layanan berbasis brankas mandiri asli) tidak akan lagi menerima pelanggan baru mulai 15 Desember 2025, tanpa berdampak pada pelanggan yang sudah ada. Amazon Glacier adalah layanan mandiri dengan miliknya APIs sendiri yang menyimpan data di brankas dan berbeda dari Amazon S3 dan kelas penyimpanan Amazon S3 Glacier. Data Anda yang ada akan tetap aman dan dapat diakses di Amazon Glacier tanpa batas waktu. Tidak diperlukan migrasi. Untuk penyimpanan arsip jangka panjang berbiaya rendah, AWS rekomendasikan kelas penyimpanan Amazon S3 Glacier, yang memberikan pengalaman pelanggan yang unggul dengan APIs berbasis ember S3, ketersediaan penuh, biaya lebih rendah, Wilayah AWS dan integrasi layanan. AWS Jika Anda ingin meningkatkan kemampuan, pertimbangkan untuk bermigrasi ke kelas penyimpanan Amazon S3 Glacier dengan menggunakan Panduan Solusi AWS kami untuk mentransfer data dari kubah Amazon Glacier ke kelas penyimpanan Amazon S3 Glacier.

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 ini menetapkan dan kemudian memberlakukan kebijakan pengambilan data di AWS Wilayah yang ditentukan dalam permintaan. PUT Anda dapat menetapkan satu kebijakan per AWS Wilayah 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 Amazon Glacier.

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

AccountIdNilainya adalah Akun AWS ID. Nilai ini harus cocok dengan Akun AWS ID yang terkait dengan kredensional yang digunakan untuk menandatangani permintaan. Anda dapat menentukan Akun AWS ID atau secara opsional satu '-' (tanda hubung), dalam hal ini Amazon Glacier menggunakan Akun AWS ID yang terkait dengan kredenal 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.

Tipe: Angka

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

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

Aturan

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

Tipe: Array

Wajib: Ya

Strategi

Tipe kebijakan pengambilan data yang ditetapkan.

Tipe: String

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 Amazon Glacier.

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 Amazon Glacier dan pesan kesalahan, 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 Glacier (Amazon Glacier) menetapkan kebijakan dan mengembalikan HTTP 204 No Content seperti yang ditunjukkan pada 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