Définir les paiements du demandeur

Par défaut, la fonctionnalité de paiements du demandeur n'est pas activée dans les buckets. Pour activer ou désactiver les paiements du demandeur pour un bucket existant, exécutez une requête PUT limitée au bucket et utilisez le paramètre de chaîne de requête billing. Vous devez inclure un document XML dans le corps de la requête, indiquant si vous souhaitez activer ou désactiver cette fonctionnalité. Vous ne pouvez pas définir les paiements du demandeur sur un nouveau bucket que vous créez.

Vous devez disposer de l'autorisation storage.buckets.update pour activer ou désactiver les paiements du demandeur pour un bucket existant.

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

Paramètre Description Requis
billing Utilisé lors de l'activation ou de la désactivation des paiements du demandeur pour un bucket. En cas d'utilisation dans une requête de bucket PUT, le corps de la requête doit spécifier l'état activé ou désactivé. Non

Pour en savoir plus sur les paramètres à inclure lors de la création et de l'utilisation d'URL signées, consultez la section Paramètres des chaînes de requête d'URL signée.

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 billing pour activer ou désactiver les paiements du demandeur pour un bucket existant.

Élément Description
BillingConfiguration Conteneur des demandeurs.
RequesterPays État à appliquer à la fonctionnalité "Paiements du demandeur" Les valeurs acceptées sont Enabled et Disabled.

Syntaxe des requêtes

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>

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

L'exemple suivant active les paiements du demandeur pour un bucket nommé my-bucket.

Requête

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>

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