CloudFormation가 지정된 경우 생성되는 AWS::Serverless::Function 리소스 - AWS Serverless Application Model
핵심 함수 속성이벤트 소스이벤트 구성

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

CloudFormation가 지정된 경우 생성되는 AWS::Serverless::Function 리소스

AWS::Serverless::Function이 지정되면 AWS Serverless Application Model(AWS SAM)는 항상 AWS::Lambda::Function 기본 CloudFormation 리소스를 만듭니다.

AWS::Lambda::Function

LogicalId: <function‑LogicalId>

참조 가능한 속성: 해당 없음(이 CloudFormation 리소스를 참조하려면 LogicalId를 사용해야 합니다.)

이 CloudFormation 리소스 외에도 AWS::Serverless::Function를 지정하면 AWS SAM은 다음 시나리오에 대한 CloudFormation 리소스도 생성합니다.

핵심 함수 속성

다음 시나리오는 핵심 함수 속성을 기반으로 CloudFormation 리소스를 생성합니다.

역할 속성이 지정되지 않음

Role의 AWS::Serverless::Function 속성이 지정되지 않은 경우 AWS SAM는 AWS::IAM::Role CloudFormation 리소스를 생성합니다.

AWS::IAM::Role

LogicalId: <function‑LogicalId>Role

참조 가능한 속성: 해당 없음(이 CloudFormation 리소스를 참조하려면 LogicalId를 사용해야 합니다.)

AutoPublishalias 속성 지정됨

AutoPublishAlias의 AWS::Serverless::Function 속성을 지정하면 AWS SAM은 다음과 같은 CloudFormation 리소스, 즉 AWS::Lambda::Alias 및 AWS::Lambda::Version을 생성합니다.

AWS::Lambda::Alias

LogicalId: <function‑LogicalId>Alias<alias‑name>

<alias‑name>은 AutoPublishAlias가 설정된 문자열입니다. 예를 들어 AutoPublishAlias을 live로 설정하면 LogicalId은 MyFunctionAliaslive입니다.

참조 가능한 속성: <function‑LogicalId>.Alias

AWS::Lambda::Version

LogicalId: <function‑LogicalId>Version<sha>

<sha>은 스택이 만들어질 때 생성되는 고유한 해시 값입니다. 예를 들어 MyFunction버전926eeb5ff1입니다.

참조 가능한 속성: <function‑LogicalId>.Version

AutoPublishAlias 속성에 대한 자세한 내용은 AWS::Serverless::Function의 속성 섹션을 참조하세요.

DeploymentPreference 속성 지정됨

DeploymentPreference의 AWS::Serverless::Function 속성을 지정하면 AWS SAM은 다음과 같은 CloudFormation 리소스, 즉 AWS::CodeDeploy::Application 및 AWS::CodeDeploy::DeploymentGroup을 생성합니다. 또한, Role 객체의 DeploymentPreference 속성이 지정되지 않은 경우, AWS SAM는 AWS::IAM::Role CloudFormation 리소스를 생성합니다.

AWS::CodeDeploy::Application

LogicalId: ServerlessDeploymentApplication

참조 가능한 속성: 해당 없음(이 LogicalId 리소스를 참조하려면 CloudFormation를 사용해야 합니다.)

AWS::CodeDeploy::DeploymentGroup

LogicalId: <function‑LogicalId>DeploymentGroup

참조 가능한 속성: 해당 없음(이 LogicalId 리소스를 참조하려면 CloudFormation를 사용해야 합니다.)

AWS::IAM::Role

LogicalId: CodeDeployServiceRole

참조 가능한 속성: 해당 없음(이 LogicalId 리소스를 참조하려면 CloudFormation를 사용해야 합니다.)

FunctionUrlConfig 속성이 지정됨

FunctionUrlConfig 속성이 지정되면, AWS SAM은(는) AuthType을(를) 기반으로 다른 CloudFormation 리소스를 생성합니다.

AuthType: NONE이(가) 지정되면 AWS SAM은(는) 다음 CloudFormation 리소스를 생성합니다.

AWS::Lambda::Permission(액세스 간접 호출)

LogicalId: <function‑LogicalId>URLInvokeAllowPublicAccess

참조 가능한 속성: 해당 없음(이 LogicalId 리소스를 참조하려면 CloudFormation를 사용해야 합니다.)

AWS::Lambda::Permission(퍼블릭 액세스)

LogicalId: <function‑LogicalId>UrlPublicPermissions

참조 가능한 속성: 해당 없음(이 LogicalId 리소스를 참조하려면 CloudFormation를 사용해야 합니다.)

AWS::Lambda::Url

LogicalId: <function‑LogicalId>Url

참조 가능한 속성: 해당 없음(이 LogicalId 리소스를 참조하려면 CloudFormation를 사용해야 합니다.)

AuthType: AWS_IAM이(가) 지정되면 AWS SAM은(는) 다음만 생성합니다.

AWS::Lambda::Url

LogicalId: <function‑LogicalId>Url

참조 가능한 속성: 해당 없음(이 LogicalId 리소스를 참조하려면 CloudFormation를 사용해야 합니다.)

FunctionUrlConfig 속성에 대한 추가 정보는 FunctionUrlConfig를 참조하세요.

이벤트 소스

다음 시나리오에서는 이벤트 소스를 기반으로 CloudFormation 리소스를 생성합니다.

Api 이벤트 소스 지정됨

Event의 AWS::Serverless::Function 속성이 Api으로 설정되었지만 RestApiId 속성이 지정되지 않은 경우 AWS SAM이 AWS::ApiGateway::RestApi CloudFormation 리소스를 생성합니다.

AWS::ApiGateway::RestApi

LogicalId: ServerlessRestApi

참조 가능한 속성: 해당 없음(이 LogicalId 리소스를 참조하려면 CloudFormation를 사용해야 합니다.)

HttpApi 이벤트 소스 지정됨

Event의 AWS::Serverless::Function 속성이 HttpApi으로 설정되었지만 ApiId 속성이 지정되지 않은 경우 AWS SAM이 AWS::ApiGatewayV2::Api CloudFormation 리소스를 생성합니다.

AWS::ApiGatewayV2::Api

LogicalId: ServerlessHttpApi

참조 가능한 속성: 해당 없음(이 LogicalId 리소스를 참조하려면 CloudFormation를 사용해야 합니다.)

스트리밍 이벤트 소스 지정됨

Event의 AWS::Serverless::Function 속성이 스트리밍 타입의 하나로 설정된 경우, AWS SAM이 AWS::Lambda::EventSourceMapping CloudFormation 리소스를 생성합니다. 이는 DynamoDB, Kinesis, MQ, MSK, 및 SQS 유형에 적용됩니다.

AWS::Lambda::EventSourceMapping

LogicalId: <function‑LogicalId><event‑LogicalId>

참조 가능한 속성: 해당 없음(이 LogicalId 리소스를 참조하려면 CloudFormation를 사용해야 합니다.)

이벤트 브리지(또는 이벤트 버스) 이벤트 소스 지정됨

Event의 AWS::Serverless::Function 속성이 이벤트 브리지 (또는 이벤트 버스) 유형 중 하나로 설정되면 AWS SAM이 AWS::Events::Rule CloudFormation 리소스를 생성합니다. 이는EventBridgeRule, Schedule, 및 CloudWatchEvents 유형에 적용됩니다.

AWS::Events::Rule

LogicalId: <function‑LogicalId><event‑LogicalId>

참조 가능한 속성: 해당 없음(이 LogicalId 리소스를 참조하려면 CloudFormation를 사용해야 합니다.)

IoTRule 이벤트 소스 지정됨

Event의 AWS::Serverless::Function 속성이 IoTrule로 설정되면 AWS SAM이 AWS::IoT::TopicRule CloudFormation 리소스를 생성합니다.

AWS::IoT::TopicRule

LogicalId: <function‑LogicalId><event‑LogicalId>

참조 가능한 속성: 해당 없음(이 LogicalId 리소스를 참조하려면 CloudFormation를 사용해야 합니다.)

이벤트 구성

다음 시나리오에서는 이벤트 구성을 기반으로 CloudFormation 리소스를 생성합니다.

Amazon SNS 이벤트에 대하여 OnSuccess(또는 OnFailure) 속성이 지정됩니다

OnSuccess의 OnFailure 속성의 DestinationConfig 속성의 EventInvokeConfig(또는 AWS::Serverless::Function) 속성이 지정되고 대상 유형이 SNS이지만, 대상 ARN이 지정되지 않은 경우, AWS SAM이 다음 CloudFormation 리소스, 즉 AWS::Lambda::EventInvokeConfig 및 AWS::SNS::Topic를 생성합니다.

AWS::Lambda::EventInvokeConfig

LogicalId: <function‑LogicalId>EventInvokeConfig

참조 가능한 속성: 해당 없음(이 LogicalId 리소스를 참조하려면 CloudFormation를 사용해야 합니다.)

AWS::SNS::Topic

LogicalId: <function‑LogicalId>OnSuccessTopic (또는 <function‑LogicalId>OnFailureTopic)

참조 가능한 속성: <function‑LogicalId>.DestinationTopic

OnSuccess및 OnFailure 가 모두 Amazon SNS 이벤트에 관하여 지정된 경우, 생성된 리소스 간에 구분하려면 LogicalId를 사용해야 합니다.

Amazon SQS 이벤트에 대하여 OnSuccess(또는 OnFailure) 속성이 지정됩니다

OnSuccess의 OnFailure 속성의 DestinationConfig 속성의 EventInvokeConfig(또는 AWS::Serverless::Function) 속성이 지정되고 대상 유형이 SQS이지만, 대상 ARN이 지정되지 않은 경우, AWS SAM이 다음 CloudFormation 리소스, 즉 AWS::Lambda::EventInvokeConfig 및 AWS::SQS::Queue를 생성합니다.

AWS::Lambda::EventInvokeConfig

LogicalId: <function‑LogicalId>EventInvokeConfig

참조 가능한 속성: 해당 없음(이 LogicalId 리소스를 참조하려면 CloudFormation를 사용해야 합니다.)

AWS::SQS::Queue

LogicalId: <function‑LogicalId>OnSuccessQueue (또는 <function‑LogicalId>OnFailureQueue)

참조 가능한 속성: <function‑LogicalId>.DestinationQueue

OnSuccess및 OnFailure 가 모두 Amazon SQS 이벤트에 관하여 지정된 경우, 생성된 리소스 간에 구분하려면 LogicalId를 사용해야 합니다.