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 `MyRestApiGammaStage`.  
*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, `MyRestApiDeployment926eeb5ff1`.  
*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: `ApiGatewayDomainName926eeb5ff1`.  
*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`