Obtenir des informations sur les metadata d’un objet

Vous pouvez obtenir des informations sur les metadata d’un objet sans pour autant avoir à le télécharger.

Pour utiliser cette commande, vous devez avoir la permission read sur l’objet. Pour en savoir plus, voir Gérer les accès à vos objets.

Obtenir des informations sur les metadata d’un objet avec AWS CLI

Avant de commencer : Installez et configurez AWS CLI et définissez votre profil. Pour en savoir plus, voir Installer et configurer AWS CLI.

Pour obtenir des informations sur les metadata d’un objet, utilisez la commande head-object en suivant cette syntaxe :

Exemple de requête
$ aws s3api head-object \
    --profile YOUR_PROFILE \
    --bucket BUCKET \
    --if-match "\"12345a6b76656da1b64f287c8627af7\"" \
    --if-modified-since "2022-01-20" \
    --if-none-match "\"12345a6b76656da1b64f287c8627af7\"" \
    --if-unmodified-since "2022-01-20" \
    --key OBJECT \
    --version-id "12345" \
    --part-number "1" \
    --endpoint https://oos.eu-west-2.outscale.com

Cette commande contient les attributs suivants que vous devez spécifier :

  • (optionnel) profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.

  • bucket : Le nom du bucket dans lequel l’objet est stocké.

  • (optionnel) if-match : Ne demande l’objet que si son ETag correspond à celui que vous avez indiqué pour cet attribut.

  • (optionnel) if-modified-since : Ne demande l’objet que s’il a été modifié après la date (au format ISO 8601) indiquée pour cet attribut.

  • (optionnel) if-none-match : Ne demande l’objet que si son ETag ne correspond pas à celui que vous avez indiqué pour cet attribut.

  • (optionnel) if-unmodified-since : Ne demande l’objet que s’il n’a pas été modifié depuis la date (au format ISO 8601) indiquée pour cet attribut.

  • key : Le nom de l’objet duquel vous souhaitez récupérer les metadata.

  • (optionnel) version-id : L’ID de la version de l’objet à partir de laquelle vous souhaitez récupérer les metadata. Pour en savoir plus, voir Utiliser le bucket versioning.

  • (optionnel) part-number : Le numéro du dépôt du téléchargement (entre 1 and 10000, les deux inclus). Pour en savoir plus, voir Utiliser un dépôt partitionné.

  • endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête.

La commande head-object renvoie les éléments suivants :

  • DeleteMarker : Si true, indique que l’objet récupéré est un delete marker. Pour en savoir plus, voir Lister les versions d’un objet.

    Si false, l’élément n’est pas renvoyé dans le résultat.

  • AcceptRanges : Indique les requêtes d’intervalle que le serveur prend en charge pour l’objet.

  • Expiration : Si une règle de cycle de vie a été appliquée à l’objet, renvoie les détails sur sa configuration. Pour en savoir plus, voir Gérer le cycle de vie de vos buckets.

    • expiry-date : Date et heure d’expiration de l’objet.

    • rule-id : Le nom donné à la règle de cycle de vie.

  • LastModified : Date et heure à laquelle l’objet a été modifié pour la dernière fois.

  • ContentLength : La taille de l’objet, en octets.

  • ETag : L’ETag de l’objet.

Si la commande s3 de haut niveau a été utilisée pour déposer l’objet dans un bucket et si cet objet était suffisamment volumineux (généralement 5 Mo ou plus), le nombre de parties composant l’objet reconstitué sera contenu dans son ETag. Ceci est indiqué par un tiret et le nombre correspondant à la fin de l’ETag (par exemple, l’objet a été divisé en 15 parties si l’ETag se termine par -15). Pour en savoir plus, voir Tutoriel : Utiliser un dépôt partitionné avec AWS CLI (s3).

  • MissingMeta : Dans le cas de headers non conventionnels, le nombre d’entrées de metadata non renvoyées.

  • VersionId : L’ID de la version de l’objet que vous demandez à récupérer.

  • CacheControl : Indique les directives de mise en cache adéquates lors du traitement de l’objet.

  • ContentDisposition : Indique comment le contenu est affiché.

  • ContentEncoding : Le format d’encodage de l’objet.

  • ContentLanguage : La langue dans laquelle le contenu de l’objet se trouve, en code de langue.

  • ContentType : Le type MIME (Multipurpose Internet Mail Extensions) de l’objet.

  • Expires : Date et heure à laquelle l’objet ne peut plus être mis en cache et est considéré comme obsolète.

  • WebsiteRedirectLocation : Si l’objet se trouve dans un bucket configuré comme site web, indique l’URL. Pour en savoir plus, voir Gérer un site web sur bucket.

  • Metadata : Une carte des entrées de metadata supplémentaires que vous avez éventuellement spécifiées.

    • key : Le nom de la metadata.

    • value : La valeur de la metadata.

  • PartsCount : Si vous avez spécifié un attribut partNumber dans votre requête, le nombre de parties composant l’objet. Pour en savoir plus, voir Utiliser un dépôt partitionné.

  • ObjectLockMode : Si Object Lock est activité sur le bucket contenant l’objet, indique son mode. Pour en savoir plus, voir Configurer un Object Lock par défaut sur un bucket.

  • ObjectLockRetainUntilDate : Si une période de rétention a été appliquée à l’objet, indique la date durant laquelle l’objet est verrouillé. Pour en savoir plus, voir Configurer un Object Lock spécifique sur un object.

Exemple de résultat
{
    "DeleteMarker": true,
    "AcceptRanges": "bytes",
    "Expiration": {
        "expiry-date": "Thu, 20 Jan 2022 13:18:18 GMT",
        "rule-id": "id"
    },
    "LastModified": "Thu, 20 Jan 2022 13:18:18 GMT",
    "ContentLength": 1534068,
    "ETag": "\"15943a31a76656da1b64f287c8627af7\"",
    "MissingMeta": "2",
    "VersionId": "12345",
    "CacheControl": "no-cache",
    "ContentDisposition": "inline",
    "ContentEncoding": "gzip",
    "ContentLanguage": "en",
    "ContentType": "application/pdf",
    "Expires": "Thu, 20 Jan 2022 13:18:18 GMT",
    "WebsiteRedirectLocation": "example.com",
    "Metadata": {
        "key": "value"
    },
    "PartsCount": "4",
    "ObjectLockMode": "COMPLIANCE",
    "ObjectLockRetainUntilDate": "2023-11-18T08:23:48.027000+00:00"
}

Pages connexes

AWS™ et Amazon Web Services™ sont des marques de commerce d’Amazon Technologies, Inc. ou de ses affiliées aux États-Unis et/ou dans les autres pays.