Définir le site Web du bucket

Lors de leur création, aucune configuration de site Web n'est définie pour les buckets. Pour définir ou modifier la configuration de site Web d'un bucket existant, exécutez une requête PUT qui est limitée au bucket et utilisez le paramètre de chaîne de requête websiteConfig. Vous devez inclure un document XML dans le corps de la requête contenant la configuration du site Web que vous souhaitez appliquer.

Vous devez disposer de l'autorisation FULL_CONTROL pour définir ou modifier la configuration du site Web pour un bucket existant. De plus, vous devez être authentifié pour utiliser la méthode de bucket PUT.

Pour en savoir plus sur l'utilisation d'un bucket pour héberger un site Web statique, ainsi que sur d'autres options de configuration de votre site Web, consultez la page Héberger un site Web statique.

Paramètres de la chaîne de requête

Paramètre Description Requis
websiteConfig Il permet de modifier la configuration d'un site Web dans un bucket existant. Vous devez indiquer le document WebsiteConfiguration dans le corps de la requête. Non

Consultez la section Paramètres de la chaîne de requête d'URL signée pour en savoir plus sur les paramètres que vous incluez lors de la création et de l'utilisation d'URL signées.

En-têtes de requête

Voir les en-têtes de requêtes courants.

Éléments du corps de la requête

Les éléments de corps de requête suivants ne sont disponibles que si vous utilisez le paramètre de chaîne de requête websiteConfig pour spécifier une configuration de site Web pour un bucket existant.

Élément Description
WebsiteConfiguration Conteneur de configuration de site Web.
MainPageSuffix Suffixe du nom d'objet pour simuler le comportement de l'index de répertoire. Vous devez saisir un nom d'objet valide. Facultatif.
NotFoundPage Nom de l'objet à renvoyer avec des réponses 404. Vous devez saisir un nom d'objet valide. Facultatif.

Syntaxe des requêtes

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

En-têtes de réponse

La requête peut renvoyer divers en-têtes de réponse en fonction des en-têtes de requête que vous utilisez.

Éléments du corps de la réponse

La réponse n'inclut pas de document XML dans le corps de la réponse.

Exemple

Requête

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>

Réponse

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