Lancer une importation avec reprise

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