AWS CloudFormation Recursos generados para AWS SAM

En esta sección se proporcionan detalles sobre los AWS CloudFormation recursos que se crean al AWS SAM procesar la AWS plantilla. El conjunto de AWS CloudFormation recursos que se 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 AutoPublishAlias propiedad opcional, generará AWS::Lambda::Alias AWS::Lambda::Version recursos AWS SAM adicionales.

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

Hacer referencia a los recursos de AWS CloudFormation generados.

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

Hacer referencia a los recursos generados mediante AWS CloudFormation LogicalId

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

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 AWS Management Console, AWS CLI, o una de las AWS SDKs. No recomendamos referenciar estos recursos con LogicalId porque los valores hash pueden cambiar.

Hacer referencia a AWS CloudFormation los recursos generados mediante una propiedad referenciable

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

nota

No todos los AWS CloudFormation recursos generados tienen propiedades a las que se puede hacer referencia. Para dichos recursos, debe utilizar los LogicalId.

Escenarios de recursos generados AWS CloudFormation

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

AWS SAM recurso	AWS CloudFormation Recurso 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 AWS CloudFormation recurso 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 una fuente 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 una fuente 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	StageNamese especifica la propiedad StageNamela propiedad no está especificada DomainNamese especifica la propiedad
AWS::Serverless::LayerVersion	AWS::Lambda::LayerVersion	Además de generar el AWS CloudFormation recurso base, no hay escenarios adicionales para este recurso sin servidor.
AWS::Serverless::SimpleTable	AWS::DynamoDB::Table	Además de generar el AWS CloudFormation recurso 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 un origen de eventos de API Se ha especificado una origen de eventos de puente de eventos (o bus de eventos)

Temas

• AWS CloudFormation recursos generados cuando AWS::Serverless::Api se especifica

• AWS CloudFormation recursos generados cuando AWS::Serverless::Application se especifica

• AWS CloudFormation recursos generados al especificar AWS::Serverless::Connector

• AWS CloudFormation recursos generados cuando AWS::Serverless::Function se especifica

• AWS CloudFormation recursos generados cuando AWS::Serverless::GraphQLApi se especifica

• AWS CloudFormation recursos generados cuando AWS::Serverless::HttpApi se especifica

• AWS CloudFormation recursos generados cuando AWS::Serverless::LayerVersion se especifica

• AWS CloudFormation recursos generados cuando AWS::Serverless::SimpleTable se especifica

• AWS CloudFormation recursos generados cuando AWS::Serverless::StateMachine se especifica