Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Contoh dari CloudFormation perintah operasi tumpukan untuk AWS CLI dan PowerShell
Contoh baris perintah berikut menunjukkan cara melakukan individual CloudFormation tindakan dengan AWS CLI dan PowerShell. Contoh-contoh ini hanya mencakup tindakan yang paling umum digunakan. Untuk daftar lengkapnya, lihat cloudformation di AWS CLI Referensi Perintah.
Contoh-contoh dalam panduan ini menggunakan konvensi garis miring terbalik (\) untuk menunjukkan bahwa baris perintah panjang berlanjut pada baris berikutnya.
Topik
Membatalkan pembaruan tumpukan
Gunakan cancel-update-stack perintah perintah untuk membatalkan pembaruan tumpukan. Untuk informasi selengkapnya, lihat Batalkan pembaruan tumpukan.
- CLI
-
- AWS CLI
-
Untuk membatalkan pembaruan tumpukan yang sedang berlangsung
Berikut ini
cancel-update-stackcontoh membatalkan pembaruan tumpukan padamyteststacktumpukan.aws cloudformation cancel-update-stack \ --stack-namemyteststackPerintah ini tidak menghasilkan output.
Untuk informasi lebih lanjut, lihat Membatalkan pembaruan tumpukan di AWS CloudFormation Panduan Pengguna.
-
Untuk detail API, lihat CancelUpdateStack
di AWS CLI Referensi Perintah.
-
- PowerShell
-
- Alat untuk PowerShell V4
-
Contoh 1: Membatalkan pembaruan pada tumpukan yang ditentukan.
Stop-CFNUpdateStack -StackName "myStack"-
Untuk detail API, lihat CancelUpdateStack di Alat AWS untuk PowerShell Referensi Cmdlet (V4).
-
- Alat untuk PowerShell V5
-
Contoh 1: Membatalkan pembaruan pada tumpukan yang ditentukan.
Stop-CFNUpdateStack -StackName "myStack"-
Untuk detail API, lihat CancelUpdateStack di Alat AWS untuk PowerShell Referensi Cmdlet (V5).
-
Terus mengembalikan pembaruan
Gunakan continue-update-rollback perintah untuk terus memutar kembali pembaruan. Untuk informasi selengkapnya, lihat Terus mengembalikan pembaruan.
- CLI
-
- AWS CLI
-
Untuk mencoba kembali rollback pembaruan
Berikut ini
continue-update-rollbackcontoh melanjutkan operasi rollback dari pembaruan tumpukan yang sebelumnya gagal.aws cloudformation continue-update-rollback \ --stack-namemy-stackPerintah ini tidak menghasilkan output.
Untuk informasi lebih lanjut, lihat Lanjutkan memutar kembali pembaruan di AWS CloudFormation Panduan Pengguna.
-
Untuk detail API, lihat ContinueUpdateRollback
di AWS CLI Referensi Perintah.
-
- PowerShell
-
- Alat untuk PowerShell V4
-
Contoh 1: Melanjutkan rollback dari tumpukan bernama, yang seharusnya berada dalam status 'UPDATE_ROLLBACK_FAILED'. Jika rollback lanjutan berhasil, tumpukan akan masuk ke status 'UPDATE_ROLLBACK_COMPLETE'.
Resume-CFNUpdateRollback -StackName "myStack"-
Untuk detail API, lihat ContinueUpdateRollback di Alat AWS untuk PowerShell Referensi Cmdlet (V4).
-
- Alat untuk PowerShell V5
-
Contoh 1: Melanjutkan rollback dari tumpukan bernama, yang seharusnya berada dalam status 'UPDATE_ROLLBACK_FAILED'. Jika rollback lanjutan berhasil, tumpukan akan masuk ke status 'UPDATE_ROLLBACK_COMPLETE'.
Resume-CFNUpdateRollback -StackName "myStack"-
Untuk detail API, lihat ContinueUpdateRollback di Alat AWS untuk PowerShell Referensi Cmdlet (V5).
-
Buat tumpukan
Gunakan create-stack perintah untuk membuat tumpukan. Anda harus memberikan nama tumpukan, lokasi templat yang valid, dan parameter masukan apa pun. Nama kunci parameter peka huruf besar/kecil. Jika Anda salah mengetik nama kunci parameter, CloudFormation tidak membuat tumpukan dan melaporkan bahwa template tidak berisi parameter itu.
Contoh berikut menunjukkan cara membuat tumpukan baru dengan nama, template, dan parameter input yang ditentukan.
- CLI
-
- AWS CLI
-
Untuk membuat AWS CloudFormation tumpukan
Berikut ini
create-stackcontoh membuat tumpukan dengan namamyteststackmenggunakansampletemplate.jsontemplat.aws cloudformation create-stack \ --stack-namemyteststack\ --template-bodyfile://sampletemplate.json\ --parametersParameterKey=KeyPairName,ParameterValue=TestKeyParameterKey=SubnetIDs,ParameterValue=SubnetID1\\,SubnetID2Isi dari
sampletemplate.json:{ "AWSTemplateFormatVersion": "2010-09-09", "Description": "Sample template that creates an Amazon EC2 instance in the first of the specified subnets.", "Parameters": { "KeyPairName": { "Type": "AWS::EC2::KeyPair::KeyName", "Description": "Name of an existing EC2 key pair for SSH access to the instance." }, "SubnetIDs": { "Type": "CommaDelimitedList", "Description": "Comma-delimited list of subnet IDs." } }, "Resources": { "MyInstance": { "Type": "AWS::EC2::Instance", "Properties": { "ImageId": "ami-0abcdef1234567890", "InstanceType": "t3.micro", "KeyName": { "Ref": "KeyPairName" }, "SubnetId": { "Fn::Select": [ "0", { "Ref": "SubnetIDs" } ] } } } } }Output:
{ "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/myteststack/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }Untuk informasi lebih lanjut, lihat Mengelola AWS sumber daya sebagai satu unit dengan CloudFormation tumpukan di AWS CloudFormation Panduan Pengguna.
-
Untuk detail API, lihat CreateStack
di AWS CLI Referensi Perintah.
-
- PowerShell
-
- Alat untuk PowerShell V4
-
Contoh 1: Membuat tumpukan baru dengan nama yang ditentukan. Template diurai dari konten yang disediakan dengan parameter kustomisasi ('PK1' dan 'PK2' mewakili nama parameter yang dinyatakan dalam konten template, 'PV1' dan 'PV2' mewakili nilai untuk parameter tersebut. Parameter kustomisasi juga dapat ditentukan menggunakan 'Key' dan 'Value' alih-alih 'ParameterKey'dan'ParameterValue'. Jika pembuatan tumpukan gagal, itu tidak akan diputar kembali.
New-CFNStack -StackName "myStack" ` -TemplateBody "{TEMPLATE CONTENT HERE}" ` -Parameter @( @{ ParameterKey="PK1"; ParameterValue="PV1" }, @{ ParameterKey="PK2"; ParameterValue="PV2" }) ` -DisableRollback $trueContoh 2: Membuat tumpukan baru dengan nama yang ditentukan. Template diurai dari konten yang disediakan dengan parameter kustomisasi ('PK1' dan 'PK2' mewakili nama parameter yang dinyatakan dalam konten template, 'PV1' dan 'PV2' mewakili nilai untuk parameter tersebut. Parameter kustomisasi juga dapat ditentukan menggunakan 'Key' dan 'Value' alih-alih 'ParameterKey'dan'ParameterValue'. Jika pembuatan tumpukan gagal, itu akan diputar kembali.
$p1 = New-Object -Type Amazon.CloudFormation.Model.Parameter $p1.ParameterKey = "PK1" $p1.ParameterValue = "PV1" $p2 = New-Object -Type Amazon.CloudFormation.Model.Parameter $p2.ParameterKey = "PK2" $p2.ParameterValue = "PV2" New-CFNStack -StackName "myStack" ` -TemplateBody "{TEMPLATE CONTENT HERE}" ` -Parameter @( $p1, $p2 ) ` -OnFailure "ROLLBACK"Contoh 3: Membuat tumpukan baru dengan nama yang ditentukan. Template diperoleh dari URL Amazon S3 dengan parameter penyesuaian ('PK1' mewakili nama parameter yang dideklarasikan dalam konten template, 'PV1' mewakili nilai untuk parameter. Parameter kustomisasi juga dapat ditentukan menggunakan 'Key' dan 'Value' alih-alih 'ParameterKey'dan'ParameterValue'. Jika pembuatan tumpukan gagal, itu akan diputar kembali (sama seperti menentukan -DisableRollback $ salah).
New-CFNStack -StackName "myStack" ` -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template ` -Parameter @{ ParameterKey="PK1"; ParameterValue="PV1" }Contoh 4: Membuat tumpukan baru dengan nama yang ditentukan. Template diperoleh dari URL Amazon S3 dengan parameter penyesuaian ('PK1' mewakili nama parameter yang dideklarasikan dalam konten template, 'PV1' mewakili nilai untuk parameter. Parameter kustomisasi juga dapat ditentukan menggunakan 'Key' dan 'Value' alih-alih 'ParameterKey'dan'ParameterValue'. Jika pembuatan tumpukan gagal, itu akan diputar kembali (sama seperti menentukan -DisableRollback $ salah). AEN notifikasi yang ditentukan akan menerima peristiwa terkait tumpukan yang dipublikasikan.
New-CFNStack -StackName "myStack" ` -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template ` -Parameter @{ ParameterKey="PK1"; ParameterValue="PV1" } ` -NotificationARN @( "arn1", "arn2" )-
Untuk detail API, lihat CreateStack di Alat AWS untuk PowerShell Referensi Cmdlet (V4).
-
- Alat untuk PowerShell V5
-
Contoh 1: Membuat tumpukan baru dengan nama yang ditentukan. Template diurai dari konten yang disediakan dengan parameter kustomisasi ('PK1' dan 'PK2' mewakili nama parameter yang dinyatakan dalam konten template, 'PV1' dan 'PV2' mewakili nilai untuk parameter tersebut. Parameter kustomisasi juga dapat ditentukan menggunakan 'Key' dan 'Value' alih-alih 'ParameterKey'dan'ParameterValue'. Jika pembuatan tumpukan gagal, itu tidak akan diputar kembali.
New-CFNStack -StackName "myStack" ` -TemplateBody "{TEMPLATE CONTENT HERE}" ` -Parameter @( @{ ParameterKey="PK1"; ParameterValue="PV1" }, @{ ParameterKey="PK2"; ParameterValue="PV2" }) ` -DisableRollback $trueContoh 2: Membuat tumpukan baru dengan nama yang ditentukan. Template diurai dari konten yang disediakan dengan parameter kustomisasi ('PK1' dan 'PK2' mewakili nama parameter yang dinyatakan dalam konten template, 'PV1' dan 'PV2' mewakili nilai untuk parameter tersebut. Parameter kustomisasi juga dapat ditentukan menggunakan 'Key' dan 'Value' alih-alih 'ParameterKey'dan'ParameterValue'. Jika pembuatan tumpukan gagal, itu akan diputar kembali.
$p1 = New-Object -Type Amazon.CloudFormation.Model.Parameter $p1.ParameterKey = "PK1" $p1.ParameterValue = "PV1" $p2 = New-Object -Type Amazon.CloudFormation.Model.Parameter $p2.ParameterKey = "PK2" $p2.ParameterValue = "PV2" New-CFNStack -StackName "myStack" ` -TemplateBody "{TEMPLATE CONTENT HERE}" ` -Parameter @( $p1, $p2 ) ` -OnFailure "ROLLBACK"Contoh 3: Membuat tumpukan baru dengan nama yang ditentukan. Template diperoleh dari URL Amazon S3 dengan parameter penyesuaian ('PK1' mewakili nama parameter yang dideklarasikan dalam konten template, 'PV1' mewakili nilai untuk parameter. Parameter kustomisasi juga dapat ditentukan menggunakan 'Key' dan 'Value' alih-alih 'ParameterKey'dan'ParameterValue'. Jika pembuatan tumpukan gagal, itu akan diputar kembali (sama seperti menentukan -DisableRollback $ salah).
New-CFNStack -StackName "myStack" ` -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template ` -Parameter @{ ParameterKey="PK1"; ParameterValue="PV1" }Contoh 4: Membuat tumpukan baru dengan nama yang ditentukan. Template diperoleh dari URL Amazon S3 dengan parameter penyesuaian ('PK1' mewakili nama parameter yang dideklarasikan dalam konten template, 'PV1' mewakili nilai untuk parameter. Parameter kustomisasi juga dapat ditentukan menggunakan 'Key' dan 'Value' alih-alih 'ParameterKey'dan'ParameterValue'. Jika pembuatan tumpukan gagal, itu akan diputar kembali (sama seperti menentukan -DisableRollback $ salah). AEN notifikasi yang ditentukan akan menerima peristiwa terkait tumpukan yang dipublikasikan.
New-CFNStack -StackName "myStack" ` -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template ` -Parameter @{ ParameterKey="PK1"; ParameterValue="PV1" } ` -NotificationARN @( "arn1", "arn2" )-
Untuk detail API, lihat CreateStack di Alat AWS untuk PowerShell Referensi Cmdlet (V5).
-
Anda dapat menggunakan AWS CLI --template-url opsi untuk menentukan lokasi file template di Amazon S3 atau AWS Systems Manager.
Untuk Amazon S3, URL harus dimulai dengan https://. URL situs web statis S3 tidak didukung.
--template-urlhttps://s3.region-code.amazonaws.com/bucket-name/template-name
Untuk AWS Systems Manager, gunakan format berikut:
--template-url"ssm-doc://arn:aws:ssm:region-code:account-id:document/document-name"
Mode ekspres
Untuk membuat tumpukan menggunakan mode ekspres, tambahkan --deployment-config parameter. Mode ekspres menyelesaikan operasi tumpukan segera CloudFormation menerapkan konfigurasi sumber daya. Untuk informasi selengkapnya, lihat Mode ekspres.
aws cloudformation create-stack --stack-namemyteststack\ --template-bodyfile://sampletemplate.json\ --deployment-config '{"mode": "EXPRESS"}'
Buat tumpukan yang mencakup transformasi
Gunakan deploy perintah untuk membuat tumpukan yang mencakup transformasi. Saat Anda membuat tumpukan dari template yang menyertakan transformasi, Anda harus menggunakan set perubahan. deploy perintah menggabungkan dua langkah (membuat set perubahan dan mengeksekusinya) menjadi satu perintah.
- AWS CLI
-
Berikut ini
deployperintah membuat tumpukan dengan nama, template, dan parameter input yang ditentukan.aws cloudformation deploy --stack-namemyteststack\ --template/path_to_template/my-template.json\ --parameter-overridesKey1=Value1 Key2=Value2
Hapus tumpukan
Gunakan delete-stack perintah untuk menghapus tumpukan. Untuk informasi selengkapnya, lihat Hapus tumpukan.
- CLI
-
- AWS CLI
-
Untuk menghapus tumpukan
Berikut ini
delete-stackcontoh menghapus tumpukan yang ditentukan.aws cloudformation delete-stack \ --stack-namemy-stackPerintah ini tidak menghasilkan output.
Untuk informasi lebih lanjut, lihat Mengelola AWS sumber daya sebagai satu unit dengan CloudFormation tumpukan di AWS CloudFormation Panduan Pengguna.
-
Untuk detail API, lihat DeleteStack
di AWS CLI Referensi Perintah.
-
- PowerShell
-
- Alat untuk PowerShell V4
-
Contoh 1: Menghapus tumpukan yang ditentukan.
Remove-CFNStack -StackName "myStack"-
Untuk detail API, lihat DeleteStack di Alat AWS untuk PowerShell Referensi Cmdlet (V4).
-
- Alat untuk PowerShell V5
-
Contoh 1: Menghapus tumpukan yang ditentukan.
Remove-CFNStack -StackName "myStack"-
Untuk detail API, lihat DeleteStack di Alat AWS untuk PowerShell Referensi Cmdlet (V5).
-
Jika penghapusan gagal dan mengembalikan DELETE_FAILED status, Anda dapat memilih untuk menghapus tumpukan dengan paksa menggunakan --deletion-mode pilihan. Ini adalah nilai-nilai berikut yang dapat digunakan dengan deletion-mode:
-
STANDARD: Menghapus tumpukan secara normal. Ini adalah mode penghapusan default. -
FORCE_DELETE_STACK: Menghapus tumpukan dan melewatkan semua sumber daya yang gagal dihapus.
- AWS CLI
-
Berikut ini
delete-stackCommand Force menghapusmenumpuk menggunakanmyteststackFORCE_DELETE_STACKnilai dengandeletion-modeParameter:aws cloudformation delete-stack --stack-namemyteststack\ --deletion-mode FORCE_DELETE_STACKPerintah ini tidak menghasilkan output.
Setelah menggunakan FORCE_DELETE_STACK, Anda dapat menggunakan list-stack-resources perintah untuk membuat daftar sumber daya yang dilewati selama proses penghapusan tumpukan. Sumber daya yang disimpan akan menampilkan status DELETE_SKIPPED. Untuk informasi selengkapnya, lihat Daftar sumber daya tumpukan.
Mode ekspres
Untuk menghapus tumpukan menggunakan mode ekspres, tambahkan --deployment-config Parameter:
aws cloudformation delete-stack --stack-namemyteststack\ --deployment-config '{"mode": "EXPRESS"}'
Untuk informasi selengkapnya, lihat Mode ekspres.
Jelaskan peristiwa tumpukan
Gunakan describe-stack-events perintah untuk menggambarkan peristiwa tumpukan. Untuk informasi selengkapnya, lihat Pantau kemajuan tumpukan.
- CLI
-
- AWS CLI
-
Untuk mendeskripsikan peristiwa tumpukan
Berikut ini
describe-stack-eventscontoh menampilkan 2 peristiwa terbaru untuk tumpukan yang ditentukan.aws cloudformation describe-stack-events \ --stack-namemy-stack\ --max-items2Output:
{ "StackEvents": [ { "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "EventId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "StackName": "my-stack", "LogicalResourceId": "my-stack", "PhysicalResourceId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "ResourceType": "AWS::CloudFormation::Stack", "Timestamp": "2019-10-02T05:34:29.556Z", "ResourceStatus": "UPDATE_COMPLETE" }, { "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "EventId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "StackName": "my-stack", "LogicalResourceId": "my-stack", "PhysicalResourceId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "ResourceType": "AWS::CloudFormation::Stack", "Timestamp": "2019-10-02T05:34:29.127Z", "ResourceStatus": "UPDATE_COMPLETE_CLEANUP_IN_PROGRESS" } ], "NextToken": "eyJOZXh0VG9XMPLiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAyfQ==" }Untuk informasi lebih lanjut, lihat Pantau kemajuan tumpukan di AWS CloudFormation Panduan Pengguna.
-
Untuk detail API, lihat DescribeStackEvents
di AWS CLI Referensi Perintah.
-
- PowerShell
-
- Alat untuk PowerShell V4
-
Contoh 1: Mengembalikan semua peristiwa terkait tumpukan untuk tumpukan yang ditentukan.
Get-CFNStackEvent -StackName "myStack"-
Untuk detail API, lihat DescribeStackEvents di Alat AWS untuk PowerShell Referensi Cmdlet (V4).
-
- Alat untuk PowerShell V5
-
Contoh 1: Mengembalikan semua peristiwa terkait tumpukan untuk tumpukan yang ditentukan.
Get-CFNStackEvent -StackName "myStack"-
Untuk detail API, lihat DescribeStackEvents di Alat AWS untuk PowerShell Referensi Cmdlet (V5).
-
Jelaskan sumber daya tumpukan
- CLI
-
- AWS CLI
-
Untuk mendapatkan informasi tentang sumber daya tumpukan
Berikut ini
describe-stack-resourcecontoh menampilkan detail untuk sumber daya bernamaMyFunctiondalam tumpukan yang ditentukan.aws cloudformation describe-stack-resource \ --stack-nameMyStack\ --logical-resource-idMyFunctionOutput:
{ "StackResourceDetail": { "StackName": "MyStack", "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/MyStack/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "LogicalResourceId": "MyFunction", "PhysicalResourceId": "my-function-SEZV4XMPL4S5", "ResourceType": "AWS::Lambda::Function", "LastUpdatedTimestamp": "2019-10-02T05:34:27.989Z", "ResourceStatus": "UPDATE_COMPLETE", "Metadata": "{}", "DriftInformation": { "StackResourceDriftStatus": "IN_SYNC" } } }Untuk informasi lebih lanjut, lihat Mengelola AWS sumber daya sebagai satu unit dengan CloudFormation tumpukan di AWS CloudFormation Panduan Pengguna.
-
Untuk detail API, lihat DescribeStackResource
di AWS CLI Referensi Perintah.
-
- PowerShell
-
- Alat untuk PowerShell V4
-
Contoh 1: Mengembalikan deskripsi sumber daya yang diidentifikasi dalam template yang terkait dengan tumpukan yang ditentukan oleh ID logis “myDbInstance”.
Get-CFNStackResource -StackName "myStack" -LogicalResourceId "MyDBInstance"-
Untuk detail API, lihat DescribeStackResource di Alat AWS untuk PowerShell Referensi Cmdlet (V4).
-
- Alat untuk PowerShell V5
-
Contoh 1: Mengembalikan deskripsi sumber daya yang diidentifikasi dalam template yang terkait dengan tumpukan yang ditentukan oleh ID logis “myDbInstance”.
Get-CFNStackResource -StackName "myStack" -LogicalResourceId "MyDBInstance"-
Untuk detail API, lihat DescribeStackResource di Alat AWS untuk PowerShell Referensi Cmdlet (V5).
-
Jelaskan sumber daya tumpukan
- CLI
-
- AWS CLI
-
Untuk mendapatkan informasi tentang sumber daya tumpukan
Berikut ini
describe-stack-resourcescontoh menampilkan detail untuk sumber daya dalam tumpukan yang ditentukan.aws cloudformation describe-stack-resources \ --stack-namemy-stackOutput:
{ "StackResources": [ { "StackName": "my-stack", "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "LogicalResourceId": "bucket", "PhysicalResourceId": "my-stack-bucket-1vc62xmplgguf", "ResourceType": "AWS::S3::Bucket", "Timestamp": "2019-10-02T04:34:11.345Z", "ResourceStatus": "CREATE_COMPLETE", "DriftInformation": { "StackResourceDriftStatus": "IN_SYNC" } }, { "StackName": "my-stack", "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "LogicalResourceId": "function", "PhysicalResourceId": "my-function-SEZV4XMPL4S5", "ResourceType": "AWS::Lambda::Function", "Timestamp": "2019-10-02T05:34:27.989Z", "ResourceStatus": "UPDATE_COMPLETE", "DriftInformation": { "StackResourceDriftStatus": "IN_SYNC" } }, { "StackName": "my-stack", "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "LogicalResourceId": "functionRole", "PhysicalResourceId": "my-functionRole-HIZXMPLEOM9E", "ResourceType": "AWS::IAM::Role", "Timestamp": "2019-10-02T04:34:06.350Z", "ResourceStatus": "CREATE_COMPLETE", "DriftInformation": { "StackResourceDriftStatus": "IN_SYNC" } } ] }Untuk informasi lebih lanjut, lihat Mengelola AWS sumber daya sebagai satu unit dengan CloudFormation tumpukan di AWS CloudFormation Panduan Pengguna.
-
Untuk detail API, lihat DescribeStackResources
di AWS CLI Referensi Perintah.
-
- PowerShell
-
- Alat untuk PowerShell V4
-
Contoh 1: Mengembalikandeskripsi AWS sumber daya hingga 100 sumber daya yang terkait dengan tumpukan yang ditentukan. Untuk mendapatkan rincian semua sumber daya yang terkait dengan tumpukan gunakan Get-CFNStackResourceSummary, yang juga mendukung paging manual hasil.
Get-CFNStackResourceList -StackName "myStack"Contoh 2: Mengembalikan deskripsi instans Amazon EC2 yang diidentifikasi dalam template yang terkait dengan tumpukan yang ditentukan oleh ID logis “Ec2Instance”.
Get-CFNStackResourceList -StackName "myStack" -LogicalResourceId "Ec2Instance"Contoh 3: Mengembalikan deskripsi hingga 100 sumber daya yang terkait dengan tumpukan yang berisi instans Amazon EC2 yang diidentifikasi oleh ID instans “i-123456". Untuk mendapatkan rincian semua sumber daya yang terkait dengan tumpukan gunakan Get-CFNStackResourceSummary, yang juga mendukung paging manual hasil.
Get-CFNStackResourceList -PhysicalResourceId "i-123456"Contoh 4: Mengembalikan deskripsi instans Amazon EC2 yang diidentifikasi oleh ID logis “Ec2Instance” dalam template untuk tumpukan. Tumpukan diidentifikasi menggunakan ID sumber daya fisik sumber daya yang dikandungnya, dalam hal ini juga instans Amazon EC2 dengan ID instance “i-123456". Sumber daya fisik yang berbeda juga dapat digunakan untuk mengidentifikasi tumpukan tergantung pada konten template, misalnya bucket Amazon S3.
Get-CFNStackResourceList -PhysicalResourceId "i-123456" -LogicalResourceId "Ec2Instance"-
Untuk detail API, lihat DescribeStackResources di Alat AWS untuk PowerShell Referensi Cmdlet (V4).
-
- Alat untuk PowerShell V5
-
Contoh 1: Mengembalikandeskripsi AWS sumber daya hingga 100 sumber daya yang terkait dengan tumpukan yang ditentukan. Untuk mendapatkan rincian semua sumber daya yang terkait dengan tumpukan gunakan Get-CFNStackResourceSummary, yang juga mendukung paging manual hasil.
Get-CFNStackResourceList -StackName "myStack"Contoh 2: Mengembalikan deskripsi instans Amazon EC2 yang diidentifikasi dalam template yang terkait dengan tumpukan yang ditentukan oleh ID logis “Ec2Instance”.
Get-CFNStackResourceList -StackName "myStack" -LogicalResourceId "Ec2Instance"Contoh 3: Mengembalikan deskripsi hingga 100 sumber daya yang terkait dengan tumpukan yang berisi instans Amazon EC2 yang diidentifikasi oleh ID instans “i-123456". Untuk mendapatkan rincian semua sumber daya yang terkait dengan tumpukan gunakan Get-CFNStackResourceSummary, yang juga mendukung paging manual hasil.
Get-CFNStackResourceList -PhysicalResourceId "i-123456"Contoh 4: Mengembalikan deskripsi instans Amazon EC2 yang diidentifikasi oleh ID logis “Ec2Instance” dalam template untuk tumpukan. Tumpukan diidentifikasi menggunakan ID sumber daya fisik sumber daya yang dikandungnya, dalam hal ini juga instans Amazon EC2 dengan ID instance “i-123456". Sumber daya fisik yang berbeda juga dapat digunakan untuk mengidentifikasi tumpukan tergantung pada konten template, misalnya bucket Amazon S3.
Get-CFNStackResourceList -PhysicalResourceId "i-123456" -LogicalResourceId "Ec2Instance"-
Untuk detail API, lihat DescribeStackResources di Alat AWS untuk PowerShell Referensi Cmdlet (V5).
-
Jelaskan tumpukan
- CLI
-
- AWS CLI
-
Untuk menggambarkan AWS CloudFormation tumpukan
Berikut ini
describe-stackscontoh menunjukkan informasi ringkasan untukmyteststacktumpukan.aws cloudformation describe-stacks \ --stack-namemyteststackOutput:
{ "Stacks": [ { "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/myteststack/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "Description": "AWS CloudFormation Sample Template S3_Bucket: Sample template showing how to create a publicly accessible S3 bucket. **WARNING** This template creates an S3 bucket. You will be billed for the AWS resources used if you create a stack from this template.", "Tags": [], "Outputs": [ { "Description": "Name of S3 bucket to hold website content", "OutputKey": "BucketName", "OutputValue": "myteststack-s3bucket-jssofi1zie2w" } ], "StackStatusReason": null, "CreationTime": "2013-08-23T01:02:15.422Z", "Capabilities": [], "StackName": "myteststack", "StackStatus": "CREATE_COMPLETE", "DisableRollback": false } ] }Untuk informasi lebih lanjut, lihat Mengelola AWS sumber daya sebagai satu unit dengan CloudFormation tumpukan di AWS CloudFormation Panduan Pengguna.
-
Untuk detail API, lihat DescribeStacks
di AWS CLI Referensi Perintah.
-
- Go
-
- SDK untuk Go V2
-
catatan
Ada lebih banyak tentang GitHub. Temukan contoh lengkapnya dan pelajari cara mengatur dan menjalankannya di Repositori Contoh Kode AWS
. import ( "context" "log" "github.com/aws/aws-sdk-go-v2/aws" "github.com/aws/aws-sdk-go-v2/service/cloudformation" ) // StackOutputs defines a map of outputs from a specific stack. type StackOutputs map[string]string type CloudFormationActions struct { CfnClient *cloudformation.Client } // GetOutputs gets the outputs from a CloudFormation stack and puts them into a structured format. func (actor CloudFormationActions) GetOutputs(ctx context.Context, stackName string) StackOutputs { output, err := actor.CfnClient.DescribeStacks(ctx, &cloudformation.DescribeStacksInput{ StackName: aws.String(stackName), }) if err != nil || len(output.Stacks) == 0 { log.Panicf("Couldn't find a CloudFormation stack named %v. Here's why: %v\n", stackName, err) } stackOutputs := StackOutputs{} for _, out := range output.Stacks[0].Outputs { stackOutputs[*out.OutputKey] = *out.OutputValue } return stackOutputs }-
Untuk detail API, lihat DescribeStacks
di AWS SDK untuk Go Referensi API.
-
- PowerShell
-
- Alat untuk PowerShell V4
-
Contoh 1: Mengembalikan kumpulan instance Stack yang menjelaskan semua tumpukan pengguna.
Get-CFNStackContoh 2: Mengembalikan instance Stack yang menjelaskan tumpukan yang ditentukan
Get-CFNStack -StackName "myStack"-
Untuk detail API, lihat DescribeStacks di Alat AWS untuk PowerShell Referensi Cmdlet (V4).
-
- Alat untuk PowerShell V5
-
Contoh 1: Mengembalikan kumpulan instance Stack yang menjelaskan semua tumpukan pengguna.
Get-CFNStackContoh 2: Mengembalikan instance Stack yang menjelaskan tumpukan yang ditentukan
Get-CFNStack -StackName "myStack"-
Untuk detail API, lihat DescribeStacks di Alat AWS untuk PowerShell Referensi Cmdlet (V5).
-
Secara default, describe-stacks perintah mengembalikan nilai parameter. Untuk mencegah nilai parameter sensitif seperti kata sandi dikembalikan, sertakan a NoEcho properti disetel ke TRUE di milikmu CloudFormation templat.
Menggunakan NoEcho atribut tidak menutupi informasi apa pun yang disimpan dalam hal berikut:
-
Metadatabagian template. CloudFormation tidak mengubah, memodifikasi, atau menyunting informasi apa pun yang Anda sertakan dalamMetadatabagian. Untuk informasi lebih lanjut, lihat Metadata. -
Outputsbagian template. Untuk informasi lebih lanjut, lihat Keluaran. -
Metadataatribut dari definisi sumber daya. Untuk informasi lebih lanjut, lihat AtributMetadata.
Kami sangat menyarankan Anda untuk tidak menggunakan mekanisme ini untuk memasukkan informasi sensitif, seperti kata sandi atau rahasia.
Daripada menanamkan informasi sensitif secara langsung di CloudFormation template, kami sarankan Anda menggunakan parameter dinamis dalam template tumpukan untuk mereferensikan informasi sensitif yang disimpan dan dikelola di luar CloudFormation, seperti di AWS Systems Manager Penyimpanan Parameter atau AWS Secrets Manager.
Untuk informasi lebih lanjut, lihat Jangan menyematkan kredentif di template Anda praktik terbaik.
Dapatkan template
- CLI
-
- AWS CLI
-
Untuk melihat isi template untuk AWS CloudFormation tumpukan
Berikut ini
get-templatecontoh menunjukkan template untukmyteststacktumpukan.aws cloudformation get-template \ --stack-namemyteststackOutput:
{ "TemplateBody": { "AWSTemplateFormatVersion": "2010-09-09", "Outputs": { "BucketName": { "Description": "Name of S3 bucket to hold website content", "Value": { "Ref": "S3Bucket" } } }, "Description": "AWS CloudFormation Sample Template S3_Bucket: Sample template showing how to create a publicly accessible S3 bucket. **WARNING** This template creates an S3 bucket. You will be billed for the AWS resources used if you create a stack from this template.", "Resources": { "S3Bucket": { "Type": "AWS::S3::Bucket", "Properties": { "AccessControl": "PublicRead" } } } } }Untuk informasi lebih lanjut, lihat Bekerja dengan CloudFormation templat di AWS CloudFormation Panduan Pengguna.
-
Untuk detail API, lihat GetTemplate
di AWS CLI Referensi Perintah.
-
- PowerShell
-
- Alat untuk PowerShell V4
-
Contoh 1: Mengembalikan template yang terkait dengan tumpukan yang ditentukan.
Get-CFNTemplate -StackName "myStack"-
Untuk detail API, lihat GetTemplate di Alat AWS untuk PowerShell Referensi Cmdlet (V4).
-
- Alat untuk PowerShell V5
-
Contoh 1: Mengembalikan template yang terkait dengan tumpukan yang ditentukan.
Get-CFNTemplate -StackName "myStack"-
Untuk detail API, lihat GetTemplate di Alat AWS untuk PowerShell Referensi Cmdlet (V5).
-
Daftar sumber daya tumpukan
- CLI
-
- AWS CLI
-
Untuk membuat daftar sumber daya dalam tumpukan
Berikut ini
list-stack-resourcescontoh menampilkan daftar sumber daya dalam tumpukan yang ditentukan.aws cloudformation list-stack-resources \ --stack-namemy-stackOutput:
{ "StackResourceSummaries": [ { "LogicalResourceId": "bucket", "PhysicalResourceId": "my-stack-bucket-1vc62xmplgguf", "ResourceType": "AWS::S3::Bucket", "LastUpdatedTimestamp": "2019-10-02T04:34:11.345Z", "ResourceStatus": "CREATE_COMPLETE", "DriftInformation": { "StackResourceDriftStatus": "IN_SYNC" } }, { "LogicalResourceId": "function", "PhysicalResourceId": "my-function-SEZV4XMPL4S5", "ResourceType": "AWS::Lambda::Function", "LastUpdatedTimestamp": "2019-10-02T05:34:27.989Z", "ResourceStatus": "UPDATE_COMPLETE", "DriftInformation": { "StackResourceDriftStatus": "IN_SYNC" } }, { "LogicalResourceId": "functionRole", "PhysicalResourceId": "my-functionRole-HIZXMPLEOM9E", "ResourceType": "AWS::IAM::Role", "LastUpdatedTimestamp": "2019-10-02T04:34:06.350Z", "ResourceStatus": "CREATE_COMPLETE", "DriftInformation": { "StackResourceDriftStatus": "IN_SYNC" } } ] }Untuk informasi lebih lanjut, lihat Mengelola AWS sumber daya sebagai satu unit dengan CloudFormation tumpukan di AWS CloudFormation Panduan Pengguna.
-
Untuk detail API, lihat ListStackResources
di AWS CLI Referensi Perintah.
-
- PowerShell
-
- Alat untuk PowerShell V4
-
Contoh 1: Mengembalikan deskripsi semua sumber daya yang terkait dengan tumpukan yang ditentukan.
Get-CFNStackResourceSummary -StackName "myStack"-
Untuk detail API, lihat ListStackResources di Alat AWS untuk PowerShell Referensi Cmdlet (V4).
-
- Alat untuk PowerShell V5
-
Contoh 1: Mengembalikan deskripsi semua sumber daya yang terkait dengan tumpukan yang ditentukan.
Get-CFNStackResourceSummary -StackName "myStack"-
Untuk detail API, lihat ListStackResources di Alat AWS untuk PowerShell Referensi Cmdlet (V5).
-
Daftar tumpukan
Gunakan list-stacks perintah untuk membuat daftar tumpukan. Untuk mencantumkan hanya tumpukan dengan kode status yang ditentukan, sertakan --stack-status-filter pilihan. Anda dapat menentukan satu atau lebih kode status tumpukan untuk --stack-status-filter pilihan. Untuk informasi selengkapnya, lihat Kode status tumpukan.
- CLI
-
- AWS CLI
-
Untuk daftar AWS CloudFormation tumpukan
Berikut ini
list-stackscontoh menunjukkan ringkasan semua tumpukan yang memiliki statusCREATE_COMPLETE.aws cloudformation list-stacks \ --stack-status-filterCREATE_COMPLETEOutput:
{ "StackSummaries": [ { "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/myteststack/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "TemplateDescription": "AWS CloudFormation Sample Template S3_Bucket: Sample template showing how to create a publicly accessible S3 bucket. **WARNING** This template creates an S3 bucket. You will be billed for the AWS resources used if you create a stack from this template.", "StackStatusReason": null, "CreationTime": "2013-08-26T03:27:10.190Z", "StackName": "myteststack", "StackStatus": "CREATE_COMPLETE" } ] }Untuk informasi lebih lanjut, lihat Mengelola AWS sumber daya sebagai satu unit dengan CloudFormation tumpukan di AWS CloudFormation Panduan Pengguna.
-
Untuk detail API, lihat ListStacks
di AWS CLI Referensi Perintah.
-
- PowerShell
-
- Alat untuk PowerShell V4
-
Contoh 1: Mengembalikan informasi ringkasan untuk semua tumpukan.
Get-CFNStackSummaryContoh 2: Mengembalikan informasi ringkasan untuk semua tumpukan yang sedang dibuat.
Get-CFNStackSummary -StackStatusFilter "CREATE_IN_PROGRESS"Contoh 3: Mengembalikan informasi ringkasan untuk semua tumpukan yang sedang dibuat atau diperbarui.
Get-CFNStackSummary -StackStatusFilter @("CREATE_IN_PROGRESS", "UPDATE_IN_PROGRESS")-
Untuk detail API, lihat ListStacks di Alat AWS untuk PowerShell Referensi Cmdlet (V4).
-
- Alat untuk PowerShell V5
-
Contoh 1: Mengembalikan informasi ringkasan untuk semua tumpukan.
Get-CFNStackSummaryContoh 2: Mengembalikan informasi ringkasan untuk semua tumpukan yang sedang dibuat.
Get-CFNStackSummary -StackStatusFilter "CREATE_IN_PROGRESS"Contoh 3: Mengembalikan informasi ringkasan untuk semua tumpukan yang sedang dibuat atau diperbarui.
Get-CFNStackSummary -StackStatusFilter @("CREATE_IN_PROGRESS", "UPDATE_IN_PROGRESS")-
Untuk detail API, lihat ListStacks di Alat AWS untuk PowerShell Referensi Cmdlet (V5).
-
Memperbarui tumpukan
Gunakan perintah update-stack untuk memperbarui tumpukan secara langsung. Anda menentukan tumpukan, dan parameter nilai dan kemampuan yang akan diperbarui, dan, jika Anda ingin menggunakan templat yang diperbarui, nama templat. Untuk informasi selengkapnya, lihat Perbarui tumpukan secara langsung.
- CLI
-
- AWS CLI
-
Untuk memperbarui AWS CloudFormation tumpukan
Berikut ini
update-stackcontoh memperbarui template dan parameter input untukmystacktumpukan.aws cloudformation update-stack \ --stack-namemystack\ --template-urlhttps://s3.amazonaws.com/sample/updated.template\ --parametersParameterKey=KeyPairName,ParameterValue=SampleKeyPairParameterKey=SubnetIDs,ParameterValue=SampleSubnetID1\\,SampleSubnetID2Output:
{ "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/mystack/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }Berikut ini
update-stackcontoh pembaruan hanyaSubnetIDsnilai parameter untukmystacktumpukan. Jika Anda tidak menentukan nilai parameter, nilai default yang ditentukan dalam template digunakan.aws cloudformation update-stack \ --stack-namemystack\ --template-urlhttps://s3.amazonaws.com/sample/updated.template\ --parametersParameterKey=KeyPairName,UsePreviousValue=trueParameterKey=SubnetIDs,ParameterValue=SampleSubnetID1\\,UpdatedSampleSubnetID2Output:
{ "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/mystack/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }Berikut ini
update-stackcontoh menambahkan dua topik pemberitahuan tumpukan kemystacktumpukan.aws cloudformation update-stack \ --stack-namemystack\ --use-previous-template \ --notification-arns"arn:aws:sns:use-east-1:123456789012:mytopic1""arn:aws:sns:us-west-2:123456789012:mytopic2"Output:
{ "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/mystack/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }Untuk informasi lebih lanjut, lihat AWS CloudFormation pembaruan tumpukan di AWS CloudFormation Panduan Pengguna.
-
Untuk detail API, lihat UpdateStack
di AWS CLI Referensi Perintah.
-
- PowerShell
-
- Alat untuk PowerShell V4
-
Contoh 1: Memperbarui tumpukan 'MyStack' dengan template dan parameter kustomisasi yang ditentukan. 'PK1' mewakili nama parameter yang dideklarasikan dalam template dan 'PV1' mewakili nilainya. Parameter kustomisasi juga dapat ditentukan menggunakan 'Key' dan 'Value' alih-alih 'ParameterKey'dan'ParameterValue'.
Update-CFNStack -StackName "myStack" ` -TemplateBody "{Template Content Here}" ` -Parameter @{ ParameterKey="PK1"; ParameterValue="PV1" }Contoh 2: Memperbarui tumpukan 'MyStack' dengan template dan parameter kustomisasi yang ditentukan. 'PK1' dan 'PK2' mewakili nama parameter yang dideklarasikan dalam template, 'PV1' dan 'PV2' mewakili nilai yang diminta. Parameter kustomisasi juga dapat ditentukan menggunakan 'Key' dan 'Value' alih-alih 'ParameterKey'dan'ParameterValue'.
Update-CFNStack -StackName "myStack" ` -TemplateBody "{Template Content Here}" ` -Parameter @( @{ ParameterKey="PK1"; ParameterValue="PV1" }, @{ ParameterKey="PK2"; ParameterValue="PV2" } )Contoh 3: Memperbarui tumpukan 'MyStack' dengan template yang ditentukan dan parameter kustomisasi. 'PK1' mewakili nama parameter yang dideklarasikan dalam template dan 'PV2' mewakili nilainya. Parameter kustomisasi juga dapat ditentukan menggunakan 'Key' dan 'Value' alih-alih 'ParameterKey'dan'ParameterValue'.
Update-CFNStack -StackName "myStack" -TemplateBody "{Template Content Here}" -Parameters @{ ParameterKey="PK1"; ParameterValue="PV1" }Contoh 4: Memperbarui tumpukan 'MyStack' dengan template yang ditentukan, diperoleh dari Amazon S3, dan parameter penyesuaian. 'PK1' dan 'PK2' mewakili nama parameter yang dideklarasikan dalam template, 'PV1' dan 'PV2' mewakili nilai yang diminta. Parameter kustomisasi juga dapat ditentukan menggunakan 'Key' dan 'Value' alih-alih 'ParameterKey'dan'ParameterValue'.
Update-CFNStack -StackName "myStack" ` -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template ` -Parameter @( @{ ParameterKey="PK1"; ParameterValue="PV1" }, @{ ParameterKey="PK2"; ParameterValue="PV2" } )Contoh 5: Memperbarui tumpukan 'MyStack', yang diasumsikan dalam contoh ini berisi sumber daya IAM, dengan template yang ditentukan, diperoleh dari Amazon S3, dan parameter penyesuaian. 'PK1' dan 'PK2' mewakili nama parameter yang dideklarasikan dalam template, 'PV1' dan 'PV2' mewakili nilai yang diminta. Parameter kustomisasi juga dapat ditentukan menggunakan 'Key' dan 'Value' alih-alih 'ParameterKey'dan'ParameterValue'. Tumpukan yang berisi sumber daya IAM mengharuskan Anda untuk menentukan parameter -Capabilities “CAPABILITY_IAM” jika tidak pembaruan akan gagal dengan 'InsufficientCapabilities'kesalahan.
Update-CFNStack -StackName "myStack" ` -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template ` -Parameter @( @{ ParameterKey="PK1"; ParameterValue="PV1" }, @{ ParameterKey="PK2"; ParameterValue="PV2" } ) ` -Capabilities "CAPABILITY_IAM"-
Untuk detail API, lihat UpdateStack di Alat AWS untuk PowerShell Referensi Cmdlet (V4).
-
- Alat untuk PowerShell V5
-
Contoh 1: Memperbarui tumpukan 'MyStack' dengan template dan parameter kustomisasi yang ditentukan. 'PK1' mewakili nama parameter yang dideklarasikan dalam template dan 'PV1' mewakili nilainya. Parameter kustomisasi juga dapat ditentukan menggunakan 'Key' dan 'Value' alih-alih 'ParameterKey'dan'ParameterValue'.
Update-CFNStack -StackName "myStack" ` -TemplateBody "{Template Content Here}" ` -Parameter @{ ParameterKey="PK1"; ParameterValue="PV1" }Contoh 2: Memperbarui tumpukan 'MyStack' dengan template dan parameter kustomisasi yang ditentukan. 'PK1' dan 'PK2' mewakili nama parameter yang dideklarasikan dalam template, 'PV1' dan 'PV2' mewakili nilai yang diminta. Parameter kustomisasi juga dapat ditentukan menggunakan 'Key' dan 'Value' alih-alih 'ParameterKey'dan'ParameterValue'.
Update-CFNStack -StackName "myStack" ` -TemplateBody "{Template Content Here}" ` -Parameter @( @{ ParameterKey="PK1"; ParameterValue="PV1" }, @{ ParameterKey="PK2"; ParameterValue="PV2" } )Contoh 3: Memperbarui tumpukan 'MyStack' dengan template yang ditentukan dan parameter kustomisasi. 'PK1' mewakili nama parameter yang dideklarasikan dalam template dan 'PV2' mewakili nilainya. Parameter kustomisasi juga dapat ditentukan menggunakan 'Key' dan 'Value' alih-alih 'ParameterKey'dan'ParameterValue'.
Update-CFNStack -StackName "myStack" -TemplateBody "{Template Content Here}" -Parameters @{ ParameterKey="PK1"; ParameterValue="PV1" }Contoh 4: Memperbarui tumpukan 'MyStack' dengan template yang ditentukan, diperoleh dari Amazon S3, dan parameter penyesuaian. 'PK1' dan 'PK2' mewakili nama parameter yang dideklarasikan dalam template, 'PV1' dan 'PV2' mewakili nilai yang diminta. Parameter kustomisasi juga dapat ditentukan menggunakan 'Key' dan 'Value' alih-alih 'ParameterKey'dan'ParameterValue'.
Update-CFNStack -StackName "myStack" ` -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template ` -Parameter @( @{ ParameterKey="PK1"; ParameterValue="PV1" }, @{ ParameterKey="PK2"; ParameterValue="PV2" } )Contoh 5: Memperbarui tumpukan 'MyStack', yang diasumsikan dalam contoh ini berisi sumber daya IAM, dengan template yang ditentukan, diperoleh dari Amazon S3, dan parameter penyesuaian. 'PK1' dan 'PK2' mewakili nama parameter yang dideklarasikan dalam template, 'PV1' dan 'PV2' mewakili nilai yang diminta. Parameter kustomisasi juga dapat ditentukan menggunakan 'Key' dan 'Value' alih-alih 'ParameterKey'dan'ParameterValue'. Tumpukan yang berisi sumber daya IAM mengharuskan Anda untuk menentukan parameter -Capabilities “CAPABILITY_IAM” jika tidak pembaruan akan gagal dengan 'InsufficientCapabilities'kesalahan.
Update-CFNStack -StackName "myStack" ` -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template ` -Parameter @( @{ ParameterKey="PK1"; ParameterValue="PV1" }, @{ ParameterKey="PK2"; ParameterValue="PV2" } ) ` -Capabilities "CAPABILITY_IAM"-
Untuk detail API, lihat UpdateStack di Alat AWS untuk PowerShell Referensi Cmdlet (V5).
-
Untuk menghapus semua notifikasi, tentukan untuk [] untuk --notification-arns pilihan.
Mode ekspres
Untuk memperbarui tumpukan menggunakan mode ekspres, tambahkan --deployment-config Parameter:
aws cloudformation update-stack --stack-namemyteststack\ --template-bodyfile://sampletemplate.json\ --deployment-config '{"mode": "EXPRESS"}'
Untuk informasi selengkapnya, lihat Mode ekspres.
Validasi template Anda
Gunakan validate-template perintah untuk memeriksa file template Anda untuk kesalahan sintaks.
Selama validasi, CloudFormation pertama periksa apakah template adalah JSON yang valid. Jika bukan, CloudFormation memeriksa apakah templat YAML valid. Jika kedua pemeriksaan gagal, CloudFormation mengembalikan kesalahan validasi template.
- CLI
-
- AWS CLI
-
Untuk memvalidasi AWS CloudFormation templat
Berikut ini
validate-templatecontoh memvalidasisampletemplate.jsontemplat.aws cloudformation validate-template \ --template-bodyfile://sampletemplate.jsonIsi dari
sampletemplate.json:{ "AWSTemplateFormatVersion": "2010-09-09", "Description": "AWS CloudFormation Sample Template S3_Bucket: Sample template showing how to create an S3 bucket. **WARNING** This template creates an S3 bucket. You will be billed for the AWS resources used if you create a stack from this template.", "Resources": { "S3Bucket": { "Type": "AWS::S3::Bucket", "DeletionPolicy": "Retain" } }, "Outputs": { "BucketName": { "Value": { "Ref": "S3Bucket" }, "Description": "Name of the sample Amazon S3 bucket." } } }Output:
{ "Description": "AWS CloudFormation Sample Template S3_Bucket: Sample template showing how to create an S3 bucket. **WARNING** This template creates an S3 bucket. You will be billed for the AWS resources used if you create a stack from this template.", "Parameters": [], "Capabilities": [] }Untuk informasi lebih lanjut, lihat Bekerja dengan CloudFormation templat di AWS CloudFormation Panduan Pengguna.
-
Untuk detail API, lihat ValidateTemplate
di AWS CLI Referensi Perintah.
-
- PowerShell
-
- Alat untuk PowerShell V4
-
Contoh 1: Memvalidasi konten template yang ditentukan. Output merinci kemampuan, deskripsi, dan parameter template.
Test-CFNTemplate -TemplateBody "{TEMPLATE CONTENT HERE}"Contoh 2: Memvalidasi template tertentu yang diakses melalui URL Amazon S3. Output merinci kemampuan, deskripsi, dan parameter template.
Test-CFNTemplate -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template-
Untuk detail API, lihat ValidateTemplate di Alat AWS untuk PowerShell Referensi Cmdlet (V4).
-
- Alat untuk PowerShell V5
-
Contoh 1: Memvalidasi konten template yang ditentukan. Output merinci kemampuan, deskripsi, dan parameter template.
Test-CFNTemplate -TemplateBody "{TEMPLATE CONTENT HERE}"Contoh 2: Memvalidasi template tertentu yang diakses melalui URL Amazon S3. Output merinci kemampuan, deskripsi, dan parameter template.
Test-CFNTemplate -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template-
Untuk detail API, lihat ValidateTemplate di Alat AWS untuk PowerShell Referensi Cmdlet (V5).
-
Berikut ini adalah contoh respons yang menghasilkan kesalahan validasi.
{
"ResponseMetadata": {
"RequestId": "4ae33ec0-1988-11e3-818b-e15a6df955cd"
},
"Errors": [
{
"Message": "Template format error: JSON not well-formed. (line 11, column 8)",
"Code": "ValidationError",
"Type": "Sender"
}
],
"Capabilities": [],
"Parameters": []
}
A client error (ValidationError) occurred: Template format error: JSON not well-formed. (line 11, column 8)
validate-template perintah dirancang untuk memeriksa hanya sintaks template Anda. Itu tidak memastikan bahwa nilai properti yang telah Anda tentukan untuk sumber daya valid untuk sumber daya tersebut. Juga tidak menentukan jumlah sumber daya yang akan ada ketika tumpukan dibuat.
Untuk memeriksa validitas operasional, Anda perlu mencoba membuat tumpukan. Tidak ada kotak pasir atau area uji untuk CloudFormation menumpuk, sehingga Anda dikenakan biaya untuk sumber daya yang Anda buat selama pengujian.
Tidak dapat menemukan apa yang Anda butuhkan? Minta contoh baru dengan menggunakan Berikan umpan balik link di bagian bawah halaman ini.