head-object - Object Storage Service - Centre de documentation Alibaba Cloud

La commande head-object permet d'interroger les métadonnées d'un objet.

Remarque

Le contenu de l'objet n'est pas renvoyé dans la réponse lorsque vous exécutez cette commande.

Autorisations

Par défaut, un compte Alibaba Cloud dispose de toutes les autorisations. Les utilisateurs RAM ou les rôles RAM associés à un compte Alibaba Cloud ne disposent d'aucune autorisation par défaut. Le compte Alibaba Cloud ou l'administrateur du compte doit accorder les autorisations d'opération via des stratégies RAM ou une stratégie de bucket.

API

Action

Description

HeadObject

oss:GetObject

Interroge les métadonnées d'un objet.

Syntaxe de la commande

ossutil api head-object --bucket value --key value [flags]

Paramètre

Type

Description

--bucket

string

Nom du bucket.

--key

string

Chemin complet de l'objet.

--if-match

string

Si la valeur ETag spécifiée dans la requête correspond à la valeur ETag de l'objet, le code 200 OK et les métadonnées de l'objet sont renvoyés. Sinon, le code 412 Precondition Failed est renvoyé.

--if-modified-since

string

Si l'heure spécifiée est antérieure à la dernière heure de modification de l'objet, les métadonnées de l'objet et le code 200 OK sont renvoyés. Sinon, le code 304 Not Modified est renvoyé.

--if-none-match

string

Si la valeur ETag saisie ne correspond pas à la valeur ETag de l'objet, les métadonnées de l'objet et le code 200 OK sont renvoyés. Sinon, le code 304 Not Modified est renvoyé.

--if-unmodified-since

string

Si l'heure spécifiée est égale ou postérieure à la dernière heure de modification de l'objet, les métadonnées de l'objet et le code 200 OK sont renvoyés. Sinon, le code 412 Precondition Failed est renvoyé.

--version-id

string

ID de version de l'objet.

Remarque

La commande head-object correspond à l'opération HeadObject. Pour plus d'informations sur les paramètres de l'opération HeadObject, consultez la rubrique HeadObject.
Pour plus d'informations sur les options de ligne de commande globales prises en charge, consultez la rubrique Options de ligne de commande.

Exemples

Interrogez les métadonnées de exampleobject.

ossutil api head-object --bucket examplebucket --key exampleobject

Interrogez les métadonnées de exampleobject et affichez la sortie au format JSON.

ossutil api head-object --bucket examplebucket --key exampleobject --output-format json

Interrogez les métadonnées de exampleobject dont l'ID de version est 123.

ossutil api head-object --bucket examplebucket --key exampleobject --version-id 123

Interrogez les métadonnées de exampleobject dont la valeur ETag est 123.

ossutil api head-object --bucket examplebucket --key exampleobject --if-match 123

Interrogez les métadonnées de exampleobject dont l'heure de modification réelle est antérieure à « Thu, 11 Jul 2024 06:36:31 GMT ».
```
ossutil api head-object --bucket examplebucket --key exampleobject --if-modified-since "Thu, 11 Jul 2024 06:36:31 GMT"
```