En-têtes HTTP et paramètres de chaîne de requête pour l'API XML

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

L'API XML de Cloud Storage utilise plusieurs en-têtes HTTP standards ainsi que plusieurs en-têtes HTTP d'extension (personnalisés). Plusieurs des méthodes HTTP acceptent également les paramètres de chaîne de requête. Les en-têtes et les paramètres sont décrits ci-dessous.

Récapitulatif des en-têtes HTTP et des paramètres de chaîne de requête

L'API XML utilise les en-têtes HTTP standards suivants:

Requête Réponse Les deux
Autorisation
Content-MD5
Hôtes
If-Match
If-Modified-Since
If-None-Match
If-Unchanged-Since
ETag
Dernière modification
Lieu
Contrôle du cache
Disposition du contenu
Encodage de contenu
Langue du contenu
Longueur du contenu
Plage de contenu
Type de contenu
Date
Portées
Encodage de transfert

L'API XML utilise les en-têtes HTTP (extension) personnalisés suivants:

Requête Réponse Les deux
x-goog-acl
x-goog-api-version
x-goog-bucket-retention-period
x-goog-content-length-range
x-goog-content-sha256
x-goog-copy-source
x-goog-copy-source-generation
x-goog-copy-source-if-generation-match
x-goog-copy-source-if-match
x-goog-copy-source-if-metageneration-match
x-goog-copy-source-if-modified-depuis
x-goog-copy-source-if-none-match
x-goog-copy-source-if-unmodified-du
x-goog-date
x-goog-encryption-key
x-goog-encryption-kms-key-name
x-goog-if-generation-match
x-goog-if-metageneration-match
x-goog-metadata-directive
x-goog-project-id
x-goog-resumable
x-goog-user-project
x-goog-component-count
x-goog-expiration
x-goog-generation
x-goog-metageneration
x-goog-stored-content-encoding
x-goog-stored-content-length
x-goog-custom-time
x-goog-encryption-algorithm
x-goog-encryption-key-sha256
X-goog-hash
x-goog-meta-
x-goog-storage-class

L'API XML utilise les paramètres de chaîne de requête suivants:

ID de clé d'accès
acl
Action (Action)
facturation
rédiger
Cors
defaultObjectAcl
délimiteur
type-encodage
chiffrement
encryptionConfig
génération
marqueur de génération
cycle de vie emplacement
journalisation
repère
Repère
clés max.
MaxItems
préfixe
réponse-contenu-disposition
type-contenu-réponse-type
État
classe de stockage
création de balises
upload_id [id_importation]
Nom d'utilisateur
projetutilisateur
gestion des versions
versions
Configuration du site Web
Algorithme X-Goog
Identifiant X-Goog
Date X-Goog
X-Goog-Expires
X-Goog-SignedHeaders
Signature X-Goog

En-têtes HTTP standards

Autorisation

Un en-tête de requête contenant une chaîne permettant d'authentifier les requêtes.

Valeurs correctes Un identifiant d'authentification ( Bearer | GOOG1 | AWS ) suivi de l'un des éléments suivants :
  • Un jeton OAuth 2.0 valide
  • Une clé d'accès
  • Une signature
Exemple Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s- ...
Détails Pour en savoir plus sur l'utilisation de cet en-tête, consultez la page Authentification.

Remarque : Si vos requêtes sont acheminées via un proxy, vous devrez peut-être contacter votre administrateur réseau pour vous assurer que l'en-tête Authorization contenant vos identifiants est : qui n'ont pas été supprimées par le proxy. Sans l'en-tête Authorization, vous recevez une erreur MissingSecurityHeader et votre requête est refusée. Pour en savoir plus sur l'accès à Cloud Storage via un serveur proxy, consultez la page Dépannage.

Cache-Control

Un en-tête de requête et de réponse qui spécifie le paramètre de contrôle du cache

Valeurs correctes Toute valeur de contrôle du cache valide (voir la spécification)
Exemple Cache-Control: public, max-age=6000
Détails Vous ne devez spécifier le contrôle du cache que pour les objets accessibles à tous les utilisateurs anonymes. Pour être accessible de manière anonyme, la LCA d'un objet doit accorder l'autorisation READ ou FULL_CONTROL à AllUsers. Si un objet est accessible à tous les utilisateurs anonymes et que vous ne spécifiez pas de paramètre de contrôle du cache, Cloud Storage applique un paramètre de contrôle du cache de 3 600 secondes. Lors de la diffusion via XML, Cloud Storage respecte le contrôle du cache de l'objet tel que défini par ses métadonnées.

Content-Disposition

Un en-tête de requête et de réponse qui spécifie les informations de présentation sur les données transmises.

Valeurs correctes Toute valeur de disposition de contenu valide (voir la spécification).
Exemple Content-Disposition: attachment; filename=FILENAME
Détails Si vous définissez l'en-tête Content-Disposition lors de l'importation d'un objet, il sera diffusé au moment du téléchargement (et a ensuite été interprété par les navigateurs Web et les autres clients HTTP). L'utilisation courante de Content-Disposition est la définition de attachment;filename=FILENAMEt, ce qui provoque généralement l'ouverture d'une boîte de dialogue "Enregistrer sous..." dans le navigateur Web.

Content-Encoding

Un en-tête de requête et de réponse qui spécifie l'algorithme de compression d'un objet.

Valeurs correctes Tout algorithme de compression valide (voir la spécification)
Exemple Content-Encoding: gzip
Détails Cloud Storage ne compresse ni ne décompresse les objets. Si vous utilisez cet en-tête pour spécifier un algorithme de compression (par exemple, deflate), Cloud Storage conserve l'en-tête, mais ne compresse pas ni décompresse l'objet.

Content-Language

Code de langue ISO 639-1 du contenu.

Valeurs correctes Consultez la colonne ISO 639-1 de la page Codes pour la représentation des noms de langues pour obtenir la liste des codes de langue.
Exemple Content-Language: en

Longueur du contenu

Longueur (en octets) du corps de la requête ou de la réponse.

Valeurs correctes Toute valeur égale ou supérieure à zéro.
Exemple Content-Length: 1234
Détails Cela est nécessaire pour toutes les requêtes, à l'exception de celles utilisant l'encodage de transfert fragmenté (voir spécifications). Si vous n'utilisez pas l'encodage de transfert fragmenté et que vous n'incluez pas l'en-tête Content-Length dans une requête, la requête échoue et Cloud Storage répond avec un code d'état 411 Longueur requise.

Content-MD5

Condensé MD5 du corps de la requête.

Valeurs correctes Un condensé MD5 valide.
Exemple Content-MD5: iB94gawbwUSiZy5FuruIOQ==
Détails Consultez les spécifications. Cloud Storage peut utiliser cette fonctionnalité pour vérifier l'intégrité d'une opération PUT.

Plage de contenu

En-tête de requête ou de réponse qui spécifie une plage d'octets.

Valeurs correctes Toute plage d'octets valide.
Exemple Content-Range: bytes 456-987/1234
Détails

Lorsqu'elle apparaît dans une réponse, l'en-tête Content-Range indique la plage d'octets renvoyés en réponse à une requête incluant un en-tête Range.

Lorsqu'elle est incluse dans une requête d'importation avec reprise, la méthode Content-Range permet d'interroger la position actuelle de l'importation ou un indicateur du point de départ de Le bloc de données en cours d'importation dans la requête en cours.

Les plages d'octets sont incluses ; C'est-à-dire que bytes 0-999 représente les 1 000 premiers octets d'un fichier ou d'un objet.

Pour plus d'informations, en particulier sur les réponses de téléchargement, consultez la spécification.

Content-Type

Type MIME de la requête ou de la réponse.

Valeurs correctes Tout type MIME valide (voir la spécification).
Exemple Content-Type: text/html
Détails Si vous ne spécifiez pas de type de contenu lorsque vous importez un objet, le système Cloud Storage utilise application/octet-stream par défaut lors de la diffusion de l'objet.

Date

Date et heure de la requête ou de la réponse.

Valeurs correctes Date et heure représentées au format HTTP traditionnel (voir la spécification).
Exemple Date: Wed, 16 Jun 2010 11:11:11 GMT
Détails Lorsqu'il est utilisé pour créer des URL signées à l'aide du processus de signature V2, il doit être au format HTTP traditionnel. Reportez-vous à la section 7.1.1.2 du spécification. Lorsque vous utilisez le processus de signature V4, le format doit être au format de base ISO 8601 YYYYMMDD'T'HHMMSS'Z'.

ETag

Un en-tête de réponse qui contient le tag d'entité de l'objet auquel vous accédez.

Valeurs correctes Chaîne de caractères entourée par des guillemets. Pour en savoir plus, consultez la section Bonnes pratiques concernant les hachages et les ETags.
Exemples ETag: "39a59594290b0f9a30662a56d695b71d"
ETag: "-CKicn4fknbUCEAE="
Détails Consultez les spécifications.

Hôte

Un en-tête de requête qui spécifie l'URI de Cloud Storage.

Valeurs correctes Format de l'URI valide.
Exemple Host: storage.googleapis.com
Détails Pour en savoir plus sur les URI valides, consultez les pages Points de terminaison de requêtes et Spécifications de l'hôte.

If-Match

Un en-tête de requête qui spécifie un tag d'entité (ETag).

Valeurs correctes Un tag d'entité valide.
Exemple If-Match: "881f7881ac1bc144a2672e45babb8839"
Détails Vous ne pouvez spécifier qu'un seul tag d'entité (et non une liste de tags d'entité séparés par une virgule). Vous pouvez utiliser cet en-tête avec les méthodes "HEAD Object" et "GET Object". Si l'ETag que vous spécifiez avec cet en-tête est identique à l'ETag de l'objet, les métadonnées ou l'objet sont renvoyés. Si l'ETag que vous spécifiez avec cet en-tête est différent de l'ETag de l'objet, les métadonnées ou l'objet ne sont pas renvoyés et Cloud Storage renvoie une412 Échec des conditions préalables. Pour plus d'informations, consultez les spécifications.

If-Modified-Since

Un en-tête de requête qui spécifie une date et une heure.

Valeurs correctes Date et heure représentées au format HTTP traditionnel.
Exemple If-Modified-Since: Fri, 19 Feb 2010 22:04:23 GMT
Détails Vous pouvez utiliser cet en-tête avec les méthodes HEAD et Object Object. Si un objet a été modifié après la date et l'heure que vous spécifiez avec cet en-tête, les métadonnées ou l'objet sont renvoyés. Si un objet a été modifié avant la date et l'heure que vous spécifiez avec cet en-tête, les métadonnées ou l'objet ne sont pas renvoyés et Cloud Storage renvoie une erreur 304 non modifiée..

Pour plus d'informations sur l'en-tête If-Modified-Since, consultez la spécification. Pour plus d'informations sur les formats de date HTTP, consultez la spécification, section 7.1.1.2.

If-None-Match

Un en-tête de requête qui spécifie un tag d'entité (ETag).

Valeurs correctes Un tag d'entité valide.
Exemple If-None-Match: "881f7881ac1bc144a2672e45babb8839"
Détails Vous pouvez utiliser cet en-tête avec les méthodes HEAD et Object Object. Si l'ETag que vous spécifiez avec cet en-tête est différent de l'ETag de l'objet, les métadonnées ou l'objet sont renvoyés. Si l'ETag que vous spécifiez avec cet en-tête est identique à l'ETag de l'objet, les métadonnées ou l'objet ne sont pas renvoyés et Cloud Storage renvoie une erreur 304 Not Modified. Pour plus d'informations, consultez les spécifications.

If-Unchanged-Since

Un en-tête de requête qui spécifie une date et une heure.

Valeurs correctes Date et heure représentées au format HTTP traditionnel.
Exemple If-Unmodified-Since: Fri, 19 Feb 2010 22:04:23 GMT
Détails Vous pouvez utiliser cet en-tête avec les méthodes HEAD et Object Object. Si l'objet n'a pas été modifié après la date spécifiée dans cet en-tête, les métadonnées ou l'objet sont renvoyés. Si l'objet a été modifié après la date spécifiée dans cet en-tête, les métadonnées ou l'objet ne sont pas renvoyés et Cloud Storage renvoie une erreur 412 Precondition Failed.

Pour plus d'informations sur l'en-tête If-Unmodified-Since, consultez la spécification. Pour plus d'informations sur les formats de date HTTP, consultez la spécification, section 7.1.1.2.

Dernière modification

Un en-tête de réponse contenant la date et l'heure de dernière modification de l'objet.

Valeurs correctes Date et heure représentées au format HTTP traditionnel.
Exemple Last-Modified: Fri, 19 Feb 2010 22:04:23 GMT
Détails Pour plus d'informations sur l'en-tête Last-Modified, consultez la spécification. Pour plus d'informations sur les formats de date HTTP, consultez la spécification, section 7.1.1.2.

Emplacement

Un en-tête de réponse est utilisé à plusieurs fins:

  • En réponse à une importation avec reprise, vous obtenez un URI de session pour une opération d'importation avec reprise.
  • En réponse à une requête d'authentification basée sur les cookies, elle fournit une URL de réponse d'origine Web unique pour la requête.
  • En réponse à une requête de téléchargement d'API JSON effectuée sur une URL autre que www.googleapis.com/download, elle fournit une redirection vers l'URL de l'API JSON où le téléchargement peut être effectué.
Valeurs correctes Tout URI valide.
Exemple Location: https://example.storage.googleapis.com/?upload_id=tvA0...rot
Détails L'en-tête de réponse Location est renvoyé lorsque vous lancez une importation avec reprise.

Plage

Un en-tête de requête indiquant la plage d'octets que vous souhaitez afficher et un en-tête de réponse indiquant la plage d'octets importés dans le système Cloud Storage.

Valeurs correctes Toute plage d'octets contigu..
Exemples Range: bytes=0-1999 (2 000 premiers octets)
Range: bytes=-2000 (2 000 derniers octets)
Range: bytes=2000- (de l'octet 2000 à la fin du fichier)
Détails

Lorsqu'elle est incluse dans l'en-tête d'une requête de données d'objet, seule la plage d'octets spécifiée pour l'objet est renvoyée, ce qui est utile lors de la reprise des importations interrompues. Une requête valide et réussie renvoie un code de réponse 206 Partial Content. Sachez que dans certaines circonstances, l'en-tête de requête range est ignoré.

Lorsque la requête est renvoyée dans le cadre d'une réponse associée à une importation avec reprise, Range indique le nombre d'octets actuellement importés. Vous pouvez ensuite utiliser ces informations pour continuer l'importation.

Les plages d'octets sont incluses. Par exemple, bytes=0-999 représente les 1 000 premiers octets d'un fichier ou d'un objet. Pour en savoir plus sur cet en-tête, consultez les spécifications.

Encodage de transfert

Un en-tête de requête et de réponse qui spécifie si le corps du message a été appliqué au codage de transfert.

Valeurs correctes chunked
Exemple Transfer-Encoding: chunked
Détails Cet en-tête indique si le corps de message d'une requête ou d'une réponse a été fragmenté. Si c'est le cas, le serveur diffuse le contenu dans une série de fragments, avec un bloc final d'une longueur égale à zéro. Si vous spécifiez l'option Transfer-Encoding: Chunked, vous n'avez pas besoin de spécifier Content-Length. Cela peut s'avérer utile si vous ne connaissez pas à l'avance la longueur du corps du message, par exemple lors d'une importation en streaming. Pour en savoir plus sur les encodages de transfert, consultez les spécifications. Pour plus d'informations sur l'encodage de transfert fragmenté, consultez la spécification.

En-têtes HTTP (extension) personnalisés

x-goog-acl

Un en-tête de requête qui applique des LCA prédéfinies (analysées) à un bucket ou à un objet lorsque vous l'importez ou le créez.

Valeurs correctes Pour les buckets: project-private, private, public-read, public-read-write, authenticated-read

Pour les objets: project-private, private, bucket-owner-read, bucket-owner-full-control, public-read, authenticated-read

Exemple x-goog-acl: private
Détails Lorsqu'un utilisateur importe un objet ou crée un bucket sans spécifier de LCA, la LCA private est appliquée. Pour en savoir plus sur les LCA prédéfinies, consultez la page Contrôle des accès.

x-goog-api-version

Cet en-tête est obsolète et n'est pas utilisé.

x-goog-bucket-retention-period

Un en-tête de requête qui ajoute une règle de conservation à un nouveau bucket.

Valeurs correctes Entier compris entre 1 et 3 155 760 000.
Exemple x-goog-bucket-retention-period: 32000
Détails Cet en-tête de requête ne peut être utilisé que lors de la création d'un bucket. Lorsque l'en-tête est inclus, le nouveau bucket obtient une règle de conservation déverrouillée d'une durée, en secondes, déterminée par la valeur de cet en-tête.

x-goog-component-count

Un en-tête de réponse indiquant le nombre de composants qui composent un objet composite.

Valeurs correctes Entier supérieur ou égal à 1.
Exemple x-goog-component-count: 32
Détails Cet en-tête de réponse n'est renvoyé que si l'objet auquel vous accédez est un objet composite. L'en-tête renvoie le nombre de composants qui composent l'objet.

x-goog-content-length-range

Un en-tête de requête PUT. S'il est utilisé, Cloud Storage n'accepte la requête que si la taille du contenu de la requête se situe dans la plage spécifiée de l'en-tête.

Valeurs correctes Paire MIN,MAX
Exemple x-goog-content-length-range: 0,256
Détails Les valeurs de taille de contenu sont incluses et transmises en octets. Si la taille du contenu de la requête se situe dans la plage spécifiée, le contenu est envoyé comme demandé. Si la taille du contenu de la requête se situe en dehors de la plage spécifiée, la requête échoue et un code 400 Bad Request est renvoyé dans la réponse. Si x-goog-content-length-range est utilisé dans une requête autre que PUT, l'en-tête est ignoré sans notification.

x-goog-content-sha256

Un en-tête de requête qui contient un hachage du corps de la requête.

Valeurs correctes Hachage en hexadécimal, encodé en hexadécimal, en SHA-256 ou UNSIGNED-PAYLOAD.
Exemple x-goog-content-sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
Détails Cet en-tête est obligatoire pour les requêtes qui utilisent une signature dans l'en-tête Authorization. x-goog-content-sha256 doit correspondre à la valeur que vous avez utilisée pour la partie de charge utile de votre requête canonique.

x-goog-copy-source

Un en-tête de requête qui spécifie le bucket et l'objet source pour une opération de copie.

Valeurs correctes Un chemin d'accès /BUCKET_NAME/OBJECT_NAME
Exemple x-goog-copy-source: travel-maps/paris.jpg
Détails Cet en-tête de requête spécifie le chemin d'accès à l'objet source. Un chemin valide doit inclure le bucket et l'objet, séparés par une barre oblique (/). Notez que le chemin de l'objet source doit être une URL légale. Il doit donc être encodée en pourcentage.

Pour utiliser cet en-tête, vous devez disposer de l'autorisation READ sur l'objet source et au minimum de l'autorisation WRITE sur le bucket de destination.

Si les objets source et de destination sont identiques (y compris la génération), la copie est traitée comme une mise à jour des métadonnées. Pour en savoir plus sur le contrôle du comportement de mise à jour et de remplacement, consultez x-goog-metadata-directive.

x-goog-copy-source-generation

Un en-tête de requête qui spécifie la génération de l'objet à copier.

Valeurs correctes Tout nombre positif (valeur 64 bits)
Exemple x-goog-copy-source-generation: 1360044097839000
Détails Cet en-tête de requête peut être utilisé avec x-goog-copy-source pour spécifier la génération de l'objet à copier. Elle n'est pas valide sans l'en-tête x-goog-copy-source. Si aucune génération de l'objet source n'existe, Cloud Storage renvoie le code d'état 404 Not Found.

Si les objets source et de destination sont identiques (y compris la génération), la copie est traitée comme une mise à jour des métadonnées. Pour plus d'informations sur le contrôle du comportement de mise à jour et de remplacement, consultez x-goog-metadata-directive.

x-goog-copy-source-if-generation-match

Un en-tête de requête qui spécifie la requête de copie correspondante ne sera exécuté que si l'objet source x-goog-generation correspond à la valeur spécifiée. Cet en-tête n'est valide que lorsqu'il est utilisé avec x-goog-copy-source.

Valeurs correctes Tout nombre positif (valeur 64 bits)
Exemple x-goog-copy-source-if-generation-match: 1360044097835000
Détails Cet en-tête de requête ne peut être utilisé pour copier de manière conditionnelle l'objet source que s'il possède la génération spécifiée. Si la génération ne correspond pas, Cloud Storage renvoie un code d'erreur 412 Precondition Failed.

Pour plus d'informations, consultez la page Utiliser les versions d'objet.

x-goog-copy-source-if-match

Un en-tête de requête qui spécifie les conditions d'une opération de copie.

Valeurs correctes Un tag d'entité (ETag)
Exemple x-goog-copy-source-if-match: 53fc311c15eda0a031809982ccf92aac
Détails Vous ne pouvez spécifier qu'un seul tag d'entité (et non une liste de tags d'entité séparés par une virgule). Cet en-tête de requête ne peut être utilisé que si vous effectuez une opération de copie avec l'en-tête de requête x-goog-copy-source. Si l'ETag que vous spécifiez avec cet en-tête de requête correspond à l'ETag de l'objet source, l'opération de copie se poursuit. Si l'ETag ne correspond pas, Cloud Storage renvoie un code d'erreur 412 Precondition Failed.

x-goog-copy-source-if-metageneration-match

Un en-tête de requête qui spécifie la requête correspondante n'est autorisé que si l'objet metageneration de l'objet source correspond à la valeur de cet en-tête.

Valeurs correctes Tout nombre positif (valeur 64 bits)
Exemple x-goog-copy-source-if-metageneration-match: 4
Détails Si la métagénération d'objets source correspond à l'en-tête x-goog-copy-source-if-metageneration-match, la requête aboutit et Google Cloud Storage renvoie l'état HTTP 200 OK. Si la métagénération ne correspond pas, Cloud Storage renvoie un code d'erreur 412 Precondition Failed.

Cette valeur ne peut être utilisée qu'avec x-goog-copy-source-if-generation-match ou x-goog-copy-source-generation. Si vous ne l'utilisez pas, vous obtenez un code d'erreur d'argument non valide HTTP 400 BadRequest.

Pour plus d'informations, consultez la page Utiliser les versions d'objet.

x-goog-copy-source-if-modified-depuis

Un en-tête de requête qui spécifie les conditions d'une opération de copie.

Valeurs correctes Date et heure représentées au format HTTP traditionnel.
Exemple x-goog-copy-source-if-modified-since: Fri, 19 Feb 2010 14:05:04 GMT
Détails Cet en-tête de requête ne peut être utilisé que si vous effectuez une opération de copie avec l'en-tête de requête x-goog-copy-source. Si la date et l'heure que vous spécifiez sont antérieures à la date Last-Modified de l'objet source, l'objet est copié. Si la date et l'heure sont ultérieures, Cloud Storage renvoie un code d'erreur 412 Precondition Failed.

Pour plus d'informations sur l'en-tête HTTP If-Modified-Since (qui autre que la source de copie, s'applique à ce cas d'utilisation), consultez la spécification. Pour plus d'informations sur les formats de date HTTP, consultez la spécification, section 7.1.1.2

x-goog-copy-source-if-none-match

Un en-tête de requête qui spécifie les conditions d'une opération de copie.

Valeurs correctes Un tag d'entité (ETag)
Exemple x-goog-copy-source-if-none-match: 53fc311c15eda0a031809982ccf92aac
Détails Cet en-tête de requête ne peut être utilisé que si vous effectuez une opération de copie avec l'en-tête de requête x-goog-copy-source. Si l'ETag que vous spécifiez avec cet en-tête de requête ne correspond pas à l'ETag de l'objet source, l'opération de copie se poursuit. Si l'ETag correspond, Cloud Storage renvoie un code d'erreur 412 Precondition Failed. Pour plus d'informations sur l'en-tête HTTP If-None-Match (différent de la source de copie, s'applique à ce cas d'utilisation), consultez la spécification.

x-goog-copy-source-if-unmodified-du

Un en-tête de requête qui spécifie les conditions d'une opération de copie.

Valeurs correctes Date et heure représentées au format HTTP traditionnel.
Exemple x-goog-copy-source-if-unmodified-since: Fri, 19 Feb 2010 14:05:04 GMT
Détails Cet en-tête de requête ne peut être utilisé que si vous effectuez une opération de copie avec l'en-tête de requête x-goog-copy-source. Si la date et l'heure que vous spécifiez sont postérieures à la date Last-Modified de l'objet source, l'objet est copié. Si la date et l'heure sont antérieures, Cloud Storage renvoie un code d'erreur 412 Precondition Failed.

Pour plus d'informations sur l'en-tête HTTP If-Unmodified-Since (qui autre que la source de copie, s'applique à ce cas d'utilisation), consultez la spécification. Pour plus d'informations sur les formats de date HTTP, consultez la spécification, section 7.1.1.2.

x-goog-custom-time

Un en-tête de requête et de réponse pour les métadonnées d'objets d'horodatage personnalisées

Valeurs correctes Date et heure représentées au format RFC 3339.
Exemple x-goog-custom-time: 2020-04-12T23:20:50.52Z
Détails Cet en-tête peut être inclus lors des requêtes PUT ou POST. La valeur que vous spécifiez dans l'en-tête est stockée avec l'objet et est renvoyée dans un en-tête de réponse lorsque vous effectuez une requête GET ou HEAD sur l'objet. La durée personnalisée d'un objet est généralement utilisée avec la gestion du cycle de vie des objets.

x-goog-date

Un en-tête de requête qui spécifie l'horodatage pour les requêtes authentifiées.

Valeurs correctes Date et heure représentées au format HTTP traditionnel.
Exemple x-goog-date: Fri, 19 Feb 2010 14:05:04 GMT
Détails Lorsqu'il est utilisé pour créer des URL signées à l'aide du processus de signature V2, il doit être au format HTTP traditionnel. Reportez-vous à la section 7.1.1.2 du spécification. Lorsque vous utilisez le processus de signature V4, le format doit être au format de base ISO 8601 YYYYMMDD'T'HHMMSS'Z'.

x-goog-encryption-algorithm

Un en-tête de requête et de réponse qui spécifie l'algorithme de chiffrement à utiliser.

Valeurs correctes AES256
Exemple x-goog-encryption-algorithm: AES256
Détails Cet en-tête de requête et de réponse est utilisé lorsque vous fournissez des clés de chiffrement fournies par le client.

x-goog-encryption-key

En-tête de requête qui spécifie une clé de chiffrement AES-256.

Valeurs correctes Chaîne au format Base64 RFC 4648 d'une clé de chiffrement AES-256 valide
Exemple x-goog-encryption-key: NwbyGGmcKAX4FxGpOERG2Ap33m5NVOgmXznSGTEvG0I=
Détails Cet en-tête de requête est utilisé lorsque vous fournissez des clés de chiffrement fournies par le client.

x-goog-encryption-key-sha256

Un en-tête de requête et de réponse qui spécifie le hachage SHA256 de la clé de chiffrement.

Valeurs correctes Chaîne au format Base64 RFC 4648 d'un hachage SHA256 valide pour une clé de chiffrement.
Exemple x-goog-encryption-key-sha256: +eBzkZBt1Mj2CZx69L3c8yXoZB6DtRLlSvXMJB9JGIQ=
Détails Cet en-tête de requête est utilisé lorsque vous fournissez des clés de chiffrement fournies par le client.

x-goog-encryption-kms-key-name

Un en-tête de requête qui spécifie une clé de chiffrement Cloud KMS.

Valeurs correctes Une ressource de clé de chiffrement Cloud KMS
Exemple x-goog-encryption-kms-key-name: projects/my-project/locations/us-east1/keyRings/my-keyring/cryptoKeys/my-key
Détails Cet en-tête de requête est utilisé lorsque vous souhaitez chiffrer un objet spécifique avec une clé de chiffrement gérée par le client.

x-goog-expiration

Un en-tête de réponse qui spécifie à quel moment l'objet consulté sera supprimé, conformément à la configuration du cycle de vie.

Valeurs correctes Date et heure représentées au format HTTP traditionnel.
Exemple x-goog-expiration: Tue, 25 June 2013 00:00:00 GMT
Détails Cet en-tête de réponse n'est renvoyé que pour les objets d'un bucket dans lequel la gestion du cycle de vie est activée si certaines conditions sont remplies. Pour en savoir plus, consultez la section Comportement du cycle de vie des objets.

x-goog-generation

Un en-tête de réponse indiquant la version des données d'objet auxquelles vous accédez.

Valeurs correctes Tout nombre positif (valeur 64 bits)
Exemple x-goog-generation: 1360044097835000
Détails Chaque fois qu'un objet est créé ou remplacé, Cloud Storage lui attribue automatiquement une génération. La génération change à chaque remplacement des données d'objets. Cependant, il n'existe aucune relation définie entre les générations sur différents objets.

Pour plus d'informations, consultez la page Utiliser les versions d'objet.

x-goog-if-generation-match

Un en-tête de requête qui spécifie la requête correspondante n'est autorisé que si l'élément x-goog-generation de l'objet correspond à la valeur de cet en-tête.

Valeurs correctes Zéro ou n'importe quel nombre positif (valeur 64 bits)
Exemple x-goog-if-generation-match: 1360044097835000
Détails Si la génération d'objets correspond à l'en-tête x-goog-if-generation-match, la requête aboutit et Google Cloud Storage renvoie l'état HTTP 200 OK. Si la génération ne correspond pas, Google Cloud Storage renvoie un code d'erreur HTTP 412 Precondition Failed.

Si vous définissez l'en-tête x-goog-if-generation-match sur 0, Google Cloud Storage n'effectue la requête spécifiée que si l'objet n'existe pas actuellement. Par exemple, vous pouvez effectuer une requête PUT pour créer un objet avec un objet x-goog-if-generation-match. L'objet n'est créé que s'il n'existe pas déjà en tant que version active. Si l'objet existe, la requête est annulée.

Pour plus d'informations, consultez la page Utiliser les versions d'objet.

x-goog-if-metageneration-match

Un en-tête de requête qui spécifie la requête correspondante n'est autorisé que si l'élément x-goog-metageneration de l'objet correspond à la valeur de cet en-tête.

Valeurs correctes Tout nombre positif (valeur 64 bits)
Exemple x-goog-if-metageneration-match: 4
Détails Si la métagénération d'objets correspond à l'en-tête x-goog-if-metageneration-match, la requête aboutit et Google Cloud Storage renvoie l'état HTTP 200 OK. Si la métagénération ne correspond pas, Cloud Storage renvoie un code d'erreur HTTP 412 Precondition Failed.

Cet en-tête de requête ne doit être utilisé qu'avec l'en-tête x-goog-if-generation-match pour garantir que les mises à jour des métadonnées sont effectivement effectuées par rapport à la génération de l'objet que vous effectuer la mise à jour. Vous pouvez donc effectuer des opérations de lecture-modification-écriture en toute sécurité.

Pour plus d'informations, consultez la page Utiliser les versions d'objet.

x-goog-metadata-directive

Un en-tête de requête qui spécifie la gestion des métadonnées lors d'une opération de copie.

Sachez que les listes de contrôle d'accès aux objets (lorsqu'elles sont présentes) ne sont jamais copiées. Le cas échéant, le nouvel objet reçoit les LCA spécifiées dans l'en-tête de la requête x-goog-acl ou les listes de contrôle d'accès aux objets par défaut définies pour le bucket contenant le nouvel objet.

Valeurs correctes COPY | REPLACE
Exemple x-goog-metadata-directive: REPLACE
Détails

Utilisé uniquement avec l'en-tête de requête x-goog-copy-source. La valeur par défaut est COPY.

Si vous spécifiez COPY, les métadonnées de l'objet source sont appliquées à l'objet nouvellement créé.

Si vous spécifiez REPLACE, l'opération applique les métadonnées fournies dans la requête à l'objet nouvellement créé.

Lorsque vous copiez un objet de sorte qu'il réécrit l'objet source, vous devez inclure x-goog-metadata-directive: REPLACE. L'en-tête est facultatif dans tous les autres cas.

x-goog-metageneration

Un en-tête de réponse indiquant la version des métadonnées d'objet auxquelles vous accédez.

Valeurs correctes Tout nombre positif (valeur 64 bits)
Exemple x-goog-metageneration: 1
Détails Chaque fois qu'un objet est créé ou remplacé, Cloud Storage attribue automatiquement une métagénération de 1. La métagénération augmente à chaque mise à jour des métadonnées de l'objet (mise à jour des LCA ou autres mises à jour de métadonnées). Ainsi, une métagénération plus importante implique toujours une version plus récente des métadonnées de l'objet. Cependant, il n'existe aucune relation définie entre différentes générations sur différents objets, ni même entre différentes générations d'un même objet. Chaque génération de l'objet possède sa propre version de métagénération propre à sa génération.

Pour en savoir plus, consultez la page Utiliser les versions d'objet.

X-goog-hash

Un en-tête de requête et de réponse pour exprimer les sommes de contrôle encodées en base64 MD5 et/ou CRC32C d'un objet. En tant qu'en-tête de requête pour les requêtes d'importation, les hachages fournis sont validés par rapport aux valeurs calculées par Cloud Storage.

Valeurs correctes md5=BASE64_ENCODED_MD5 ou crc32c=BASE64_ENCODED_CRC32C. Spécifiez les valeurs CRC32c dans l'ordre des octets de grande taille. Notez également que HTTP considère que les valeurs d'en-têtes sont séparées par une virgule comme l'équivalent d'en-têtes distincts avec des clés identiques.
Exemples x-goog-hash: crc32c=n03x6A==
x-goog-hash: md5=Ojk9c3dhfxgoKVVHYwFbHQ==
x-goog-hash: crc32c=n03x6A==,md5=Ojk9c3dhfxgoKVVHYwFbHQ==
Détails Cloud Storage stocke les hachages MD5 pour tous les objets non composites. Les CRC32C sont disponibles pour tous les objets.

x-goog-meta-

Un en-tête de requête et de réponse vous permettant de définir des métadonnées personnalisées pour un objet.

Valeurs correctes Tout nom d'en-tête valide.
Exemple x-goog-meta-reviewer: jane
Détails Pour utiliser cet en-tête, vous devez ajouter le nom de votre en-tête personnalisé au préfixe x-goog-meta-, puis ajouter l'en-tête et sa valeur associée à votre requête PUT ou POST. Par exemple, si vos objets sont associés à différents projets, vous pouvez ajouter des informations spécifiques à un projet à vos métadonnées en créant plusieurs en-têtes de requête, tels que: x-goog-meta-project-name. x-goog-meta-project-number et x-goog-meta-project-manager. Vous pouvez ensuite définir une valeur pour ces en-têtes de requête lors d'une requête PUT ou POST, comme illustré dans l'exemple suivant:

PUT /kitten.jpg HTTP/1.1
Host: my-bucket.storage.googleapis.com
Date: Wed, 17 Jun 2020 11:11:11 GMT
Content-Type: image/jpg
Content-Length: 554
Authorization: Bearer 1/zVNpoQNsOSxZKqOZgckhpQ
x-goog-meta-project-name: Sales Projections
x-goog-meta-project-number: 878973
x-goog-meta-project-manager: W. Loman
    

Les en-têtes x-goog-meta- sont stockés avec un objet et sont toujours renvoyés dans un en-tête de réponse lorsque vous effectuez une requête GET ou HEAD sur un objet. L'utilisation des en-têtes comme métadonnées personnalisées entraîne des frais, comme indiqué dans la section Tarifs et assistance.

Remarque:Tous les en-têtes personnalisés et les valeurs associées ne doivent contenir que des caractères US-ASCII imprimables.

Remarque:Nous vous recommandons de limiter la taille totale des en-têtes personnalisés à quelques Ko.

x-goog-project-id

Un en-tête de requête qui indique le projet sur lequel vous travaillez.

Valeurs correctes Tout nom ou numéro de projet valide
Exemples x-goog-project-id: 000111222333
x-goog-project-id: my-project-name
x-goog-project-id: example.com:my-google-apps-for-work-project-name
Détails Cet en-tête de requête indique à Cloud Storage dans lequel créer un bucket ou pour quel projet répertorier les buckets. Il est facultatif pour ces tâches si vous avez défini un projet par défaut pour l'accès interopérable.

x-goog-resumable

Un en-tête de requête qui lance une opération d'importation avec reprise.

Valeurs correctes start
Exemple x-goog-resumable: start
Détails Cet en-tête de requête informe le système Cloud Storage que vous souhaitez lancer une importation avec reprise. L'en-tête ne peut être utilisé qu'avec une requête d'objet POST pour les importations avec reprise.

x-goog-storage-class

Un en-tête de requête et de réponse indiquant la classe de stockage d'un objet

Valeurs correctes STANDARD, NEARLINE, COLDLINE, ARCHIVE, MULTI_REGIONAL et REGIONAL
Exemple x-goog-storage-class: NEARLINE
Détails Cet en-tête peut être inclus dans les requêtes PUT Object et POST Object afin de définir un objet sur une classe de stockage autre que la classe de stockage par défaut du bucket associé. L'en-tête est inclus dans toutes les réponses GET Object.

x-goog-stored-content-encoding

Un en-tête de réponse indiquant l'encodage du contenu de l'objet tel qu'il est stocké dans Cloud Storage, indépendamment de toute négociation basée sur le serveur pouvant survenir pour les requêtes individuelles de l'objet.

Valeurs correctes Le codage de contenu spécifié dans l'importation d'objets ou identity.
Exemple x-goog-stored-content-encoding: gzip
Détails Si un objet a été importé sans codage de contenu, la valeur de cet en-tête est identity.

x-goog-stored-content-length

Un en-tête de réponse indiquant la longueur du contenu (en octets) de l'objet tel qu'il est stocké dans Cloud Storage, indépendamment de toute négociation basée sur le serveur pouvant survenir pour les requêtes individuelles de l'objet.

Valeurs correctes Toute valeur d'octet égale ou supérieure à zéro.
Exemple x-goog-stored-content-length: 350
Détails Aucun

x-goog-user-project

Un en-tête de requête qui spécifie un projet utilisateur à facturer pour les frais d'accès associés à la requête.

Valeurs correctes L'ID du projet existant pour un projet Google Cloud
Exemple x-goog-user-project: my-project
Détails Le projet spécifié dans l'en-tête est facturé pour les frais associés à la requête. Cet en-tête permet par exemple d'effectuer des requêtes sur des buckets pour lesquels la fonctionnalité de paiements du demandeur est activée.

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

Dans les exemples de paramètres de chaîne de requête décrits dans cette section, les URI ne sont pas affichés, mais sont supposés être relatifs à storage.googleapis.com. Comme décrit sur la page Points de terminaison de requêtes, vous pouvez également spécifier le nom du bucket dans le cadre du nom d'hôte, par exemple BUCKET-NAME.storage.googleapis.com. Si vous spécifiez le bucket dans le nom d'hôte, n'incluez pas ce nom dans le chemin d'accès de l'URI. Par exemple, les éléments suivants permettent d'obtenir la LCA d'un objet:

  • https://storage.googleapis.com/BUCKET-NAME/object-name?acl
  • https://BUCKET-NAME.storage.googleapis.com/object-name?acl

ID de clé d'accès

Un paramètre de chaîne de requête vous permettant d'identifier la clé HMAC que vous souhaitez mettre à jour ou supprimer.

Valeurs correctes ID d'accès associé à une clé HMAC.
Exemple /?Action=UpdateAccessKey&AccessKeyId=GOOG1EXAMPLE&Status=Inactive
/?Action=DeleteAccessKey&AccessKeyId=GOOG1EXAMPLE
Détails Le paramètre de chaîne de requête AccessKeyId vous permet de spécifier la clé HMAC à mettre à jour ou à supprimer. Vous devez utiliser AccessKeyId conjointement avec le paramètre de requête Action. Pour en savoir plus sur la récupération de l'ID d'accès de votre clé HMAC, consultez la page Obtenir des informations sur la clé HMAC.

acl

Un paramètre de chaîne de requête vous permettant de récupérer ou de modifier la liste de contrôle d'accès pour un bucket ou un objet

Valeurs correctes Aucune
Exemple /BUCKET_NAME?acl
/BUCKET_NAME/OBJECT_NAME?acl
Détails Facultatif pour les requêtes suivantes: PUT Bucket, PUT Object, GET Bucket, GET Object. Si vous envoyez une requête PUT, vous devez inclure un document XML dans le corps de la requête spécifiant les LCA que vous souhaitez appliquer. Vous ne pouvez utiliser aucune sous-ressource supplémentaire avec ce paramètre de requête.

Action

Un paramètre de chaîne de requête vous permettant d'identifier l'opération clé HMAC à effectuer.

Valeurs correctes ListAccessKeys, CreateAccessKey, UpdateAccessKey, DeleteAccessKey
Exemple /?Action=ListAccessKeys
Détails LesAction qui vous permet de spécifier l'opération de clé HMAC à effectuer : list ,create ,update ou delete s'affiche en haut de l'écran.

billing

Un paramètre de chaîne de requête vous permettant d'activer, de désactiver ou de vérifier l'état de la fonctionnalité Paiements du demandeur pour un bucket

Valeurs correctes Dans le corps de la requête: Enabled, Disabled.
Exemple /BUCKET_NAME?billing
Détails Facultatif pour les requêtes suivantes: GET Bucket, PUT Bucket. Lorsqu'elle est utilisée dans une requête GET Bucket, l'état actuel de la fonctionnalité "Paiements du demandeur" est renvoyé dans le corps de la réponse. En cas d'utilisation dans une requête PUT Bucket, le corps de la requête doit contenir un élément <BillingConfiguration> qui indique s'il faut activer ou désactiver la fonctionnalité. Pour en savoir plus sur la configuration des paiements du demandeur à l'aide de l'API XML, consultez la page Définir les paiements du demandeur.

compose

Paramètre de chaîne de requête qui vous permet de composer une séquence d'objets existants dans un nouvel objet composite (utilisé uniquement avec l'API XML).

Valeurs correctes Aucune
Exemple /BUCKET_NAME/OBJECT_NAME?compose
Détails Facultatif pour les requêtes PUT Object. Un document XML de ComposeRequest doit être fourni dans le corps de la requête. Vous ne pouvez utiliser aucune sous-ressource supplémentaire avec ce paramètre de requête.

cors

Un paramètre de chaîne de requête vous permettant de récupérer ou de modifier le partage de ressources inter-origines (CORS) pour un bucket

Valeurs correctes Aucune
Exemple /BUCKET_NAME?cors
Détails Facultatif pour les requêtes suivantes: PUT Bucket, GET Bucket. Si vous envoyez une requête PUT, vous devez inclure un document XML dans le corps de la requête, qui spécifie le CORS à appliquer. Ce paramètre de requête ne peut utiliser aucune sous-ressource supplémentaire.

defaultObjectAcl

Un paramètre de chaîne de requête vous permettant de récupérer ou de modifier la liste de contrôle d'accès aux objets par défaut pour un bucket

Valeurs correctes Aucune
Exemple /BUCKET_NAME?defaultObjectAcl
Détails Facultatif pour les requêtes de bucket PUT et GET Bucket. Si vous envoyez une requête PUT, vous devez inclure un document XML dans le corps de la requête, qui spécifie la LCA qui s'applique par défaut aux nouveaux objets ajoutés au bucket. Vous ne pouvez utiliser aucune sous-ressource supplémentaire avec ce paramètre de requête. Pour en savoir plus, consultez la section Définir des LCA d'objet par défaut.

delimiter

Caractère ou groupe de caractères utilisés pour restreindre une liste d'objets lors d'une requête de bucket GET.

Valeurs correctes Caractères ou caractères Unicode
Exemple /?delimiter=/
Détails

La méthode delimiter simplifie une liste d'objets qui utilisent un schéma de nommage semblable à un répertoire. Si spécifié, les objets dont le nom ne contient pas le délimiteur sont renvoyés, comme ils le seraient normalement dans les éléments Contents de la réponse. Si un nom d'objet contient le délimiteur, la partie du nom de l'objet jusqu'à la première instance du délimiteur s'affiche dans un élément CommonPrefixes de la réponse.

Vous pouvez utiliser un opérateur delimiter avec un paramètre prefix. Dans ce cas, prefix limite les résultats aux objets dont le nom correspond à prefix.

Le champ delimiter est généralement défini sur /, mais il peut s'agir de n'importe quelle séquence de caractères. Pour obtenir un exemple d'utilisation d'un objet delimiter, consultez l'exemple de délimiteur.

type-encodage

Un paramètre de chaîne de requête permettant d'encoder les noms d'objet URL dans les réponses aux requêtes de création d'objets.

Valeurs correctes url
Exemple /bucket?encoding-type=url
Détails Facultatif lors de l'affichage des listes d'objets dans un bucket. Lorsqu'ils sont inclus dans la requête, les noms d'objet renvoyés sont encodés en URL. Ceci est utile si l'un de vos noms d'objets comprend des caractères Unicode que XML 1.0 ne peut pas analyser.

encryption

Un paramètre de chaîne de requête vous permettant de récupérer les informations de chiffrement d'un objet

Valeurs correctes Aucune
Exemple /object?encryption
Détails Facultatif pour les requêtes GET Object. Lorsque l'objet concerné est chiffré par une clé de chiffrement fournie par le client, l'algorithme de chiffrement et le SHA-256 de la clé sont renvoyés dans un élément Encryption. Lorsque l'objet interrogé est chiffré par une clé de chiffrement gérée par le client, la ressource de clé Cloud Key Management Service est renvoyée dans un élément Encryption. Dans tous les autres cas, un élément Encryption vide est renvoyé.

Vous ne pouvez utiliser aucune sous-ressource supplémentaire avec ce paramètre de requête.

encryptionConfig

Un paramètre de chaîne de requête qui vous permet de définir ou de récupérer la clé de chiffrement gérée par le client par défaut utilisée par un bucket.

Valeurs correctes Aucune
Exemple /bucket?encryptionConfig
Détails Facultatif pour les requêtes GET Bucket. Lorsque le bucket interrogée dispose d'une clé de chiffrement gérée par le client par défaut, le nom de la ressource de clé est renvoyé dans un élément EncryptionConfiguration.

Facultatif pour les requêtes Bucket PUT. Lorsque la requête inclut une ressource de clé de chiffrement gérée par le client dans le corps de la requête, cette clé devient la clé de chiffrement par défaut du bucket. Lorsque la requête inclut un élément EncryptionConfiguration vide, toute clé par défaut existante est supprimée du bucket.

génération

Valeur indiquant la génération de l'objet à récupérer.

Valeurs correctes Tout nombre positif (valeur 64 bits)
Exemple ?generation=1360887759327000
Détails Le paramètre de chaîne de requête generation vous permet de spécifier la version de l'objet sur laquelle effectuer des opérations.

marqueur de génération

Valeur indiquant le numéro de génération à partir duquel vous souhaitez qu'une liste d'objets commence.

Valeurs correctes Tout nombre positif (valeur 64 bits)
Exemple ?generation-marker=1360887759327000
Détails Le paramètre de chaîne de requête generation-marker est un point de départ pour créer des listes de pages dans des buckets avec versions gérées. Doit être utilisé conjointement avec marker pour spécifier complètement l'objet et la génération de l'élément par défaut. Toutes les versions d'objet dont la valeur est supérieure à celle generation-marker spécifiée (y compris la version en ligne si elle génère une génération plus élevée) sont renvoyées dans la liste d'objets, tout comme les objets qui sont lexicographiquement supérieurs à ceux de marker

lifecycle

Un paramètre de chaîne de requête vous permettant de récupérer ou de modifier les règles de gestion du cycle de vie d'un bucket.

Valeurs correctes Aucune
Exemple /BUCKET_NAME?lifecycle
Détails Facultatif pour les requêtes suivantes: PUT Bucket, GET Bucket. Si vous envoyez une requête PUT, vous devez inclure un document XML dans le corps de la requête, qui spécifie la configuration du cycle de vie. Vous ne pouvez utiliser aucune sous-ressource supplémentaire avec ce paramètre de requête.

emplacement

Un paramètre de chaîne de requête vous permettant de récupérer la contrainte d'emplacement pour un bucket

Valeurs correctes Aucune
Exemple /BUCKET_NAME?location
Détails Facultatif pour les requêtes suivantes: GET Bucket.

logging

Un paramètre de chaîne de requête vous permettant de récupérer ou de modifier la configuration de journalisation pour un bucket

Valeurs correctes Aucune
Exemple /BUCKET_NAME?logging
Détails Facultatif pour les requêtes suivantes: PUT Bucket, GET Bucket. Si vous envoyez une requête PUT, vous devez inclure un document XML dans le corps de la requête qui spécifie la configuration de la journalisation. Ce paramètre de requête ne peut utiliser aucune sous-ressource supplémentaire.

repère

Chaîne indiquant où vous souhaitez démarrer une liste d'objets.

Valeurs correctes N'importe quelle chaîne.
Exemple ?marker=test
Détails Le paramètre de chaîne de requête marker est une chaîne de caractères Unicode qui spécifie l'objet avec lequel vous souhaitez qu'une liste d'objets commence. La liste des objets renvoyés est celles qui sont lexicographiquement supérieures à celles du marker.

Repère

Jeton de page qui vous permet de répertorier les pages suivantes des clés HMAC.

Valeurs correctes Chaîne fournie dans une réponse list précédente si IsTruncated est true.
Exemple ?Action=ListAccessKeys&Marker=AERPALERN/NEXT/TOKEN
Détails Le paramètre de chaîne de requête Marker est un jeton de continuation, utilisé pour parcourir de grands ensembles de résultats lors de la création de listes de clés HMAC pour un projet donné. Si IsTruncated est défini sur true dans une réponse list précédente, utilisez le jeton Marker fourni dans les requêtes list suivantes jusqu'à ce que IsTruncated soit false. Vous devez utiliser Marker conjointement avec le paramètre de requête Action. Pour en savoir plus, consultez la section Obtenir la clé HMAC.

clés max.

Entier qui limite le nombre d'objets renvoyés dans un seul "page" de résultat.

Valeurs correctes Tout nombre supérieur à zéro.
Exemple ?max-keys=100
Détails Le paramètre de chaîne de requête max-keys est un entier qui spécifie le nombre maximal d'objets que vous souhaitez afficher dans une liste d'objets. Si une requête peut renvoyer plus d'objets que ne le permet max-keys, l'élément de réponse IsTruncated contient une valeur True.

MaxItems

Entier qui limite le nombre de clés HMAC renvoyées par une seule page de résultats.

Valeurs correctes Tout nombre supérieur à zéro.
Exemple ?Action=ListAccessKeys&MaxItems=100
Détails Le paramètre de chaîne de requête MaxItems est un entier qui spécifie le nombre maximal de clés HMAC renvoyées dans une seule page de résultats. Si une requête peut renvoyer plus de clés que MaxItems ne le permet, l'élément de réponse IsTruncated contient une valeur true. Vous devez utiliser MaxItems conjointement avec le paramètre de requête Action. Le service peut renvoyer moins de résultats que le maximum spécifié.

prefix

Chaîne qui limite une liste d'objets à ces objets avec un préfixe spécifique.

Valeurs correctes Tout préfixe valide.
Exemple ?prefix=/europe/france
Détails Le paramètre de chaîne de requête prefix est une chaîne de caractères Unicode qui limite la liste aux objets dont le nom commence par la valeur prefix spécifiée. Vous pouvez utiliser le paramètre de chaîne de requête prefix conjointement avec le paramètre de chaîne de requête delimiter pour créer un sous-ensemble d'objets plus petit.

réponse-contenu-disposition

Un paramètre de chaîne de requête qui permet de remplacer le contenu inclus dans les requêtes GET authentifiées.

Valeurs correctes En-tête encodé au format URL à renvoyer au lieu de la disposition du contenu de l'objet sous-jacent.
Exemple ?response-content-disposition=attachment%3B%20filename%3D%22foo%22
Détails Permet aux requêtes GET authentifiées de remplacer la disposition de contenu renvoyée dans les en-têtes.

Pour plus d'informations, consultez les spécifications.

type-contenu-réponse-type

Un paramètre de chaîne de requête qui permet de remplacer le type de contenu pour les requêtes GET authentifiées.

Valeurs correctes En-tête encodé au format URL à renvoyer au lieu du type de contenu de l'objet sous-jacent.
Exemple ?response-content-type=text%2Fhtml
Détails Permet aux requêtes GET authentifiées de remplacer la disposition de contenu renvoyée dans les en-têtes.

Pour plus d'informations, consultez les spécifications.

État

Un paramètre de chaîne de requête vous permettant d'activer ou de désactiver une clé HMAC

Valeurs correctes Active, Inactive
Exemple ?Action=UpdateAccessKey&AccessKeyId=GOOG1EXAMPLE&Status=Inactive
Détails Le paramètre de chaîne de requête Status vous permet de modifier l'état d'une clé HMAC entre Active et Inactive. Vous devez utiliser Status conjointement avec les paramètres de requête Action et AccessKeyId.

classe de stockage

Un paramètre de chaîne de requête qui vous permet de définir ou de récupérer la classe de stockage d'un bucket.

Valeurs correctes Dans le corps de la requête: STANDARD, NEARLINE, ARCHIVE, COLDLINE, MULTI_REGIONAL, REGIONAL,DURABLE_REDUCED_AVAILABILITY
Exemple /BUCKET_NAME?storageClass
Détails Facultatif pour les requêtes suivantes: GET Bucket, PUT Bucket. Lorsqu'elle est utilisée dans une requête GET Bucket, la classe de stockage du bucket spécifié est renvoyée dans le corps de la réponse. Lorsqu'elle est utilisée dans une requête PUT Bucket, le corps de la requête doit contenir un élément <StorageClass> qui spécifie la classe de stockage que vous souhaitez attribuer au bucket. Pour en savoir plus sur la définition de la classe de stockage d'un bucket à l'aide de l'API XML, consultez la page Définir la classe de stockage d'un bucket.

création de balises

Un paramètre de chaîne de requête vous permettant de définir ou de récupérer les libellés appliqués à un bucket

Valeurs correctes Dans le corps de la requête: étiquette, fournie en tant que paire key:value.
Exemple /BUCKET_NAME?tagging
Détails Facultatif pour les requêtes suivantes: GET Bucket, PUT Bucket. Lorsqu'ils sont utilisés dans une requête GET Bucket, les libellés appliqués au bucket spécifié sont renvoyés dans le corps de la réponse. Lorsqu'il est utilisé dans une requête PUT Bucket, le corps de la requête doit contenir un élément <Tagging> qui spécifie les libellés que vous souhaitez appliquer au bucket. Pour en savoir plus sur l'application de libellés à l'aide de l'API XML, consultez la page Définir des étiquettes de bucket.

upload_id [id_importation]

Un paramètre de chaîne de requête qui spécifie cet ID d'importation pour une opération d'importation avec reprise. La partie upload_id fait partie de l'URI de la session, mais vous devez enregistrer l'URI complet de la session, car elle définit l'URI de requête de manière unique pour les opérations d'importation avec reprise suivantes. L'URI de session est obtenu à partir de l'en-tête de réponse Location.

Valeurs correctes Tout ID d'importation valide.
Exemple /?upload_id=tvA0ExBntDaOKdxL46u1NkHxNb...B2Uowrot HTTP/1.1
Détails Un ID d'importation expire au bout d'une semaine. Nous vous recommandons de démarrer une importation avec reprise dès que vous obtenez l'ID d'importation et de reprendre votre importation peu après son interruption.

Si vous utilisez un ID d'importation arrivé à expiration dans une requête, vous recevrez un code d'état 404 "Introuvable". Dans ce cas, vous devez relancer l'importation avec reprise, obtenir un nouvel ID d'importation et reprendre l'importation depuis le début à l'aide de ce nouvel ID.

L'ID d'importation est lié à l'emplacement créé. Par conséquent, si vous créez un emplacement dans un emplacement et que vous l'utilisez dans un autre emplacement, vos performances seront affectées.

L'ID d'importation est un jeton de support, ce qui signifie qu'il est utilisé en tant qu'authentificateur. Par conséquent, veillez à ne pas divulguer les ID d'importation.

Nom d'utilisateur

Un paramètre de chaîne de requête vous permettant d'identifier le compte de service pour lequel vous souhaitez créer, mettre à jour ou répertorier une clé HMAC.

Valeurs correctes Adresse e-mail de compte de service valide.
Exemple /?Action=CreateAccessKey&UserName=serviceAccount@proj.iam.gserviceaccount.com
Détails La méthode UserName est requise pour créer une clé HMAC et facultative pour mettre à jour une clé ou pour répertorier les clés associées à un projet. Vous devez utiliser UserName conjointement avec le paramètre de requête Action.

projetutilisateur

Paramètre de chaîne de requête qui spécifie un ID de projet à facturer pour les frais d'accès associés à la requête.

Valeurs correctes Tout ID de projet valide.
Exemple ?userProject=example-project
Détails Le projet spécifié dans ce paramètre est facturé pour les frais associés à la requête. userProject est utilisé, par exemple, lors de l'envoi de requêtes à des buckets pour lesquels les paiements du demandeur sont activés.

En règle générale, les requêtes XML nécessitant un ID de projet doivent être fournies dans l'en-tête x-goog-user-project au lieu du paramètre userProject.

versioning

Un paramètre de chaîne de requête vous permettant de récupérer ou de modifier la configuration de la gestion des versions pour un bucket

Valeurs correctes Aucune
Exemple /OBJECT_NAME?versioning
Détails Facultatif pour les requêtes suivantes: PUT Bucket, GET Bucket. Si vous envoyez une requête PUT, vous devez inclure un document XML dans le corps de la requête, indiquant la configuration de gestion des versions que vous souhaitez appliquer. Vous ne pouvez utiliser aucune sous-ressource supplémentaire avec ce paramètre de requête.

versions

Un paramètre de chaîne de requête vous permettant de récupérer toute la génération d'objets dans un bucket avec versions gérées

Valeurs correctes Aucune
Exemple /BUCKET_NAME?versions=True
Détails Facultatif pour les requêtes suivantes: GET Bucket.

Configuration du site Web

Un paramètre de chaîne de requête vous permettant de récupérer ou de modifier la configuration d'un site Web.

Valeurs correctes Aucune
Exemple /BUCKET_NAME?websiteConfig
Détails Facultatif pour les requêtes suivantes: PUT Bucket, GET Bucket. Si vous envoyez une requête PUT, vous devez inclure un document XML dans le corps de la requête, indiquant la configuration du site Web que vous souhaitez appliquer. Vous ne pouvez utiliser aucune sous-ressource supplémentaire avec ce paramètre de requête.

Algorithme X-Goog

Paramètre de chaîne de requête permettant de déterminer l'algorithme de l'URL signée V4.

Valeurs correctes GOOG4-RSA-SHA256
GOOG4-HMAC-SHA256
AWS4-HMAC-SHA256
Détails Utilisée spécifiquement pour les requêtes signées V4, telles que les URL signées.

Identifiant X-Goog

Un paramètre de chaîne de requête permettant de déterminer le type d'identifiants utilisé.

Valeurs correctes Service_Account_Email/Date/Region/goog4_request
Google_HMAC_Access_Key_ID/Date/Region/goog4_request
AWS_HMAC_Access_Key_ID/Date/Region/aws4_request
Exemple Avec un compte de service Google : example%40example-project.iam.gserviceaccount.com%2F20181026%2Fus-central-1%2Fstorage%2Fgoog4_request
Avec HMAC : GOOGTS7C7FUP3AIRVJTE2BCD%2F20181026%2Fus-central-1%2Fstorage%2Fgoog4_request
Détails Utilisée spécifiquement pour les requêtes signées V4, telles que les URL signées.

X-Goog-Date (paramètre de requête)

Date et heure auxquelles l'URL signée est utilisable.

Valeurs correctes Toute date suivant: AAAAMMJJ'T'HHMMSS'Z'
Exemple ?X-Goog-Date=20181026T181309Z
Détails Le format utilisé est le format de base ISO 8601 AAAAMMJJ'T'HHMMSS'Z'.

X-Goog-Expires

Paramètre de chaîne de requête permettant de déterminer la durée d'activation d'une URL V4 signée.

Valeurs correctes 1 seconde jusqu'à 604 800 secondes
Exemple ?X-Goog-Expires=900
Détails Durée pendant laquelle l'URL signée est restée valide, mesurée en secondes à partir de la valeur indiquée dans X-Goog-Date (paramètre de requête). La valeur maximale est de 7 jours ou de 604 800 secondes.

X-Goog-SignedHeaders

Paramètre de chaîne de requête permettant de déterminer les en-têtes signés dans une URL signée V4.

Valeurs correctes Le seul en-tête obligatoire est host. Tout en-tête signé avec une signature d'URL signée V4 doit figurer dans cette liste.
Exemples ?X-Goog-SignedHeaders=host
?X-Goog-SignedHeaders=host,x-goog-acl
Détails En-têtes devant être inclus dans toute requête utilisant l'URL signée.

Signature X-Goog

Un paramètre de chaîne de requête contenant la valeur d'une signature d'URL signée V4.

Valeurs correctes Signature de l'URL signée.
Exemple ?X-Goog-Signature=247a2aa45f169edf4d187d54e7cc46e4731b1e6273242c4f4c39a1d2507a0e58706e25e3a85a7dbb891d62afa8496def8e260c1db863d9ace85ff0a184b894b117fe46d1225c82f2aa19efd52cf21d3e2022b3b868dcc1aca2741951ed5bf3bb25a34f5e9316a2841e8ff4c530b22ceaa1c5ce09c7cbb5732631510c20580e61723f5594de3aea497f195456a2ff2bdd0d13bad47289d8611b6f9cfeef0c46c91a455b94e90a66924f722292d21e24d31dcfb38ce0c0f353ffa5a9756fc2a9f2b40bc2113206a81e324fc4fd6823a29163fa845c8ae7eca1fcf6e5bb48b3200983c56c5ca81fffb151cca7402beddfc4a76b133447032ea7abedc098d2eb14a7
Détails Chaîne d'authentification permettant aux requêtes utilisant cette URL signée d'accéder à la ressource désignée.