El comando head-object sirve para consultar los metadatos de un objeto.
Nota
Al ejecutar este comando, la respuesta no incluye el contenido del objeto.
Permisos
De forma predeterminada, una cuenta de Alibaba Cloud tiene permisos completos. Los usuarios o roles de RAM asociados a una cuenta de Alibaba Cloud no cuentan con ningún permiso de manera predeterminada. La cuenta de Alibaba Cloud o su administrador deben otorgar los permisos de operación mediante RAM policies o Bucket Policy.
|
API |
Acción |
Descripción |
|
HeadObject |
|
Consulta los metadatos de un objeto. |
Sintaxis del comando
ossutil api head-object --bucket value --key value [flags]|
Parámetro |
Tipo |
Descripción |
|
--bucket |
string |
Nombre del bucket. |
|
--key |
string |
Ruta completa del objeto. |
|
--if-match |
string |
Si el valor ETag especificado en la solicitud coincide con el valor ETag del objeto, se devuelve 200 OK junto con los metadatos del objeto. De lo contrario, se devuelve 412 precondition con errores. |
|
--if-modified-since |
string |
Si la hora especificada es anterior a la última modificación del objeto, se devuelven los metadatos del objeto y 200 OK. En caso contrario, se devuelve 304 Not Modified. |
|
--if-none-match |
string |
Si el valor ETag proporcionado no coincide con el ETag del objeto, se devuelven los metadatos del objeto y 200 OK. De lo contrario, se devuelve 304 Not Modified. |
|
--if-unmodified-since |
string |
Si la hora especificada es igual o posterior a la última modificación del objeto, se devuelven los metadatos del objeto y 200 OK. En caso contrario, se devuelve 412 Precondition con errores. |
|
--version-id |
string |
Identificador de versión del objeto. |
El comando head-object corresponde a la operación HeadObject. Para obtener más información sobre los parámetros de la operación HeadObject, consulte HeadObject.
Para conocer más detalles sobre las opciones globales de línea de comandos compatibles, consulte Command-line options.
Ejemplos
-
Consulte los metadatos de
exampleobject.ossutil api head-object --bucket examplebucket --key exampleobject -
Consulte los metadatos de
exampleobjecty muestre el resultado en formato JSON.ossutil api head-object --bucket examplebucket --key exampleobject --output-format json -
Consulte los metadatos de
exampleobjectcuyo identificador de versión es 123.ossutil api head-object --bucket examplebucket --key exampleobject --version-id 123 -
Consulte los metadatos de
exampleobjectcuyo valor ETag es 123.ossutil api head-object --bucket examplebucket --key exampleobject --if-match 123 -
Consulte los metadatos de
exampleobjectcuya fecha real de modificación sea 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"