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

# 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`은 `{{MyRestApiGamma}}Stage`가 됩니다.  
*참조 가능한 속성: *`{{<api‑LogicalId>}}.Stage`

**`AWS::ApiGateway::Deployment`**  
*`LogicalId`: *`{{<api‑LogicalId>}}Deployment{{<sha>}}`  
`{{<sha>}}`은 스택이 만들어질 때 생성되는 고유한 해시 값입니다. 예를 들어 `{{MyRestApi}}Deployment{{926eeb5ff1}}`입니다.  
*참조 가능한 속성: *`{{<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>}}`은 스택이 만들어질 때 생성되는 고유한 해시 값입니다. 예를 들어 `ApiGatewayDomainName{{926eeb5ff1}}`입니다.  
*참조 가능한 속성: *`{{<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`