

Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Usar `ListObjects` com uma CLI
<a name="s3_example_s3_ListObjects_section"></a>

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*.  
+  Para obter detalhes da API, consulte [ListObjects](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/list-objects.html)em *Referência de AWS CLI Comandos*. 

------
#### [ 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 obter detalhes da API, consulte [ListObjects](https://docs.aws.amazon.com/powershell/v4/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (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 obter detalhes da API, consulte [ListObjects](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. 

------