AWS::Serverless::LayerVersion

LayerVersion Lambda 함수에 필요한 라이브러리 또는 런타임 코드를 포함하는 Lambda를 생성합니다.

또한 AWS::Serverless::LayerVersion 리소스는 Metadata 리소스 속성을 지원하므로 애플리케이션에 포함된 계층을 AWS SAM 구축하도록 지시할 수 있습니다. 레이어 구축에 대한 자세한 내용은 에서 Lambda 레이어 구축 AWS SAM 섹션을 참조하세요.

중요 참고: 에서 UpdateReplacePolicy AWS CloudFormation리소스 속성이 릴리스된 이후 AWS::Lambda::LayerVersion(권장) 은 과 동일한 AWS::Serverless::LayerVersion 이점을 제공합니다.

서버리스가 변환되면 LayerVersion SAM은 리소스의 논리적 ID도 변환하여 CloudFormation 리소스가 업데이트될 때까지 이전 버전이 자동으로 LayerVersions 삭제되지 않도록 합니다.

참고

에 AWS CloudFormation배포하면 AWS SAM 리소스가 리소스로 AWS SAM 변환됩니다. AWS CloudFormation 자세한 정보는 에 대한 AWS CloudFormation 리소스 생성 AWS SAM을 참조하세요.

구문

AWS Serverless Application Model (AWS SAM) 템플릿에서 이 엔티티를 선언하려면 다음 구문을 사용하십시오.

YAML

Type: AWS::Serverless::LayerVersion
Properties:
  CompatibleArchitectures: List
  CompatibleRuntimes: List
  ContentUri: String | LayerContent
  Description: String
  LayerName: String
  LicenseInfo: String
  RetentionPolicy: String

속성

CompatibleArchitectures

레이어 버전에 지원되는 명령어 세트 아키텍처를 지정합니다.

이 속성에 대한 자세한 내용은 AWS Lambda 개발자 가이드의 Lambda 명령 세트 아키텍처를 참조하세요.

유효한 값: x86_64, arm64

유형: 목록

필수 항목 여부: 아니요

기본값: x86_64

AWS CloudFormation 호환성: 이 속성은 AWS::Lambda::LayerVersion 리소스의 CompatibleArchitectures 속성으로 직접 전달됩니다.

CompatibleRuntimes

이와 LayerVersion 호환되는 런타임 목록.

유형: 목록

필수 항목 여부: 아니요

AWS CloudFormation 호환성: 이 속성은 AWS::Lambda::LayerVersion 리소스의 CompatibleRuntimes 속성으로 직접 전달됩니다.

ContentUri

Amazon S3 Uri, 로컬 폴더 경로 또는 레이어 코드의 LayerContent 객체

Amazon S3 Uri 또는 LayerContent 객체가 제공되는 경우 참조되는 Amazon S3 객체는 Lambda 계층의 콘텐츠를 포함하는 유효한 ZIP 아카이브여야 합니다.

로컬 폴더 경로가 제공되는 경우 콘텐츠가 제대로 변환되려면 템플릿은 sam build 및 그 다음으로 sam deploy 또는 sam package 중 하나가 포함된 워크플로를 거쳐야 합니다. 기본적으로 상대 경로는 AWS SAM 템플릿의 위치를 기준으로 확인됩니다.

유형: 문자열 | LayerContent

필수 항목 여부: 예

AWS CloudFormation 호환성: 이 속성은 AWS::Lambda::LayerVersion 리소스의 Content 속성과 유사합니다. 중첩된 Amazon S3 속성은 다르게 지정됩니다.

Description

이 레이어에 대한 설명.

타입: 문자열

필수 항목 여부: 아니요

AWS CloudFormation 호환성: 이 속성은 AWS::Lambda::LayerVersion 리소스의 Description 속성으로 직접 전달됩니다.

LayerName

레이어의 이름 또는 Amazon 리소스 이름(ARN)입니다.

타입: 문자열

필수 항목 여부: 아니요

기본값: 리소스 논리적 ID

AWS CloudFormation 호환성: 이 속성은 AWS::Lambda::LayerVersion 리소스의 LayerName 속성과 유사합니다. 이름을 지정하지 않으면 리소스의 논리적 ID를 이름으로 사용합니다.

LicenseInfo

이에 대한 라이선스에 대한 정보 LayerVersion.

타입: 문자열

필수 항목 여부: 아니요

AWS CloudFormation 호환성: 이 속성은 AWS::Lambda::LayerVersion 리소스 LicenseInfo 속성으로 직접 전달됩니다.

RetentionPolicy

이 속성은 리소스를 삭제할 때 이전 버전을 보존할지 아니면 삭제할지를 지정합니다. LayerVersion 리소스를 업데이트하거나 LayerVersion 교체할 때 이전 버전을 보존해야 하는 경우 UpdateReplacePolicy 속성을 활성화해야 합니다. 이 작업에 대한 자세한 내용은 AWS CloudFormation 사용 설명서의 UpdateReplacePolicy속성을 참조하십시오.

유효한 값: Retain 또는 Delete

타입: 문자열

필수 항목 여부: 아니요

AWS CloudFormation 호환성: 이 속성은 AWS SAM 고유하며 AWS CloudFormation 이에 상응하는 속성이 없습니다.

추가 참고 사항: Retain 지정하면 변환된 에서 지원하는 리소스 속성 AWS SAM AWS::Lambda::LayerVersion 리소스에 f가 AWS SAM 추가됩니다. DeletionPolicy: Retain

반환 값

Ref

이 리소스의 논리적 ID가 Ref 내장 함수에 제공되면 기본 Lambda의 리소스 ARN을 반환합니다. LayerVersion

Ref 함수의 사용에 대한 자세한 내용은 AWS CloudFormation 사용자 가이드의 Ref 섹션을 참조하세요.

예

LayerVersionExample

예시: LayerVersion

YAML

Properties:
  LayerName: MyLayer
  Description: Layer description
  ContentUri: 's3://my-bucket/my-layer.zip'
  CompatibleRuntimes:
    - nodejs10.x
    - nodejs12.x
  LicenseInfo: 'Available under the MIT-0 license.'
  RetentionPolicy: Retain