AWS CloudFormationAWS::Serverless::Functionが指定されているときに生成される リソース - AWS Serverless Application Model
コア関数のプロパティイベントソースイベント設定

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

AWS CloudFormationAWS::Serverless::Functionが指定されているときに生成される リソース

AWS::Serverless::Function を指定すると、 AWS Serverless Application Model (AWS SAM) は常に AWS::Lambda::Function ベース AWS CloudFormation リソースを作成します。

AWS::Lambda::Function

LogicalId: <function‑LogicalId>

参照可能なプロパティ: 該当なし (この AWS CloudFormation リソースを参照LogicalIdするには を使用する必要があります)

この AWS CloudFormation リソースに加えて、 を指定すると、 AWS::Serverless::Functionは次のシナリオの AWS CloudFormation リソース AWS SAM も生成します。

コア関数のプロパティ

次のシナリオでは、コア関数のプロパティに基づいて AWS CloudFormation リソースを生成します。

Role プロパティが指定されていない

の Roleプロパティが指定されていない場合、 AWS::Serverless::Functionは AWS::IAM::Role AWS CloudFormation リソース AWS SAM を生成します。

AWS::IAM::Role

LogicalId: <function‑LogicalId>Role

参照可能なプロパティ: 該当なし (この AWS CloudFormation リソースを参照LogicalIdするには を使用する必要があります)

AutoPublishAlias プロパティが指定されている

の AutoPublishAliasプロパティAWS::Serverless::Functionを指定すると、 は AWS::Lambda::Aliasおよび の AWS CloudFormation リソース AWS SAM を生成します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> は、スタックが作成されるときに生成される一意のハッシュ値です。例えば、MyFunctionVersion926eeb5ff1 などです。

参照可能なプロパティ: <function‑LogicalId>.Version

AutoPublishAlias プロパティの詳細については、AWS::Serverless::Function のプロパティセクションを参照してください。

DeploymentPreference プロパティが指定されている

の DeploymentPreferenceプロパティAWS::Serverless::Functionを指定するAWS::CodeDeploy::Applicationと、 は および の AWS CloudFormation リソースリソース AWS SAM を生成しますAWS::CodeDeploy::DeploymentGroup。さらに、 DeploymentPreference オブジェクトの Roleプロパティが指定されていない場合、 は AWS::IAM::Role AWS CloudFormation リソース AWS SAM も生成します。

AWS::CodeDeploy::Application

LogicalId: ServerlessDeploymentApplication

参照可能なプロパティ: 該当なし (この AWS CloudFormation リソースを参照LogicalIdするには を使用する必要があります)

AWS::CodeDeploy::DeploymentGroup

LogicalId: <function‑LogicalId>DeploymentGroup

参照可能なプロパティ: 該当なし (この AWS CloudFormation リソースを参照LogicalIdするには を使用する必要があります)

AWS::IAM::Role

LogicalId: CodeDeployServiceRole

参照可能なプロパティ: 該当なし (この AWS CloudFormation リソースを参照LogicalIdするには を使用する必要があります)

FunctionUrlConfig プロパティが指定されています

FunctionUrlConfig プロパティを指定すると、 は に基づいて異なる AWS CloudFormation リソース AWS SAM を生成しますAuthType。

AuthType: NONE を指定すると、 は次の AWS CloudFormation リソース AWS SAM を生成します。

AWS::Lambda::Permission (アクセスを呼び出す)

LogicalId: <function‑LogicalId>URLInvokeAllowPublicAccess

参照可能なプロパティ: 該当なし (この AWS CloudFormation リソースを参照LogicalIdするには を使用する必要があります)

AWS::Lambda::Permission (パブリックアクセス)

LogicalId: <function‑LogicalId>UrlPublicPermissions

参照可能なプロパティ: 該当なし (この AWS CloudFormation リソースを参照LogicalIdするには を使用する必要があります)

AWS::Lambda::Url

LogicalId: <function‑LogicalId>Url

参照可能なプロパティ: 該当なし (この AWS CloudFormation リソースを参照LogicalIdするには を使用する必要があります)

を指定するAuthType: AWS_IAMと、 は以下のみ AWS SAM を生成します。

AWS::Lambda::Url

LogicalId: <function‑LogicalId>Url

参照可能なプロパティ: 該当なし (この AWS CloudFormation リソースを参照LogicalIdするには を使用する必要があります)

FunctionUrlConfig プロパティの詳細については、「 FunctionUrlConfig」を参照してください。

イベントソース

次のシナリオでは、イベントソースに基づいて AWS CloudFormation リソースを生成します。

Api イベントソースが指定されている

の EventプロパティAWS::Serverless::Functionが に設定されているがApi、 RestApiIdプロパティが指定されていない場合、 はAWS::ApiGateway::RestApi AWS CloudFormation リソース AWS SAM を生成します。

AWS::ApiGateway::RestApi

LogicalId: ServerlessRestApi

参照可能なプロパティ: 該当なし (この AWS CloudFormation リソースを参照LogicalIdするには を使用する必要があります)

HttpApi イベントソースが指定されている

の EventプロパティAWS::Serverless::Functionが に設定されているがHttpApi、 ApiIdプロパティが指定されていない場合、 は AWS::ApiGatewayV2::Api AWS CloudFormation リソース AWS SAM を生成します。

AWS::ApiGatewayV2::Api

LogicalId: ServerlessHttpApi

参照可能なプロパティ: 該当なし (この AWS CloudFormation リソースを参照LogicalIdするには を使用する必要があります)

ストリーミングイベントソースが指定されている

の EventプロパティAWS::Serverless::Functionがストリーミングタイプの 1 つに設定されている場合、 はAWS::Lambda::EventSourceMapping AWS CloudFormation リソース AWS SAM を生成します。これは、DynamoDB、Kinesis、MQ、MSK、および SQS の各タイプに適用されます。

AWS::Lambda::EventSourceMapping

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

参照可能なプロパティ: 該当なし (この AWS CloudFormation リソースを参照LogicalIdするには を使用する必要があります)

イベントブリッジ (またはイベントバス) イベントソースが指定されている

の EventプロパティAWS::Serverless::Functionがイベントブリッジ (またはイベントバス) タイプの 1 つに設定されている場合、 はAWS::Events::Rule AWS CloudFormation リソース AWS SAM を生成します。これは、EventBridgeRule、Schedule、および CloudWatchEvents の各タイプに適用されます。

AWS::Events::Rule

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

参照可能なプロパティ: 該当なし (この AWS CloudFormation リソースを参照LogicalIdするには を使用する必要があります)

IotRule イベントソースが指定されている

の EventプロパティAWS::Serverless::Functionが IoTRule に設定されている場合、 はAWS::IoT::TopicRule AWS CloudFormation リソース AWS SAM を生成します。

AWS::IoT::TopicRule

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

参照可能なプロパティ: 該当なし (この AWS CloudFormation リソースを参照LogicalIdするには を使用する必要があります)

イベント設定

次のシナリオでは、イベント設定に基づいて AWS CloudFormation リソースを生成します。

Amazon SNS イベントに対して OnSuccess (または OnFailure) プロパティが指定されている

の プロパティの DestinationConfigプロパティの OnSuccess (または OnFailure) EventInvokeConfigプロパティAWS::Serverless::Functionが指定され、送信先タイプが SNSであっても送信先 ARN が指定されていない場合、 は AWS::Lambda::EventInvokeConfigおよび の AWS CloudFormation リソース AWS SAM を生成しますAWS::SNS::Topic。

AWS::Lambda::EventInvokeConfig

LogicalId: <function‑LogicalId>EventInvokeConfig

参照可能なプロパティ: 該当なし (この AWS CloudFormation リソースを参照LogicalIdするには を使用する必要があります)

AWS::SNS::Topic

LogicalId: <function‑LogicalId>OnSuccessTopic (または <function‑LogicalId>OnFailureTopic)

参照可能なプロパティ: <function‑LogicalId>.DestinationTopic

OnSuccess と OnFailure の両方が Amazon SNS イベントに指定されている場合、生成されたリソースを区別するには LogicalId を使用する必要があります。

Amazon SQS イベントに対して OnSuccess (または OnFailure) プロパティが指定されている

の プロパティの DestinationConfigプロパティの OnSuccess (または OnFailure) EventInvokeConfigプロパティAWS::Serverless::Functionが指定され、送信先タイプが SQSであっても送信先 ARN が指定されていない場合、 は AWS::Lambda::EventInvokeConfigおよび の AWS CloudFormation リソース AWS SAM を生成しますAWS::SQS::Queue。

AWS::Lambda::EventInvokeConfig

LogicalId: <function‑LogicalId>EventInvokeConfig

参照可能なプロパティ: 該当なし (この AWS CloudFormation リソースを参照LogicalIdするには を使用する必要があります)

AWS::SQS::Queue

LogicalId: <function‑LogicalId>OnSuccessQueue (または <function‑LogicalId>OnFailureQueue)

参照可能なプロパティ: <function‑LogicalId>.DestinationQueue

OnSuccess と OnFailure の両方が Amazon SQS イベントに指定されている場合、生成されたリソースを区別するには LogicalId を使用する必要があります。