AWS CloudFormationRecursos generados

Cuando AWS Serverless Application Model (AWS SAM) procesa el archivo AWS SAM de plantilla, genera uno o más AWS CloudFormation recursos. 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 AWS SAM recursos y propiedades especificadas en el archivo de plantilla. Puedes hacer referencia a AWS CloudFormation los recursos generados en cualquier parte del archivo de plantilla, de forma similar a como haces referencia a los recursos que declaras explícitamente en tu archivo de plantilla.

Por ejemplo, si especificas un AWS::Serverless::Function recurso en el archivo AWS SAM de plantilla, AWS SAM siempre generará un recurso AWS::Lambda::Function base. Si también especifica la AutoPublishAlias propiedad opcional, AWS SAM genera AWS::Lambda::Alias AWS::Lambda::Version recursos 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 AWS SAM de plantilla.

Hacer referencia a los recursos generados AWS CloudFormation

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

Hacer referencia a AWS CloudFormation los recursos generados por LogicalId

Cada uno de los AWS CloudFormation recursos que AWS SAM genera tiene un LogicalId identificador alfanumérico (A-Z, a-z, 0-9) que es único en un archivo de plantilla. AWS SAMutiliza los AWS SAM recursos LogicalIds del archivo de plantilla para crear LogicalIds los AWS CloudFormation recursos que genera. Puede utilizar el LogicalId AWS CloudFormation recurso generado para acceder a las propiedades de ese recurso dentro del archivo de plantilla, tal como 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 de la Guía del AWS CloudFormation usuario.

nota

Algunos recursos generados incluyen un valor LogicalIds de hash único para evitar conflictos entre espacios de nombres. Estos recursos se derivan cuando se crea la pila. LogicalIds Solo puede recuperarlos después de crear la pila con el AWS Management Console SDK o uno de los AWS SDK. AWS CLI No recomendamos hacer referencia a estos recursos LogicalId porque los valores de hash pueden cambiar.

Hacer referencia a AWS CloudFormation los recursos generados por propiedad referenciable

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

nota

No todos los AWS CloudFormation recursos generados tienen propiedades referenciables. Para esos recursos, debe utilizar elLogicalId.

Escenarios AWS CloudFormation de recursos generados

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.

Recurso de AWS SAM	AWS CloudFormationRecurso base	Escenarios
AWS::Serverless::Api	AWS::ApiGateway::RestApi	Se especifica la propiedad domainName Se especifica la propiedad UsagePlan
AWS:: Serverless:: Aplicación	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	Se especifica la propiedad AutoPublishAlias No se ha especificado la propiedad de rol Se especifica la propiedad DeploymentPreference Se especifica un origen de eventos Api Se especifica un origen de eventos HttpAPI Se especifica un origen de eventos de streaming Se especifica un origen de eventos de puente de eventos (o bus de eventos) Se especifica un origen de eventos de IoTrule La propiedad onSuccess (o onFailure) se especifica para eventos de Amazon SNS La propiedad onSuccess (o onFailure) se especifica para eventos de Amazon SQS
AWS::Serverless::HttpApi	AWS::ApiGatewayV2::Api	Se especifica la propiedad StageName La propiedad StageName esnoespecificado Se especifica la propiedad domainName
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	No se ha especificado la propiedad de rol Se especifica un origen de eventos Api Se especifica un origen de eventos de puente de eventos (o bus de eventos)

Temas

• AWS CloudFormationrecursos generados cuando se especifica AWS:: Serverless:: Api
• AWS CloudFormationrecursos generados cuando se especifica AWS:: Serverless:: Application
• AWS CloudFormationrecursos generados al especificarAWS::Serverless::Connector
• AWS CloudFormationrecursos generados cuandoAWS::Serverless::Functionse especifica
• AWS CloudFormationrecursos generados cuandoAWS::Serverless::GraphQLApiestá especificado
• AWS CloudFormationrecursos generados cuando se especifica AWS:: Serverless:: HttpApi
• AWS CloudFormationrecursos generados cuandoAWS::Serverless::LayerVersionse especifica
• AWS CloudFormationrecursos generados cuandoAWS::Serverless::SimpleTablese especifica
• AWS CloudFormationrecursos generados cuandoAWS::Serverless::StateMachinese especifica