볼트에 태그 추가(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

관련 단원

• 볼트의 태그 목록 조회(GET tags)

• 볼트에서 태그 삭제(POST tags remove)

참고 항목

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

• AWS Command Line Interface