AWS CloudFormationRisorse generate

QuandoAWS Serverless Application Model (AWS SAM) elabora il fileAWS SAM modello, genera una o piùAWS CloudFormation risorse. Il set diAWS CloudFormation risorseAWS SAM generato varia a seconda degli scenari specificati. Uno scenario è la combinazione diAWS SAM risorse e proprietà specificate nel file modello. Puoi fare riferimento alleAWS CloudFormation risorse generate altrove all'interno del file modello, in modo simile a come fai riferimento alle risorse dichiarate esplicitamente nel file modello.

Ad esempio, se si specifica unaAWS::Serverless::Function risorsa nel fileAWS SAM modello, generaAWS SAM sempre una risorsa diAWS::Lambda::Function base. Se si specifica anche laAutoPublishAlias proprietà opzionale, generaAWS SAMAWS::Lambda::Alias inoltreAWS::Lambda::Version risorse.

Questa sezione elenca gli scenari e leAWS CloudFormation risorse che generano e mostra come fare riferimento alleAWS CloudFormation risorse generate nel fileAWS SAM modello.

Riferimento alleAWS CloudFormation risorse generate

Sono disponibili due opzioni per fare riferimentoAWS CloudFormation alle risorse generate all'interno del fileAWS SAM modello, tramiteLogicalId o tramite proprietà referenziabile.

Riferimento alleAWS CloudFormation risorse generate da LogicalId

LeAWS CloudFormation risorse presentiAWS SAM presenti hanno unLogicalId identificatore alfanumerico (A-Z, a-z, 0-9) univoco all'interno di un file modello. AWS SAMutilizza leAWS SAM risorseLogicalIds del file modello per costruireLogicalIds leAWS CloudFormation risorse che genera. Puoi utilizzare il valoreLogicalId di unaAWS CloudFormation risorsa generata per accedere alle proprietà di quella risorsa all'interno del tuo file modello, proprio come faresti per unaAWS CloudFormation risorsa che hai dichiarato esplicitamente. Per ulteriori informazioni suLogicalIds inAWS CloudFormation eAWS SAM modelli, consulta Risorse nella Guida per l'AWS CloudFormationutente.

Nota

AlcuneLogicalIds delle risorse generate includono un valore hash univoco per evitare conflitti tra i namespace. Queste risorse vengono derivate quando viene creato lo stack.LogicalIds È possibile recuperarli solo dopo aver creato lo stack utilizzandoAWS Management ConsoleAWS CLI, o uno degliAWS SDK. Non consigliamo di fare riferimento a queste risorseLogicalId perché i valori hash potrebbero cambiare.

RiferimentoAWS CloudFormation alle risorse generate tramite proprietà referenziabili

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

Nota

Non tutte leAWS CloudFormation risorse generate hanno proprietà referenziabili. Per queste risorse, è necessario utilizzare ilLogicalId.

Scenari diAWS CloudFormation risorse generate

La tabella seguente riassume leAWS SAM risorse e le proprietà che costituiscono gli scenari che generanoAWS CloudFormation risorse. Gli argomenti della colonna Scenari forniscono dettagli sulleAWS CloudFormation risorse aggiuntiveAWS SAM generate per tale scenario.

Risorsa AWS SAM	AWS CloudFormationRisorsa base	Scenari
AWS::Serverless::Api	AWS::ApiGateway::RestApi	Viene specificata la proprietà DomainName È specificata la proprietà UsagePlan
AWS። Serverless። Applicazione	AWS::CloudFormation::Stack	Oltre alla generazione dellaAWS CloudFormation risorsa di base, non esistono scenari aggiuntivi per questa risorsa serverless.
AWS::Serverless::Function	AWS::Lambda::Function	La proprietà AutoPublishAlias è specificata La proprietà Role non è specificata È specificata la proprietà DeploymentPreference Viene specificata un'origine evento Api Viene specificata un'origine evento HttpAPI Viene specificata una fonte di eventi in streaming Viene specificata un'origine evento bridge (o bus eventi) Viene specificata un'origine evento IotRule La proprietà onSuccess (o onFailure) è specificata per gli eventi Amazon SNS La proprietà onSuccess (o onFailure) è 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 dellaAWS CloudFormation risorsa di base, non esistono scenari aggiuntivi per questa risorsa serverless.
AWS::Serverless::SimpleTable	AWS::DynamoDB::Table	Oltre alla generazione dellaAWS 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 viene specificato AWS። Serverless። Api
• AWS CloudFormationrisorse generate quando AWS። Serverless። Application
• AWS CloudFormationrisorse generate quando si specificaAWS::Serverless::Connector
• AWS CloudFormationrisorse generate quandoAWS::Serverless::Functionspecificato
• 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