Recursos de AWS CloudFormation generados

Cuando AWS Serverless Application Model (AWS SAM) procesa su archivo de plantilla de AWS SAM, genera uno o más recursos de AWS CloudFormation. El conjunto de recursos de AWS CloudFormation que AWS SAM genera varía según los escenarios que especifique. Un escenario es la combinación de recursos y propiedades de AWS SAM especificada en el archivo de plantilla. Puede hacer referencia a los recursos de AWS CloudFormation generados en otros lugares del archivo de plantilla, de forma similar a como hace referencia a los recursos que declara explícitamente en el archivo de plantilla.

Por ejemplo, si especifica un recurso de AWS::Serverless::Function en el archivo de plantillas de AWS SAM, AWS SAM siempre generará un recurso base AWS::Lambda::Function. Si también especifica la propiedad AutoPublishAlias opcional, AWS SAM también generará recursos AWS::Lambda::Alias y AWS::Lambda::Version.

En esta sección se enumeran los escenarios y los recursos de AWS CloudFormation que generan, y se muestra cómo hacer referencia a los recursos de AWS CloudFormation generados en el archivo de plantillas de AWS SAM.

Hacer referencia a los recursos de AWS CloudFormation generados.

Tiene dos opciones para hacer referencia a los recursos de AWS CloudFormation generados en su archivo de plantillas de AWS SAM: por LogicalId o por propiedad referenciable.

Hacer referencia a AWS CloudFormation los recursos generados por LogicalId

Los recursos de AWS CloudFormation que genera AWS SAM tienen un LogicalId cada uno, que es un identificador alfanumérico (A-Z, a-z, 0-9) que es único dentro de un archivo de plantilla. AWS SAM utiliza los LogicalIds de los recursos de AWS SAM del archivo plantilla para construir los LogicalIds de los recursos de AWS CloudFormation que genera. Puede usar el LogicalId de un recurso de AWS CloudFormation generado para acceder a las propiedades de ese recurso dentro de su archivo de plantilla, del mismo modo que lo haría con un recurso de AWS CloudFormation que haya declarado explícitamente. Para más información sobre LogicalIds en plantillas de AWS CloudFormation y AWS SAM, consulte Recursos en la Guía del usuario de AWS CloudFormation.

nota

Algunos LogicalIds de los recursos generados incluyen un valor hash único para evitar conflictos con los espacios de los nombres. Los LogicalIds de estos recursos se obtienen cuando se crea la pila. Puede recuperarlos solo después de haber creado la pila con la AWS Management Console, la AWS CLI, o uno de los SDK de AWS. No recomendamos referenciar estos recursos con LogicalId porque los valores hash pueden cambiar.

Referenciado de los recursos de AWS CloudFormation generados por propiedad referenciable

Para algunos recursos generados, AWS SAM proporciona una propiedad referenciable del recurso de AWS SAM. Puede utilizar esta propiedad para referenciar un recurso de AWS CloudFormation generado y sus propiedades en el archivo plantilla de AWS SAM.

nota

No todos los recursos de AWS CloudFormation generados tienen propiedades referenciables. Para dichos recursos, debe utilizar los LogicalId.

Escenarios de recursos de AWS CloudFormation generados

En la siguiente tabla se resumen los recursos y las propiedades de AWS SAM que componen los escenarios que generan recursos de AWS CloudFormation. Los temas de la columna Escenarios proporcionan detalles sobre los recursos de AWS CloudFormation adicionales que genera AWS SAM para ese escenario.

Recurso de AWS SAM	Recurso de AWS CloudFormation base	Escenarios
AWS::Serverless::Api	AWS::ApiGateway::RestApi	DomainNamese especifica la propiedad UsagePlanse especifica la propiedad
AWS::Serverless::Application	AWS::CloudFormation::Stack	Además de generar el recurso de AWS CloudFormation base, no hay escenarios adicionales para este recurso sin servidor.
AWS::Serverless::Function	AWS::Lambda::Function	AutoPublishAlias se especifica la propiedad La propiedad del rol no está especificada DeploymentPreference se especifica la propiedad Se ha especificado una fuente de eventos de API Se ha especificado un origen de HttpApi eventos Se ha especificado una origen de eventos de transmisión Se ha especificado una origen de eventos de puente de eventos (o bus de eventos) Se ha especificado un origen de IotRule eventos OnSuccess(o OnFailure) la propiedad está especificada para los eventos de Amazon SNS OnSuccess(o OnFailure) la propiedad está especificada para los eventos de Amazon SQS
AWS::Serverless::HttpApi	AWS::ApiGatewayV2::Api	Se ha especificado la propiedad Stagename No se ha especificado la propiedad Stagename Se ha especificado la propiedad DomainName
AWS::Serverless::LayerVersion	AWS::Lambda::LayerVersion	Además de generar el recurso de AWS CloudFormation base, no hay escenarios adicionales para este recurso sin servidor.
AWS::Serverless::SimpleTable	AWS::DynamoDB::Table	Además de generar el recurso de AWS CloudFormation base, no hay escenarios adicionales para este recurso sin servidor.
AWS::Serverless::StateMachine	AWS::StepFunctions::StateMachine	La propiedad del rol no está especificada Se ha especificado una fuente de eventos de API Se ha especificado una origen de eventos de puente de eventos (o bus de eventos)

Temas

• Recursos de AWS CloudFormation generados cuando se especifica AWS::Serverless::Api
• AWS CloudFormation recursos generados cuando se especifica AWS::Serverless::Application
• AWS CloudFormation recursos generados cuando se especifica AWS::Serverless::Connector
• Recursos de AWS CloudFormation generados cuando se especifica AWS::Serverless::Function
• Recursos de AWS CloudFormation generados cuando se especifica AWS::Serverless::GraphQLApi
• AWS CloudFormation recursos generados cuando se especifica AWS::Serverless::HttpApi
• AWS CloudFormation recursos generados cuando se especifica AWS::Serverless::LayerVersion
• AWS CloudFormation recursos generados cuando se especifica AWS::Serverless::SimpleTable
• AWS CloudFormation recursos generados cuando se especifica AWS::Serverless::StateMachine