--- title: "Object Storage - Récupérer les métadonnées d'un objet avec GetObjectAttributes" description: "Découvrez comment récupérer les attributs de métadonnées de vos objets (ETag, taille, classe de stockage, checksum, parties multipart) sans télécharger le corps de l'objet" url: https://docs.ovhcloud.com/fr/guides/storage-and-backup/object-storage/s3-get-object-attributes lang: fr lastUpdated: 2026-05-11 --- # Object Storage - Récupérer les métadonnées d'un objet avec GetObjectAttributes ## Objectif **Ce guide explique comment utiliser l'opération API S31 `GetObjectAttributes` pour récupérer les attributs de métadonnées des objets de vos buckets OVHcloud Object Storage sans télécharger le corps de l'objet.** ## Prérequis - [Un projet Public Cloud](/fr/guides/public-cloud/cross-functional/create-a-public-cloud-project.md) dans votre compte OVHcloud - [Un utilisateur Object Storage](/fr/guides/storage-and-backup/object-storage/s3-identity-and-access-management.md) déjà créé - [AWS CLI installé et configuré](/fr/guides/storage-and-backup/object-storage/s3-getting-started-with-object-storage.md) ## En pratique ### Pourquoi utiliser GetObjectAttributes ? L'inspection des métadonnées d'un objet nécessite traditionnellement au moins 2 appels API distincts : `HeadObject` pour récupérer l'ETag, la taille et la classe de stockage, et `ListParts` pour énumérer les parties des objets multipart. Chaque appel supplémentaire ajoute de la latence, ce qui devient significatif à grande échelle dans les pipelines de données, les workflows de vérification d'intégrité ou les systèmes d'audit de stockage. `GetObjectAttributes` consolide la récupération de tous les attributs en un **seul appel API sélectif**. Vous demandez exactement les attributs dont vous avez besoin ; le service retourne uniquement ces champs — aucun corps d'objet n'est transféré. **Bénéfices clés :** - **Aucun transfert de corps :** récupérez uniquement les métadonnées, quelle que soit la taille de l'objet. - **Réponse sélective :** recevez uniquement les attributs que vous demandez. - **Tout client compatible S3 :** fonctionne avec AWS CLI, n'importe quel SDK S3 et les appels HTTP directs. ### Attributs supportés Vous sélectionnez les attributs à récupérer en les listant dans l'en-tête de requête `x-amz-object-attributes` (séparés par des espaces pour AWS CLI, par des virgules pour HTTP brut). Les attributs non listés sont absents de la réponse. | Attribut | Description | | -------------- | ---------------------------------------------------------------------------------------------------------- | | `ETag` | Identifiant opaque représentant une version spécifique du contenu de l'objet | | `Checksum` | Valeur de checksum calculée avec l'algorithme stocké avec l'objet lors du téléversement | | `ObjectParts` | Structure multipart de l'objet : liste des parties avec leur numéro, taille et checksum optionnel | | `StorageClass` | Classe de stockage de l'objet (`STANDARD`, `STANDARD_IA`, `GLACIER_IR`, `DEEP_ARCHIVE`, `EXPRESS_ONEZONE`) | | `ObjectSize` | Taille totale de l'objet en octets | L'en-tête de réponse `Last-Modified` est toujours retourné, quels que soient les attributs demandés. :::info L'en-tête `x-amz-object-attributes` est **obligatoire**. Une requête sans cet en-tête retourne `400 Bad Request`. Les noms d'attributs sont sensibles à la casse. ::: ### Récupérer les attributs d'un objet **Via AWS CLI** ```sh # Récupérer l'ETag et la taille aws s3api get-object-attributes \ --bucket \ --key \ --object-attributes ETag ObjectSize ``` **Réponse en cas de succès :** ```json { "LastModified": "2026-04-15T10:23:45+00:00", "ETag": "d41d8cd98f00b204e9800998ecf8427e", "ObjectSize": 1048576 } ``` Pour demander tous les attributs à la fois : ```sh aws s3api get-object-attributes \ --bucket \ --key \ --object-attributes ETag Checksum ObjectParts StorageClass ObjectSize ``` **Via curl (API REST S3)** ```sh curl -X GET \ -H "x-amz-object-attributes: ETag,ObjectSize" \ --aws-sigv4 "aws:amz::s3" \ --user ":" \ "https://s3..io.cloud.ovh.net//?attributes" ``` **Succès :** HTTP `200 OK` avec un corps XML contenant les attributs demandés. ### Attribut Checksum Lorsque `Checksum` est demandé, la réponse inclut l'algorithme et la valeur stockés avec l'objet lors du téléversement. Si l'objet a été téléversé sans checksum, l'élément `Checksum` est absent de la réponse — ce n'est pas une erreur. **Algorithmes de checksum supportés sur OVHcloud Object Storage :** | Algorithme | Élément XML dans la réponse | | ----------- | --------------------------- | | CRC-32 | `ChecksumCRC32` | | CRC-32C | `ChecksumCRC32C` | | CRC-64/NVME | `ChecksumCRC64NVME` | | SHA-1 | `ChecksumSHA1` | | SHA-256 | `ChecksumSHA256` | **Via AWS CLI** ```sh aws s3api get-object-attributes \ --bucket `` \ --key \ --object-attributes Checksum ``` **Réponse (l'objet a un checksum CRC32) :** ```json { "LastModified": "2026-04-15T10:23:45+00:00", "Checksum": { "ChecksumCRC32": "aGVsbG8=" } } ``` **Réponse (l'objet n'a pas de checksum) :** ```json { "LastModified": "2026-04-15T10:23:45+00:00" } ``` **Via curl (API REST S3)** ```sh curl -X GET \ -H "x-amz-object-attributes: Checksum" \ --aws-sigv4 "aws:amz::s3" \ --user ":" \ "https://s3..io.cloud.ovh.net/``/?attributes" ``` ### Attribut ObjectParts (objets multipart) Lorsque `ObjectParts` est demandé sur un objet multipart, la réponse liste toutes les parties avec leur numéro, taille et checksum optionnel. Pour les objets en une seule partie (non-multipart), `ObjectParts` est retourné comme un élément vide. :::info Seuls les détails des parties (taille, checksum, pagination) des objets créés avec le type de checksum `COMPOSITE` seront listés ; en d'autres termes, lorsque vous créez votre multipart upload, vous devez définir la valeur de l'en-tête `x-amz-checksum-type` sur `COMPOSITE`. ::: **Pagination :** les résultats sont paginés à 1000 parties par réponse maximum. **Via AWS CLI** ```sh # Lister toutes les parties (par défaut : jusqu'à 1000) aws s3api get-object-attributes \ --bucket \ --key \ --object-attributes ObjectParts ``` **Réponse :** ```json { "LastModified": "2026-04-20T08:10:00+00:00", "ObjectParts": { "TotalPartsCount": 3, "MaxParts": 1000, "IsTruncated": false, "Parts": [ { "PartNumber": 1, "Size": 5242880 }, { "PartNumber": 2, "Size": 5242880 }, { "PartNumber": 3, "Size": 1048576 } ] } } ``` **Via curl (API REST S3)** ```sh curl -X GET \ -H "x-amz-object-attributes: ObjectParts" \ --aws-sigv4 "aws:amz::s3" \ --user ":" \ "https://s3..io.cloud.ovh.net//?attributes" ``` Paginer à travers ObjectParts (objets avec plus de 1000 parties) Lorsqu'un objet possède plus de 1000 parties, `IsTruncated` vaut `true` et `NextPartNumberMarker` indique où reprendre. Utilisez `--part-number-marker` pour récupérer les pages suivantes. **Via AWS CLI** ```sh # Première page aws s3api get-object-attributes \ --bucket `` \ --key \ --object-attributes ObjectParts \ --max-parts 1000 # Page suivante - utilisez NextPartNumberMarker de la réponse précédente aws s3api get-object-attributes \ --bucket `` \ --key \ --object-attributes ObjectParts \ --max-parts 1000 \ --part-number-marker `` ``` **Via curl (API REST S3)** ```sh # Première page curl -X GET \ -H "x-amz-object-attributes: ObjectParts" \ -H "x-amz-max-parts: 1000" \ --aws-sigv4 "aws:amz::s3" \ --user ":" \ "https://s3..io.cloud.ovh.net/``/?attributes" # Page suivante curl -X GET \ -H "x-amz-object-attributes: ObjectParts" \ -H "x-amz-max-parts: 1000" \ -H "x-amz-part-number-marker: ``" \ --aws-sigv4 "aws:amz::s3" \ --user ":" \ "https://s3..io.cloud.ovh.net/``/?attributes" ``` ### Objets versionnés Par défaut, `GetObjectAttributes` opère sur la **version courante** de l'objet. Pour récupérer les attributs d'une version spécifique, ajoutez `--version-id` à la requête. **Via AWS CLI** ```sh aws s3api get-object-attributes \ --bucket \ --key \ --version-id \ --object-attributes ETag ObjectSize StorageClass ``` L'en-tête de réponse `x-amz-version-id` retourne l'identifiant de version de l'objet récupéré. **Via curl (API REST S3)** ```sh curl -X GET \ -H "x-amz-object-attributes: ETag,ObjectSize" \ --aws-sigv4 "aws:amz::s3" \ --user ":" \ "https://s3..io.cloud.ovh.net/``/?attributes&versionId=``" ``` :::info **Permissions IAM avec versionId :** l'utilisation de `--version-id` requiert les permissions `s3:GetObjectVersion` et `s3:GetObjectVersionAttributes`, à la place des permissions par défaut `s3:GetObject` + `s3:GetObjectAttributes`. ::: ### Objets chiffrés (SSE-C) Pour les objets chiffrés avec SSE-C (clés fournies par le client), vous devez fournir les trois en-têtes de chiffrement à chaque requête `GetObjectAttributes`. Le service ne stocke pas la clé. **Via AWS CLI** ```sh aws s3api get-object-attributes \ --bucket \ --key \ --object-attributes ETag ObjectSize \ --sse-customer-algorithm AES256 \ --sse-customer-key \ --sse-customer-key-md5 ``` **Via curl (API REST S3)** ```sh curl -X GET \ -H "x-amz-object-attributes: ETag,ObjectSize" \ -H "x-amz-server-side-encryption-customer-algorithm: AES256" \ -H "x-amz-server-side-encryption-customer-key: " \ -H "x-amz-server-side-encryption-customer-key-MD5: " \ --aws-sigv4 "aws:amz::s3" \ --user ":" \ "https://s3..io.cloud.ovh.net//?attributes" ``` :::warning Les trois en-têtes SSE-C sont obligatoires pour les objets SSE-C. L'omission de l'un d'eux retourne `400 Bad Request`. Fournir une clé incorrecte retourne `403 Forbidden`. Pour les objets non chiffrés et SSE-S3, n'incluez **pas** les en-têtes SSE-C — les inclure retourne `400 Bad Request`. ::: ### Permissions IAM | Situation | Permissions requises | | ---------------- | ------------------------------------------------------- | | Sans `versionId` | `s3:GetObject` + `s3:GetObjectAttributes` | | Avec `versionId` | `s3:GetObjectVersion` + `s3:GetObjectVersionAttributes` | Aucune permission supplémentaire n'est requise au-delà des permissions de lecture standard. ### Codes d'erreur | Code HTTP | Code d'erreur | Condition | | ------------------------ | ----------------- | ----------------------------------------------------------------------------------------------------- | | `200 OK` | - | Requête réussie | | `400 Bad Request` | `InvalidArgument` | `x-amz-object-attributes` manquant, nom d'attribut invalide, ou combinaison d'en-têtes SSE-C invalide | | `403 Forbidden` | `AccessDenied` | Permission IAM manquante, ou clé SSE-C incorrecte | | `404 Not Found` | `NoSuchKey` | L'objet n'existe pas et le demandeur a `s3:ListBucket` | | `403 Forbidden` | `AccessDenied` | L'objet n'existe pas et le demandeur n'a PAS `s3:ListBucket` | | `405 Method Not Allowed` | - | La version cible est un marqueur de suppression | :::info **Marqueurs de suppression :** dans un bucket versionné, si la version courante d'un objet (ou la version spécifiée par `--version-id`) est un marqueur de suppression, le service retourne `405 Method Not Allowed` avec l'en-tête de réponse `x-amz-delete-marker: true`. ::: ## Aller plus loin Échangez avec notre [communauté d’utilisateurs](https://community.ovhcloud.com/). 1  : S3 est une marque déposée appartenant à Amazon Technologies, Inc. Les services de OVHcloud ne sont pas sponsorisés, approuvés, ou affiliés de quelque manière que ce soit.