head-object用於擷取某個檔案（Object）的元資訊。
注意事項
使用此命令不會返迴文件內容。
許可權說明
阿里雲帳號預設擁有全部許可權。阿里雲帳號下的RAM使用者或RAM角色預設沒有任何許可權，需要阿里雲帳號或帳號管理員通過RAM Policy或Bucket Policy授予操作許可權。
API | Action | 說明 |
HeadObject |
| 擷取某個Object的中繼資料。 |
命令格式
ossutil api head-object --bucket value --key value [flags]參數 | 類型 | 說明 |
--bucket | string | Bucket名稱。 |
--key | string | Object的完整路徑。 |
--if-match | string | 如果傳入期望的ETag和Object的 ETag匹配，則返回200 OK和Object Meta；否則返回412 precondition failed。 |
--if-modified-since | string | 如果傳入參數中的時間早於實際修改時間，則返回200 OK和Object Meta；否則返回304 not modified。 |
--if-none-match | string | 如果傳入期望的ETag值和Object的ETag不匹配，則返回200 OK和Object Meta；否則返回304 Not Modified。 |
--if-unmodified-since | string | 如果傳入參數中的時間等於或者晚於檔案實際修改時間，則返回200 OK和Object Meta；否則返回412 Precondition Failed。 |
--version-id | string | Obejct的版本號碼。 |
head-object命令對應API介面HeadObject。關於API中的具體參數含義，請參見HeadObject。
關於支援的全域命令列選項，請參見支援的全域命令列選項。
使用樣本
擷取
exampleobject對象的元資訊。ossutil api head-object --bucket examplebucket --key exampleobject擷取
exampleobject對象的元資訊，以JSON格式顯示。ossutil api head-object --bucket examplebucket --key exampleobject --output-format json擷取版本號碼為123的
exampleobject的元資訊。ossutil api head-object --bucket examplebucket --key exampleobject --version-id 123擷取
exampleobject對象且ETag等於123的元資訊。ossutil api head-object --bucket examplebucket --key exampleobject --if-match 123擷取
exampleobject對象且對象實際修改時間早於"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"