Object Storage - Récupérer les métadonnées d'un objet avec GetObjectAttributes

Objectif

Ce guide explique comment utiliser l'opération API S3¹ 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 dans votre compte OVHcloud
• Un utilisateur Object Storage déjà créé
• AWS CLI installé et configuré

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.

L'en-tête de réponse Last-Modified est toujours retourné, quels que soient les attributs demandés.

Récupérer les attributs d'un objet

# Récupérer l'ETag et la taille
aws s3api get-object-attributes \
  --bucket <nom_du_bucket> \
  --key <clé_de_l_objet> \
  --object-attributes ETag ObjectSize

{
    "LastModified": "2026-04-15T10:23:45+00:00",
    "ETag": "d41d8cd98f00b204e9800998ecf8427e",
    "ObjectSize": 1048576
}

aws s3api get-object-attributes \
  --bucket <nom_du_bucket> \
  --key <clé_de_l_objet> \
  --object-attributes ETag Checksum ObjectParts StorageClass ObjectSize

curl -X GET \
  -H "x-amz-object-attributes: ETag,ObjectSize" \
  --aws-sigv4 "aws:amz:<région>:s3" \
  --user "<clé_accès>:<clé_secrète>" \
  "https://s3.<région>.io.cloud.ovh.net/<nom_du_bucket>/<clé_de_l_objet>?attributes"

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 :

aws s3api get-object-attributes \
  --bucket <nom_du_bucket> \
  --key <clé_de_l_objet> \
  --object-attributes Checksum

{
    "LastModified": "2026-04-15T10:23:45+00:00",
    "Checksum": {
        "ChecksumCRC32": "aGVsbG8="
    }
}

{
    "LastModified": "2026-04-15T10:23:45+00:00"
}

curl -X GET \
  -H "x-amz-object-attributes: Checksum" \
  --aws-sigv4 "aws:amz:<région>:s3" \
  --user "<clé_accès>:<clé_secrète>" \
  "https://s3.<région>.io.cloud.ovh.net/<nom_du_bucket>/<clé_de_l_objet>?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.

Pagination : les résultats sont paginés à 1000 parties par réponse maximum.

# Lister toutes les parties (par défaut : jusqu'à 1000)
aws s3api get-object-attributes \
  --bucket <nom_du_bucket> \
  --key <clé_de_l_objet> \
  --object-attributes ObjectParts

{
    "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 }
        ]
    }
}

curl -X GET \
  -H "x-amz-object-attributes: ObjectParts" \
  --aws-sigv4 "aws:amz:<région>:s3" \
  --user "<clé_accès>:<clé_secrète>" \
  "https://s3.<région>.io.cloud.ovh.net/<nom_du_bucket>/<clé_de_l_objet>?attributes"

# Première page
aws s3api get-object-attributes \
  --bucket <nom_du_bucket> \
  --key <clé_de_l_objet> \
  --object-attributes ObjectParts \
  --max-parts 1000

# Page suivante - utilisez NextPartNumberMarker de la réponse précédente
aws s3api get-object-attributes \
  --bucket <nom_du_bucket> \
  --key <clé_de_l_objet> \
  --object-attributes ObjectParts \
  --max-parts 1000 \
  --part-number-marker <marqueur_de_partie_suivante>

# Première page
curl -X GET \
  -H "x-amz-object-attributes: ObjectParts" \
  -H "x-amz-max-parts: 1000" \
  --aws-sigv4 "aws:amz:<région>:s3" \
  --user "<clé_accès>:<clé_secrète>" \
  "https://s3.<région>.io.cloud.ovh.net/<nom_du_bucket>/<clé_de_l_objet>?attributes"

# Page suivante
curl -X GET \
  -H "x-amz-object-attributes: ObjectParts" \
  -H "x-amz-max-parts: 1000" \
  -H "x-amz-part-number-marker: <marqueur_de_partie_suivante>" \
  --aws-sigv4 "aws:amz:<région>:s3" \
  --user "<clé_accès>:<clé_secrète>" \
  "https://s3.<région>.io.cloud.ovh.net/<nom_du_bucket>/<clé_de_l_objet>?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.

aws s3api get-object-attributes \
  --bucket <nom_du_bucket> \
  --key <clé_de_l_objet> \
  --version-id <id_de_version> \
  --object-attributes ETag ObjectSize StorageClass

curl -X GET \
  -H "x-amz-object-attributes: ETag,ObjectSize" \
  --aws-sigv4 "aws:amz:<région>:s3" \
  --user "<clé_accès>:<clé_secrète>" \
  "https://s3.<région>.io.cloud.ovh.net/<nom_du_bucket>/<clé_de_l_objet>?attributes&versionId=<id_de_version>"

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é.

aws s3api get-object-attributes \
  --bucket <nom_du_bucket> \
  --key <clé_de_l_objet> \
  --object-attributes ETag ObjectSize \
  --sse-customer-algorithm AES256 \
  --sse-customer-key <clé_256_bits_encodée_base64> \
  --sse-customer-key-md5 <md5_de_la_clé_encodé_base64>

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: <clé_encodée_base64>" \
  -H "x-amz-server-side-encryption-customer-key-MD5: <md5_encodé_base64>" \
  --aws-sigv4 "aws:amz:<région>:s3" \
  --user "<clé_accès>:<clé_secrète>" \
  "https://s3.<région>.io.cloud.ovh.net/<nom_du_bucket>/<clé_de_l_objet>?attributes"

Permissions IAM

Aucune permission supplémentaire n'est requise au-delà des permissions de lecture standard.

Codes d'erreur

Aller plus loin

Échangez avec notre communauté d'utilisateurs.

¹ : 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.