기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
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 SAMAWS::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