View a markdown version of this page

Usar ListObjects com uma CLI - Amazon Simple Storage Service

Usar ListObjects com uma CLI

Os exemplos de código a seguir mostram como usar o ListObjects.

Exemplos de ações são trechos de código de programas maiores e devem ser executados em contexto. É possível ver essa ação em contexto no seguinte exemplo de código:

CLI
AWS CLI

O seguinte exemplo usa o comando list-objects para exibir os nomes de todos os objetos presentes no bucket especificado:

aws s3api list-objects --bucket text-content --query 'Contents[].{Key: Key, Size: Size}'

O exemplo usa o argumento --query para filtrar a saída de list-objects até encontrar o valor e o tamanho da chave de cada objeto

Para obter mais informações sobre objetos, consulte Working with Amazon S3 Buckets no Guia do desenvolvedor do Amazon S3.

  • Consulte detalhes da API em ListObjects na Referência de comandos da AWS CLI.

PowerShell
Ferramentas para PowerShell V4

Exemplo 1: este comando recupera as informações sobre todos os itens no bucket “test-files".

Get-S3Object -BucketName amzn-s3-demo-bucket

Exemplo 2: este comando recupera as informações sobre o item “sample.txt” do bucket “test-files".

Get-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt

Exemplo 3: este comando recupera as informações sobre todos os itens com prefixo “sample” do bucket “test-files".

Get-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix sample
  • Para ver detalhes da API, consulte ListObjects na Ferramentas da AWS para PowerShell Cmdlet Reference (V4).

Ferramentas para PowerShell V5

Exemplo 1: este comando recupera as informações sobre todos os itens no bucket “test-files".

Get-S3Object -BucketName amzn-s3-demo-bucket

Exemplo 2: este comando recupera as informações sobre o item “sample.txt” do bucket “test-files".

Get-S3Object -BucketName amzn-s3-demo-bucket -Key sample.txt

Exemplo 3: este comando recupera as informações sobre todos os itens com prefixo “sample” do bucket “test-files".

Get-S3Object -BucketName amzn-s3-demo-bucket -KeyPrefix sample
  • Para ver detalhes da API, consulte ListObjects na Ferramentas da AWS para PowerShell Cmdlet Reference (V5).

Para ver uma lista completa dos guias de desenvolvedor e exemplos de código do SDK da AWS, consulte Desenvolvimento com o Amazon S3 usando AWS SDKs. Este tópico também inclui informações sobre como começar e detalhes sobre versões anteriores do SDK.