**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](https://aws.amazon.com/s3/storage-classes/glacier/). Amazon Glacier (layanan berbasis brankas mandiri asli) tidak lagi menerima pelanggan baru. 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](https://aws.amazon.com/s3/storage-classes/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](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/). 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` atau `Locked`. + 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)](api-InitiateVaultLock.md). Kunci vault ditetapkan ke dalam status `Locked` dengan memanggil [Menyelesaikan Kunci Vault (POST lockId)](api-CompleteVaultLock.md). Anda dapat menghentikan proses penguncian vault dengan memanggil [Membatalkan Kunci Vault (DELETE lock-policy)](api-AbortVaultLock.md). Untuk informasi selengkapnya tentang proses penguncian vault, lihat [Kunci Gletser Amazon Glacier](vault-lock.md). 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](vault-lock-policy.md). ## 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 ``` 1. GET /AccountId/vaults/vaultName/lock-policy HTTP/1.1 2. Host: glacier.Region.amazonaws.com 3. Date: Date 4. Authorization: SignatureValue 5. x-amz-glacier-version: 2012-06-01 ``` **catatan** `AccountId`Nilainya adalah Akun AWS ID akun yang memiliki brankas. 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 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](api-common-request-headers.md). ### Isi Permintaan Operasi ini tidak memiliki isi permintaan. ## Respons Sebagai tanggapan, Amazon Glacier (Amazon Glacier) mengembalikan kebijakan akses vault dalam format JSON di badan 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](api-common-response-headers.md). ### Isi Respons Isi respons berisi bidang JSON berikut. **Kebijakan** Kebijakan kunci vault sebagai string JSON, yang menggunakan "\$1" sebagai karakter escape. Tipe: String **Status** Status kunci vault. Tipe: String Nilai yang valid: `InProgress``|Locked` **ExpirationDate** Tanggal dan waktu UTC saat ID kunci kedaluwarsa. Nilai ini bisa `null` jika status kunci vault adalah `Locked`. *Tipe*: 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`. *Tipe*: Representasi string dalam format tanggal ISO 8601, misalnya `2013-03-20T17:03:43.221Z`. ### Kesalahan Untuk informasi tentang pengecualian Amazon Glacier dan pesan kesalahan, lihat. [Respons Kesalahan](api-error-responses.md) ## 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. ``` 1. GET /-/vaults/examplevault/lock-policy HTTP/1.1 2. Host: glacier.us-west-2.amazonaws.com 3. x-amz-Date: 20170210T120000Z 4. x-amz-glacier-version: 2012-06-01 5. 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 Glacier mengembalikan kebijakan akses vault sebagai string JSON di badan respons. String JSON yang dikembalikan menggunakan "\$1" sebagai karakter escape, seperti yang ditunjukkan dalam contoh permintaan [Memulai Kunci Vault (POST lock-policy)](api-InitiateVaultLock.md). Namun, contoh berikut menunjukkan string JSON yang dikembalikan tanpa karakter escape agar mudah dibaca. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:00:00 GMT 4. Content-Type: application/json 5. Content-Length: length 6. 7. { 8. "Policy": " 9. { 10. "Version": "2012-10-17", 11. "Statement": [ 12. { 13. "Sid": "Define-vault-lock", 14. "Principal": { 15. "AWS": "arn:aws:iam::999999999999:root" 16. }, 17. "Effect": "Deny", 18. "Action": "glacier:DeleteArchive", 19. "Resource": [ 20. "arn:aws:glacier:us-west-2:999999999999:vaults/examplevault" 21. ], 22. "Condition": { 23. "NumericLessThanEquals": { 24. "glacier:ArchiveAgeInDays": "365" 25. } 26. } 27. } 28. ] 29. } 30. ", 31. "State": "InProgress", 32. "ExpirationDate": "exampledate", 33. "CreationDate": "exampledate" 34. } ``` ## Bagian Terkait + [Membatalkan Kunci Vault (DELETE lock-policy)](api-AbortVaultLock.md) + [Menyelesaikan Kunci Vault (POST lockId)](api-CompleteVaultLock.md) + [Memulai Kunci Vault (POST lock-policy)](api-InitiateVaultLock.md) ## Lihat Juga Untuk informasi selengkapnya tentang penggunaan API ini di salah satu Amazon khusus bahasa SDKs, lihat berikut ini: + [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/get-vault-lock.html)