As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Adicionando a extensão AWS AppConfig Agent Lambda
<a name="appconfig-integration-lambda-extensions-add"></a>

Para usar a extensão AWS AppConfig Agent Lambda, você precisa adicionar a extensão ao seu Lambda. Isso pode ser feito adicionando a extensão do AWS AppConfig Agent Lambda à sua função Lambda como uma camada ou habilitando a extensão em uma função Lambda como uma imagem de contêiner.

**nota**  
A AWS AppConfig extensão é independente do tempo de execução e oferece suporte a todos os tempos de execução.

**Antes de começar**  
Antes de ativar a extensão do AWS AppConfig Agent Lambda, faça o seguinte:
+ Organize as configurações em sua função do Lambda para que você possa externalizá-las no AWS AppConfig.
+ Crie AWS AppConfig artefatos e dados de configuração, incluindo sinalizadores de recursos ou dados de configuração de formato livre. Para obter mais informações, consulte [Criação de sinalizadores de recursos e dados de configuração de formato livre no AWS AppConfig](creating-feature-flags-and-configuration-data.md).
+ Adicione `appconfig:StartConfigurationSession` e `appconfig:GetLatestConfiguration` à política AWS Identity and Access Management (IAM) usada pela função de execução da função Lambda. Para obter mais informações, consulte [perfil do IAM para execução do AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/lambda-intro-execution-role.html) no *Guia do desenvolvedor do AWS Lambda *. Para obter mais informações sobre permissões do AWS AppConfig , consulte [Ações, recursos e chaves de condição do AWS AppConfig](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsappconfig.html) na *Referência de autorização do serviço*. 

## Adicionar a extensão do AWS AppConfig Agent Lambda usando uma camada e um ARN
<a name="appconfig-integration-lambda-extensions-enabling"></a>

Para usar a extensão AWS AppConfig Agent Lambda, você adiciona a extensão à sua função Lambda como uma camada. Para obter informações sobre como adicionar uma camada à sua função, consulte [Configuração de extensões](https://docs.aws.amazon.com/lambda/latest/dg/using-extensions.html#using-extensions-config) no *Guia do desenvolvedor do AWS Lambda *. O nome da extensão no AWS Lambda console é **AWS- AppConfig -Extension**. Observe também que, ao adicionar a extensão como uma camada ao Lambda, é necessário especificar um nome do recurso da Amazon (ARN). Escolha um ARN em uma das listas a seguir que corresponda à plataforma e Região da AWS onde você criou o Lambda.
+ [Plataforma x86-64](appconfig-integration-lambda-extensions-versions.md#appconfig-integration-lambda-extensions-enabling-x86-64)
+ [ARM64 plataforma](appconfig-integration-lambda-extensions-versions.md#appconfig-integration-lambda-extensions-enabling-ARM64)

Se quiser testar a extensão antes de adicioná-la à sua função, você pode verificar se ela funciona usando o exemplo de código a seguir.

```
import urllib.request
                

def lambda_handler(event, context):
    url = f'http://localhost:2772/applications/application_name/environments/environment_name/configurations/configuration_name'
    config = urllib.request.urlopen(url).read()
    return config
```

Para testá-la, crie uma nova função do Lambda para Python, adicione a extensão e execute a função do Lambda. Depois de executar a função Lambda, a função AWS AppConfig Lambda retorna a configuração especificada para o caminho http://localhost:2772. Para obter informações sobre como criar uma função do Lambda, consulte [Criar uma função do Lambda com o console](https://docs.aws.amazon.com/lambda/latest/dg/getting-started-create-function.html), no *Guia do desenvolvedor do AWS Lambda *. 

**Importante**  
Você pode visualizar os dados de registro da extensão do AWS AppConfig Agent Lambda AWS Lambda nos registros. As entradas de log são precedidas por `appconfig agent`. Aqui está um exemplo.  

```
[appconfig agent] 2024/05/07 04:19:01 ERROR retrieve failure for 'SourceEventConfig:SourceEventConfigEnvironment:SourceEventConfigProfile': StartConfigurationSession: api error AccessDenied: User: arn:aws:sts::0123456789:assumed-role/us-east-1-LambdaRole/extension1 is not authorized to perform: sts:AssumeRole on resource: arn:aws:iam::0123456789:role/test1 (retry in 60s)
```