AWS::Serverless::Application

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

注記

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

構文

AWS Serverless Application Model （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 テンプレートが含まれている必要があります。AWS Serverless Application Repository に公開されたアプリケーションを指定するには、ApplicationLocationObject を使用することができます。

ローカルファイルパスを指定する場合は、定義が適切に変換されるようにするために、テンプレートが sam deploy または sam package コマンドを含むワークフローを実行する必要があります。

タイプ： 文字列 | ApplicationLocationObject

必須: はい

AWS CloudFormation 互換性: このプロパティは、 AWS::CloudFormation::Stackリソースの TemplateURLプロパティに似ています。 CloudFormation バージョンでは、 からアプリケーションを取得ApplicationLocationObjectするために を使用しません AWS Serverless Application Repository。

NotificationARNs

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

タイプ: リスト

必須: いいえ

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

Parameters

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

タイプ: マップ

必須: いいえ

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

Tags

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

タイプ: マップ

必須: いいえ

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

TimeoutInMinutes

ネストされたスタックが CREATE_COMPLETE状態になるまで AWS CloudFormation 待機する分単位の時間の長さ。デフォルトではタイムアウトが設定されていません。は、ネストされたスタックが CREATE_COMPLETE状態になったことを AWS CloudFormation 検出し、ネストされたスタックリソースを親スタックCREATE_COMPLETEの としてマークし、親スタックの作成を再開します。ネストされたスタックが に達する前にタイムアウト期間が終了するとCREATE_COMPLETE、 はネストされたスタックを失敗として AWS CloudFormation マークし、ネストされたスタックと親スタックの両方をロールバックします。

タイプ: 整数

必須: いいえ

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

戻り値

参照番号

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

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

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

通常のアプリケーション

S3 url からのアプリケーションです。

YAML

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