本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 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（必须使用`LogicalId`来引用此 CloudFormation 资源）

除此 CloudFormation 资源外，如果指定了`AWS::Serverless::HttpApi`此资源， AWS SAM 还会生成用于以下场景的 CloudFormation 资源：

**Topics**
+ [StageName 属性已指定](#sam-specification-generated-resources-httpapi-stage-name)
+ [StageName *未*指定属性](#sam-specification-generated-resources-httpapi-not-stage-name)
+ [DomainName 属性已指定](#sam-specification-generated-resources-httpapi-domain-name)

## StageName 属性已指定
<a name="sam-specification-generated-resources-httpapi-stage-name"></a>

当指定了的`StageName`属性`AWS::Serverless::HttpApi`时， AWS SAM 会生成`AWS::ApiGatewayV2::Stage` CloudFormation 资源。

**`AWS::ApiGatewayV2::Stage`**  
*`LogicalId`: *`<httpapi‑LogicalId><stage‑name>Stage`  
`<stage‑name>` 是 `StageName` 属性将被设置为的字符串。例如，如果设置为 `StageName``Gamma`，则`LogicalId`为：*MyHttpApiGamma*舞台。  
*可引用属性：*`<httpapi‑LogicalId>.Stage`

## StageName *未*指定属性
<a name="sam-specification-generated-resources-httpapi-not-stage-name"></a>

如果*未*指定 a `AWS::Serverless::HttpApi` 的`StageName`属性，则 AWS SAM 生成`AWS::ApiGatewayV2::Stage` CloudFormation 资源。

**`AWS::ApiGatewayV2::Stage`**  
*`LogicalId`: *`<httpapi‑LogicalId>ApiGatewayDefaultStage`  
*可引用属性：*`<httpapi‑LogicalId>.Stage`

## DomainName 属性已指定
<a name="sam-specification-generated-resources-httpapi-domain-name"></a>

当指定了`Domain`属性的属性`AWS::Serverless::HttpApi`时， AWS SAM 会生成`AWS::ApiGatewayV2::DomainName` CloudFormation 资源。`DomainName`

**`AWS::ApiGatewayV2::DomainName`**  
*`LogicalId`: *`ApiGatewayDomainNameV2<sha>`  
`<sha>` 是在创建堆栈时生成的唯一哈希值。例如 `ApiGatewayDomainNameV2`*926eeb5ff1*。  
*可引用属性：*`<httpapi‑LogicalId>.DomainName`