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
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Mencantumkan Tanda untuk Vault (GET tags)
Operasi ini mencantumkan semua tag yang dilampirkan di vault. Operasi ini mengembalikan peta kosong jika tidak ada tanda. Untuk informasi selengkapnya tentang tanda, lihat Menandai Sumber Daya Amazon S3 Glacier.
Sintaks Permintaan
Untuk mencantumkan tanda untuk vault, kirim permintaan HTTP GET ke URI tanda seperti yang ditunjukkan dalam contoh sintaks berikut.
GET /
AccountId
/vaults/vaultName
/tags 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
Jika operasi berhasil, layanan mengirimkan kembali respon 200 OK
HTTP.
Sintaks Respons
HTTP/1.1 200 OK x-amzn-RequestId: x-amzn-RequestId Date: Date Content-Type: application/json Content-Length: Length { "Tags": { "string" : "string", "string" : "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.
- Tag
-
Tanda yang dilampirkan ke vault. Setiap tanda terdiri dari kunci dan nilai.
Jenis: String ke Peta String
Diperlukan: Ya
Kesalahan
Untuk informasi tentang pengecualian dan pesan kesalahan Amazon S3 Glacier, lihat Respons Kesalahan.
Contoh
Contoh: Mencantumkan Tandai untuk Vault
Contoh berikut mencantumkan tanda untuk vault.
Contoh Permintaan
Dalam contoh ini, permintaan GET dikirim untuk mengambil daftar tanda dari vault yang ditentukan.
GET /-/vaults/examplevault/tags 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
Jika permintaan berhasil, Amazon S3 Glacier (S3 Glacier) mengembalikan HTTP 200 OK
dengan daftar tanda untuk vault seperti yang ditampilkan dalam contoh berikut.
HTTP/1.1 200 OK x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q Date: Wed, 10 Feb 2017 12:02:00 GMT Content-Type: application/json Content-Length: length { "Tags", { "examplekey1": "examplevalue1", "examplekey2": "examplevalue2" } }
Bagian Terkait
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu dari SDK Amazon spesifik bahasa, lihat berikut ini: