錯誤回應 - Amazon Glacier
範例 1：描述不存在的任務 ID 的任務請求範例 2：列出請求參數具有無效值的任務請求

此頁面僅適用於使用 Vaults 和 2012 年原始 REST API 的 Amazon Glacier 服務的現有客戶。

如果您要尋找封存儲存解決方案，建議您在 Amazon Glacier Instant Retrieval、S3 Glacier Flexible Retrieval 和 S3 Glacier Deep Archive 中使用 Amazon Glacier 儲存類別。 Amazon S3 若要進一步了解這些儲存選項，請參閱 Amazon Glacier 儲存類別。

自 2025 年 12 月 15 日起，Amazon Glacier （原始獨立保存庫型服務） 將不再接受新客戶，不會影響現有客戶。Amazon Glacier 是一項獨立服務，具有自己的 APIs，可將資料存放在保存庫中，並與 Amazon S3 和 Amazon S3 Glacier 儲存類別不同。您現有的資料將在 Amazon Glacier 中無限期保持安全且可存取。不需要遷移。對於低成本、長期的封存儲存， AWS 建議採用 Amazon S3 Glacier 儲存類別，透過 S3 儲存貯體型 APIs、完整 AWS 區域 可用性、降低成本 AWS 和服務整合，提供卓越的客戶體驗。如果您想要增強功能，請考慮使用我們的解決方案指南，將資料從 Amazon S3 Glacier 保存庫傳輸至 Amazon S3 Glacier 儲存類別，以遷移至 Amazon S3 Glacier 儲存類別。 AWS Amazon Glacier Amazon S3

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

錯誤回應

如果發生錯誤，此 API 會傳回以下其中一個例外狀況：

代碼 說明 HTTP 狀態碼 類型
AccessDeniedException 如果嘗試存取 AWS Identity and Access Management (IAM) 政策不允許的資源，或在請求 URI 中使用不正確的 AWS 帳戶 ID，則傳回。如需詳細資訊，請參閱Amazon Glacier 的 Identity and Access Management。 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 資料擷取政策。 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) 請求。也就是說，您指定了不存在的任務 ID。

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

為了回應，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 工作) 請求以擷取具有特定 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"
}