# Usar pontos de acesso do Amazon S3 Object Lambda
**nota**
Desde 7 de novembro de 2025, o S3 Object Lambda está disponível somente para clientes existentes que estão usando o serviço no momento, bem como para parceiros selecionados da Rede de Parceiros da AWS (APN). Para recursos semelhantes ao S3 Object Lambda, saiba mais aqui: [Amazon S3 Object Lambda availability change](https://docs.aws.amazon.com/AmazonS3/latest/userguide/amazons3-ol-change.html).
Fazer solicitações via Pontos de Acesso do Amazon S3 Object Lambda funciona da mesma forma que fazer solicitações por meio de outros pontos de acesso. Para obter mais informações sobre como fazer solicitações via ponto de acesso, consulte [Usar o recurso Pontos de Acesso Amazon S3 para buckets de uso geral](using-access-points.md). Você pode fazer solicitações via pontos de acesso do Object Lambda usando o console do Amazon S3, a AWS Command Line Interface (AWS CLI), AWS SDKs ou API REST do Amazon S3.
**Importante**
Os nomes do recursos da Amazon (ARNs) para pontos de acesso do Object Lambda usam um nome de serviço de `s3-object-lambda`. Assim, os ARNs dos pontos de acesso do Object Lambda começam com `arn:aws::s3-object-lambda`, em vez do prefixo `arn:aws::s3` usado com outros pontos de acesso.
## Como encontrar o ARN do ponto de acesso do Object Lambda
Para usar um ponto de acesso do Object Lambda com a AWS CLI ou AWS SDKs, é necessário saber o nome do recurso da Amazon (ARN) do ponto de acesso do Object Lambda. Os exemplos a seguir mostram como encontrar o ARN para um ponto de acesso do Object Lambda usando o console ou a AWS CLI do Amazon S3.
### Usar o console do S3
**Para encontrar o ARN do seu ponto de acesso do Object Lambda usando o console**
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. No painel de navegação à esquerda, escolha **Object Lambda access points** (Pontos de acesso do Object Lambda).
1. Selecione o botão de opção próximo ao ponto de acesso do Object Lambda cujo ARN você deseja copiar.
1. Escolha **Copy ARN** (Copiar ARN).
### Como usar o AWS CLI
**Para encontrar o ARN do ponto de acesso do Object Lambda usando a AWS CLI**
1. Para recuperar uma lista dos pontos de acesso do Object Lambda associados à Conta da AWS, execute o comando a seguir. Antes de executar o comando, substitua o ID da conta *`111122223333`* pelo ID da sua Conta da AWS.
```
aws s3control list-access-points-for-object-lambda --account-id 111122223333
```
1. Revise a saída do comando para localizar o ARN do ponto de acesso do Object Lambda que deseja usar. A saída do comando anterior será semelhante à saída do exemplo a seguir.
```
{
"ObjectLambdaAccessPointList": [
{
"Name": "my-object-lambda-ap",
"ObjectLambdaAccessPointArn": "arn:aws:s3-object-lambda:us-east-1:111122223333:accesspoint/my-object-lambda-ap"
},
...
]
}
```
## Como usar um alias no estilo do bucket para o ponto de acesso do Object Lambda do bucket do S3
Quando você cria um ponto de acesso do Object Lambda, o Amazon S3 gera automaticamente um alias exclusivo para seu ponto de acesso do Object Lambda. É possível usar esse alias em vez de um nome de bucket do Amazon S3 ou o nome do recurso da Amazon (ARN) do ponto de acesso do Object Lambda em uma solicitação para operações de plano de dados do ponto de acesso. Para obter uma lista dessas operações, consulte [Compatibilidade dos pontos de acesso](access-points-service-api-support.md).
Um nome de alias do ponto de acesso do Object Lambda é criado dentro do mesmo namespace de um bucket do Amazon S3. Esse nome de alias é gerado automaticamente, e não é possível alterá-lo. Para um ponto de acesso do Object Lambda existente, um alias é automaticamente atribuído para uso. Um nome de alias de ponto de acesso do Object Lambda atende a todos os requisitos de um nome de bucket válido do Amazon S3 e consiste nas seguintes partes:
`Object Lambda Access Point name prefix-metadata--ol-s3`
**nota**
O sufixo `--ol-s3` é reservado para nomes de alias de ponto de acesso e não pode ser usado para nomes de bucket ou de ponto de acesso do Object Lambda. Para obter mais informações sobre as regras para nomes de bucket do Amazon S3, consulte [Regras de nomenclatura de buckets de uso geral](bucketnamingrules.md).
Os exemplos a seguir mostram o ARN e o alias de ponto de acesso do Object Lambda para um ponto de acesso do Object Lambda chamado `my-object-lambda-access-point`:
+ **ARN** – `arn:aws:s3-object-lambda:region:account-id:accesspoint/my-object-lambda-access-point`
+ **Alias de ponto de acesso do Object Lambda** – `my-object-lambda-acc-1a4n8yjrb3kda96f67zwrwiiuse1a--ol-s3`
Ao usar um ponto de acesso do Object Lambda, você pode usar o nome do alias do ponto de acesso do Object Lambda sem exigir grandes alterações no código.
Quando você exclui um ponto de acesso do Object Lambda, o nome do alias do ponto de acesso do Object Lambda se torna inativo e não provisionado.
### Como encontrar o alias do ponto de acesso do Object Lambda
#### Usar o console do S3
**Para encontrar o alias do ponto de acesso do Object Lambda usando o console**
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. No painel de navegação à esquerda, escolha **Object Lambda access points** (Pontos de acesso do Object Lambda).
1. Para o ponto de acesso do Object Lambda que você deseja usar, copie o valor do **alias do ponto de acesso do Object Lambda**.
#### Como usar o AWS CLI
Quando você cria um ponto de acesso do Object Lambda, o Amazon S3 gera automaticamente um nome de alias de ponto de acesso do Object Lambda, conforme mostrado no exemplo de comando a seguir. Para executar esse comando, substitua os `user input placeholders` por suas próprias informações. Para obter informações sobre como criar um ponto de acesso do Object Lambda usando a AWS CLI, consulte [Para criar um ponto de acesso do Object Lambda usando a AWS CLI](olap-create.md#olap-create-cli-specific).
```
aws s3control create-access-point-for-object-lambda --account-id 111122223333 --name my-object-lambda-access-point --configuration file://my-olap-configuration.json
{
"ObjectLambdaAccessPointArn": "arn:aws:s3:region:111122223333:accesspoint/my-access-point",
"Alias": {
"Value": "my-object-lambda-acc-1a4n8yjrb3kda96f67zwrwiiuse1a--ol-s3",
"Status": "READY"
}
}
```
O nome do alias do ponto de acesso do Object Lambda gerado tem dois campos:
+ O campo `Value` é o valor do alias do ponto de acesso do Object Lambda.
+ O campo `Status` é o status do alias do ponto de acesso do Object Lambda. Se o status for `PROVISIONING`, o Amazon S3 estará provisionando o alias do ponto de acesso do Object Lambda, e o alias ainda não estará pronto para uso. Se o status for `READY`, o alias do ponto de acesso do Object Lambda terá sido provisionado com êxito e estará pronto para uso.
Para obter mais informações sobre o tipo de dados `ObjectLambdaAccessPointAlias` na API REST, consulte [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateAccessPointForObjectLambda.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateAccessPointForObjectLambda.html) e [https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ObjectLambdaAccessPointAlias.html](https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ObjectLambdaAccessPointAlias.html) na *Referência da API do Amazon Simple Storage Service*.
### Como usar o alias do ponto de acesso do Object Lambda
É possível usar um alias de ponto de acesso do Object Lambda em vez de um nome de bucket do Amazon S3 para as operações listadas em [Compatibilidade dos pontos de acesso](access-points-service-api-support.md).
O exemplo da AWS CLI a seguir para o comando `get-bucket-location` usa o alias do ponto de acesso do bucket para retornar a Região da AWS em que o bucket está. Para executar esse comando, substitua os `user input placeholders` por suas próprias informações.
```
aws s3api get-bucket-location --bucket my-object-lambda-acc-w7i37nq6xuzgax3jw3oqtifiusw2a--ol-s3
{
"LocationConstraint": "us-west-2"
}
```
Se o alias do ponto de acesso do Object Lambda em uma solicitação não for válido, o código de erro `InvalidAccessPointAliasError` será retornado. Para obter mais informações sobre `InvalidAccessPointAliasError`, consulte [Lista de códigos de erro](https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList) na *Referência de API do Amazon Simple Storage Service*.
As limitações de um alias de um ponto de acesso do Object Lambda são as mesmas de um alias de ponto de acesso. Para obter mais informações sobre os limites de um alias do ponto de acesso, consulte [Limitações dos alias de ponto de acesso](access-points-naming.md#use-ap-alias-limitations).