

 **이 페이지는 볼트와 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="vault-operations"></a>

다음은 Amazon Glacier에서 사용할 수 있는 볼트 작업입니다.

**Topics**
+ [볼트 잠금 중단(DELETE lock-policy)](api-AbortVaultLock.md)
+ [볼트에 태그 추가(POST tags add)](api-AddTagsToVault.md)
+ [볼트 만들기(PUT vault)](api-vault-put.md)
+ [볼트 잠금 완료(POST lockId)](api-CompleteVaultLock.md)
+ [볼트 삭제(DELETE vault)](api-vault-delete.md)
+ [볼트 액세스 정책 삭제(DELETE access-policy)](api-DeleteVaultAccessPolicy.md)
+ [볼트 알림 삭제(DELETE notification-configuration)](api-vault-notifications-delete.md)
+ [볼트 설명(GET vault)](api-vault-get.md)
+ [볼트 액세스 정책 가져오기(GET access-policy)](api-GetVaultAccessPolicy.md)
+ [볼트 잠금 가져오기(GET lock-policy)](api-GetVaultLock.md)
+ [볼트 알림 가져오기(GET notification-configuration)](api-vault-notifications-get.md)
+ [볼트 잠금 시작(POST lock-policy)](api-InitiateVaultLock.md)
+ [볼트의 태그 목록 조회(GET tags)](api-ListTagsForVault.md)
+ [볼트 목록 조회(GET vaults)](api-vaults-get.md)
+ [볼트에서 태그 삭제(POST tags remove)](api-RemoveTagsFromVault.md)
+ [볼트 액세스 정책 설정(PUT access-policy)](api-SetVaultAccessPolicy.md)
+ [볼트 알림 구성 설정(PUT notification-configuration)](api-vault-notifications-put.md)

# 볼트 잠금 중단(DELETE lock-policy)
<a name="api-AbortVaultLock"></a>

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

이 작업에서는 볼트 잠금이 `Locked` 상태가 아닐 경우 볼트 잠금 프로세스를 중단합니다. 이 작업을 요청할 때 볼트 잠금이 `Locked` 상태일 경우에는 `AccessDeniedException` 오류가 반환됩니다. 볼트 잠금 프로세스를 중단하면 지정된 볼트에서 볼트 잠금 정책도 삭제됩니다.

`InProgress`를 호출하면 볼트 잠금이 [볼트 잠금 시작(POST lock-policy)](api-InitiateVaultLock.md) 상태로 전환됩니다. `Locked`를 호출하면 볼트 잠금이 [볼트 잠금 완료(POST lockId)](api-CompleteVaultLock.md) 상태로 전환됩니다. 볼트 잠금 상태는 [볼트 잠금 가져오기(GET lock-policy)](api-GetVaultLock.md)을 호출하면 알 수 있습니다. 볼트 잠금 프로세스에 대한 자세한 내용은 [Amazon Glacier 볼트 잠금](vault-lock.md) 섹션을 참조하세요. 볼트 잠금 정책에 대한 자세한 내용은 [볼트 잠금 정책](vault-lock-policy.md) 섹션을 참조하세요.

이 작업은 멱등성을 갖습니다. 볼트 잠금이 `InProgress` 상태이거나 볼트에 연결된 정책이 없는 경우에는 이 작업을 여러 번 성공적으로 호출할 수 있습니다.

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

볼트 잠금 정책을 삭제하려면 HTTP `DELETE` 요청을 볼트의 `lock-policy` 하위 리소스 URI로 전송합니다.

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

```
1. DELETE /AccountId/vaults/vaultName/lock-policy 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-AbortVaultLock-requests-parameters"></a>

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

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

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

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

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

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

정책이 성공적으로 삭제되면 Amazon Glacier가 `HTTP 204 No Content` 응답을 반환합니다.

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

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

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

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

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

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

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

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

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

다음은 볼트 잠금 프로세스를 중단하는 방법을 설명한 예시입니다.

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

이 예시에서 `DELETE` 요청은 볼트 이름이 **examplevault**인 `lock-policy` 하위 리소스로 전송됩니다.

```
1. DELETE /-/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. x-amz-glacier-version: 2012-06-01
```

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

정책이 성공적으로 삭제되면 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:00:00 GMT
```

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

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

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

 
+ [볼트 잠금 시작(POST lock-policy)](api-InitiateVaultLock.md)

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

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

# 볼트에 태그 추가(POST tags add)
<a name="api-AddTagsToVault"></a>

이 작업에서는 지정한 태그를 볼트에 추가합니다. 각 태그는 키와 값으로 구성됩니다. 각 볼트는 최대 50개까지 태그를 가질 수 있습니다. 볼트의 태그 제한을 초과하는 요청일 경우에는 `LimitExceededException` 오류가 반환됩니다.

지정한 키 아래의 볼트에 태그가 이미 있는 경우에는 기존 키 값을 덮어쓰게 됩니다. 태그에 대한 자세한 내용은 [Amazon Glacier 리소스에 태그 지정](tagging.md) 섹션을 참조하세요.

## 요청 구문
<a name="api-AddTagsToVault-requestSyntax"></a>

태그를 볼트에 추가하려면 다음 구문 예제와 같이 HTTP POST 요청을 태그 URI로 전송합니다.

```
 1. POST /AccountId/vaults/vaultName/tags?operation=add 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.    "Tags": 
10.       {
11.          "string": "string",
12.          "string": "string"
13.       }        
14. }
```

 

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

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


|  이름  |  설명  |  필수  | 
| --- | --- | --- | 
|  operation=add  |  [볼트에서 태그 삭제(POST tags remove)](api-RemoveTagsFromVault.md)와 구분할 목적으로 `add` 값이 포함된 단일 쿼리 문자열 파라미터 `operation`입니다.  |  예  | 

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

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

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

요청 본문에는 다음의 JSON 필드가 포함됩니다.

 

**태그**  
볼트에 추가할 태그입니다. 각 태그는 키와 값으로 구성됩니다. 값은 빈 문자열일 수도 있습니다.  
 *유형:* 문자열 간 맵   
 *길이 제한:* 최소 길이 1. 최대 길이 10  
 *필수 항목 여부*: 예 

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

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

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

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

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

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

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

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

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

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

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

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

다음 예에서는 볼트에 추가할 태그와 함께 HTTP POST 요청을 전송합니다.

```
 1. POST /-/vaults/examplevault/tags?operation=add 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. {
 9.   "Tags": 
10.     {
11.        "examplekey1": "examplevalue1",
12.        "examplekey2": "examplevalue2"
13.     }        
14. }
```

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

요청이 성공하면 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-AddTagsToVault"></a>

 
+ [볼트의 태그 목록 조회(GET tags)](api-ListTagsForVault.md)

 
+ [볼트에서 태그 삭제(POST tags remove)](api-RemoveTagsFromVault.md)

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

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

# 볼트 만들기(PUT vault)
<a name="api-vault-put"></a>

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

이 작업은 지정한 이름으로 새로운 볼트를 생성합니다.   볼트 이름은 AWS 계정에 속하는 AWS 리전 내에서 반드시 고유해야 합니다. 계정당 최대 1,000개까지 볼트를 생성할 수 있습니다. 더 많은 볼트 생성을 위한 자세한 정보는 [Amazon Glacier 제품 세부 정보 페이지](https://aws.amazon.com/glacier)를 참조하세요.

볼트 이름을 지정할 때는 다음 지침을 따라야 합니다.

 
+  이름에 포함되는 문자 길이는 1\$1255자입니다.
+ 유효한 문자는 A\$1Z, a\$1z, 0\$19, ‘-’(하이픈), ‘\$1’(밑줄), ‘.’(마침표)입니다.

이 작업은 멱등성을 갖기 때문에 동일한 요청을 여러 차례 전송할 수 있으며, Amazon Glacier(Amazon Glacier)가 지정한 볼트를 처음 생성한 이후부터는 추가적인 영향을 미치지 않습니다.

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

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

볼트 생성을 위해 HTTP PUT 요청을 생성할 볼트의 URI로 전송합니다.

```
1. PUT /AccountId/vaults/VaultName 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-vault-put-requests-parameters"></a>

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

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

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

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

이 작업의 요청 본문은 비어 있어야 합니다(0바이트).

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

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

```
HTTP/1.1 201 Created
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Location: Location
```

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

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


|  이름  |  설명 | 
| --- | --- | 
| `Location`  | 생성된 볼트의 상대적 URI 경로입니다. 유형: 문자열 | 

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

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

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

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

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

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

다음은 HTTP PUT 요청을 전송하여 `examplevault`라는 이름의 볼트를 생성하는 예제입니다.

```
1. PUT /-/vaults/examplevault 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. Content-Length: 0
6. 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-vault-put-example-response"></a>

Amazon Glacier가 볼트를 생성하고, `Location` 헤더에 볼트의 상대적 URI 경로를 반환합니다. 계정 ID는 요청에서 계정 ID 또는 하이픈('`-`') 지정 여부에 상관없이 항상 `Location` 헤더에 표시됩니다.

```
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. Location: /111122223333/vaults/examplevault
```

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

 
+ [볼트 목록 조회(GET vaults)](api-vaults-get.md)
+ [볼트 삭제(DELETE vault)](api-vault-delete.md)
+ [Amazon Glacier의 ID 및 액세스 관리(IAM)](security-iam.md)

## 참고
<a name="vault-put-SeeAlso"></a>

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

# 볼트 잠금 완료(POST lockId)
<a name="api-CompleteVaultLock"></a>

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

이번 작업에서는 볼트 잠금 상태를 `InProgress`에서 `Locked`로 전환하여 볼트 잠금 프로세스를 완료합니다. 이렇게 완료된 볼트 잠금 정책은 변경할 수 없습니다. `InProgress`을 호출하면 볼트 잠금이 [볼트 잠금 시작(POST lock-policy)](api-InitiateVaultLock.md) 상태로 전환됩니다. 볼트 잠금 상태는 [볼트 잠금 가져오기(GET lock-policy)](api-GetVaultLock.md)을 호출하면 가져올 수 있습니다. 볼트 잠금 프로세스에 대한 자세한 내용은 [Amazon Glacier 볼트 잠금](vault-lock.md) 섹션을 참조하세요.

이 작업은 멱등성을 갖습니다. 볼트 잠금 상태가 `Locked`이고, 입력한 잠금 ID가 처음에 볼트를 잠글 때 사용한 잠금 ID와 일치하는 경우에는 이 요청이 항상 성공합니다.

볼트 잠금이 `Locked` 상태라고 해도 요청 시 잘못된 잠금 ID를 입력하면 `AccessDeniedException` 오류가 반환됩니다. 볼트 잠금이 `InProgress` 상태일 때 잘못된 잠금 ID를 입력하면 `InvalidParameter` 오류가 발생합니다.

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

볼트 잠금 프로세스를 완료하려면 HTTP `POST` 요청을 유효한 잠금 ID와 함께 볼트의 `lock-policy` 하위 리소스 URI로 전송합니다.

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

```
1. POST /AccountId/vaults/vaultName/lock-policy/lockId 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에 하이픈('-')을 포함하지 않습니다.

 `lockId` 값은 [볼트 잠금 시작(POST lock-policy)](api-InitiateVaultLock.md) 요청에서 가져오는 잠금 ID입니다.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

다음은 HTTP POST 요청을 잠금 ID와 함께 전송하여 볼트 잠금 프로세스를 완료하는 예제입니다.

```
1. POST /-/vaults/examplevault/lock-policy/AE863rKkWZU53SLW5be4DUcW 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-CompleteVaultLock-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-CompleteVaultLock"></a>

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

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

 
+ [볼트 잠금 시작(POST lock-policy)](api-InitiateVaultLock.md)

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

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

# 볼트 삭제(DELETE vault)
<a name="api-vault-delete"></a>

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

이 작업은 볼트를 삭제합니다. Amazon Glacier(Amazon Glacier)는 마지막 인벤토리를 기준으로 볼트에 저장된 아카이브가 없고, 마지막 인벤토리 이후 볼트에 대한 쓰기 작업이 없었던 경우에 한해 볼트를 삭제합니다. 두 조건 중 하나라도 충족되지 않는 경우에는 볼트 삭제가 중단되고(볼트가 삭제되지 않음) Amazon Glacier는 오류를 반환합니다.

볼트에 저장된 아카이브 수 등 볼트 관련 정보를 제공하는 [볼트 설명(GET vault)](api-vault-get.md) 작업을 사용할 수 있지만, 해당 정보는 Amazon Glacier가 마지막으로 생성한 볼트 인벤토리를 기준으로 합니다.

이 작업은 멱등성을 갖습니다.

**참고**  
볼트를 삭제하면 해당 볼트에 연결된 볼트 액세스 정책 역시 삭제됩니다. 볼트 액세스 정책에 대한 자세한 내용은 [볼트 액세스 정책](vault-access-policy.md) 섹션을 참조하세요.

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

볼트를 삭제하려면 `DELETE` 요청을 볼트의 리소스 URI로 전송합니다.

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

```
1. DELETE /AccountId/vaults/VaultName 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 또는 선택적으로 하나의 '`-`'(하이픈)을 지정할 수 있습니다. 이 경우에 Amazon Glacier는 요청 서명에 사용된 자격 증명과 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 사용하는 경우 ID에 하이픈('-')을 포함할 수 없습니다.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

다음은 이름이 `examplevault`인 볼트를 삭제하는 예제입니다. 이 예제 요청은 삭제할 리소스(볼트)의 URI에 대한 `DELETE` 요청입니다.

```
1. DELETE /-/vaults/examplevault 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-vault-delete-example-response"></a>

```
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-vault-delete"></a>

 
+ [볼트 만들기(PUT vault)](api-vault-put.md)
+ [볼트 목록 조회(GET vaults)](api-vaults-get.md)
+ [작업 시작(POST jobs)](api-initiate-job-post.md)
+ [Amazon Glacier의 ID 및 액세스 관리(IAM)](security-iam.md)

## 참고
<a name="api-vault-delete-SeeAlso"></a>

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

# 볼트 액세스 정책 삭제(DELETE access-policy)
<a name="api-DeleteVaultAccessPolicy"></a>

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

이 작업에서는 지정된 볼트에 연결되어 있는 액세스 정책을 삭제합니다. 이 작업은 최종적으로 일관성을 갖습니다. 다시 말해서 Amazon Glacier(Amazon Glacier)가 액세스 정책을 완전히 제거하는 데 약간의 시간이 필요하기 때문에 삭제 요청을 전송한 후에도 짧은 시간 동안 정책이 적용되는 것을 볼 수도 있습니다.

이 작업은 멱등성을 갖습니다. 따라서 볼트에 연결되어 있는 정책이 없더라도 삭제를 여러 차례 호출할 수 있습니다. 볼트 액세스 정책에 대한 자세한 내용은 [볼트 액세스 정책](vault-access-policy.md) 섹션을 참조하세요.

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

현재 볼트 액세스 정책을 삭제하려면 HTTP `DELETE` 요청을 볼트의 `access-policy` 하위 리소스 URI로 전송합니다.

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

```
1. DELETE /AccountId/vaults/vaultName/access-policy 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를 지정하거나 선택적으로 단일 '`-`'(하이픈)를 지정할 수 있습니다.이 경우 Amazon Glacier는 요청에 서명하는 데 사용되는 자격 증명과 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 사용하는 경우 ID에 하이픈('-')을 포함할 수 없습니다.

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

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

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

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

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

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

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

정책이 성공적으로 삭제되면 Amazon Glacier가 응답에서 `204 No Content`를 반환합니다.

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

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

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

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

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

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

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

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

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

다음은 볼트 액세스 정책을 삭제하는 방법을 설명한 예제입니다.

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

이 예시에서 `DELETE` 요청은 볼트 이름이 **examplevault**인 `access-policy` 하위 리소스로 전송됩니다.

```
1. DELETE /-/vaults/examplevault/access-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. x-amz-glacier-version: 2012-06-01
```

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

정책이 성공적으로 삭제되면 Amazon Glacier가 응답에서 다음 예시와 같이 `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:00:00 GMT
```

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

 
+ [볼트 액세스 정책 가져오기(GET access-policy)](api-GetVaultAccessPolicy.md)

 
+ [볼트 액세스 정책 설정(PUT access-policy)](api-SetVaultAccessPolicy.md)

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

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

# 볼트 알림 삭제(DELETE notification-configuration)
<a name="api-vault-notifications-delete"></a>

## 설명
<a name="api-vault-notifications-delete-description"></a>

이 작업에서는 볼트에 설정된 알림 구성([볼트 알림 구성 설정(PUT notification-configuration)](api-vault-notifications-put.md))을 삭제합니다. 작업은 최종적으로 일관성을 갖습니다. 즉, Amazon Glacier(Amazon Glacier)가 알림을 완전히 비활성화하는 데 약간의 시간이 필요하며, 삭제 요청을 보낸 후 잠시 동안은 알림을 받을 수도 있습니다.

## Requests
<a name="api-vault-notifications-delete-requests"></a>

볼트의 알림 구성을 삭제하려면 `DELETE` 요청을 볼트의 `notification-configuration` 하위 리소스로 전송합니다.

### 구문
<a name="api-vault-notifications-delete-requests-syntax"></a>

```
1. DELETE /AccountId/vaults/VaultName/notification-configuration 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를 지정하거나 선택적으로 단일 '`-`'(하이픈)를 지정할 수 있습니다.이 경우 Amazon Glacier는 요청에 서명하는 데 사용되는 자격 증명과 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 사용하는 경우 ID에 하이픈('-')을 포함할 수 없습니다.

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

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

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

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

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

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

## 응답
<a name="api-vault-notifications-delete-responses"></a>

### 구문
<a name="api-vault-notifications-delete-responses-syntax"></a>

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

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

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

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

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

### 오류
<a name="api-vault-notifications-delete-responses-errors"></a>

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

## 예제
<a name="api-vault-notifications-delete-examples"></a>

다음은 볼트에 설정된 알림 구성을 제거하는 방법을 설명한 예제입니다.

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

이 예시에서 `DELETE` 요청은 볼트 이름이 `examplevault`인 `notification-configuration` 하위 리소스로 전송됩니다.

```
1. DELETE /111122223333/vaults/examplevault/notification-configuration 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-vault-notifications-delete-example-response"></a>

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

## 관련 섹션
<a name="related-sections-vault-notifications-delete"></a>

 
+ [볼트 알림 가져오기(GET notification-configuration)](api-vault-notifications-get.md)
+ [볼트 알림 구성 설정(PUT notification-configuration)](api-vault-notifications-put.md)
+ [Amazon Glacier의 ID 및 액세스 관리(IAM)](security-iam.md)

## 참고
<a name="api-vault-notifications-delete_SeeAlso"></a>

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

# 볼트 설명(GET vault)
<a name="api-vault-get"></a>

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

이 작업에서는 볼트의 Amazon 리소스 이름(ARN), 볼트 생성 날짜, 볼트에 저장된 아카이브 수, 볼트에 저장된 모든 아카이브의 총 크기 등 볼트에 대한 정보를 반환합니다. 아카이브의 수와 총 크기는 Amazon Glacier(Amazon Glacier)가 마지막으로 생성한 볼트 인벤토리를 기준으로 합니다([Amazon Glacier에서의 볼트 작업](working-with-vaults.md) 참조). Amazon Glacier는 거의 매일 볼트 인벤토리를 생성합니다. 이는 아카이브를 볼트에 추가하거나 삭제한 직후에 볼트 설명 요청을 전송하더라도 응답에 변경 내용이 반영되지 않을 수도 있다는 것을 의미합니다.

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

볼트 정보를 가져오려면 `GET` 요청을 특정 볼트 리소스의 URI로 전송합니다.

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

```
1. GET /AccountId/vaults/VaultName 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 또는 선택적으로 하나의 '`-`'(하이픈)을 지정할 수 있습니다. 이 경우에 Amazon Glacier는 요청 서명에 사용된 자격 증명과 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 사용하는 경우 ID에 하이픈('-')을 포함할 수 없습니다.

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

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

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

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

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

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

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

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

```
HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length

{
  "CreationDate" : String,
  "LastInventoryDate" : String,
  "NumberOfArchives" : Number,
  "SizeInBytes" : Number,
  "VaultARN" : String,
  "VaultName" : String
}
```

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

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

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

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

**CreationDate**  
볼트가 생성된 UTC 날짜입니다.  
**유형: ISO 8601 날짜 형식의 문자열 표현입니다. 예: `2013-03-20T17:03:43.221Z`

**LastInventoryDate**  
Amazon Glacier가 마지막 볼트 인벤토리를 완료한 UTC 날짜입니다. 볼트 인벤토리의 시작에 대한 자세한 내용은 [작업 시작(POST jobs)](api-initiate-job-post.md) 섹션을 참조하세요.  
*유형*: ISO 8601 날짜 형식의 문자열 표현입니다(예: `2013-03-20T17:03:43.221Z`).

**NumberOfArchives**  
마지막 볼트 인벤토리를 기준으로 볼트에 저장된 아카이브 수입니다. 인벤토리가 아직 볼트에서 실행되지 않은 경우, 예를 들어 볼트를 방금 생성한 경우 이 필드는 null 값을 반환합니다.  
*형식*: 숫자

**SizeInBytes**  
마지막 인벤토리 날짜를 기준으로 아카이브별 오버헤드를 포함하여 볼트에 저장된 아카이브의 총 크기(바이트)입니다. 인벤토리가 아직 볼트에서 실행되지 않은 경우, 예를 들어 볼트를 방금 생성한 경우 이 필드는 `null` 값을 반환합니다.  
*형식*: 숫자

**VaultARN**  
볼트의 Amazon 리소스 이름(ARN)입니다.  
*유형*: 문자열

**VaultName**  
생성 시 지정한 볼트 이름입니다. 볼트 이름은 볼트의 ARN에도 포함됩니다.  
*유형*: 문자열

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

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

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

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

다음은 이름이 `examplevault`인 볼트에 대한 정보를 가져오는 방법을 설명한 예제입니다.

```
GET /-/vaults/examplevault HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-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
```

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

```
 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: 260
 6. 
 7. {
 8.   "CreationDate" : "2012-02-20T17:01:45.198Z",
 9.   "LastInventoryDate" : "2012-03-20T17:03:43.221Z",
10.   "NumberOfArchives" : 192,
11.   "SizeInBytes" : 78088912,
12.   "VaultARN" : "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault",
13.   "VaultName" : "examplevault"
14. }
```

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

 
+ [볼트 만들기(PUT vault)](api-vault-put.md)
+ [볼트 목록 조회(GET vaults)](api-vaults-get.md)
+ [볼트 삭제(DELETE vault)](api-vault-delete.md)
+ [작업 시작(POST jobs)](api-initiate-job-post.md)
+ [Amazon Glacier의 ID 및 액세스 관리(IAM)](security-iam.md)

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

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

# 볼트 액세스 정책 가져오기(GET access-policy)
<a name="api-GetVaultAccessPolicy"></a>

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

이 작업은 볼트에 설정되어 있는 `access-policy` 하위 리소스를 검색합니다. 하위 리소스 설정에 대한 자세한 내용은 [볼트 액세스 정책 설정(PUT access-policy)](api-SetVaultAccessPolicy.md) 섹션을 참조하세요. 볼트에 설정되어 있는 액세스 정책이 없는 경우에는 `404 Not found` 오류가 반환됩니다. 볼트 액세스 정책에 대한 자세한 내용은 [볼트 액세스 정책](vault-access-policy.md) 섹션을 참조하세요.

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

현재 볼트 액세스 정책을 반환하려면 HTTP `GET` 요청을 볼트의 `access-policy` 하위 리소스 URI로 전송합니다.

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

```
1. GET /AccountId/vaults/vaultName/access-policy 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를 지정하거나 선택적으로 단일 '`-`'(하이픈)를 지정할 수 있습니다.이 경우 Amazon Glacier는 요청에 서명하는 데 사용되는 자격 증명과 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 사용하는 경우 ID에 하이픈('-')을 포함할 수 없습니다.

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

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

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

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

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

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

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

응답 시, Amazon Glacier(Amazon Glacier)는 응답 본문에서 JSON 형식으로 볼트 액세스 정책을 반환합니다.

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

```
HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: length
				
{
  "Policy": "string"
}
```

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

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

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

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

 **정책**   
JSON 문자열 형식의 볼트 액세스 정책으로서 "\$1"를 이스케이프 문자로 사용합니다.  
 유형: 문자열

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

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

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

다음은 볼트 액세스 정책을 가져오는 방법을 설명한 예제입니다.

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

이 예제에서는 `GET` 요청이 볼트의 `access-policy` 하위 리소스 URI로 전송됩니다.

```
1. GET /-/vaults/examplevault/access-policy 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-GetVaultAccessPolicy-example-response"></a>

요청이 성공하면 Amazon Glacier가 응답 본문에서 볼트 액세스 정책을 JSON 문자열 형식으로 반환합니다. 반환된 JSON 문자열은 [볼트 액세스 정책 설정(PUT access-policy)](api-SetVaultAccessPolicy.md) 예제와 같이 "\$1"를 이스케이프 문자로 사용합니다. 하지만 다음 예제에서는 가독성을 위해 반환된 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: length
 6. 
 7. {
 8.   "Policy": "
 9.     {
10.       "Version": "2012-10-17",		 	 	 
11.       "Statement": [
12.         {
13.           "Sid": "allow-time-based-deletes",
14.           "Principal": {
15.             "AWS": "999999999999"
16.           },
17.           "Effect": "Allow",
18.           "Action": "glacier:Delete*",
19.           "Resource": [
20.             "arn:aws:glacier:us-west-2:999999999999:vaults/examplevault"
21.           ],
22.           "Condition": {
23.             "DateGreaterThan": {
24.               "aws:CurrentTime": "2018-12-31T00:00:00Z"
25.             }
26.           }
27.         }
28.       ]
29.     }        
30.   "
31. }
```

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

 
+ [볼트 액세스 정책 삭제(DELETE access-policy)](api-DeleteVaultAccessPolicy.md)

 
+ [볼트 액세스 정책 설정(PUT access-policy)](api-SetVaultAccessPolicy.md)

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

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

# 볼트 잠금 가져오기(GET lock-policy)
<a name="api-GetVaultLock"></a>

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

이 작업에서는 지정된 볼트에 설정되어 있는 `lock-policy` 하위 리소스에서 다음과 같은 속성을 가져옵니다.
+ 볼트에 설정되어 있는 볼트 잠금 정책
+ 볼트 잠금 상태(`InProgess` 또는 `Locked`)
+ 잠금 ID의 만료 시점. 잠금 ID는 볼트 잠금 프로세스를 마치는 데 사용됩니다.
+ 볼트 잠금이 시작되어 `InProgress` 상태로 전환된 시점

[볼트 잠금 시작(POST lock-policy)](api-InitiateVaultLock.md)을 호출하면 볼트 잠금이 `InProgress` 상태로 전환됩니다. [볼트 잠금 완료(POST lockId)](api-CompleteVaultLock.md)을 호출하면 볼트 잠금이 `Locked` 상태로 전환됩니다. 또한 [볼트 잠금 중단(DELETE lock-policy)](api-AbortVaultLock.md)을 직접 호출하여 볼트 잠금 프로세스를 중단시킬 수 있습니다. 볼트 잠금 프로세스에 대한 자세한 내용은 [Amazon Glacier 볼트 잠금](vault-lock.md) 섹션을 참조하세요.

볼트에 설정되어 있는 볼트 잠금 정책이 없는 경우에는 `404 Not found` 오류가 반환됩니다. 볼트 잠금 정책에 대한 자세한 내용은 [볼트 잠금 정책](vault-lock-policy.md) 섹션을 참조하세요.

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

현재 볼트 잠금 정책과 기타 속성을 반환하려면 다음 구문 예제와 같이 HTTP `GET` 요청을 볼트의 `lock-policy` 하위 리소스 URI로 전송합니다.

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

```
1. GET /AccountId/vaults/vaultName/lock-policy 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를 지정하거나 선택적으로 단일 '`-`'(하이픈)를 지정할 수 있습니다.이 경우 Amazon Glacier는 요청에 서명하는 데 사용되는 자격 증명과 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 사용하는 경우 ID에 하이픈('-')을 포함할 수 없습니다.

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

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

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

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

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

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

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

응답 시, Amazon Glacier(Amazon Glacier)는 응답 본문에서 JSON 형식으로 볼트 액세스 정책을 반환합니다.

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

```
HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: length
				
{
  "Policy": "string",
  "State": "string",
  "ExpirationDate": "string",
  "CreationDate":"string"
}
```

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

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

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

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

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

 **상태**   
볼트 잠금 상태입니다.  
 타입: 문자열  
 유효한 값: `InProgress``|Locked`

 **ExpirationDate**   
잠금 ID가 만료되는 UTC 날짜와 시간입니다. 볼트 잠금이 `null` 상태인 경우 이 값은 `Locked`가 될 수 있습니다.  
**유형: ISO 8601 날짜 형식의 문자열 표현입니다. 예: `2013-03-20T17:03:43.221Z`

 **CreationDate**   
볼트 잠금이 `InProgress` 상태로 전환된 UTC 날짜와 시간입니다.  
**유형: ISO 8601 날짜 형식의 문자열 표현입니다. 예: `2013-03-20T17:03:43.221Z`

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

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

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

다음은 볼트 잠금 정책을 가져오는 방법을 설명한 예제입니다.

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

이 예제에서는 `GET` 요청이 볼트의 `lock-policy` 하위 리소스 URI로 전송됩니다.

```
1. GET /-/vaults/examplevault/lock-policy 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-GetVaultLock-example-response"></a>

요청이 성공하면 Amazon Glacier가 응답 본문에서 볼트 액세스 정책을 JSON 문자열 형식으로 반환합니다. 반환된 JSON 문자열은 [볼트 잠금 시작(POST lock-policy)](api-InitiateVaultLock.md) 요청 예제와 같이 "\$1"를 이스케이프 문자로 사용합니다. 하지만 다음 예제에서는 가독성을 위해 반환된 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: length
 6. 
 7. {
 8.   "Policy": "
 9.     {
10.       "Version": "2012-10-17",		 	 	 
11.       "Statement": [
12.         {
13.           "Sid": "Define-vault-lock",
14.           "Principal": {
15.             "AWS": "arn:aws:iam::999999999999:root"
16.           },
17.           "Effect": "Deny",
18.           "Action": "glacier:DeleteArchive",
19.           "Resource": [
20.             "arn:aws:glacier:us-west-2:999999999999:vaults/examplevault"
21.           ],
22.           "Condition": {
23.             "NumericLessThanEquals": {
24.               "glacier:ArchiveAgeInDays": "365"
25.             }
26.           }
27.         }
28.       ]
29.     }
30.   ",
31.   "State": "InProgress",
32.   "ExpirationDate": "exampledate",
33.   "CreationDate": "exampledate"  
34. }
```

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

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

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

 
+ [볼트 잠금 시작(POST lock-policy)](api-InitiateVaultLock.md)

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

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

# 볼트 알림 가져오기(GET notification-configuration)
<a name="api-vault-notifications-get"></a>

## 설명
<a name="api-vault-notifications-get-description"></a>

이 작업에서는 볼트에 설정되어 있는 `notification-configuration` 하위 리소스를 가져옵니다([볼트 알림 구성 설정(PUT notification-configuration)](api-vault-notifications-put.md) 참조). 볼트에 알림 구성이 설정되어 있지 않으면 `404 Not Found` 오류가 반환됩니다. 볼트 알림에 대한 자세한 내용은 [Amazon Glacier의 볼트 알림 구성](configuring-notifications.md) 섹션을 참조하세요.

## Requests
<a name="api-vault-notifications-get-requests"></a>

알림 구성 정보를 가져오려면 `GET` 요청을 볼트의 `notification-configuration` 하위 리소스 URI로 전송합니다.

### 구문
<a name="api-vault-notifications-get-requests-syntax"></a>

```
1. GET /AccountId/vaults/VaultName/notification-configuration 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를 지정하거나 선택적으로 단일 '`-`'(하이픈)를 지정할 수 있습니다.이 경우 Amazon Glacier는 요청에 서명하는 데 사용되는 자격 증명과 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 사용하는 경우 ID에 하이픈('-')을 포함할 수 없습니다.

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

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

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

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

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

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

## 응답
<a name="api-vault-notifications-get-responses"></a>

### 구문
<a name="api-vault-notifications-get-responses-syntax"></a>

```
HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: length
{
  "Events": [
    String,
    ...
  ],
  "SNSTopic": String
}
```

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

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

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

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

 

**이벤트**  
Amazon Glacier(Amazon Glacier)가 지정된 Amazon SNS 토픽으로 알림 메시지를 보내게 되는 하나 이상의 이벤트로 이루어진 목록입니다. 알림 메시지를 게시하도록 볼트를 구성할 수 있는 볼트 이벤트에 대한 자세한 내용은 [볼트 알림 구성 설정(PUT notification-configuration)](api-vault-notifications-put.md) 섹션을 참조하세요.  
*유형*: 배열

**SNSTopic**  
Amazon Simple Notification Service(SNS) 토픽의 Amazon 리소스 이름(ARN)입니다. 자세한 내용은 **Amazon Simple Notification Service 시작 가이드의 [Amazon SNS 시작하기](https://docs.aws.amazon.com/sns/latest/gsg/Welcome.html)를 참조하세요.  
*유형*: 문자열

### 오류
<a name="api-vault-notifications-get-responses-errors"></a>

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

## 예제
<a name="api-vault-notifications-get-examples"></a>

다음은 볼트에 설정된 알림 구성을 가져오는 방법을 설명한 예제입니다.

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

이 예에서는 `GET` 요청이 볼트의 `notification-configuration` 하위 리소스로 전송됩니다.

```
1. GET /-/vaults/examplevault/notification-configuration 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-vault-notifications-get-example-response"></a>

응답이 성공적으로 반환되면 감사 로깅 구성 문서가 응답 본문에 JSON 형식으로 표시됩니다. 이번 예시에서는 구성에 따라 두 가지 이벤트(`ArchiveRetrievalCompleted`와 `InventoryRetrievalCompleted`)에 대한 알림 메시지가 Amazon SNS 토픽 `arn:aws:sns:us-west-2:012345678901:mytopic`으로 전송되는 것을 보여줍니다.

```
 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: 150
 6.   
 7. {
 8.   "Events": [
 9.     "ArchiveRetrievalCompleted",
10.     "InventoryRetrievalCompleted"
11.   ],
12.   "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic"
13. }
```

## 관련 섹션
<a name="related-sections-vault-notifications-get"></a>

 
+ [볼트 알림 삭제(DELETE notification-configuration)](api-vault-notifications-delete.md)
+ [볼트 알림 구성 설정(PUT notification-configuration)](api-vault-notifications-put.md)
+ [Amazon Glacier의 ID 및 액세스 관리(IAM)](security-iam.md)

## 참고
<a name="api-vault-notifications-get_SeeAlso"></a>

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

# 볼트 잠금 시작(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) 

# 볼트의 태그 목록 조회(GET tags)
<a name="api-ListTagsForVault"></a>

이 작업에서는 볼트에 연결되어 있는 모든 태그의 목록을 조회합니다. 태그가 없는 경우에는 비어있는 맵을 반환합니다. 태그에 대한 자세한 내용은 [Amazon Glacier 리소스에 태그 지정](tagging.md) 섹션을 참조하세요.

## 요청 구문
<a name="api-ListTagsForVault-RequestSyntax"></a>

볼트의 태그 목록을 조회하려면 다음 구문 예제와 같이 HTTP GET 요청을 태그 URI로 전송합니다.

```
1. GET /AccountId/vaults/vaultName/tags 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-ListTagsForVault-RequestParameters"></a>

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

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

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

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

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

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

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

### 응답 구문
<a name="api-ListTagsForVault-ResponseSyntax"></a>

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

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

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

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

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

**태그**  <a name="Glacier-ListTagsForVault-response-Tags"></a>
볼트에 연결된 태그입니다. 각 태그는 키와 값으로 구성됩니다.  
 *유형:* 문자열 간 맵   
 *필수 항목 여부*: 예 

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

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

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

### 예제: 볼트의 태그 목록 조회
<a name="api-ListTagsForVault-example1"></a>

다음은 볼트의 태그 목록을 조회하는 예제입니다.

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

이 예제에서는 GET 요청을 전송하여 지정된 볼트의 태그 목록을 가져옵니다.

```
1. GET /-/vaults/examplevault/tags 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-ListTagsForVault-example1-response"></a>

요청이 성공하면 Amazon Glacier(Amazon Glacier)가 다음 예시와 같이 볼트의 태그 목록과 함께 `HTTP 200 OK`를 반환합니다.

```
 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.    "Tags",
 9.       {
10.          "examplekey1": "examplevalue1",
11.          "examplekey2": "examplevalue2"
12.       }  
13. }
```

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

 
+ [볼트에 태그 추가(POST tags add)](api-AddTagsToVault.md)

 
+ [볼트에서 태그 삭제(POST tags remove)](api-RemoveTagsFromVault.md)

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

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

# 볼트 목록 조회(GET vaults)
<a name="api-vaults-get"></a>

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

이 작업에서는 호출 사용자의 계정에 속한 모든 볼트 목록을 조회합니다. 이때 응답으로 반환되는 목록은 볼트 이름을 기준으로 ASCII 정렬 순서를 따릅니다.

기본적으로 이 작업에서 요청 1건당 반환되는 항목 수는 최대 10개입니다. 목록을 조회할 볼트가 더 있는 경우에는 응답 본문의 `marker` 필드에 새로운 볼트 목록 조회 요청과 함께 목록이 계속되는 지점에 볼트의 Amazon 리소스 이름(ARN)이 추가됩니다. 그렇지 않으면 `marker` 필드는 `null` 값을 갖습니다. 다음 볼트 목록 조회 요청에서는 Amazon Glacier(Amazon Glacier)가 이전 볼트 목록 조회 요청에 대한 응답으로 반환한 값으로 `marker` 파라미터를 설정합니다. 또한 요청 시 `limit` 파라미터를 지정하여 응답으로 반환되는 볼트 수를 제한할 수도 있습니다.

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

볼트 목록을 가져오려면 `GET` 요청을 *볼트* 리소스에 전송합니다.

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

```
1. GET /AccountId/vaults 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-vaults-get-requests-parameters"></a>

이 작업은 다음 요청 파라미터를 사용합니다.


|  이름  |  설명  |  필수  | 
| --- | --- | --- | 
|  limit  |  반환할 볼트의 최대 수입니다. 기본 제한은 10개입니다. 반환되는 볼트 수가 지정한 제한보다 적을 수 있지만 제한을 초과할 수는 없습니다. 유형: 문자열 제약 조건: 최소 정수 값 1. 최대 정수 값 10  |  아니요  | 
|  marker  |  페이지 매김에 사용되는 문자열입니다. `marker`는 볼트 목록 조회가 시작되는 볼트 ARN을 지정합니다. (`marker`에서 지정하는 볼트는 반환 목록에 포함되지 않습니다.) 이전 볼트 목록 조회 응답에서 `marker` 값을 가져옵니다. `marker`는 이전 볼트 목록 조회 요청에서 시작된 결과에 페이지를 계속해서 매겨야 하는 경우에만 포함해야 합니다. 마커에 대해 빈 값("")을 지정하면 첫 번째 볼트부터 볼트 목록을 반환합니다. 유형: 문자열 제약 조건: 없음  |  아니요  | 

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

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

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

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

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

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

```
HTTP/1.1 200 OK
x-amzn-RequestId: x-amzn-RequestId
Date: Date
Content-Type: application/json
Content-Length: Length

{
  "Marker": String
  "VaultList": [ 
   {
    "CreationDate": String,
    "LastInventoryDate": String,
    "NumberOfArchives": Number,
    "SizeInBytes": Number,
    "VaultARN": String,
    "VaultName": String
   }, 
   ...
  ]
}
```

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

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

### 응답 본문
<a name="api-vaults-get-response-body"></a>

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

 

**CreationDate**  
볼트가 생성된 날짜(UTC)입니다.  
*유형*: 문자열. ISO 8601 날짜 형식의 문자열 표현입니다. 예: `2013-03-20T17:03:43.221Z`

**LastInventoryDate**  
마지막 볼트 인벤토리의 날짜(UTC)입니다. 인벤토리가 아직 볼트에서 실행되지 않은 경우, 예를 들어 볼트를 방금 생성한 경우 이 필드는 null 값을 가질 수 있습니다. 볼트 인벤토리의 시작에 대한 자세한 내용은 [작업 시작(POST jobs)](api-initiate-job-post.md) 섹션을 참조하세요.  
*유형*: ISO 8601 날짜 형식의 문자열 표현입니다. 예: `2013-03-20T17:03:43.221Z`

**마커**  
결과에 페이지를 계속해서 매기는 지점을 나타내는 `vaultARN`입니다. 다른 볼트 목록 조회 요청에서 `marker`를 사용하여 목록에서 추가 볼트를 가져올 수 있습니다. 볼트가 더 없을 경우 이 값은 `null`입니다.  
*유형*: 문자열

**NumberOfArchives**  
마지막 인벤토리 날짜를 기준으로 볼트의 아카이브 수입니다.  
*유형*: 숫자

**SizeInBytes**  
마지막 인벤토리 날짜를 기준으로 아카이브별 오버헤드를 포함하여 볼트에 저장된 모든 아카이브의 총 크기(바이트)입니다.  
*유형*: 숫자

**VaultARN**  
볼트의 Amazon 리소스 이름(ARN)입니다.  
*유형*: 문자열

**VaultList**  
각각 볼트에 대해 설명하는 객체의 배열입니다.  
*유형*: 배열

**VaultName**  
볼트 이름입니다.  
*유형*: 문자열

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

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

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

### 예제: 모든 볼트 목록 조회
<a name="api-vaults-get-example1"></a>

다음은 볼트 목록을 조회하는 예제입니다. 요청에서 `marker` 파라미터와 `limit` 파라미터를 지정하지 않았기 때문에 최대 10개까지 볼트가 반환됩니다.

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

```
1. GET /-/vaults 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-vaults-get-example1-response"></a>

`Marker`가 `null` 값을 갖기 때문에 더 이상 목록을 조회할 볼트가 없다는 것을 의미합니다.

```
 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: 497	
 6. 
 7. {
 8.   "Marker": null,
 9.   "VaultList": [ 
10.    {
11.     "CreationDate": "2012-03-16T22:22:47.214Z",
12.     "LastInventoryDate": "2012-03-21T22:06:51.218Z",
13.     "NumberOfArchives": 2,
14.     "SizeInBytes": 12334,
15.     "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1",
16.     "VaultName": "examplevault1"
17.    }, 
18.    {
19.     "CreationDate": "2012-03-19T22:06:51.218Z",
20.     "LastInventoryDate": "2012-03-21T22:06:51.218Z",
21.     "NumberOfArchives": 0,
22.     "SizeInBytes": 0,
23.     "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault2",
24.     "VaultName": "examplevault2"
25.    },
26.    {
27.     "CreationDate": "2012-03-19T22:06:51.218Z",
28.     "LastInventoryDate": "2012-03-25T12:14:31.121Z",
29.     "NumberOfArchives": 0,
30.     "SizeInBytes": 0,
31.     "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault3",
32.     "VaultName": "examplevault3"
33.    } 
34.   ]
35. }
```

### 예제: 부분적 볼트 목록 조회
<a name="api-vaults-get-example2"></a>

다음은 `marker`에서 지정한 볼트부터 볼트 2개를 반환하는 예제입니다.

#### 요청 예시
<a name="api-vaults-get-example2-request"></a>

```
1. GET /-/vaults?limit=2&marker=arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1 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-vaults-get-example2-response"></a>

목록에서 볼트 2개가 반환됩니다. `Marker`에 볼트 ARN이 포함되어 있으므로 다른 볼트 목록 조회 요청에서 페이지 매김이 계속 됩니다.

```
 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: 497	
 6. 
 7. {
 8.   "Marker": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault3",
 9.   "VaultList": [ 
10.    {
11.     "CreationDate": "2012-03-16T22:22:47.214Z",
12.     "LastInventoryDate": "2012-03-21T22:06:51.218Z",
13.     "NumberOfArchives": 2,
14.     "SizeInBytes": 12334,
15.     "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault1",
16.     "VaultName": "examplevault1"
17.    }, 
18.    {
19.     "CreationDate": "2012-03-19T22:06:51.218Z",
20.     "LastInventoryDate": "2012-03-21T22:06:51.218Z",
21.     "NumberOfArchives": 0,
22.     "SizeInBytes": 0,
23.     "VaultARN": "arn:aws:glacier:us-west-2:012345678901:vaults/examplevault2",
24.     "VaultName": "examplevault2"
25.    }
26.   ]
27. }
```

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

 
+ [볼트 만들기(PUT vault)](api-vault-put.md)
+ [볼트 삭제(DELETE vault)](api-vault-delete.md)
+ [작업 시작(POST jobs)](api-initiate-job-post.md)
+ [Amazon Glacier의 ID 및 액세스 관리(IAM)](security-iam.md)

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

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

# 볼트에서 태그 삭제(POST tags remove)
<a name="api-RemoveTagsFromVault"></a>

이 작업에서는 볼트에 연결되어 있는 태그 집합에서 태그를 1개 이상 삭제합니다. 태그에 대한 자세한 내용은 [Amazon Glacier 리소스에 태그 지정](tagging.md) 섹션을 참조하세요.

이 작업은 멱등성을 갖습니다. 볼트에 연결되어 있는 태그가 없더라도 작업은 성공적으로 실행됩니다.

## 요청 구문
<a name="api-RemoveTagsFromVault-RequestSyntax"></a>

볼트에서 태그를 삭제하려면 다음 구문 예제와 같이 HTTP POST 요청을 태그 URI로 전송합니다.

```
POST /AccountId/vaults/vaultName/tags?operation=remove HTTP/1.1
Host: glacier.Region.amazonaws.com
Date: Date
Authorization: SignatureValue
Content-Length: Length
x-amz-glacier-version: 2012-06-01
{
   "TagKeys": [
      "string",
      "string"
   ]
}
```

 

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

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


|  이름  |  설명  |  필수  | 
| --- | --- | --- | 
|  operation=remove  |  [볼트에 태그 추가(POST tags add)](api-AddTagsToVault.md)와 구분할 목적으로 `remove` 값이 추가된 단일 쿼리 문자열 파라미터 `operation`입니다.  |  예  | 

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

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

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

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

 

**TagKeys**  
태그 키 목록입니다. 해당하는 태그가 각각 볼트에서 삭제됩니다.  
 *유형:* 문자열 배열  
 *길이 제한:* 목록의 최소 항목 수 1개. 목록의 최대 항목 수 10개  
 *필수 항목 여부*: 예

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

작업이 성공하면 서비스가 비어있는 HTTP 본문과 함께 HTTP `204 No Content` 응답을 다시 전송합니다.

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

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

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

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

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

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

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

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

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

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

다음은 HTTP POST 요청을 전송하여 지정한 태그를 삭제하는 예제입니다.

```
 1. POST /-/vaults/examplevault/tags?operation=remove 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. {
 9.    "TagsKeys": [
10.       "examplekey1",
11.       "examplekey2"
12.    ]        
13. }
```

### 응답의 예
<a name="api-RemoveTagsFromVault-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-RemoveTagsFromVault"></a>

 
+ [볼트에 태그 추가(POST tags add)](api-AddTagsToVault.md)

 
+ [볼트의 태그 목록 조회(GET tags)](api-ListTagsForVault.md)

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

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

# 볼트 액세스 정책 설정(PUT access-policy)
<a name="api-SetVaultAccessPolicy"></a>

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

이 작업에서는 볼트 액세스 정책을 구성하여 기존 정책을 덮어씁니다. 볼트 액세스 정책을 구성하려면 `PUT` 요청을 볼트의 `access-policy` 하위 리소스에 전송합니다. 볼트마다 액세스 정책 1개를 설정할 수 있으며, 정책 크기는 최대 20KB로 제한됩니다. 볼트 액세스 정책에 대한 자세한 내용은 [볼트 액세스 정책](vault-access-policy.md) 섹션을 참조하세요.

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

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

볼트 액세스 정책을 설정하려면 다음 구문 예제와 같이 HTTP `PUT` 요청을 볼트의 `access-policy` 하위 리소스 URI로 전송합니다.

```
 1. PUT /AccountId/vaults/vaultName/access-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를 지정하거나 선택적으로 단일 '`-`'(하이픈)를 지정할 수 있습니다.이 경우 Amazon Glacier는 요청에 서명하는 데 사용되는 자격 증명과 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 사용하는 경우 ID에 하이픈('-')을 포함할 수 없습니다.

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

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

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

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

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

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

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

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

정책이 허용되면 Amazon Glacier가 응답으로 `204 No Content`를 반환합니다.

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

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

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

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

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

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

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

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

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

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

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

```
1. PUT /-/vaults/examplevault/access-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-owner-access-rights\",\"Effect\":\"Allow\",\"Principal\":{\"AWS\":\"arn:aws:iam::999999999999:root\"},\"Action\":\"glacier:DeleteArchive\",\"Resource\":\"arn:aws:glacier:us-west-2:999999999999:vaults/examplevault\"}]}"}
```

### 응답의 예
<a name="api-SetVaultAccessPolicy-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-SetVaultAccessPolicy"></a>

 
+ [볼트 액세스 정책 삭제(DELETE access-policy)](api-DeleteVaultAccessPolicy.md)

 
+ [볼트 액세스 정책 가져오기(GET access-policy)](api-GetVaultAccessPolicy.md)

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

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

# 볼트 알림 구성 설정(PUT notification-configuration)
<a name="api-vault-notifications-put"></a>

## 설명
<a name="api-vault-notifications-put-description"></a>

Amazon Glacier(Amazon Glacier)에서 아카이브 및 볼트 인벤토리 가져오기는 비동기식 작업이기 때문에 먼저 작업을 시작하여 완료될 때까지 기다린 후에 작업 출력을 다운로드해야 합니다. 작업이 완료되었을 때 알림 메시지를 Amazon Simple Notification Service(Amazon SNS) 토픽에 게시하도록 볼트를 구성할 수 있습니다. 이 작업을 사용하여 볼트에 대한 알림 구성을 설정할 수 있습니다. 자세한 내용은 [Amazon Glacier의 볼트 알림 구성](configuring-notifications.md) 단원을 참조하십시오.

볼트 알림을 구성하려면 PUT 요청을 볼트의 `notification-configuration` 하위 리소스에 전송합니다. 알림 구성은 볼트에 따라 다르기 때문에 볼트 하위 리소스라고 불리기도 합니다. 요청에는 Amazon Simple Notification Service(Amazon SNS) 토픽을 제공하는 JSON 문서와 Amazon Glacier가 알림 메시지를 토픽에 전송할 이벤트가 포함되어야 합니다.

다음과 같은 볼트 이벤트에 대해 알림 메시지를 게시하도록 볼트를 구성할 수 있습니다.

 
+ **`ArchiveRetrievalCompleted`**: 이 이벤트는 아카이브 가져오기로 시작된 작업이 완료되었을 때 발생합니다([작업 시작(POST jobs)](api-initiate-job-post.md)). 완료된 작업은 상태는 `Succeeded` 또는 `Failed`가 될 수 있습니다. SNS 토픽으로 전송되는 알림 메시지는 [작업 설명(GET JobID)](api-describe-job-get.md)에서 반환되는 출력과 동일합니다.
+ **`InventoryRetrievalCompleted`**: 이 이벤트는 인벤토리 가져오기로 시작된 작업이 완료되었을 때 발생합니다([작업 시작(POST jobs)](api-initiate-job-post.md)). 완료된 작업은 상태는 `Succeeded` 또는 `Failed`가 될 수 있습니다. SNS 토픽으로 전송되는 알림 메시지는 [작업 설명(GET JobID)](api-describe-job-get.md)에서 반환되는 출력과 동일합니다.

Amazon SNS 토픽은 알림 메시지를 해당 토픽 게시할 수 있도록 반드시 볼트에 권한을 부여해야 합니다.

## Requests
<a name="api-vault-notifications-put-requests"></a>

볼트에 대한 알림 구성을 설정하려면 PUT 요청을 볼트의 `notification-configuration` 하위 리소스 URI로 전송합니다. 구성은 요청 본문에서 지정하며, Amazon SNS 토픽 이름을 비롯해 각 토픽으로 알림 메시지를 트리거하는 이벤트들의 배열이 포함됩니다.

### 구문
<a name="api-vault-notifications-put-requests-syntax"></a>

```
 1. PUT /AccountId/vaults/VaultName/notification-configuration HTTP/1.1
 2. Host: glacier.Region.amazonaws.com
 3. Date: Date
 4. Authorization: SignatureValue
 5. x-amz-glacier-version: 2012-06-01
 6. 
 7. {
 8.    "SNSTopic": String,
 9.    "Events":[String, ...] 
10. }
```

 

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

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

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

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

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

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

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

**이벤트**  
Amazon Glacier가 알림 메시지를 전송하는 하나 이상의 이벤트의 배열입니다.  
*유효한 값*: `ArchiveRetrievalCompleted` \$1 `InventoryRetrievalCompleted`   
*필수 항목 여부*: 예  
*유형*: 배열

**SNSTopic**  
Amazon SNS 토픽 ARN입니다. 자세한 내용은 **Amazon Simple Notification Service 시작 가이드의 [Amazon SNS 시작하기](https://docs.aws.amazon.com/sns/latest/gsg/Welcome.html)를 참조하세요.  
*필수 항목 여부*: 예  
*유형*: 문자열

## 응답
<a name="api-vault-notifications-put-responses"></a>

알림 구성이 허용되면 Amazon Glacier(Amazon Glacier)가 응답으로 `204 No Content`를 반환합니다.

### 구문
<a name="api-vault-notifications-put-responses-elements"></a>

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

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

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

### 응답 본문
<a name="api-vault-notifications-put-responses-body"></a>

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

### 오류
<a name="api-vault-notifications-put-responses-errors"></a>

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

## 예제
<a name="api-vault-notifications-put-examples"></a>

다음은 볼트 알림 구성 방법을 설명한 예제입니다.

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

다음 요청은 `examplevault` 알림 구성을 설정하여 두 개의 이벤트(`ArchiveRetrievalCompleted`와 `InventoryRetrievalCompleted`) 알림이 Amazon SNS 토픽 `arn:aws:sns:us-west-2:012345678901:mytopic`으로 전송되게 합니다.

```
 1. PUT /-/vaults/examplevault/notification-policy 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.    "Events": ["ArchiveRetrievalCompleted", "InventoryRetrievalCompleted"],
 9.    "SNSTopic": "arn:aws:sns:us-west-2:012345678901:mytopic"       
10. }
```

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

요청이 성공하면 응답으로 `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:00:00 GMT
```

## 관련 섹션
<a name="related-sections-vault-notifications-put"></a>

 
+ [볼트 알림 가져오기(GET notification-configuration)](api-vault-notifications-get.md)
+ [볼트 알림 삭제(DELETE notification-configuration)](api-vault-notifications-delete.md)
+ [Amazon Glacier의 ID 및 액세스 관리(IAM)](security-iam.md)

## 참고
<a name="api-vault-notifications-put_SeeAlso"></a>

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