Sumber daya AWS CloudFormation yang dibuat

Saat AWS Serverless Application Model (AWS SAM) memproses file templat AWS SAM, itu membuat satu atau lebih sumber daya AWS CloudFormation. Kumpulan sumber daya AWS CloudFormation yang dibuat AWS SAM tidak sama tergantung pada skenario yang Anda tentukan. Skenario adalah kombinasi dari sumber daya AWS SAM dan properti yang ditentukan dalam file templat Anda. Anda dapat mereferensikan sumber daya AWS CloudFormation yang dibuat di tempat lain dalam file templat Anda, mirip dengan cara Anda mereferensikan sumber daya yang Anda deklarasikan secara eksplisit dalam file templat Anda.

Misalnya, jika Anda menentukan sumber daya AWS::Serverless::Function di file templat AWS SAM Anda, AWS SAM selalu membuat sebuah sumber daya dasar AWS::Lambda::Function. Jika Anda juga menentukan properti AutoPublishAlias opsional, AWS SAM juga membuat sumber daya AWS::Lambda::Alias dan AWS::Lambda::Version.

Bagian ini berisi daftar skenario dan sumber daya AWS CloudFormation yang mereka buat, dan menunjukkan cara mereferensikan sumber daya AWS CloudFormation yang dibuat di file templat AWS SAM Anda.

Mereferensikan sumber daya AWS CloudFormation yang dibuat

Anda mempunyai dua pilihan untuk mereferensikan sumber daya AWS CloudFormation yang dibuat di dalam file templat AWS SAM Anda, dengan LogicalId atau dengan properti yang direferensikan.

Referensi AWS CloudFormation sumber daya yang dihasilkan oleh LogicalId

Sumber daya AWS CloudFormation yang dibuat AWS SAM masing-masing mempunyai LogicalId, yang merupakan pengidentifikasi alfanumerik (A-Z, a-z, 0-9) yang unik dalam file templat. AWS SAM menggunakan LogicalIds dari sumber daya AWS SAM dalam file templat Anda untuk membangun LogicalIds dari sumber daya AWS CloudFormation yang dibuat. Anda dapat menggunakan LogicalId dari sumber daya AWS CloudFormation yang dibuat untuk mengakses properti dari sumber daya tersebut dalam file templat Anda, seperti yang Anda lakukan untuk sumber daya AWS CloudFormation yang telah Anda nyatakan secara eksplisit. Untuk informasi selengkapnya tentang LogicalIds dalam AWS CloudFormation serta templat AWS SAM, lihat Sumber Daya di Panduan Pengguna AWS CloudFormation.

catatan

Parameter LogicalIds dari beberapa sumber daya yang dibuat mencakup nilai hash unik untuk menghindari konflik namespace. Parameter LogicalIds dari sumber daya ini berasal ketika tumpukan dibuat. Anda dapat mengambil mereka hanya setelah tumpukan telah dibuat menggunakan AWS Management Console, AWS CLI, atau salah satu dari AWS SDK. Kami tidak menyarankan mereferensikan sumber daya ini dengan LogicalId karena nilai hash mungkin berubah.

Mereferensikan sumber daya AWS CloudFormation yang dibuat dengan properti yang dapat direferensikan

Untuk beberapa sumber daya yang dibuat, AWS SAM menyediakan properti yang dapat direferensikan dari sumber daya AWS SAM. Anda dapat menggunakan properti ini untuk referensi sebuah sumber daya AWS CloudFormation yang dibuat dan propertinya dalam file templat AWS SAM.

catatan

Tidak semua sumber daya AWS CloudFormation yang dibuat memiliki properti yang dapat direferensikan. Untuk sumber daya tersebut, Anda harus menggunakan LogicalId.

Skenario sumber daya AWS CloudFormation yang dibuat

Tabel berikut merangkum sumber daya dan properti AWS SAM yang membentuk skenario yang membuat sumber daya AWS CloudFormation. Topik dalam kolom Skenario memberikan detail tentang sumber daya AWS CloudFormation tambahan yang dibuat AWS SAM untuk skenario tersebut.

Sumber daya AWS SAM	Sumber daya AWS CloudFormation dasar	Skenario
AWS::Serverless::Api	AWS::ApiGateway::RestApi	DomainNameproperti ditentukan UsagePlanproperti ditentukan
AWS::Serverless::Application	AWS::CloudFormation::Stack	Selain membuat sumber daya AWS CloudFormation dasar, tidak ada skenario tambahan untuk sumber daya nirserver ini.
AWS::Serverless::Function	AWS::Lambda::Function	AutoPublishAlias properti ditentukan Properti peran tidak ditentukan DeploymentPreference properti ditentukan Sumber peristiwa Api ditentukan Sumber HttpApi acara ditentukan Sumber peristiwa streaming ditentukan Sumber event bridge (atau bus peristiwa) ditentukan Sumber IotRule acara ditentukan OnSuccess(atau OnFailure) properti ditentukan untuk acara Amazon SNS OnSuccess(atau OnFailure) properti ditentukan untuk peristiwa Amazon SQS
AWS::Serverless::HttpApi	AWS::ApiGatewayV2::Api	Properti StageName ditentukan Properti StageNametidakditentukan Properti DomainName ditentukan
AWS::Serverless::LayerVersion	AWS::Lambda::LayerVersion	Selain membuat sumber daya AWS CloudFormation dasar, tidak ada skenario tambahan untuk sumber daya nirserver ini.
AWS::Serverless::SimpleTable	AWS::DynamoDB::Table	Selain membuat sumber daya AWS CloudFormation dasar, tidak ada skenario tambahan untuk sumber daya nirserver ini.
AWS::Serverless::StateMachine	AWS::StepFunctions::StateMachine	Properti peran tidak ditentukan Sumber peristiwa Api ditentukan Sumber event bridge (atau bus peristiwa) ditentukan

Topik

• AWS CloudFormationsumber daya yang dihasilkan saat AWS::Serverless::Api ditentukan
• Sumber daya AWS CloudFormation dihasilkan ketika AWS::Serverless::Application ditentukan
• AWS CloudFormationsumber daya yang dihasilkan saat Anda menentukan AWS::Serverless::Connector
• AWS CloudFormationsumber daya yang dihasilkan saat AWS::Serverless::Function ditentukan
• AWS CloudFormationsumber daya yang dihasilkan saat AWS::Serverless::GraphQLApi ditentukan
• Sumber daya AWS CloudFormation dibuat ketika AWS::Serverless::HttpApi ditentukan
• AWS CloudFormationsumber daya yang dihasilkan saatAWS::Serverless::LayerVersionditentukan
• AWS CloudFormationsumber daya yang dihasilkan saatAWS::Serverless::SimpleTableditentukan
• AWS CloudFormationsumber daya yang dibuat saatAWS::Serverless::StateMachineditentukan