**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. # Mencantumkan Vault (GET vaults) ## Deskripsi Operasi ini mencantumkan semua vault yang dimiliki oleh akun pengguna yang memanggil. Daftar yang dikembalikan dalam respons diurutkan ASCII berdasarkan nama vault. Secara default, operasi ini mengembalikan hingga 10 item per permintaan. Jika ada lebih banyak vault yang dicantumkan, bidang `marker` respons dalam isi respons berisi vault Amazon Resource Name (ARN) tempat untuk melanjutkan daftar dengan permintaan Cantumkan Vault baru; jika tidak, bidang `marker` adalah `null`. Dalam permintaan List Vaults berikutnya, Anda menetapkan `marker` parameter ke nilai Amazon Glacier (Amazon Glacier) yang dikembalikan dalam tanggapan terhadap permintaan List Vaults sebelumnya. Anda juga dapat membatasi jumlah vault yang dikembalikan dalam respons dengan menentukan parameter `limit` dalam permintaan. ## Permintaan Untuk mendapatkan daftar vault, Anda mengirim permintaan `GET` ke sumber daya *vault*. ### Sintaksis ``` 1. GET /AccountId/vaults 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. 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 menggunakan parameter permintaan berikut. | Nama | Deskripsi | Wajib | | --- | --- | --- | | limit | Jumlah maksimum vault yang dikembalikan. Batas default adalah 10. Jumlah vault yang dikembalikan mungkin kurang dari batas yang ditentukan, tetapi jumlah vault yang dikembalikan tidak pernah melebihi batas. Tipe: String Batasan: Nilai bilangan bulat minimum 1. Nilai bilangan bulat maksimum 10. | Tidak | | marker | String yang digunakan untuk pemberian nomor halaman. `marker` menentukan ARN vault setelah cantuman vault harus dimulai. (Vault yang ditentukan oleh `marker` tidak disertakan dalam daftar yang dikembalikan.) Dapatkan nilai `marker` dari respons Cantumkan Vault sebelumnya. Anda harus menyertakan `marker` hanya jika Anda melanjutkan pemberian nomor halaman dari hasil yang dimulai dalam permintaan Cantumkan Vault sebelumnya. Menentukan nilai kosong ("") untuk penanda mengembalikan daftar vault yang dimulai dari vault pertama. Tipe: String Batasan: Tidak Ada | Tidak | ### 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 ### Sintaksis ``` HTTP/1.1 200 OK x-amzn-RequestId: x-amzn-RequestId Date: Date Content-Type: application/json Content-Length: Length { "Marker": String "VaultList": [ { "CreationDate": String, "LastInventoryDate": String, "NumberOfArchives": Number, "SizeInBytes": Number, "VaultARN": String, "VaultName": 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. **CreationDate** Tanggal vault dibuat, dalam Waktu Universal Terkoordinasi (UTC). *Tipe*: String. Representasi string dalam format tanggal ISO 8601, misalnya `2013-03-20T17:03:43.221Z`. **LastInventoryDate** Tanggal inventaris vault terakhir, dalam Waktu Universal Terkoordinasi (UTC). Bidang ini dapat nol jika inventaris belum berjalan di vault, misalnya, jika Anda baru saja membuat vault. Untuk informasi tentang memulai inventaris untuk vault, lihat [Memulai Tugas (POST jobs)](api-initiate-job-post.md). *Tipe*: Representasi string dalam format tanggal ISO 8601, misalnya `2013-03-20T17:03:43.221Z`. **Penanda** `vaultARN` yang mewakili tempat untuk melanjutkan pemberian nomor halaman hasil. Anda menggunakan `marker` dalam permintaan Cantumkan Vault lainnya untuk mendapatkan lebih banyak vault dalam daftar. Jika tidak ada lagi vault, nilai ini adalah `null`. *Tipe*: String **NumberOfArchives** Jumlah arsip di vault mulai dari tanggal inventaris terakhir. *Tipe*: Angka **SizeInBytes** Ukuran total, dalam byte, dari semua arsip di vault termasuk overhead per arsip apa pun, yang dimulai dari tanggal inventaris terakhir. *Tipe*: Angka **Vaultarn** Amazon Resource Name (ARN) dari vault. *Tipe*: String **VaultList** Array objek apa pun, dengan masing-masing objek yang memberikan deskripsi vault. *Tipe*: Array **VaultName** Nama vault. *Tipe*: String ### Kesalahan Untuk informasi tentang pengecualian Amazon Glacier dan pesan kesalahan, lihat. [Respons Kesalahan](api-error-responses.md) ## Contoh ### Contoh: Mencantumkan Semua Vault Contoh berikut mencantumkan vault. Karena parameter `marker` dan `limit` tidak ditentukan dalam permintaan, hingga 10 vault dikembalikan. #### Contoh Permintaan ``` 1. GET /-/vaults 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 `Marker` adalah `null` yang menunjukkan tidak ada lagi vault yang dicantumkan. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:02:00 GMT 4. Content-Type: application/json 5. Content-Length: 497 6. 7. { 8. "Marker": null, 9. "VaultList": [ 10. { 11. "CreationDate": "2012-03-16T22:22:47.214Z", 12. "LastInventoryDate": "2012-03-21T22:06:51.218Z", 13. "NumberOfArchives": 2, 14. "SizeInBytes": 12334, 15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1", 16. "VaultName": "examplevault1" 17. }, 18. { 19. "CreationDate": "2012-03-19T22:06:51.218Z", 20. "LastInventoryDate": "2012-03-21T22:06:51.218Z", 21. "NumberOfArchives": 0, 22. "SizeInBytes": 0, 23. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault2", 24. "VaultName": "examplevault2" 25. }, 26. { 27. "CreationDate": "2012-03-19T22:06:51.218Z", 28. "LastInventoryDate": "2012-03-25T12:14:31.121Z", 29. "NumberOfArchives": 0, 30. "SizeInBytes": 0, 31. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault3", 32. "VaultName": "examplevault3" 33. } 34. ] 35. } ``` ### Contoh: Daftar Parsial Vault Contoh berikut mengembalikan dua vault yang dimulai dari vault yang ditentukan oleh `marker`. #### Contoh Permintaan ``` 1. GET /-/vaults?limit=2&marker=arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1 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 Dua vault dikembalikan dalam daftar. `Marker` berisi ARN vault untuk melanjutkan pemberian nomor halaman dalam permintaan Cantumkan Vault lainnya. ``` 1. HTTP/1.1 200 OK 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q 3. Date: Wed, 10 Feb 2017 12:02:00 GMT 4. Content-Type: application/json 5. Content-Length: 497 6. 7. { 8. "Marker": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault3", 9. "VaultList": [ 10. { 11. "CreationDate": "2012-03-16T22:22:47.214Z", 12. "LastInventoryDate": "2012-03-21T22:06:51.218Z", 13. "NumberOfArchives": 2, 14. "SizeInBytes": 12334, 15. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1", 16. "VaultName": "examplevault1" 17. }, 18. { 19. "CreationDate": "2012-03-19T22:06:51.218Z", 20. "LastInventoryDate": "2012-03-21T22:06:51.218Z", 21. "NumberOfArchives": 0, 22. "SizeInBytes": 0, 23. "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault2", 24. "VaultName": "examplevault2" 25. } 26. ] 27. } ``` ## Bagian Terkait + [Membuat Vault (PUT vault)](api-vault-put.md) + [Menghapus Vault (DELETE vault)](api-vault-delete.md) + [Memulai Tugas (POST jobs)](api-initiate-job-post.md) + [Identity and Access Management untuk Amazon Glacier](security-iam.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/list-vaults.html)