Lance une importation avec reprise avec une requête POST. Cette requête initiale génère un URI de session à utiliser dans les requêtes PUT ultérieures qui importe les données. La requête initiale vous permet également de spécifier des métadonnées pour l'objet. Une fois l'importation avec reprise, l'objet importé remplace tout objet existant portant le même nom. Pour obtenir des conseils sur l'importation dans Cloud Storage, consultez les bonnes pratiques.
Pour les importations simples avec l'API XML, vous envoyez une requête PUT Object au lieu d'utiliser l'objet POST.
Paramètres de la chaîne de requête
La requête n'inclut généralement pas les paramètres de chaîne de requête.
Pour en savoir plus sur les paramètres à inclure lors de la création et de l'utilisation d'URL signées, consultez la section Paramètres des chaînes de requête d'URL signée.
En-têtes de requête
Les en-têtes de requête suivants peuvent être utilisés.
| En-tête | Description | Requis |
|---|---|---|
Authorization |
Chaîne d'authentification de la requête. | Oui |
Cache-Control |
Les conditions dans lesquelles un objet accessible publiquement doit être mis en cache. Cache-Control permet également de déterminer si un objet peut être transformé. |
Non |
Content-Disposition |
En-tête qui spécifie les informations de présentation sur la manière dont les données de l'objet doivent être transmises. | Non |
Content-Encoding |
Algorithme de compression utilisé pour compresser l'objet que vous importez. | Non |
Content-Language |
Code de langue ISO 639-1 du contenu. | Non |
Content-Length |
Longueur du corps de la requête sans en-têtes (en octets). Pour lancer une importation avec reprise, cette valeur est 0. |
Oui |
Content-Type |
Type MIME de l'objet à importer. Si vous ne spécifiez pas de type de contenu, Cloud Storage utilise par défaut la valeur application/octet-stream lorsqu'il diffuse l'objet. |
Non (recommandé) |
Date |
Date et heure de la requête. | Oui |
Host |
URI de Cloud Storage. Pour en savoir plus, consultez la page Points de terminaison de requêtes. | Oui |
x-goog-acl |
La LCA prédéfinie que vous souhaitez appliquer à l'objet. | Non |
x-goog-custom-time |
Date et heure spécifiées par l'utilisateur. | Non |
x-goog-encryption-kms-key-name |
Clé de chiffrement gérée par le client à utiliser pour chiffrer l'objet. | Non |
x-goog-if-generation-match |
Si la génération spécifiée est identique à l'objet que vous remplacez, l'objet est remplacé. Vous pouvez également spécifier 0 comme valeur spéciale pour indiquer que le nouvel objet n'est créé que s'il n'existe aucun objet existant. | Non |
x-goog-if-metageneration-match |
Si la métagénération spécifiée est identique à l'objet que vous essayez de mettre à jour, les métadonnées de l'objet sont mises à jour. Ceci n'est autorisé que si x-goog-if-generation est spécifié. En combinant ces deux générations, vous pouvez mettre en œuvre des mises à jour sécurisées en lecture-modification-écriture. |
Non |
x-goog-meta- |
Un en-tête d'extension permettant de stocker des métadonnées personnalisées. | Non |
x-goog-resumable |
Indique que cette requête lance l'importation avec reprise. Cet en-tête doit utiliser la valeur start |
Oui |
x-goog-storage-class |
Attribuer à un objet une classe de stockage en plus de la classe de stockage par défaut du bucket associé. | Non |
x-goog-user-project |
Projet à facturer pour les frais associés à la requête. | Non |
Pour fournir une clé de chiffrement fournie par le client lors de l'importation de l'objet, utilisez les en-têtes répertoriés sur la page "Clé de chiffrement fournie par le client" de votre requête.
Éléments du corps de la requête
Cette requête n'inclut pas de document XML dans le corps de la requête.
En-têtes de réponse
La réponse inclut un en-tête Location qui indique l'URI de session à utiliser lors de l'importation des données de l'objet.
Éléments du corps de la réponse
La réponse n'inclut pas de document XML dans le corps de la réponse.
Exemple
L'exemple suivant importe un objet nommé "paris.jpg" dans un bucket nommé "travel-maps".
Requête
POST /paris.jpg HTTP/2 Host: travel-maps.storage.googleapis.com Date: Thu, 10 Dec 2020 18:11:50 GMT Content-Type: image/jpg Content-Length: 0 X-Goog-Resumable: start Authorization: Bearer ya29.AHES6ZRVmB7fkLtd1XTmq6mo0S1wqZZi3-Lh_s-6Uw7p8vtgSwg
Réponse
HTTP/2 201 Content-Type: text/plain; charset=utf-8 X-Guploader-Uploadid: ABf5-UxjuGIOxcy0OpOLoAHbmo5rYKWx3XfrZFTjowNwPT9JYiopVZW2gPFrusVKO5kaSZ7fNrDWkb9sT_lKxOssUTE Location: https://storage.googleapis.com/nstocktest/xmltestinit.jpg?upload_id=ABf5-UxjuGIOxcy0OpOLoAHbmo5rYKWx3XfrZFTjowNwPT9JYiopVZW2gPFrusVKO5kaSZ7fNrDWkb9sT_lKxOssUTE Content-Length: 0 Date: Thu, 10 Dec 2020 18:11:53 GMT Server: UploadServer