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

# 에 대해 생성된 CloudFormation 리소스 AWS SAM
<a name="sam-specification-generated-resources"></a>

이 섹션에서는가 AWS 템플릿을 AWS SAM 처리할 때 생성되는 CloudFormation 리소스에 대한 세부 정보를 제공합니다. 에서 AWS SAM 생성하는 CloudFormation 리소스 세트는 지정한 시나리오에 따라 다릅니다. *시나리오*는 템플릿 파일에 지정된 AWS SAM 리소스와 속성의 조합입니다. 템플릿 파일에서 명시적으로 선언한 CloudFormation 리소스를 참조하는 것과 마찬가지로 템플릿 파일 내 다른 곳에서 생성된 리소스를 참조할 수 있습니다.

예를 들어 `AWS::Serverless::Function` 템플릿 파일에 AWS SAM 리소스를 지정하면 항상 AWS SAM 기본 리소스가 `AWS::Lambda::Function`생성됩니다. 선택적 `AutoPublishAlias` 속성도 지정하면가 `AWS::Lambda::Alias` 및 `AWS::Lambda::Version` 리소스를 AWS SAM 추가로 생성합니다.

이 섹션에서는 시나리오와 시나리오가 생성하는 CloudFormation 리소스를 나열하고 AWS SAM 템플릿 파일에서 생성된 CloudFormation 리소스를 참조하는 방법을 보여줍니다.

## 생성된 CloudFormation 리소스 참조
<a name="sam-specification-generated-resources-referencing"></a>

 AWS SAM 템플릿 파일 내에서 생성된 CloudFormation 리소스를 참조하거나 참조 가능한 속성을 `LogicalId` 기준으로 참조하는 두 가지 옵션이 있습니다.

### LogicalId로 생성된 CloudFormation 리소스 참조
<a name="sam-specification-generated-resources-referencing-logicalid"></a>

가 각각 AWS SAM 생성하는 CloudFormation 리소스에는 템플릿 파일 내에서 고유한 `[LogicalId](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html#resources-section-structure-logicalid)`영숫자(A-Z, a-z, 0-9) 식별자인가 있습니다.는 템플릿 파일에 있는 AWS SAM 리소스`LogicalIds`의를 AWS SAM 사용하여 생성하는 CloudFormation 리소스`LogicalIds`의를 구성합니다. 명시적으로 선언한 CloudFormation 리소스와 마찬가지로 생성된 리소스`LogicalId`의를 사용하여 템플릿 파일 내에서 해당 리소스의 속성에 CloudFormation 액세스할 수 있습니다. CloudFormation 및 AWS SAM 템플릿`LogicalIds`의에 대한 자세한 내용은 *AWS CloudFormation 사용 설명서*의 [리소스를](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html) 참조하세요.

**참고**  
생성된 일부 리소스의 `LogicalIds`에는 네임스페이스 충돌을 방지하기 위한 고유한 해시 값이 포함되어 있습니다. 이러한 리소스의 `LogicalIds`는 스택이 생성될 때 파생됩니다. AWS Management Console AWS CLI또는 AWS SDKs. 해시 값이 변경될 수 있으므로 이러한 `LogicalId` 리소스를 참조하지 않는 것이 좋습니다.

### 참조 가능한 속성으로 생성된 CloudFormation 리소스 참조
<a name="sam-specification-generated-resources-referencing-referenceable-property"></a>

일부 생성된 리소스의 AWS SAM 경우는 리소스의 참조 가능한 속성을 AWS SAM 제공합니다. 이 속성을 사용하여 AWS SAM 템플릿 파일 내에서 생성된 CloudFormation 리소스와 해당 속성을 참조할 수 있습니다.

**참고**  
생성된 모든 CloudFormation 리소스에 참조 가능한 속성이 있는 것은 아닙니다. 이러한 리소스의 경우 `LogicalId`를 사용해야 합니다.

## 생성된 CloudFormation 리소스 시나리오
<a name="sam-specification-generated-resources-scenarios"></a>

다음 표에는 AWS SAM 리소스를 생성하는 시나리오를 구성하는 CloudFormation 리소스와 속성이 요약되어 있습니다. **시나리오** 열의 주제는가 해당 시나리오에 대해 생성하는 AWS SAM 추가 CloudFormation 리소스에 대한 세부 정보를 제공합니다.


| AWS SAM 리소스 | 기본 CloudFormation 리소스 | 시나리오 | 
| --- | --- | --- | 
| AWS::Serverless::Api  | [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-restapi.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-restapi.html) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/serverless-application-model/latest/developerguide/sam-specification-generated-resources.html)  | 
| AWS::Serverless::Application  | [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/serverless-application-model/latest/developerguide/sam-specification-generated-resources.html)  | 
| AWS::Serverless::CapacityProvider  | [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/serverless-application-model/latest/developerguide/sam-specification-generated-resources.html)  | 
| AWS::Serverless::Function | [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/serverless-application-model/latest/developerguide/sam-specification-generated-resources.html)  | 
| AWS::Serverless::HttpApi | [AWS::ApiGatewayV2::Api](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigatewayv2-api.html) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/serverless-application-model/latest/developerguide/sam-specification-generated-resources.html)  | 
| AWS::Serverless::LayerVersion  | [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/serverless-application-model/latest/developerguide/sam-specification-generated-resources.html)  | 
| AWS::Serverless::SimpleTable  | [AWS::DynamoDB::Table](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-table.html) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/serverless-application-model/latest/developerguide/sam-specification-generated-resources.html)  | 
| AWS::Serverless::StateMachine  | [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/serverless-application-model/latest/developerguide/sam-specification-generated-resources.html)  | 

**Topics**
+ [생성된 CloudFormation 리소스 참조](#sam-specification-generated-resources-referencing)
+ [생성된 CloudFormation 리소스 시나리오](#sam-specification-generated-resources-scenarios)
+ [CloudFormation AWS::Serverless::Api가 지정될 때 생성되는 리소스](sam-specification-generated-resources-api.md)
+ [CloudFormation AWS::Serverless::Application가 지정될 때 생성되는 리소스](sam-specification-generated-resources-application.md)
+ [CloudFormation AWS::Serverless::CapacityProvider가 지정될 때 생성되는 리소스](sam-specification-generated-resources-capacityprovider.md)
+ [CloudFormation 지정할 때 생성된 리소스 AWS::Serverless::Connector](sam-specification-generated-resources-connector.md)
+ [CloudFormation AWS::Serverless::Function가 지정될 때 생성되는 리소스](sam-specification-generated-resources-function.md)
+ [CloudFormation AWS::Serverless::GraphQLApi가 지정될 때 생성되는 리소스](sam-specification-generated-resources-graphqlapi.md)
+ [CloudFormation AWS::Serverless::HttpApi가 지정될 때 생성되는 리소스](sam-specification-generated-resources-httpapi.md)
+ [CloudFormation AWS::Serverless::LayerVersion가 지정될 때 생성되는 리소스](sam-specification-generated-resources-layerversion.md)
+ [CloudFormation AWS::Serverless::SimpleTable가 지정될 때 생성되는 리소스](sam-specification-generated-resources-simpletable.md)
+ [CloudFormation AWS::Serverless::StateMachine가 지정될 때 생성되는 리소스](sam-specification-generated-resources-statemachine.md)

# CloudFormation AWS::Serverless::Api가 지정될 때 생성되는 리소스
<a name="sam-specification-generated-resources-api"></a>

`AWS::Serverless::Api`이 지정되면 AWS Serverless Application Model (AWS SAM)는 항상 `AWS::ApiGateway::RestApi` 기본 CloudFormation 리소스를 생성합니다. 또한 항상 `AWS::ApiGateway::Stage` 및 `AWS::ApiGateway::Deployment` 리소스도 생성합니다.

**`AWS::ApiGateway::RestApi`**  
*`LogicalId`: *`<api‑LogicalId>`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

**`AWS::ApiGateway::Stage`**  
*`LogicalId`: *`<api‑LogicalId><stage‑name>Stage`  
`<stage‑name>`은 `StageName` 속성이 설정된 문자열입니다. 예를 들어 `StageName`을 `Gamma`로 설정하면, `LogicalId`은 `MyRestApiGammaStage`가 됩니다.  
*참조 가능한 속성: *`<api‑LogicalId>.Stage`

**`AWS::ApiGateway::Deployment`**  
*`LogicalId`: *`<api‑LogicalId>Deployment<sha>`  
`<sha>`은 스택이 만들어질 때 생성되는 고유한 해시 값입니다. 예를 들어 `MyRestApiDeployment926eeb5ff1`입니다.  
*참조 가능한 속성: *`<api‑LogicalId>.Deployment`

이러한 CloudFormation 리소스 외에도이 지정되면 `AWS::Serverless::Api`는 다음 시나리오에 대한 추가 CloudFormation 리소스를 AWS SAM 생성합니다.

**Topics**
+ [DomainName 속성이 지정되었습니다.](#sam-specification-generated-resources-api-domain-name)
+ [UsagePlan 속성 지정됨](#sam-specification-generated-resources-api-usage-plan)

## DomainName 속성이 지정되었습니다.
<a name="sam-specification-generated-resources-api-domain-name"></a>

의 `DomainName` 속성 `Domain` 속성이 지정되면 `AWS::Serverless::Api`가 `AWS::ApiGateway::DomainName` CloudFormation 리소스를 AWS SAM 생성합니다.

**`AWS::ApiGateway::DomainName`**  
*`LogicalId`: *`ApiGatewayDomainName<sha>`  
`<sha>`은 스택이 만들어질 때 생성되는 고유한 해시 값입니다. 예를 들어 `ApiGatewayDomainName926eeb5ff1`입니다.  
*참조 가능한 속성: *`<api‑LogicalId>.DomainName`

## UsagePlan 속성 지정됨
<a name="sam-specification-generated-resources-api-usage-plan"></a>

의 `UsagePlan` 속성 `Auth` 속성이 지정되면 `AWS::Serverless::Api`는 CloudFormation `AWS::ApiGateway::UsagePlan`, `AWS::ApiGateway::UsagePlanKey`및 리소스를 AWS SAM 생성합니다`AWS::ApiGateway::ApiKey`.

**`AWS::ApiGateway::UsagePlan`**  
*`LogicalId`: *`<api‑LogicalId>UsagePlan`  
*참조 가능한 속성: *`<api‑LogicalId>.UsagePlan`

**`AWS::ApiGateway::UsagePlanKey`**  
*`LogicalId`: *`<api‑LogicalId>UsagePlanKey`  
*참조 가능한 속성: *`<api‑LogicalId>.UsagePlanKey`

**`AWS::ApiGateway::ApiKey`**  
*`LogicalId`: *`<api‑LogicalId>ApiKey`  
*참조 가능한 속성: *`<api‑LogicalId>.ApiKey`

# CloudFormation AWS::Serverless::Application가 지정될 때 생성되는 리소스
<a name="sam-specification-generated-resources-application"></a>

`AWS::Serverless::Application`이 지정 AWS Serverless Application Model 되면 (AWS SAM)가 `AWS::CloudFormation::Stack` 기본 CloudFormation 리소스를 생성합니다.

**`AWS::CloudFormation::Stack`**  
*`LogicalId`: *`<application‑LogicalId>`   
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

# CloudFormation AWS::Serverless::CapacityProvider가 지정될 때 생성되는 리소스
<a name="sam-specification-generated-resources-capacityprovider"></a>

`AWS::Serverless::CapacityProvider`이 지정되면 AWS Serverless Application Model (AWS SAM)은 `AWS::Lambda::CapacityProvider` 기본 CloudFormation 리소스를 생성합니다.

**`AWS::Lambda::CapacityProvider`**  
*`LogicalId`: *`<capacityprovider‑LogicalId>`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

이 CloudFormation 리소스 외에도이 `AWS::Serverless::CapacityProvider` 지정되면는 다음 시나리오에 대한 CloudFormation 리소스 AWS SAM 도 생성합니다.

**Topics**
+ [OperatorRole 속성이 지정되지 않았습니다.](#sam-specification-generated-resources-capacityprovider-iam-role)

## OperatorRole 속성이 지정되지 않았습니다.
<a name="sam-specification-generated-resources-capacityprovider-iam-role"></a>

의 `OperatorRole` 속성`AWS::Serverless::CapacityProvider`이 지정*되지 않은* 경우는 `AWSLambdaManagedEC2ResourceOperator` 관리형 정책이 연결된 `AWS::IAM::Role` CloudFormation 리소스를 AWS SAM 생성합니다.

**`AWS::IAM::Role`**  
*`LogicalId`: *`<capacityprovider‑LogicalId>OperatorRole`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

# CloudFormation 지정할 때 생성된 리소스 AWS::Serverless::Connector
<a name="sam-specification-generated-resources-connector"></a>

**참고**  
임베디드 `Connectors` 속성을 통해 커넥터를 정의하면 이러한 리소스가 생성되기 전에 먼저 `AWS::Serverless::Connector` 리소스로 변환됩니다.

 AWS SAM 템플릿에서 `AWS::Serverless::Connector` 리소스를 지정하면는 필요에 따라 다음 AWS CloudFormation 리소스를 AWS SAM 생성합니다.

**`AWS::IAM::ManagedPolicy`**  
 *`LogicalId`:*`<connector‑LogicalId>Policy`   
 *참조 가능한 속성:* N/A(이 CloudFormation 리소스를 참조하려면를 사용해야 합니다`LogicalId`.) 

**`AWS::SNS::TopicPolicy`**  
 *`LogicalId`:*`<connector‑LogicalId>TopicPolicy`   
 *참조 가능한 속성:* N/A(이 CloudFormation 리소스를 참조하려면를 사용해야 합니다`LogicalId`.) 

**`AWS::SQS::QueuePolicy`**  
 *`LogicalId`:*`<connector‑LogicalId>QueuePolicy`   
 *참조 가능한 속성:* N/A(이 CloudFormation 리소스를 참조하려면를 사용해야 합니다`LogicalId`.) 

**`AWS::Lambda::Permission`**  
 *`LogicalId`:*`<connector‑LogicalId><permission>LambdaPermission`   
 `<permission>`은 `Permissions` 속성에 의해 지정된 권한입니다. 예를 들어 `Write`입니다.  
*참조 가능한 속성:* N/A(이 CloudFormation 리소스를 참조하려면를 사용해야 합니다`LogicalId`.) 

# CloudFormation AWS::Serverless::Function가 지정될 때 생성되는 리소스
<a name="sam-specification-generated-resources-function"></a>

`AWS::Serverless::Function`이 지정 AWS Serverless Application Model 되면 (AWS SAM)는 항상 `AWS::Lambda::Function` 기본 CloudFormation 리소스를 생성합니다.

**`AWS::Lambda::Function`**  
*`LogicalId`: *`<function‑LogicalId>`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

이 CloudFormation 리소스 외에도이 `AWS::Serverless::Function` 지정되면는 다음 시나리오에 대한 CloudFormation 리소스 AWS SAM 도 생성합니다.

**Topics**
+ [핵심 함수 속성](#sam-specification-generated-resources-function-core-properties)
+ [이벤트 소스](#sam-specification-generated-resources-function-event-sources)
+ [이벤트 구성](#sam-specification-generated-resources-function-event-configuration)

## 핵심 함수 속성
<a name="sam-specification-generated-resources-function-core-properties"></a>

다음 시나리오에서는 코어 함수 속성을 기반으로 CloudFormation 리소스를 생성합니다.

### 역할 속성이 지정되지 않음
<a name="sam-specification-generated-resources-function-not-role"></a>

의 `Role` 속성을 지정*하지* 않으면 `AWS::Serverless::Function`가 `AWS::IAM::Role` CloudFormation 리소스를 AWS SAM 생성합니다.

**`AWS::IAM::Role`**  
*`LogicalId`: *`<function‑LogicalId>Role`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

### AutoPublishalias 속성 지정됨
<a name="sam-specification-generated-resources-function-autopublishalias"></a>

의 `AutoPublishAlias` 속성`AWS::Serverless::Function`이 지정되면는 `AWS::Lambda::Alias` 및 CloudFormation 리소스를 AWS SAM 생성합니다`AWS::Lambda::Version`.

**`AWS::Lambda::Alias`**  
*`LogicalId`: *`<function‑LogicalId>Alias<alias‑name>`  
`<alias‑name>`은 `AutoPublishAlias`가 설정된 문자열입니다. 예를 들어 `AutoPublishAlias`을 `live`로 설정하면 `LogicalId`은 *MyFunction*Alias*live*입니다.  
*참조 가능한 속성: *`<function‑LogicalId>.Alias`

**`AWS::Lambda::Version`**  
*`LogicalId`: *`<function‑LogicalId>Version<sha>`  
`<sha>`은 스택이 만들어질 때 생성되는 고유한 해시 값입니다. 예를 들어 *MyFunction*버전*926eeb5ff1*입니다.  
*참조 가능한 속성: *`<function‑LogicalId>.Version`

`AutoPublishAlias` 속성에 대한 자세한 내용은 [AWS::Serverless::Function의 속성 섹션](sam-resource-function.md#sam-resource-function-properties)을 참조하세요.

### DeploymentPreference 속성 지정됨
<a name="sam-specification-generated-resources-function-deploymentpreference"></a>

의 `DeploymentPreference` 속성`AWS::Serverless::Function`이 지정되면 `AWS::CodeDeploy::Application` 및 CloudFormation 리소스가 AWS SAM 생성됩니다`AWS::CodeDeploy::DeploymentGroup`. 또한 `DeploymentPreference` 객체의 `Role` 속성이 지정*되지* 않은 경우는 `AWS::IAM::Role` CloudFormation 리소스 AWS SAM 도 생성합니다.

**`AWS::CodeDeploy::Application`**  
*`LogicalId`: *`ServerlessDeploymentApplication`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

**`AWS::CodeDeploy::DeploymentGroup`**  
*`LogicalId`: *`<function‑LogicalId>DeploymentGroup`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

**`AWS::IAM::Role`**  
*`LogicalId`: *`CodeDeployServiceRole`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

### FunctionUrlConfig 속성이 지정됨
<a name="sam-specification-generated-resources-function-functionurlconfig"></a>

`FunctionUrlConfig` 속성이 지정되면는를 기반으로 다양한 CloudFormation 리소스를 AWS SAM 생성합니다`AuthType`.

`AuthType: NONE`이 지정되면 다음 CloudFormation 리소스를 AWS SAM 생성합니다.

**`AWS::Lambda::Permission`(액세스 간접 호출)**  
*`LogicalId`: *`<function‑LogicalId>URLInvokeAllowPublicAccess`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

**`AWS::Lambda::Permission`(퍼블릭 액세스)**  
*`LogicalId`: *`<function‑LogicalId>UrlPublicPermissions`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

**`AWS::Lambda::Url`**  
*`LogicalId`: *`<function‑LogicalId>Url`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

`AuthType: AWS_IAM`를 지정하면 만 AWS SAM 생성됩니다.

**`AWS::Lambda::Url`**  
*`LogicalId`: *`<function‑LogicalId>Url`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

`FunctionUrlConfig` 속성에 대한 추가 정보는 [FunctionUrlConfig](sam-property-function-functionurlconfig.md)를 참조하세요.

## 이벤트 소스
<a name="sam-specification-generated-resources-function-event-sources"></a>

다음 시나리오에서는 이벤트 소스를 기반으로 CloudFormation 리소스를 생성합니다.

### Api 이벤트 소스 지정됨
<a name="sam-specification-generated-resources-function-api"></a>

의 `Event` 속성`AWS::Serverless::Function`이 로 설정`Api`되었지만 `RestApiId` 속성이 지정*되지 않은* 경우는 `AWS::ApiGateway::RestApi` CloudFormation 리소스를 AWS SAM 생성합니다.

**`AWS::ApiGateway::RestApi`**  
*`LogicalId`: *`ServerlessRestApi`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

### HttpApi 이벤트 소스 지정됨
<a name="sam-specification-generated-resources-function-httpapi"></a>

의 `Event` 속성`AWS::Serverless::Function`이 로 설정`HttpApi`되었지만 `ApiId` 속성이 지정*되지 않은* 경우는 `AWS::ApiGatewayV2::Api` CloudFormation 리소스를 AWS SAM 생성합니다.

**`AWS::ApiGatewayV2::Api`**  
*`LogicalId`: *`ServerlessHttpApi`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

### 스트리밍 이벤트 소스 지정됨
<a name="sam-specification-generated-resources-function-streaming"></a>

의 `Event` 속성`AWS::Serverless::Function`이 스트리밍 유형 중 하나로 설정되면가 `AWS::Lambda::EventSourceMapping` CloudFormation 리소스를 AWS SAM 생성합니다. 이는 `DynamoDB`, `Kinesis`, `MQ`, `MSK`, 및 `SQS` 유형에 적용됩니다.

**`AWS::Lambda::EventSourceMapping`**  
*`LogicalId`: *`<function‑LogicalId><event‑LogicalId>`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

### 이벤트 브리지(또는 이벤트 버스) 이벤트 소스 지정됨
<a name="sam-specification-generated-resources-function-eventbridge"></a>

의 `Event` 속성`AWS::Serverless::Function`이 이벤트 브리지(또는 이벤트 버스) 유형 중 하나로 설정되면가 `AWS::Events::Rule` CloudFormation 리소스를 AWS SAM 생성합니다. 이는`EventBridgeRule`, `Schedule`, 및 `CloudWatchEvents` 유형에 적용됩니다.

**`AWS::Events::Rule`**  
*`LogicalId`: *`<function‑LogicalId><event‑LogicalId>`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

### IoTRule 이벤트 소스 지정됨
<a name="sam-specification-generated-resources-function-iotrule"></a>

의 `Event` 속성`AWS::Serverless::Function`이 IoTRule로 설정되면가 `AWS::IoT::TopicRule` CloudFormation 리소스를 AWS SAM 생성합니다.

**`AWS::IoT::TopicRule`**  
*`LogicalId`: *`<function‑LogicalId><event‑LogicalId>`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

## 이벤트 구성
<a name="sam-specification-generated-resources-function-event-configuration"></a>

다음 시나리오에서는 이벤트 구성을 기반으로 CloudFormation 리소스를 생성합니다.

### Amazon SNS 이벤트에 대하여 OnSuccess(또는 OnFailure) 속성이 지정됩니다
<a name="sam-specification-generated-resources-function-sns-onsuccess"></a>

의 속성에 대한 `OnSuccess` (또는 `OnFailure`) `DestinationConfig` `EventInvokeConfig` 속성`AWS::Serverless::Function`이 지정되고 대상 유형이 `SNS`이지만 대상 ARN이 지정*되지 않은* 경우는 `AWS::Lambda::EventInvokeConfig` 및 CloudFormation 리소스를 AWS SAM 생성합니다`AWS::SNS::Topic`.

**`AWS::Lambda::EventInvokeConfig`**  
*`LogicalId`: *`<function‑LogicalId>EventInvokeConfig`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

**`AWS::SNS::Topic`**  
*`LogicalId`: *`<function‑LogicalId>OnSuccessTopic` (또는 `<function‑LogicalId>OnFailureTopic`)  
*참조 가능한 속성: *`<function‑LogicalId>.DestinationTopic`  
`OnSuccess`및 `OnFailure` 가 모두 Amazon SNS 이벤트에 관하여 지정된 경우, 생성된 리소스 간에 구분하려면 `LogicalId`를 사용해야 합니다.

### Amazon SQS 이벤트에 대하여 OnSuccess(또는 OnFailure) 속성이 지정됩니다
<a name="sam-specification-generated-resources-function-sqs-onsuccess"></a>

의 속성에 대한 `OnSuccess` (또는 `OnFailure`) `DestinationConfig` `EventInvokeConfig` 속성`AWS::Serverless::Function`이 지정되고 대상 유형이 `SQS`이지만 대상 ARN이 지정*되지 않은* 경우는 `AWS::Lambda::EventInvokeConfig` 및 CloudFormation 리소스를 AWS SAM 생성합니다`AWS::SQS::Queue`.

**`AWS::Lambda::EventInvokeConfig`**  
*`LogicalId`: *`<function‑LogicalId>EventInvokeConfig`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

**`AWS::SQS::Queue`**  
*`LogicalId`: *`<function‑LogicalId>OnSuccessQueue` (또는 `<function‑LogicalId>OnFailureQueue`)  
*참조 가능한 속성: *`<function‑LogicalId>.DestinationQueue`  
`OnSuccess`및 `OnFailure` 가 모두 Amazon SQS 이벤트에 관하여 지정된 경우, 생성된 리소스 간에 구분하려면 `LogicalId`를 사용해야 합니다.

# CloudFormation AWS::Serverless::GraphQLApi가 지정될 때 생성되는 리소스
<a name="sam-specification-generated-resources-graphqlapi"></a>

(AWS SAM) 템플릿에서 `AWS::Serverless::GraphQLApi` AWS Serverless Application Model 리소스를 지정하면가 AWS SAM 항상 다음과 같은 기본 AWS CloudFormation 리소스를 생성합니다.

**`AWS::AppSync::DataSource`**  
*`LogicalId`: *`<graphqlapi-LogicalId><datasource-RelativeId><datasource-Type>DataSource`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

**`AWS::AppSync::FunctionConfiguration`**  
*`LogicalId`: *`<graphqlapi-LogicalId><function-RelativeId>`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

**`AWS::AppSync::GraphQLApi`**  
*`LogicalId`: *`<graphqlapi-LogicalId>`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

**`AWS::AppSync::GraphQLSchema`**  
*`LogicalId`: *`<graphqlapi-LogicalId>Schema`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

**`AWS::AppSync::Resolver`**  
*`LogicalId`: *`<graphqlapi-LogicalId><OperationType><resolver-RelativeId>`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

이러한 CloudFormation 리소스 외에도이 지정되면 `AWS::Serverless::GraphQLApi`에서 다음 CloudFormation 리소스도 생성할 AWS SAM 수 있습니다.

`AWS::AppSync::ApiCache`  
*`LogicalId`: *`<graphqlapi-LogicalId>ApiCache`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

`AWS::AppSync::ApiKey`  
*`LogicalId`: *`<graphqlapi-LogicalId><apikey-RelativeId>`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

`AWS::AppSync::DomainName`  
*`LogicalId`: *`<graphqlapi-LogicalId>DomainName`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

`AWS::AppSync::DomainNameApiAssociation`  
*`LogicalId`: *`<graphqlapi-LogicalId>DomainNameApiAssociation`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

AWS SAM 는 `AWS::Serverless::Connector` 리소스를 사용하여 권한을 프로비저닝할 수도 있습니다. 자세한 내용은 [CloudFormation 지정할 때 생성된 리소스 AWS::Serverless::Connector](sam-specification-generated-resources-connector.md) 단원을 참조하십시오.

# CloudFormation AWS::Serverless::HttpApi가 지정될 때 생성되는 리소스
<a name="sam-specification-generated-resources-httpapi"></a>

`AWS::Serverless::HttpApi`이 지정 AWS Serverless Application Model 되면 (AWS SAM)가 `AWS::ApiGatewayV2::Api` 기본 CloudFormation 리소스를 생성합니다.

**`AWS::ApiGatewayV2::Api`**  
*`LogicalId`: *`<httpapi‑LogicalId>`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

이 CloudFormation 리소스 외에도이 `AWS::Serverless::HttpApi` 지정되면는 다음 시나리오에 대한 CloudFormation 리소스 AWS SAM 도 생성합니다.

**Topics**
+ [스테이지 이름 속성이 지정되었습니다.](#sam-specification-generated-resources-httpapi-stage-name)
+ [StageName 속성이 지정되지 *않았*습니다.](#sam-specification-generated-resources-httpapi-not-stage-name)
+ [DomainName 속성이 지정되었습니다.](#sam-specification-generated-resources-httpapi-domain-name)

## 스테이지 이름 속성이 지정되었습니다.
<a name="sam-specification-generated-resources-httpapi-stage-name"></a>

의 `StageName` 속성`AWS::Serverless::HttpApi`이 지정되면가 `AWS::ApiGatewayV2::Stage` CloudFormation 리소스를 AWS SAM 생성합니다.

**`AWS::ApiGatewayV2::Stage`**  
*`LogicalId`: *`<httpapi‑LogicalId><stage‑name>Stage`  
`<stage‑name>`은 `StageName` 속성이 설정된 문자열입니다. 예를 들어, `StageName`을 `Gamma`로 설정하면 `LogicalId`은 *myHTTPAPIGamma*Stage입니다.  
*참조 가능한 속성:* `<httpapi‑LogicalId>.Stage`

## StageName 속성이 지정되지 *않았*습니다.
<a name="sam-specification-generated-resources-httpapi-not-stage-name"></a>

의 `StageName` 속성`AWS::Serverless::HttpApi`이 지정*되지 않으면*가 `AWS::ApiGatewayV2::Stage` CloudFormation 리소스를 AWS SAM 생성합니다.

**`AWS::ApiGatewayV2::Stage`**  
*`LogicalId`: *`<httpapi‑LogicalId>ApiGatewayDefaultStage`  
*참조 가능한 속성: *`<httpapi‑LogicalId>.Stage`

## DomainName 속성이 지정되었습니다.
<a name="sam-specification-generated-resources-httpapi-domain-name"></a>

의 `DomainName` 속성 속성이 지정되면 `Domain``AWS::Serverless::HttpApi`가 `AWS::ApiGatewayV2::DomainName` CloudFormation 리소스를 AWS SAM 생성합니다.

**`AWS::ApiGatewayV2::DomainName`**  
*`LogicalId`: *`ApiGatewayDomainNameV2<sha>`  
`<sha>`은 스택이 만들어질 때 생성되는 고유한 해시 값입니다. `ApiGatewayDomainNameV2` *926eeb5ff1*을 예로 들 수 있습니다.  
*참조 가능한 속성:* `<httpapi‑LogicalId>.DomainName`

# CloudFormation AWS::Serverless::LayerVersion가 지정될 때 생성되는 리소스
<a name="sam-specification-generated-resources-layerversion"></a>

`AWS::Serverless::LayerVersion`이 지정 AWS Serverless Application Model 되면 (AWS SAM)가 `AWS::Lambda::LayerVersion` 기본 CloudFormation 리소스를 생성합니다.

**`AWS::Lambda::LayerVersion`**  
*`LogicalId`: *`<layerversion‑LogicalId>`   
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

# CloudFormation AWS::Serverless::SimpleTable가 지정될 때 생성되는 리소스
<a name="sam-specification-generated-resources-simpletable"></a>

`AWS::Serverless::SimpleTable`이 지정 AWS Serverless Application Model 되면 (AWS SAM)가 `AWS::DynamoDB::Table` 기본 CloudFormation 리소스를 생성합니다.

**`AWS::DynamoDB::Table`**  
*`LogicalId`: *`<simpletable‑LogicalId>`   
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

# CloudFormation AWS::Serverless::StateMachine가 지정될 때 생성되는 리소스
<a name="sam-specification-generated-resources-statemachine"></a>

`AWS::Serverless::StateMachine`이 지정되면 AWS Serverless Application Model (AWS SAM)은 `AWS::StepFunctions::StateMachine` 기본 CloudFormation 리소스를 생성합니다.

**`AWS::StepFunctions::StateMachine`**  
*`LogicalId`: *`<statemachine‑LogicalId>`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

이 CloudFormation 리소스 외에도이 `AWS::Serverless::StateMachine` 지정되면는 다음 시나리오에 대한 CloudFormation 리소스 AWS SAM 도 생성합니다.

**Topics**
+ [역할 속성이 지정되지 않음](#sam-specification-generated-resources-statemachine-not-role)
+ [API 이벤트 소스 지정됨](#sam-specification-generated-resources-statemachine-api)
+ [이벤트 브리지(또는 이벤트 버스) 이벤트 소스 지정됨](#sam-specification-generated-resources-statemachine-eventbridge)

## 역할 속성이 지정되지 않음
<a name="sam-specification-generated-resources-statemachine-not-role"></a>

의 `Role` 속성`AWS::Serverless::StateMachine`이 지정*되지 않으면*가 `AWS::IAM::Role` CloudFormation 리소스를 AWS SAM 생성합니다.

**`AWS::IAM::Role`**  
*`LogicalId`: *`<statemachine‑LogicalId>Role`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

## API 이벤트 소스 지정됨
<a name="sam-specification-generated-resources-statemachine-api"></a>

의 `Event` 속성`AWS::Serverless::StateMachine`이 로 설정`Api`되었지만 `RestApiId` 속성이 지정*되지 않은* 경우는 `AWS::ApiGateway::RestApi` CloudFormation 리소스를 AWS SAM 생성합니다.

**`AWS::ApiGateway::RestApi`**  
*`LogicalId`: *`ServerlessRestApi`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)

## 이벤트 브리지(또는 이벤트 버스) 이벤트 소스 지정됨
<a name="sam-specification-generated-resources-statemachine-eventbridge"></a>

의 `Event` 속성`AWS::Serverless::StateMachine`이 이벤트 브리지(또는 이벤트 버스) 유형 중 하나로 설정되면가 `AWS::Events::Rule` CloudFormation 리소스를 AWS SAM 생성합니다. 이는`EventBridgeRule`, `Schedule`, 및 `CloudWatchEvents` 유형에 적용됩니다.

**`AWS::Events::Rule`**  
*`LogicalId`: *`<statemachine‑LogicalId><event‑LogicalId>`  
*참조 가능한 속성: *N/A(이 CloudFormation 리소스를 참조`LogicalId`하려면를 사용해야 함)