# Listar objetos por meio de um ponto de acesso para um bucket de uso geral
<a name="list-object-ap"></a>

Esta seção explica como listar objetos por meio de um ponto de acesso para um bucket de uso geral usando o Console de gerenciamento da AWS, a AWS Command Line Interface ou a API REST.

## Usar o console do S3
<a name="list-object-ap-console"></a>

**Como listar os objetos por meio de um ponto de acesso na Conta da AWS**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Na barra de navegação na parte superior da página, escolha o nome da Região da AWS exibida no momento. Em seguida, escolha a região para a qual você deseja listar os pontos de acesso. 

1. No painel de navegação, no lado esquerdo do console, escolha **Pontos de acesso**.

1. (Opcional) Pesquise pontos de acesso pelo nome. Somente os pontos de acesso na Região da AWS selecionada aparecerão aqui.

1. Escolha o nome do ponto de acesso que você deseja gerenciar ou usar.

1. Na guia **Objetos**, é possível visualizar o nome dos objetos que deseja acessar por meio do ponto de acesso. Enquanto estiver usando o ponto de acesso, você só pode executar as operações de objeto permitidas pelas permissões do ponto de acesso.
**nota**  
A exibição do console sempre mostra todos os objetos no bucket. O uso de um ponto de acesso conforme descrito neste procedimento restringe as operações que você pode executar nesses objetos, mas não se você puder ver que eles existem no bucket.
O Console de gerenciamento da AWS não oferece suporte ao uso de pontos de acesso da nuvem privada virtual (VPC) para acessar recursos de bucket. Para acessar recursos de bucket em um ponto de acesso da VPC, use a AWS CLI, os AWS SDKs ou as APIs REST do Amazon S3.

## Como usar o AWS CLI
<a name="list-object-ap-cli"></a>

O exemplo de comando `list-objects-v2` a seguir mostra como você pode usar a AWS CLI para listar os objetos por meio de um ponto de acesso.

O comando a seguir lista os objetos da Conta da AWS *111122223333* usando o ponto de acesso *my-access-point*.

```
aws s3api list-objects-v2 --bucket arn:aws:s3:Região da AWS:111122223333:accesspoint/my-access-point      
```

**nota**  
O S3 gera automaticamente aliases de ponto de acesso para todos os pontos de acesso e esses aliases podem ser usados em qualquer lugar em que um nome de bucket seja usado para realizar operações ao nível do objeto. Para obter mais informações, consulte [Alias de ponto de acesso](access-points-naming.md#access-points-alias).

Para obter mais informações e exemplos, consulte [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/list-objects-v2.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/list-objects-v2.html) na *Referência de comandos da AWS CLI*.

## Uso da API REST
<a name="list-object-ap-rest"></a>

É possível usar a API REST para listar os pontos de acesso. Para obter mais informações, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectsV2.html) na *Referência da API do Amazon Simple Storage Service*.