Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# CloudFormation recursos generados cuando AWS::Serverless::Api se especifica
<a name="sam-specification-generated-resources-api"></a>

Cuando `AWS::Serverless::Api` se especifica un, AWS Serverless Application Model (AWS SAM) siempre genera un CloudFormation recurso `AWS::ApiGateway::RestApi` base. Además, siempre genera un recurso `AWS::ApiGateway::Stage` y un recurso `AWS::ApiGateway::Deployment`.

**`AWS::ApiGateway::RestApi`**  
*`LogicalId`: *`{{<api‑LogicalId>}}`  
*Propiedad referenciable:* N/A (debe usar la `LogicalId` para hacer referencia a este CloudFormation recurso)

**`AWS::ApiGateway::Stage`**  
*`LogicalId`: *`{{<api‑LogicalId>}}{{<stage‑name>}}Stage`  
`{{<stage‑name>}}` es la cadena en la que está establecida la propiedad `StageName`. Por ejemplo, si establece `StageName` como `Gamma`, entonces `LogicalId` es `{{MyRestApiGamma}}Stage`.  
*Propiedad referenciable: * `{{<api‑LogicalId>}}.Stage`

**`AWS::ApiGateway::Deployment`**  
*`LogicalId`: *`{{<api‑LogicalId>}}Deployment{{<sha>}}`  
`{{<sha>}}` es un valor hash único que se genera cuando se crea la pila. Por ejemplo, `{{MyRestApi}}Deployment{{926eeb5ff1}}`.  
*Propiedad referenciable: *`{{<api‑LogicalId>}}.Deployment`

Además de estos CloudFormation recursos, cuando `AWS::Serverless::Api` se especifica, AWS SAM genera CloudFormation recursos adicionales para los siguientes escenarios.

**Topics**
+ [DomainName se especifica la propiedad](#sam-specification-generated-resources-api-domain-name)
+ [UsagePlan se especifica la propiedad](#sam-specification-generated-resources-api-usage-plan)

## DomainName se especifica la propiedad
<a name="sam-specification-generated-resources-api-domain-name"></a>

Cuando se especifica la `DomainName` `Domain` propiedad de `AWS::Serverless::Api` una, AWS SAM genera el `AWS::ApiGateway::DomainName` CloudFormation recurso.

**`AWS::ApiGateway::DomainName`**  
*`LogicalId`: *`ApiGatewayDomainName{{<sha>}}`  
`{{<sha>}}` es un valor hash único que se genera cuando se crea la pila. Por ejemplo: `ApiGatewayDomainName{{926eeb5ff1}}`.  
*Propiedad referenciable: *`{{<api‑LogicalId>}}.DomainName`

## UsagePlan se especifica la propiedad
<a name="sam-specification-generated-resources-api-usage-plan"></a>

Cuando se especifica la `Auth` propiedad de `AWS::Serverless::Api` una, AWS SAM genera los siguientes CloudFormation recursos: `AWS::ApiGateway::UsagePlan``AWS::ApiGateway::UsagePlanKey`, y`AWS::ApiGateway::ApiKey`. `UsagePlan`

**`AWS::ApiGateway::UsagePlan`**  
*`LogicalId`: *`{{<api‑LogicalId>}}UsagePlan`  
*Propiedad referenciable: *`{{<api‑LogicalId>}}.UsagePlan`

**`AWS::ApiGateway::UsagePlanKey`**  
*`LogicalId`: *`{{<api‑LogicalId>}}UsagePlanKey`  
*Propiedad referenciable: *`{{<api‑LogicalId>}}.UsagePlanKey`

**`AWS::ApiGateway::ApiKey`**  
*`LogicalId`: *`{{<api‑LogicalId>}}ApiKey`  
*Propiedad referenciable: *`{{<api‑LogicalId>}}.ApiKey`