As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Gerado CloudFormation recursos para AWS SAM
<a name="sam-specification-generated-resources"></a>

Esta seção fornece detalhes sobre os CloudFormation recursos que são criados ao AWS SAM processar seu AWS modelo. O conjunto de CloudFormation recursos AWS SAM gerados difere dependendo dos cenários que você especificar. Um *cenário* é a combinação de recursos AWS SAM e propriedades especificados em seu arquivo de modelo. Você pode referenciar os recursos CloudFormation gerados em outro lugar no seu arquivo de modelo, da mesma forma que você faz referência aos recursos que você declara explicitamente em seu arquivo de modelo.

Por exemplo, se você especificar um recurso `AWS::Serverless::Function` em seu arquivo de modelo AWS SAM , AWS SAM sempre gera um recurso base `AWS::Lambda::Function`. Se você também especificar a `AutoPublishAlias` propriedade opcional, AWS SAM também gera `AWS::Lambda::Alias` `AWS::Lambda::Version` recursos.

Esta seção lista os cenários e os CloudFormation recursos que eles geram e mostra como referenciar os CloudFormation recursos gerados em seu arquivo AWS SAM de modelo.

## Referência gerada CloudFormation recursos
<a name="sam-specification-generated-resources-referencing"></a>

Você tem duas opções para referenciar CloudFormation recursos gerados em seu arquivo AWS SAM de modelo, por `LogicalId` ou por propriedade referenciável.

### Referência gerada CloudFormation recursos por LogicalId
<a name="sam-specification-generated-resources-referencing-logicalid"></a>

Os CloudFormation recursos que AWS SAM geram cada um têm um`[LogicalId](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html#resources-section-structure-logicalid)`, que é um identificador alfanumérico (A-Z, a-z, 0-9) exclusivo em um arquivo de modelo. AWS SAM usa os `LogicalIds` AWS SAM recursos em seu arquivo de modelo para construir `LogicalIds` os CloudFormation recursos que ele gera. Você pode usar o `LogicalId` de um CloudFormation recurso gerado para acessar as propriedades desse recurso em seu arquivo de modelo, assim como faria com um CloudFormation recurso que você declarou explicitamente. Para obter mais informações sobre `LogicalIds` em CloudFormation e AWS SAM modelos, consulte [Recursos](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resources-section-structure.html) no *Guia do AWS CloudFormation usuário*.

**nota**  
Alguns recursos gerados incluem um valor `LogicalIds` de hash exclusivo para evitar conflitos de namespace. Esses recursos são derivados quando a pilha é criada `LogicalIds`. Você pode recuperá-los somente após a criação da pilha usando o Console de gerenciamento da AWS, AWS CLI, ou um dos AWS SDKs. Não recomendamos referenciar esses recursos `LogicalId` porque os valores de hash podem mudar.

### Referência gerada CloudFormation recursos por propriedade referenciável
<a name="sam-specification-generated-resources-referencing-referenceable-property"></a>

Para alguns recursos gerados, AWS SAM fornece uma propriedade referenciável do AWS SAM recurso. Você pode usar essa propriedade para referenciar um CloudFormation recurso gerado e suas propriedades em seu arquivo AWS SAM de modelo.

**nota**  
Nem todos os CloudFormation recursos gerados têm propriedades referenciáveis. Para esses recursos, você deve usar `LogicalId` o.

## Gerado CloudFormation cenários de recursos
<a name="sam-specification-generated-resources-scenarios"></a>

A tabela a seguir resume os AWS SAM recursos e propriedades que compõem os cenários que geram CloudFormation recursos. Os tópicos na coluna **Cenários** fornecem detalhes sobre os CloudFormation recursos adicionais que são AWS SAM gerados para esse cenário.


| AWS SAM recurso |  CloudFormation Recurso básico | Cenários | 
| --- | --- | --- | 
| AWS::Serverless::Api  | [AWS::ApiGateway::RestApi](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-restapi.html) |  +  [DomainName propriedade é especificada](sam-specification-generated-resources-api.md#sam-specification-generated-resources-api-domain-name) <br />+  [UsagePlan propriedade é especificada](sam-specification-generated-resources-api.md#sam-specification-generated-resources-api-usage-plan)   | 
| AWS::Serverless::Application  | [AWS::CloudFormation::Stack](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html) |  +  Além de gerar o CloudFormation recurso básico, não há cenários adicionais para esse recurso sem servidor.   | 
| AWS::Serverless::CapacityProvider  | [AWS::Lambda::CapacityProvider](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html) |  +  [OperatorRole propriedade não é especificada](sam-specification-generated-resources-capacityprovider.md#sam-specification-generated-resources-capacityprovider-iam-role)   | 
| AWS::Serverless::MicrovmImage  | [AWS::Lambda::MicrovmImage](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-microvmimage.html) |  +  [BuildRoleArn propriedade não é especificada](sam-specification-generated-resources-microvmimage.md#sam-specification-generated-resources-microvmimage-iam-role)   | 
| AWS::Serverless::NetworkConnector  | [AWS::Lambda::NetworkConnector](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-lambda-networkconnector.html) |  +  [OperatorRole propriedade não é especificada](sam-specification-generated-resources-networkconnector.md#sam-specification-generated-resources-networkconnector-iam-role)   | 
| AWS::Serverless::Function | [AWS::Lambda::Function](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html) |  +  [AutoPublishAlias propriedade é especificada](sam-specification-generated-resources-function.md#sam-specification-generated-resources-function-autopublishalias) <br />+  [A propriedade da função não foi especificada](sam-specification-generated-resources-function.md#sam-specification-generated-resources-function-not-role) <br />+  [DeploymentPreference propriedade é especificada](sam-specification-generated-resources-function.md#sam-specification-generated-resources-function-deploymentpreference) <br />+  [Uma fonte de eventos da Api é especificada](sam-specification-generated-resources-function.md#sam-specification-generated-resources-function-api) <br />+  [Uma fonte de HttpApi eventos é especificada](sam-specification-generated-resources-function.md#sam-specification-generated-resources-function-httpapi) <br />+  [Uma fonte de eventos de streaming é especificada](sam-specification-generated-resources-function.md#sam-specification-generated-resources-function-streaming) <br />+  [Uma fonte de eventos de ponte de eventos (ou barramento de eventos) é especificada](sam-specification-generated-resources-function.md#sam-specification-generated-resources-function-eventbridge) <br />+  [Uma fonte de IotRule eventos é especificada](sam-specification-generated-resources-function.md#sam-specification-generated-resources-function-iotrule) <br />+  [OnSuccess (ou OnFailure) a propriedade é especificada para eventos do Amazon SNS](sam-specification-generated-resources-function.md#sam-specification-generated-resources-function-sns-onsuccess) <br />+  [OnSuccess (ou OnFailure) a propriedade é especificada para eventos do Amazon SQS](sam-specification-generated-resources-function.md#sam-specification-generated-resources-function-sqs-onsuccess)   | 
| AWS::Serverless::HttpApi | [AWS::ApiGatewayV2::Api](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigatewayv2-api.html) |  +  [StageName propriedade é especificada](sam-specification-generated-resources-httpapi.md#sam-specification-generated-resources-httpapi-stage-name) <br />+  [StageName propriedade *não* é especificada](sam-specification-generated-resources-httpapi.md#sam-specification-generated-resources-httpapi-not-stage-name) <br />+  [DomainName propriedade é especificada](sam-specification-generated-resources-httpapi.md#sam-specification-generated-resources-httpapi-domain-name)   | 
| AWS::Serverless::LayerVersion  | [AWS::Lambda::LayerVersion](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html) |  +  Além de gerar o CloudFormation recurso básico, não há cenários adicionais para esse recurso sem servidor.   | 
| AWS::Serverless::SimpleTable  | [AWS::DynamoDB::Table](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-table.html) |  +  Além de gerar o CloudFormation recurso básico, não há cenários adicionais para esse recurso sem servidor.   | 
| AWS::Serverless::StateMachine  | [AWS::StepFunctions::StateMachine](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html) |  +  [A propriedade da função não foi especificada](sam-specification-generated-resources-statemachine.md#sam-specification-generated-resources-statemachine-not-role) <br />+  [Uma origem de eventos de API é especificada](sam-specification-generated-resources-statemachine.md#sam-specification-generated-resources-statemachine-api) <br />+  [Uma fonte de eventos de ponte de eventos (ou barramento de eventos) é especificada](sam-specification-generated-resources-statemachine.md#sam-specification-generated-resources-statemachine-eventbridge)   | 

**Topics**
+ [Referência gerada CloudFormation recursos](#sam-specification-generated-resources-referencing)
+ [Gerado CloudFormation cenários de recursos](#sam-specification-generated-resources-scenarios)
+ [CloudFormation recursos gerados quando AWS::Serverless::Api é especificado](sam-specification-generated-resources-api.md)
+ [CloudFormation recursos gerados quando AWS::Serverless::Application é especificado](sam-specification-generated-resources-application.md)
+ [CloudFormation recursos gerados quando AWS::Serverless::CapacityProvider é especificado](sam-specification-generated-resources-capacityprovider.md)
+ [CloudFormation recursos gerados quando você especifica AWS::Serverless::Connector](sam-specification-generated-resources-connector.md)
+ [CloudFormation recursos gerados quando AWS::Serverless::Function é especificado](sam-specification-generated-resources-function.md)
+ [CloudFormation recursos gerados quando AWS::Serverless::GraphQLApi é especificado](sam-specification-generated-resources-graphqlapi.md)
+ [CloudFormation recursos gerados quando AWS::Serverless::HttpApi é especificado](sam-specification-generated-resources-httpapi.md)
+ [CloudFormation recursos gerados quando AWS::Serverless::MicrovmImage é especificado](sam-specification-generated-resources-microvmimage.md)
+ [CloudFormation recursos gerados quando AWS::Serverless::NetworkConnector é especificado](sam-specification-generated-resources-networkconnector.md)
+ [CloudFormation recursos gerados quando AWS::Serverless::WebSocketApi é especificado](sam-specification-generated-resources-websocketapi.md)
+ [CloudFormation recursos gerados quando AWS::Serverless::LayerVersion é especificado](sam-specification-generated-resources-layerversion.md)
+ [CloudFormation recursos gerados quando AWS::Serverless::SimpleTable é especificado](sam-specification-generated-resources-simpletable.md)
+ [CloudFormation recursos gerados quando AWS::Serverless::StateMachine é especificado](sam-specification-generated-resources-statemachine.md)