**此頁面僅適用於使用 Vaults 和 2012 年原始 REST API 的 Amazon Glacier 服務的現有客戶。**
如果您要尋找封存儲存解決方案，建議您在 Amazon Glacier Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive 中使用 Amazon Glacier 儲存類別。 Amazon S3 若要進一步了解這些儲存選項，請參閱 [Amazon Glacier 儲存類別](https://aws.amazon.com/s3/storage-classes/glacier/)。
Amazon Glacier （原始獨立保存庫型服務） 不再接受新客戶。Amazon Glacier 是一項獨立服務，具有自己的 APIs，可將資料存放在保存庫中，並與 Amazon S3 和 Amazon S3 Glacier 儲存類別不同。您現有的資料將在 Amazon Glacier 中無限期保持安全且可存取。不需要遷移。對於低成本、長期的封存儲存， AWS 建議使用 [Amazon S3 Glacier 儲存類別](https://aws.amazon.com/s3/storage-classes/glacier/)，透過 S3 儲存貯體型 APIs、完整 AWS 區域 可用性、降低成本 AWS 和服務整合，提供卓越的客戶體驗。如果您想要增強功能，請考慮使用我們的解決方案指南，將資料從 Amazon S3 Glacier 保存庫傳輸至 Amazon S3 Glacier 儲存類別，以遷移至 Amazon S3 Glacier 儲存類別。 [AWS Amazon Glacier Amazon S3 ](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/)
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 錯誤回應
如果發生錯誤，此 API 會傳回以下其中一個例外狀況：
| Code | Description | HTTP 狀態碼 | Type |
| --- | --- | --- | --- |
| AccessDeniedException | 如果嘗試存取 AWS Identity and Access Management (IAM) 政策不允許的資源，或在請求 URI 中使用不正確的 AWS 帳戶 ID，則傳回。如需詳細資訊，請參閱[Amazon Glacier 的 Identity and Access Management](security-iam.md)。 | 403 Forbidden | 用戶端 |
| BadRequest | 如果請求無法處理，則傳回。 | 400 Bad Request | 用戶端 |
| ExpiredTokenException | 如果請求中使用的安全權杖已過期，則傳回。 | 403 Forbidden | 用戶端 |
| InsufficientCapacityException | 如果沒有足夠的能力處理急件請求，則傳回。此錯誤僅適用於急件擷取，而不適用於標準或大量擷取。 | 503 Service Unavailable | Server |
| InvalidParameterValueException | 如果未正確指定請求的參數，則傳回。 | 400 Bad Request | 用戶端 |
| InvalidSignatureException | 如果請求簽章無效，則傳回。 | 403 Forbidden | 用戶端 |
| LimitExceededException | 如果請求導致超出以下其中一個限額：保存庫限制、標籤限制或佈建的容量限制，則傳回。 | 400 Bad Request | 用戶端 |
| MissingAuthenticationTokenException | 如果沒有該請求的驗證資料，則傳回。 | 400 Bad Request | 用戶端 |
| MissingParameterValueException | 如果請求中缺少必要的標題或參數，則傳回。 | 400 Bad Request | 用戶端 |
| PolicyEnforcedException | 如果擷取作業超過目前資料政策的擷取速率限制，則傳回。如需有關資料擷取政策的詳細資訊，請參閱 [Amazon Glacier 資料擷取政策](data-retrieval-policy.md)。 | 400 Bad Request | 用戶端 |
| ResourceNotFoundException | 如果指定的資源不存在，例如保存庫、上傳 ID 或工作 ID，則傳回。 | 404 Not Found | 用戶端 |
| RequestTimeoutException | 如果上傳封存，且 Amazon Glacier (Amazon Glacier) 在收到上傳時逾時，則傳回。 | 408 Request Timeout | 用戶端 |
| SerializationException | 如果請求內文無效，則傳回。如果包括 JSON 承載，請檢查格式完好。 | 400 Bad Request | 用戶端 |
| ServiceUnavailableException | 如果服務無法完成請求，則傳回。 | 500 Internal Server Error | Server |
| ThrottlingException | 如果您需要降低對 Amazon Glacier 的請求率，則傳回。 | 400 Bad Request | 用戶端 |
| UnrecognizedClientException | 如果存取金鑰 ID 或安全權杖無效，則傳回。 | 400 Bad Request | 用戶端 |
各種 Amazon Glacier APIs都會傳回相同的例外狀況，但會有不同的例外狀況訊息，協助您疑難排解遇到的特定錯誤。
Amazon Glacier 傳回回應內文中的錯誤資訊。以下範例顯示一些錯誤回應。
## 範例 1：描述不存在的任務 ID 的任務請求
假設您傳送不存在任務的 [描述任務 (GET JobID)](api-describe-job-get.md) 請求。也就是說，您指定了不存在的任務 ID。
```
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
```
為了回應，Amazon Glacier 會傳回下列錯誤回應。
```
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"
}
```
其中：
**Code**
其中一個一般例外狀況。
*類型：*字串
**Message**
特定於傳回錯誤的 API 的錯誤狀況的一般描述。
*類型：*字串
**類型**
錯誤來源。該欄位可以是以下其中一個值：`Client`、`Server` 或 `Unknown`。
*類型*：字串
在先前的回應中，請注意下列事項：
+ 對於錯誤回應，Amazon Glacier 會傳回 `4xx`和 的狀態碼值`5xx`。在此範例中，該狀態碼為 `404 Not Found`。
+ 此 `Content-Type` 標頭值 `application/json` 表示內文中的 JSON
+ 在內文的 JSON 提供錯誤資訊。
在之前的請求，假設您指定不存在的保存庫，而不是錯誤的工作 ID。該回應傳回不同的訊息。
```
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"
}
```
## 範例 2：列出請求參數具有無效值的任務請求
在這個範例中，您傳送 [列出工作 (GET 工作)](api-jobs-get.md) 請求以擷取具有特定 `statuscode` 的保存庫工作，而且您提供錯誤的 `statuscode` 值 `finished`，而不是可接受的值 `InProgress`、`Succeeded` 或 `Failed`。
```
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 會傳回`InvalidParameterValueException`具有適當訊息的 。
```
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"
}
```