Halaman ini hanya untuk pelanggan lama layanan S3 Glacier menggunakan Vaults dan REST API asli dari tahun 2012.
Jika Anda mencari solusi penyimpanan arsip, kami sarankan untuk menggunakan kelas penyimpanan S3 Glacier di Amazon S3, Pengambilan Instan Gletser S3, Pengambilan Fleksibel Gletser S3, dan S3 Glacier Deep Archive. Untuk mempelajari lebih lanjut tentang opsi penyimpanan ini, lihat Kelas penyimpanan S3 Glacier dan Penyimpanan data jangka panjang menggunakan kelas
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Membuat Vault (PUT vault)
Deskripsi
Operasi ini membuat vault baru dengan nama tertentu. Nama brankas harus unik di dalam AWS Wilayah untuk sebuah 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
Sintaks
Untuk membuat vault, kirim permintaan HTTP PUT ke URI vault yang akan dibuat.
PUT /AccountId/vaults/VaultNameHTTP/1.1 Host: glacier.Region.amazonaws.com Date:DateAuthorization:SignatureValueContent-Length:Lengthx-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 S3 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 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
Sintaks
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 |
|---|---|
|
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/examplevaultBagian Terkait
Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu Amazon khusus bahasa SDKs, lihat berikut ini:
