全部产品
Search
文档中心

:objek-kepala

更新时间:Jul 06, 2025

Perintah objek-kepala digunakan untuk memeriksa metadata sebuah objek.

Catatan

  • Konten objek tidak dikembalikan dalam respons saat menjalankan perintah ini.

Izin

Secara default, akun Alibaba Cloud memiliki izin penuh. Pengguna RAM atau Peran RAM di bawah akun Alibaba Cloud tidak memiliki izin apa pun secara default. Akun Alibaba Cloud atau administrator akun harus memberikan izin operasi melalui Kebijakan RAM atau Kebijakan Bucket.

API

Aksi

Definisi

HeadObject

oss:GetObject

Memeriksa metadata sebuah objek.

Sintaksis perintah

ossutil api head-object --bucket value --key value [flags]

Parameter

Tipe

Deskripsi

--bucket

string

Nama bucket.

--key

string

Jalur lengkap Objek.

--if-match

string

Jika nilai ETag yang ditentukan dalam permintaan cocok dengan nilai ETag objek, 200 OK dan metadata objek dikembalikan. Jika tidak, 412 precondition failed dikembalikan.

--if-modified-since

string

Jika waktu yang ditentukan lebih awal dari waktu modifikasi terakhir objek, metadata objek dan 200 OK dikembalikan. Jika tidak, 304 Not Modified dikembalikan.

--if-none-match

string

Jika input ETag tidak cocok dengan ETag objek, metadata objek dan 200 OK dikembalikan. Jika tidak, 304 Not Modified dikembalikan.

--if-unmodified-since

string

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

--version-id

string

ID Versi objek.

Catatan
  • Perintah objek-kepala sesuai dengan operasi HeadObject. Untuk informasi lebih lanjut tentang parameter dalam operasi HeadObject, lihat HeadObject.

  • Untuk informasi lebih lanjut tentang opsi baris perintah global yang didukung, lihat Opsi Baris Perintah.

Contoh

  • Memeriksa metadata exampleobject.

    ossutil api head-object --bucket examplebucket --key exampleobject
  • Memeriksa metadata exampleobject dan menampilkan keluaran dalam format JSON.

    ossutil api head-object --bucket examplebucket --key exampleobject --output-format json
  • Memeriksa metadata exampleobject yang ID versinya adalah 123.

    ossutil api head-object --bucket examplebucket --key exampleobject --version-id 123
  • Memeriksa metadata exampleobject yang nilai ETag-nya adalah 123.

    ossutil api head-object --bucket examplebucket --key exampleobject --if-match 123
  • Memeriksa metadata exampleobject yang waktu modifikasi aktualnya lebih awal dari 'Thu, 11 Jul 2024 06:36:31 GMT'.

    ossutil api head-object --bucket examplebucket --key exampleobject --if-modified-since "Thu, 11 Jul 2024 06:36:31 GMT"