기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # aws-람다-s3 ![](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/images/experimental.png) 모든 클래스는 활발히 개발 중이며 향후 버전에서 이전 버전과 호환되지 않는 변경 또는 제거 될 수 있습니다. 이들은 적용되지 않습니다[의미 체계 버전](https://semver.org/)모델을 활성화합니다. 즉, 이 패키지를 사용할 수도 있지만 이 패키지의 최신 버전으로 업그레이드할 때 소스 코드를 업데이트해야 할 수도 있습니다. **참고:** 적절한 기능을 보장하려면 프로젝트의 AWS 솔루션 구성 패키지와 AWS CDK 패키지가 동일한 버전이어야 합니다. | **언어** | **패키지** | | --- | --- | | ![](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/images/python.png) Python | aws\_solutions\_constructs.aws\_lambda\_s3 | | ![](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/images/typescript.png) 타이프 스크립트 | @aws-solutions-constructs/aws-lambda-s3 | | ![](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/images/java.png) Java | software.amazon.awsconstructs.services.lambdas3 | ## Overview 이 AWS 솔루션 구조는 Amazon S3 버킷에 연결된 AWS Lambda 함수를 구현합니다. 다음은 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); ``` *파라미터* + scope[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[`LambdaToS3Props`](#pattern-construct-props-19) ## 패턴 | **이름** | **유형** | **설명** | | --- | --- | --- | | 람다오브즈 기존인가요? | [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) | Lambda 함수 객체의 기존 인스턴스, 이 및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) | Lambda 함수의 기본 속성을 재정의하는 선택적 사용자 제공 속성입니다. 의 경우에는 무시됩니다.existingLambdaObj제공될 예정입니다. | | 버켓토비 기존에? | [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.IBucket.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.IBucket.html) | S3 버킷 객체의 기존 인스턴스입니다. 이것이 제공되는 경우bucketProps는 오류입니다. | | 버킷 소품? | [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.BucketProps.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.BucketProps.html) | 버킷의 기본 속성을 재정의하는 선택적 사용자 제공 속성입니다. 의 경우에는 무시됩니다.existingBucketObj제공될 예정입니다. | | 버킷 사용 권한? | string[] | Lambda 함수에 부여할 선택적 버킷 권한입니다. 다음 중 한 개 이상을 지정할 수 있습니다.Delete,Put,Read,ReadWrite,Write. | | 기존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) | 이 패턴을 배포해야 하는 선택 사항인 기존 VPC 입니다. VPC PC에 배포되면 Lambda 함수는 VPC의 ENI를 사용하여 네트워크 리소스에 액세스하고 인터페이스 엔드포인트는 Amazon SQS 용 VPC에 생성됩니다. 기존 VPC 가 제공되면deployVpc속성은true. 이 사용ec2.IVpc를 사용하여 클라이언트가 스택 외부에 있는 VPC를 제공할 수 있도록[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)메서드를 호출합니다. | | VPC를 배포하시겠습니까? | boolean | 새 VPC 생성하려면vpcProps이 패턴을 배포 할 수 있습니다. 이 를 로 설정합니다.true는 패턴을 실행하기 위해 최소한의 대부분의 프라이빗 VPC 배포합니다.[See the AWS documentation website for more details](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/aws-lambda-s3.html) 이 속성이true을 선택한 다음existingVpc를 지정할 수 없습니다. 기본값은 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) | 새 VPC 기본 속성을 재정의하는 선택적 사용자 제공 속성입니다.enableDnsHostnames,enableDnsSupport,natGateways및subnetConfiguration는 패턴에 의해 설정되므로 여기에 제공된 속성에 대한 모든 값이 오버라이드됩니다. 다음의 경우,deployVpc이 (가)true이 속성은 무시됩니다. | | 버켓텐바이론변수 이름? | string | Lambda 함수에 대한 S3 버킷 환경 변수 세트의 선택적 이름입니다. | ## 패턴 | **이름** | **유형** | **설명** | | --- | --- | --- | | 람다함수 | [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) | 패턴에 의해 생성 된 Lambda 함수의 인스턴스를 돌려줍니다. | | S3Bucket? | [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.Bucket.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.Bucket.html) | 패턴에 의해 생성된 S3 버킷의 인스턴스를 반환합니다. | | s3로깅 버킷? | [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.Bucket.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-s3.Bucket.html) | S3 버킷의 패턴으로 생성된 로깅 버킷의 인스턴스를 반환합니다. | | VPC 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) | 패턴에 사용된 VPC 인스턴스 (있는 경우) 를 반환합니다. 패턴에 의해 생성된 VPC 또는 패턴 생성자에 제공된 VPC일 수 있습니다. | ## 기본 설정 재정의없이이 패턴을 즉시 구현하면 다음과 같은 기본값이 설정됩니다. ### AWS Lambda 함수 + Lambda 함수에 대한 제한된 권한 액세스 IAM 역할을 구성합니다. + NodeJS Lambda 함수에 대한 연결 유지와 연결을 재사용 할 수 있습니다. + X-Ray 추적 + 환경 변수를 설정합니다. + `S3_BUCKET_NAME` (default) + `AWS_NODEJS_CONNECTION_REUSE_ENABLED`(노드 10.x 이상 함수의 경우) ### Amazon S3 버킷 + S3 버킷에 대한 액세스 로깅을 구성합니다. + AWS 관리형 KMS 키를 사용하여 S3 버킷에 대한 서버 측 암호화를 활성화합니다. + S3 버킷의 버전 관리를 켭니다. + S3 버킷에 대한 공용 액세스를 허용하지 않습니다. + CloudFormation 스택을 삭제할 때 S3 버킷을 유지합니다. + 전송 중인 데이터의 암호화를 실행합니다. + 90일 후에 최신 버전이 아닌 객체 버전을 Glacier 스토리지로 이동하는 수명 주기 규칙을 적용합니다. ## Architecture ![](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/images/aws-lambda-s3.png) ## GitHub
이 패턴의 코드를 보려면 문제 및 끌어오기 요청을 작성/조회하는 등의 작업을 수행합니다.
![](http://docs.aws.amazon.com/ko_kr/solutions/latest/constructs/images/GitHub-Mark-32px.png) [@aws -솔루션 - 구성/aws - 람다 - S3](https://github.com/awslabs/aws-solutions-constructs/tree/master/source/patterns/%40aws-solutions-constructs/aws-lambda-s3)