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.
Respons Kesalahan
Jika terjadi kesalahan, API mengembalikan salah satu pengecualian berikut:
Kode | Deskripsi | Kode Status HTTP | Tipe |
---|---|---|---|
AccessDeniedException |
Dikembalikan jika ada upaya untuk mengakses sumber daya yang tidak diizinkan oleh kebijakan AWS Identity and Access Management (IAM), atau Akun AWS ID yang salah digunakan dalam URI permintaan. Untuk informasi selengkapnya, lihat Identity and Access Management untuk Amazon S3 Glacier. | 403 Forbidden |
Klien |
BadRequest |
Dikembalikan jika permintaan tidak dapat diproses. | 400 Bad Request |
Klien |
ExpiredTokenException |
Dikembalikan jika token keamanan yang digunakan dalam permintaan telah berakhir. | 403 Forbidden |
Klien |
InsufficientCapacityException |
Dikembalikan jika kapasitas tidak memadai untuk memproses permintaan yang dipercepat. Kesalahan ini hanya berlaku untuk pengambilan yang dipercepat dan bukan untuk pengambilan standar atau massal. | 503 Service Unavailable |
Server |
InvalidParameterValueException |
Dikembalikan jika parameter permintaan salah ditentukan. | 400 Bad Request |
Klien |
InvalidSignatureException |
Dikembalikan jika tanda tangan permintaan tidak valid. | 403 Forbidden |
Klien |
LimitExceededException |
Dikembalikan jika hasil permintaan di salah satu batas berikut terlampaui, batas vault, batas tanda, atau batas kapasitas yang disediakan. | 400 Bad Request |
Klien |
MissingAuthenticationTokenException |
Dikembalikan jika tidak tidak ditemukan data autentikasi untuk permintaan. | 400 Bad Request |
Klien |
MissingParameterValueException |
Dikembalikan jika header atau parameter yang diperlukan hilang dari permintaan. | 400 Bad Request |
Klien |
PolicyEnforcedException |
Dikembalikan jika tugas pengambilan akan melebihi batas tingkat pengambilan kebijakan data saat ini. Untuk informasi selengkapnya tentang kebijakan pengambilan data, lihat Kebijakan Pengambilan Data Gletser S3. | 400 Bad Request |
Klien |
ResourceNotFoundException |
Dikembalikan jika sumber daya yang ditentukan seperti vault, ID unggahan, atau ID tugas tidak ada. | 404 Not Found |
Klien |
RequestTimeoutException |
Dikembalikan jika waktu unggah arsip dan Amazon S3 Glacier (S3 Glacier) berakhir saat menerima unggahan. | 408 Request Timeout |
Klien |
SerializationException |
Dikembalikan jika isi permintaan tidak valid. Jika termasuk muatan JSON, periksa bahwa muatan JSON tersebut memiliki bentuk yang baik. | 400 Bad Request |
Klien |
ServiceUnavailableException |
Dikembalikan jika layanan tidak dapat menyelesaikan permintaan. | 500 Internal Server Error |
Server |
ThrottlingException |
Dikembalikan jika Anda perlu mengurangi tingkat permintaan Anda untuk S3 Glacier. | 400 Bad Request |
Klien |
UnrecognizedClientException |
Dikembalikan jika Access Key ID atau token keamanan tidak valid. | 400 Bad Request |
Klien |
Berbagai S3 Glacier APIs mengembalikan pengecualian yang sama, tetapi dengan pesan pengecualian yang berbeda untuk membantu Anda memecahkan masalah kesalahan tertentu yang dihadapi.
S3 Glacier mengembalikan informasi kesalahan dalam isi respons. Contoh berikut menunjukkan beberapa respons kesalahan.
Contoh 1: Menjelaskan permintaan Tugas dengan ID tugas yang tidak ada
Misalkan Anda mengirim permintaan Mendeskripsikan Tugas (GET JobID) untuk tugas yang tidak ada. Artinya, Anda menentukan ID tugas yang tidak ada.
GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVEXAMPLEbadJobID HTTP/1.1 Host: glacier.us-west-2.amazonaws.com 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
Sebagai respons, S3 Glacier mengembalikan respons kesalahan berikut.
HTTP/1.1 404 Not Found x-amzn-RequestId: AAABaZ9N92Iiyv4N7sru3ABEpSQkuFtmH3NP6aAC51ixfjg Content-Type: application/json Content-Length: 185 Date: Wed, 10 Feb 2017 12:00:00 GMT { "code": "ResourceNotFoundException", "message": "The job ID was not found: HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVEXAMPLEbadJobID", "type": "Client" }
Dengan:
- Kode
-
Salah satu pengecualian umum.
Tipe: String
- Pesan
-
Deskripsi umum tentang kondisi kesalahan yang khusus untuk API yang mengembalikan kesalahan.
Tipe: String
- Jenis
-
Sumber kesalahan. Bidang dapat menjadi salah satu dari nilai berikut:
Client
,Server
, atauUnknown
.Tipe: String.
Perhatikan hal berikut dalam respons sebelumnya:
-
Untuk respons kesalahan, S3 Glacier mengembalikan nilai kode status
4xx
dan5xx
. Dalam contoh ini, kode status adalah404 Not Found
. -
Nilai header
Content-Type
application/json
menunjukkan JSON dalam isi -
JSON dalam isi menyediakan informasi kesalahan.
Dalam permintaan sebelumnya, bukan ID tugas yang buruk, misalkan Anda menentukan vault yang tidak ada. Respons mengembalikan pesan yang berbeda.
HTTP/1.1 404 Not Found x-amzn-RequestId: AAABBeC9Zw0rp_5D0L8VfB3FA_WlTupqTKAUehMcPhdgni0 Content-Type: application/json Content-Length: 154 Date: Wed, 10 Feb 2017 12:00:00 GMT { "code": "ResourceNotFoundException", "message": "Vault not found for ARN: arn:aws:glacier:us-west-2:012345678901:vaults/examplevault", "type": "Client" }
Contoh 2: Mencantumkan permintaan Tugas dengan nilai yang tidak valid untuk parameter permintaan
Dalam contoh ini Anda mengirim permintaan Mencantumkan Tugas (GET jobs) untuk mengambil tugas vault dengan statuscode
tertentu, dan Anda memberikan nilai statuscode
finished
yang salah, bukan nilai InProgress
,Succeeded
, atau Failed
yang dapat diterima.
GET /-/vaults/examplevault/jobs?statuscode=finished HTTP/1.1 Host: glacier.us-west-2.amazonaws.com 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
S3 Glacier mengembalikan InvalidParameterValueException
dengan pesan yang sesuai.
HTTP/1.1 400 Bad Request x-amzn-RequestId: AAABaZ9N92Iiyv4N7sru3ABEpSQkuFtmH3NP6aAC51ixfjg Content-Type: application/json Content-Length: 141 Date: Wed, 10 Feb 2017 12:00:00 GMT { "code": "InvalidParameterValueException", "message": "The job status code is not valid: finished", "type: "Client" }