Mencantumkan Vault (GET vaults) - Amazon Glacier
DeskripsiPermintaanResponsContohBagian TerkaitLihat Juga

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.

Amazon Glacier (layanan berbasis brankas mandiri asli) tidak akan lagi menerima pelanggan baru mulai 15 Desember 2025, tanpa berdampak pada pelanggan yang sudah ada. 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, 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.

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

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

catatan

AccountIdNilainya 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.

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.

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).

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

Contoh

Contoh: Mencantumkan Semua Vault

Contoh berikut mencantumkan vault. Karena parameter marker dan limit tidak ditentukan dalam permintaan, hingga 10 vault dikembalikan.

Contoh Permintaan

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

Marker adalah null yang menunjukkan tidak ada lagi vault yang dicantumkan.

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: 497	

{
  "Marker": null,
  "VaultList": [ 
   {
    "CreationDate": "2012-03-16T22:22:47.214Z",
    "LastInventoryDate": "2012-03-21T22:06:51.218Z",
    "NumberOfArchives": 2,
    "SizeInBytes": 12334,
    "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1",
    "VaultName": "examplevault1"
   }, 
   {
    "CreationDate": "2012-03-19T22:06:51.218Z",
    "LastInventoryDate": "2012-03-21T22:06:51.218Z",
    "NumberOfArchives": 0,
    "SizeInBytes": 0,
    "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault2",
    "VaultName": "examplevault2"
   },
   {
    "CreationDate": "2012-03-19T22:06:51.218Z",
    "LastInventoryDate": "2012-03-25T12:14:31.121Z",
    "NumberOfArchives": 0,
    "SizeInBytes": 0,
    "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault3",
    "VaultName": "examplevault3"
   } 
  ]
}

Contoh: Daftar Parsial Vault

Contoh berikut mengembalikan dua vault yang dimulai dari vault yang ditentukan oleh marker.

Contoh Permintaan

GET /-/vaults?limit=2&marker=arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1 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

Dua vault dikembalikan dalam daftar. Marker berisi ARN vault untuk melanjutkan pemberian nomor halaman dalam permintaan Cantumkan Vault lainnya.

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: 497	

{
  "Marker": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault3",
  "VaultList": [ 
   {
    "CreationDate": "2012-03-16T22:22:47.214Z",
    "LastInventoryDate": "2012-03-21T22:06:51.218Z",
    "NumberOfArchives": 2,
    "SizeInBytes": 12334,
    "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1",
    "VaultName": "examplevault1"
   }, 
   {
    "CreationDate": "2012-03-19T22:06:51.218Z",
    "LastInventoryDate": "2012-03-21T22:06:51.218Z",
    "NumberOfArchives": 0,
    "SizeInBytes": 0,
    "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault2",
    "VaultName": "examplevault2"
   }
  ]
}

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu Amazon khusus bahasa SDKs, lihat berikut ini: