aws-lambda-sqs - Constructos da AWS
Visão geralInicializadorAdereços de construção de padrãoPropriedades de padrãoConfigurações padrãoArquiteturaGitHub

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

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ânticoModelo. 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
Python 		aws_solutions_constructs.aws_lambda_sqs
TypeScript 		@aws-solutions-constructs/aws-lambda-sqs
Java 		software.amazon.awsconstructs.services.lambdasqs

Overview

Este AWS Solutions Construct implementa uma função do AWS Lambda conectada a uma fila do Amazon SQS.

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


 import { LambdaToSqs, LambdaToSqsProps } from "@aws-solutions-constructs/aws-lambda-sqs";

 new LambdaToSqs(this, 'LambdaToSqsPattern', {
    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


 new LambdaToSqs(scope: Construct, id: string, props: LambdaToSqsProps);

Parâmetros

Adereços de construção de padrão

Nome Tipo Descrição
ExistingAmbdaobj? lambda.Function Uma função opcional existente do Lambda a ser usada em vez da função padrão. Fornecendo tanto isso quantolambdaFunctionPropscausará um erro.
LambdaFunctionProps? lambda.FunctionProps Propriedades opcionais fornecidas pelo usuário para substituir as propriedades padrão da função Lambda.
ExistingQueueobj? sqs.Queue Uma fila SQS opcional existente a ser usada em vez da fila padrão. Fornecendo tanto isso quantoqueuePropscausará um erro.
QueueProps? sqs.QueueProps Propriedades opcionais fornecidas pelo usuário para substituir as propriedades padrão da fila SQS.
EnableQueuePurging? boolean Se deve conceder permissões adicionais à função do Lambda, habilitando-o a limpar a fila SQS. Padronizado como false.
ImplantyDeadletterQueue? boolean Criar uma fila secundária a ser usada como uma dead letter queue. Padronizado como true.
DeadletterQueueProps? sqs.QueueProps Props opcionais fornecidos pelo usuário para substituir os adereços padrão para a fila de letras inativas. Usado somente se odeployDeadLetterQueueé definida como true.
MaxReceiveCount? number O número de vezes que uma mensagem pode ser desenfileirada sem sucesso antes de ser movida para a fila de mensagens mortas. Padronizado como 15.
ExistingVPC? ec2.IVpc 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, odeployVpcA propriedade não pode sertrue. Umaec2.IVpcé usado para permitir que os clientes forneçam VPCs que existem fora da pilha usando oec2.Vpc.fromLookup()Método do.
Implementar VPC? boolean Criar uma nova VPC com base emvpcPropsno qual implantar esse padrão. Configurando isso comotrueimplantará a VPC mínima e mais privada para executar o padrão:

  • Uma sub-rede isolada em cada zona de disponibilidade usada pelo programa CDK

  • enableDnsHostnameseenableDnsSupportserão ambos definidos comotrue

Se esta propriedade fortrue, entãoexistingVpcnão pode ser especificado. Padronizado como false.
VPCProps? ec2.VpcProps Propriedades opcionais fornecidas pelo usuário para substituir as propriedades padrão da nova VPC.enableDnsHostnames,enableDnsSupport,natGateways, esubnetConfigurationsão definidos pelo padrão, portanto, quaisquer valores para essas propriedades fornecidas aqui serão substituídos. SedeployVpcnão étrue, então essa propriedade será ignorada.
QueueEnvironmentVariableName? string Nome opcional para o conjunto de variáveis de ambiente de URL de fila SQS para a função Lambda.

Propriedades de padrão

Nome Tipo Descrição
DeadletterQueue? sqs.Queue Retorna uma instância da fila de letras mortas criada pelo padrão, se uma for implantada.
LambdaFunction lambda.Function Retorna uma instância da função Lambda criada pelo padrão.
SQSqueue sqs.Queue Retorna uma instância da fila SQS criada pelo padrão.
VPC? ec2.IVpc Retorna uma instância da VPC criada ou usada pelo padrão (se houver). Esta pode ser uma VPC criada pelo padrão ou uma VPC fornecida ao construtor de padrões.

Configurações padrão

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

Função do AWS Lambda

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

  • Permitir que a função envie apenas mensagens para a fila (a expurgação pode ser habilitada usando oenableQueuePurge).

  • Habilitar rastreamento do X-Ray

  • Definir variáveis de ambiente:

    • SQS_QUEUE_URL

    • AWS_NODEJS_CONNECTION_REUSE_ENABLED(para funções Node 10.x e superiores)

Fila do Amazon SQS

  • Implante a dead letter queue do SQS para a fila do SQS de origem.

  • Ative a criptografia no lado do servidor para a fila do SQS de origem usando a AWS Managed KMS Key.

  • Aplique a criptografia de dados em trânsito

Architecture

Icons representing cloud search, Lambda function, SQS queue, and DLQ in a workflow diagram.

GitHub

Para exibir o código desse padrão, crie/exiba problemas e solicitações pull e muito mais:
Circular icon with a graduation cap symbol representing education or learning.
@aws -solutions-constructs/aws-lambda-sqs