AWS CloudFormation Recursos gerados

Esta seção fornece detalhes sobre os AWS CloudFormation recursos que são criados ao AWS SAM processar seu AWS modelo. O conjunto de AWS 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 AWS 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 AWS CloudFormation recursos que eles geram e mostra como referenciar os AWS CloudFormation recursos gerados em seu arquivo AWS SAM de modelo.

Referenciando recursos gerados AWS CloudFormation

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

Referenciando AWS CloudFormation recursos gerados por LogicalId

Os AWS CloudFormation recursos que AWS SAM geram cada um têm umLogicalId, 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 AWS CloudFormation recursos que ele gera. Você pode usar o LogicalId de um AWS CloudFormation recurso gerado para acessar as propriedades desse recurso em seu arquivo de modelo, assim como faria com um AWS CloudFormation recurso que você declarou explicitamente. Para obter mais informações sobre LogicalIds em AWS CloudFormation e AWS SAM modelos, consulte Recursos 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 AWS Management Console, AWS CLI, ou um dos AWS SDKs. Não recomendamos referenciar esses recursos LogicalId porque os valores de hash podem mudar.

Referenciando AWS CloudFormation recursos gerados por propriedade referenciável

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

nota

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

Cenários AWS CloudFormation de recursos gerados

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

AWS SAM recurso	AWS CloudFormation Recurso básico	Cenários
AWS::Serverless::Api	AWS::ApiGateway::RestApi	DomainNamepropriedade é especificada UsagePlanpropriedade é especificada
AWS::Serverless::Application	AWS::CloudFormation::Stack	Além de gerar o AWS CloudFormation recurso básico, não há cenários adicionais para esse recurso sem servidor.
AWS::Serverless::Function	AWS::Lambda::Function	AutoPublishAlias propriedade é especificada A propriedade da função não foi especificada DeploymentPreference propriedade é especificada Uma fonte de eventos da Api é especificada Uma fonte de HttpApi eventos é especificada Uma fonte de eventos de streaming é especificada Uma fonte de eventos de ponte de eventos (ou barramento de eventos) é especificada Uma fonte de IotRule eventos é especificada OnSuccess(ou OnFailure) a propriedade é especificada para eventos do Amazon SNS OnSuccess(ou OnFailure) a propriedade é especificada para eventos do Amazon SQS
AWS::Serverless::HttpApi	AWS::ApiGatewayV2::Api	StageNamepropriedade é especificada StageNamepropriedade não é especificada DomainNamepropriedade é especificada
AWS::Serverless::LayerVersion	AWS::Lambda::LayerVersion	Além de gerar o AWS CloudFormation recurso básico, não há cenários adicionais para esse recurso sem servidor.
AWS::Serverless::SimpleTable	AWS::DynamoDB::Table	Além de gerar o AWS CloudFormation recurso básico, não há cenários adicionais para esse recurso sem servidor.
AWS::Serverless::StateMachine	AWS::StepFunctions::StateMachine	A propriedade da função não foi especificada Uma fonte de eventos de API é especificada Uma fonte de eventos de ponte de eventos (ou barramento de eventos) é especificada

Tópicos

• AWS CloudFormation recursos gerados quando AWS::Serverless::Api é especificado
• AWS CloudFormation recursos gerados quando AWS::Serverless::Application é especificado
• Os recursos AWS CloudFormation gerados quando você especifica AWS::Serverless::Connector
• AWS CloudFormation recursos gerados quando AWS::Serverless::Function é especificado
• AWS CloudFormation recursos gerados quando AWS::Serverless::GraphQLApi é especificado
• AWS CloudFormation recursos gerados quando AWS::Serverless::HttpApi é especificado
• AWS CloudFormation recursos gerados quando AWS::Serverless::LayerVersion é especificado
• AWS CloudFormation recursos gerados quando AWS::Serverless::SimpleTable é especificado
• AWS CloudFormation recursos gerados quando AWS::Serverless::StateMachine é especificado