Tüm Ürünler
Search

Bu Ürün

    Object Storage Service:HeadObject

    Belge Merkezi

    Object Storage Service:HeadObject

    Son Güncelleme:Oct 01, 2026

    HeadObject işlemi, nesne içeriğini döndürmeden nesnenin meta verilerini alır.

    Sürüm Oluşturma

    • Bir versionId belirtmeden HeadObject işlemini çağırırsanız mevcut sürümün meta verileri döndürülür. Mevcut sürüm bir silme işaretçisi ise OSS 404 NoSuchKey hatası döndürür.

    • Belirli bir versionId ile HeadObject işlemini çağırırsanız ilgili sürümün meta verileri döndürülür. Silme işaretçisinin versionId değerini belirtmeyin; aksi takdirde OSS 405 MethodNotAllowed hatası döndürür.

    İzinler

    Varsayılan olarak bir Alibaba Cloud hesabının tüm izinleri bulunur. Bir Alibaba Cloud hesabı altındaki RAM kullanıcıları veya RAM rollerinin varsayılan olarak hiçbir izni yoktur. Alibaba Cloud hesabı veya hesap yöneticisi, işlemler için gerekli izinleri RAM ilkeleri veya Bucket Policy aracılığıyla vermelidir.


    API


    Eylem


    Açıklama


    HeadObject


    oss:GetObject


    Bir nesnenin meta verilerini sorgular.

    İstek sözdizimi

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

    İstek üstbilgileri


    Ad


    Tür


    Gerekli


    Açıklama


    If-Modified-Since


    Dize


    Hayır

    Belirtilen zaman nesnenin gerçek değiştirilme zamanından önceyse OSS 200 OK yanıtını nesne meta verileriyle birlikte döndürür. Aksi durumda OSS 304 Not Modified döndürür.

    Varsayılan değer: Yok


    If-Unmodified-Since


    Dize


    Hayır

    Belirtilen zaman nesnenin gerçek değiştirilme zamanına eşitse veya ondan sonraysa OSS 200 OK yanıtını nesne meta verileriyle birlikte döndürür. Aksi durumda OSS 412 Precondition Failed döndürür.

    Varsayılan değer: Yok


    If-Match


    Dize


    Hayır

    Belirtilen ETag nesnenin ETag değeriyle eşleşirse OSS 200 OK yanıtını nesne meta verileriyle birlikte döndürür. Aksi durumda OSS 412 Precondition Failed döndürür.

    Varsayılan değer: Yok


    If-None-Match


    Dize


    Hayır

    Belirtilen ETag nesnenin ETag değeriyle eşleşmezse OSS 200 OK yanıtını nesne meta verileriyle birlikte döndürür. Aksi durumda OSS 304 Not Modified döndürür.

    Varsayılan değer: Yok

    Bu işlem ayrıca Host ve Date gibi Ortak istek üstbilgilerini da destekler.

    Yanıt üstbilgileri

    İstenen nesne bir sembolik bağlantıysa yanıt üstbilgileri aşağıdaki gibi davranır:

    • Content-Length, ETag, x-oss-storage-class ve Content-Md5 nesne dosyasının meta verileridir.

    • Last-Modified, sembolik bağlantının veya nesne dosyasının en son değiştirilme zamanıdır (hangisi daha geçse).

    • Diğer yanıt üstbilgileri sembolik bağlantının meta verilerini gösterir.

    Ad

    Tür

    Açıklama

    x-oss-meta-*

    Dize

    PutObject ile x-oss-meta- öneki kullanılarak ayarlanan kullanıcı tanımlı meta veri üstbilgileri yanıtta döndürülür.

    x-oss-meta- ile başlamayan özel üstbilgiler

    Dize

    PutObject ile ayarlanan ve x-oss-meta- ile başlamayan özel üstbilgiler (örneğin, key1:base64_encode(value1),key2:base64_encode(value2)...) yanıtta döndürülür.

    x-oss-server-side-encryption

    Dize

    Nesne sunucu tarafı şifreleme kullanıyorsa döndürülür. Değer şifreleme algoritmasını belirtir.

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

    Dize

    Nesne KMS tabanlı sunucu tarafı şifreleme kullanıyorsa döndürülür. Değer KMS anahtar kimliğidir.

    x-oss-storage-class

    Dize

    Nesnenin depolama sınıfı. Geçerli değerler: Standard, IA, Archive, ColdArchive ve DeepColdArchive.

    Depolama sınıfları.

    x-oss-object-type

    Dize

    Nesnenin türü.

    • PutObject çağrısı yaparak yüklenen veya CreateDirectory çağrısı yaparak oluşturulan nesneler Normal türündedir.

    • AppendObject çağrısı yaparak yüklenen nesneler Appendable türündedir.

    • MultipartUpload çağrısı yaparak yüklenen nesneler Multipart türündedir.

    x-oss-next-append-position

    Dize

    Appendable nesneler için döndürülür. Sonraki ekleme işleminin başlayacağı konumu belirtir.

    x-oss-hash-crc64ecma

    Dize

    CRC-64/XZ algoritması kullanılarak hesaplanan nesnenin CRC-64 değeri.

    OSS'in CRC-64 desteğinden önce oluşturulan nesneler için bu üstbilgi döndürülmeyebilir.

    x-oss-sealed-time

    Dize

    Mühürlenmiş Appendable nesneler için döndürülür. Nesnenin mühürlendiği zamanı HTTP 1.1 GMT biçiminde belirtir (örneğin, Sat, 11 Oct 2025 06:41:42 GMT).

    x-oss-transition-time

    Dize

    Nesnenin bir yaşam döngüsü kuralı tarafından Cold Archive veya Deep Cold Archive sınıfına dönüştürüldüğü zaman.

    Not

    • Cold Archive veya Deep Cold Archive nesnesini dönüştürüldükten 180 gün sonra silerseniz erken silme ücreti alınmaz. Dönüştürüldükten sonraki 180 gün içinde silerseniz erken silme ücreti alınır.

    • Bu alan, bir nesnenin yaşam döngüsü kuralı tarafından IA veya Archive depolama sınıfına dönüştürüldüğü zamanı belirlemek için kullanılamaz. IA veya Archive nesnesinin minimum depolama süresi gereksinimini karşılayıp karşılamadığı Last-Modified zamanına bağlıdır.

    x-oss-expiration

    Dize

    Yaşam döngüsü kuralları yapılandırılmış bir paketteki nesnenin sona erme zamanı.

    • Paket için sürüm oluşturma etkinleştirilmiş

      • versionId olmadan istek gönderilir.

        İstenen nesne yaşam döngüsü yapılandırmasındaki bir silme kuralıyla eşleşirse yanıtta x-oss-expiration üstbilgisi döndürülerek nesnenin mevcut sürümünün sona erme zamanı belirtilir.

      • versionId ile istek gönderilir.

        İstenen nesne yaşam döngüsü yapılandırmasındaki bir silme kuralıyla eşleşse bile yanıtta x-oss-expiration üstbilgisi döndürülmez.

    • Paket için sürüm oluşturma devre dışı bırakılmış

      • İstenen nesne yaşam döngüsü yapılandırmasındaki bir silme kuralıyla eşleşirse yanıtta x-oss-expiration üstbilgisi döndürülür.

      • İstenen nesne yaşam döngüsü yapılandırmasındaki bir silme kuralıyla eşleşmezse yanıtta x-oss-expiration üstbilgisi döndürülmez.

    x-oss-restore

    Dize

    Nesnenin depolama sınıfı Archive, ColdArchive veya DeepColdArchive ise ve bir Restore isteği gönderildiyse geri yükleme durumu bu üstbilgide döndürülür:

    • Restore isteği gönderilmediyse veya geri yüklenen nesnenin süresi dolduysa bu üstbilgi döndürülmez.

    • Geri yükleme devam ediyorsa değer ongoing-request="true" olur.

    • Geri yükleme tamamlandıysa değer ongoing-request="false", expiry-date="Sun, 16 Apr 2017 08:12:33 GMT" olur; burada expiry-date geri yüklenen kopyanın ne zaman sona ereceğini belirtir.

    x-oss-process-status

    Dize

    Simple Message Queue (SMQ) kullanılarak bir OSS olay bildirimi oluşturulduysa ve eşleşen bir kural varsa bu üstbilgi döndürülür. Değer, JSON biçimindeki Base64 kodlu olay bildirimi sonucudur.

    x-oss-request-charged

    Dize

    Paket istekte bulunan tarafından ödeme modunu kullanıyorsa ve istekte bulunan paket sahibi değilse döndürülür. Değer requester olur.

    Content-Md5

    Dize

    • Normal nesneler için RFC 1864'e göre hesaplanan mesaj içeriğinin (üstbilgiler hariç) Base64 kodlu 128 bitlik MD5 karma değeridir.

    • Multipart veya Appendable nesneler için bu üstbilgi döndürülmez.

    Last-Modified

    Dize

    Nesnenin en son değiştirilme zamanı, HTTP 1.1 GMT biçimindedir.

    Not

    • Sık Olmayan Erişim depolama sınıfındaki nesnelerin minimum depolama süresi 30 gündür. Süre nesnenin Last-Modified zamanından itibaren hesaplanır. Last-Modified zamanından 30 gün sonra bir nesneyi silerseniz erken silme ücreti alınmaz.

    • Arşiv Depolama sınıfındaki nesnelerin minimum depolama süresi 60 gündür. Süre nesnenin Last-Modified zamanından itibaren hesaplanır. Last-Modified zamanından 60 gün sonra bir nesneyi silerseniz erken silme ücreti alınmaz.

    Access-Control-Allow-Origin

    Dize

    Pakette bir CORS kuralı yapılandırılmışsa ve istek kaynağı kurala uyuyorsa döndürülür.

    Access-Control-Allow-Methods

    Dize

    Pakette bir CORS kuralı yapılandırılmışsa ve Access-Control-Request-Method kurala uyuyorsa döndürülür.

    Access-Control-Max-Age

    Dize

    Pakette bir CORS kuralı yapılandırılmışsa ve istek kurala uyuyorsa döndürülür. Ön uçuş önbelleğe alma süresini belirtir.

    Access-Control-Allow-Headers

    Dize

    Pakette bir CORS kuralı yapılandırılmışsa ve istek kurala uyuyorsa döndürülür.

    Access-Control-Expose-Headers

    Dize

    İstemci tarafı JavaScript'in erişmesine izin verilen üstbilgiler. Pakette bir CORS kuralı yapılandırılmışsa ve istek kurala uyuyorsa döndürülür.

    x-oss-tagging-count

    Dize

    Nesneyle ilişkili etiket sayısı. Yalnızca etiketleri okuma izniniz varsa döndürülür.

    Bu işlem ayrıca ETag ve x-oss-request-id gibi Ortak yanıt üstbilgilerini da destekler.

    Örnekler

    • Sürüm oluşturma devre dışı bırakıldı

      İstek örneği

      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

      Yanıt örneği (Nesne bir dosyadır)

      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

      Yanıt örneği (Nesne bir klasördür)

      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

      Yanıt örneği (Nesne mühürlenmiş bir Appendable nesnedir)

      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

    • Bir nesnenin belirli bir sürümünü isteme (sürüm oluşturma etkin)

      İstek örneği

      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

      Yanıt örneği

      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

    • Bir nesnenin en son sürümünü isteme (sürüm oluşturma etkin)

      İstek örneği

      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

      Yanıt örneği

      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

    • Geri yükleme görevi devam ediyor

      İstek örneği

      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

      Yanıt örneği

      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

    • Geri yükleme görevi tamamlandı

      İstek örneği

      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

      Yanıt örneği

      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

    • SSE-OSS ile sunucu tarafı şifreleme kullanma

      İstek örneği

      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

      Yanıt örneği

      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

    • SSE-KMS ile sunucu tarafı şifreleme kullanma

      İstek örneği

      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

      Yanıt örneği

      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'lar

    Desteklenen SDK'lar:

    ossutil

    İlgili ossutil komutu head-object şeklindedir.

    Hata kodları

    Hata kodu

    HTTP durum kodu

    Açıklama

    NoSuchKey

    404

    İstenen nesne mevcut değil.

    SymlinkTargetNotExist

    404

    İstenen dosya bir sembolik bağlantıdır.

    InvalidTargetType

    400

    İstenen nesne bir sembolik bağlantıdır ve hedef nesnesi de bir sembolik bağlantıdır.

    NotModified

    304

    Bu hata aşağıdaki nedenlerden biri nedeniyle döndürülür:

    • If-Modified-Since istek üstbilgisi belirtilmiştir ancak kaynak nesne belirtilen zamandan bu yana değiştirilmemiştir.

    • If-None-Match istek üstbilgisi belirtilmiştir ve kaynak nesnenin ETag değeri sizin sağladığınız ETag değeriyle aynıdır.

    PreconditionFailed

    412

    Bu hata aşağıdaki nedenlerden biri nedeniyle döndürülür:

    • If-Unmodified-Since istek üstbilgisi belirtilmiştir ancak belirtilen zaman nesnenin gerçek değiştirilme zamanından öncedir.

    • If-Match istek üstbilgisi belirtilmiştir ancak kaynak nesnenin ETag değeri sizin sağladığınız ETag değeriyle aynı değildir.