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.
Mendapatkan Kunci Vault (GET lock-policy)
Deskripsi
Operasi ini mengambil atribut berikut dari subsumber daya lock-policy
yang ditetapkan pada vault yang ditentukan:
-
Kebijakan kunci vault yang ditetapkan di vault.
-
Status kunci vault, yakni
InProgess
atauLocked
. -
Saat ID kunci kedaluwarsa. ID kunci digunakan untuk menyelesaikan proses penguncian vault.
-
Ketika kunci vault dimulai dan ditetapkan ke status
InProgress
.
Kunci vault ditetapkan ke dalam status InProgress
dengan memanggil Memulai Kunci Vault (POST lock-policy). Kunci vault ditetapkan ke dalam status Locked
dengan memanggil Menyelesaikan Kunci Vault (POST lockId). Anda dapat menghentikan proses penguncian vault dengan memanggil Membatalkan Kunci Vault (DELETE lock-policy). Untuk informasi selengkapnya tentang proses penguncian vault, lihat Kunci Vault S3 Glacier.
Jika tidak ada kebijakan kunci vault yang ditetapkan di vault, operasi mengembalikan kesalahan 404
Not found
. Untuk informasi selengkapnya tentang kebijakan kunci vault, lihat Kebijakan Vault Lock.
Permintaan
Untuk mengembalikan kebijakan kunci vault saat ini dan atribut lainnya, kirim permintaan GET
HTTP untuk URI dari subsumber daya lock-policy
vault seperti yang ditunjukkan dalam contoh sintaks berikut.
Sintaksis
GET /
AccountId
/vaults/vaultName
/lock-policy 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 dari akun yang memiliki vault. 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 menggunakan 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
Sebagai respons, Amazon S3 Glacier (S3 Glacier) mengembalikan kebijakan akses vault dalam format JSON di isi respons.
Sintaksis
HTTP/1.1 200 OK x-amzn-RequestId: x-amzn-RequestId Date: Date Content-Type: application/json Content-Length: length { "Policy": "string", "State": "string", "ExpirationDate": "string", "CreationDate":"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.
- Kebijakan
-
Kebijakan kunci vault sebagai string JSON, yang menggunakan "\" sebagai karakter escape.
Jenis: String
- negara bagian
-
Status kunci vault.
Jenis: String
Nilai yang valid:
InProgress
|
Locked
- ExpirationDate
-
Tanggal dan waktu UTC saat ID kunci kedaluwarsa. Nilai ini bisa
null
jika status kunci vault adalahLocked
.Jenis: Representasi string dalam format tanggal ISO 8601, misalnya
2013-03-20T17:03:43.221Z
. - CreationDate
-
Tanggal dan waktu UTC saat status kunci vault ditetapkan ke
InProgress
.Jenis: Representasi string dalam format tanggal ISO 8601, misalnya
2013-03-20T17:03:43.221Z
.
Kesalahan
Untuk informasi tentang pengecualian dan pesan kesalahan Amazon S3 Glacier, lihat Respons Kesalahan.
Contoh
Contoh berikut menunjukkan cara mendapatkan kebijakan kunci vault.
Contoh Permintaan
Dalam contoh ini, permintaan GET
dikirim ke URI dari subsumber daya lock-policy
vault.
GET /-/vaults/examplevault/lock-policy 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, S3 Glacier mengembalikan kebijakan akses vault sebagai string JSON dalam isi respons. String JSON yang dikembalikan menggunakan "\" sebagai karakter escape, seperti yang ditunjukkan dalam contoh permintaan Memulai Kunci Vault (POST lock-policy). Namun, contoh berikut menunjukkan string JSON yang dikembalikan tanpa karakter escape agar mudah dibaca.
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: length { "Policy": " { "Version": "2012-10-17", "Statement": [ { "Sid": "Define-vault-lock", "Principal": { "AWS": "arn:aws:iam::999999999999:root" }, "Effect": "Deny", "Action": "glacier:DeleteArchive", "Resource": [ "arn:aws:glacier:us-west-2:999999999999:vaults/examplevault" ], "Condition": { "NumericLessThanEquals": { "glacier:ArchiveAgeInDays": "365" } } } ] } ", "State": "InProgress", "ExpirationDate": "exampledate", "CreationDate": "exampledate" }
Bagian Terkait
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu dari SDK Amazon spesifik bahasa, lihat berikut ini: