**이 페이지는 볼트와 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 스토리지 클래스로 마이그레이션하는 것이 좋습니다.

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 데이터 가져오기 작업
<a name="data-retrieval-policy-operations"></a>

다음은 Amazon Glacier에서 사용할 수 있는 데이터 가져오기 관련 작업입니다.

**Topics**
+ [데이터 가져오기 정책 가져오기(GET policy)](api-GetDataRetrievalPolicy.md)
+ [프로비저닝된 용량 나열(GET provisioned-capacity)](api-ListProvisionedCapacity.md)
+ [프로비저닝된 용량 구매(POST provisioned-capacity)](api-PurchaseProvisionedCapacity.md)
+ [데이터 가져오기 정책 설정(PUT policy)](api-SetDataRetrievalPolicy.md)

# 데이터 가져오기 정책 가져오기(GET policy)
<a name="api-GetDataRetrievalPolicy"></a>

## 설명
<a name="api-GetDataRetrievalPolicy-description"></a>

이 작업은 `GET` 요청 시 지정한 AWS 계정 및 AWS 리전의 현재 데이터 검색 정책을 반환합니다. 데이터 가져오기 정책에 대한 자세한 내용은 [Amazon Glacier 데이터 검색 정책](data-retrieval-policy.md) 섹션을 참조하세요.

## 요청
<a name="api-GetDataRetrievalPolicy-requests"></a>

현재 데이터 가져오기 정책을 반환하려면 다음 구문 예제와 같이 HTTP `GET` 요청을 데이터 가져오기 정책 URI로 전송합니다.

### 구문
<a name="api-GetDataRetrievalPolicy-requests-syntax"></a>

```
1. GET /AccountId/policies/data-retrieval HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
```

 

**참고**  
`AccountId` 값은 AWS 계정 ID입니다. 이 값은 요청 서명에 사용된 자격 증명과 연결된 AWS 계정 ID와 일치해야 합니다. AWS 계정 ID 또는 선택적으로 하나의 '`-`'(하이픈)을 지정할 수 있습니다. 이 경우에 Amazon Glacier는 요청 서명에 사용된 자격 증명과 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 지정하는 경우 ID에 하이픈('-')을 포함하지 않습니다.

### 요청 파라미터
<a name="api-GetDataRetrievalPolicy-requests-parameters"></a>

이 작업은 요청 파라미터를 사용하지 않습니다.

### 요청 헤더
<a name="api-GetDataRetrievalPolicy-requests-headers"></a>

이 작업은 모든 작업에 일반적인 요청 헤더만 사용합니다. 일반적인 요청 헤더에 대한 내용은 [공통 요청 헤더](api-common-request-headers.md) 섹션을 참조하세요.

### 요청 본문
<a name="api-GetDataRetrievalPolicy-requests-elements"></a>

이 작업에는 요청 본문이 없습니다.

## 응답
<a name="api-GetDataRetrievalPolicy-responses"></a>

### 구문
<a name="api-GetDataRetrievalPolicy-responses-syntax"></a>

```
HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: length
{
  "Policy":
    {
      "Rules":[
         {
            "BytesPerHour": Number,
            "Strategy": String	 
         }
       ]
    }
}
```

### 응답 헤더
<a name="api-GetDataRetrievalPolicy-responses-headers"></a>

이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 [공통 응답 헤더](api-common-response-headers.md) 섹션을 참조하세요.

### 응답 본문
<a name="api-GetDataRetrievalPolicy-responses-elements"></a>

JSON 응답 본문에는 다음과 같은 JSON 필드가 포함됩니다.

 

**BytesPerHour**  
한 시간이 가져올 수 있는 최대 바이트 수입니다.  
이 필드는 **Strategy** 필드 값이 `BytesPerHour`인 경우에 한해 나타납니다.  
*형식*: 숫자

**규칙**  
정책 규칙입니다. 이 규칙이 목록 형식이기는 하지만 현재는 Strategy 필드와 옵션으로 BytesPerHour 필드로 구성된 규칙 하나만 있습니다.  
*유형*: 배열

**Strategy**  
데이터 가져오기 정책의 유형입니다.  
*유형*: 문자열  
유효한 값: `BytesPerHour`\$1`FreeTier`\$1`None`. `BytesPerHour`은 콘솔에서 **최대 가져오기 속도**를 선택하는 것과 동일합니다. `FreeTier`는 콘솔에서 **프리 티어만**을 선택하는 것과 동일합니다. `None`은 콘솔에서 **가져오기 정책 없음**을 선택하는 것과 동일합니다. 콘솔에서 데이터 가져오기 정책을 선택하는 것에 대한 자세한 내용은 [Amazon Glacier 데이터 검색 정책](data-retrieval-policy.md) 섹션을 참조하세요.

### 오류
<a name="api-GetDataRetrievalPolicy-responses-errors"></a>

Amazon Glacier 예외 및 오류 메시지에 대한 자세한 내용은 [오류 응답](api-error-responses.md) 섹션을 참조하세요.

## 예시
<a name="api-GetDataRetrievalPolicy-examples"></a>

다음은 데이터 가져오기 정책을 가져오는 방법을 설명한 예제입니다.

### 요청 예시
<a name="api-GetDataRetrievalPolicy-example-request"></a>

이 예제에서는 `GET` 요청이 정책의 위치 URI로 전송됩니다.

```
1. GET /-/policies/data-retrieval HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-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
```

### 응답의 예
<a name="api-GetDataRetrievalPolicy-example-response"></a>

응답이 성공적으로 반환되면 데이터 가져오기 정책이 응답 본문에 JSON 형식으로 표시됩니다.

```
 1. HTTP/1.1 200 OK
 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
 3. Date: Wed, 10 Feb 2017 12:00:00 GMT
 4. Content-Type: application/json
 5. Content-Length: 85
 6.  
 7. {
 8.   "Policy":
 9.     {
10.       "Rules":[
11.          {
12.            "BytesPerHour":10737418240,
13.            "Strategy":"BytesPerHour"
14.           }
15.        ]
16.     }
17. }
```

## 관련 섹션
<a name="related-sections-GetDataRetrievalPolicy"></a>

 
+ [데이터 가져오기 정책 설정(PUT policy)](api-SetDataRetrievalPolicy.md)

 
+ [작업 시작(POST jobs)](api-initiate-job-post.md)

# 프로비저닝된 용량 나열(GET provisioned-capacity)
<a name="api-ListProvisionedCapacity"></a>

이 작업은 지정된 AWS 계정를 위해 프로비저닝된 용량 단위를 나열합니다. 프로비저닝된 용량에 대한 자세한 내용은 [아카이브 검색 옵션](downloading-an-archive-two-steps.md#api-downloading-an-archive-two-steps-retrieval-options) 섹션을 참조하세요.

프로비저닝된 용량 단위는 구매한 날짜 및 시간, 즉 시작 날짜로부터 1개월 지속됩니다. 단위는 시작 날짜로부터 정확하게 1개월(초 단위) 후인 만료 날짜에 만료됩니다.

시작 날짜가 31일인 경우에는 만료 날짜는 다음 달 말일이 됩니다. 예를 들어 시작 날짜가 8월 31일이라면 만료 날짜는 9월 30일입니다. 시작 날짜가 1월 31일이라면 만료 날짜는 2월 28일입니다. [응답의 예](#api-ListProvisionedCapacity-example1-response)에서 이러한 기능을 볼 수 있습니다.

## Request Syntax
<a name="api-ListProvisionedCapacity-RequestSyntax"></a>

계정에 프로비저닝된 가져오기 용량을 나열하려면 다음 구문 예제와 같이 HTTP GET 요청을 프로비저닝된 용량 URI에게 전송합니다.

```
1. GET /AccountId/provisioned-capacity HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. x-amz-glacier-version: 2012-06-01
```

 

**참고**  
`AccountId` 값은 AWS 계정 ID입니다. 이 값은 요청에 서명하는 데 사용되는 자격 증명과 연결된 AWS 계정 ID와 일치해야 합니다. AWS 계정 ID를 지정하거나 선택적으로 단일 '`-`'(하이픈)를 지정할 수 있습니다.이 경우 Amazon Glacier는 요청에 서명하는 데 사용되는 자격 증명과 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 지정하는 경우 ID에 하이픈('-')을 포함하지 않습니다.

## 요청 파라미터
<a name="api-ListProvisionedCapacity-RequestParameters"></a>

이 작업은 요청 파라미터를 사용하지 않습니다.

## 요청 헤더
<a name="api-ListProvisionedCapacity-requests-headers"></a>

이 작업은 모든 작업에 일반적인 요청 헤더만 사용합니다. 일반적인 요청 헤더에 대한 내용은 [공통 요청 헤더](api-common-request-headers.md) 섹션을 참조하세요.

## 요청 본문
<a name="api-ListProvisionedCapacity-requests-elements"></a>

이 작업에는 요청 본문이 없습니다.

## 응답
<a name="api-ListProvisionedCapacity-responses"></a>

작업이 성공하면 서비스가 HTTP `200 OK` 응답을 다시 전송합니다.

### Response Syntax
<a name="api-ListProvisionedCapacity-ResponseSyntax"></a>

```
HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length
{
   "ProvisionedCapacityList": 
      {
         "CapacityId" : "string",
         "StartDate" : "string"
         "ExpirationDate" : "string"
      }
}
```

### 응답 헤더
<a name="api-ListProvisionedCapacity-headers"></a>

이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 [공통 응답 헤더](api-common-response-headers.md) 섹션을 참조하세요.

### 응답 본문
<a name="api-ListProvisionedCapacity-body"></a>

JSON 응답 본문에는 다음과 같은 JSON 필드가 포함됩니다.

**CapacityId**  <a name="Glacier-ListProvisionedCapacity-response"></a>
프로비저닝된 용량 단위를 식별하는 ID입니다.  
 *유형*: 문자열.

**StartDate**  
프로비저닝된 용량 단위를 구매한 날짜(UTC)입니다.  
*유형*: 문자열. ISO 8601 날짜 형식의 문자열 표현입니다. 예: `2013-03-20T17:03:43.221Z`

**ExpirationDate**  
프로비저닝된 용량 단위가 만료되는 날짜(UTC)입니다.  
*유형*: 문자열. ISO 8601 날짜 형식의 문자열 표현입니다. 예: `2013-03-20T17:03:43.221Z`

### 오류
<a name="api-ListProvisionedCapacity-errors"></a>

Amazon Glacier 예외 및 오류 메시지에 대한 자세한 내용은 [오류 응답](api-error-responses.md) 섹션을 참조하세요.

## 예제
<a name="api-ListProvisionedCapacity-examples"></a>

다음은 계정에 프로비저닝된 용량 단위를 나열하는 예제입니다.

### 요청 예시
<a name="api-ListProvisionedCapacity-example1-request"></a>

이 예에서는 GET 요청을 전송하여 지정된 계정에 프로비저닝된 용량 단위 목록을 가져옵니다.

```
1. GET /123456789012/priority-capacity HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-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
```

### 응답의 예
<a name="api-ListProvisionedCapacity-example1-response"></a>

요청이 성공하면 Amazon Glacier(Amazon Glacier)가 다음 예제와 같이 계정에 프로비저닝된 용량 단위 목록과 함께 `HTTP 200 OK`를 반환합니다.

 처음에 나열된 프로비저닝된 용량 단위는 시작 날짜가 2017년 1월 31일이고 만료 날짜가 2017년 2월 28일인 단위의 예입니다. 앞서 설명한 대로, 시작 날짜가 31일인 경우에는 만료 날짜는 다음 달 말일이 됩니다.

```
 1. HTTP/1.1 200 OK
 2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
 3. Date: Wed, 10 Feb 2017 12:02:00 GMT
 4. Content-Type: application/json
 5. Content-Length: length
 6. 
 7. {
 8.    "ProvisionedCapacityList",
 9.       {
10.          "CapacityId": "zSaq7NzHFQDANTfQkDen4V7z",
11.          "StartDate": "2017-01-31T14:26:33.031Z",
12.          "ExpirationDate": "2017-02-28T14:26:33.000Z",
13.       },
14.       {
15.          "CapacityId": "yXaq7NzHFQNADTfQkDen4V7z",
16.          "StartDate": "2016-12-13T20:11:51.095Z"",
17.          "ExpirationDate": "2017-01-13T20:11:51.000Z" ",
18.       },
19.       ...
20. }
```

## 관련 섹션
<a name="api-ListProvisionedCapacity-related-sections"></a>

 
+ [프로비저닝된 용량 구매(POST provisioned-capacity)](api-PurchaseProvisionedCapacity.md)

# 프로비저닝된 용량 구매(POST provisioned-capacity)
<a name="api-PurchaseProvisionedCapacity"></a>

이 작업에서는 AWS 계정에 프로비저닝된 용량 단위를 구매합니다.

프로비저닝된 용량 단위는 구매한 날짜 및 시간, 즉 시작 날짜로부터 1개월 지속됩니다. 단위는 시작 날짜로부터 정확하게 1개월(초 단위) 후인 만료 날짜에 만료됩니다.

시작 날짜가 31일인 경우에는 만료 날짜는 다음 달 말일이 됩니다. 예를 들어 시작 날짜가 8월 31일이라면 만료 날짜는 9월 30일입니다. 시작 날짜가 1월 31일이라면 만료 날짜는 2월 28일입니다.

프로비저닝된 용량을 통해 필요할 때 신속 검색에 대한 검색 용량이 보장됩니다. 각 용량 단위로 5분마다 신속 검색 3회를 수행할 수 있고, 최대 150MB/s의 검색 처리량이 제공됩니다. 프로비저닝된 용량에 대한 자세한 내용은 [아카이브 검색 옵션](downloading-an-archive-two-steps.md#api-downloading-an-archive-two-steps-retrieval-options) 섹션을 참조하세요.

**참고**  
프로비저닝된 용량 단위는 1개당 2개로 제한됩니다 AWS 계정.

## Requests
<a name="api-PurchaseProvisionedCapacity-requests"></a>

에 대해 프로비저닝된 용량 단위를 구매하려면 프로비저닝된 용량 URI로 HTTP `POST` 요청을 AWS 계정 전송합니다.

### 구문
<a name="api-PurchaseProvisionedCapacity-requests-syntax"></a>

```
1. POST /AccountId/provisioned-capacity HTTP/1.1
2. Host: glacier.Region.amazonaws.com
3. Date: Date
4. Authorization: SignatureValue
5. Content-Length: Length
6. x-amz-glacier-version: 2012-06-01
```

 

**참고**  
`AccountId` 값은 AWS 계정 ID입니다. 이 값은 요청에 서명하는 데 사용되는 자격 증명과 연결된 AWS 계정 ID와 일치해야 합니다. AWS 계정 ID를 지정하거나 선택적으로 단일 '`-`'(하이픈)를 지정할 수 있습니다.이 경우 Amazon Glacier는 요청에 서명하는 데 사용되는 자격 증명과 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 지정하는 경우 ID에 하이픈('-')을 포함하지 않습니다.

### 요청 파라미터
<a name="api-PurchaseProvisionedCapacity-requestParameters"></a>

#### 요청 헤더
<a name="api-PurchaseProvisionedCapacity-requests-headers"></a>

이 작업은 모든 작업에 일반적인 요청 헤더만 사용합니다. 일반적인 요청 헤더에 대한 내용은 [공통 요청 헤더](api-common-request-headers.md) 섹션을 참조하세요.

#### 요청 본문
<a name="api-PurchaseProvisionedCapacity-requests-elements"></a>

이 작업에는 요청 본문이 없습니다.

## 응답
<a name="api-PurchaseProvisionedCapacity-responses"></a>

작업 요청이 성공하면 서비스가 HTTP `201 Created` 응답을 반환합니다.

### 구문
<a name="api-PurchaseProvisionedCapacity-response-syntax"></a>

```
HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
x-amz-capacity-id: CapacityId
```

### 응답 헤더
<a name="api-PurchaseProvisionedCapacity-responses-headers"></a>

성공적인 응답에는 모든 작업에 일반적인 응답 헤더 외에 다음 응답 헤더가 포함됩니다. 일반적인 응답 헤더에 대한 자세한 내용은 [공통 응답 헤더](api-common-response-headers.md) 섹션을 참조하세요.


|  이름  |  설명 | 
| --- | --- | 
|  `x-amz-capacity-id`   |  프로비저닝된 용량 단위를 식별하는 ID입니다. 유형: 문자열  | 

### 응답 본문
<a name="api-PurchaseProvisionedCapacity-responses-elements"></a>

이 작업은 응답 본문을 반환하지 않습니다.

### 오류
<a name="api-PurchaseProvisionedCapacity-responses-errors"></a>

이 작업에는 모든 Amazon Glacier 작업에 일반적으로 발생할 수 있는 오류 외에 다음 오류도 포함됩니다. Amazon Glacier의 오류에 대한 자세한 내용과 오류 코드 목록은 [오류 응답](api-error-responses.md) 섹션을 참조하세요.


| 코드 | 설명 | HTTP 상태 코드 | Type | 
| --- | --- | --- | --- | 
| LimitExceededException | 임의의 요청이 프로비저닝된 용량 단위의 계정 제한을 초과한 경우에 반환됩니다. | 400 Bad Request | 클라이언트 | 

## 예제
<a name="api-PurchaseProvisionedCapacity-examples"></a>

다음은 계정에 프로비저닝된 용량 단위를 구매하는 예제입니다.

### 요청 예시
<a name="api-PurchaseProvisionedCapacity-example-request"></a>

아래 예제에서는 HTTP POST 요청을 전송하여 프로비저닝된 용량 단위를 구매합니다.

```
1. POST /123456789012/provisioned-capacity HTTP/1.1
2. Host: glacier.us-west-2.amazonaws.com
3. x-amz-Date: 20170210T120000Z
4. Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
5. Content-Length: length
6. x-amz-glacier-version: 2012-06-01
```

### 응답의 예
<a name="api-PurchaseProvisionedCapacity-example-response"></a>

요청이 성공하면 Amazon Glacier(Amazon Glacier)가 다음 예시와 같이 `HTTP 201 Created` 응답을 반환합니다.

```
1. HTTP/1.1 201 Created
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
4. x-amz-capacity-id: zSaq7NzHFQDANTfQkDen4V7z
```

## 관련 섹션
<a name="api-PurchaseProvisionedCapacity-related-sections"></a>

 
+ [프로비저닝된 용량 나열(GET provisioned-capacity)](api-ListProvisionedCapacity.md)

# 데이터 가져오기 정책 설정(PUT policy)
<a name="api-SetDataRetrievalPolicy"></a>

## 설명
<a name="api-SetDataRetrievalPolicy-description"></a>

이번 작업에서는 `PUT` 요청 시 지정한 AWS 리전의 데이터 검색 정책을 설정한 후 규정합니다. 정책은 AWS 계정의 AWS 리전당 하나씩 설정할 수 있습니다. `PUT` 요청이 성공하면 몇 분 이내에 정책이 규정됩니다.

 하지만 정책이 규정되기 전에는 정책 설정 작업이 진행 중인 가져오기 작업에 적용되지 않습니다. 데이터 가져오기 정책에 대한 자세한 내용은 [Amazon Glacier 데이터 검색 정책](data-retrieval-policy.md) 섹션을 참조하세요.

## 요청
<a name="api-SetDataRetrievalPolicy-requests"></a>

### 구문
<a name="api-SetDataRetrievalPolicy-requests-syntax"></a>

데이터 가져오기 정책을 설정하려면 다음 구문 예제와 같이 HTTP PUT 요청을 데이터 가져오기 정책 URI로 전송합니다.

```
 1. PUT /AccountId/policies/data-retrieval HTTP/1.1
 2. Host: glacier.Region.amazonaws.com
 3. Date: Date
 4. Authorization: SignatureValue
 5. Content-Length: Length
 6. x-amz-glacier-version: 2012-06-01
 7. 			
 8. {
 9.   "Policy":
10.     {
11.       "Rules":[
12.          {
13.              "Strategy": String,
14.              "BytesPerHour": Number          
15.          }
16.        ]
17.     }
18. }
```

 

**참고**  
`AccountId` 값은 AWS 계정 ID입니다. 이 값은 요청 서명에 사용된 자격 증명과 연결된 AWS 계정 ID와 일치해야 합니다. AWS 계정 ID 또는 선택적으로 하나의 '`-`'(하이픈)을 지정할 수 있습니다. 이 경우에 Amazon Glacier는 요청 서명에 사용된 자격 증명과 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 지정하는 경우 ID에 하이픈('-')을 포함하지 않습니다.

### 요청 파라미터
<a name="api-SetDataRetrievalPolicy-requests-parameters"></a>

이 작업은 요청 파라미터를 사용하지 않습니다.

### 요청 헤더
<a name="api-SetDataRetrievalPolicy-requests-headers"></a>

이 작업은 모든 작업에 일반적인 요청 헤더만 사용합니다. 일반적인 요청 헤더에 대한 내용은 [공통 요청 헤더](api-common-request-headers.md) 섹션을 참조하세요.

### 요청 본문
<a name="api-SetDataRetrievalPolicy-requests-elements"></a>

요청 본문의 JSON에 포함되는 필드는 다음과 같습니다.

 

**BytesPerHour**  
한 시간이 가져올 수 있는 최대 바이트 수입니다.  
이 필드는 Strategy 필드 값이 `BytesPerHour`인 경우에만 필요합니다. Strategy 필드가 `BytesPerHour`로 설정되어 있지 않은 상태에서 이 필드를 설정하면 PUT 작업이 거부됩니다.  
*유형*: 숫자  
*필수 항목 여부*: Strategy 필드가 `BytesPerHour`로 설정되어 있는 경우 예이고, 그렇지 않으면 아니요입니다.  
*유효한 값*: 최소 정수 값 1. 최대 정수 값 2^63 - 1 포함

**Rules**  
정책 규칙입니다. 이 규칙이 목록 유형이지만 현재는 Strategy 필드와 BytesPerHour 필드(옵션)로 구성된 규칙 하나만 있어야 합니다.  
*유형*: 배열  
*필수 항목 여부*: 예

**Strategy**  
설정할 데이터 가져오기 정책의 유형입니다.  
*유형*: 문자열  
*필수 항목 여부*: 예  
유효한 값: `BytesPerHour`\$1`FreeTier`\$1`None`. `BytesPerHour`는 콘솔에서 **최대 가져오기 속도**를 선택하는 것과 동일합니다. `FreeTier`는 콘솔에서 **프리 티어만**을 선택하는 것과 동일합니다. `None`은 콘솔에서 **가져오기 정책 없음**을 선택하는 것과 동일합니다. 콘솔에서 데이터 가져오기 정책을 선택하는 것에 대한 자세한 내용은 [Amazon Glacier 데이터 검색 정책](data-retrieval-policy.md) 섹션을 참조하세요.

## 응답
<a name="api-SetDataRetrievalPolicy-responses"></a>

### 구문
<a name="api-SetDataRetrievalPolicyresponse-syntax"></a>

```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```

### 응답 헤더
<a name="api-SetDataRetrievalPolicy-responses-headers"></a>

이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 [공통 응답 헤더](api-common-response-headers.md) 섹션을 참조하세요.

### 응답 본문
<a name="api-SetDataRetrievalPolicy-responses-elements"></a>

이 작업은 응답 본문을 반환하지 않습니다.

### 오류
<a name="api-SetDataRetrievalPolicy-responses-errors"></a>

Amazon Glacier 예외 및 오류 메시지에 대한 자세한 내용은 [오류 응답](api-error-responses.md) 섹션을 참조하세요.

## 예시
<a name="api-SetDataRetrievalPolicy-examples"></a>

### 요청 예시
<a name="api-SetDataRetrievalPolicy-example-request"></a>

다음은 Strategy 필드가 `BytesPerHour`로 설정되어 있을 때 HTTP PUT 요청을 전송하는 예제입니다.

```
 1. PUT /-/policies/data-retrieval HTTP/1.1
 2. Host: glacier.us-west-2.amazonaws.com
 3. x-amz-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
 6. 			
 7. {
 8.   "Policy":
 9.     {
10.       "Rules":[
11.          {
12.              "Strategy":"BytesPerHour",
13.              "BytesPerHour":10737418240       
14.           }
15.        ]
16.     }
17. }
```

다음은 Strategy 필드가 `FreeTier`로 설정되어 있을 때 HTTP PUT 요청을 전송하는 예제입니다.

```
 1. PUT /-/policies/data-retrieval HTTP/1.1
 2. Host: glacier.us-west-2.amazonaws.com
 3. x-amz-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
 6. 			
 7. {
 8.   "Policy":
 9.     {
10.       "Rules":[
11.          {
12.              "Strategy":"FreeTier"   
13.           }
14.        ]
15.     }
16. }
```

다음은 Strategy 필드가 `None`으로 설정되어 있을 때 HTTP PUT 요청을 전송하는 예제입니다.

```
 1. PUT /-/policies/data-retrieval HTTP/1.1
 2. Host: glacier.us-west-2.amazonaws.com
 3. x-amz-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
 6. 			
 7. {
 8.   "Policy":
 9.     {
10.       "Rules":[
11.          {
12.              "Strategy":"None"   
13.           }
14.        ]
15.     }
16. }
```

### 응답의 예
<a name="api-SetDataRetrievalPolicy-example-response"></a>

요청이 성공하면 Amazon Glacier(Amazon Glacier)가 다음 예시와 같이 정책을 설정한 후 `HTTP 204 No Content`를 반환합니다.

```
1. HTTP/1.1 204 No Content
2. x-amzn-RequestId: AAABZpJrTyioDC_HsOmHae8EZp_uBSJr6cnGOLKp_XJCl-Q
3. Date: Wed, 10 Feb 2017 12:02:00 GMT
```

## 관련 섹션
<a name="related-sections-SetDataRetrievalPolicy"></a>

 
+ [데이터 가져오기 정책 가져오기(GET policy)](api-GetDataRetrievalPolicy.md)

 
+ [작업 시작(POST jobs)](api-initiate-job-post.md)