錯誤回應

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

代碼	描述	HTTP 狀態碼	類型
AccessDeniedException	如果嘗試存取 AWS Identity and Access Management (IAM) 政策所不允許的資源，或者在請求 URI 中使用了錯誤的 AWS 帳戶 ID，則傳回。如需更多詳細資訊，請參閱 Amazon S3 Glacier 的 Identity and Access Management。	403 Forbidden	用戶端
BadRequest	如果請求無法處理，則傳回。	400 Bad Request	用戶端
ExpiredTokenException	如果請求中使用的安全權杖已過期，則傳回。	403 Forbidden	用戶端
InsufficientCapacityException	如果沒有足夠的能力處理急件請求，則傳回。此錯誤僅適用於急件擷取，而不適用於標準或大量擷取。	503 Service Unavailable	伺服器
InvalidParameterValueException	如果未正確指定請求的參數，則傳回。	400 Bad Request	用戶端
InvalidSignatureException	如果請求簽章無效，則傳回。	403 Forbidden	用戶端
LimitExceededException	如果請求導致超出以下其中一個限額：文件庫限制、標籤限制或佈建的容量限制，則傳回。	400 Bad Request	用戶端
MissingAuthenticationTokenException	如果沒有該請求的驗證資料，則傳回。	400 Bad Request	用戶端
MissingParameterValueException	如果請求中缺少必要的標題或參數，則傳回。	400 Bad Request	用戶端
PolicyEnforcedException	如果擷取作業超過目前資料政策的擷取速率限制，則傳回。如需有關資料擷取政策的詳細資訊，請參閱 S3 Glacier 資料擷取政策。	400 Bad Request	用戶端
ResourceNotFoundException	如果指定的資源不存在，例如文件庫、上傳 ID 或任務 ID，則傳回。	404 Not Found	用戶端
RequestTimeoutException	如果上傳封存並在接收上傳時 Amazon S3 Glacier (S3 Glacier) 逾時，則傳回。	408 Request Timeout	用戶端
SerializationException	如果請求內文無效，則傳回。如果包括 JSON 承載，請檢查格式完好。	400 Bad Request	用戶端
ServiceUnavailableException	如果服務無法完成請求，則傳回。	500 Internal Server Error	伺服器
ThrottlingException	如果您需要將請求速率降至 S3 Glacier，則傳回。	400 Bad Request	用戶端
UnrecognizedClientException	如果存取金鑰 ID 或安全權杖無效，則傳回。	400 Bad Request	用戶端

各種 S3 Glacier API 會傳回相同的例外狀況，但具有不同的例外狀況訊息，可協助您對遇到的特定錯誤進行故障診斷。

S3 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

S3 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。

類型：字串

在先前的回應中，請注意下列事項：

• 對於錯誤回應，S3 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

S3 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"
}