Respons Kesalahan - Amazon S3 Glacier
Contoh 1: Menjelaskan permintaan Tugas dengan ID tugas yang tidak adaContoh 2: Mencantumkan permintaan Tugas dengan nilai yang tidak valid untuk parameter permintaan

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 penyimpanan S3 Glacier di Panduan Pengguna Amazon S3. Kelas penyimpanan ini menggunakan Amazon S3 API, tersedia di semua wilayah, dan dapat dikelola dalam konsol Amazon S3. Mereka menawarkan fitur seperti Analisis Biaya Penyimpanan, Lensa Penyimpanan, fitur enkripsi opsional canggih, dan banyak lagi.

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, atau Unknown.

Tipe: String.

Perhatikan hal berikut dalam respons sebelumnya:

  • Untuk respons kesalahan, S3 Glacier mengembalikan nilai kode status 4xx dan 5xx. Dalam contoh ini, kode status adalah 404 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"
}