aws-lambda-s3 - Costrutti delle soluzioni AWS

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

aws-lambda-s3

Tutte le classi sono in fase di sviluppo attivo e soggette a modifiche o rimozione non compatibili con le versioni precedenti in qualsiasi versione futura. Questi non sono soggetti allaControllo delle versioni semanticheModello. Ciò significa che, mentre è possibile utilizzarli, potrebbe essere necessario aggiornare il codice sorgente quando si esegue l'aggiornamento a una versione più recente di questo pacchetto.

Nota: Per garantire la corretta funzionalità, i pacchetti AWS Solutions Constructs e i pacchetti AWS CDK nel progetto devono essere della stessa versione.

Linguaggio Pacchetto
Python
aws_solutions_constructs.aws_lambda_s3
TypeScript
@aws-solutions-constructs/aws-lambda-s3
Java
software.amazon.awsconstructs.services.lambdas3

Overview

Questo Construct di soluzioni AWS implementa una funzione Lambda collegata a un bucket Amazon S3.

Ecco una definizione di modello distribuibile minima in TypeScript:

import { LambdaToS3 } from '@aws-solutions-constructs/aws-lambda-s3'; new LambdaToS3(this, 'LambdaToS3Pattern', { 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 LambdaToS3(scope: Construct, id: string, props: LambdaToS3Props);

Parametri

Puntelli di costruzione modelli

Nome Tipo Descrizione
EsistenteLambdaobj? lambda.Function Istanza esistente dell'oggetto Function Lambda, fornendo sia questo chelambdaFunctionPropscauserà un errore.
LambdafunctionPunps? lambda.FunctionProps Proprietà facoltative fornite dall'utente per sovrascrivere le proprietà predefinite per la funzione Lambda. Ignorato se unexistingLambdaObjviene fornito.
Esistente BucketObj? s3.IBucket Istanza esistente dell'oggetto S3 Bucket. Se questo è fornito, quindi anche fornirebucketPropsè un errore.
Bucket Props? s3.BucketProps Proprietà facoltative fornite dall'utente per sovrascrivere le proprietà predefinite per il bucket. Ignorato se unexistingBucketObjviene fornito.
BucketPermissions? string[] Autorizzazioni bucket facoltative da concedere alla funzione Lambda. Può essere specificato uno o più dei valori seguenti:Delete,Put,Read,ReadWrite,Write: .
VPC esistente? ec2.IVpc Un VPC opzionale esistente in cui deve essere distribuito questo modello. Quando viene distribuita in un VPC, la funzione Lambda utilizzerà ENI nel VPC per accedere alle risorse di rete e verrà creato un endpoint di interfaccia nel VPC per Amazon SQS. Se viene fornito un VPC esistente,deployVpcnon può esseretrue: . Questo utilizzaec2.IVpcper consentire ai client di fornire i VPC che esistono al di fuori dello stack utilizzando ilec2.Vpc.fromLookup()Metodo.
DeployVPC? boolean Se creare un nuovo VPC basato suvpcPropsin cui distribuire questo modello. Impostazione di questo valoretruedistribuirà il VPC minimo e più privato per eseguire il pattern:
  • Una sottorete isolata in ogni zona di disponibilità utilizzata dal programma CDK.

  • enableDnsHostnameseenableDnsSupportsaranno entrambi impostati sutrue: .

Se questa proprietà ètrue, quindiexistingVpcnon può essere specificato. L'impostazione predefinita è false.
VPCProp? ec2.VpcProps Proprietà facoltative fornite dall'utente per sovrascrivere le proprietà predefinite per il nuovo VPC.enableDnsHostnames,enableDnsSupport,natGatewaysesubnetConfigurationsono impostati dal modello, quindi tutti i valori per quelle proprietà fornite qui verranno ignorati. SedeployVpcnon ètrueQuesta proprietà verrà ignorata.
bucketEnvironmentVariableName? string Nome facoltativo per la variabile di ambiente bucket S3 impostata per la funzione Lambda.

Proprietà dei modelli

Nome Tipo Descrizione
LambdaFunction lambda.Function Restituisce un'istanza della funzione Lambda creata dal pattern.
S3Bucket? s3.Bucket Restituisce un'istanza del bucket S3 creato dalla serie.
S3loggingBucket? s3.Bucket Restituisce un'istanza del bucket di registrazione creato dal pattern per il bucket S3.
Il VPC? ec2.IVpc Restituisce un'istanza del VPC utilizzato dal modello (se presente). Questo può essere un VPC creato dal pattern o dal VPC fornito al costruttore del pattern.

Impostazioni predefinite

L'implementazione predefinita di questo modello senza sostituzioni imposterà i seguenti valori predefiniti:

Funzione di AWS Lambda

  • Configurare il ruolo IAM di accesso con privilegi limitati per la funzione Lambda.

  • Abilita il riutilizzo delle connessioni con Keep-Alive per la funzione NodeJS Lambda.

  • Abilita traccia X-Ray

  • Imposta le variabili di ambiente:

    • S3_BUCKET_NAME (predefinito)

    • AWS_NODEJS_CONNECTION_REUSE_ENABLED(per le funzioni Node 10.x e successive)

S3 Amazon S3

  • Configurare la registrazione accesso per S3 Bucket

  • Abilita la crittografia lato server per S3 Bucket utilizzando la chiave AWS gestita KMS.

  • Attivare il controllo delle versioni per S3 Bucket.

  • Non consentire l'accesso pubblico per S3 Bucket.

  • Mantenere il bucket S3 quando si elimina lo stack CloudFormation.

  • Applicazione della crittografia dei dati in transito

  • Applica la regola del ciclo di vita per spostare le versioni degli oggetti non correnti nell'archivio Glacier dopo 90 giorni.

Architecture

GitHub

Per visualizzare il codice per questo modello, creare/visualizzare problemi e richieste pull e altro ancora:
@aws -solutions-constructs/aws-lambda-s3