ls (List buckets, objects, or parts) - Object Storage Service: Central de Documentação do Alibaba Cloud

Notas de uso

A partir da versão 1.6.16 do ossutil, use ossutil como o nome do binário em seus comandos, independentemente do sistema operacional. Para versões anteriores à 1.6.16, use o nome do binário específico do seu sistema operacional. Para mais informações, consulte ossutil command reference.

Permissões

As contas Alibaba Cloud têm permissões completas por padrão. Por outro lado, os usuários e as funções do RAM não têm permissões padrão. O proprietário da conta ou um administrador deve conceder essas permissões por meio de uma RAM policy ou bucket policy.

Ação da API	Descrição
`oss:ListBuckets`	Necessária para execute o comando `ls` e listar buckets em uma conta.
`oss:ListObjects`	Necessária para execute o comando `ls` e listar objetos em um bucket especifique.
`oss:ListObjectVersions`	Opcional. Necessária para listar todas as versões de um objeto ao usar a opção `--all-versions`.
`oss:ListMultipartUploads`	Opcional. Necessária para listar uploads multipart incompletos ou abortados.
`oss:ListParts`	Opcional. Necessária para listar partes.

Sintaxe do comando

ossutil ls cloud_url [options]

Parâmetros

Parâmetro	Descrição
cloud_url	Especifique o recurso a ser operado. O formato é `oss://[bucket_name[/prefix]]`. Se omitido, lista todos os buckets que você tem permissão para acessar na conta atual. Se especifique `oss://bucket_name`, lista recursivamente todos os objetos no bucket. Se especifique `oss://bucket_name/prefix`, lista recursivamente todos os objetos no bucket que correspondem ao prefixo especifique.
-s, --short-format	Exibe a saída em formato simplificado. O resultado inclui apenas os nomes dos recursos.
-d, --directory	Realiza uma listagem não recursiva. Lista apenas os objetos e subdiretórios de primeiro nível (prefixos comuns que terminam com `/`) no caminho atual.
-m, --multipart	Lista todas as tarefas de upload multipart incompletas ou abortadas no bucket especifique. Nota: Partes incompletas ocupam espaço de armazenamento e geram cobranças. Verifique e limpe-as regularmente.
-a, --all-type	Lista todos os tipos de recursos, incluindo objetos e partes incompletas.
--limited-num	Especifique o número máximo de resultados a serem retornados em uma única solicitação. Pode ser usada para paginação. Para evitar tempos limite de solicitação ao listar muitos objetos, use esta opção junto com `--marker` para paginação.
--marker	Inicia a listagem a partir do marcador especifique. Se um bucket contiver muitos objetos, use esta opção com `--limited-num` para paginação.
--upload-id-marker	Retoma a listagem de uploads multipart incompletos a partir do UploadID especifique.
--payer	Especifique que o solicitante paga pelo acesso. Se você defina esta opção como `requester`, o solicitante pagará pelas taxas geradas, como taxas de tráfego e de solicitação.
--include	Lista objetos que correspondem ao padrão curinga especifique. Para mais informações, consulte --include and --exclude options.
--exclude	Exclui objetos que correspondem ao padrão curinga especifique da listagem. Para mais informações, consulte --include and --exclude options.
--all-versions	Lista todas as versões históricas de um objeto. Esta opção é válida apenas para buckets com controle de versão ativado.
--version-id-marker	Retoma a listagem das versões históricas de um objeto a partir do ID de versão especifique. Esta opção é válida apenas para buckets com controle de versão ativado.

Para mais informações sobre outras opções comuns para este comando, consulte Common options.

Resultados da saída

O valor ETag na lista de objetos retornados serve para verifique a integridade do conteúdo do objeto.

Para um objeto criado com PutObject, o ETag é o hash MD5 do seu conteúdo.
Para um objeto criado com outros métodos, como upload multipart, o ETag é um valor exclusivo, e não o hash MD5 do conteúdo.

Exemplos

Listar todos os buckets

Execute o comando ls sem nenhum parâmetro para listar todos os buckets acessíveis em sua conta.

ossutil ls

Ou:

ossutil ls oss://

Saída de exemplo:

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 no modo simples

ossutil ls -s

Saída de exemplo:

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

Listar buckets por página

Se houver muitos buckets, use as opções --limited-num e --marker para listá-los por página.

Liste os buckets cujos nomes vêm alfabeticamente após o marcador examplebucketA.

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

Saída de exemplo:

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 os objetos em um bucket especificado

Liste todos os objetos no bucket examplebucket.

ossutil ls oss://examplebucket

Saída de exemplo:

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

O valor ETag serve para identificar o conteúdo de um objeto. Para um objeto criado com uma solicitação PutObject, o valor ETag é o hash MD5 do conteúdo do objeto. Para um objeto criado com outros métodos, o valor ETag é um valor exclusivo gerado com base em regras específicas, não sendo o hash MD5 do conteúdo do objeto.

Listar objetos em um diretório (prefixo) especificado

Liste os objetos que têm o prefixo example no bucket examplebucket.

ossutil ls oss://examplebucket/example

Saída de exemplo:

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 com um sufixo especificado

Use a opção --include para listar todos os arquivos .mp4 no bucket examplebucket.

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

Saída de exemplo:

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 não recursiva objetos e subdiretórios de primeiro nível

Use a opção -d para listar apenas os objetos e subdiretórios de primeiro nível no diretório raiz do bucket examplebucket. O comando não lista recursivamente o conteúdo dos subdiretórios.

ossutil ls oss://examplebucket -d

Saída de exemplo:

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

Listar todas as versões de todos os objetos

Para um bucket com controle de versão ativado, use a opção --all-versions para listar todas as versões dos objetos.

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

Saída de exemplo:

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 as versões de um objeto especifique

Para um bucket com controle de versão ativado, use a opção --all-versions para listar todas as versões de example.txt.

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

Saída de exemplo:

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 as partes

Use a opção -m para listar todas as partes incompletas no examplebucket que resultam de uploads interrompidos ou com falha. Essas partes consomem espaço de armazenamento e geram cobranças. Exclua essas partes regularmente para evitar custos desnecessários.

ossutil ls oss://examplebucket -m

Saída de exemplo:

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 os objetos e partes

Use a opção -m para listar todos os objetos e partes no examplebucket.

ossutil ls oss://examplebucket -a

Saída de exemplo:

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 outra conta

Liste todos os objetos em um bucket de teste pertencente a outra conta Alibaba Cloud na região de Singapore.

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