翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
AWS::Serverless::Application
AWS Serverless Application Repository
注記
にデプロイすると 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
プロパティに直接渡されます。 -
このアプリケーションに追加されるタグを指定するマップ (文字列対文字列) です。キーと値に使用できるのは英数字のみです。キーの長さは 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