AWS::Serverless::LayerVersion - AWS Serverless Application Model
구문속성반환 값예시

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS::Serverless::LayerVersion

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

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

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

Serverless가 변환되면 LayerVersion 는 리소스가 업데이트 LayerVersions 될 CloudFormation 때 이전 가 자동으로 삭제되지 않도록 리소스의 논리적 IDSAM도 변환합니다.

참고

에 배포하면 가 AWS SAM 리소스를 AWS CloudFormation 리소스로 AWS CloudFormation AWS SAM 변환합니다. 자세한 내용은 AWS SAM용으로 생성된 AWS CloudFormation 리소스 단원을 참조하십시오.

구문

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 동등한 속성이 없습니다.

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

반환 값

Ref

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

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

예시

LayerVersionExample

의 예 LayerVersion

YAML

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