L'opération GetObjectMeta récupère les métadonnées d'un objet, notamment son ETag, sa taille et sa date de dernière modification, sans renvoyer le contenu de l'objet.
Notes
Si l'objet est un lien symbolique, les métadonnées du lien symbolique sont renvoyées.
Si le versioning est désactivé, vous devez disposer de l'autorisation oss:GetObject. Si le versioning est activé, vous devez disposer de l'autorisation oss:GetObjectVersion pour récupérer les métadonnées d'une version spécifique. Spécifiez la version à l'aide de l'en-tête de requête x-oss-version-id. Accorder des autorisations personnalisées à un utilisateur RAM.
Versioning
Par défaut, GetObjectMeta récupère les métadonnées de la version actuelle. Si la version actuelle est un marqueur de suppression, OSS renvoie l'erreur 404 Not Found. Si vous spécifiez un versionId dans la requête, les métadonnées de cette version sont renvoyées.
Syntaxe de la requête
HEAD /ObjectName?objectMeta HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValueEn-têtes de requête
Cette opération utilise uniquement les en-têtes de requête communs. Pour plus d'informations, consultez En-têtes de requête communs.
En-têtes de réponse
|
En-tête de réponse |
Type |
Exemple |
Description |
|
Content-Length |
String |
344606 |
Taille de l'objet en octets. |
|
ETag |
String |
5B3C1A2E053D763E1B002CC607C5**** |
Un ETag (entity tag) est généré lors de la création d'un objet pour identifier son contenu. Pour les objets créés via PutObject, l'ETag correspond au hachage MD5 du contenu. Pour les objets créés par d'autres méthodes, l'ETag est une valeur unique mais ne correspond pas au hachage MD5. Utilisez l'ETag pour vérifier si le contenu a changé, mais pas pour valider l'intégrité des données via MD5. Valeur par défaut : Aucune |
|
x-oss-transition-time |
String |
Tue, 23 Apr 2024 07:21:42 GMT |
Date à laquelle une règle de cycle de vie a converti l'objet en Cold Archive ou Deep Cold Archive. Remarque
|
|
x-oss-last-access-time |
String |
Tue, 30 Mar 2021 06:07:48 GMT |
Dernière date d'accès à l'objet au format GMT (HTTP 1.1). Renvoyé uniquement lorsque le suivi d'accès est activé. Mis à jour lors de l'accès à l'objet. Important
La dernière date d'accès est mise à jour de manière asynchrone. OSS la met généralement à jour sous 24 heures. Si un objet est accédé plusieurs fois dans un délai de 24 heures, seule la première date d'accès est enregistrée. |
|
Last-Modified |
String |
Fri, 24 Feb 2012 06:07:48 GMT |
Date de dernière modification de l'objet, au format GMT (HTTP 1.1). Remarque
|
|
x-oss-version-id |
String |
CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk**** |
ID de version de l'objet. Ce champ est renvoyé uniquement lorsque vous obtenez les métadonnées d'une version spécifique d'un objet. |
|
x-oss-sealed-time |
String |
Sat, 11 Oct 2025 06:41:42 GMT |
Date à laquelle l'opération de scellement a été effectuée sur l'objet ajoutable, au format GMT (HTTP 1.1). Renvoyé uniquement pour les objets ajoutables scellés. |
Cette opération renvoie également les En-têtes de réponse communs.
Exemples
-
Versioning désactivé
Exemple de requête
HEAD /oss.jpg?objectMeta HTTP/1.1 Host: oss-example.oss-cn-hangzhou.aliyuncs.com Date: Wed, 29 Apr 2015 05:21:12 GMT Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eExemple de réponse
ImportantSi vous activez l'espace de noms hiérarchique pour un bucket, puis que vous créez un dossier en appelant l'opération CreateDirectory, l'ETag est renvoyé sous la forme « null » lorsque vous appelez l'opération GetObjectMeta pour obtenir les métadonnées du dossier.
-
Suivi d'accès désactivé
HTTP/1.1 200 OK x-oss-request-id: 559CC9BDC755F95A6448**** Date: Wed, 29 Apr 2015 05:21:12 GMT ETag: "5B3C1A2E053D763E1B002CC607C5****" Last-Modified: Fri, 24 Feb 2012 06:07:48 GMT Content-Length: 344606 Connection: keep-alive Server: AliyunOSS -
Suivi d'accès activé
HTTP/1.1 200 OK x-oss-request-id: 559CC9BDC755F95A6448**** Date: Wed, 29 Apr 2015 05:21:12 GMT ETag: "5B3C1A2E053D763E1B002CC607C5****" x-oss-transition-time: Tue, 23 Apr 2024 07:21:42 GMT x-oss-last-access-time: Thu, 14 Oct 2021 11:49:05 GMT Last-Modified: Fri, 24 Feb 2012 06:07:48 GMT Content-Length: 344606 Connection: keep-alive Server: AliyunOSS
-
-
Versioning activé
Exemple de requête
GET /example?objectMeta&versionId=CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk**** HTTP/1.1 Host: versioning-test.oss-cn-hangzhou.aliyuncs.com Date: Tue, 09 Apr 2019 06:24:00 GMT Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218eExemple de réponse
-
Suivi d'accès désactivé
HTTP/1.1 200 OK x-oss-version-id: CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk**** x-oss-request-id: 5CAC3A80B7AEADE0170005F6 Date: Tue, 09 Apr 2019 06:24:00 GMT ETag: "1CF5A685959CA2ED8DE6E5F8ACC2****" Last-Modified: Tue, 09 Apr 2019 06:24:00 GMT Content-Length: 119914 Connection: keep-alive Server: AliyunOSS -
Suivi d'accès activé
HTTP/1.1 200 OK x-oss-version-id: CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk**** x-oss-request-id: 5CAC3A80B7AEADE0170005F6 Date: Tue, 09 Apr 2019 06:24:00 GMT ETag: "1CF5A685959CA2ED8DE6E5F8ACC2****" x-oss-last-access-time: Thu, 14 Oct 2021 11:49:05 GMT Last-Modified: Tue, 09 Apr 2019 06:24:00 GMT Content-Length: 119914 Connection: keep-alive Server: AliyunOSS
-
SDK
Vous pouvez appeler cette opération à l'aide des SDK suivants :
Interface de ligne de commande ossutil
La commande ossutil correspondante est get-object-meta.
Références
Codes d'erreur
|
Code d'erreur |
Code d'état HTTP |
Description |
|
Not Found |
404 |
L'objet spécifié n'existe pas. |