All Products
Search

This Product

    Object Storage Service:HeadObject

    Document Center

    Object Storage Service:HeadObject

    Last Updated:May 21, 2026

    Operasi HeadObject mengambil metadata objek. Operasi ini tidak mengembalikan konten objek.

    Versioning

    • Jika Anda memanggil operasi HeadObject tanpa menentukan versionId, OSS mengembalikan metadata versi objek saat ini. Jika versi objek saat ini adalah delete marker, OSS mengembalikan 404 NoSuchKey.

    • Jika Anda memanggil operasi HeadObject dan menentukan versionId, OSS mengembalikan metadata versi objek yang Anda tentukan. Jangan menentukan versionId milik delete marker. Jika tetap dilakukan, OSS mengembalikan 405 MethodNotAllowed.

    Sintaksis request

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

    Request header

    Nama

    Tipe

    Wajib

    Deskripsi

    If-Modified-Since

    String

    Tidak

    Jika waktu yang ditentukan lebih awal daripada waktu modifikasi aktual objek, OSS mengembalikan 200 OK beserta metadata objek. Jika tidak, OSS mengembalikan 304 Not Modified.

    Nilai default: Tidak ada

    If-Unmodified-Since

    String

    Tidak

    Jika waktu yang ditentukan sama dengan atau lebih baru daripada waktu modifikasi aktual objek, OSS mengembalikan 200 OK beserta metadata objek. Jika tidak, OSS mengembalikan 412 Precondition Failed.

    Nilai default: Tidak ada

    If-Match

    String

    Tidak

    Jika ETag yang ditentukan cocok dengan ETag objek, OSS mengembalikan 200 OK beserta metadata objek. Jika tidak, OSS mengembalikan 412 Precondition Failed.

    Nilai default: Tidak ada

    If-None-Match

    String

    Tidak

    Jika ETag yang ditentukan tidak cocok dengan ETag objek, OSS mengembalikan 200 OK beserta metadata objek. Jika tidak, OSS mengembalikan 304 Not Modified.

    Nilai default: Tidak ada

    Operasi ini juga mencakup request header umum seperti Host dan Date. Untuk informasi selengkapnya, lihat Request header umum.

    Response header

    Jika objek yang diminta adalah symbolic link, response header dijelaskan sebagai berikut:

    • Content-Length, ETag, x-oss-storage-class, dan Content-Md5 adalah metadata file objek.

    • Last-Modified adalah waktu modifikasi terakhir dari symbolic link atau file objek, mana pun yang lebih baru.

    • Response header lainnya menunjukkan metadata symbolic link.

    Nama

    Tipe

    Deskripsi

    x-oss-meta-*

    String

    Parameter yang diawali dengan x-oss-meta- adalah header metadata yang ditentukan pengguna. Jika Anda menetapkan metadata kustom berawalan x-oss-meta- saat memanggil operasi PutObject, header metadata kustom tersebut disertakan dalam respons.

    Header kustom yang tidak diawali dengan x-oss-meta-

    String

    Jika Anda menentukan header kustom yang tidak diawali dengan x-oss-meta-, misalnya x-oss-persistent-headers:key1:base64_encode(value1),key2:base64_encode(value2)...., saat memanggil operasi PutObject, header kustom terkait ditambahkan ke respons.

    x-oss-server-side-encryption

    String

    Jika objek disimpan dengan enkripsi sisi server, header ini dikembalikan dalam respons. Nilai header ini menunjukkan algoritma enkripsi sisi server yang digunakan untuk objek tersebut.

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

    String

    Jika enkripsi sisi server digunakan saat objek dibuat dan metode enkripsinya adalah KMS, header ini disertakan dalam respons. Header ini menunjukkan ID KMS key milik pengguna.

    x-oss-storage-class

    String

    Kelas penyimpanan objek. Nilai valid: Standard, IA, Archive, ColdArchive, dan DeepColdArchive.

    Untuk informasi selengkapnya, lihat Storage classes.

    x-oss-object-type

    String

    Tipe objek.

    • Objek yang diunggah dengan memanggil PutObject atau dibuat dengan memanggil CreateDirectory bertipe Normal.

    • Objek yang diunggah dengan memanggil AppendObject bertipe Appendable.

    • Objek yang diunggah dengan memanggil MultipartUpload bertipe Multipart.

    x-oss-next-append-position

    String

    Header ini dikembalikan untuk objek Appendable guna menentukan posisi awal operasi append berikutnya.

    x-oss-hash-crc64ecma

    String

    Nilai cyclic redundancy check 64-bit (CRC-64) dari objek. Nilai ini dihitung berdasarkan algoritma CRC-64/XZ.

    Response header ini mungkin tidak dikembalikan saat Anda memanggil operasi HeadObject untuk objek yang dibuat sebelum OSS mendukung CRC-64.

    x-oss-sealed-time

    String

    Header ini dikembalikan untuk objek Appendable yang telah disegel. Nilai header ini menunjukkan waktu saat objek tersebut disegel. Waktu menggunakan format GMT yang ditentukan dalam HTTP 1.1, misalnya Sat, 11 Oct 2025 06:41:42 GMT.

    x-oss-transition-time

    String

    Waktu saat objek dikonversi ke kelas penyimpanan Cold Archive atau Deep Cold Archive oleh aturan lifecycle.

    x-oss-expiration

    String

    Waktu kedaluwarsa objek dalam bucket yang dikonfigurasi dengan aturan lifecycle.

    • Versioning diaktifkan untuk bucket

      • Request dikirim tanpa versionId.

        Jika objek yang diminta cocok dengan aturan hapus dalam konfigurasi lifecycle, header x-oss-expiration dikembalikan dalam respons untuk menunjukkan waktu kedaluwarsa versi objek saat ini.

      • Request dikirim dengan versionId.

        Header x-oss-expiration tidak dikembalikan dalam respons, terlepas dari apakah objek yang diminta cocok dengan aturan hapus dalam konfigurasi lifecycle.

    • Versioning dinonaktifkan untuk bucket

      • Jika objek yang diminta cocok dengan aturan hapus dalam konfigurasi lifecycle, header x-oss-expiration dikembalikan dalam respons.

      • Jika objek yang diminta tidak cocok dengan aturan hapus dalam konfigurasi lifecycle, header x-oss-expiration tidak dikembalikan dalam respons.

    x-oss-restore

    String

    Jika kelas penyimpanan objek adalah Archive, ColdArchive, atau DeepColdArchive, dan Anda telah mengirim request Restore, status pemulihan objek dikembalikan pada response header x-oss-restore. Kasus berikut dapat terjadi:

    • Jika tidak ada request Restore yang dikirim atau objek yang dipulihkan telah kedaluwarsa, header ini tidak dikembalikan.

    • Jika request Restore dikirim tetapi tugas pemulihan belum selesai, nilai x-oss-restore adalah ongoing-request="true".

    • Jika request Restore dikirim dan tugas pemulihan telah selesai, nilai x-oss-restore adalah ongoing-request="false", expiry-date="Sun, 16 Apr 2017 08:12:33 GMT". expiry-date menunjukkan waktu kedaluwarsa objek yang dipulihkan.

    x-oss-process-status

    String

    Setelah Anda membuat notifikasi event OSS menggunakan Simple Message Queue (SMQ), jika ada aturan notifikasi event yang cocok saat Anda melakukan operasi OSS terkait, header ini disertakan dalam respons. Nilainya adalah hasil notifikasi event dalam format JSON yang dikodekan Base64.

    x-oss-request-charged

    String

    Jika bucket pemilik objek diatur ke mode pay-by-requester dan pemohon bukan pemilik bucket, header ini disertakan dalam respons. Nilai header ini adalah requester.

    Content-Md5

    String

    • Untuk objek Normal, nilai MD5 128-bit dari konten pesan (tidak termasuk header) dihitung berdasarkan RFC 1864. Nilai ini kemudian dikodekan Base64 untuk memperoleh nilai Content-Md5.

    • Header ini tidak dikembalikan untuk objek Multipart atau Appendable.

    Last-Modified

    String

    Tanggal terakhir objek dimodifikasi. Formatnya adalah waktu GMT yang ditentukan dalam HTTP 1.1.

    Access-Control-Allow-Origin

    String

    Jika aturan cross-origin resource sharing (CORS) dikonfigurasi untuk bucket pemilik objek dan origin request memenuhi aturan CORS tersebut, origin ini disertakan dalam respons.

    Access-Control-Allow-Methods

    String

    Jika aturan CORS dikonfigurasi untuk bucket pemilik objek dan Access-Control-Request-Method dari request memenuhi aturan CORS tersebut, metode yang diizinkan disertakan dalam respons.

    Access-Control-Max-Age

    String

    Jika aturan CORS dikonfigurasi untuk bucket pemilik objek dan request memenuhi aturan CORS tersebut, MaxAgeSeconds disertakan dalam respons.

    Access-Control-Allow-Headers

    String

    Jika aturan CORS dikonfigurasi untuk bucket pemilik objek dan request memenuhi aturan CORS tersebut, header-header ini disertakan dalam respons.

    Access-Control-Expose-Headers

    String

    Daftar header yang dapat diakses oleh program JavaScript di sisi klien. Jika aturan CORS dikonfigurasi untuk bucket pemilik objek dan request memenuhi aturan CORS tersebut, ExposeHeader disertakan dalam respons.

    x-oss-tagging-count

    String

    Jumlah tag yang terkait dengan objek. Header ini dikembalikan hanya jika Anda memiliki izin untuk membaca tag.

    Operasi ini juga mencakup response header umum seperti ETag dan x-oss-request-id. Untuk informasi selengkapnya, lihat Response header umum.

    Contoh

    • Versioning dinonaktifkan

      Contoh request

      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

      Contoh respons (objek berupa file)

      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/jpeg
Connection: keep-alive
Server: AliyunOSS

      Contoh respons (objek berupa folder)

      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

      Contoh respons (objek Appendable yang telah disegel)

      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

    • Meminta versi tertentu dari sebuah objek (versioning diaktifkan)

      Contoh request

      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

      Contoh respons

      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

    • Meminta versi terbaru dari sebuah objek (versioning diaktifkan)

      Contoh request

      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

      Contoh respons

      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

    • Tugas Restore sedang berlangsung

      Contoh request

      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

      Contoh respons

      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/jpeg
Connection: keep-alive
Server: AliyunOSS

    • Tugas Restore selesai

      Contoh request

      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

      Contoh respons

      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

    • Menggunakan enkripsi sisi server dengan SSE-OSS

      Contoh request

      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

      Contoh respons

      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/jpeg
Connection: keep-alive
Server: AliyunOSS

    • Menggunakan enkripsi sisi server dengan SSE-KMS

      Contoh request

      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

      Contoh respons

      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/jpeg
Connection: keep-alive
Server: AliyunOSS

    SDK

    Operasi ini didukung oleh SDK berikut:

    ossutil

    Untuk perintah ossutil yang sesuai dengan operasi HeadObject, lihat head-object.

    Kode error

    Kode error

    Kode status HTTP

    Deskripsi

    NoSuchKey

    404

    Objek yang diminta tidak ada.

    SymlinkTargetNotExist

    404

    File yang diminta adalah symbolic link.

    InvalidTargetType

    400

    Objek yang diminta adalah symbolic link, dan objek targetnya juga merupakan symbolic link.

    NotModified

    304

    Error ini dikembalikan karena salah satu alasan berikut:

    • Request header If-Modified-Since ditentukan, tetapi objek sumber tidak dimodifikasi sejak waktu yang ditentukan.

    • Request header If-None-Match ditentukan, dan ETag objek sumber sama dengan ETag yang Anda berikan.

    PreconditionFailed

    412

    Error ini dikembalikan karena salah satu alasan berikut:

    • Request header If-Unmodified-Since ditentukan, tetapi waktu yang ditentukan lebih awal daripada waktu modifikasi aktual objek.

    • Request header If-Match ditentukan, tetapi ETag objek sumber tidak sama dengan ETag yang Anda berikan.