GetObjectMeta - get object metadata including ETag and size - Object Storage Service

Notlar

Not

Nesne bir sembolik bağ ise sembolik bağın meta verileri döndürülür.

Sürüm oluşturma devre dışıysa oss:GetObject iznine sahip olmanız gerekir. Sürüm oluşturma etkinse belirli bir sürümün meta verilerini almak için oss:GetObjectVersion iznine sahip olmalısınız. Sürümü x-oss-version-id istek üst bilgisiyle belirtin. RAM kullanıcısına özel izinler atama.

Sürüm Oluşturma

Varsayılan olarak GetObjectMeta geçerli sürümün meta verilerini alır. Geçerli sürüm bir silme işaretçisiyse OSS 404 Not Found yanıtını döndürür. İstekte versionId belirtirseniz o sürümün meta verileri döndürülür.

İstek sözdizimi

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

İstek üst bilgileri

DescribeRegions yalnızca ortak istek üst bilgilerini kullanır. Daha fazla bilgi için bkz. Ortak istek üst bilgileri.

Yanıt üst bilgileri

Yanıt üst bilgisi	Tür	Örnek	Açıklama
Content-Length	String	344606	Nesnenin bayt cinsinden boyutu.
ETag	String	5B3C1A2E053D763E1B002CC607C5****	ETag (varlık etiketi), nesne oluşturulduğunda içeriğini tanımlamak için üretilir. PutObject ile oluşturulan nesneler için ETag, içeriğin MD5 karmasıdır. Diğer yöntemlerle oluşturulan nesneler için ETag benzersiz bir değerdir ancak MD5 karması değildir. İçeriğin değişip değişmediğini kontrol etmek için ETag kullanın; veri bütünlüğünün MD5 doğrulaması için kullanmayın. Varsayılan değer: Yok
x-oss-transition-time	String	Tue, 23 Apr 2024 07:21:42 GMT	Yaşam döngüsü kuralının nesneyi Cold Archive veya Deep Cold Archive sınıfına dönüştürdüğü zaman. Not Cold Archive veya Deep Cold Archive nesnesini dönüşümden 180 gün sonra silerseniz erken silme ücreti alınmaz. Dönüşümden sonraki 180 gün içinde silerseniz erken silme ücreti uygulanır. Bu alan, yaşam döngüsü kuralıyla nesnenin IA veya Archive depolama sınıfına ne zaman dönüştürüldüğünü belirlemek için kullanılamaz. IA veya Archive nesnesinin minimum depolama süresi koşulunu karşılayıp karşılamadığı `Last-Modified` zamanına bağlıdır.
x-oss-last-access-time	String	Tue, 30 Mar 2021 06:07:48 GMT	Nesnenin son erişim zamanı (GMT biçimi, HTTP 1.1). Yalnızca erişim izleme etkinleştirildiğinde döndürülür. Nesneye erişildiğinde güncellenir. Önemli Son erişim zamanı eşzamansız olarak güncellenir. OSS genellikle bunu 24 saat içinde günceller. Bir nesneye 24 saat içinde birden çok kez erişilirse yalnızca en erken erişim zamanı kaydedilir.
Last-Modified	String	Fri, 24 Feb 2012 06:07:48 GMT	Nesnenin en son değiştirildiği zaman (GMT biçimi, HTTP 1.1). Not Infrequent Access depolama sınıfındaki nesneler için minimum depolama süresi 30 gündür. Süre, nesnenin Last-Modified zamanından hesaplanır. Last-Modified zamanından 30 gün sonra nesneyi silerseniz erken silme ücreti alınmaz. Archive Storage depolama sınıfındaki nesneler için minimum depolama süresi 60 gündür. Süre, nesnenin Last-Modified zamanından hesaplanır. Last-Modified zamanından 60 gün sonra nesneyi silerseniz erken silme ücreti alınmaz.
x-oss-version-id	String	CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk****	Nesnenin sürüm kimliği. Bu alan yalnızca nesnenin belirli bir sürümünün meta verilerini aldığınızda döndürülür.
x-oss-sealed-time	String	Sat, 11 Oct 2025 06:41:42 GMT	Eklenebilir nesne üzerinde mühürleme işleminin yapıldığı zaman (GMT biçimi, HTTP 1.1). Yalnızca mühürlenmiş eklenebilir nesneler için döndürülür.

Bu işlem ayrıca Ortak yanıt üst bilgileri değerlerini de döndürür.

Örnekler

Sürüm oluşturma devre dışı

İstek örneği

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=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Yanıt örneği

Önemli

Bir paket için hiyerarşik ad alanını etkinleştirip CreateDirectory işlemiyle bir klasör oluşturursanız GetObjectMeta işlemiyle klasörün meta verilerini aldığınızda ETag "null" olarak döndürülür.

Erişim izleme devre dışı

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

Erişim izleme etkin

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

Sürüm oluşturma etkin

İstek örneği

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=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

Yanıt örneği

Erişim izleme devre dışı

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

Erişim izleme etkin

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

Bu işlemi aşağıdaki SDK'ları kullanarak çağırabilirsiniz:

Komut satırı arayüzü ossutil

İlgili ossutil komutu get-object-meta komutudur.

İlgili kaynaklar

Nesne meta verilerini yönetme

Hata kodları

Hata kodu	HTTP durum kodu	Açıklama
Not Found	404	Belirtilen nesne mevcut değil.