**이 페이지는 볼트와 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 tags add)
이 작업에서는 지정한 태그를 볼트에 추가합니다. 각 태그는 키와 값으로 구성됩니다. 각 볼트는 최대 50개까지 태그를 가질 수 있습니다. 볼트의 태그 제한을 초과하는 요청일 경우에는 `LimitExceededException` 오류가 반환됩니다.
지정한 키 아래의 볼트에 태그가 이미 있는 경우에는 기존 키 값을 덮어쓰게 됩니다. 태그에 대한 자세한 내용은 [Amazon Glacier 리소스에 태그 지정](tagging.md) 섹션을 참조하세요.
## 요청 구문
태그를 볼트에 추가하려면 다음 구문 예제와 같이 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에 하이픈('-')을 포함하지 않습니다.
## 요청 파라미터
| 이름 | 설명 | 필수 |
| --- | --- | --- |
| operation=add | [볼트에서 태그 삭제(POST tags remove)](api-RemoveTagsFromVault.md)와 구분할 목적으로 `add` 값이 포함된 단일 쿼리 문자열 파라미터 `operation`입니다. | 예 |
### 요청 헤더
이 작업은 모든 작업에 일반적인 요청 헤더만 사용합니다. 일반적인 요청 헤더에 대한 내용은 [공통 요청 헤더](api-common-request-headers.md) 섹션을 참조하세요.
### 요청 본문
요청 본문에는 다음의 JSON 필드가 포함됩니다.
**태그**
볼트에 추가할 태그입니다. 각 태그는 키와 값으로 구성됩니다. 값은 빈 문자열일 수도 있습니다.
*유형:* 문자열 간 맵
*길이 제한:* 최소 길이 1. 최대 길이 10
*필수 항목 여부*: 예
## 응답
작업 요청이 성공하면 서비스가 HTTP `204 No Content` 응답을 반환합니다.
### 구문
```
HTTP/1.1 204 No Content
x-amzn-RequestId: x-amzn-RequestId
Date: Date
```
### 응답 헤더
이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 [공통 응답 헤더](api-common-response-headers.md) 섹션을 참조하세요.
### 응답 본문
이 작업은 응답 본문을 반환하지 않습니다.
### 오류
Amazon Glacier 예외 및 오류 메시지에 대한 자세한 내용은 [오류 응답](api-error-responses.md) 섹션을 참조하세요.
## 예시
### 요청 예시
다음 예에서는 볼트에 추가할 태그와 함께 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. }
```
### 응답의 예
요청이 성공하면 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
```
## 관련 섹션
+ [볼트의 태그 목록 조회(GET tags)](api-ListTagsForVault.md)
+ [볼트에서 태그 삭제(POST tags remove)](api-RemoveTagsFromVault.md)
## 참고
언어 특정 Amazon SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.
+ [AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/reference/glacier/add-tags-to-vault.html)