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 |
| 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. |
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 exampleobjectMemeriksa metadata
exampleobjectdan menampilkan keluaran dalam format JSON.ossutil api head-object --bucket examplebucket --key exampleobject --output-format jsonMemeriksa metadata
exampleobjectyang ID versinya adalah 123.ossutil api head-object --bucket examplebucket --key exampleobject --version-id 123Memeriksa metadata
exampleobjectyang nilai ETag-nya adalah 123.ossutil api head-object --bucket examplebucket --key exampleobject --if-match 123Memeriksa metadata
exampleobjectyang 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"