ls (List buckets, objects, or parts) - Object Storage Service - Centro de documentación de Alibaba Cloud

El comando ls muestra información sobre los buckets, objetos y partes de su cuenta. Utilice este comando para consultar y gestionar sus recursos de Object Storage Service (OSS); por ejemplo, para localizar y eliminar objetos grandes con el fin de controlar el uso del almacenamiento.

Notas de uso

A partir de ossutil 1.6.16, puede usar ossutil como nombre del binario en sus comandos, sin importar el sistema operativo. En versiones anteriores a la 1.6.16, debe usar el nombre del binario correspondiente a su sistema operativo. Para más información, consulte ossutil command reference.

Permisos

Las cuentas de Alibaba Cloud tienen todos los permisos de forma predeterminada. En cambio, los usuarios y roles de RAM no cuentan con permisos predeterminados. El propietario de la cuenta o un administrador debe otorgarles permisos mediante una RAM policy o bucket policy.

Acción de API	Descripción
`oss:ListBuckets`	Obligatorio para ejecutar el comando `ls` y listar los buckets de una cuenta.
`oss:ListObjects`	Obligatorio para ejecutar el comando `ls` y listar los objetos de un bucket específico.
`oss:ListObjectVersions`	Opcional. Se requiere para listar todas las versiones de un objeto cuando se usa la opción `--all-versions`.
`oss:ListMultipartUploads`	Opcional. Se requiere para listar las cargas multiparte incompletas o canceladas.
`oss:ListParts`	Opcional. Se requiere para listar las partes.

Sintaxis del comando

ossutil ls cloud_url [options]

Parámetros

Parámetro	Descripción
cloud_url	Especifica el recurso sobre el que se trabajará. El formato es `oss://[bucket_name[/prefix]]`. Si se omite, se listan todos los buckets a los que tiene permiso de acceder en la cuenta actual. Si especifica `oss://bucket_name`, se listan de forma recursiva todos los objetos del bucket. Si especifica `oss://bucket_name/prefix`, se listan de forma recursiva todos los objetos del bucket que coinciden con el prefijo indicado.
-s, --short-format	Muestra el resultado en un formato simplificado. La salida incluye únicamente los nombres de los recursos.
-d, --directory	Realiza un listado no recursivo. Muestra solo los objetos y los subdirectorios de primer nivel (prefijos comunes que terminan en `/`) de la ruta actual.
-m, --multipart	Lista todas las tareas de carga multiparte incompletas o canceladas del bucket especificado. Nota: Las partes incompletas ocupan espacio de almacenamiento y generan cargos. Revíselas y elimínelas de forma periódica.
-a, --all-type	Lista todos los tipos de recursos, incluidos los objetos y las partes incompletas.
--limited-num	Especifica el número máximo de resultados que se devuelven en una sola solicitud. Esta opción sirve para paginar. Para evitar tiempos de espera agotados al listar muchos objetos, úsela junto con la opción `--marker`.
--marker	Inicia el listado desde el marcador especificado. Si un bucket contiene muchos objetos, combine esta opción con `--limited-num` para paginar.
--upload-id-marker	Reanuda el listado de cargas multiparte incompletas a partir del UploadID especificado.
--payer	Indica que el solicitante paga por el acceso. Si establece esta opción en `requester`, quien realiza la solicitud asume los cargos generados, como las tarifas de tráfico y de solicitudes.
--include	Lista los objetos que coinciden con el patrón de comodines especificado. Para más información, consulte --include and --exclude options.
--exclude	Excluye del listado los objetos que coinciden con el patrón de comodines especificado. Para más información, consulte --include and --exclude options.
--all-versions	Lista todas las versiones históricas de un objeto. Esta opción solo es válida para buckets con control de versiones habilitado.
--version-id-marker	Reanuda el listado de versiones históricas de un objeto a partir del identificador de versión especificado. Esta opción solo es válida para buckets con control de versiones habilitado.

Para más información sobre otras opciones comunes de este comando, consulte Common options.

Resultados de salida

El valor ETag de la lista de objetos devuelta sirve para comprobar la integridad del contenido del objeto.

En un objeto creado con PutObject, el ETag corresponde al hash MD5 de su contenido.
En un objeto creado por otros métodos, como una carga multiparte, el ETag es un valor único y no el hash MD5 de su contenido.

Ejemplos

Listar todos los buckets

Ejecute el comando ls sin parámetros para listar todos los buckets accesibles de su cuenta.

ossutil ls

O bien:

ossutil ls oss://

Salida de ejemplo:

2016-10-21 16:18:37 +0800 CST       oss-ap-southeast-1         Archive    oss://examplebucketA
2016-12-01 15:06:21 +0800 CST       oss-ap-southeast-1        Standard    oss://examplebucketB
2016-07-20 10:36:24 +0800 CST       oss-ap-southeast-1              IA    oss://examplebucketC
2016-10-21 17:31:27 +0800 CST       oss-ap-southeast-1         Archive    oss://examplebucketD
Bucket Number is:4
0.252174(s) elapsed

Listar buckets en modo simple

ossutil ls -s

Salida de ejemplo:

oss://examplebucketA
oss://examplebucketB
oss://examplebucketC
oss://examplebucketD
Bucket Number is:4
0.235104(s) elapsed

Listar buckets por página

Si tiene muchos buckets, utilice las opciones --limited-num y --marker para listarlos por página.

Liste los buckets cuyos nombres sean alfabéticamente posteriores al marcador examplebucketA.

ossutil ls  --limited-num=2 -s --marker examplebucketA

Salida de ejemplo:

2016-12-01 15:06:21 +0800 CST       oss-ap-southeast-1        Standard    oss://examplebucketB
2016-07-20 10:36:24 +0800 CST       oss-ap-southeast-1              IA    oss://examplebucketC
Bucket Number is:2
0.132174(s) elapsed

Listar todos los objetos de un bucket específico

Liste todos los objetos del bucket examplebucket.

ossutil ls oss://examplebucket

Salida de ejemplo:

LastModifiedTime                    Size(B)  StorageClass   ETag                                    ObjectName
2020-12-01 15:06:37 +0800 CST           114      Standard   61DE142E5AFF9A6748707D4A77BFBCFB        oss://examplebucket/example.txt
2020-12-01 15:06:42 +0800 CST        363812      Standard   E7581E5D2EBC56ECCB6FB6050B4C6545        oss://examplebucket/examplefolder/photo.jpg
2020-12-01 15:06:45 +0800 CST      57374182      Standard   BE97B7AD7A2C1277B11221E5C9537544        oss://examplebucket/video.mp4
Object Number is:3
0.007379(s) elapsed

El valor ETag identifica el contenido de un objeto. Cuando el objeto se crea mediante una solicitud PutObject, el ETag corresponde al hash MD5 de dicho contenido. Si se genera por otros métodos, el ETag es un valor único producido según reglas específicas y no equivale al hash MD5 del contenido.

Listar objetos de un directorio (prefijo) específico

Liste los objetos con el prefijo example dentro del bucket examplebucket.

ossutil ls oss://examplebucket/example

Salida de ejemplo:

LastModifiedTime                    Size(B)  StorageClass   ETag                                     ObjectName
2020-12-01 15:06:37 +0800 CST           114      Standard   61DE142E5AFF9A6748707D4A77BFBCFB        oss://examplebucket/example.txt
2020-12-01 15:06:42 +0800 CST        363812      Standard   E7581E5D2EBC56ECCB6FB6050B4C6545        oss://examplebucket/examplefolder/photo.jpg
Object Number is:2
0.007379(s) elapsed

Listar objetos con un sufijo específico

Utilice la opción --include para listar todos los archivos .mp4 del bucket examplebucket.

ossutil ls oss://examplebucket --include *.mp4

Salida de ejemplo:

LastModifiedTime                    Size(B)  StorageClass   ETag                                     ObjectName
2020-12-01 15:06:45 +0800 CST      57374182      Standard   BE97B7AD7A2C1277B11221E5C9537544        oss://examplebucket/video.mp4
Object Number is:1
0.007379(s) elapsed

Listar de forma no recursiva los objetos y los subdirectorios de primer nivel

Use la opción -d para listar únicamente los objetos y los subdirectorios de primer nivel del directorio raíz del bucket examplebucket. El contenido de los subdirectorios no se lista de forma recursiva.

ossutil ls oss://examplebucket -d

Salida de ejemplo:

oss://examplebucket/example.txt
oss://examplebucket/examplefolder/
oss://examplebucket/video.mp4
Object and Directory Number is: 3
0.278(s) elapsed

Listar todas las versiones de todos los objetos

En un bucket con control de versiones habilitado, utilice la opción --all-versions para listar todas las versiones de los objetos.

ossutil ls oss://examplebucket --all-versions

Salida de ejemplo:

LastModifiedTime                   Size(B)  StorageClass   ETag                                   VERSIONID                                                           IS-LATEST   DELETE-MARKER   ObjectName
2020-12-01 15:06:37 +0800 CST         114      Standard   61DE142E5AFF9A6748707D4A77BFBCFB      CAEQARiBgICUsOuR2hYiIDI3NWVjNmEyYmM0NTRkZWNiMTkxY2VjMDMwZjFlMDA3    true        false           oss://examplebucket/example.txt
2020-06-11 11:03:37 +0800 CST      363812      Standard   E7581E5D2EBC56ECCB6FB6050B4C6545      CAEQARiBgIDZtvuR2hYiIDNhYjRkN2M5NTA5OTRlN2Q4YTYzODQwMzQ4NDYwZDdm    true        false           oss://examplebucket/examplefolder/photo.jpg
2021-01-26 13:27:08 +0800 CST           0                                                       CAEQLxiBgIDd7NH0uRciIDA3Yzg0MTZjOWNlYzQ4ODZhMzVkZWE0MmE2NzBlYTYx    true        true            oss://examplebucket/image.png
2020-12-01 15:06:45 +0800 CST    57374182      Standard   BE97B7AD7A2C1277B11221E5C9537544      CAEQLBiBgMDZiprwthciIDY2NGM0NTNmZDE3ODRmZmVhZGM4YTUwZGQyNGU3ZjQ3    true        false           oss://examplebucket/video.mp4
2016-06-11 10:53:46 +0800 CST      118076      Standard   FFDB300F053AAF06F4C4C58A4869C427      CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3MDRk    false       false           oss://examplebucket/example.txt
2016-06-11 11:02:05 +0800 CST      345374      Standard   078A9852BCF81DC4811E6EDCBFD121BE      CAEQARiBgICNz_iR2hYiIGJjZTBjNDQxYWRhNTQ2ZTNiNmMzYzQ1YzMzMDA5ZjUw    false       false           oss://examplebucket/examplefolder/photo.jpg
Object Number is: 6

0.692000(s) elapsed

Listar todas las versiones de un objeto específico

En un bucket con control de versiones habilitado, utilice la opción --all-versions para listar todas las versiones de example.txt.

ossutil ls oss://examplebucket/example.txt --all-versions

Salida de ejemplo:

LastModifiedTime                   Size(B)  StorageClass  ETag                                   VERSIONID                                                           IS-LATEST   DELETE-MARKER  ObjectName
2020-12-01 15:06:37 +0800 CST         114      Standard   61DE142E5AFF9A6748707D4A77BFBCFB      CAEQARiBgICUsOuR2hYiIDI3NWVjNmEyYmM0NTRkZWNiMTkxY2VjMDMwZjFlMDA3    true        false           oss://examplebucket/example.txt
2016-06-11 10:53:46 +0800 CST         114      Standard   61DE142E5AFF9A6748707D4A77BFBCFB      CAEQARiBgID8rumR2hYiIGUyOTAyZGY2MzU5MjQ5ZjlhYzQzZjNlYTAyZDE3MDRk    false       false           oss://examplebucket/example.txt
Object Number is: 2
0.361(s) elapsed

Listar todas las partes

Utilice la opción -m para listar todas las partes incompletas de examplebucket generadas por cargas interrumpidas o con errores. Estas partes consumen espacio de almacenamiento y generan cargos. Elimínelas de forma periódica para evitar costos innecesarios.

ossutil ls oss://examplebucket -m

Salida de ejemplo:

InitiatedTime                     UploadID                           ObjectName
2017-01-13 03:45:26 +0000 CST     15754AF7980C4DFB8193F190837520BB    oss://examplebucket/test.mp4
2017-01-20 11:16:21 +0800 CST     A20157A7B2FEC4670626DAE0F4C0073C    oss://examplebucket/object.exe
UploadId Number is: 2
0.191(s) elapsed

Listar todos los objetos y partes

Utilice la opción -m para listar todos los objetos y partes de examplebucket.

ossutil ls oss://examplebucket -a

Salida de ejemplo:

LastModifiedTime                    Size(B)  StorageClass   ETag                                     ObjectName
2020-12-01 15:06:37 +0800 CST           114      Standard   61DE142E5AFF9A6748707D4A77BFBCFB        oss://examplebucket/example.txt
2020-12-01 15:06:42 +0800 CST        363812      Standard   E7581E5D2EBC56ECCB6FB6050B4C6545        oss://examplebucket/examplefolder/photo.jpg
2020-12-01 15:06:45 +0800 CST      57374182      Standard   BE97B7AD7A2C1277B11221E5C9537544        oss://examplebucket/video.mp4
Object Number is:3
InitiatedTime                     UploadID                           ObjectName
2017-01-13 03:45:26 +0000 CST     15754AF7980C4DFB8193F190837520BB    oss://examplebucket/test.mp4
2017-01-13 03:45:13 +0000 CST     2A1F9B4A95E341BD9285CC42BB950EE0    oss://examplebucket/test.mp4
2017-01-13 03:45:01 +0000 CST     3998971ACAF94AD9AC48EAC1988BE863    oss://examplebucket/test.mp4
2017-01-20 11:16:21 +0800 CST     A20157A7B2FEC4670626DAE0F4C0073C    oss://examplebucket/object.exe
UploadId Number is:4
0.791289(s) elapsed

Listar recursos autorizados por otra cuenta

Liste todos los objetos de un bucket de prueba perteneciente a otra cuenta de Alibaba Cloud en la región Singapore.

ossutil ls oss://test -e oss-ap-southeast-1.aliyuncs.com -i yourAccessKeyID  -k yourAccessKeySecret