Panggil GetObjectMeta untuk memperoleh metadata objek - Object Storage Service

Panggil operasi GetObjectMeta untuk memperoleh metadata objek. Metadata tersebut mencakup ETag, ukuran, dan waktu modifikasi terakhir objek. Konten objek tidak dikembalikan.

Catatan

Catatan

Jika objek tersebut merupakan tautan simbolik, informasi mengenai tautan simbolik tersebut akan dikembalikan.

Jika Pengendalian versi dinonaktifkan untuk suatu bucket, Anda harus memiliki izin oss:GetObject untuk memperoleh metadata objek. Jika Pengendalian versi diaktifkan untuk suatu bucket, Anda harus memiliki izin oss:GetObjectVersion untuk memperoleh metadata versi tertentu dari suatu objek. Untuk menentukan versi, gunakan header permintaan x-oss-version-id. Untuk informasi selengkapnya, lihat Berikan izin kustom kepada Pengguna RAM.

Pengendalian versi

Secara default, operasi GetObjectMeta mengambil metadata versi terkini dari suatu objek. Jika versi terkini objek tersebut adalah penanda hapus, kesalahan 404 Not Found dikembalikan. Jika Anda menentukan versionId dalam permintaan, metadata versi yang ditentukan akan dikembalikan.

Sintaksis permintaan

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

Header permintaan

Semua header dalam permintaan DescribeRegions merupakan header permintaan umum. Untuk informasi selengkapnya, lihat Header permintaan umum.

Header respons

Header respons	Tipe	Contoh	Deskripsi
Content-Length	String	344606	Ukuran objek dalam byte.
ETag	String	5B3C1A2E053D763E1B002CC607C5****	Ketika suatu objek dibuat, ETag (entity tag) dihasilkan untuk mengidentifikasi konten objek tersebut. Untuk objek yang dibuat melalui permintaan PutObject, ETag adalah Hash MD5 dari kontennya. Untuk objek yang dibuat dengan metode lain, ETag merupakan nilai unik tetapi bukan Hash MD5 dari kontennya. Anda dapat menggunakan ETag untuk memeriksa apakah konten objek telah berubah. Jangan gunakan ETag untuk Validasi MD5 guna memverifikasi integritas data. Nilai default: Tidak ada
x-oss-transition-time	String	Tue, 23 Apr 2024 07:21:42 GMT	Waktu ketika objek dikonversi ke kelas penyimpanan Penyimpanan Arsip Dingin atau Deep Cold Archive oleh aturan siklus hidup. Catatan Jika Anda menghapus objek Penyimpanan Arsip Dingin atau Deep Cold Archive lebih dari 180 hari setelah dikonversi, tidak dikenakan biaya penghapusan dini. Jika Anda menghapus objek tersebut dalam waktu 180 hari setelah dikonversi, biaya penghapusan dini akan dikenakan. Bidang ini tidak dapat digunakan untuk menentukan waktu ketika objek dikonversi ke kelas penyimpanan Akses Jarang atau Arsip oleh aturan siklus hidup. Apakah objek Akses Jarang atau Arsip memenuhi persyaratan durasi penyimpanan minimum bergantung pada waktu `Last-Modified`.
x-oss-last-access-time	String	Tue, 30 Mar 2021 06:07:48 GMT	Waktu akses terakhir objek. Waktu tersebut dalam format GMT sesuai spesifikasi HTTP 1.1. Jika Pelacakan akses diaktifkan, nilai bidang ini diperbarui saat objek diakses. Jika Pelacakan akses dinonaktifkan, bidang ini tidak dikembalikan. Penting Waktu akses terakhir objek diperbarui secara asinkron. OSS biasanya memperbarui waktu akses terakhir objek dalam waktu 24 jam. Jika suatu objek diakses beberapa kali dalam rentang 24 jam, OSS hanya memperbarui waktu akses paling awal.
Last-Modified	String	Fri, 24 Feb 2012 06:07:48 GMT	Waktu ketika objek terakhir dimodifikasi. Waktu tersebut dalam format GMT sesuai spesifikasi HTTP 1.1. Catatan Durasi penyimpanan minimum untuk objek dalam kelas penyimpanan Akses Jarang adalah 30 hari. Durasi tersebut dihitung sejak waktu Last-Modified objek. Jika Anda menghapus objek lebih dari 30 hari setelah waktu Last-Modified-nya, tidak dikenakan biaya penghapusan dini. Durasi penyimpanan minimum untuk objek dalam kelas penyimpanan Archive Storage adalah 60 hari. Durasi tersebut dihitung sejak waktu Last-Modified objek. Jika Anda menghapus objek lebih dari 60 hari setelah waktu Last-Modified-nya, tidak dikenakan biaya penghapusan dini.
x-oss-version-id	String	CAEQNRiBgIDMh4mD0BYiIDUzNDA4OGNmZjBjYTQ0YmI4Y2I4ZmVlYzJlNGVk****	ID versi objek. Bidang ini hanya dikembalikan saat Anda memperoleh metadata versi tertentu dari suatu objek.
x-oss-sealed-time	String	Sat, 11 Oct 2025 06:41:42 GMT	Waktu ketika operasi seal dilakukan pada objek yang dapat ditambahkan yang berada dalam status Sealed. Waktu tersebut dalam format GMT sesuai spesifikasi HTTP 1.1. Bidang ini hanya dikembalikan saat Anda mengakses objek yang dapat ditambahkan yang telah disegel.

Operasi ini juga menggunakan header respons umum. Untuk informasi selengkapnya, lihat Header respons umum.

Contoh

Pengendalian versi dinonaktifkan

Contoh permintaan

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

Contoh respons

Penting

Jika Anda mengaktifkan namespace hirarkis untuk suatu bucket lalu membuat folder dengan memanggil operasi CreateDirectory, ETag akan dikembalikan sebagai "null" saat Anda memanggil operasi GetObjectMeta untuk memperoleh metadata folder tersebut.

Pelacakan akses dinonaktifkan

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

Pelacakan akses diaktifkan

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

Pengendalian versi diaktifkan

Contoh permintaan

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

Contoh respons

Pelacakan akses dinonaktifkan

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

Pelacakan akses diaktifkan

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

Anda dapat memanggil operasi ini menggunakan kit pengembangan perangkat lunak (SDK) berikut:

Antarmuka baris perintah ossutil

Untuk perintah ossutil yang sesuai dengan operasi GetObjectMeta, lihat get-object-meta.

Referensi

Untuk informasi selengkapnya mengenai metadata objek, lihat Kelola metadata objek.

Kode kesalahan

Kode kesalahan	Kode status HTTP	Deskripsi
Not Found	404	Objek yang ditentukan tidak ada.