Obtenir les paiements du demandeur de bucket

Pour renvoyer l'état des paiements du demandeur d'un bucket, vous devez envoyer une requête GET ciblée au bucket souhaité et utiliser le paramètre de chaîne de requête billing. L'état du bucket est renvoyé dans un document XML dans le corps de la réponse.

Vous devez disposer de l'autorisation storage.buckets.get pour vérifier l'état des paiements du demandeur pour un bucket.

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

Paramètre Description Requis
billing Utilisez cette méthode pour renvoyer l'état des paiements du demandeur pour le bucket. 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

Cette requête n'inclut pas de document XML dans le corps de la requête.

Syntaxe des requêtes

La syntaxe suivante s'applique aux requêtes de bucket GET utilisant le paramètre de chaîne de requête billing.

GET /?billing HTTP/1.1
Host: BUCKET_NAME.storage.googleapis.com
Date: DATE
Content-Length: 0
Authorization: AUTHENTICATION_STRING

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

Les éléments de corps de réponse suivants ne s'appliquent que si vous utilisez le paramètre de chaîne de requête billing pour obtenir l'état de la fonctionnalité des paiements du demandeur pour le bucket.

Élément Description
BillingConfiguration Conteneur des demandeurs.
RequesterPays État de la fonctionnalité "Paiements du demandeur". L'état indiqué est Enabled ou Disabled.

Exemple

L'exemple suivant récupère l'état des paiements du demandeur pour un bucket nommé my-bucket. Dans cet exemple, les paiements du demandeur sont activés sur le bucket.

Requête

GET /?billing HTTP/1.1
Host: my-bucket.storage.googleapis.com
Date: Thu, 24 Jan 2016 02:34:56 GMT
Content-Length: 0
Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg

Réponse

HTTP/1.1 200 OK
Date: Thu, 24 Jan 2016 02:34:56 GMT
Expires: Mon, 01 Jan 1990 00:00:00 GMT
Cache-Control: no-cache, no-store, must-revalidate
Content-Length: 121
Content-Type: text/html

<?xml version="1.0" encoding="UTF-8"?>
<BillingConfiguration>
  <RequesterPays>Enabled</RequesterPays>
</BillingConfiguration>