버킷 웹사이트 설정

버킷 생성 시 버킷에는 웹사이트 구성이 설정되어 있지 않습니다. 기존 버킷의 웹사이트 구성을 설정하거나 수정하려면 버킷으로 범위가 지정된 PUT 요청을 수행하고 websiteConfig 쿼리 문자열 매개변수를 사용합니다. 적용하려는 웹사이트 구성이 포함된 요청 본문에 XML 문서를 포함해야 합니다.

기존 버킷의 웹사이트 구성을 설정하거나 수정하려면 FULL_CONTROL 권한이 있어야 합니다. 또한 PUT 버킷 메서드를 사용하도록 인증을 받아야 합니다.

버킷을 사용해 웹사이트 웹사이트를 설정하는 다른 옵션을 포함하여 정적 웹사이트를 호스팅하는 방법에 대한 자세한 내용은 정적 웹사이트 호스팅을 참조하세요.

쿼리 문자열 매개변수

매개변수 설명 필수
websiteConfig 기존 버킷의 웹사이트 구성을 변경하는 데 이 매개변수를 사용합니다. 웹사이트 구성 문서를 요청 본문에 제공해야 합니다. 없음

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

요청 헤더

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

요청 본문 요소

websiteConfig 쿼리 문자열 매개변수를 사용하여 기존 버킷의 웹사이트 구성을 지정하는 경우에만 다음 요청 본문 요소가 적용됩니다.

요소 설명
WebsiteConfiguration 웹사이트 구성을 위한 컨테이너입니다.
MainPageSuffix 디렉터리 색인 동작을 시뮬레이션하는 객체 이름 서픽스입니다. 유효한 객체 이름이어야 합니다. 선택사항.
NotFoundPage 404 응답으로 반환할 객체의 이름입니다. 유효한 객체 이름이어야 합니다. 선택사항.

요청 구문

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

XML_DOCUMENT_DEFINING_WEBSITE_CONFIG

응답 헤더

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

응답 본문 요소

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

요청

PUT /?websiteConfig HTTP/1.1
Host: storage.googleapis.com
Content-Length: 156
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg

<WebsiteConfiguration>
  <MainPageSuffix>index.html</MainPageSuffix>
  <NotFoundPage>404.html</NotFoundPage>
</WebsiteConfiguration>

응답

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