Membeli Kapasitas yang Disediakan (GET provisioned-capacity)

Operasi ini membeli unit kapasitas yang disediakan untuk Akun AWS.

Unit kapasitas yang disediakan berlangsung selama satu bulan mulai tanggal dan waktu pembelian, yang merupakan tanggal mulai. Unit ini berakhir pada tanggal kedaluwarsa, yang tepat satu bulan setelah tanggal mulai ke detik terdekat.

Jika tanggal mulai adalah tanggal 31, tanggal kedaluwarsa adalah hari terakhir bulan berikutnya. Misalnya, jika tanggal mulai adalah 31 Agustus, tanggal kedaluwarsa adalah 30 September. Jika tanggal mulai 31 Januari, tanggal kedaluwarsa adalah 28 Februari.

Kapasitas yang disediakan membantu memastikan kapasitas pengambilan Anda untuk pengambilan yang dipercepat tersedia saat Anda membutuhkannya. Setiap unit kapasitas memastikan setidaknya tiga pengambilan yang dipercepat dapat dilakukan setiap lima menit dan menyediakan throughput pengambilan hingga 150 MB/dtk. Untuk informasi selengkapnya tentang kapasitas yang disediakan, lihat Opsi Pengambilan Arsip.

catatan

Ada batas dua unit kapasitas yang disediakan per Akun AWS.

Permintaan

Untuk membeli unit kapasitas yang disediakan untuk Akun AWS, kirim permintaan POST HTTP ke URI kapasitas yang disediakan.

Sintaksis

POST /AccountId/provisioned-capacity 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

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

Jika permintaan operasi berhasil, layanan mengembalikan respons 201 Created HTTP.

Sintaksis

HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
x-amz-capacity-id: CapacityId

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
x-amz-capacity-id	ID yang mengidentifikasi unit kapasitas yang disediakan. Jenis: String

Isi Respons

Operasi ini tidak mengembalikan isi respons.

Kesalahan

Operasi ini mencakup satu atau beberapa kesalahan berikut, selain kemungkinan kesalahan umum untuk semua operasi Amazon S3 Glacier. Untuk informasi tentang kesalahan Amazon S3 Glacier dan daftar kode kesalahan, lihat Respons Kesalahan.

Kode	Deskripsi	Kode Status HTTP	Tipe
LimitExceededException	Dikembalikan jika permintaan yang diberikan akan melebihi batas akun unit kapasitas yang disediakan.	400 Bad Request	Klien

Contoh

Contoh berikut membeli unit kapasitas yang disediakan untuk akun.

Contoh Permintaan

Contoh berikut mengirimkan permintaan HTTP POST untuk membeli unit kapasitas yang disediakan.

POST /123456789012/provisioned-capacity HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
Content-Length: length
x-amz-glacier-version: 2012-06-01

Contoh Respons

Jika permintaan berhasil, Amazon S3 Glacier (S3 Glacier) mengembalikan respons HTTP 201 Created, seperti yang ditampilkan dalam contoh berikut.

HTTP/1.1 201 Created
x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
Date: Wed, 10 Feb 2017 12:02:00 GMT
x-amz-capacity-id: zSaq7NzHFQDANTfQkDen4V7z

Bagian Terkait

• Mencantumkan Kapasitas yang Disediakan (GET provisioned-capacity)