**이 페이지는 볼트와 2012년부터 원래 REST API를 사용하는 Amazon Glacier 서비스의 기존 고객만 사용할 수 있습니다.**
아카이브 스토리지 솔루션을 찾고 있다면 Amazon S3의 Amazon Glacier 스토리지 클래스, S3 Glacier Instant Retrieval, S3 Glacier Flexible Retrieval 및 S3 Glacier Deep Archive를 사용하는 것이 좋습니다. 이러한 스토리지 옵션에 대한 자세한 내용은 [Amazon Glacier 스토리지 클래스](https://aws.amazon.com/s3/storage-classes/glacier/)를 참조하세요.
Amazon Glacier(기존 독립 실행형 볼트 기반 서비스)는 더 이상 신규 고객을 받지 않습니다. Amazon Glacier는 데이터를 볼트에 저장하고 Amazon S3 및 Amazon S3 Glacier 스토리지 클래스와 구별되는 자체 API를 갖춘 독립 실행형 서비스입니다. 기존 데이터는 Amazon Glacier에서 무기한으로 안전하게 보관되며 액세스 가능합니다. 마이그레이션은 필요하지 않습니다. 저비용 장기 아카이브 스토리지의 경우는 [S3 버킷 기반 API, 전체 가용성, 저렴한 비용 및 서비스 통합을 통해 우수한 고객 경험을 제공하는 Amazon S3 Glacier 스토리지 클래스](https://aws.amazon.com/s3/storage-classes/glacier/)를 AWS 권장합니다. S3 APIs AWS 리전 AWS 향상된 기능을 원하는 경우 [Amazon Glacier 볼트에서 Amazon S3 Glacier 스토리지 클래스로 데이터를 전송하기 위한AWS 솔루션 지침](https://aws.amazon.com/solutions/guidance/data-transfer-from-amazon-s3-glacier-vaults-to-amazon-s3/)을 사용하여 Amazon S3 Glacier 스토리지 클래스로 마이그레이션하는 것이 좋습니다.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 오류 응답
오류가 발생할 경우 API는 다음 예외 중 한 가지를 반환합니다.
| 코드 | 설명 | HTTP 상태 코드 | Type |
| --- | --- | --- | --- |
| AccessDeniedException | AWS Identity and Access Management (IAM) 정책에서 허용하지 않는 리소스에 액세스하려는 시도가 있거나 요청 URI에 잘못된 AWS 계정 ID가 사용된 경우 반환됩니다. 자세한 내용은 [Amazon Glacier의 ID 및 액세스 관리(IAM)](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 API가 동일한 예외를 반환하지만 예외 메시지가 다르기 때문에 특정 오류 문제를 해결하는 데 효과적입니다.
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"
}
```
위치:
**코드**
일반 예외 중 하나입니다.
*유형*: 문자열
**메시지**
오류를 반환하는 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 jobs)](api-jobs-get.md) 요청을 전송하여 특정 `statuscode`가 있는 볼트 작업을 가져오려고 합니다. 이때 올바른 값인 `InProgress`, `Succeeded` 또는 `Failed` 대신 잘못된 `statuscode` 값인 `finished`를 입력합니다.
```
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"
}
```