O comando head-object consulta os metadados de um objeto.
Nota
A resposta deste comando não retorna o conteúdo do objeto.
Permissões
Por padrão, uma conta Alibaba Cloud tem permissões totais. Usuários RAM ou funções RAM vinculados a uma conta Alibaba Cloud não têm permissão por padrão. A conta Alibaba Cloud ou o administrador da conta deve conceder as permissões de operação por meio de políticas do RAM ou Bucket Policy.
|
API |
Action |
Descrição |
|
HeadObject |
|
Consulta os metadados de um objeto. |
Sintaxe do comando
ossutil api head-object --bucket value --key value [flags]|
Parâmetro |
Tipo |
Descrição |
|
--bucket |
string |
Nome do bucket. |
|
--key |
string |
Caminho completo do objeto. |
|
--if-match |
string |
Se o valor ETag especificado na solicitação corresponder ao ETag do objeto, retorna 200 OK e os metadados do objeto. Caso contrário, retorna 412 precondition failed. |
|
--if-modified-since |
string |
Se o horário especificado for anterior à última modificação do objeto, retorna os metadados do objeto e 200 OK. Caso contrário, retorna 304 Not Modified. |
|
--if-none-match |
string |
Se o ETag fornecido não corresponder ao ETag do objeto, retorna os metadados do objeto e 200 OK. Caso contrário, retorna 304 Not Modified. |
|
--if-unmodified-since |
string |
Se o horário especificado for igual ou posterior à última modificação do objeto, retorna os metadados do objeto e 200 OK. Caso contrário, retorna 412 Precondition Failed. |
|
--version-id |
string |
ID da versão do objeto. |
O comando head-object corresponde à operação HeadObject. Para obter mais informações sobre os parâmetros da operação HeadObject, consulte HeadObject.
Para mais detalhes sobre as opções globais de linha de comando compatíveis, consulte Opções de linha de comando.
Exemplos
-
Consulte os metadados de
exampleobject.ossutil api head-object --bucket examplebucket --key exampleobject -
Obtenha os metadados de
exampleobjecte exiba a saída no formato JSON.ossutil api head-object --bucket examplebucket --key exampleobject --output-format json -
Recupere os metadados de
exampleobjectcom ID de versão 123.ossutil api head-object --bucket examplebucket --key exampleobject --version-id 123 -
Verifique os metadados de
exampleobjectcujo valor ETag é 123.ossutil api head-object --bucket examplebucket --key exampleobject --if-match 123 -
Liste os metadados de
exampleobjectcuja data de modificação real é anterior a '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"