Mencantumkan Kapasitas yang Disediakan (GET provisioned-capacity) - Amazon Glacier

Halaman ini hanya untuk pelanggan lama layanan Amazon Glacier menggunakan Vaults dan REST API asli dari 2012.

Jika Anda mencari solusi penyimpanan arsip, sebaiknya gunakan kelas penyimpanan Amazon Glacier di Amazon S3, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval, dan S3 Glacier Deep Archive. Untuk mempelajari lebih lanjut tentang opsi penyimpanan ini, lihat kelas penyimpanan Amazon Glacier.

Amazon Glacier (layanan berbasis brankas mandiri asli) tidak akan lagi menerima pelanggan baru mulai 15 Desember 2025, tanpa berdampak pada pelanggan yang sudah ada. Amazon Glacier adalah layanan mandiri dengan miliknya APIs sendiri yang menyimpan data di brankas dan berbeda dari Amazon S3 dan kelas penyimpanan Amazon S3 Glacier. Data Anda yang ada akan tetap aman dan dapat diakses di Amazon Glacier tanpa batas waktu. Tidak diperlukan migrasi. Untuk penyimpanan arsip jangka panjang berbiaya rendah, AWS rekomendasikan kelas penyimpanan Amazon S3 Glacier, yang memberikan pengalaman pelanggan yang unggul dengan APIs berbasis ember S3, ketersediaan penuh, biaya lebih rendah, Wilayah AWS dan integrasi layanan. AWS Jika Anda ingin meningkatkan kemampuan, pertimbangkan untuk bermigrasi ke kelas penyimpanan Amazon S3 Glacier dengan menggunakan Panduan Solusi AWS kami untuk mentransfer data dari kubah Amazon Glacier ke kelas penyimpanan Amazon S3 Glacier.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Mencantumkan Kapasitas yang Disediakan (GET provisioned-capacity)

Operasi ini mencantumkan unit kapasitas yang disediakan untuk Akun AWS yang ditentukan. Untuk informasi selengkapnya tentang kapasitas yang disediakan, lihat Opsi Pengambilan Arsip.

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. Anda dapat melihat fungsi ini di Contoh Respons.

Sintaks Permintaan

Untuk mencantumkan kapasitas pengambilan yang disediakan untuk akun, kirim permintaan HTTP GET ke URI kapasitas yang disediakan seperti yang ditunjukkan dalam contoh sintaks berikut.

GET /AccountId/provisioned-capacity HTTP/1.1 Host: glacier.Region.amazonaws.com Date: Date Authorization: SignatureValue x-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 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

Operasi ini tidak memiliki isi permintaan.

Respons

Jika operasi berhasil, layanan mengirimkan kembali respon 200 OK HTTP.

Sintaks Respons

HTTP/1.1 200 OK x-amzn-RequestId: x-amzn-RequestId Date: Date Content-Type: application/json Content-Length: Length { "ProvisionedCapacityList": { "CapacityId" : "string", "StartDate" : "string" "ExpirationDate" : "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.

CapacityId

ID yang mengidentifikasi unit kapasitas yang disediakan.

Tipe: String.

StartDate

Tanggal pembelian unit kapasitas yang disediakan, dalam Waktu Universal Terkoordinasi (UTC).

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

ExpirationDate

Tanggal berakhirnya unit kapasitas yang disediakan, dalam Waktu Universal Terkoordinasi (UTC).

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

Kesalahan

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

Contoh

Contoh berikut mencantumkan unit kapasitas yang disediakan untuk akun.

Contoh Permintaan

Dalam contoh ini, permintaan GET dikirim untuk mengambil daftar unit kapasitas yang disediakan untuk akun yang ditentukan.

GET /123456789012/priority-capacity 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

Jika permintaan berhasil, Amazon Glacier (Amazon Glacier) mengembalikan dengan daftar unit kapasitas HTTP 200 OK yang disediakan untuk akun seperti yang ditunjukkan pada contoh berikut.

Unit kapasitas yang disediakan terdaftar pertama adalah contoh unit dengan tanggal mulai 31 Januari 2017 dan tanggal kedaluwarsa 28 Februari 2017. Seperti yang dijelaskan sebelumnya, jika tanggal mulai adalah tanggal 31, tanggal kedaluwarsa adalah hari terakhir bulan berikutnya.

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: length { "ProvisionedCapacityList", { "CapacityId": "zSaq7NzHFQDANTfQkDen4V7z", "StartDate": "2017-01-31T14:26:33.031Z", "ExpirationDate": "2017-02-28T14:26:33.000Z", }, { "CapacityId": "yXaq7NzHFQNADTfQkDen4V7z", "StartDate": "2016-12-13T20:11:51.095Z"", "ExpirationDate": "2017-01-13T20:11:51.000Z" ", }, ... }