Menjelaskan Vault (GET vault)

Deskripsi

Operasi ini mengembalikan informasi tentang vault, termasuk Amazon Resource Name (ARN) vault, tanggal vault dibuat, jumlah arsip yang terdapat di dalam vault, dan ukuran total semua arsip di vault. Jumlah arsip dan ukuran totalnya dimulai dari inventaris vault terakhir yang dihasilkan Amazon S3 Glacier (S3 Glacier) (lihat Bekerja dengan Vault di Amazon S3 Glacier). S3 Glacier menghasilkan inventaris vault kurang lebih setiap hari. Ini berarti jika Anda menambahkan atau menghapus arsip dari vault, lalu segera mengirim permintaan Jelaskan Vault, respons mungkin tidak mencerminkan perubahan.

Permintaan

Untuk mendapatkan informasi tentang vault, kirim permintaan GET ke URI dari sumber daya vault tertentu.

Sintaksis

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

Sintaksis

HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length

{
  "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 UTC saat vault dibuat.

Tipe: Representasi string dalam format tanggal ISO 8601, misalnya 2013-03-20T17:03:43.221Z.

LastInventoryDate

Tanggal UTC saat S3 Glacier menyelesaikan inventaris vault terakhir. 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.

NumberOfArchives

Jumlah arsip di vault sesuai inventaris vault terakhir. Bidang ini akan mengembalikan nol jika inventaris belum berjalan di vault, misalnya, jika Anda baru saja membuat vault.

Tipe: Angka

SizeInBytes

Ukuran total dalam byte dari arsip di vault termasuk setiap overhead per arsip, yang dimulai dari tanggal inventaris terakhir. Bidang ini akan mengembalikan null jika inventaris belum berjalan di vault, misalnya, jika Anda baru saja membuat vault.

Tipe: Angka

VaultArn

Amazon Resource Name (ARN) dari vault.

Tipe: String

VaultName

Nama vault yang ditentukan saat pembuatan. Nama vault juga disertakan dalam ARN vault tersebut.

Tipe: String

Kesalahan

Untuk informasi tentang pengecualian dan pesan kesalahan Amazon S3 Glacier, lihat Respons Kesalahan.

Contoh

Contoh Permintaan

Contoh berikut menunjukkan cara mendapatkan informasi tentang vault bernama examplevault.

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

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

{
  "CreationDate" : "2012-02-20T17:01:45.198Z",
  "LastInventoryDate" : "2012-03-20T17:03:43.221Z",
  "NumberOfArchives" : 192,
  "SizeInBytes" : 78088912,
  "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault",
  "VaultName" : "examplevault"
}

Bagian Terkait

• Membuat Vault (PUT vault)

• Mencantumkan Vault (GET vaults)

• 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