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 SAM 리소스를 CloudFormation 리소스로 변환됩니다. 자세한 내용은 AWS SAM용으로 생성된 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을 제공하는 경우, 템플릿 URL은 클라우드포메이션 템플릿URL 설명서에 지정된 형식을 따라야 하며 유효한 클라우드포메이션또는 SAM 템플릿을 포함해야 합니다. ApplicationLocationObject는 AWS Serverless Application Repository에 게시된 애플리케이션을 지정하는 데 사용할 수 있습니다.

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

유형: 문자열 | ApplicationLocationObject

필수 항목 여부: 예

CloudFormation호환성: 이 속성은 AWS::CloudFormation::Stack 리소스의 TemplateURL 속성과 유사합니다. CloudFormation 버전에서는 AWS Serverless Application Repository에서 애플리케이션을 인출하는 데 ApplicationLocationObject가 필요하지 않습니다.

NotificationARNs

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

유형: 목록

필수 항목 여부: 아니요

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

Parameters

애플리케이션 파라미터 값

유형: 맵

필수 항목 여부: 아니요

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

Tags

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

유형: 맵

필수 항목 여부: 아니요

CloudFormation호환성: 이 속성은 AWS::CloudFormation::Stack 리소스의 Tags 속성과 유사합니다. SAM의 태그 속성은 키:값의 쌍으로 구성되고, CloudFormation에서는 태그 객체 목록으로 구성됩니다. 스택이 생성되면 SAM은 이 애플리케이션에 lambda:createdBy:SAM 태그를 자동으로 추가합니다. 또한 이 애플리케이션이 AWS Serverless Application Repository의 애플리케이션인 경우 SAM은 두 개의 추가 serverlessrepo:applicationId:ApplicationId 및 serverlessrepo:semanticVersion:SemanticVersion태그도 자동으로 추가합니다.

TimeoutInMinutes

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

유형: 정수

필수 항목 여부: 아니요

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

반환 값

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/sam-s3-demo-bucket/template.yaml