Object Storage Service：HeadObject

Nama

Tipe

Wajib

Deskripsi

If-Modified-Since

String

Tidak

Jika waktu yang ditentukan lebih awal daripada waktu modifikasi aktual objek, respons 200 OK dan metadata objek dikembalikan. Jika tidak, respons 304 Not Modified dikembalikan.

Nilai default: Tidak ada

If-Unmodified-Since

String

Tidak

Jika waktu yang ditentukan sama dengan atau lebih baru daripada waktu modifikasi aktual objek, respons 200 OK dan metadata objek dikembalikan. Jika tidak, respons 412 Precondition Failed dikembalikan.

Nilai default: Tidak ada

If-Match

String

Tidak

Jika ETag yang ditentukan sesuai dengan ETag objek, respons 200 OK dan metadata objek dikembalikan. Jika tidak, respons 412 Precondition Failed dikembalikan.

Nilai default: Tidak ada

If-None-Match

String

Tidak

Jika ETag yang ditentukan tidak sesuai dengan ETag objek, respons 200 OK dan metadata objek dikembalikan. Jika tidak, respons 304 Not Modified dikembalikan.

Nilai default: Tidak ada

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 dengan awalan x-oss-meta- saat memanggil operasi PutObject, header metadata kustom tersebut akan 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-, seperti x-oss-persistent-headers:key1:base64_encode(value1),key2:base64_encode(value2)..., saat memanggil operasi PutObject, header kustom yang sesuai akan 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 kunci KMS pengguna.

x-oss-storage-class

String

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

Untuk informasi selengkapnya, lihat Kelas penyimpanan.

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 Pemeriksaan redundansi siklik 64-bit (CRC-64) objek. Nilai ini dihitung berdasarkan algoritma CRC-64/XZ.

Header respons ini mungkin tidak dikembalikan ketika 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 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 objek dikonversi ke kelas penyimpanan Cold Archive atau Deep Cold Archive oleh aturan siklus hidup.

x-oss-expiration

String

Waktu kedaluwarsa objek dalam bucket yang dikonfigurasi dengan aturan siklus hidup.

• Pengendalian versi diaktifkan untuk bucket

  • Permintaan dikirim tanpa versionId.

    Jika objek yang diminta sesuai dengan aturan penghapusan dalam konfigurasi siklus hidup, header x-oss-expiration dikembalikan dalam respons untuk menunjukkan waktu kedaluwarsa versi objek saat ini.

  • Permintaan dikirim dengan versionId.

    Header x-oss-expiration tidak dikembalikan dalam respons, terlepas dari apakah objek yang diminta sesuai dengan aturan penghapusan dalam konfigurasi siklus hidup.

• Pengendalian versi dinonaktifkan untuk bucket

  • Jika objek yang diminta sesuai dengan aturan penghapusan dalam konfigurasi siklus hidup, header x-oss-expiration dikembalikan dalam respons.

  • Jika objek yang diminta tidak sesuai dengan aturan penghapusan dalam konfigurasi siklus hidup, header x-oss-expiration tidak dikembalikan dalam respons.

x-oss-restore

String

Jika kelas penyimpanan objek adalah Archive, ColdArchive, atau DeepColdArchive, dan Anda telah mengirimkan permintaan Restore, status restore objek dikembalikan dalam header respons x-oss-restore. Beberapa kemungkinan berikut dapat terjadi:

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

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

• Jika permintaan Restore dikirim dan tugas restore 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 terdapat aturan notifikasi event yang sesuai saat Anda melakukan operasi OSS terkait, header ini disertakan dalam respons. Nilainya adalah hasil notifikasi event yang dikodekan Base64 dalam format JSON.

x-oss-request-charged

String

Jika bucket tempat objek berada diatur ke mode bayar-per-permintaan dan peminta 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 mendapatkan nilai Content-Md5.

• Header ini tidak dikembalikan untuk objek Multipart atau Appendable.

Last-Modified

String

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

Access-Control-Allow-Origin

String

Jika aturan Berbagi sumber daya lintas asal (CORS) dikonfigurasi untuk bucket tempat objek berada dan origin permintaan memenuhi aturan CORS yang ditentukan, origin tersebut disertakan dalam respons.

Access-Control-Allow-Methods

String

Jika aturan CORS dikonfigurasi untuk bucket tempat objek berada dan Access-Control-Request-Method permintaan memenuhi aturan CORS yang ditentukan, metode yang diizinkan disertakan dalam respons.

Access-Control-Max-Age

String

Jika aturan CORS dikonfigurasi untuk bucket tempat objek berada dan permintaan memenuhi aturan CORS, MaxAgeSeconds disertakan dalam respons.

Access-Control-Allow-Headers

String

Jika aturan CORS dikonfigurasi untuk bucket tempat objek berada dan permintaan memenuhi aturan CORS yang ditentukan, header-header ini disertakan dalam respons.

Access-Control-Expose-Headers

String

Daftar header yang boleh diakses oleh program JavaScript sisi klien. Jika aturan CORS dikonfigurasi untuk bucket tempat objek berada dan permintaan memenuhi aturan CORS yang ditentukan, ExposeHeader disertakan dalam respons.

x-oss-tagging-count

String

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

Kode error

Kode status HTTP

Deskripsi

NoSuchKey

404

Objek yang diminta tidak ada.

SymlinkTargetNotExist

404

File yang diminta adalah tautan simbolik.

InvalidTargetType

400

Objek yang diminta adalah tautan simbolik, dan objek targetnya juga merupakan tautan simbolik.

NotModified

304

Error ini dikembalikan karena salah satu alasan berikut:

• Header permintaan If-Modified-Since ditentukan, tetapi objek sumber belum dimodifikasi sejak waktu yang ditentukan.

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

PreconditionFailed

412

Error ini dikembalikan karena salah satu alasan berikut:

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

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