AWS::Serverless::Application - AWS Serverless Application Model

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

AWS::Serverless::Application

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

注記

にデプロイすると AWS CloudFormation、 は AWS SAM リソースを AWS CloudFormation リソース AWS SAM に変換します。詳細については、「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プロパティに似ています。の Tags プロパティ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 待機する分単位の時間。デフォルトではタイムアウトが設定されていません。がネストされたスタックが 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/amzn-s3-demo-bucket/template.yaml