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. 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. Pour en savoir plus, voir Installer et configurer AWS CLI.

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 part-number 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.