Use o comando head-object para consultar os metadados de um objeto.
Observação
A resposta não inclui o conteúdo do objeto ao executar este comando.
Permissões
Por padrão, uma conta da Alibaba Cloud tem permissões completas. Usuários ou funções do RAM associados a ela não têm permissões por padrão. O titular da conta ou um administrador deve conceder permissões de operação por meio de RAM policies ou Bucket Policy.
|
API |
Ação |
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 ETag informado na solicitação corresponder ao ETag do objeto, a resposta inclui os metadados e o código 200 OK. Caso contrário, retorna 412 Precondition Failed. |
|
--if-modified-since |
string |
Se a data e hora especificadas forem anteriores à última modificação do objeto, a resposta inclui os metadados e o código 200 OK. Caso contrário, retorna 304 Not Modified. |
|
--if-none-match |
string |
Se o ETag informado for diferente do ETag do objeto, a resposta inclui os metadados e o código 200 OK. Caso contrário, retorna 304 Not Modified. |
|
--if-unmodified-since |
string |
Se a data e hora especificadas forem iguais ou posteriores à última modificação do objeto, a resposta inclui os metadados e o código 200 OK. Caso contrário, retorna 412 Precondition Failed. |
|
--version-id |
string |
ID de versão do objeto. |
O comando
head-objectcorresponde à operação HeadObject. Para detalhes sobre os parâmetros dessa operação, consulte HeadObject.Para mais informações sobre as opções de linha de comando globais suportadas, consulte Command-line options.
Exemplos
-
Consulte os metadados de
exampleobject.ossutil api head-object --bucket examplebucket --key exampleobject -
Retorne os metadados de
exampleobjectno formato JSON.ossutil api head-object --bucket examplebucket --key exampleobject --output-format json -
Obtenha os metadados da versão 123 de
exampleobject.ossutil api head-object --bucket examplebucket --key exampleobject --version-id 123 -
Filtre os metadados de
exampleobjectusando o valor de ETag 123.ossutil api head-object --bucket examplebucket --key exampleobject --if-match 123 -
Consulte os metadados de
exampleobjectcom data de modificação 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"