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:
L'API XML utilise les en-têtes HTTP (extension) personnalisés suivants:
L'API XML utilise les paramètres de chaîne de requête suivants:
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 :
|
| 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 |
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 Lorsqu'elle est incluse dans une requête d'importation avec reprise, la méthode Les plages d'octets sont incluses ; C'est-à-dire que 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 Lorsque la requête est renvoyée dans le cadre d'une réponse associée à une importation avec reprise, Les plages d'octets sont incluses. Par exemple, |
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: |
| 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 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 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 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 Si vous spécifiez Si vous spécifiez Lorsque vous copiez un objet de sorte qu'il réécrit l'objet source, vous devez inclure |
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 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: 000111222333x-goog-project-id: my-project-namex-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?aclhttps://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 Vous pouvez utiliser un opérateur Le champ |
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 |
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 |
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-SHA256GOOG4-HMAC-SHA256AWS4-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_requestGoogle_HMAC_Access_Key_ID/Date/Region/goog4_requestAWS_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_requestAvec 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. |