Configura el sitio web del depósito

Cuando se crean, los depósitos no tienen establecida ninguna configuración del sitio web. A fin de establecer o modificar la configuración del sitio web para un depósito existente, realiza una solicitud PUT que esté dentro del depósito y usa el parámetro de string de consulta websiteConfig. Debes incluir un documento XML en el cuerpo de la solicitud que contiene la configuración del sitio web que deseas aplicar.

Debes tener el permiso FULL_CONTROL para establecer o modificar la configuración del sitio web de un depósito existente. También debes autenticarte para usar el método de depósito PUT.

Si quieres obtener más información sobre cómo usar un depósito para alojar un sitio web estático, incluidas otras opciones a fin de configurar el sitio web, consulta Aloja un sitio web estático.

Parámetros de string de consulta

Parámetro Descripción Obligatorio
websiteConfig Usa esto para cambiar la configuración del sitio web en un depósito existente. Debes proporcionar el documento WebsiteConfiguration en el cuerpo de la solicitud. No

Consulta los parámetros de string de consulta de URL firmados para obtener información sobre los parámetros que incluyes cuando creas y usas URL firmadas.

Solicita encabezados

Consulta encabezados de solicitud comunes.

Elementos de cuerpo de la solicitud

Los siguientes elementos del cuerpo de la solicitud solo se aplican si usas el parámetro de string de consulta websiteConfig para especificar una configuración del sitio web de un depósito existente.

Elemento Descripción
WebsiteConfiguration Es un contenedor para la configuración del sitio web.
MainPageSuffix Un sufijo de nombre de objeto para simular el comportamiento del índice del directorio. Debe ser un nombre de objeto válido. Opcional.
NotFoundPage Nombre del objeto que se mostrará con las respuestas 404. Debe ser un nombre de objeto válido. Opcional.

Sintaxis de la solicitud

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

Encabezados de respuesta

La solicitud puede mostrar una variedad de encabezados de respuesta según los encabezados de la solicitud que uses.

Elementos del cuerpo de la respuesta

La respuesta no incluye un documento XML en el cuerpo de la respuesta.

Ejemplo

Solicitud

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>

Respuesta

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