Composer un objet

L'opération de composition crée un objet dont le contenu est la concaténation d'une séquence donnée d'objets sources (jusqu'à 32). Les objets sources doivent tous résider dans le même bucket et utiliser la même classe de stockage. Les objets sources ne sont pas affectés par l'opération de composition, et l'objet composite obtenu ne change pas si ses objets sources sont remplacés ou supprimés.

Les objets composites peuvent être créés à partir d'objets sources qui sont eux-mêmes des objets composites.

Pour en savoir plus, consultez la section Objets composites.

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

Paramètre Description Requis
compose Il émet une requête compose. Le corps de la requête doit être renseigné dans un document XML de requête. Non

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

En plus des en-têtes de requêtes courants, les éléments suivants peuvent être utilisés.

En-tête Description Requis
Content-Encoding Algorithme de compression utilisé pour compresser l'objet composite. Non
Content-Disposition Un en-tête qui spécifie des informations de présentation sur la manière dont les données de l'objet doivent être transmises. Non
x-goog-acl La LCA prédéfinie que vous souhaitez appliquer à l'objet composite. Non
x-goog-custom-time Date et heure spécifiées par l'utilisateur. Non
x-goog-meta- Un en-tête d'extension permettant de stocker des métadonnées personnalisées. Non

Pour composer des objets chiffrés à l'aide d'une clé de chiffrement fournie par le client, utilisez les en-têtes répertoriés sur la page "Chiffrement" de votre requête.

Éléments du corps de la requête

Les éléments de corps de requête suivants ne sont disponibles que si vous utilisez le paramètre de chaîne de requête compose pour émettre une requête de composition.

Élément Description
ComposeRequest Conteneur pour une demande de composition.
Component Conteneur pour un argument du composant de requête de composition.
Name Nom d'objet pour un composant de demande de composition.
Generation Numéro de génération d'un composant de demande de composition.
IfGenerationMatch Numéro de génération attendu pour un composant de demande de composition. La requête échoue si la génération de l'objet composant est différente.

Syntaxe des requêtes

PUT /OBJECT_NAME?compose HTTP/1.1
Host: BUCKET_NAME.storage.googleapis.com
Date: DATE
Content-Length: REQUEST_BODY_LENGTH
Authorization: AUTHENTICATION_STRING

<ComposeRequest>
  <Component>
    <Name>component-obj-1</Name>
  </Component>
  <Component>
    <Name>component-obj-2</Name>
    <Generation>1361471441094000</Generation>
  </Component>
  <Component>
    <Name>component-obj-3</Name>
    <IfGenerationMatch>1361471441094000</IfGenerationMatch>
  </Component>
</ComposeRequest>

En-têtes de réponse

La requête peut renvoyer divers en-têtes de réponse en fonction des en-têtes de requête que vous utilisez.

Éléments du corps de la réponse

La réponse n'inclut pas de document XML dans le corps de la réponse.