Objet GET

Télécharge un objet, répertorie les LCA d'un objet ou obtient les informations de chiffrement d'un objet.

Pour télécharger un objet, exécutez une requête GET limitée à un bucket et à un objet. Vous pouvez également utiliser différents en-têtes de requête pour étendre la portée de la requête. La requête renvoie le contenu de l'objet dans le corps de la réponse. Pour répertorier les LCA d'un objet, vous devez envoyer une requête GET limitée à un bucket et à un objet, à l'aide du paramètre de chaîne de requête acl. Les LCA sont renvoyées dans un document XML dans le corps de la réponse.

Si vous effectuez une requête GET pour un objet qui n'existe pas, vous obtenez un code d'état 404 Not Found et le corps de la réponse d'erreur contiendra NoSuchKey. dans l'élément Code.

Utilisez une requête d'objet GET pour effectuer les opérations suivantes:

Vous ne devez pas utiliser de requête d'objet GET pour récupérer des métadonnées d'objet générales, car cela entraîne des frais de sortie associés au téléchargement de l'objet entier. Utilisez plutôt une requête d'objet HEAD.

En-têtes de requête courants

Voici les en-têtes de requête courants pour les requêtes d'objet GET.

En-tête Description Requis
Authorization Chaîne d'authentification de la requête. Obligatoire pour les objets sans accès en lecture public. Peut-être.
Host URI de Cloud Storage. Pour en savoir plus, consultez la page Points de terminaison de requêtes. Oui
x-goog-user-project Projet à facturer pour les frais associés à la requête. Non