Definir site do bucket

No momento da criação, os buckets não têm nenhuma configuração de site definida. Para definir ou modificar a configuração do site de um bucket atual, faça uma solicitação PUT com escopo para o bucket e use o parâmetro de string de consulta websiteConfig. Você precisa incluir um documento XML no corpo da solicitação que contém a configuração do site que você quer aplicar.

Você precisa ter a permissão FULL_CONTROL para definir ou modificar a configuração do site de um bucket atual. Além disso, você precisa estar autenticado para usar o método PUT do bucket.

Para mais informações sobre como usar um bucket para hospedar um site estático, incluindo outras opções para definir a configuração do site, consulte Como hospedar um site estático.

Parâmetros de string de consulta

Parâmetro Descrição Obrigatório
websiteConfig Use isso para alterar a configuração do site em um bucket existente. Você precisa fornecer o documento WebsiteConfiguration no corpo da solicitação. Não

Consulte parâmetros de string de consulta de URL assinado para informações sobre os parâmetros incluídos ao criar e usar URLs assinados.

Cabeçalhos de solicitação

Veja cabeçalhos de solicitação comuns.

Elementos do corpo da solicitação

Os elementos do corpo da solicitação a seguir são aplicáveis somente se você usar o parâmetro de string de consulta websiteConfig para especificar uma configuração de site para um bucket existente.

Element Descrição
WebsiteConfiguration Contêiner para configuração.
MainPageSuffix Um sufixo de nome de objeto para simular o comportamento do índice de diretórios. Precisa ser um nome de objeto válido. Opcional.
NotFoundPage Nome do objeto a ser retornado com respostas 404. Precisa ser um nome de objeto válido. Opcional.

Sintaxe da solicitação

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

Cabeçalhos de resposta

A solicitação pode retornar diversos cabeçalhos de resposta, dependendo dos cabeçalhos de solicitação usados.

Elementos do corpo da resposta

A resposta não inclui um documento XML no corpo da resposta.

Exemplo

Solicitação

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>

Resposta

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