Set bucket labels

To add or modify labels applied to a bucket, you make a PUT request that is scoped to the desired bucket, and you use the tagging query string parameter along with a <Tagging> element in the request body.

Query string parameters

Parameter Description Required
tagging Used when adding or modifying labels applied to a bucket. If used, include the labels in the body of the request. No

Request headers

See common request headers.

Request body elements

The following request body elements are applicable only if you use the tagging query string parameter to set the labels that are applied to the bucket.

Element Description
Tagging The container for TagSet.
TagSet The container for all labels that are applied to the bucket.
Tag A container for an individual label. A label is composed of a key:value pair.
Key The key for a label.
Value The value for a label.

Request syntax

The following syntax applies to PUT Bucket requests that use the tagging query string parameter.

PUT /?tagging HTTP/1.1
Host: <bucket>.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>

Response headers

The request can return a variety of response headers depending on the request headers you use.

Response body elements

The response does not include an XML document in the response body.

Example

The following example sets a label configuration that consists of two labels to a bucket named my-bucket.

Request

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>

Response

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
이 페이지가 도움이 되었나요? 평가를 부탁드립니다.

다음에 대한 의견 보내기...

도움이 필요하시나요? 지원 페이지를 방문하세요.