View a markdown version of this page

Contoh dari CloudFormation perintah operasi tumpukan untuk AWS CLI dan PowerShell - AWS CloudFormation

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.

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-stack contoh membatalkan pembaruan tumpukan pada myteststack tumpukan.

aws cloudformation cancel-update-stack \ --stack-name myteststack

Perintah ini tidak menghasilkan output.

Untuk informasi lebih lanjut, lihat Membatalkan pembaruan tumpukan di AWS CloudFormation Panduan Pengguna.

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-rollback contoh melanjutkan operasi rollback dari pembaruan tumpukan yang sebelumnya gagal.

aws cloudformation continue-update-rollback \ --stack-name my-stack

Perintah ini tidak menghasilkan output.

Untuk informasi lebih lanjut, lihat Lanjutkan memutar kembali pembaruan di AWS CloudFormation Panduan Pengguna.

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"
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"

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-stack contoh membuat tumpukan dengan nama myteststack menggunakan sampletemplate.json templat.

aws cloudformation create-stack \ --stack-name myteststack \ --template-body file://sampletemplate.json \ --parameters ParameterKey=KeyPairName,ParameterValue=TestKey ParameterKey=SubnetIDs,ParameterValue=SubnetID1\\,SubnetID2

Isi 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 $true

Contoh 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 $true

Contoh 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).

catatan

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-url https://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-name myteststack \ --template-body file://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 deploy perintah membuat tumpukan dengan nama, template, dan parameter input yang ditentukan.

aws cloudformation deploy --stack-name myteststack \ --template /path_to_template/my-template.json \ --parameter-overrides Key1=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-stack contoh menghapus tumpukan yang ditentukan.

aws cloudformation delete-stack \ --stack-name my-stack

Perintah 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-stack Command Force menghapus myteststack menumpuk menggunakan FORCE_DELETE_STACK nilai dengan deletion-mode Parameter:

aws cloudformation delete-stack --stack-name myteststack \ --deletion-mode FORCE_DELETE_STACK

Perintah 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-name myteststack \ --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-events contoh menampilkan 2 peristiwa terbaru untuk tumpukan yang ditentukan.

aws cloudformation describe-stack-events \ --stack-name my-stack \ --max-items 2

Output:

{ "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.

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-resource contoh menampilkan detail untuk sumber daya bernama MyFunction dalam tumpukan yang ditentukan.

aws cloudformation describe-stack-resource \ --stack-name MyStack \ --logical-resource-id MyFunction

Output:

{ "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.

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"
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"

Jelaskan sumber daya tumpukan

CLI
AWS CLI

Untuk mendapatkan informasi tentang sumber daya tumpukan

Berikut ini describe-stack-resources contoh menampilkan detail untuk sumber daya dalam tumpukan yang ditentukan.

aws cloudformation describe-stack-resources \ --stack-name my-stack

Output:

{ "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.

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"
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"

Jelaskan tumpukan

CLI
AWS CLI

Untuk menggambarkan AWS CloudFormation tumpukan

Berikut ini describe-stacks contoh menunjukkan informasi ringkasan untuk myteststack tumpukan.

aws cloudformation describe-stacks \ --stack-name myteststack

Output:

{ "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-CFNStack

Contoh 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-CFNStack

Contoh 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.

penting

Menggunakan NoEcho atribut tidak menutupi informasi apa pun yang disimpan dalam hal berikut:

  • Metadata bagian template. CloudFormation tidak mengubah, memodifikasi, atau menyunting informasi apa pun yang Anda sertakan dalam Metadata bagian. Untuk informasi lebih lanjut, lihat Metadata.

  • Outputs bagian template. Untuk informasi lebih lanjut, lihat Keluaran.

  • Metadata atribut dari definisi sumber daya. Untuk informasi lebih lanjut, lihat Atribut Metadata.

Kami sangat menyarankan Anda untuk tidak menggunakan mekanisme ini untuk memasukkan informasi sensitif, seperti kata sandi atau rahasia.

penting

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-template contoh menunjukkan template untuk myteststack tumpukan.

aws cloudformation get-template \ --stack-name myteststack

Output:

{ "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-resources contoh menampilkan daftar sumber daya dalam tumpukan yang ditentukan.

aws cloudformation list-stack-resources \ --stack-name my-stack

Output:

{ "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.

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-stacks contoh menunjukkan ringkasan semua tumpukan yang memiliki status CREATE_COMPLETE.

aws cloudformation list-stacks \ --stack-status-filter CREATE_COMPLETE

Output:

{ "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-CFNStackSummary

Contoh 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-CFNStackSummary

Contoh 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-stack contoh memperbarui template dan parameter input untuk mystack tumpukan.

aws cloudformation update-stack \ --stack-name mystack \ --template-url https://s3.amazonaws.com/sample/updated.template \ --parameters ParameterKey=KeyPairName,ParameterValue=SampleKeyPair ParameterKey=SubnetIDs,ParameterValue=SampleSubnetID1\\,SampleSubnetID2

Output:

{ "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/mystack/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }

Berikut ini update-stack contoh pembaruan hanya SubnetIDs nilai parameter untuk mystack tumpukan. Jika Anda tidak menentukan nilai parameter, nilai default yang ditentukan dalam template digunakan.

aws cloudformation update-stack \ --stack-name mystack \ --template-url https://s3.amazonaws.com/sample/updated.template \ --parameters ParameterKey=KeyPairName,UsePreviousValue=true ParameterKey=SubnetIDs,ParameterValue=SampleSubnetID1\\,UpdatedSampleSubnetID2

Output:

{ "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/mystack/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" }

Berikut ini update-stack contoh menambahkan dua topik pemberitahuan tumpukan ke mystack tumpukan.

aws cloudformation update-stack \ --stack-name mystack \ --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).

catatan

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-name myteststack \ --template-body file://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-template contoh memvalidasi sampletemplate.json templat.

aws cloudformation validate-template \ --template-body file://sampletemplate.json

Isi 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.

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)
catatan

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.

Ketersediaan contoh

Tidak dapat menemukan apa yang Anda butuhkan? Minta contoh baru dengan menggunakan Berikan umpan balik link di bagian bawah halaman ini.