Tous les produits
Search

Ce produit

    Object Storage Service:HeadObject

    Centre de documentation

    Object Storage Service:HeadObject

    Dernière mise à jour :Aug 18, 2026

    L'opération HeadObject récupère les métadonnées d'un objet sans renvoyer son contenu.

    Versioning

    • Si vous appelez HeadObject sans spécifier de versionId, les métadonnées de la version actuelle sont renvoyées. Si la version actuelle est un marqueur de suppression, OSS renvoie l'erreur 404 NoSuchKey.

    • Si vous appelez HeadObject avec un versionId spécifique, les métadonnées de cette version sont renvoyées. Ne spécifiez pas le versionId d'un marqueur de suppression, sinon OSS renvoie l'erreur 405 MethodNotAllowed.

    Permissions

    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 Bucket Policy.

    API

    Action

    Description

    HeadObject

    oss:GetObject

    Récupère les métadonnées d'un objet.

    Syntaxe de la requête

    HEAD /ObjectName HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

    En-têtes de requête

    Nom

    Type

    Obligatoire

    Description

    If-Modified-Since

    String

    Non

    Si l'heure spécifiée est antérieure à l'heure de modification réelle de l'objet, OSS renvoie 200 OK avec les métadonnées de l'objet. Sinon, OSS renvoie 304 Not Modified.

    Valeur par défaut : Aucune

    If-Unmodified-Since

    String

    Non

    Si l'heure spécifiée est identique ou postérieure à l'heure de modification réelle de l'objet, OSS renvoie 200 OK avec les métadonnées de l'objet. Sinon, OSS renvoie 412 Precondition Failed.

    Valeur par défaut : Aucune

    If-Match

    String

    Non

    Si l'ETag spécifié correspond à l'ETag de l'objet, OSS renvoie 200 OK avec les métadonnées de l'objet. Sinon, OSS renvoie 412 Precondition Failed.

    Valeur par défaut : Aucune

    If-None-Match

    String

    Non

    Si l'ETag spécifié ne correspond pas à l'ETag de l'objet, OSS renvoie 200 OK avec les métadonnées de l'objet. Sinon, OSS renvoie 304 Not Modified.

    Valeur par défaut : Aucune

    Cette opération prend également en charge les en-têtes de requête communs tels que Host et Date.

    En-têtes de réponse

    Si l'objet demandé est un lien symbolique, les en-têtes de réponse se comportent comme suit :

    • Content-Length, ETag, x-oss-storage-class et Content-Md5 correspondent aux métadonnées du fichier objet.

    • Last-Modified correspond à la dernière heure de modification du lien symbolique ou du fichier objet, selon la date la plus récente.

    • Les autres en-têtes de réponse indiquent les métadonnées du lien symbolique.

    Nom

    Type

    Description

    x-oss-meta-*

    String

    Les en-têtes de métadonnées définis par l'utilisateur via PutObject avec le préfixe x-oss-meta- sont renvoyés dans la réponse.

    En-têtes personnalisés qui ne commencent pas par x-oss-meta-

    String

    Les en-têtes personnalisés qui ne commencent pas par x-oss-meta- (par exemple, x-oss-persistent-headers:key1:base64_encode(value1),key2:base64_encode(value2)...) définis via PutObject sont renvoyés dans la réponse.

    x-oss-server-side-encryption

    String

    Renvoyé si l'objet utilise le chiffrement côté serveur. La valeur indique l'algorithme de chiffrement.

    x-oss-server-side-encryption-key-id

    String

    Renvoyé si l'objet utilise le chiffrement côté serveur basé sur KMS. La valeur correspond à l'ID de clé KMS.

    x-oss-storage-class

    String

    Classe de stockage de l'objet. Valeurs valides : Standard, IA, Archive, ColdArchive et DeepColdArchive.

    Classes de stockage.

    x-oss-object-type

    String

    Type de l'objet.

    • Les objets téléchargés en appelant PutObject ou créés en appelant CreateDirectory sont de type Normal.

    • Les objets téléchargés en appelant AppendObject sont de type Appendable.

    • Les objets téléchargés en appelant MultipartUpload sont de type Multipart.

    x-oss-next-append-position

    String

    Renvoyé pour les objets de type Appendable. Indique la position à partir de laquelle la prochaine opération d'ajout commence.

    x-oss-hash-crc64ecma

    String

    Valeur CRC-64 de l'objet, calculée à l'aide de l'algorithme CRC-64/XZ.

    Cet en-tête peut ne pas être renvoyé pour les objets créés avant qu'OSS ne prenne en charge CRC-64.

    x-oss-sealed-time

    String

    Renvoyé pour les objets Appendable scellés. Indique quand l'objet a été scellé, au format HTTP 1.1 GMT (par exemple, Sat, 11 Oct 2025 06:41:42 GMT).

    x-oss-transition-time

    String

    Heure à laquelle l'objet a été converti en Cold Archive ou Deep Cold Archive par une règle de cycle de vie.

    Remarque

    • Si vous supprimez un objet Cold Archive ou Deep Cold Archive plus de 180 jours après sa conversion, aucun frais de suppression anticipée n'est facturé. Si vous supprimez l'objet dans les 180 jours suivant sa conversion, des frais de suppression anticipée sont facturés.

    • Ce champ ne peut pas être utilisé pour déterminer l'heure à laquelle un objet est converti en classe de stockage IA ou Archive par une règle de cycle de vie. Le fait qu'un objet IA ou Archive respecte la durée de stockage minimale dépend de l'heure Last-Modified.

    x-oss-expiration

    String

    Heure d'expiration d'un objet dans un bucket pour lequel des règles de cycle de vie sont configurées.

    • Le versioning est activé pour le bucket

      • Une requête est envoyée sans versionId.

        Si l'objet demandé correspond à une règle de suppression dans la configuration du cycle de vie, l'en-tête x-oss-expiration est renvoyé dans la réponse pour indiquer l'heure d'expiration de la version actuelle de l'objet.

      • Une requête est envoyée avec un versionId.

        L'en-tête x-oss-expiration n'est pas renvoyé dans la réponse, que l'objet demandé corresponde ou non à une règle de suppression dans la configuration du cycle de vie.

    • Le versioning est désactivé pour le bucket

      • Si l'objet demandé correspond à une règle de suppression dans la configuration du cycle de vie, l'en-tête x-oss-expiration est renvoyé dans la réponse.

      • Si l'objet demandé ne correspond à aucune règle de suppression dans la configuration du cycle de vie, l'en-tête x-oss-expiration n'est pas renvoyé dans la réponse.

    x-oss-restore

    String

    Si la classe de stockage de l'objet est Archive, ColdArchive ou DeepColdArchive et qu'une requête Restore a été soumise, le statut de restauration est renvoyé dans cet en-tête :

    • Si aucune requête Restore n'a été soumise ou si l'objet restauré a expiré, cet en-tête n'est pas renvoyé.

    • Si la restauration est en cours, la valeur est ongoing-request="true".

    • Si la restauration est terminée, la valeur est ongoing-request="false", expiry-date="Sun, 16 Apr 2017 08:12:33 GMT", où expiry-date indique quand la copie restaurée expire.

    x-oss-process-status

    String

    Si une notification d'événement OSS est créée à l'aide de Simple Message Queue (SMQ) et qu'une règle correspondante existe, cet en-tête est renvoyé. La valeur correspond au résultat de la notification d'événement encodé en Base64 au format JSON.

    x-oss-request-charged

    String

    Renvoyé si le bucket utilise le mode pay-by-requester et si le demandeur n'est pas le propriétaire du bucket. La valeur est requester.

    Content-Md5

    String

    • Pour les objets Normal, il s'agit du hachage MD5 128 bits encodé en Base64 du contenu du message (hors en-têtes), calculé conformément à la RFC 1864.

    • Cet en-tête n'est pas renvoyé pour les objets Multipart ou Appendable.

    Last-Modified

    String

    Dernière heure de modification de l'objet, au format HTTP 1.1 GMT.

    Remarque

    • La durée de stockage minimale pour les objets de la classe de stockage Infrequent Access est de 30 jours. La durée est calculée à partir de l'heure Last-Modified de l'objet. Si vous supprimez un objet plus de 30 jours après son heure Last-Modified, aucun frais de suppression anticipée n'est facturé.

    • La durée de stockage minimale pour les objets de la classe de stockage Archive est de 60 jours. La durée est calculée à partir de l'heure Last-Modified de l'objet. Si vous supprimez un objet plus de 60 jours après son heure Last-Modified, aucun frais de suppression anticipée n'est facturé.

    Access-Control-Allow-Origin

    String

    Renvoyé si le bucket possède une règle CORS configurée et si l'origine de la requête correspond à la règle.

    Access-Control-Allow-Methods

    String

    Renvoyé si le bucket possède une règle CORS configurée et si Access-Control-Request-Method correspond à la règle.

    Access-Control-Max-Age

    String

    Renvoyé si le bucket possède une règle CORS configurée et si la requête correspond à la règle. Indique la durée de mise en cache de la requête preflight.

    Access-Control-Allow-Headers

    String

    Renvoyé si le bucket possède une règle CORS configurée et si la requête correspond à la règle.

    Access-Control-Expose-Headers

    String

    En-têtes auxquels le JavaScript côté client est autorisé à accéder. Renvoyé si le bucket possède une règle CORS configurée et si la requête correspond à la règle.

    x-oss-tagging-count

    String

    Nombre de tags associés à l'objet. Renvoyé uniquement si vous disposez de l'autorisation de lecture des tags.

    Cette opération prend également en charge les en-têtes de réponse communs tels que ETag et x-oss-request-id.

    Exemples

    • Le versioning est désactivé

      Exemple de requête

      HEAD /oss.jpg HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 7 Aug 2020 07:32:52 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

      Exemple de réponse (L'objet est un fichier)

      HTTP/1.1 200 OK
x-oss-request-id: 559CC9BDC755F95A6448****
x-oss-object-type: Normal
x-oss-storage-class: Archive
Date: Fri, 7 Aug 2020 07:32:52 GMT
Last-Modified: Fri, 24 Feb 2012 06:07:48 GMT
ETag: "fba9dede5f27731c9771645a3986****"
Content-Length: 344606
Content-Type: image/jpg
Connection: keep-alive
Server: AliyunOSS

      Exemple de réponse (L'objet est un dossier)

      HTTP/1.1 200 OK
x-oss-request-id: 559CC9BDC755F95A6448****
x-oss-object-type: Normal
x-oss-storage-class: Standard
Date: Wed, 31 Mar 2021 07:32:52 GMT
Last-Modified: Tue, 30 Mar 2021 06:07:48 GMT
ETag: "null"
Content-Length: 0
Content-Type: application/x-directory
Connection: keep-alive
Server: AliyunOSS

      Exemple de réponse (L'objet est un objet Appendable scellé)

      HTTP/1.1 200 OK
x-oss-request-id: 559CC9BDC755F95A6448****
x-oss-object-type: Appendable
x-oss-storage-class: Standard
x-oss-sealed-time: Sat, 11 Oct 2025 06:41:42 GMT
Date: Wed, 31 Mar 2021 07:32:52 GMT
Last-Modified: Tue, 30 Mar 2021 06:07:48 GMT
ETag: "fba9dede5f27731c9771645a3986****"
Content-Length: 100
Content-Type: text/plain
Connection: keep-alive
Server: AliyunOSS

    • Demande d'une version spécifique d'un objet (le versioning est activé)

      Exemple de requête

      HEAD /example?versionId=CAEQNRiBgICb8o6D0BYiIDNlNzk5NGE2M2Y3ZjRhZTViYTAxZGE0ZTEyMWYy****
Host: versioning-test.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 7 Aug 2020 06:27:12 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

      Exemple de réponse

      HTTP/1.1 200 OK
x-oss-versionId: CAEQNRiBgICb8o6D0BYiIDNlNzk5NGE2M2Y3ZjRhZTViYTAxZGE0ZTEyMWYy****
x-oss-request-id: 5CAC3B40B7AEADE01700****
x-oss-object-type: Normal
x-oss-storage-class: Archive
Date: Fri, 7 Aug 2020 06:27:12 GMT
Last-Modified: Fri, 7 Aug 2020 06:27:12 GMT
ETag: "A082B659EF78733A5A042FA253B1****"
Content-Length: 481827
Content-Type: text/html
Connection: keep-alive
Server: AliyunOSS

    • Demande de la dernière version d'un objet (le versioning est activé)

      Exemple de requête

      HEAD /example HTTP/1.1    
Host: versioning-test.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 7 Aug 2020 06:27:12 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

      Exemple de réponse

      HTTP/1.1 200 OK
x-oss-versionId: CAEQMxiBgMCZov2D0BYiIDY4MDllOTc2YmY5MjQxMzdiOGI3OTlhNTU0ODIx****
x-oss-request-id: 5CAC3B40B7AEADE01700****
x-oss-object-type: Normal
x-oss-storage-class: Archive
Date: Fri, 7 Aug 2020 06:27:12 GMT
Last-Modified: Fri, 7 Aug 2020 06:27:12 GMT
ETag: "3663F7B0B9D3153F884C821E7CF4****"
Content-Length: 485859
Content-Type: text/html
Connection: keep-alive
Server: AliyunOSS

    • Tâche de restauration en cours

      Exemple de requête

      HEAD /oss.jpg HTTP/1.1
Host: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 7 Aug 2020 07:32:52 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

      Exemple de réponse

      HTTP/1.1 200 OK
x-oss-request-id: 58F71A164529F18D7F00****
x-oss-object-type: Normal
x-oss-storage-class: Archive
x-oss-restore: ongoing-request="true"
Date: Fri, 7 Aug 2020 07:32:52 GMT
Last-Modified: Fri, 7 Aug 2020 06:07:48 GMT
ETag: "fba9dede5f27731c9771645a3986****"
Content-Length: 344606
Content-Type: image/jpg
Connection: keep-alive
Server: AliyunOSS

    • Tâche de restauration terminée

      Exemple de requête

      HEAD /oss.jpg HTTP/1.1
Host: oss-archive-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 7 Aug 2020 09:35:51 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

      Exemple de réponse

      HTTP/1.1 200 OK
x-oss-request-id: 58F725344529F18D7F00****
x-oss-object-type: Normal
x-oss-storage-class: Archive
x-oss-restore: ongoing-request="false", expiry-date="Sun, 16 Apr 2017 08:12:33 GMT"
Date: Fri, 7 Aug 2020 09:35:51 GMT
Last-Modified: Fri, 7 Aug 2020 06:07:48 GMT
ETag: "fba9dede5f27731c9771645a3986****"
Content-Length: 344606

    • Utilisation du chiffrement côté serveur avec SSE-OSS

      Exemple de requête

      HEAD /oss.jpg HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 7 Aug 2020 07:32:52 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

      Exemple de réponse

      HTTP/1.1 200 OK
x-oss-request-id: 559CC9BDC755F95A6448****
x-oss-object-type: Normal
x-oss-storage-class: Archive
x-oss-server-side-encryption: AES256
Date: Fri, 7 Aug 2020 07:32:52 GMT
Last-Modified: Fri, 7 Aug 2020 06:07:48 GMT
ETag: "fba9dede5f27731c9771645a3986****"
Content-Length: 344606
Content-Type: image/jpg
Connection: keep-alive
Server: AliyunOSS

    • Utilisation du chiffrement côté serveur avec SSE-KMS

      Exemple de requête

      HEAD /oss.jpg HTTP/1.1
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Date: Fri, 7 Aug 2020 07:32:52 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20250417/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

      Exemple de réponse

      HTTP/1.1 200 OK
x-oss-request-id: 559CC9BDC755F95A64485981
x-oss-object-type: Normal
x-oss-storage-class: Archive
x-oss-server-side-encryption: KMS
x-oss-server-side-encryption-key-id: 9468da86-3509-4f8d-a61e-6eab1eac****
Date: Fri, 7 Aug 2020 07:32:52 GMT
Last-Modified: Fri, 7 Aug 2020 06:07:48 GMT
ETag: "fba9dede5f27731c9771645a3986****"
Content-Length: 344606
Content-Type: image/jpg
Connection: keep-alive
Server: AliyunOSS

    SDK

    SDK pris en charge :

    ossutil

    La commande ossutil correspondante est head-object.

    Codes d'erreur

    Code d'erreur

    Code d'état HTTP

    Description

    NoSuchKey

    404

    L'objet demandé n'existe pas.

    SymlinkTargetNotExist

    404

    Le fichier demandé est un lien symbolique.

    InvalidTargetType

    400

    L'objet demandé est un lien symbolique et son objet cible est également un lien symbolique.

    NotModified

    304

    Cette erreur est renvoyée pour l'une des raisons suivantes :

    • L'en-tête de requête If-Modified-Since est spécifié, mais l'objet source n'a pas été modifié depuis l'heure spécifiée.

    • L'en-tête de requête If-None-Match est spécifié et l'ETag de l'objet source est identique à l'ETag que vous avez fourni.

    PreconditionFailed

    412

    Cette erreur est renvoyée pour l'une des raisons suivantes :

    • L'en-tête de requête If-Unmodified-Since est spécifié, mais l'heure spécifiée est antérieure à l'heure de modification réelle de l'objet.

    • L'en-tête de requête If-Match est spécifié, mais l'ETag de l'objet source n'est pas identique à l'ETag que vous avez fourni.