AWS::Serverless::Function

AWS Lambda 関数、 AWS Identity and Access Management (IAM) 実行ロール、および関数をトリガーするイベントソースマッピングを作成します。

AWS::Serverless::FunctionMetadataリソースはリソース属性もサポートするので、 AWS SAM アプリケーションに必要なカスタムランタイムを構築するように指示できます。カスタムランタイムの構築の詳細については、「カスタムランタイムの構築」を参照してください。

注記

にデプロイすると AWS CloudFormation、 AWS SAM AWS SAM リソースはリソースに変換されます。 AWS CloudFormation 詳細については、「生成された AWS CloudFormation リソース」を参照してください。

Syntax

AWS Serverless Application Model (AWS SAM) テンプレートでこのエンティティを宣言するには、次の構文を使用します。

YAML

Type: AWS::Serverless::Function
Properties:
  Architectures: List
  AssumeRolePolicyDocument: JSON
  AutoPublishAlias: String
  AutoPublishAliasAllProperties: Boolean
  AutoPublishCodeSha256: String
  CodeSigningConfigArn: String
  CodeUri: String | FunctionCode
  DeadLetterQueue: Map | DeadLetterQueue
  DeploymentPreference: DeploymentPreference
  Description: String
  Environment: Environment
  EphemeralStorage: EphemeralStorage
  EventInvokeConfig: EventInvokeConfiguration
  Events: EventSource
  FileSystemConfigs: List
  FunctionName: String
  FunctionUrlConfig: FunctionUrlConfig
  Handler: String
  ImageConfig: ImageConfig
  ImageUri: String
  InlineCode: String
  KmsKeyArn: String
  Layers: List
  LoggingConfig: LoggingConfig
  MemorySize: Integer
  PackageType: String
  PermissionsBoundary: String
  Policies: String | List | Map
  PropagateTags: Boolean
  ProvisionedConcurrencyConfig: ProvisionedConcurrencyConfig
  ReservedConcurrentExecutions: Integer
  Role: String
  RolePath: String
  Runtime: String
  RuntimeManagementConfig: RuntimeManagementConfig
  SnapStart: SnapStart
  Tags: Map
  Timeout: Integer
  Tracing: String
  VersionDescription: String
  VpcConfig: VpcConfig

プロパティ

Architectures

関数の命令セットアーキテクチャ。

このプロパティの詳細については、AWS Lambda デベロッパーガイドの「Lambda 命令セットアーキテクチャ」を参照してください。

有効な値: x86_64 または arm64 のいずれか。

タイプ: リスト

必須: いいえ

デフォルト: x86_64

AWS CloudFormation 互換性:Architecturesこのプロパティはリソースのプロパティに直接渡されます。AWS::Lambda::Function

AssumeRolePolicyDocument

AssumeRolePolicyDocument Roleこの関数用に作成されたデフォルトにを追加します。このプロパティが指定されていない場合は、この関数にデフォルトの assume role AWS SAM が追加されます。

Type: JSON

必須: いいえ

AWS CloudFormation 互換性:AssumeRolePolicyDocumentAWS::IAM::Roleこのプロパティはリソースのプロパティに似ています。 AWS SAM このプロパティをこの関数用に生成された IAM ロールに追加します。この関数にロールの Amazon リソースネーム (ARN) が提供されている場合、このプロパティは何も実行しません。

AutoPublishAlias

Lambda エイリアスの名前です。Lambda エイリアスの詳細については、AWS Lambda デベロッパーガイドの「Lambda 関数のエイリアス」を参照してください。このプロパティを使用する例については、「サーバーレスアプリケーションの段階的なデプロイ」を参照してください。

AWS SAM AWS::Lambda::VersionAWS::Lambda::Aliasこのプロパティを設定すると生成とリソースが生成されます。このシナリオの詳細については、「AutoPublishAlias プロパティが指定されている」を参照してください。 AWS CloudFormation 生成されたリソースに関する一般的な情報については、を参照してください生成された AWS CloudFormation リソース。

タイプ: 文字列

必須: いいえ

AWS CloudFormation 互換性: AWS SAM このプロパティは固有のもので、 AWS CloudFormation 同等のプロパティはありません。

AutoPublishAliasAllProperties

新しい AWS::Lambda::Version が作成されるタイミングを指定します。true の場合、 Lambda 関数のプロパティが変更されると、新しい Lambda バージョンが作成されます。false の場合、次のプロパティのいずれかが変更された場合にのみ、新しい Lambda バージョンが作成されます。

• Environment、MemorySize、SnapStart

• Code プロパティの更新を伴う変更 (CodeDict、ImageUri、InlineCode など)。

このプロパティでは AutoPublishAlias を定義する必要があります。

AutoPublishSha256 も指定されている場合、その動作は AutoPublishAliasAllProperties: true よりも優先されます。

タイプ: ブール

必須: いいえ

デフォルト値: false

AWS CloudFormation 互換性: AWS SAM このプロパティは固有のもので、 AWS CloudFormation 同等のものはありません。

AutoPublishCodeSha256

この文字列を使用すると、CodeUri値と連動して新しい Lambda バージョンを公開する必要があるかどうかが決まります。このプロパティは、次のようなデプロイの問題を解決するためによく使用されます。デプロイパッケージは Amazon S3 ロケーションに保存され、更新された Lambda 関数コードを含む新しいデプロイパッケージに置き換えられますが、CodeUriプロパティは変更されません (新しいデプロイパッケージが新しい Amazon S3 ロケーションにアップロードされ、CodeUri新しいロケーションに変更されるのとは対照的です)。

この問題は、 AWS SAM 次のような特徴を持つテンプレートによって特徴付けられます。

• DeploymentPreferenceオブジェクトは段階的に展開できるように設定されている (を参照)。サーバーレスアプリケーションの段階的なデプロイ

• AutoPublishAliasプロパティは設定されており、デプロイのたびに変更されることはありません。

• CodeUriプロパティは設定されており、デプロイメント間で変更されることはありません。

このシナリオでは、AutoPublishCodeSha256 を更新することで新しい Lambda バージョンが正常に作成されます。ただし、Amazon S3 にデプロイされた新しい関数コードは認識されません。新しい関数コードを認識するには、Amazon S3 バケットのバージョニングを使用することを検討してください。Lambda 関数の Version プロパティを指定し、常に最新のデプロイパッケージを使用するようにバケットを設定します。

このシナリオで段階的なデプロイを正常にトリガーするには、AutoPublishCodeSha256 に一意の値を提供する必要があります。

型: 文字列

必須: いいえ

AWS CloudFormation 互換性: AWS SAM このプロパティは固有のもので、 AWS CloudFormation 同等のものはありません。

CodeSigningConfigArn

AWS::Lambda::CodeSigningConfig リソースの ARN で、この関数のコード署名を有効にするために使用されます。コード署名の詳細については、「AWS SAM アプリケーションのためのコード署名の設定」を参照してください。

型: 文字列

必須: いいえ

AWS CloudFormation 互換性:CodeSigningConfigArnAWS::Lambda::Functionこのプロパティはリソースのプロパティに直接渡されます。

CodeUri

関数のコード 以下のような値を設定できます。

• 関数の Amazon S3 URI。例えば s3://bucket-123456789/sam-app/1234567890abcdefg です。

• 関数へのローカルパス。例えば hello_world/ です。

• FunctionCode オブジェクト。

注記

関数の Amazon S3 URI または FunctionCode オブジェクトを指定する場合は、有効な Lambda デプロイパッケージを参照する必要があります。

ローカルファイルパスを指定する場合は、 AWS SAM CLI を使用してデプロイ時にローカルファイルをアップロードします。詳細については、「AWS SAM CLI を使用してデプロイ時にローカルファイルをアップロードする」を参照してください。

CodeUriプロパティで組み込み関数を使用すると、 AWS SAM 値を正しく解析できなくなります。AWS::Language代わりに拡張トランスフォームの使用を検討してください。

タイプ: [ 文字列 | FunctionCode ]

必須: 条件的。PackageType が Zip に設定されている場合、CodeUri または InlineCode のいずれかが必須です。

AWS CloudFormation 互換性: CodeAWS::Lambda::Functionこのプロパティはリソースのプロパティに似ています。ネストされた Amazon S3 プロパティには異なる名前が付けられています。

DeadLetterQueue

処理できないイベントを Lambda が送信する Amazon Simple Notification Service (Amazon SNS) トピックまたは Amazon Simple Queue Service (Amazon SQS) キューを設定します。デッドレターキュー機能の詳細については、「AWS Lambda デベロッパーガイド」の「デッドレターキュー」を参照してください。

注記

Lambda 関数のイベントソースが Amazon SQS キューである場合は、Lambda 関数ではなく、ソースキューのデッドレターキューを設定してください。関数用に設定するデッドレターキューは、イベントソースキューではなく、関数の非同期呼び出しキューに使用されます。

タイプ:マップ | DeadLetterQueue

必須: いいえ

AWS CloudFormation 互換性:DeadLetterConfigAWS::Lambda::Functionこのプロパティはリソースのプロパティに似ています。in AWS CloudFormation の型はから派生しますがTargetArn、 AWS SAM の型はと一緒に型を渡さなければなりませんTargetArn。

DeploymentPreference

段階的な Lambda デプロイを有効にする設定です。

DeploymentPreference AWS SAM オブジェクトを指定すると、AWS::CodeDeploy::Application呼び出し側 ServerlessDeploymentApplication (スタックごとに 1 つ)、呼び出し側<function-logical-id>DeploymentGroup、AWS::CodeDeploy::DeploymentGroupAWS::IAM::Roleおよび呼び出し側を作成しますCodeDeployServiceRole。

タイプ:DeploymentPreference

必須: いいえ

AWS CloudFormation 互換性: AWS SAM このプロパティは固有のもので、 AWS CloudFormation 同等のものはありません。

その他の参照資料: このプロパティの詳細については、「サーバーレスアプリケーションの段階的なデプロイ」を参照してください。

Description

関数の説明です。

型: 文字列

必須: いいえ

AWS CloudFormation 互換性:DescriptionAWS::Lambda::Functionこのプロパティはリソースのプロパティに直接渡されます。

Environment

ランタイム環境の設定です。

タイプ: Environment

必須: いいえ

AWS CloudFormation 互換性:EnvironmentAWS::Lambda::Functionこのプロパティはリソースのプロパティに直接渡されます。

EphemeralStorage

/tmp の Lambda 関数で使用可能なディスク容量を MB 単位で指定するオブジェクト。

このプロパティの詳細については、「AWS Lambda デベロッパーガイド」の「Lambda 実行環境」を参照してください。

タイプ:EphemeralStorage

必須: いいえ

AWS CloudFormation 互換性:EphemeralStorageAWS::Lambda::Functionこのプロパティはリソースのプロパティに直接渡されます。

EventInvokeConfig

Lambda 関数でのイベントの呼び出し設定を説明するオブジェクトです。

タイプ:EventInvokeConfiguration

必須: いいえ

AWS CloudFormation 互換性: AWS SAM このプロパティは固有のもので、 AWS CloudFormation 同等のものはありません。

Events

この関数をトリガーするイベントを指定します。イベントは、1 つのタイプと、そのタイプに依存する一連のプロパティで構成されます。

タイプ:EventSource

必須: いいえ

AWS CloudFormation 互換性: AWS SAM このプロパティは固有のもので、 AWS CloudFormation 同等のものはありません。

FileSystemConfigs

Amazon Elastic ファイルシステム (Amazon EFS) FileSystemConfigファイルシステムの接続設定を指定するオブジェクトのリスト。

テンプレートに AWS::EFS::MountTarget リソースが含まれている場合は、DependsOn リソース属性を指定して、関数の前にマウントターゲットが作成または更新されることを確実にする必要があります。

タイプ: リスト

必須: いいえ

AWS CloudFormation 互換性:FileSystemConfigsAWS::Lambda::Functionこのプロパティはリソースのプロパティに直接渡されます。

FunctionName

関数の名前です。名前を指定しない場合は、一意の名前が生成されます。

型: 文字列

必須: いいえ

AWS CloudFormation 互換性:FunctionNameAWS::Lambda::Functionこのプロパティはリソースのプロパティに直接渡されます。

FunctionUrlConfig

関数 URL を記述するオブジェクトです。関数 URL は、関数を呼び出すために使用する HTTPS エンドポイントです。

詳細については、「AWS Lambda デベロッパーガイド」の「関数スケーリング」を参照してください。

タイプ:FunctionUrlConfig

必須: いいえ

AWS CloudFormation 互換性: AWS SAM このプロパティは固有のもので、 AWS CloudFormation 同等のものはありません。

Handler

実行を開始するために呼び出されるコード内の関数です。このプロパティが必要になるのは、PackageType プロパティが Zip に設定されている場合のみです。

型: 文字列

必須: 条件に応じて異なります

AWS CloudFormation 互換性:HandlerAWS::Lambda::Functionこのプロパティはリソースのプロパティに直接渡されます。

ImageConfig

Lambda のコンテナイメージ設定に使用されるオブジェクトです。詳細については、AWS Lambda デベロッパーガイドの「Lambda でのコンテナイメージの使用」を参照してください。

タイプ:ImageConfig

必須: いいえ

AWS CloudFormation 互換性:ImageConfigAWS::Lambda::Functionこのプロパティはリソースのプロパティに直接渡されます。

ImageUri

Lambda 関数のコンテナイメージ用の Amazon Elastic Container Registry (Amazon ECR) リポジトリの URI です。このプロパティは、PackageType プロパティが Image に設定されている場合にのみ適用され、それ以外の場合は無視されます。詳細については、AWS Lambda デベロッパーガイドの「Lambda でのコンテナイメージの使用」を参照してください。

注記

PackageTypeImageプロパティがに設定されている場合は必須かImageUri、Metadata AWS SAM テンプレートファイルに必要なエントリを使用してアプリケーションをビルドする必要があります。詳細については、「アプリケーションの構築」を参照してください。

必要な Metadata エントリを使用してアプリケーションを構築することは、ImageUri よりも優先されるので、両方を指定すれば ImageUri は無視されます。

型: 文字列

必須: いいえ

AWS CloudFormation 互換性:ImageUriAWS::Lambda::FunctionCodeこのプロパティはデータ型のプロパティに直接渡されます。

InlineCode

テンプレートに直接記述された Lambda 関数コードです。このプロパティは、PackageType プロパティが Zip に設定されている場合にのみ適用され、それ以外の場合は無視されます。

注記

PackageType が Zip (デフォルト) に設定されていると、CodeUri または InlineCode のいずれかが必要になります。

タイプ: 文字列

必須: 条件に応じて異なります

AWS CloudFormation 互換性:ZipFileAWS::Lambda::FunctionCodeこのプロパティはデータ型のプロパティに直接渡されます。

KmsKeyArn

Lambda が関数の環境変数の暗号化と復号化に使用する AWS Key Management Service (AWS KMS) キーの ARN。

タイプ: 文字列

必須: いいえ

AWS CloudFormation 互換性:このプロパティはリソースのプロパティに直接渡されます。KmsKeyArn AWS::Lambda::Function

Layers

この関数が使用する必要がある LayerVersion ARN のリストです。ここで指定されている順序は、Lambda 関数の実行時にそれらがインポートされる順序です。

タイプ: リスト

必須: いいえ

AWS CloudFormation 互換性:LayersAWS::Lambda::Functionこのプロパティはリソースのプロパティに直接渡されます。

LoggingConfig

この関数の Amazon CloudWatch ログ設定です。

タイプ:LoggingConfig

必須: いいえ

AWS CloudFormation 互換性:LoggingConfigAWS::Lambda::Functionこのプロパティはリソースのプロパティに直接渡されます。

MemorySize

関数の各呼び出しに割り当てられるメモリのサイズ (MB) です。

タイプ: 整数

必須: いいえ

AWS CloudFormation 互換性:MemorySizeAWS::Lambda::Functionこのプロパティはリソースのプロパティに直接渡されます。

PackageType

Lambda 関数のデプロイパッケージタイプです。詳細については、AWS Lambda デベロッパーガイドの「Lambda デプロイパッケージ」を参照してください。

注意:

1. このプロパティが Zip (デフォルト) に設定されている場合は、CodeUri または InlineCode が適用され、ImageUri は無視されます。

2. このプロパティが Image に設定されている場合は、ImageUri のみが適用され、CodeUri とInlineCode は無視されます。関数のコンテナイメージを保存するために必要な Amazon ECR リポジトリは、によってauto 作成できます。 AWS SAMCLI詳細については、「sam deploy」を参照してください。

有効な値: Zip または Image

タイプ：文字列

必須: いいえ

デフォルト: Zip

AWS CloudFormation 互換性:PackageTypeAWS::Lambda::Functionこのプロパティはリソースのプロパティに直接渡されます。

PermissionsBoundary

この関数の実行ロールに使用するアクセス許可境界の ARN です。このプロパティは、ユーザーのためにロールが生成される場合にのみ機能します。

型: 文字列

必須: いいえ

AWS CloudFormation 互換性:PermissionsBoundaryAWS::IAM::Roleこのプロパティはリソースのプロパティに直接渡されます。

Policies

この関数の許可ポリシー。ポリシーは関数のデフォルト AWS Identity and Access Management (IAM) 実行ロールに追加されます。

このプロパティは、単一の値または値のリストを受け入れます。使用できる値は次のとおりです。

• AWS SAMポリシーテンプレート.

• AWS  管理ポリシーまたはカスタマー管理ポリシーの ARN。

• AWS 以下のリストにある管理ポリシーの名前。

• マップとして YAML でフォーマットされたインライン IAM ポリシー。

注記

Role プロパティを設定する場合、このプロパティは無視されます。

タイプ: 文字列 | リスト | マップ

必須: いいえ

AWS CloudFormation 互換性:PoliciesAWS::IAM::Roleこのプロパティはリソースのプロパティに似ています。

PropagateTags

AWS::Serverless::Function が生成したリソースに Tags プロパティからのタグを渡すかどうかを指定します。True を指定して、生成されたリソースにタグを伝播します。

タイプ: ブール

必須: いいえ

デフォルト: False

AWS CloudFormation 互換性: AWS SAM このプロパティは固有のもので、 AWS CloudFormation 同等のプロパティはありません。

ProvisionedConcurrencyConfig

関数のエイリアスのプロビジョニングされた同時実行設定です。

注記

ProvisionedConcurrencyConfig を指定できるのは、AutoPublishAlias が設定されている場合のみです。それ以外の場合は、エラーが発生します。

タイプ:ProvisionedConcurrencyConfig

必須: いいえ

AWS CloudFormation 互換性:ProvisionedConcurrencyConfigAWS::Lambda::Aliasこのプロパティはリソースのプロパティに直接渡されます。

ReservedConcurrentExecutions

関数用に予約する同時実行の最大数です。

このプロパティの詳細については、AWS Lambda デベロッパーガイドの「Lambda 関数スケーリング」を参照してください。

タイプ: 整数

必須: いいえ

AWS CloudFormation 互換性:ReservedConcurrentExecutionsAWS::Lambda::Functionこのプロパティはリソースのプロパティに直接渡されます。

Role

この関数の実行ロールとして使用する IAM ロールの ARN です。

型: 文字列

必須: いいえ

AWS CloudFormation 互換性:RoleAWS::Lambda::Functionこのプロパティはリソースのプロパティに似ています。 AWS CloudFormation これはでは必須ですが、では必須ではありません AWS SAM。ロールが指定されていない場合は、<function-logical-id>Role の論理 ID を持つロールが作成されます。

RolePath

関数の IAM 実行ロールへのパス。

このプロパティは、ユーザーのためにロールが生成される場合にのみ機能します。Role プロパティでロールが指定されている場合は使用しないでください。

タイプ: 文字列

必須: 条件に応じて異なります

AWS CloudFormation 互換性:PathAWS::IAM::Roleこのプロパティはリソースのプロパティに直接渡されます。

Runtime

関数のランタイムの識別子です。このプロパティが必要になるのは、PackageType プロパティが Zip に設定されている場合のみです。

注記

providedこのプロパティに識別子を指定すると、Metadataリソース属性を使用して、 AWS SAM この関数が必要とするカスタムランタイムのビルドを指示できます。カスタムランタイムの構築の詳細については、「カスタムランタイムの構築」を参照してください。

型: 文字列

必須: 条件に応じて異なります

AWS CloudFormation 互換性:RuntimeAWS::Lambda::Functionこのプロパティはリソースのプロパティに直接渡されます。

RuntimeManagementConfig

ランタイム環境の更新、ロールバック動作、特定のランタイムバージョンの選択など、Lambda 関数のランタイム管理オプションを設定します。詳細については、「AWS Lambda デベロッパーガイド」の「Lambda ランタイム更新」を参照してください。

タイプ:RuntimeManagementConfig

必須: いいえ

AWS CloudFormation 互換性: RuntimeManagementConfigAWS::Lambda::Functionこのプロパティはリソースのプロパティに直接渡されます。

SnapStart

新しい Lambda 関数バージョンのスナップショットを作成します。スナップショットは、すべての依存関係を含む、初期化された関数のキャッシュされた状態です。関数は一度だけ初期化され、キャッシュされた状態は将来の すべての呼び出しで再利用されるため、関数の初期化が必要な回数が減ることでアプリケーションのパフォーマンスが向上します。詳細については、『AWS Lambda 開発者ガイド』の「Lambda SnapStart による起動時のパフォーマンスの向上」を参照してください。

タイプ:SnapStart

必須: いいえ

AWS CloudFormation 互換性:SnapStartAWS::Lambda::Functionこのプロパティはリソースのプロパティに直接渡されます。

Tags

この関数に追加されるタグを指定するマップ (文字列対文字列) です。タグの有効なキーと値の詳細については、「AWS Lambda デベロッパーガイド」の「タグのキーと値の要件」を参照してください。

スタックが作成されると、この Lambda 関数と、 AWS SAM lambda:createdBy:SAMこの関数用に生成されるデフォルトロールにタグが自動的に追加されます。

タイプ: マップ

必須: いいえ

AWS CloudFormation 互換性:Tagsこのプロパティはリソースのプロパティに似ています。AWS::Lambda::FunctionTags AWS SAM のプロパティはキーと値のペアで構成されます (これに対し、 AWS CloudFormation Tagこのプロパティはオブジェクトのリストで構成されます)。また、この Lambda 関数と、 AWS SAM lambda:createdBy:SAMこの関数用に生成されるデフォルトロールにタグが自動的に追加されます。

Timeout

関数が停止されるまでの最大実行時間 (秒) です。

タイプ: 整数

必須: いいえ

デフォルト: 3

AWS CloudFormation 互換性:Timeoutこのプロパティはリソースのプロパティに直接渡されます。AWS::Lambda::Function

Tracing

関数の X-Ray トレーシングモードを指定する文字列です。

• Active – 関数の X-Ray トレーシングを有効にします。

• Disabled – 関数の X-Ray を無効にします。

• PassThrough – 関数の X-Ray トレーシングを有効にします。サンプリングデシジョンはダウンストリームサービスに委任されます。

Active または PassThrough が指定されており、Role プロパティが設定されていない場合、 AWS SAM は、ユーザー用に作成する Lambda 実行ロールに arn:aws:iam::aws:policy/AWSXrayWriteOnlyAccess ポリシーを追加します。

X-Ray の詳細については、『AWS Lambda 開発者ガイド』 AWS X-Rayの「AWS Lambda with の使用」を参照してください。

有効な値: [Active|Disabled|PassThrough]

タイプ: 文字列

必須: いいえ

AWS CloudFormation 互換性:TracingConfigAWS::Lambda::Functionこのプロパティはリソースのプロパティに似ています。

VersionDescription

新しい Lambda バージョンリソースに追加される Description フィールドを指定します。

型: 文字列

必須: いいえ

AWS CloudFormation 互換性:DescriptionAWS::Lambda::Versionこのプロパティはリソースのプロパティに直接渡されます。

VpcConfig

この関数が Virtual Private Cloud (VPC) 内のプライベートリソースにアクセスすることを可能にする設定です。

タイプ:VpcConfig

必須: いいえ

AWS CloudFormation 互換性:VpcConfigAWS::Lambda::Functionこのプロパティはリソースのプロパティに直接渡されます。

戻り値

参照番号

このリソースの論理 ID が Ref 組み込み関数に提供されると、基盤となる Lambda 関数のリソース名が返されます。

Ref 関数の使用方法の詳細については、「AWS CloudFormation ユーザーガイド」の「Ref」を参照してください。

Fn:: GetAtt

Fn::GetAtt は、このタイプの指定された属性の値を返します。利用可能な属性とサンプル戻り値は以下のとおりです。

Fn::GetAtt の使用の詳細については、「AWS CloudFormation ユーザーガイド」の「Fn::GetAtt」を参照してください。

Arn

基盤となる Lambda 関数の ARN です。

例

シンプルな関数

以下は、AWS::Serverless::Function パッケージタイプ (デフォルト) の Zip リソースと、Amazon S3 バケット内にある関数コードの基本的な例です。

YAML

Type: AWS::Serverless::Function
Properties:
  Handler: index.handler
  Runtime: python3.9
  CodeUri: s3://bucket-name/key-name

関数プロパティの例

以下は、InlineCode、Layers、Tracing、Policies、Amazon EFS、および Api イベントソースを使用する、AWS::Serverless::Function パッケージタイプ (デフォルト) の Zip の例です。

YAML

Type: AWS::Serverless::Function
DependsOn: MyMountTarget        # This is needed if an AWS::EFS::MountTarget resource is declared for EFS
Properties:
  Handler: index.handler
  Runtime: python3.9
  InlineCode: |
    def handler(event, context):
      print("Hello, world!")
  ReservedConcurrentExecutions: 30
  Layers:
    - Ref: MyLayer
  Tracing: Active
  Timeout: 120
  FileSystemConfigs:
    - Arn: !Ref MyEfsFileSystem
      LocalMountPath: /mnt/EFS
  Policies:
    - AWSLambdaExecute
    - Version: '2012-10-17' 
      Statement:
        - Effect: Allow
          Action:
            - s3:GetObject
            - s3:GetObjectACL
          Resource: 'arn:aws:s3:::my-bucket/*'
  Events:
    ApiEvent:
      Type: Api
      Properties:
        Path: /path
        Method: get

ImageConfig例:

以下は、Image パッケージタイプの Lambda 関数向けの ImageConfig の例です。

YAML

HelloWorldFunction:
  Type: AWS::Serverless::Function
  Properties:
    PackageType: Image
    ImageUri: account-id.dkr.ecr.region.amazonaws.com/ecr-repo-name:image-name
    ImageConfig:
      Command:
        - "app.lambda_handler"
      EntryPoint:
        - "entrypoint1"
      WorkingDirectory: "workDir"

RuntimeManagementConfig 例

現在の動作に従ってランタイム環境を更新するように設定された Lambda 関数:

TestFunction
  Type: AWS::Serverless::Function
  Properties:
    ...
    Runtime: python3.9
    RuntimeManagementConfig:
      UpdateRuntimeOn: Auto

関数が更新されたときにランタイム環境を更新するように設定された Lambda 関数:

TestFunction
  Type: AWS::Serverless::Function
  Properties:
    ...
    Runtime: python3.9
    RuntimeManagementConfig:
      UpdateRuntimeOn: FunctionUpdate

ランタイム環境を手動で更新するように構成された Lambda 関数:

TestFunction
  Type: AWS::Serverless::Function
  Properties:
    ...
    Runtime: python3.9
    RuntimeManagementConfig:
      RuntimeVersionArn: arn:aws:lambda:us-east-1::runtime:4c459dd0104ee29ec65dcad056c0b3ddbe20d6db76b265ade7eda9a066859b1e
      UpdateRuntimeOn: Manual

SnapStart例

future SnapStart バージョンで有効になっている Lambda 関数の例:

TestFunc
  Type: AWS::Serverless::Function
  Properties:
    ...
    SnapStart:
      ApplyOn: PublishedVersions