Mendapatkan Kebijakan Pengambilan Data (GET policy)

Deskripsi

Operasi mengembalikan kebijakan pengambilan data saat ini untuk Wilayah Akun AWS dan AWS yang ditentukan dalam permintaan GET. Untuk informasi selengkapnya tentang kebijakan pengambilan data, lihat Kebijakan Pengambilan Data Gletser S3.

Permintaan

Untuk mengembalikan kebijakan pengambilan data saat ini, kirim permintaan GET HTTP ke URI kebijakan pengambilan data seperti yang ditunjukkan dalam contoh sintaks berikut.

Sintaksis

GET /AccountId/policies/data-retrieval HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
x-amz-glacier-version: 2012-06-01

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

Operasi ini tidak memiliki isi permintaan.

Respons

Sintaksis

HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: length
{
  "Policy":
    {
      "Rules":[
         {
            "BytesPerHour": Number,
            "Strategy": String	 
         }
       ]
    }
}

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

Isi respons berisi bidang JSON berikut.

BytesPerHour

Jumlah maksimum byte yang dapat diambil dalam satu jam.

Bidang ini hanya akan muncul jika nilai bidang Strategy (Strategi) adalah BytesPerHour.

Jenis: Jumlah

Aturan

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

Jenis: Susunan

Strategi

Tipe kebijakan pengambilan data.

Jenis: String

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.

Kesalahan

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

Contoh

Contoh berikut menunjukkan cara mendapatkan kebijakan pengambilan data.

Contoh Permintaan

Dalam contoh ini, permintaan GET dikirim ke URI dari lokasi kebijakan.

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

Contoh Respons

Respons yang sukses menunjukkan kebijakan pengambilan data dalam isi respons dalam format JSON.

HTTP/1.1 200 OK
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:00:00 GMT
Content-Type: application/json
Content-Length: 85
 
{
  "Policy":
    {
      "Rules":[
         {
           "BytesPerHour":10737418240,
           "Strategy":"BytesPerHour"
          }
       ]
    }
}

Bagian Terkait

• Mengatur Kebijakan Pengambilan Data (PUT policy)

• Memulai Tugas (POST jobs)