AWS::Serverless::Application - AWS Serverless Application Model
구문속성반환 값예시

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

AWS::Serverless::Application

AWS Serverless Application Repository로부터, 또는 Amazon S3 버킷으로부터 서버리스 애플리케이션을 중첩 애플리케이션으로 내장합니다. 중첩된 애플리케이션은 중첩된 상태로 배포됩니다. AWS::CloudFormation::Stack 다른 리소스를 포함한 여러 다른 AWS::Serverless::Application 리소스를 포함할 수 있습니다.

참고

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

로컬 파일 경로를 제공하는 경우, 애플리케이션이 제대로 변환되려면 템플릿이 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자(유니코드 문자)이며 “aws:”로 시작할 수 없습니다. 값은 길이가 1~255자인 유니코드 문자입니다.

유형: 맵

필수 항목 여부: 아니요

AWS 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 상태에 도달할 AWS CloudFormation 때까지 기다리는 분 단위의 시간 길이입니다. 기본값은 제한 시간 없음입니다. 중첩 스택이 CREATE_COMPLETE 상태에 도달한 것을 AWS CloudFormation 감지하면 중첩 스택 리소스를 상위 스택CREATE_COMPLETE에 로 표시하고 상위 스택 생성을 재개합니다. 중첩 스택이 에 도달하기 전에 제한 시간이 만료되면 는 중첩 스택을 실패로 CREATE_COMPLETE AWS CloudFormation 표시하고 중첩 스택과 상위 스택을 모두 롤백합니다.

유형: 정수

필수 항목 여부: 아니요

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