AWS::Serverless::Application

AWS Serverless Application Repository または Amazon S3 バケットからネストされたアプリケーションとしてサーバーレスアプリケーションを埋め込みます。ネストされたアプリケーションは、ネストされた AWS::CloudFormation::Stack リソースとしてデプロイされます。このリソースには、他の AWS::Serverless::Application リソースを含む複数の他のリソースを含めることができます。

構文

このエンティティを AWS サーバーレスアプリケーションモデル (AWS SAM) テンプレートの場合は、次の構文を使用します。

YAML

Type: AWS::Serverless::Application
Properties:
  Location: String | ApplicationLocationObject
  NotificationARNs: List
  Parameters: Map
  Tags: Map
  TimeoutInMinutes: Integer

プロパティ

Location

ネストされたアプリケーションのテンプレート URL、ファイルパス、またはロケーションオブジェクト。

テンプレート URL を提供する場合は、 CloudFormation TemplateUrl 文書 有効な CloudFormation またはSAMテンプレート。ApplicationLocationObject を使用して、AWS Serverless Application Repository に発行されたアプリケーションを指定できます。

ローカルファイルパスが指定されている場合、アプリケーションを正しく変換するには、テンプレートが sam deploy または sam package コマンドを含むワークフローを実行する必要があります。

タイプ: 文字列 | ApplicationLocationObject

必須: はい

AWS CloudFormation 互換性: このプロパティは、 TemplateURL プロパティ AWS::CloudFormation::Stack リソース。[ CloudFormation バージョンは ApplicationLocationObject からアプリケーションを取得できます。 AWS Serverless Application Repository.

NotificationARNs

スタックイベントに関する通知が送信される既存の Amazon SNS トピックのリスト。

タイプ: List

必須: いいえ

AWS CloudFormation 互換性: このプロパティは NotificationARNs プロパティ AWS::CloudFormation::Stack リソース。

Parameters

アプリケーションパラメータ値。

タイプ: マップ

必須: いいえ

AWS CloudFormation 互換性: このプロパティは Parameters プロパティ AWS::CloudFormation::Stack リソース。

Tags

このアプリケーションに追加するタグを指定するマップ (文字列から文字列)。キーと値に使用できるのは英数字のみです。キーの長さは 1～127 文字の Unicode 文字です。「aws:」をプレフィックスとして使用することはできません。値の長さは 1～255 文字の Unicode 文字です。

タイプ: マップ

必須: いいえ

AWS CloudFormation 互換性: このプロパティは、 Tags プロパティ AWS::CloudFormation::Stack リソース。SAMのタグプロパティは、Key:Valueペアで構成されます。 CloudFormation タグオブジェクトのリストで構成されます。スタックが作成されると、SAM は自動的にこのアプリケーションに lambda:createdBy:SAM タグを追加します。さらに、このアプリケーションが AWS Serverless Application Repository からのものである場合、SAM はまた、自動的に 2 つの追加のタグ serverlessrepo:applicationId:ApplicationId と serverlessrepo:semanticVersion:SemanticVersion を追加します。

TimeoutInMinutes

ネストされたスタックが CREATE_COMPLETE の状態になるのを AWS CloudFormation が待機する時間 (分)。デフォルトではタイムアウトが設定されていません。AWSが CloudFormation ネストされたスタックが CREATE_COMPLETE ネストされたスタック リソースを次のようにマークします。 CREATE_COMPLETE 親スタックで と が、親スタックの作成を再開します。ネストされたスタックが CREATE_COMPLETE の状態に至る前にタイムアウト期間が経過すると、AWS CloudFormation は、ネストされたスタックは失敗としてマークし、ネストされたスタックと親スタックの両方がロールバックされます。

タイプ: 整数

必須: いいえ

AWS CloudFormation 互換性: このプロパティは TimeoutInMinutes プロパティ AWS::CloudFormation::Stack リソース。

戻り値

Ref

このリソースの論理IDが Ref 基礎関数のリソース名を返します。 AWS::CloudFormation::Stack リソース。

[ Ref 関数、「」を参照カンスウ Ref を AWS CloudFormation ユーザーガイド.

Fn::GetAtt

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

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

Outputs.ApplicationOutputName

名前付きのスタック出力の値 ApplicationOutputName。

例

SAR アプリケーション

Serverless Application Repository のテンプレートを使用するアプリケーション

YAML

Type: AWS::Serverless::Application
Properties:
  Location:
    ApplicationId: 'arn:aws:serverlessrepo:us-east-1:012345678901:applications/my-application'
    SemanticVersion: 1.0.0
  Parameters:
    StringParameter: parameter-value
    IntegerParameter: 2

Normal-Application

S3 URL からのアプリケーション

YAML

Type: AWS::Serverless::Application
Properties:
  Location: https://s3.amazonaws.com/demo-bucket/template.yaml