Usar pontos de acesso do Amazon S3 Object Lambda - Amazon Simple Storage Service
Como encontrar o ARN do ponto de acesso do Object LambdaComo usar um alias no estilo do bucket para o ponto de acesso do Object Lambda

Usar pontos de acesso do Amazon S3 Object Lambda

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 pontos de acesso. 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.

Para encontrar o ARN do seu ponto de acesso do Object Lambda usando o console

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

  2. No painel de navegação à esquerda, escolha Object Lambda access points (Pontos de acesso do Object Lambda).

  3. Selecione o botão de opção próximo ao ponto de acesso do Object Lambda cujo ARN você deseja copiar.

  4. Escolha Copy ARN (Copiar ARN).

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

  2. 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 com ponto de acesso com produtos da AWS.

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 nomeação de bucket.

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

Para encontrar o alias do ponto de acesso do Object Lambda usando o console

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

  2. No painel de navegação à esquerda, escolha Object Lambda access points (Pontos de acesso do Object Lambda).

  3. Para o ponto de acesso do Object Lambda que você deseja usar, copie o valor do alias do ponto de acesso do Object Lambda.

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.

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 CreateAccessPointForObjectLambda e ObjectLambdaAccessPointAlias 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 com ponto de acesso com produtos da AWS.

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