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

# AWS::Serverless::Application
<a name="sam-resource-application"></a>

[AWS Serverless Application Repository](https://serverlessrepo.aws.amazon.com/applications)로부터, 또는 Amazon S3 버킷으로부터 서버리스 애플리케이션을 중첩 애플리케이션으로 내장합니다. 중첩된 애플리케이션은 중첩된 리소스로 배포되며, 중첩된 [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-stack.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-cloudformation-stack.html)리소스에는 다른 리소스를 비롯한 다른 [AWS::Serverless::Application](#sam-resource-application)리소스가 포함될 수 있습니다. 

**참고**  
에 배포하면가 AWS SAM 리소스를 CloudFormation 리소스로 AWS CloudFormation AWS SAM 변환합니다. 자세한 내용은 [에 대해 생성된 CloudFormation 리소스 AWS SAM](sam-specification-generated-resources.md) 단원을 참조하십시오.

## 구문
<a name="sam-resource-application-syntax"></a>

 AWS Serverless Application Model (AWS SAM) 템플릿에서이 개체를 선언하려면 다음 구문을 사용합니다.

### YAML
<a name="sam-resource-application-syntax.yaml"></a>

```
Type: AWS::Serverless::Application
Properties:
  [Location](#sam-application-location): String | ApplicationLocationObject
  [NotificationARNs](#sam-application-notificationarns): List
  [Parameters](#sam-application-parameters): Map
  [Tags](#sam-application-tags): Map
  [TimeoutInMinutes](#sam-application-timeoutinminutes): Integer
```

## 속성
<a name="sam-resource-application-properties"></a>

 `Location`   <a name="sam-application-location"></a>
중첩된 애플리케이션의 템플릿 URL, 파일 경로 또는 위치 개체.  
템플릿 URL을 제공하는 경우, 템플릿 URL은 [클라우드포메이션 템플릿URL 설명서](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-templateurl)에 지정된 형식을 따라야 하며 유효한 클라우드포메이션또는 SAM 템플릿을 포함해야 합니다. [ApplicationLocationObject](sam-property-application-applicationlocationobject.md)는 [AWS Serverless Application Repository](https://docs.aws.amazon.com/serverlessrepo/latest/devguide/what-is-serverlessrepo.html)에 게시된 애플리케이션을 지정하는 데 사용할 수 있습니다.  
로컬 파일 경로를 제공하는 경우, 애플리케이션이 제대로 변환되려면 템플릿이 `sam deploy` 또는 `sam package` 명령을 포함하는 워크플로를 거쳐야 합니다.  
*유형*: 문자열 \$1 [ApplicationLocationObject](sam-property-application-applicationlocationobject.md)  
*필수 항목 여부:* 예  
*CloudFormation 호환성*:이 속성은 `AWS::CloudFormation::Stack` 리소스의 `[TemplateURL](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-templateurl)` 속성과 유사합니다. CloudFormation 버전에서는 AWS Serverless Application Repository에서 애플리케이션을 인출하는 데 [ApplicationLocationObject](sam-property-application-applicationlocationobject.md)가 필요하지 않습니다.

 `NotificationARNs`   <a name="sam-application-notificationarns"></a>
스택 이벤트에 대한 알림을 전송하는 기존의 Amazon SNS 주제 목록.  
*유형*: 목록  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::CloudFormation::Stack` 리소스의 `[NotificationARNs](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-notificationarns)` 속성으로 직접 전달됩니다.

 `Parameters`   <a name="sam-application-parameters"></a>
애플리케이션 파라미터 값  
*유형*: 맵  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::CloudFormation::Stack` 리소스의 `[Parameters](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-parameters)` 속성으로 직접 전달됩니다.

 `Tags`   <a name="sam-application-tags"></a>
이 응용 프로그램에 추가할 태그를 지정하는 맵(문자열 간)입니다. 키와 값에는 영숫자 문자만 사용할 수 있습니다. 키는 길이가 1\$1127자(유니코드 문자)이며 “aws:”로 시작할 수 없습니다. 값은 길이가 1\$1255자인 유니코드 문자입니다.  
*유형*: 맵  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::CloudFormation::Stack` 리소스의 `[Tags](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-tags)` 속성과 유사합니다. SAM의 태그 속성은 키:값의 쌍으로 구성되고, CloudFormation에서는 태그 객체 목록으로 구성됩니다. 스택이 생성되면 SAM은 이 애플리케이션에 `lambda:createdBy:SAM` 태그를 자동으로 추가합니다. 또한이 애플리케이션이에서 가져온 경우 AWS Serverless Application Repository SAM은 두 개의 추가 태그 `serverlessrepo:applicationId:ApplicationId` 및 도 자동으로 생성합니다`serverlessrepo:semanticVersion:SemanticVersion`.

 `TimeoutInMinutes`   <a name="sam-application-timeoutinminutes"></a>
중첩 스택이 `CREATE_COMPLETE` 상태에 도달할 CloudFormation 때까지 기다리는 분 단위의 시간 길이입니다. 기본값은 제한 시간 없음입니다. 가 중첩 스택이 `CREATE_COMPLETE` 상태에 도달했음을 CloudFormation 감지하면 중첩 스택 리소스를 상위 스택`CREATE_COMPLETE`에 로 표시하고 상위 스택 생성을 재개합니다. 중첩 스택이에 도달하기 전에 제한 시간이 만료되면는 중첩 스택을 실패로 `CREATE_COMPLETE` CloudFormation 표시하고 중첩 스택과 상위 스택을 모두 롤백합니다.  
*유형*: 정수  
*필수 항목 여부*: 아니요  
*CloudFormation 호환성*:이 속성은 `AWS::CloudFormation::Stack` 리소스의 `[TimeoutInMinutes](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html#cfn-cloudformation-stack-timeoutinminutes)` 속성으로 직접 전달됩니다.

## 반환 값
<a name="sam-resource-application-return-values"></a>

### Ref
<a name="sam-resource-application-return-values-ref"></a>

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

`Ref` 함수의 사용에 대한 자세한 내용은 *AWS CloudFormation 사용자 가이드*의 [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-ref.html) 섹션을 참조하세요.

### Fn::GetAtt
<a name="sam-resource-application-return-values-fn--getatt"></a>

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

`Fn::GetAtt`의 사용에 대한 자세한 내용은 *AWS CloudFormation 사용자 가이드*의 [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/intrinsic-function-reference-getatt.html) 섹션을 참조하세요.

`Outputs.ApplicationOutputName`  <a name="Outputs.ApplicationOutputName-fn::getatt"></a>
`ApplicationOutputName`라는 이름의 스택 출력 결과의 값.

## 예제
<a name="sam-resource-application--examples"></a>

### SAR 애플리케이션
<a name="sam-resource-application--examples--sar-application"></a>

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

#### YAML
<a name="sam-resource-application--examples--sar-application--yaml"></a>

```
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
```

### 정상-애플리케이션
<a name="sam-resource-application--examples--normal-application"></a>

S3 URL을 통한 애플리케이션

#### YAML
<a name="sam-resource-application--examples--normal-application--yaml"></a>

```
Type: AWS::Serverless::Application
Properties:
  Location: https://s3.amazonaws.com/sam-s3-demo-bucket/template.yaml
```

# ApplicationLocationObject
<a name="sam-property-application-applicationlocationobject"></a>

[AWS Serverless Application Repository](https://docs.aws.amazon.com/serverlessrepo/latest/devguide/what-is-serverlessrepo.html)에 게시된 애플리케이션.

## 구문
<a name="sam-property-application-applicationlocationobject-syntax"></a>

 AWS Serverless Application Model (AWS SAM) 템플릿에서이 개체를 선언하려면 다음 구문을 사용합니다.

### YAML
<a name="sam-property-application-applicationlocationobject-syntax.yaml"></a>

```
  [ApplicationId](#sam-application-applicationlocationobject-applicationid): String
  [SemanticVersion](#sam-application-applicationlocationobject-semanticversion): String
```

## 속성
<a name="sam-property-application-applicationlocationobject-properties"></a>

 `ApplicationId`   <a name="sam-application-applicationlocationobject-applicationid"></a>
애플리케이션의 Amazon 리소스 이름(ARN)입니다.  
*유형*: 문자열  
*필수 항목 여부:* 예  
*CloudFormation 호환성*:이 속성은에 고유 AWS SAM 하며 CloudFormation 동등한 속성이 없습니다.

 `SemanticVersion`   <a name="sam-application-applicationlocationobject-semanticversion"></a>
애플리케이션의 의미 체계 버전입니다.  
*유형*: 문자열  
*필수 항목 여부:* 예  
*CloudFormation 호환성*:이 속성은에 고유 AWS SAM 하며 CloudFormation 동등한 속성이 없습니다.

## 예제
<a name="sam-property-application-applicationlocationobject--examples"></a>

### 애플리케이션
<a name="sam-property-application-applicationlocationobject--examples--my-application"></a>

예제 애플리케이션 위치 객체

#### YAML
<a name="sam-property-application-applicationlocationobject--examples--my-application--yaml"></a>

```
Location:
  ApplicationId: 'arn:aws:serverlessrepo:us-east-1:012345678901:applications/my-application'
  SemanticVersion: 1.0.0
```