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

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