

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

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

# 볼트 잠금 시작(POST lock-policy)
<a name="api-InitiateVaultLock"></a>

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

이 작업에서는 다음과 같은 방법으로 볼트 잠금 프로세스를 시작합니다.
+ 지정된 볼트에 볼트 잠금 정책을 설치합니다.
+ 볼트 잠금 상태를 `InProgress`로 설정합니다.
+ 볼트 잠금 프로세스를 마치는 데 사용되는 잠금 ID를 반환합니다.

각 볼트마다 볼트 잠금 정책 1개를 설정할 수 있으며, 정책 크기는 최대 20KB로 제한됩니다. 볼트 잠금 정책에 대한 자세한 내용은 [볼트 잠금 정책](vault-lock-policy.md) 섹션을 참조하세요.

볼트 잠금 상태가 `InProgress`로 전환된 후에는 24시간 이내에 볼트 잠금 프로세스를 마쳐야 합니다. 24시간이 지나면 잠금 ID가 만료되고 볼트가 자동으로 `InProgress` 상태를 종료하고 볼트 잠금 정책이 볼트에서 제거됩니다. [볼트 잠금 완료(POST lockId)](api-CompleteVaultLock.md)을 호출하여 볼트 잠금 프로세스를 마치면 볼트 잠금 상태가 `Locked`로 설정됩니다.

**참고**  
볼트 잠금이 `Locked` 상태로 바뀐 이후에는 동일한 볼트에 대해 새로운 볼트 잠금을 시작할 수 없습니다.

[볼트 잠금 중단(DELETE lock-policy)](api-AbortVaultLock.md)을 직접 호출하여 볼트 잠금 프로세스를 중단할 수 있습니다. 볼트 잠금 상태는 [볼트 잠금 가져오기(GET lock-policy)](api-GetVaultLock.md)을 호출하면 알 수 있습니다. 볼트 잠금 프로세스에 대한 자세한 내용은 [Amazon Glacier 볼트 잠금](vault-lock.md) 섹션을 참조하세요.

볼트 잠금이 `InProgress` 상태일 때 이 작업을 호출하면 `AccessDeniedException` 오류가 반환됩니다. 볼트 잠금이 `InProgress` 상태일 때 새로운 볼트 잠금 정책을 시작하려면 [볼트 잠금 중단(DELETE lock-policy)](api-AbortVaultLock.md)을 먼저 호출해야 합니다.

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

볼트 잠금 프로세스를 시작하려면 다음 구문 예제와 같이 HTTP `POST` 요청을 볼트의 `lock-policy` 하위 리소스 URI로 전송합니다.

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

```
 1. POST /AccountId/vaults/vaultName/lock-policy 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": "string"
10. }
```

 

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

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

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

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

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

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

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

 **정책**   
JSON 문자열 형식의 볼트 잠금 정책으로서 "\$1"를 이스케이프 문자로 사용합니다.  
 유형: 문자열   
 필수 항목 여부: 예

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

Amazon Glacier(Amazon Glacier)는 정책이 수락되면 `HTTP 201 Created` 응답을 반환합니다.

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

```
HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
x-amz-lock-id: lockId
```

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

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


|  이름  |  설명  | 
| --- | --- | 
|  x-amz-lock-id  |  볼트 잠금 프로세스를 마치는 데 사용되는 잠금 ID입니다. 유형: 문자열  | 

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

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

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

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

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

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

다음은 HTTP `PUT` 요청을 볼트의 `lock-policy` 하위 리소스 URI로 전송하는 예제입니다. `Policy` JSON 문자열은 이스케이프 문자로 "\$1"를 사용합니다.

```
1. PUT /-/vaults/examplevault/lock-policy 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
7. 
8. {"Policy":"{\"Version\":\"2012-10-17\",		 	 	 \"Statement\":[{\"Sid\":\"Define-vault-lock\",\"Effect\":\"Deny\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault\",\"Condition\":{\"NumericLessThanEquals\":{\"glacier:ArchiveAgeinDays\":\"365\"}}}]}"}
```

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

요청이 성공하면 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-lock-id: AE863rKkWZU53SLW5be4DUcW
```

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

 
+ [볼트 잠금 중단(DELETE lock-policy)](api-AbortVaultLock.md)

 
+ [볼트 잠금 완료(POST lockId)](api-CompleteVaultLock.md)

 
+ [볼트 잠금 가져오기(GET lock-policy)](api-GetVaultLock.md)

## 참고
<a name="api-InitiateVaultLock_SeeAlso"></a>

언어 특정 Amazon SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+  [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/initiate-vault-lock.html) 