볼트에 태그 추가(POST tags add) - Amazon S3 Glacier
요청 구문요청 파라미터응답예시관련 단원참고 항목

이 페이지는 Vaults와 2012RESTAPI년의 원본을 사용하는 S3 Glacier 서비스의 기존 고객만 사용할 수 있습니다.

아카이브 스토리지 솔루션을 찾고 있다면 Amazon S3, S3 Glacier Instant Retrieval , S33 S3 Glacier Flexible Retrieval 및 S3 Glacier Deep Archive 의 S3 Glacier 스토리지 클래스를 사용하는 것이 좋습니다. Amazon S3 이러한 스토리지 옵션에 대한 자세한 내용은 Amazon S3 사용 설명서의 S3 Glacier 스토리지 클래스 및 S3 Glacier 스토리지 클래스를 사용하는 장기 데이터 스토리지를 참조하세요. Amazon S3 이러한 스토리지 클래스는 Amazon S3 를 사용하며API, 모든 리전에서 사용할 수 있고, Amazon S3 콘솔 내에서 관리할 수 있습니다. 스토리지 비용 분석, 스토리지 렌즈, 고급 선택적 암호화 기능 등과 같은 기능을 제공합니다.

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

볼트에 태그 추가(POST tags add)

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

지정한 키의 태그가 이미 볼트에 존재하는 경우에는 기존 키 값을 덮어쓰게 됩니다. 태그에 대한 자세한 내용은 Amazon S3 Glacier 리소스에 태그 지정 단원을 참조하세요.

요청 구문

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

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

참고

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

요청 파라미터

이름 설명 필수
operation=add

operation와 구분할 목적으로 add 값이 추가된 단일 쿼리 문자열 파라미터 볼트에서 태그 삭제(POST tags remove)입니다.

 예

요청 헤더

이 작업은 모든 작업에 일반적인 요청 헤더만 사용합니다. 일반적인 요청 헤더에 대한 내용은 공통 요청 헤더 단원을 참조하십시오.

요청 본문

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

태그

볼트에 추가할 태그입니다. 각 태그는 키와 값으로 구성됩니다. 값은 빈 문자열일 수도 있습니다.

유형: 문자열 간 맵

길이 제한: 최소 길이 1. 최대 길이 10

필수 항목 여부: 예

응답

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

조건

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

응답 헤더

이 작업은 대부분의 응답에 일반적인 응답 헤더만 사용합니다. 일반적인 응답 헤더에 대한 내용은 공통 응답 헤더 단원을 참조하십시오.

응답 본문

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

오류

Amazon S3 Glacier의 예외 및 오류 메시지에 대한 자세한 내용은 오류 응답 단원을 참조하세요.

예시

예 요청

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

POST /-/vaults/examplevault/tags?operation=add HTTP/1.1
Host: glacier.us-west-2.amazonaws.com
x-amz-Date: 20170210T120000Z
Authorization: AWS4-HMAC-SHA256 Credential=AKIAIOSFODNN7EXAMPLE/20141123/us-west-2/glacier/aws4_request,SignedHeaders=host;x-amz-date;x-amz-glacier-version,Signature=9257c16da6b25a715ce900a5b45b03da0447acf430195dcb540091b12966f2a2
Content-Length: length
x-amz-glacier-version: 2012-06-01
			
{
  "Tags": 
    {
       "examplekey1": "examplevalue1",
       "examplekey2": "examplevalue2"
    }        
}

응답의 예

요청이 성공하면 S3 Glacier가 다음 예제와 같이 HTTP 204 No Content를 반환합니다.

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

참고 항목

언어 특정 Amazon SDK 중 하나에서 이 API를 사용하는 방법에 대한 자세한 내용은 다음을 참조하세요.