AWS CloudFormationRisorse generate

Quando AWS Serverless Application Model (AWS SAM) elabora il file AWS SAM modello, genera una o più AWS CloudFormation risorse. L'insieme di AWS CloudFormation risorse che AWS SAM genera varia a seconda degli scenari specificati. Uno scenario è la combinazione di AWS SAM risorse e proprietà specificata nel file modello. È possibile fare riferimento alle AWS CloudFormation risorse generate altrove all'interno del file modello, in modo analogo a come si fa riferimento alle risorse dichiarate esplicitamente nel file modello.

Ad esempio, se specifichi una AWS::Serverless::Function risorsa nel file AWS SAM modello, genera AWS SAM sempre una risorsa di AWS::Lambda::Function base. Se specificate anche la AutoPublishAlias proprietà opzionale, genera AWS::Lambda::Alias e AWS::Lambda::Version risorse AWS SAM aggiuntive.

Questa sezione elenca gli scenari e le AWS CloudFormation risorse che generano e mostra come fare riferimento alle AWS CloudFormation risorse generate nel file AWS SAM modello.

Riferimento alle risorse generate AWS CloudFormation

Sono disponibili due opzioni per fare riferimento AWS CloudFormation alle risorse generate all'interno del file AWS SAM modello, in base LogicalId o tramite proprietà referenziabili.

Fare riferimento alle risorse generate da AWS CloudFormation LogicalId

Ciascuna delle AWS CloudFormation risorse AWS SAM generate ha un LogicalId identificatore alfanumerico (A-Z, a-z, 0-9) univoco all'interno di un file modello. AWS SAMutilizza le AWS SAM risorse LogicalIds del file modello per costruire le risorse che genera. LogicalIds AWS CloudFormation Puoi utilizzare le informazioni LogicalId di una AWS CloudFormation risorsa generata per accedere alle proprietà di quella risorsa all'interno del tuo file modello, proprio come faresti per una AWS CloudFormation risorsa che hai dichiarato esplicitamente. Per ulteriori informazioni su LogicalIds in AWS CloudFormation e AWS SAM modelli, consulta Risorse nella Guida per l'AWS CloudFormationutente.

Nota

Alcune risorse generate includono un valore hash univoco per evitare conflitti tra namespace. LogicalIds Alcune LogicalIds di queste risorse vengono derivate al momento della creazione dello stack. Puoi recuperarle solo dopo aver creato lo stack utilizzando AWS Management ConsoleAWS CLI, o uno degli SDK. AWS Non è consigliabile fare riferimento a queste risorse LogicalId perché i valori hash potrebbero cambiare.

Riferimento alle AWS CloudFormation risorse generate mediante proprietà referenziabili

Per alcune risorse generate, AWS SAM fornisce una proprietà referenziabile della risorsa. AWS SAM È possibile utilizzare questa proprietà per fare riferimento a una AWS CloudFormation risorsa generata e alle relative proprietà all'interno del file AWS SAM modello.

Nota

Non tutte le AWS CloudFormation risorse generate hanno proprietà referenziabili. Per tali risorse, è necessario utilizzare. LogicalId

Scenari di AWS CloudFormation risorse generate

La tabella seguente riepiloga le AWS SAM risorse e le proprietà che costituiscono gli scenari che generano AWS CloudFormation risorse. Gli argomenti della colonna Scenari forniscono dettagli sulle AWS CloudFormation risorse aggiuntive AWS SAM generate per quello scenario.

Risorsa AWS SAM	AWS CloudFormationRisorsa di base	Scenari
AWS::Serverless::Api	AWS::ApiGateway::RestApi	DomainNamela proprietà è specificata UsagePlanla proprietà è specificata
AWS:: Serverless:: Applicazione	AWS::CloudFormation::Stack	Oltre alla generazione della AWS CloudFormation risorsa di base, non esistono scenari aggiuntivi per questa risorsa serverless.
AWS::Serverless::Function	AWS::Lambda::Function	AutoPublishAlias la proprietà è specificata La proprietà del ruolo non è specificata DeploymentPreference la proprietà è specificata Viene specificata una fonte di eventi Api Viene specificata un'origine dell'evento HttpApi Viene specificata una fonte di eventi di streaming Viene specificata una fonte di eventi Event Bridge (o Event Bus) Viene specificata un'origine dell'evento IotRule OnSuccess(o OnFailure) la proprietà è specificata per gli eventi Amazon SNS OnSuccess(o OnFailure) la proprietà è specificata per gli eventi Amazon SQS
AWS::Serverless::HttpApi	AWS::ApiGatewayV2::Api	È specificata la proprietà StageName La proprietà StageName ènonspecificato Viene specificata la proprietà DomainName
AWS::Serverless::LayerVersion	AWS::Lambda::LayerVersion	Oltre alla generazione della AWS CloudFormation risorsa di base, non esistono scenari aggiuntivi per questa risorsa serverless.
AWS::Serverless::SimpleTable	AWS::DynamoDB::Table	Oltre alla generazione della AWS CloudFormation risorsa di base, non esistono scenari aggiuntivi per questa risorsa serverless.
AWS::Serverless::StateMachine	AWS::StepFunctions::StateMachine	La proprietà Role non è specificata Viene specificata un'origine evento Api Viene specificata un'origine evento bridge (o bus eventi)

Argomenti

• AWS CloudFormationrisorse generate quando AWS::Serverless::Api è specificato
• AWS CloudFormationrisorse generate quando AWS:: Serverless:: Application
• AWS CloudFormationrisorse generate quando si specifica AWS::Serverless::Connector
• AWS CloudFormationrisorse generate quando AWS::Serverless::Function è specificato
• AWS CloudFormationrisorse generate quando AWS::Serverless::GraphQLApi è specificato
• AWS CloudFormationrisorse generate quando viene specificato AWS:: Serverless:: HttpAPI
• AWS CloudFormationrisorse generate quandoAWS::Serverless::LayerVersionspecificato
• AWS CloudFormationrisorse generate quandoAWS::Serverless::SimpleTablespecificato
• AWS CloudFormationrisorse generate quandoAWS::Serverless::StateMachinespecificato