# 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: + [Criar uma página da web que oferece uma lista de objetos do Amazon S3](s3_example_s3_Scenario_ListObjectsWeb_section.md) ------ #### [ 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](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/list-objects.html) 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](https://docs.aws.amazon.com/powershell/v4/reference) 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](https://docs.aws.amazon.com/powershell/v5/reference) 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](sdk-general-information-section.md). Este tópico também inclui informações sobre como começar e detalhes sobre versões anteriores do SDK.