Obtenir des informations sur les metadata d’un objet
Vous pouvez obtenir des informations sur les metadata (métadonnées) d’un objet sans pour autant avoir à le télécharger.
Pour utiliser cette commande, vous devez avoir la permission |
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 :
$ 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 qAfAAsAAuA00kclkg0A0AAuAAjaAtA. \
--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.Si l’attribut
version-id
commence par un tiret ("-"), vous devez le spécifier en suivant cette syntaxe :--version-id=-qAfAAsAAuA00kclkg0A0AAuAAjaAtA.
-
(optionnel)
part-number
: Le numéro du dépôt du téléchargement (entre1
and10000
, 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
: Sitrue
, 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 |
-
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 attributpart-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 objet.
{
"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.