stat (Consulta de información de buckets y objetos) - Object Storage Service

El comando stat permite consultar la información de un bucket o un objeto específico. Por ejemplo, sirve para consultar la clase de almacenamiento de un bucket y los metadatos de un objeto.

Importante

A partir de la versión 1.6.16 de ossutil, se usa ossutil como nombre del binario en la línea de comandos. No es necesario cambiar el nombre del binario según el sistema operativo. Si utiliza una versión anterior a la 1.6.16, debe usar el nombre del binario correspondiente a su sistema operativo. Para obtener más información, consulte ossutil command reference.
Solo el propietario del bucket y los usuarios de Resource Access Management (RAM) con los permisos oss:GetObject, oss:GetObjectAcl y oss:GetBucketInfo pueden usar este comando para consultar los metadatos de un objeto.

Sintaxis del comando

ossutil stat oss://bucketname[/objectname]
[--encoding-type <value>]
[--payer <value>]
[--version-id <value>]

A continuación se describen los parámetros y las opciones.

Parámetro	Descripción
bucketname	Nombre del bucket de destino.
objectname	Nombre del objeto de destino.
--encoding-type	Método de codificación del nombre del objeto. Establezca el valor en url. Si no especifica esta opción, el nombre del objeto no se codifica.
--payer	Método de pago de la solicitud. Si desea que quien realiza la solicitud asuma los costos generados al acceder a los recursos de la ruta indicada, como el tráfico y las solicitudes, establezca esta opción en requester.
--version-id	Versión del objeto. Esta opción solo aplica a los objetos de un bucket con control de versiones habilitado o suspendido.

Ejemplos

Consulte la información del bucket examplebucket.

 ossutil stat oss://examplebucket

La salida a continuación muestra la información devuelta para examplebucket, que incluye el nombre del bucket, la región, la fecha de creación y la lista de control de acceso (ACL).

Name              : examplebucket
Location          : oss-cn-hangzhou
CreationDate      : 2021-06-30 16:04:41 +0800 CST
ExtranetEndpoint  : oss-cn-hangzhou.aliyuncs.com
IntranetEndpoint  : oss-cn-hangzhou-internal.aliyuncs.com
ACL               : private
Owner             : 148562088256****
StorageClass      : Standard
RedundancyType    : LRS
AccessMonitor     : Enabled

0.132413(s) elapsed

Consulte la información del objeto exampleobject.jpg almacenado en el bucket examplebucket.

ossutil stat oss://examplebucket/exampleobject.jpg

La salida a continuación muestra la información devuelta para exampleobject.jpg. Dicha información incluye la ACL y los metadatos del archivo, como Content-Type, el valor ETag y la fecha de última modificación.

ACL                   : default
Accept-Ranges         : bytes
Content-Length        : 8746
Content-Md5           : cvc5wcklut76CVoEi2UW****
Content-Type          : image/jpeg
Etag                  : 72F739C1C925BADEFA095A048B65****
Last-Modified         : 2021-07-27 09:53:03 +0800 CST
Owner                 : 148562088256****
X-Oss-Hash-Crc64ecma  : 56037670485008****
X-Oss-Object-Type     : Normal
X-Oss-Storage-Class   : Standard

0.194739(s) elapsed

Consulte la información de un objeto cuyo nombre contiene caracteres especiales dentro del bucket examplebucket.

Por ejemplo, para consultar la información del objeto example.txt en el bucket examplebucket. Cuando el nombre de un objeto tiene caracteres especiales que no se pueden escribir ni reconocer, debe codificarlo con URL, ya que ossutil solo admite este tipo de codificación para los nombres de objetos.
```
ossutil stat oss://examplebucket/%E7%A4%BA%E4%BE%8B.txt --encoding-type url
```
La respuesta a continuación proporciona la información de Example.txt, incluida su lista de control de acceso (ACL), Content-Type, el valor ETag y la fecha de última modificación.
```
ACL                   : default
Accept-Ranges         : bytes
Content-Length        : 113089
Content-Md5           : mAYgHM5cSkZNBxKDDqqW****
Content-Type          : image/jpeg
Etag                  : 9806201CCE5C4A464D0712830EAA****
Last-Modified         : 2021-07-27 10:08:57 +0800 CST
Owner                 : 148562088256****
X-Oss-Hash-Crc64ecma  : 1106061527435521****
X-Oss-Object-Type     : Normal
X-Oss-Storage-Class   : Standard

0.168335(s) elapsed
```

Consulte la información de una versión específica de un objeto en el bucket examplebucket.

ossutil stat oss://examplebucket/test.jpg --version-id  CAEQFRiBgICw.YSX1xciIDNiNzc3ZTdmNTQzOTQ1OTM4MWUwOWI1Y2M1ZTgz****

Para obtener más información sobre cómo recuperar las versiones de un objeto, consulte ls.

La salida a continuación muestra la información devuelta para la versión indicada del objeto. Incluye la ACL, los metadatos del archivo (como Content-Type, el valor ETag y la fecha de última modificación) y el identificador de versión.

ACL                   : default
Accept-Ranges         : bytes
Content-Length        : 190540
Content-Md5           : aJQnxHQ2b+zW6hh0c+2y****
Content-Type          : image/jpeg
Etag                  : 689427C474366FECD6EA187473ED****
Last-Modified         : 2021-07-27 10:19:25 +0800 CST
Owner                 : 148562088256****
X-Oss-Hash-Crc64ecma  : 1666171672179499****
X-Oss-Object-Type     : Normal
X-Oss-Storage-Class   : Standard
X-Oss-Version-Id      : CAEQFRiBgICw.YSX1xciIDNiNzc3ZTdmNTQzOTQ1OTM4MWUwOWI1Y2M1ZTgz****

0.213528(s) elapsed

Opciones comunes

Para acceder a un bucket ubicado en otra región, use -e y especifique el endpoint. Si necesita acceder a un bucket propiedad de otra cuenta de Alibaba Cloud, utilice -i para el AccessKey ID y -k para el AccessKey secret.

Por ejemplo, para obtener la información del bucket testbucket, que se encuentra en la región China (Shanghai) y pertenece a otra cuenta de Alibaba Cloud, ejecute el comando a continuación:

ossutil stat oss://testbucket  -e oss-cn-shanghai.aliyuncs.com -i yourAccessKeyID  -k yourAccessKeySecret

Common options.