버킷 라벨 설정

버킷에 적용된 라벨을 추가하거나 수정하려면 원하는 버킷으로 범위가 지정된 PUT 요청을 수행하고 tagging 쿼리 문자열 매개변수를 사용합니다. 요청 본문에 <Tagging> 요소와 함께 광고를 표시합니다.

참고: 만들 때PUT 요청tagging 쿼리 문자열 매개변수에 기존 버킷 라벨이PUT 요청

쿼리 문자열 매개변수

매개변수	설명	필수
tagging	버킷에 적용된 라벨을 추가하거나 수정할 때 사용됩니다. 이 속성을 사용하는 경우 요청 본문에 라벨을 포함합니다.	없음

서명된 URL을 만들고 사용할 때 포함되는 매개변수에 대한 정보는 서명된 URL 쿼리 문자열 매개변수를 참조하세요.

요청 헤더

일반적인 요청 헤더를 참조하세요.

요청 본문 요소

tagging 쿼리 문자열 매개변수를 사용하여 버킷에 적용되는 라벨을 설정하는 경우에만 다음 요청 본문 요소가 적용됩니다.

요소	설명
Tagging	TagSet의 컨테이너입니다.
TagSet	버킷에 적용된 모든 라벨의 컨테이너입니다.
Tag	개별 라벨의 컨테이너입니다. 라벨은 key:value 쌍으로 구성됩니다.
Key	라벨의 키입니다.
Value	라벨의 값입니다.

요청 구문

tagging 쿼리 문자열 매개변수를 사용하는 PUT 버킷 요청에는 다음 구문이 적용됩니다.

PUT /?tagging HTTP/1.1
Host: BUCKET_NAME.storage.googleapis.com
Date: DATE
Content-Length: REQUEST_BODY_LENGTH
Authorization: AUTHENTICATION_STRING

<?xml version="1.0" encoding="UTF-8"?>
<Tagging>
  <TagSet>
     <Tag>
       <Key>LABEL_KEY</Key>
       <Value>LABEL_VALUE</Value>
     </Tag>
  </TagSet>
</Tagging>

응답 헤더

이 요청은 사용 중인 요청 헤더에 따라 다양한 응답 헤더를 반환할 수 있습니다.

응답 본문 요소

응답의 응답 본문에 XML 문서가 없습니다.

예

다음 예시에서는 라벨 두 개로 구성된 라벨 my-bucket로 구성된 라벨 구성을 설정합니다.

요청

PUT /?tagging HTTP/1.1
Host: my-bucket.storage.googleapis.com
Date: Thu, 24 Jan 2016 02:34:56 GMT
Content-Length: 196
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg

<?xml version="1.0" encoding="UTF-8"?>
<Tagging>
  <TagSet>
     <Tag>
       <Key>environment</Key>
       <Value>production</Value>
     </Tag>
     <Tag>
       <Key>billing</Key>
       <Value>marketing-department</Value>
     </Tag>
  </TagSet>
</Tagging>

응답

HTTP/1.1 200 OK
Date: Thu, 24 Jan 2016 02:34:56 GMT
Expires: Mon, 01 Jan 1990 00:00:00 GMT
Cache-Control: no-cache, no-store, must-revalidate
Content-Length: 0
Content-Type: text/html