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 템플릿을 포함해야 합니다. ApplicationLocationObject는 AWS Serverless Application Repository에 게시된 애플리케이션을 지정하는 데 사용할 수 있습니다.

로컬 파일 경로를 제공하는 경우, 애플리케이션이 제대로 변환되려면 템플릿이 sam deploy 또는 sam package 명령을 포함하는 워크플로를 거쳐야 합니다.

유형: 문자열 | ApplicationLocationObject

필수 항목 여부: 예

AWS CloudFormation 호환성: 이 속성은 AWS::CloudFormation::Stack 리소스의 TemplateURL 속성과 유사합니다. 이 CloudFormation 버전에서는 에서 응용 프로그램을 검색하는 ApplicationLocationObject 데 a가 필요하지 않습니다 AWS Serverless Application Repository.

NotificationARNs

스택 이벤트에 대한 알림을 전송하는 기존의 Amazon SNS 주제 목록.

유형: 목록

필수 항목 여부: 아니요

AWS CloudFormation 호환성: 이 속성은 AWS::CloudFormation::Stack 리소스의 NotificationARNs 속성으로 직접 전달됩니다.

Parameters

애플리케이션 파라미터 값

유형: 맵

필수 항목 여부: 아니요

AWS CloudFormation 호환성: 이 속성은 AWS::CloudFormation::Stack 리소스의 Parameters 속성에 직접 전달됩니다.

Tags

이 응용 프로그램에 추가할 태그를 지정하는 맵(문자열 간)입니다. 키와 값에는 영숫자 문자만 사용할 수 있습니다. 키는 길이가 1~127자(유니코드 문자)이며 “aws:”로 시작할 수 없습니다. 값은 길이가 1~255자인 유니코드 문자입니다.

유형: 맵

필수 항목 여부: 아니요

AWS CloudFormation 호환성: 이 속성은 AWS::CloudFormation::Stack 리소스의 Tags 속성과 유사합니다. SAM의 Tags 속성은 Key:Value 쌍으로 구성되며, 두 쌍은 Tag 객체 목록으로 구성됩니다. CloudFormation 스택이 생성되면 SAM은 이 애플리케이션에 lambda:createdBy:SAM 태그를 자동으로 추가합니다. 또한 이 응용 프로그램이 에서 가져온 응용 AWS Serverless Application Repository프로그램인 경우 SAM은 두 개의 추가 태그와 serverlessrepo:applicationId:ApplicationId 도 자동으로 지정합니다. serverlessrepo:semanticVersion:SemanticVersion

TimeoutInMinutes

중첩된 스택이 상태에 도달할 AWS CloudFormation 때까지 기다리는 시간 (분) 입니다. CREATE_COMPLETE 기본값은 제한 시간 없음입니다. 중첩된 스택이 CREATE_COMPLETE 상태에 도달한 것이 AWS CloudFormation 감지되면 중첩된 스택 리소스를 상위 CREATE_COMPLETE 스택에 있는 것으로 표시하고 상위 스택 생성을 재개합니다. 중첩 스택에 CREATE_COMPLETE 도달하기 전에 제한 시간이 만료되면 중첩 스택을 실패로 AWS CloudFormation 표시하고 중첩 스택과 상위 스택을 모두 롤백합니다.

유형: 정수

필수 항목 여부: 아니요

AWS CloudFormation 호환성: 이 속성은 리소스의 속성에 직접 전달됩니다. TimeoutInMinutes AWS::CloudFormation::Stack

반환 값

Ref

Ref 내장 함수에 이 리소스의 논리적 ID를 제공하면 기저의 AWS::CloudFormation::Stack 리소스의 리소스 이름을 반환합니다.

Ref 함수의 사용에 대한 자세한 내용은 AWS CloudFormation 사용자 가이드의 Ref 섹션을 참조하세요.

Fn: GetAtt

Fn::GetAtt은 이 유형의 지정된 속성에 대한 값을 반환합니다. 다음은 사용 가능한 속성과 반환되는 샘플 값.

Fn::GetAtt의 사용에 대한 자세한 내용은 AWS CloudFormation 사용자 가이드의 Fn::GetAtt 섹션을 참조하세요.

Outputs.ApplicationOutputName

ApplicationOutputName라는 이름의 스택 출력 결과의 값.

예

SAR 애플리케이션

서버리스 애플리케이션 리포지토리의 템플릿을 사용하는 애플리케이션

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