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á.

# CloudFormation Recursos gerados 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 de acordo com os 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.

## Referenciando recursos gerados CloudFormation
<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.

### Referenciando CloudFormation recursos gerados 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.

### Referenciando CloudFormation recursos gerados 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.

## Cenários CloudFormation de recursos gerados
<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  | [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-restapi.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigateway-restapi.html) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/serverless-application-model/latest/developerguide/sam-specification-generated-resources.html)  | 
| AWS::Serverless::Application  | [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-stack.html) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/serverless-application-model/latest/developerguide/sam-specification-generated-resources.html)  | 
| AWS::Serverless::CapacityProvider  | [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-capacityprovider.html) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/serverless-application-model/latest/developerguide/sam-specification-generated-resources.html)  | 
| AWS::Serverless::Function | [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-function.html) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/serverless-application-model/latest/developerguide/sam-specification-generated-resources.html)  | 
| AWS::Serverless::HttpApi | [AWS::ApiGatewayV2::Api](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-apigatewayv2-api.html) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/serverless-application-model/latest/developerguide/sam-specification-generated-resources.html)  | 
| AWS::Serverless::LayerVersion  | [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-lambda-layerversion.html) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/serverless-application-model/latest/developerguide/sam-specification-generated-resources.html)  | 
| AWS::Serverless::SimpleTable  | [AWS::DynamoDB::Table](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-dynamodb-table.html) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/serverless-application-model/latest/developerguide/sam-specification-generated-resources.html)  | 
| AWS::Serverless::StateMachine  | [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-stepfunctions-statemachine.html) |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/serverless-application-model/latest/developerguide/sam-specification-generated-resources.html)  | 

**Topics**
+ [

## Referenciando recursos gerados CloudFormation
](#sam-specification-generated-resources-referencing)
+ [

## Cenários CloudFormation de recursos gerados
](#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::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)

# CloudFormation recursos gerados quando AWS::Serverless::Api é especificado
<a name="sam-specification-generated-resources-api"></a>

Quando um `AWS::Serverless::Api` é especificado, AWS Serverless Application Model (AWS SAM) sempre gera um CloudFormation recurso `AWS::ApiGateway::RestApi` básico. Além disso, ele sempre gera um `AWS::ApiGateway::Stage` e um recurso `AWS::ApiGateway::Deployment`.

**`AWS::ApiGateway::RestApi`**  
*`LogicalId`: *`<api‑LogicalId>`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

**`AWS::ApiGateway::Stage`**  
*`LogicalId`: *`<api‑LogicalId><stage‑name>Stage`  
`<stage‑name>` é a string para a qual a propriedade `StageName` está definida. Por exemplo, se você definir `StageName` como `Gamma`, será `LogicalId``MyRestApiGammaStage`.  
*Propriedade referenciável:* `<api‑LogicalId>.Stage`

**`AWS::ApiGateway::Deployment`**  
*`LogicalId`: *`<api‑LogicalId>Deployment<sha>`  
O `<sha>` é um valor de hash exclusivo que é gerado quando a pilha é criada. Por exemplo, `MyRestApiDeployment926eeb5ff1`.  
*Propriedade referenciável:* `<api‑LogicalId>.Deployment`

Além desses CloudFormation recursos, quando `AWS::Serverless::Api` especificado, AWS SAM gera CloudFormation recursos adicionais para os seguintes cenários.

**Topics**
+ [

## DomainName propriedade é especificada
](#sam-specification-generated-resources-api-domain-name)
+ [

## UsagePlan propriedade é especificada
](#sam-specification-generated-resources-api-usage-plan)

## DomainName propriedade é especificada
<a name="sam-specification-generated-resources-api-domain-name"></a>

Quando a `DomainName` propriedade da `Domain` propriedade de an `AWS::Serverless::Api` é especificada, AWS SAM gera o `AWS::ApiGateway::DomainName` CloudFormation recurso.

**`AWS::ApiGateway::DomainName`**  
*`LogicalId`: *`ApiGatewayDomainName<sha>`  
O `<sha>` é um valor de hash exclusivo que é gerado quando a pilha é criada. Por exemplo: `ApiGatewayDomainName926eeb5ff1`.  
*Propriedade referenciável:* `<api‑LogicalId>.DomainName`

## UsagePlan propriedade é especificada
<a name="sam-specification-generated-resources-api-usage-plan"></a>

Quando a `UsagePlan` propriedade da `Auth` propriedade de um `AWS::Serverless::Api` é especificada, AWS SAM gera os seguintes CloudFormation recursos: `AWS::ApiGateway::UsagePlan``AWS::ApiGateway::UsagePlanKey`, `AWS::ApiGateway::ApiKey` e.

**`AWS::ApiGateway::UsagePlan`**  
*`LogicalId`: *`<api‑LogicalId>UsagePlan`  
*Propriedade referenciável:* `<api‑LogicalId>.UsagePlan`

**`AWS::ApiGateway::UsagePlanKey`**  
*`LogicalId`: *`<api‑LogicalId>UsagePlanKey`  
*Propriedade referenciável:* `<api‑LogicalId>.UsagePlanKey`

**`AWS::ApiGateway::ApiKey`**  
*`LogicalId`: *`<api‑LogicalId>ApiKey`  
*Propriedade referenciável:* `<api‑LogicalId>.ApiKey`

# CloudFormation recursos gerados quando AWS::Serverless::Application é especificado
<a name="sam-specification-generated-resources-application"></a>

Quando um `AWS::Serverless::Application` é especificado, AWS Serverless Application Model (AWS SAM) gera um CloudFormation recurso `AWS::CloudFormation::Stack` básico.

**`AWS::CloudFormation::Stack`**  
*`LogicalId`: *`<application‑LogicalId>`   
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

# CloudFormation recursos gerados quando AWS::Serverless::CapacityProvider é especificado
<a name="sam-specification-generated-resources-capacityprovider"></a>

Quando um `AWS::Serverless::CapacityProvider` é especificado, AWS Serverless Application Model (AWS SAM) gera um recurso `AWS::Lambda::CapacityProvider` com base CloudFormation .

**`AWS::Lambda::CapacityProvider`**  
*`LogicalId`: *`<capacityprovider‑LogicalId>`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

Além desse CloudFormation recurso, quando `AWS::Serverless::CapacityProvider` especificado, AWS SAM também gera CloudFormation recursos para os seguintes cenários:

**Topics**
+ [

## OperatorRole propriedade não é especificada
](#sam-specification-generated-resources-capacityprovider-iam-role)

## OperatorRole propriedade não é especificada
<a name="sam-specification-generated-resources-capacityprovider-iam-role"></a>

Quando a `OperatorRole` propriedade de um *não `AWS::Serverless::CapacityProvider`* é especificada, AWS SAM gera um `AWS::IAM::Role` CloudFormation recurso com a política `AWSLambdaManagedEC2ResourceOperator` gerenciada anexada.

**`AWS::IAM::Role`**  
*`LogicalId`: *`<capacityprovider‑LogicalId>OperatorRole`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

# CloudFormation recursos gerados quando você especifica AWS::Serverless::Connector
<a name="sam-specification-generated-resources-connector"></a>

**nota**  
Quando você define conectores por meio da propriedade `Connectors` incorporada, ela é primeiro transformada em um recurso `AWS::Serverless::Connector` antes de gerar esses recursos.

Quando você especifica um `AWS::Serverless::Connector` recurso em um AWS SAM modelo, AWS SAM gera os seguintes AWS CloudFormation recursos conforme necessário.

**`AWS::IAM::ManagedPolicy`**  
 *`LogicalId`:*`<connector‑LogicalId>Policy`   
 *Propriedade referenciável:* N/A (Para referenciar esse CloudFormation recurso, você deve usar o.) `LogicalId` 

**`AWS::SNS::TopicPolicy`**  
 *`LogicalId`:*`<connector‑LogicalId>TopicPolicy`   
 *Propriedade referenciável:* N/A (Para referenciar esse CloudFormation recurso, você deve usar o.) `LogicalId` 

**`AWS::SQS::QueuePolicy`**  
 *`LogicalId`:*`<connector‑LogicalId>QueuePolicy`   
 *Propriedade referenciável:* N/A (Para referenciar esse CloudFormation recurso, você deve usar o.) `LogicalId` 

**`AWS::Lambda::Permission`**  
 *`LogicalId`:*`<connector‑LogicalId><permission>LambdaPermission`   
 `<permission>`é uma permissão especificada pela propriedade `Permissions`. Por exemplo, .`Write`   
*Propriedade referenciável:* N/A (Para referenciar esse CloudFormation recurso, você deve usar o.) `LogicalId` 

# CloudFormation recursos gerados quando AWS::Serverless::Function é especificado
<a name="sam-specification-generated-resources-function"></a>

Quando um `AWS::Serverless::Function` é especificado, AWS Serverless Application Model (AWS SAM) sempre cria um CloudFormation recurso `AWS::Lambda::Function` básico.

**`AWS::Lambda::Function`**  
*`LogicalId`: *`<function‑LogicalId>`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

Além desse CloudFormation recurso, quando `AWS::Serverless::Function` especificado, AWS SAM também gera CloudFormation recursos para os seguintes cenários.

**Topics**
+ [

## Propriedades da função principal
](#sam-specification-generated-resources-function-core-properties)
+ [

## Origens de eventos
](#sam-specification-generated-resources-function-event-sources)
+ [

## Configuração do evento
](#sam-specification-generated-resources-function-event-configuration)

## Propriedades da função principal
<a name="sam-specification-generated-resources-function-core-properties"></a>

Os cenários a seguir geram CloudFormation recursos com base nas propriedades da função principal:

### A propriedade da função não foi especificada
<a name="sam-specification-generated-resources-function-not-role"></a>

Quando a `Role` propriedade de um *não `AWS::Serverless::Function`* é especificada, AWS SAM gera um `AWS::IAM::Role` CloudFormation recurso.

**`AWS::IAM::Role`**  
*`LogicalId`: *`<function‑LogicalId>Role`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

### AutoPublishAlias propriedade é especificada
<a name="sam-specification-generated-resources-function-autopublishalias"></a>

Quando a `AutoPublishAlias` propriedade de um `AWS::Serverless::Function` é especificada, AWS SAM gera os seguintes CloudFormation recursos: `AWS::Lambda::Alias` `AWS::Lambda::Version` e.

**`AWS::Lambda::Alias`**  
*`LogicalId`: *`<function‑LogicalId>Alias<alias‑name>`  
`<alias‑name>` é a string que está definida como `AutoPublishAlias`. Por exemplo, se você `AutoPublishAlias` definir como`live`, `LogicalId` é: *MyFunction* Alias*live*.  
*Propriedade referenciável:* `<function‑LogicalId>.Alias`

**`AWS::Lambda::Version`**  
*`LogicalId`: *`<function‑LogicalId>Version<sha>`  
O `<sha>` é um valor de hash exclusivo que é gerado quando a pilha é criada. Por exemplo, *MyFunction* Versão*926eeb5ff1*.  
*Propriedade referenciável:* `<function‑LogicalId>.Version`

Para obter informações adicionais sobre a `AutoPublishAlias` propriedade, consulte a [seção Propriedades do AWS::Serverless::Function](sam-resource-function.md#sam-resource-function-properties).

### DeploymentPreference propriedade é especificada
<a name="sam-specification-generated-resources-function-deploymentpreference"></a>

Quando a `DeploymentPreference` propriedade de um `AWS::Serverless::Function` é especificada, AWS SAM gera os seguintes CloudFormation recursos: `AWS::CodeDeploy::Application` `AWS::CodeDeploy::DeploymentGroup` e. Além disso, se a `Role` propriedade do `DeploymentPreference` objeto *não* for especificada, AWS SAM também gera um `AWS::IAM::Role` CloudFormation recurso.

**`AWS::CodeDeploy::Application`**  
*`LogicalId`: *`ServerlessDeploymentApplication`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

**`AWS::CodeDeploy::DeploymentGroup`**  
*`LogicalId`: *`<function‑LogicalId>DeploymentGroup`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

**`AWS::IAM::Role`**  
*`LogicalId`: *`CodeDeployServiceRole`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

### FunctionUrlConfig propriedade é especificada
<a name="sam-specification-generated-resources-function-functionurlconfig"></a>

Quando a `FunctionUrlConfig` propriedade é especificada, AWS SAM gera CloudFormation recursos diferentes com base no`AuthType`.

Quando `AuthType: NONE` é especificado, AWS SAM gera os seguintes CloudFormation recursos:

**`AWS::Lambda::Permission` (Invocar acesso)**  
*`LogicalId`: *`<function‑LogicalId>URLInvokeAllowPublicAccess`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

**`AWS::Lambda::Permission` (Acesso público)**  
*`LogicalId`: *`<function‑LogicalId>UrlPublicPermissions`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

**`AWS::Lambda::Url`**  
*`LogicalId`: *`<function‑LogicalId>Url`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

Quando `AuthType: AWS_IAM` é especificado, AWS SAM gera somente:

**`AWS::Lambda::Url`**  
*`LogicalId`: *`<function‑LogicalId>Url`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

Para obter informações adicionais sobre a `FunctionUrlConfig` propriedade, consulte [FunctionUrlConfig](sam-property-function-functionurlconfig.md).

## Origens de eventos
<a name="sam-specification-generated-resources-function-event-sources"></a>

Os cenários a seguir geram CloudFormation recursos com base em fontes de eventos:

### Uma fonte de eventos da Api é especificada
<a name="sam-specification-generated-resources-function-api"></a>

Quando a `Event` propriedade de um `AWS::Serverless::Function` é definida como`Api`, mas a `RestApiId` propriedade *não* é especificada, AWS SAM gera o `AWS::ApiGateway::RestApi` CloudFormation recurso.

**`AWS::ApiGateway::RestApi`**  
*`LogicalId`: *`ServerlessRestApi`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

### Uma fonte de HttpApi eventos é especificada
<a name="sam-specification-generated-resources-function-httpapi"></a>

Quando a `Event` propriedade de um `AWS::Serverless::Function` é definida como`HttpApi`, mas a `ApiId` propriedade *não* é especificada, AWS SAM gera o `AWS::ApiGatewayV2::Api` CloudFormation recurso.

**`AWS::ApiGatewayV2::Api`**  
*`LogicalId`: *`ServerlessHttpApi`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

### Uma fonte de eventos de streaming é especificada
<a name="sam-specification-generated-resources-function-streaming"></a>

Quando a `Event` propriedade de an `AWS::Serverless::Function` é definida como um dos tipos de streaming, AWS SAM gera o `AWS::Lambda::EventSourceMapping` CloudFormation recurso. Isso se aplica aos seguintes tipos: `DynamoDB`, `Kinesis`, `MQ`, `MSK` e `SQS`.

**`AWS::Lambda::EventSourceMapping`**  
*`LogicalId`: *`<function‑LogicalId><event‑LogicalId>`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

### Uma fonte de eventos de ponte de eventos (ou barramento de eventos) é especificada
<a name="sam-specification-generated-resources-function-eventbridge"></a>

Quando a `Event` propriedade de an `AWS::Serverless::Function` é definida como um dos tipos de ponte de eventos (ou barramento de eventos), AWS SAM gera o `AWS::Events::Rule` CloudFormation recurso. Isso se aplica aos seguintes tipos: `EventBridgeRule`, `Schedule` e `CloudWatchEvents`.

**`AWS::Events::Rule`**  
*`LogicalId`: *`<function‑LogicalId><event‑LogicalId>`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

### Uma fonte de IotRule eventos é especificada
<a name="sam-specification-generated-resources-function-iotrule"></a>

Quando a `Event` propriedade de an `AWS::Serverless::Function` é definida como IoTRule, AWS SAM gera o `AWS::IoT::TopicRule` CloudFormation recurso.

**`AWS::IoT::TopicRule`**  
*`LogicalId`: *`<function‑LogicalId><event‑LogicalId>`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

## Configuração do evento
<a name="sam-specification-generated-resources-function-event-configuration"></a>

Os cenários a seguir geram CloudFormation recursos com base na configuração do evento:

### OnSuccess (ou OnFailure) a propriedade é especificada para eventos do Amazon SNS
<a name="sam-specification-generated-resources-function-sns-onsuccess"></a>

Quando a propriedade `OnSuccess` (ou`OnFailure`) da `DestinationConfig` propriedade da `EventInvokeConfig` propriedade de an `AWS::Serverless::Function` é especificada e o tipo de destino é, `SNS` mas o ARN de destino *não* está especificado, AWS SAM gera os seguintes CloudFormation recursos: e. `AWS::Lambda::EventInvokeConfig` `AWS::SNS::Topic`

**`AWS::Lambda::EventInvokeConfig`**  
*`LogicalId`: *`<function‑LogicalId>EventInvokeConfig`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

**`AWS::SNS::Topic`**  
*`LogicalId`: *`<function‑LogicalId>OnSuccessTopic` (ou `<function‑LogicalId>OnFailureTopic`)  
*Propriedade referenciável:* `<function‑LogicalId>.DestinationTopic`  
Se ambos `OnSuccess` e `OnFailure` forem especificados para um evento do Amazon SNS, para distinguir entre os recursos gerados, você deverá usar o `LogicalId`.

### OnSuccess (ou OnFailure) a propriedade é especificada para eventos do Amazon SQS
<a name="sam-specification-generated-resources-function-sqs-onsuccess"></a>

Quando a propriedade `OnSuccess` (ou`OnFailure`) da `DestinationConfig` propriedade da `EventInvokeConfig` propriedade de an `AWS::Serverless::Function` é especificada e o tipo de destino é, `SQS` mas o ARN de destino *não* está especificado, AWS SAM gera os seguintes CloudFormation recursos: e. `AWS::Lambda::EventInvokeConfig` `AWS::SQS::Queue`

**`AWS::Lambda::EventInvokeConfig`**  
*`LogicalId`: *`<function‑LogicalId>EventInvokeConfig`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

**`AWS::SQS::Queue`**  
*`LogicalId`: *`<function‑LogicalId>OnSuccessQueue` (ou `<function‑LogicalId>OnFailureQueue`)  
*Propriedade referenciável:* `<function‑LogicalId>.DestinationQueue`  
Se ambos `OnSuccess` e `OnFailure` forem especificados para um evento do Amazon SQS, para distinguir entre os recursos gerados, você deverá usar o `LogicalId`.

# CloudFormation recursos gerados quando AWS::Serverless::GraphQLApi é especificado
<a name="sam-specification-generated-resources-graphqlapi"></a>

Quando você especifica um `AWS::Serverless::GraphQLApi` recurso em um modelo AWS Serverless Application Model (AWS SAM), AWS SAM sempre cria os seguintes AWS CloudFormation recursos básicos.

**`AWS::AppSync::DataSource`**  
*`LogicalId`: *`<graphqlapi-LogicalId><datasource-RelativeId><datasource-Type>DataSource`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

**`AWS::AppSync::FunctionConfiguration`**  
*`LogicalId`: *`<graphqlapi-LogicalId><function-RelativeId>`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

**`AWS::AppSync::GraphQLApi`**  
*`LogicalId`: *`<graphqlapi-LogicalId>`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

**`AWS::AppSync::GraphQLSchema`**  
*`LogicalId`: *`<graphqlapi-LogicalId>Schema`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

**`AWS::AppSync::Resolver`**  
*`LogicalId`: *`<graphqlapi-LogicalId><OperationType><resolver-RelativeId>`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

Além desses CloudFormation recursos, quando `AWS::Serverless::GraphQLApi` especificado, também AWS SAM pode gerar os seguintes CloudFormation recursos.

`AWS::AppSync::ApiCache`  
*`LogicalId`: *`<graphqlapi-LogicalId>ApiCache`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

`AWS::AppSync::ApiKey`  
*`LogicalId`: *`<graphqlapi-LogicalId><apikey-RelativeId>`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

`AWS::AppSync::DomainName`  
*`LogicalId`: *`<graphqlapi-LogicalId>DomainName`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

`AWS::AppSync::DomainNameApiAssociation`  
*`LogicalId`: *`<graphqlapi-LogicalId>DomainNameApiAssociation`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

AWS SAM também pode usar o `AWS::Serverless::Connector` recurso para provisionar permissões. Para obter mais informações, consulte [CloudFormation recursos gerados quando você especifica AWS::Serverless::Connector](sam-specification-generated-resources-connector.md).

# CloudFormation recursos gerados quando AWS::Serverless::HttpApi é especificado
<a name="sam-specification-generated-resources-httpapi"></a>

Quando um `AWS::Serverless::HttpApi` é especificado, AWS Serverless Application Model (AWS SAM) gera um CloudFormation recurso `AWS::ApiGatewayV2::Api` básico.

**`AWS::ApiGatewayV2::Api`**  
*`LogicalId`: *`<httpapi‑LogicalId>`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

Além desse CloudFormation recurso, quando `AWS::Serverless::HttpApi` especificado, AWS SAM também gera CloudFormation recursos para os seguintes cenários:

**Topics**
+ [

## StageName propriedade é especificada
](#sam-specification-generated-resources-httpapi-stage-name)
+ [

## StageName propriedade *não* é especificada
](#sam-specification-generated-resources-httpapi-not-stage-name)
+ [

## DomainName propriedade é especificada
](#sam-specification-generated-resources-httpapi-domain-name)

## StageName propriedade é especificada
<a name="sam-specification-generated-resources-httpapi-stage-name"></a>

Quando a `StageName` propriedade de um `AWS::Serverless::HttpApi` é especificada, AWS SAM gera o `AWS::ApiGatewayV2::Stage` CloudFormation recurso.

**`AWS::ApiGatewayV2::Stage`**  
*`LogicalId`: *`<httpapi‑LogicalId><stage‑name>Stage`  
`<stage‑name>` é a string para a qual a propriedade `StageName` está definida. Por exemplo, se você `StageName` definir como`Gamma`, `LogicalId` é: *MyHttpApiGamma* Estágio.  
*Propriedade referenciável:* `<httpapi‑LogicalId>.Stage`

## StageName propriedade *não* é especificada
<a name="sam-specification-generated-resources-httpapi-not-stage-name"></a>

Quando a `StageName` propriedade de um *não `AWS::Serverless::HttpApi`* é especificada, AWS SAM gera o `AWS::ApiGatewayV2::Stage` CloudFormation recurso.

**`AWS::ApiGatewayV2::Stage`**  
*`LogicalId`: *`<httpapi‑LogicalId>ApiGatewayDefaultStage`  
*Propriedade referenciável:* `<httpapi‑LogicalId>.Stage`

## DomainName propriedade é especificada
<a name="sam-specification-generated-resources-httpapi-domain-name"></a>

Quando a `DomainName` propriedade da `Domain` propriedade de an `AWS::Serverless::HttpApi` é especificada, AWS SAM gera o `AWS::ApiGatewayV2::DomainName` CloudFormation recurso.

**`AWS::ApiGatewayV2::DomainName`**  
*`LogicalId`: *`ApiGatewayDomainNameV2<sha>`  
O `<sha>` é um valor de hash exclusivo que é gerado quando a pilha é criada. Por exemplo, `ApiGatewayDomainNameV2`*926eeb5ff1*.  
*Propriedade referenciável:* `<httpapi‑LogicalId>.DomainName`

# CloudFormation recursos gerados quando AWS::Serverless::LayerVersion é especificado
<a name="sam-specification-generated-resources-layerversion"></a>

Quando um `AWS::Serverless::LayerVersion` é especificado, AWS Serverless Application Model (AWS SAM) gera um CloudFormation recurso `AWS::Lambda::LayerVersion` básico.

**`AWS::Lambda::LayerVersion`**  
*`LogicalId`: *`<layerversion‑LogicalId>`   
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

# CloudFormation recursos gerados quando AWS::Serverless::SimpleTable é especificado
<a name="sam-specification-generated-resources-simpletable"></a>

Quando um `AWS::Serverless::SimpleTable` é especificado, AWS Serverless Application Model (AWS SAM) gera um CloudFormation recurso `AWS::DynamoDB::Table` básico.

**`AWS::DynamoDB::Table`**  
*`LogicalId`: *`<simpletable‑LogicalId>`   
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

# CloudFormation recursos gerados quando AWS::Serverless::StateMachine é especificado
<a name="sam-specification-generated-resources-statemachine"></a>

Quando um `AWS::Serverless::StateMachine` é especificado, AWS Serverless Application Model (AWS SAM) gera um recurso `AWS::StepFunctions::StateMachine` com base CloudFormation .

**`AWS::StepFunctions::StateMachine`**  
*`LogicalId`: *`<statemachine‑LogicalId>`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

Além desse CloudFormation recurso, quando `AWS::Serverless::StateMachine` especificado, AWS SAM também gera CloudFormation recursos para os seguintes cenários:

**Topics**
+ [

## A propriedade da função não foi especificada
](#sam-specification-generated-resources-statemachine-not-role)
+ [

## Uma origem de eventos de API é especificada
](#sam-specification-generated-resources-statemachine-api)
+ [

## Uma fonte de eventos de ponte de eventos (ou barramento de eventos) é especificada
](#sam-specification-generated-resources-statemachine-eventbridge)

## A propriedade da função não foi especificada
<a name="sam-specification-generated-resources-statemachine-not-role"></a>

Quando a `Role` propriedade de um *não `AWS::Serverless::StateMachine`* é especificada, AWS SAM gera um `AWS::IAM::Role` CloudFormation recurso.

**`AWS::IAM::Role`**  
*`LogicalId`: *`<statemachine‑LogicalId>Role`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

## Uma origem de eventos de API é especificada
<a name="sam-specification-generated-resources-statemachine-api"></a>

Quando a `Event` propriedade de um `AWS::Serverless::StateMachine` é definida como`Api`, mas a `RestApiId` propriedade *não* é especificada, AWS SAM gera o `AWS::ApiGateway::RestApi` CloudFormation recurso.

**`AWS::ApiGateway::RestApi`**  
*`LogicalId`: *`ServerlessRestApi`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation 

## Uma fonte de eventos de ponte de eventos (ou barramento de eventos) é especificada
<a name="sam-specification-generated-resources-statemachine-eventbridge"></a>

Quando a `Event` propriedade de an `AWS::Serverless::StateMachine` é definida como um dos tipos de ponte de eventos (ou barramento de eventos), AWS SAM gera o `AWS::Events::Rule` CloudFormation recurso. Isso se aplica aos seguintes tipos: `EventBridgeRule`, `Schedule` e `CloudWatchEvents`.

**`AWS::Events::Rule`**  
*`LogicalId`: *`<statemachine‑LogicalId><event‑LogicalId>`  
*Propriedade referenciável:* N/A (você deve usar o `LogicalId` para referenciar este recurso) CloudFormation