버킷 요청자 지불 설정

기본적으로 버킷에 요청자 지불이 사용 설정되어 있지 않습니다. 기존 버킷에 대한 요청자 지불을 사용 설정하거나 사용 중지하려면 버킷으로 범위가 지정된 PUT 요청을 만들고 billing 쿼리 문자열 매개변수를 사용합니다. 요청 본문에 이 기능을 사용 설정 또는 중지할지 여부를 나타내는 XML 문서를 포함해야 합니다. 현재 생성 중인 새 버킷에 요청자 지불을 설정할 수 없습니다.

기존 버킷의 요청자 지불을 사용 설정 또는 사용 중지하려면 storage.buckets.update 권한이 있어야 합니다.

쿼리 문자열 매개변수

매개변수 설명 필수
billing 버킷의 요청자 지불을 사용 설정하거나 사용 중지할 때 사용됩니다. PUT 버킷 요청에 사용할 경우 요청 본문은 사용 또는 사용 중지 상태를 지정해야 합니다. 없음

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

요청 헤더

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

요청 본문 요소

billing 쿼리 문자열 매개변수를 사용하여 기존 버킷에 요청자 지불을 사용 설정하거나 사용 중지하는 경우에만 다음 요청 본문 요소를 적용할 수 있습니다.

요소 설명
BillingConfiguration RequesterPays의 컨테이너입니다.
RequesterPays 요청자 지불 기능에 적용할 상태입니다. 허용되는 값은 EnabledDisabled입니다.

요청 구문

PUT /?billing 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"?>
<BillingConfiguration>
  <RequesterPays>
     Enabled | Disabled
  </RequesterPays>
</BillingConfiguration>

응답 헤더

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

응답 본문 요소

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

다음 샘플은 my-bucket라는 버킷에 요청자 지불을 사용 설정합니다.

요청

PUT /?billing HTTP/1.1
Host: my-bucket.storage.googleapis.com
Date: Thu, 12 Mar 2012 03:38:42 GMT
Content-Length: 121
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg

<?xml version="1.0" encoding="UTF-8"?>
<BillingConfiguration>
  <RequesterPays>Enabled</RequesterPays>
</BillingConfiguration>

응답

HTTP/1.1 200 OK
Date: Thu, 12 Mar 2012 03:38:42 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