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 Cantumkan Vault berikutnya, Anda menetapkan parameter marker untuk nilai Amazon S3 Glacier (S3 Glacier) yang dikembalikan dalam respons atas permintaan Cantumkan Vault 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

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 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 dan pesan kesalahan Amazon S3 Glacier, 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"
   }
  ]
}

Bagian Terkait

• Membuat Vault (PUT vault)

• Menghapus Vault (DELETE vault)

• Memulai Tugas (POST jobs)

• Identity and Access Management untuk Amazon S3 Glacier

Lihat Juga

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu dari SDK Amazon spesifik bahasa, lihat berikut ini:

• AWS Command Line Interface