

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

# aws-lambda-sns
<a name="aws-lambda-sns"></a>

![](http://docs.aws.amazon.com/pt_br/solutions/latest/constructs/images/experimental.png)


 Todas as classes estão em desenvolvimento ativo e estão sujeitas a alterações ou remoção não compatíveis com versões anteriores em qualquer versão futura. Estes não estão sujeitos à[Versionamento semântico](https://semver.org/)Modelo. Isso significa que, embora você possa usá-los, você pode precisar atualizar seu código-fonte ao atualizar para uma versão mais recente deste pacote. 

**Observações:** Para garantir a funcionalidade adequada, os pacotes AWS Solutions Constructs e os pacotes CDK da AWS em seu projeto devem ser da mesma versão. 


|  **Linguagem**  |  **Pacote**  | 
| --- | --- | 
|  ![](http://docs.aws.amazon.com/pt_br/solutions/latest/constructs/images/python.png) Python  |  aws\_solutions\_constructs.aws\_lambda\_sns  | 
|  ![](http://docs.aws.amazon.com/pt_br/solutions/latest/constructs/images/typescript.png) TypeScript  |  @aws-solutions-constructs/aws-lambda-sns  | 
|  ![](http://docs.aws.amazon.com/pt_br/solutions/latest/constructs/images/java.png) Java  |  software.amazon.awsconstructs.services.lambdasns  | 

## Overview
<a name="overview-20"></a>

 Este AWS Solutions Construct implementa uma função do AWS Lambda conectada a um tópico do Amazon SNS.

 Aqui está uma definição de padrão implantável mínima no TypeScript:

```
import { LambdaToSns, LambdaToSnsProps } from "@aws-solutions-constructs/aws-lambda-sns";

new LambdaToSns(this, 'test-lambda-sns', {
    lambdaFunctionProps: {
        runtime: lambda.Runtime.NODEJS_14_X,
        // This assumes a handler function in lib/lambda/index.js
        code: lambda.Code.fromAsset(`${__dirname}/lambda`),
        handler: 'index.handler'
    }
});
```

## Initializer
<a name="initializer-20"></a>

```
new LambdaToSns(scope: Construct, id: string, props: LambdaToSnsProps);
```

 *Parâmetros* 
+  escopo[https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_core.Construct.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_core.Construct.html) 
+  id`string` 
+  props[`LambdaToSnsProps`](#pattern-construct-props-20) 

## Adereços de criação de padrão
<a name="pattern-construct-props-20"></a>


|  **Nome**  |  **Tipo**  |  **Descrição**  | 
| --- | --- | --- | 
|  ExistingAmbdaobj?  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html)  |  Instância existente do objeto Lambda Function, fornecendo tanto isso elambdaFunctionPropscausará um erro.  | 
|  LambdaFunctionProps?  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.FunctionProps.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.FunctionProps.html)  |  Propriedades opcionais fornecidas pelo usuário para substituir as propriedades padrão da função Lambda. Ignorado se umexistingLambdaObjé fornecido.  | 
|  ExistingTopicobj?  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sns.Topic.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sns.Topic.html)  |  Instância existente do objeto Tópico SNS, fornecendo tanto isso quantotopicPropscausará um erro.  | 
|  TopicProps?  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sns.TopicProps.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sns.TopicProps.html)  |  Propriedades opcionais fornecidas pelo usuário para substituir as propriedades padrão do tópico SNS.  | 
|  ExistingVPC?  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-ec2.IVpc.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-ec2.IVpc.html)  |  Uma VPC opcional existente na qual esse padrão deve ser implantado. Quando implantada em uma VPC, a função Lambda usará ENIs na VPC para acessar recursos de rede e um ponto final de interface será criado na VPC para Amazon SQS. Se uma VPC existente for fornecida, a propriedadedeployVpcA propriedade não pode sertrue. Isso usaec2.IVpcpara permitir que os clientes forneçam VPCs que existem fora da pilha usando o[https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-ec2.Vpc.html#static-fromwbrlookupscope-id-options](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-ec2.Vpc.html#static-fromwbrlookupscope-id-options)Método do.  | 
|  Implementar VPC?  |  boolean  |  Como criar uma nova VPC com base emvpcPropsno qual implantar esse padrão. Configuração comotrueimplantará a VPC mínima e mais privada para executar o padrão: [See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/solutions/latest/constructs/aws-lambda-sns.html) Se esta propriedade fortrue, entãoexistingVpcnão pode ser especificado. Padronizado como false.  | 
|  VPCProps?  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-ec2.VpcProps.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-ec2.VpcProps.html)  |  Propriedades opcionais fornecidas pelo usuário para substituir as propriedades padrão da nova VPC.enableDnsHostnames,enableDnsSupport,natGatewaysesubnetConfigurationsão definidos pelo padrão, portanto, quaisquer valores para essas propriedades fornecidas aqui serão substituídos. SedeployVpcnão étrueentão essa propriedade será ignorada.  | 
|  TopicarnEnvironmentVariableName?  |  string  |  Nome opcional para o conjunto de variáveis de ambiente ARN do tópico do SNS para a função do Lambda.  | 
|  TopicNameEnvironmentVariableName?  |  string  |  Nome opcional para o conjunto de variáveis de ambiente de nome de tópico SNS para a função Lambda.  | 

## Propriedades de padrão
<a name="pattern-properties-20"></a>


|  **Nome**  |  **Tipo**  |  **Descrição**  | 
| --- | --- | --- | 
|  LambdaFunction  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html)  |  Retorna uma instância da função Lambda criada pelo padrão.  | 
|  snsTopic  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sns.Topic.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-sns.Topic.html)  |  Retorna uma instância do tópico SNS criado pelo padrão.  | 
|  VPC?  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-ec2.IVpc.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-ec2.IVpc.html)  |  Retorna uma instância da VPC usada pelo padrão (se houver). Esta pode ser uma VPC criada pelo padrão ou pela VPC fornecida ao construtor de padrões.  | 

## Configurações padrão
<a name="default-settings-20"></a>

 A implementação imediata da Construct sem qualquer substituição definirá os seguintes padrões: 

### Função do AWS Lambda
<a name="aws-lambda-function-12"></a>
+  Configurar a função do IAM de acesso de privilégio limitado para a função Lambda 
+  Habilite a reutilização de conexões com a função Keep-Alive para NodeJS Lambda. 
+  Ativar rastreamento do X-Ray.
+  Definição de variáveis de ambiente:
  +  `SNS_TOPIC_NAME` (padrão)
  +  `SNS_TOPIC_ARN` (padrão)
  +  `AWS_NODEJS_CONNECTION_REUSE_ENABLED`(para funções Node 10.x e superiores)

### Tópico do Amazon SNS
<a name="amazon-sns-topic"></a>
+  Configurar permissões de acesso de menor privilégio para o tópico SNS. 
+  Ative a criptografia do lado do servidor usando a chave KMS gerenciada pela AWS. 
+  Aplique a criptografia de dados em trânsito 

## Architecture
<a name="architecture-20"></a>

![](http://docs.aws.amazon.com/pt_br/solutions/latest/constructs/images/aws-lambda-sns.png)


## GitHub
<a name="github-20"></a>


<table>
<thead>
  <tr><th colspan="2"> Para exibir o código desse padrão, crie/exiba problemas e solicitações pull e muito mais: </th></tr>
</thead>
<tbody>
  <tr><td> ![](http://docs.aws.amazon.com/pt_br/solutions/latest/constructs/images/GitHub-Mark-32px.png) </td><td> [@aws -solutions-constructs/aws-lambda-sns](https://github.com/awslabs/aws-solutions-constructs/tree/master/source/patterns/%40aws-solutions-constructs/aws-lambda-sns) </td></tr>
</tbody>
</table>
