Membuat Vault (PUT vault)

Deskripsi

Operasi ini membuat vault baru dengan nama tertentu.  Nama vault harus unik dalam Wilayah AWS untuk Akun AWS. Anda dapat membuat hingga 1.000 vault per akun. Untuk informasi tentang membuat lebih banyak vault, buka Halaman detail produk Amazon S3 Glacier.

Anda harus menggunakan pedoman berikut ketika memberi nama vault.

• Panjang karakter nama dapat antara 1 dan 255.

• Karakter yang diperbolehkan adalah a–z, A–Z, 0–9, '_' (garis bawah), '-' (tanda hubung), dan '.' (titik).

Operasi ini bersifat idempoten, Anda dapat mengirim permintaan yang sama beberapa kali dan permintaan ini tidak memiliki efek lebih lanjut setelah Amazon S3 Glacier (S3 Glacier) membuat vault yang ditentukan untuk pertama kalinya.

Permintaan

Sintaksis

Untuk membuat vault, kirim permintaan HTTP PUT ke URI vault yang akan dibuat.

PUT /AccountId/vaults/VaultName HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
Content-Length: Length
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 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

Isi permintaan untuk operasi ini harus kosong (0 byte).

Respons

Sintaksis

HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Location: Location

Header Respons

Respons yang sukses termasuk header respon berikut, selain header respons yang umum untuk semua operasi. Untuk informasi selengkapnya tentang header respons umum, lihat Header Respons Umum.

Nama	Deskripsi
Location	Jalur URI relatif dari vault yang dibuat. Tipe: String

Isi Respons

Operasi ini tidak mengembalikan isi respons.

Kesalahan

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

Contoh

Contoh Permintaan

Contoh berikut mengirimkan permintaan HTTP PUT untuk membuat vault bernama examplevault.

PUT /-/vaults/examplevault HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
x-amz-glacier-version: 2012-06-01
Content-Length: 0
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

S3 Glacier membuat vault dan mengembalikan jalur URI relatif vault di header Location. ID akun selalu ditampilkan di header Location terlepas dari apakah ID akun atau tanda hubung ('-') ditentukan dalam permintaan.

HTTP/1.1 201 Created
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT
Location: /111122223333/vaults/examplevault

Bagian Terkait

• Mencantumkan Vault (GET vaults)

• Menghapus Vault (DELETE vault)

• 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