

 **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](https://aws.amazon.com/s3/storage-classes/glacier/).

Amazon Glacier (layanan berbasis brankas mandiri asli) tidak lagi menerima pelanggan baru. 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](https://aws.amazon.com/s3/storage-classes/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](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/).

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

# Respons Kesalahan
<a name="api-error-responses"></a>

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 Glacier](security-iam.md). | 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 Amazon Glacier](data-retrieval-policy.md). | 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 mengunggah arsip dan Amazon Glacier (Amazon Glacier) habis waktu 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 ke Amazon Glacier. | 400 Bad Request | Klien | 
| UnrecognizedClientException | Dikembalikan jika Access Key ID atau token keamanan tidak valid. | 400 Bad Request | Klien | 

Berbagai Amazon APIs Glacier mengembalikan pengecualian yang sama, tetapi dengan pesan pengecualian yang berbeda untuk membantu Anda memecahkan masalah kesalahan tertentu yang dihadapi.

Amazon Glacier mengembalikan informasi kesalahan di badan respons. Contoh berikut menunjukkan beberapa respons kesalahan.

## Contoh 1: Menjelaskan permintaan Tugas dengan ID tugas yang tidak ada
<a name="bad-request-error-example1"></a>

Misalkan Anda mengirim permintaan [Mendeskripsikan Tugas (GET JobID)](api-describe-job-get.md) untuk tugas yang tidak ada. Artinya, Anda menentukan ID tugas yang tidak ada. 

```
1. GET /-/vaults/examplevault/jobs/HkF9p6o7yjhFx-K3CGl6fuSm6VzW9T7esGQfco8nUXVYwS0jlb5gq1JZ55yHgt5vP54ZShjoQzQVVEXAMPLEbadJobID HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. Date: 20170210T120000Z
4. x-amz-glacier-version: 2012-06-01
5. 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 tanggapan, Amazon 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"
  }
```

Di mana:

**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, Amazon Glacier mengembalikan nilai kode status dan. `4xx` `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
<a name="bad-request-error-example2"></a>

Dalam contoh ini Anda mengirim permintaan [Mencantumkan Tugas (GET jobs)](api-jobs-get.md) 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
```

Amazon Glacier mengembalikan pesan `InvalidParameterValueException` 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"
}
```