Selecione suas preferências de cookies

Usamos cookies essenciais e ferramentas semelhantes que são necessárias para fornecer nosso site e serviços. Usamos cookies de desempenho para coletar estatísticas anônimas, para que possamos entender como os clientes usam nosso site e fazer as devidas melhorias. Cookies essenciais não podem ser desativados, mas você pode clicar em “Personalizar” ou “Recusar” para recusar cookies de desempenho.

Se você concordar, a AWS e terceiros aprovados também usarão cookies para fornecer recursos úteis do site, lembrar suas preferências e exibir conteúdo relevante, incluindo publicidade relevante. Para aceitar ou recusar todos os cookies não essenciais, clique em “Aceitar” ou “Recusar”. Para fazer escolhas mais detalhadas, clique em “Personalizar”.

Referência a pontos de acesso para buckets de uso geral com ARNs, aliases de ponto de acesso ou URIs no estilo de hospedagem virtual

Modo de foco
Referência a pontos de acesso para buckets de uso geral com ARNs, aliases de ponto de acesso ou URIs no estilo de hospedagem virtual - Amazon Simple Storage Service

Depois de criar um ponto de acesso para buckets de uso geral, você pode usar esses endpoints para realizar inúmeras operações. Ao fazer referência a um ponto de acesso para um bucket de uso geral, você pode usar os nomes de recurso da Amazon (ARNs), o alias do ponto de acesso ou o URI no estilo de hospedagem virtual.

ARNs de ponto de acesso para buckets de uso geral

Os pontos de acesso têm nomes de recurso da Amazon (ARNS). Os ARNs de ponto de acesso para buckets de uso geral são semelhantes aos ARNs de bucket, mas são explicitamente digitados e codificam a Região da AWS do ponto de acesso e o ID da Conta da AWS do proprietário do ponto de acesso. Para obter mais informações sobre ARNs, consulte Nomes de recurso da Amazon (ARNs) no Referência geral da AWS.

Os ARNs de ponto de acesso usam o seguinte formato:

arn:aws:s3:region:account-id:accesspoint/resource
  • arn:aws:s3:us-west-2:123456789012:accesspoint/test representa o ponto de acesso denominado test, pertencente à conta 123456789012 na região us-west-2.

  • arn:aws:s3:us-west-2:123456789012:accesspoint/* representa todos os pontos de acesso na conta 123456789012 na região us-west-2.

Os ARNs para objetos acessados por meio de um ponto de acesso usam o seguinte formato:

arn:aws:s3:region:account-id:accesspoint/access-point-name/object/resource
  • arn:aws:s3:us-west-2:123456789012:accesspoint/test/object/unit-01 representa o objeto unit-01, acessado por meio do ponto de acesso denominado test, pertencente à conta 123456789012 na região us-west-2.

  • arn:aws:s3:us-west-2:123456789012:accesspoint/test/object/* representa todos os objetos do ponto de acesso denominado test, na conta 123456789012 na região us-west-2.

  • arn:aws:s3:us-west-2:123456789012:accesspoint/test/object/unit-01/finance/* representa todos os objetos com o prefixo unit-01/finance/ para o ponto de acesso denominado test, na conta 123456789012 na região us-west-2.

Aliases de ponto de acesso para buckets de uso geral

Quando você cria um ponto de acesso para buckets de uso geral, o Amazon S3 gera automaticamente um alias que poderá ser usado no lugar de um nome de bucket do Amazon S3 para acesso a dados. É possível usar esse alias de ponto de acesso em vez de um nome do recurso da Amazon (ARN) para operações de plano de dados do ponto de acesso. Para obter uma lista dessas operações, consulte Compatibilidade dos pontos de acesso para buckets de uso geral.

Cria-se um nome de alias de ponto de acesso dentro do mesmo namespace de um bucket do Amazon S3. Esse nome de alias é gerado automaticamente, e não é possível alterá-lo. O nome de alias de ponto de acesso atende a todos os requisitos de um nome de bucket válido do Amazon S3 e consiste nas seguintes partes:

access point prefix-metadata-s3alias

nota

O sufixo -s3alias é reservado para nomes de alias de ponto de acesso e não pode ser usado para nomes de bucket ou de ponto de acesso. Para obter mais informações sobre as regras para nomes de bucket do Amazon S3, consulte Regras de nomenclatura de buckets de uso geral.

Casos de uso e limitações dos aliases de ponto de acesso para buckets de uso geral

Ao adotar pontos de acesso para buckets de uso geral, é possível usar nomes de alias de ponto de acesso sem precisar fazer alterações extensas no código.

Quando você cria um ponto de acesso para buckets de uso geral, o Amazon S3 gera automaticamente um nome de alias de ponto de acesso, conforme o exemplo a seguir. Para executar esse comando, substitua os user input placeholders por suas próprias informações.

aws s3control create-access-point --bucket amzn-s3-demo-bucket1 --name my-access-point --account-id 111122223333 { "AccessPointArn": "arn:aws:s3:region:111122223333:accesspoint/my-access-point", "Alias": "my-access-point-aqfqprnstn7aefdfbarligizwgyfouse1a-s3alias" }

É possível usar esse alias de ponto de acesso em vez de um nome de bucket do Amazon S3 para qualquer operação de plano de dados. Para obter uma lista dessas operações, consulte Compatibilidade dos pontos de acesso para buckets de uso geral.

O exemplo a seguir da AWS CLI para o comando get-object usa o alias do ponto de acesso do bucket para retornar informações sobre o objeto especificado. Para executar esse comando, substitua os user input placeholders por suas próprias informações.

aws s3api get-object --bucket my-access-point-aqfqprnstn7aefdfbarligizwgyfouse1a-s3alias --key dir/my_data.rtf my_data.rtf { "AcceptRanges": "bytes", "LastModified": "2020-01-08T22:16:28+00:00", "ContentLength": 910, "ETag": "\"00751974dc146b76404bb7290f8f51bb\"", "VersionId": "null", "ContentType": "text/rtf", "Metadata": {} }

Limitações dos alias de ponto de acesso

  • Os aliases não podem ser configurados por clientes.

  • Não é possível excluir, modificar ou desabilitar aliases de um ponto de acesso.

  • É possível usar esse alias de ponto de acesso em vez de um nome de bucket do Amazon S3 em algumas operações de plano de dados. Para obter uma lista dessas operações, consulte Compatibilidade dos pontos de acesso para buckets de uso geral com operações do S3.

  • Não é possível usar um nome de alias de ponto de acesso para operações do plano de controle do Amazon S3. Para obter uma lista de operações do plano de controle do Amazon S3, consulte Controle do Amazon S3 na Referência de APIs do Amazon Simple Storage Service.

  • No console do Amazon S3, não é possível usar aliases de ponto de acesso do S3 como origem ou destino para operações Mover.

  • Não é possível usar alias em políticas do AWS Identity and Access Management (IAM).

  • Não é possível usar aliases como destino de log para logs de acesso do servidor S3.

  • Não é possível usar aliases como destino de log para logs do AWS CloudTrail.

  • O Amazon SageMaker GroundTruth não é compatível com alias de pontos de acesso.

URI de estilo de hospedagem virtual

Os pontos de acesso para buckets de uso geral são compatíveis apenas com o endereçamento no estilo de host virtual. Em um URI de estilo de hospedagem virtual, o nome do ponto de acesso, a Conta da AWS e a Região da AWS fazem parte do nome de domínio no URL. Para ter mais informações sobre a hospedagem virtual, consulte Hospedagem virtual de buckets.

O URI de estilo de hospedagem virtual para pontos de acesso usa o seguinte formato:

https://access-point-name-account-id.s3-accesspoint.region.amazonaws.com
nota
  • Se o nome do ponto de acesso incluir caracteres de traço (-), inclua os traços no URL e insira outro traço antes do ID da conta. Por exemplo, para usar um ponto de acesso chamado finance-docs, pertencente à conta 123456789012 na região us-west-2, o URL apropriado seria https://finance-docs-123456789012.s3-accesspoint.us-west-2.amazonaws.com.

  • Os Pontos de Acesso S3 não comportam acesso por HTTP. Eles comportam apenas o acesso seguro por HTTPS.

PrivacidadeTermos do sitePreferências de cookies
© 2025, Amazon Web Services, Inc. ou suas afiliadas. Todos os direitos reservados.