Listar objetos por meio de um ponto de acesso para um bucket de uso geral - Amazon Simple Storage Service

Listar objetos por meio de um ponto de acesso para um bucket de uso geral

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

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

  1. Faça login no AWS Management Console e abra o console do Amazon S3 em https://console.aws.amazon.com/s3/.

  2. 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.

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

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

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

  6. 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 AWS Management Console 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.

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 Aliases de ponto de acesso para buckets de uso geral.

Para obter mais informações e exemplos, consulte list-access-points na Referência de comandos da AWS CLI.

É possível usar a API REST para listar os pontos de acesso. Para obter mais informações, consulte ListObjectsV2 na Referência da API do Amazon Simple Storage Service.