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

이번 작업에서는 볼트에 연결되어 있는 태그 집합에서 태그를 1개 이상 삭제합니다. 태그에 대한 자세한 내용은 Amazon S3 Glacier 리소스에 태그 지정 단원을 참조하세요.

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

요청 구문

볼트에서 태그를 삭제하려면 다음 구문 예제와 같이 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 S3 Glacier는 요청 서명에 사용된 보안 인증 정보와 연결된 AWS 계정 ID를 사용합니다. 계정 ID를 지정하는 경우 ID에 하이픈('-')을 포함하지 않습니다.

요청 파라미터

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

요청 헤더

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

요청 본문

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

TagKeys

태그 키 목록입니다. 해당하는 태그가 각각 볼트에서 삭제됩니다.

유형: 문자열 배열

길이 제한: 목록의 최소 항목 수 1개. 목록의 최대 항목 수 10개

필수 항목 여부: 예

응답

작업이 성공하면 서비스가 비어있는 HTTP 본문과 함께 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=remove 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
			
{
   "TagsKeys": [
      "examplekey1",
      "examplekey2"
   ]        
}

응답의 예

요청이 성공하면 Amazon S3 Glacier(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

관련 단원

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

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

참고 항목

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

• AWS Command Line Interface