AWS CloudFormation contoh menggunakan AWS CLI - AWS Command Line Interface
Tindakan

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

AWS CloudFormation contoh menggunakan AWS CLI

Contoh kode berikut menunjukkan cara melakukan tindakan dan mengimplementasikan skenario umum dengan menggunakan AWS Command Line Interface with AWS CloudFormation.

Tindakan adalah kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.

Setiap contoh menyertakan tautan ke kode sumber lengkap, di mana Anda dapat menemukan instruksi tentang cara mengatur dan menjalankan kode dalam konteks.

Tindakan

Contoh kode berikut menunjukkan cara menggunakanactivate-type.

AWS CLI

Untuk mengaktifkan tipe

activate-typeContoh berikut mengaktifkan ekstensi pihak ketiga publik, membuatnya tersedia untuk digunakan dalam template tumpukan.

aws cloudformation activate-type \
    --region us-west-2 \
    --type RESOURCE \
    --type-name Example::Test::1234567890abcdef0 \
    --type-name-alias Example::Test::Alias

Output:

{
    "Arn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/Example-Test-Alias"
}

Untuk informasi selengkapnya, lihat Menggunakan AWS CloudFormation registri di Panduan AWS CloudFormation Pengguna.

  • Untuk API detailnya, lihat ActivateTypedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanbatch-describe-type-configurations.

AWS CLI

Untuk menggambarkan konfigurasi tipe secara batch

batch-describe-type-configurationsContoh berikut mengkonfigurasi data untuk tipe.

aws cloudformation batch-describe-type-configurations \
    --region us-west-2 \
    --type-configuration-identifiers TypeArn="arn:aws:cloudformation:us-west-2:123456789012:type/resource/Example-Test-Type,TypeConfigurationAlias=MyConfiguration"

Output:

{
    "Errors": [],
    "UnprocessedTypeConfigurations": [],
    "TypeConfigurations": [
        {
            "Arn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/Example-Test-Type",
            "Alias": "MyConfiguration",
            "Configuration": "{\n        \"Example\": {\n            \"ApiKey\": \"examplekey\",\n            \"ApplicationKey\": \"examplekey1\",\n            \"ApiURL\": \"exampleurl\"\n            }\n}",
            "LastUpdated": "2021-10-01T15:25:46.210000+00:00",
            "TypeArn": "arn:aws:cloudformation:us-east-1:123456789012:type/resource/Example-Test-Type"
        }
    ]
}

Untuk informasi selengkapnya, lihat Menggunakan AWS CloudFormation registri di Panduan AWS CloudFormation Pengguna.

Contoh kode berikut menunjukkan cara menggunakancancel-update-stack.

AWS CLI

Untuk membatalkan pembaruan tumpukan yang sedang berlangsung

cancel-update-stackPerintah berikut membatalkan pembaruan tumpukan pada myteststack tumpukan:

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

Contoh kode berikut menunjukkan cara menggunakancontinue-update-rollback.

AWS CLI

Untuk mencoba kembali rollback pembaruan

continue-update-rollbackContoh berikut melanjutkan operasi rollback dari pembaruan tumpukan yang sebelumnya gagal.

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

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakancreate-change-set.

AWS CLI

Untuk membuat set perubahan

create-change-setContoh berikut membuat set perubahan dengan CAPABILITY_IAM kemampuan. File template.yaml adalah AWS CloudFormation template di folder saat ini yang mendefinisikan tumpukan yang menyertakan IAM sumber daya.

aws cloudformation create-change-set \
    --stack-name my-application \
    --change-set-name my-change-set \
    --template-body file://template.yaml \
    --capabilities CAPABILITY_IAM

Output:

{
    "Id": "arn:aws:cloudformation:us-west-2:123456789012:changeSet/my-change-set/bc9555ba-a949-xmpl-bfb8-f41d04ec5784",
    "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-application/d0a825a0-e4cd-xmpl-b9fb-061c69e99204"
}

Contoh kode berikut menunjukkan cara menggunakancreate-stack-instances.

AWS CLI

Untuk membuat instance tumpukan

create-stack-instancesContoh berikut membuat instance dari tumpukan yang disetel dalam dua akun dan di empat wilayah. Pengaturan toleransi kesalahan memastikan bahwa pembaruan dicoba di semua akun dan wilayah, bahkan jika beberapa tumpukan tidak dapat dibuat.

aws cloudformation create-stack-instances \
    --stack-set-name my-stack-set \
    --accounts 123456789012 223456789012 \
    --regions us-east-1 us-east-2 us-west-1 us-west-2 \
    --operation-preferences FailureToleranceCount=7

Output:

{
    "OperationId": "d7995c31-83c2-xmpl-a3d4-e9ca2811563f"
}

Untuk membuat set tumpukan, gunakan create-stack-set perintah.

Contoh kode berikut menunjukkan cara menggunakancreate-stack-set.

AWS CLI

Untuk membuat set tumpukan

create-stack-setContoh berikut membuat stack set menggunakan temlplate YAML file yang ditentukan. template.yamladalah AWS CloudFormation template di folder saat ini yang mendefinisikan tumpukan.

aws cloudformation create-stack-set \
    --stack-set-name my-stack-set \
    --template-body file://template.yaml \
    --description "SNS topic"

Output:

{
    "StackSetId": "my-stack-set:8d0f160b-d157-xmpl-a8e6-c0ce8e5d8cc1"
}

Untuk menambahkan instance tumpukan ke set tumpukan, gunakan create-stack-instances perintah.

  • Untuk API detailnya, lihat CreateStackSetdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakancreate-stack.

AWS CLI

Untuk membuat AWS CloudFormation tumpukan

create-stacksPerintah berikut membuat tumpukan dengan nama myteststack menggunakan sampletemplate.json template:

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

Output:

{
    "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896"
}

Untuk informasi selengkapnya, lihat Tumpukan di Panduan AWS CloudFormation Pengguna.

  • Untuk API detailnya, lihat CreateStackdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandeactivate-type.

AWS CLI

Untuk menonaktifkan tipe

deactivate-typeContoh berikut menonaktifkan ekstensi publik yang sebelumnya diaktifkan di akun dan Wilayah ini.

aws cloudformation deactivate-type \
    --region us-west-2 \
    --type MODULE \
    --type-name Example::Test::Type::MODULE

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menggunakan AWS CloudFormation registri di Panduan AWS CloudFormation Pengguna.

  • Untuk API detailnya, lihat DeactivateTypedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandelete-change-set.

AWS CLI

Untuk menghapus set perubahan

delete-change-setContoh berikut menghapus set perubahan dengan menentukan nama set perubahan dan nama tumpukan.

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

Perintah ini tidak menghasilkan output.

delete-change-setContoh berikut menghapus set perubahan dengan menentukan penuh ARN dari set perubahan.

aws cloudformation delete-change-set \
    --change-set-name arn:aws:cloudformation:us-east-2:123456789012:changeSet/my-change-set/4eca1a01-e285-xmpl-8026-9a1967bfb4b0

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakandelete-stack-instances.

AWS CLI

Untuk menghapus instance tumpukan

delete-stack-instancesContoh berikut menghapus instance tumpukan yang disetel dalam dua akun di dua wilayah dan mengakhiri tumpukan.

aws cloudformation delete-stack-instances \
    --stack-set-name my-stack-set \
    --accounts 123456789012 567890123456 \
    --regions us-east-1 us-west-1 \
    --no-retain-stacks

Output:

{
    "OperationId": "ad49f10c-fd1d-413f-a20a-8de6e2fa8f27"
}

Untuk menghapus kumpulan tumpukan kosong, gunakan delete-stack-set perintah.

Contoh kode berikut menunjukkan cara menggunakandelete-stack-set.

AWS CLI

Untuk menghapus set tumpukan

Perintah berikut menghapus set tumpukan kosong yang ditentukan. Set tumpukan harus kosong.

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

Perintah ini tidak menghasilkan output.

Untuk menghapus instance dari kumpulan tumpukan, gunakan delete-stack-instances perintah.

  • Untuk API detailnya, lihat DeleteStackSetdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandelete-stack.

AWS CLI

Untuk menghapus tumpukan

delete-stackContoh berikut menghapus tumpukan yang ditentukan.

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

Perintah ini tidak menghasilkan output.

  • Untuk API detailnya, lihat DeleteStackdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandeploy.

AWS CLI

Berikut perintah menyebarkan template bernama template.json ke tumpukan bernamamy-new-stack:

aws cloudformation deploy --template-file /path_to_template/template.json --stack-name my-new-stack --parameter-overrides Key1=Value1 Key2=Value2 --tags Key1=Value1 Key2=Value2

  • Untuk API detailnya, lihat Menerapkan di Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanderegister-type.

AWS CLI

Untuk membatalkan pendaftaran versi tipe

deregister-typeContoh berikut menghapus versi tipe yang ditentukan dari penggunaan aktif dalam CloudFormation registri, sehingga tidak dapat lagi digunakan dalam CloudFormation operasi.

aws cloudformation deregister-type \
    --type RESOURCE \
    --type-name My::Logs::LogGroup \
    --version-id 00000002

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menggunakan CloudFormation Registri di Panduan AWS CloudFormation Pengguna.

  • Untuk API detailnya, lihat DeregisterTypedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandescribe-account-limits.

AWS CLI

Untuk mendapatkan informasi tentang batas akun Anda

Perintah berikut mengambil daftar batas regional untuk akun saat ini.

aws cloudformation describe-account-limits

Output:

{
    "AccountLimits": [
        {
            "Name": "StackLimit",
            "Value": 200
        },
        {
            "Name": "StackOutputsLimit",
            "Value": 60
        },
        {
            "Name": "ConcurrentResourcesLimit",
            "Value": 2500
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakandescribe-change-set.

AWS CLI

Untuk mendapatkan informasi tentang set perubahan

describe-change-setContoh berikut menampilkan rincian dari set perubahan yang ditentukan oleh nama set perubahan dan nama stack.

aws cloudformation describe-change-set \
    --change-set-name my-change-set \
    --stack-name my-stack

describe-change-setContoh berikut menampilkan rincian dari set perubahan yang ditentukan oleh penuh ARN dari set perubahan:

aws cloudformation describe-change-set \
    --change-set-name arn:aws:cloudformation:us-west-2:123456789012:changeSet/my-change-set/bc9555ba-a949-xmpl-bfb8-f41d04ec5784

Output:

{
    "Changes": [
        {
            "Type": "Resource",
            "ResourceChange": {
                "Action": "Modify",
                "LogicalResourceId": "function",
                "PhysicalResourceId": "my-function-SEZV4XMPL4S5",
                "ResourceType": "AWS::Lambda::Function",
                "Replacement": "False",
                "Scope": [
                    "Properties"
                ],
                "Details": [
                    {
                        "Target": {
                            "Attribute": "Properties",
                            "Name": "Timeout",
                            "RequiresRecreation": "Never"
                        },
                        "Evaluation": "Static",
                        "ChangeSource": "DirectModification"
                    }
                ]
            }
        }
    ],
    "ChangeSetName": "my-change-set",
    "ChangeSetId": "arn:aws:cloudformation:us-west-2:123456789012:changeSet/my-change-set/4eca1a01-e285-xmpl-8026-9a1967bfb4b0",
    "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204",
    "StackName": "my-stack",
    "Description": null,
    "Parameters": null,
    "CreationTime": "2019-10-02T05:20:56.651Z",
    "ExecutionStatus": "AVAILABLE",
    "Status": "CREATE_COMPLETE",
    "StatusReason": null,
    "NotificationARNs": [],
    "RollbackConfiguration": {},
    "Capabilities": [
        "CAPABILITY_IAM"
    ],
    "Tags": null
}

Contoh kode berikut menunjukkan cara menggunakandescribe-publisher.

AWS CLI

Untuk menggambarkan penerbit

describe-publisherContoh berikut mengkonfigurasi informasi untuk penerbit.

aws cloudformation describe-publisher \
    --region us-west-2 \
    --publisher-id 000q6TfUovXsEMmgKowxDZLlwqr2QUsh

Output:

{
    "PublisherId": "000q6TfUovXsEMmgKowxDZLlwqr2QUshd2e75c8c",
    "PublisherStatus": "VERIFIED",
    "IdentityProvider": "AWS_Marketplace",
    "PublisherProfile": "https://aws.amazon.com/marketplace/seller-profile?id=2c5dc1f0-17cd-4259-8e46-822a83gdtegd"
}

Untuk informasi selengkapnya, lihat Menggunakan AWS CloudFormation registri di Panduan AWS CloudFormation Pengguna.

Contoh kode berikut menunjukkan cara menggunakandescribe-stack-drift-detection-status.

AWS CLI

Untuk memeriksa status operasi deteksi drift

describe-stack-drift-detection-statusContoh berikut menampilkan status operasi deteksi drift. Dapatkan ID by menjalankan detect-stack-drift perintah.

aws cloudformation describe-stack-drift-detection-status \
    --stack-drift-detection-id 1a229160-e4d9-xmpl-ab67-0a4f93df83d4

Output:

{
    "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204",
    "StackDriftDetectionId": "1a229160-e4d9-xmpl-ab67-0a4f93df83d4",
    "StackDriftStatus": "DRIFTED",
    "DetectionStatus": "DETECTION_COMPLETE",
    "DriftedStackResourceCount": 1,
    "Timestamp": "2019-10-02T05:54:30.902Z"
}

Contoh kode berikut menunjukkan cara menggunakandescribe-stack-events.

AWS CLI

Untuk menggambarkan peristiwa tumpukan

describe-stack-eventsContoh berikut menampilkan 2 peristiwa terbaru untuk tumpukan tertentu.

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

{
    "StackEvents": [
        {
            "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204",
            "EventId": "4e1516d0-e4d6-xmpl-b94f-0a51958a168c",
            "StackName": "my-stack",
            "LogicalResourceId": "my-stack",
            "PhysicalResourceId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204",
            "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/d0a825a0-e4cd-xmpl-b9fb-061c69e99204",
            "EventId": "4dd3c810-e4d6-xmpl-bade-0aaf8b31ab7a",
            "StackName": "my-stack",
            "LogicalResourceId": "my-stack",
            "PhysicalResourceId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204",
            "ResourceType": "AWS::CloudFormation::Stack",
            "Timestamp": "2019-10-02T05:34:29.127Z",
            "ResourceStatus": "UPDATE_COMPLETE_CLEANUP_IN_PROGRESS"
        }
    ],
    "NextToken": "eyJOZXh0VG9XMPLiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAyfQ=="
}

Contoh kode berikut menunjukkan cara menggunakandescribe-stack-instance.

AWS CLI

Untuk menggambarkan instance tumpukan

Perintah berikut menjelaskan sebuah instance dari set stack yang ditentukan dalam akun dan Region yang ditentukan. Kumpulan tumpukan ada di wilayah dan akun saat ini, dan instance ada di us-west-2 wilayah di akun123456789012. :

aws cloudformation describe-stack-instance \
    --stack-set-name my-stack-set \
    --stack-instance-account 123456789012 \
    --stack-instance-region us-west-2

Output:

{
    "StackInstance": {
        "StackSetId": "enable-config:296a3360-xmpl-40af-be78-9341e95bf743",
        "Region": "us-west-2",
        "Account": "123456789012",
        "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/StackSet-enable-config-e6cac20f-xmpl-46e9-8314-53e0d4591532/4287f9a0-e615-xmpl-894a-12b31d3117be",
        "ParameterOverrides": [],
        "Status": "OUTDATED",
        "StatusReason": "ResourceLogicalId:ConfigBucket, ResourceType:AWS::S3::Bucket, ResourceStatusReason:You have attempted to create more buckets than allowed (Service: Amazon S3; Status Code: 400; Error Code: TooManyBuckets; Request ID: F7F21CXMPL580224; S3 Extended Request ID: egd/Fdt89BXMPLyiqbMNljVk55Yqqvi3NYW2nKLUVWhUGEhNfCmZdyj967lhriaG/dWMobSO40o=)."
    }
}

Contoh kode berikut menunjukkan cara menggunakandescribe-stack-resource-drifts.

AWS CLI

Untuk mendapatkan informasi tentang sumber daya yang melayang dari definisi tumpukan

Perintah berikut menampilkan informasi tentang sumber daya hanyut untuk tumpukan yang ditentukan. Untuk memulai deteksi drift, gunakan perintah. detect-stack-drift :

aws cloudformation describe-stack-resource-drifts \
    --stack-name my-stack

Output menunjukkan fungsi AWS Lambda yang telah dimodifikasi: out-of-band

{
    "StackResourceDrifts": [
        {
            "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204",
            "LogicalResourceId": "function",
            "PhysicalResourceId": "my-function-SEZV4XMPL4S5",
            "ResourceType": "AWS::Lambda::Function",
            "ExpectedProperties": "{\"Description\":\"Write a file to S3.\",\"Environment\":{\"Variables\":{\"bucket\":\"my-stack-bucket-1vc62xmplgguf\"}},\"Handler\":\"index.handler\",\"MemorySize\":128,\"Role\":\"arn:aws:iam::123456789012:role/my-functionRole-HIZXMPLEOM9E\",\"Runtime\":\"nodejs10.x\",\"Tags\":[{\"Key\":\"lambda:createdBy\",\"Value\":\"SAM\"}],\"Timeout\":900,\"TracingConfig\":{\"Mode\":\"Active\"}}",
            "ActualProperties": "{\"Description\":\"Write a file to S3.\",\"Environment\":{\"Variables\":{\"bucket\":\"my-stack-bucket-1vc62xmplgguf\"}},\"Handler\":\"index.handler\",\"MemorySize\":256,\"Role\":\"arn:aws:iam::123456789012:role/my-functionRole-HIZXMPLEOM9E\",\"Runtime\":\"nodejs10.x\",\"Tags\":[{\"Key\":\"lambda:createdBy\",\"Value\":\"SAM\"}],\"Timeout\":22,\"TracingConfig\":{\"Mode\":\"Active\"}}",
            "PropertyDifferences": [
                {
                    "PropertyPath": "/MemorySize",
                    "ExpectedValue": "128",
                    "ActualValue": "256",
                    "DifferenceType": "NOT_EQUAL"
                },
                {
                    "PropertyPath": "/Timeout",
                    "ExpectedValue": "900",
                    "ActualValue": "22",
                    "DifferenceType": "NOT_EQUAL"
                }
            ],
            "StackResourceDriftStatus": "MODIFIED",
            "Timestamp": "2019-10-02T05:54:44.064Z"
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakandescribe-stack-resource.

AWS CLI

Untuk mendapatkan informasi tentang sumber daya tumpukan

describe-stack-resourceContoh berikut menampilkan rincian untuk sumber daya yang dinamai MyFunction dalam tumpukan tertentu.

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

Output:

{
    "StackResourceDetail": {
        "StackName": "MyStack",
        "StackId": "arn:aws:cloudformation:us-east-2:123456789012:stack/MyStack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204",
        "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"
        }
    }
}

Contoh kode berikut menunjukkan cara menggunakandescribe-stack-resources.

AWS CLI

Untuk mendapatkan informasi tentang sumber daya tumpukan

describe-stack-resourcesContoh berikut menampilkan rincian untuk sumber daya dalam tumpukan tertentu.

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/d0a825a0-e4cd-xmpl-b9fb-061c69e99204",
            "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/d0a825a0-e4cd-xmpl-b9fb-061c69e99204",
            "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/d0a825a0-e4cd-xmpl-b9fb-061c69e99204",
            "LogicalResourceId": "functionRole",
            "PhysicalResourceId": "my-functionRole-HIZXMPLEOM9E",
            "ResourceType": "AWS::IAM::Role",
            "Timestamp": "2019-10-02T04:34:06.350Z",
            "ResourceStatus": "CREATE_COMPLETE",
            "DriftInformation": {
                "StackResourceDriftStatus": "IN_SYNC"
            }
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakandescribe-stack-set-operation.

AWS CLI

Untuk mendapatkan informasi tentang operasi stack set

Contoh describe-stack-set-operation `berikut menampilkan detail untuk operasi pembaruan pada set tumpukan yang ditentukan.

aws cloudformation describe-stack-set-operation \
    --stack-set-name enable-config \
    --operation-id 35d45ebc-ed88-xmpl-ab59-0197a1fc83a0

Output:

{
    "StackSetOperation": {
        "OperationId": "35d45ebc-ed88-xmpl-ab59-0197a1fc83a0",
        "StackSetId": "enable-config:296a3360-xmpl-40af-be78-9341e95bf743",
        "Action": "UPDATE",
        "Status": "SUCCEEDED",
        "OperationPreferences": {
            "RegionOrder": [
                "us-east-1",
                "us-west-2",
                "eu-west-1",
                "us-west-1"
            ],
            "FailureToleranceCount": 7,
            "MaxConcurrentCount": 2
        },
        "AdministrationRoleARN": "arn:aws:iam::123456789012:role/AWSCloudFormationStackSetAdministrationRole",
        "ExecutionRoleName": "AWSCloudFormationStackSetExecutionRole",
        "CreationTimestamp": "2019-10-03T16:28:44.377Z",
        "EndTimestamp": "2019-10-03T16:42:08.607Z"
    }
}

Contoh kode berikut menunjukkan cara menggunakandescribe-stack-set.

AWS CLI

Untuk mendapatkan informasi tentang kumpulan tumpukan

Contoh describe-stack-set `berikut menampilkan rincian tentang set stack yang ditentukan.

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

Output:

{
    "StackSet": {
        "StackSetName": "my-stack-set",
        "StackSetId": "my-stack-set:296a3360-xmpl-40af-be78-9341e95bf743",
        "Description": "Create an Amazon SNS topic",
        "Status": "ACTIVE",
        "TemplateBody": "AWSTemplateFormatVersion: '2010-09-09'\nDescription: An AWS SNS topic\nResources:\n  topic:\n    Type: AWS::SNS::Topic",
        "Parameters": [],
        "Capabilities": [],
        "Tags": [],
        "StackSetARN": "arn:aws:cloudformation:us-west-2:123456789012:stackset/enable-config:296a3360-xmpl-40af-be78-9341e95bf743",
        "AdministrationRoleARN": "arn:aws:iam::123456789012:role/AWSCloudFormationStackSetAdministrationRole",
        "ExecutionRoleName": "AWSCloudFormationStackSetExecutionRole"
    }
}

Contoh kode berikut menunjukkan cara menggunakandescribe-stacks.

AWS CLI

Untuk menggambarkan AWS CloudFormation tumpukan

describe-stacksPerintah berikut menunjukkan informasi ringkasan untuk myteststack tumpukan:

aws cloudformation describe-stacks --stack-name myteststack

Output:

{
    "Stacks":  [
        {
            "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896",
            "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 selengkapnya, lihat Tumpukan di Panduan AWS CloudFormation Pengguna.

  • Untuk API detailnya, lihat DescribeStacksdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandescribe-type-registration.

AWS CLI

Untuk menampilkan informasi pendaftaran jenis

describe-type-registrationContoh berikut menampilkan informasi tentang pendaftaran jenis yang ditentukan, termasuk status, jenis, dan versi tipe saat ini.

aws cloudformation describe-type-registration \
    --registration-token a1b2c3d4-5678-90ab-cdef-EXAMPLE11111

Output:

{
    "ProgressStatus": "COMPLETE",
    "TypeArn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/My-Logs-LogGroup",
    "Description": "Deployment is currently in DEPLOY_STAGE of status COMPLETED; ",
    "TypeVersionArn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/My-Logs-LogGroup/00000001"
}

Untuk informasi selengkapnya, lihat Menggunakan CloudFormation Registri di Panduan AWS CloudFormation Pengguna.

Contoh kode berikut menunjukkan cara menggunakandescribe-type.

AWS CLI

Untuk menampilkan informasi jenis

describe-typeContoh berikut menampilkan informasi untuk jenis yang ditentukan.

aws cloudformation describe-type \
    --type-name My::Logs::LogGroup \
    --type RESOURCE

Output:

{
    "SourceUrl": "https://github.com/aws-cloudformation/aws-cloudformation-resource-providers-logs.git",
    "Description": "Customized resource derived from AWS::Logs::LogGroup",
    "TimeCreated": "2019-12-03T23:29:33.321Z",
    "Visibility": "PRIVATE",
    "TypeName": "My::Logs::LogGroup",
    "LastUpdated": "2019-12-03T23:29:33.321Z",
    "DeprecatedStatus": "LIVE",
    "ProvisioningType": "FULLY_MUTABLE",
    "Type": "RESOURCE",
    "Arn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/My-Logs-LogGroup/00000001",
    "Schema": "[details omitted]"
}

Untuk informasi selengkapnya, lihat Menggunakan CloudFormation Registri di Panduan AWS CloudFormation Pengguna.

  • Untuk API detailnya, lihat DescribeTypedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakandetect-stack-drift.

AWS CLI

Untuk mendeteksi sumber daya yang melayang

detect-stack-driftContoh berikut memulai deteksi drift untuk tumpukan tertentu.

aws cloudformation detect-stack-drift \
    --stack-name my-stack

Output:

{
    "StackDriftDetectionId": "1a229160-e4d9-xmpl-ab67-0a4f93df83d4"
}

Anda kemudian dapat menggunakan ID ini dengan describe-stack-resource-drifts perintah untuk menggambarkan sumber daya yang hanyut.

Contoh kode berikut menunjukkan cara menggunakandetect-stack-resource-drift.

AWS CLI

Untuk mendeteksi penyimpangan untuk sumber daya

detect-stack-resource-driftContoh berikut memeriksa sumber daya bernama MyFunction dalam tumpukan bernama MyStack drift:

aws cloudformation detect-stack-resource-drift \
   --stack-name MyStack \
   --logical-resource-id MyFunction

Output menunjukkan fungsi AWS Lambda yang telah dimodifikasi: out-of-band

{
    "StackResourceDrift": {
        "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/MyStack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204",
        "LogicalResourceId": "MyFunction",
        "PhysicalResourceId": "my-function-SEZV4XMPL4S5",
        "ResourceType": "AWS::Lambda::Function",
        "ExpectedProperties": "{\"Description\":\"Write a file to S3.\",\"Environment\":{\"Variables\":{\"bucket\":\"my-stack-bucket-1vc62xmplgguf\"}},\"Handler\":\"index.handler\",\"MemorySize\":128,\"Role\":\"arn:aws:iam::123456789012:role/my-functionRole-HIZXMPLEOM9E\",\"Runtime\":\"nodejs10.x\",\"Tags\":[{\"Key\":\"lambda:createdBy\",\"Value\":\"SAM\"}],\"Timeout\":900,\"TracingConfig\":{\"Mode\":\"Active\"}}",
        "ActualProperties": "{\"Description\":\"Write a file to S3.\",\"Environment\":{\"Variables\":{\"bucket\":\"my-stack-bucket-1vc62xmplgguf\"}},\"Handler\":\"index.handler\",\"MemorySize\":256,\"Role\":\"arn:aws:iam::123456789012:role/my-functionRole-HIZXMPLEOM9E\",\"Runtime\":\"nodejs10.x\",\"Tags\":[{\"Key\":\"lambda:createdBy\",\"Value\":\"SAM\"}],\"Timeout\":22,\"TracingConfig\":{\"Mode\":\"Active\"}}",
        "PropertyDifferences": [
            {
                "PropertyPath": "/MemorySize",
                "ExpectedValue": "128",
                "ActualValue": "256",
                "DifferenceType": "NOT_EQUAL"
            },
            {
                "PropertyPath": "/Timeout",
                "ExpectedValue": "900",
                "ActualValue": "22",
                "DifferenceType": "NOT_EQUAL"
            }
        ],
        "StackResourceDriftStatus": "MODIFIED",
        "Timestamp": "2019-10-02T05:58:47.433Z"
    }
}

Contoh kode berikut menunjukkan cara menggunakandetect-stack-set-drift.

AWS CLI

Untuk mendeteksi penyimpangan pada kumpulan tumpukan dan semua instance tumpukan terkait

detect-stack-set-driftContoh berikut memulai operasi deteksi drift pada set tumpukan yang ditentukan, termasuk semua instance tumpukan yang terkait dengan kumpulan tumpukan itu, dan mengembalikan ID operasi yang dapat digunakan untuk melacak status operasi drift.

aws cloudformation detect-stack-set-drift \
    --stack-set-name stack-set-drift-example

Output:

{
    "OperationId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111"
}

Untuk informasi selengkapnya, lihat Mendeteksi Perubahan Konfigurasi Tidak Terkelola dalam Kumpulan Tumpukan di Panduan AWS CloudFormation Pengguna.

Contoh kode berikut menunjukkan cara menggunakanestimate-template-cost.

AWS CLI

Untuk memperkirakan biaya template

estimate-template-costContoh berikut menghasilkan perkiraan biaya untuk template bernama template.yaml dalam folder saat ini.

aws cloudformation estimate-template-cost \
    --template-body file://template.yaml

Output:

{
    "Url": "http://calculator.s3.amazonaws.com/calc5.html?key=cloudformation/7870825a-xmpl-4def-92e7-c4f8dd360cca"
}

Contoh kode berikut menunjukkan cara menggunakanexecute-change-set.

AWS CLI

Untuk menjalankan set perubahan

execute-change-setContoh berikut mengeksekusi set perubahan yang ditentukan oleh mengubah nama set dan nama stack.

aws cloudformation execute-change-set \
    --change-set-name my-change-set \
    --stack-name my-stack

execute-change-setContoh berikut mengeksekusi set perubahan yang ditentukan oleh penuh ARN set perubahan.

aws cloudformation execute-change-set \
    --change-set-name arn:aws:cloudformation:us-west-2:123456789012:changeSet/my-change-set/bc9555ba-a949-xmpl-bfb8-f41d04ec5784

Contoh kode berikut menunjukkan cara menggunakanget-stack-policy.

AWS CLI

Untuk melihat kebijakan tumpukan

get-stack-policyContoh berikut menampilkan kebijakan tumpukan untuk tumpukan tertentu. Untuk melampirkan kebijakan ke tumpukan, gunakan set-stack-policy perintah.

aws cloudformation get-stack-policy \
    --stack-name my-stack

Output:

{
    "StackPolicyBody": "{\n  \"Statement\" : [\n    {\n      \"Effect\" : \"Allow\",\n      \"Action\" : \"Update:*\",\n      \"Principal\": \"*\",\n      \"Resource\" : \"*\"\n    },\n    {\n      \"Effect\" : \"Deny\",\n      \"Action\" : \"Update:*\",\n      \"Principal\": \"*\",\n      \"Resource\" : \"LogicalResourceId/bucket\"\n    }\n  ]\n}\n"
}

  • Untuk API detailnya, lihat GetStackPolicydi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanget-template-summary.

AWS CLI

Untuk menampilkan ringkasan template

Perintah berikut menampilkan informasi ringkasan tentang sumber daya dan metadata untuk file template yang ditentukan.

aws cloudformation get-template-summary \
   --template-body file://template.yaml

Output:

{
    "Parameters": [],
    "Description": "A VPC and subnets.",
    "ResourceTypes": [
        "AWS::EC2::VPC",
        "AWS::EC2::Subnet",
        "AWS::EC2::Subnet",
        "AWS::EC2::RouteTable",
        "AWS::EC2::VPCEndpoint",
        "AWS::EC2::SubnetRouteTableAssociation",
        "AWS::EC2::SubnetRouteTableAssociation",
        "AWS::EC2::VPCEndpoint"
    ],
    "Version": "2010-09-09"
}

Contoh kode berikut menunjukkan cara menggunakanget-template.

AWS CLI

Untuk melihat badan template untuk AWS CloudFormation tumpukan

get-templatePerintah berikut 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 API detailnya, lihat GetTemplatedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-change-sets.

AWS CLI

Untuk membuat daftar set perubahan

list-change-setsContoh berikut menampilkan daftar set perubahan tertunda untuk tumpukan tertentu.

aws cloudformation list-change-sets \
   --stack-name my-stack

Output:

{
    "Summaries": [
        {
            "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204",
            "StackName": "my-stack",
            "ChangeSetId": "arn:aws:cloudformation:us-west-2:123456789012:changeSet/my-change-set/70160340-7914-xmpl-bcbf-128a1fa78b5d",
            "ChangeSetName": "my-change-set",
            "ExecutionStatus": "AVAILABLE",
            "Status": "CREATE_COMPLETE",
            "CreationTime": "2019-10-02T05:38:54.297Z"
        }
    ]
}

  • Untuk API detailnya, lihat ListChangeSetsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-exports.

AWS CLI

Untuk daftar ekspor

list-exportsContoh berikut menampilkan daftar ekspor dari tumpukan di wilayah saat ini.

aws cloudformation list-exports

Output:

{
    "Exports": [
        {
            "ExportingStackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/private-vpc/99764070-b56c-xmpl-bee8-062a88d1d800",
            "Name": "private-vpc-subnet-a",
            "Value": "subnet-07b410xmplddcfa03"
        },
        {
            "ExportingStackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/private-vpc/99764070-b56c-xmpl-bee8-062a88d1d800",
            "Name": "private-vpc-subnet-b",
            "Value": "subnet-075ed3xmplebd2fb1"
        },
        {
            "ExportingStackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/private-vpc/99764070-b56c-xmpl-bee8-062a88d1d800",
            "Name": "private-vpc-vpcid",
            "Value": "vpc-011d7xmpl100e9841"
        }
    ]
}

  • Untuk API detailnya, lihat ListExportsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-imports.

AWS CLI

Untuk daftar impor

list-importsContoh berikut mencantumkan tumpukan yang mengimpor ekspor yang ditentukan. Untuk mendapatkan daftar ekspor yang tersedia, gunakan list-exports perintah.

aws cloudformation list-imports \
    --export-name private-vpc-vpcid

Output:

{
    "Imports": [
        "my-database-stack"
    ]
}

  • Untuk API detailnya, lihat ListImportsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-stack-instances.

AWS CLI

Untuk membuat daftar instance untuk tumpukan

list-stack-instancesContoh berikut mencantumkan instance yang dibuat dari set stack yang ditentukan.

aws cloudformation list-stack-instances \
    --stack-set-name enable-config

Output contoh mencakup detail tentang tumpukan yang gagal diperbarui karena kesalahan:

{
    "Summaries": [
        {
            "StackSetId": "enable-config:296a3360-xmpl-40af-be78-9341e95bf743",
            "Region": "us-west-2",
            "Account": "123456789012",
            "StackId": "arn:aws:cloudformation:ap-northeast-1:123456789012:stack/StackSet-enable-config-35a6ac50-d9f8-4084-86e4-7da34d5de4c4/a1631cd0-e5fb-xmpl-b474-0aa20f14f06e",
            "Status": "CURRENT"
        },
        {
            "StackSetId": "enable-config:296a3360-xmpl-40af-be78-9341e95bf743",
            "Region": "us-west-2",
            "Account": "123456789012",
            "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/StackSet-enable-config-e6cac20f-xmpl-46e9-8314-53e0d4591532/eab53680-e5fa-xmpl-ba14-0a522351f81e",
            "Status": "OUTDATED",
            "StatusReason": "ResourceLogicalId:ConfigDeliveryChannel, ResourceType:AWS::Config::DeliveryChannel, ResourceStatusReason:Failed to put delivery channel 'StackSet-enable-config-e6cac20f-xmpl-46e9-8314-53e0d4591532-ConfigDeliveryChannel-1OJWJ7XD59WR0' because the maximum number of delivery channels: 1 is reached. (Service: AmazonConfig; Status Code: 400; Error Code: MaxNumberOfDeliveryChannelsExceededException; Request ID: d14b34a0-ef7c-xmpl-acf8-8a864370ae56)."
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakanlist-stack-resources.

AWS CLI

Untuk membuat daftar sumber daya dalam tumpukan

Perintah berikut 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"
            }
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakanlist-stack-set-operation-results.

AWS CLI

Untuk mencantumkan hasil operasi set tumpukan

Perintah berikut menampilkan hasil operasi pembaruan pada instance dalam kumpulan tumpukan yang ditentukan.

aws cloudformation list-stack-set-operation-results \
    --stack-set-name enable-config \
    --operation-id 35d45ebc-ed88-xmpl-ab59-0197a1fc83a0

Output:

{
    "Summaries": [
        {
            "Account": "223456789012",
            "Region": "us-west-2",
            "Status": "SUCCEEDED",
            "AccountGateResult": {
                "Status": "SKIPPED",
                "StatusReason": "Function not found: arn:aws:lambda:eu-west-1:223456789012:function:AWSCloudFormationStackSetAccountGate"
            }
        },
        {
            "Account": "223456789012",
            "Region": "ap-south-1",
            "Status": "CANCELLED",
            "StatusReason": "Cancelled since failure tolerance has exceeded"
        }
    ]
}

Catatan: SKIPPED Status untuk AccountGateResult diharapkan untuk operasi yang berhasil kecuali Anda membuat fungsi gerbang akun.

Contoh kode berikut menunjukkan cara menggunakanlist-stack-set-operations.

AWS CLI

Untuk membuat daftar operasi set tumpukan

list-stack-set-operationsContoh berikut menampilkan daftar operasi terbaru pada set stack yang ditentukan.

aws cloudformation list-stack-set-operations \
    --stack-set-name my-stack-set

Output:

{
    "Summaries": [
        {
            "OperationId": "35d45ebc-ed88-xmpl-ab59-0197a1fc83a0",
            "Action": "UPDATE",
            "Status": "SUCCEEDED",
            "CreationTimestamp": "2019-10-03T16:28:44.377Z",
            "EndTimestamp": "2019-10-03T16:42:08.607Z"
        },
        {
            "OperationId": "891aa98f-7118-xmpl-00b2-00954d1dd0d6",
            "Action": "UPDATE",
            "Status": "FAILED",
            "CreationTimestamp": "2019-10-03T15:43:53.916Z",
            "EndTimestamp": "2019-10-03T15:45:58.925Z"
        }
    ]
}

Contoh kode berikut menunjukkan cara menggunakanlist-stack-sets.

AWS CLI

Untuk membuat daftar set tumpukan

list-stack-setsContoh berikut menampilkan daftar set tumpukan di wilayah dan akun saat ini.

aws cloudformation list-stack-sets

Output:

{
    "Summaries": [
        {
            "StackSetName": "enable-config",
            "StackSetId": "enable-config:296a3360-xmpl-40af-be78-9341e95bf743",
            "Description": "Enable AWS Config",
            "Status": "ACTIVE"
        }
    ]
}

  • Untuk API detailnya, lihat ListStackSetsdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-stacks.

AWS CLI

Untuk daftar AWS CloudFormation tumpukan

list-stacksPerintah berikut menunjukkan ringkasan semua tumpukan yang memiliki statusCREATE_COMPLETE:

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

Output:

[
    {
        "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/myteststack/466df9e0-0dff-08e3-8e2f-5088487c4896",
        "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 API detailnya, lihat ListStacksdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanlist-type-registrations.

AWS CLI

Untuk membuat daftar pendaftaran lengkap dari suatu jenis

list-type-registrationsContoh berikut menampilkan daftar pendaftaran tipe lengkap untuk jenis yang ditentukan.

aws cloudformation list-type-registrations \
    --type RESOURCE \
    --type-name My::Logs::LogGroup \
    --registration-status-filter COMPLETE

Output:

{
    "RegistrationTokenList": [
        "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
        "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
        "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333"
    ]
}

Untuk informasi selengkapnya, lihat Menggunakan CloudFormation Registri di Panduan AWS CloudFormation Pengguna.

Contoh kode berikut menunjukkan cara menggunakanlist-type-versions.

AWS CLI

Untuk membuat daftar versi ekstensi

list-type-versionsContoh berikut mengembalikan informasi ringkasan tentang versi ekstensi.

aws cloudformation list-type-versions \
  --endpoint https://example.com \
  --region us-west-2 \
  --type RESOURCE \
  --type-name My::Resource::Example \
  --publisher-id 123456789012

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menggunakan AWS CloudFormation registri di Panduan AWS CloudFormation Pengguna.

Contoh kode berikut menunjukkan cara menggunakanlist-types.

AWS CLI

Untuk mencantumkan jenis sumber daya pribadi di akun

list-typesContoh berikut menampilkan daftar jenis sumber daya pribadi yang saat ini terdaftar di AWS akun saat ini.

aws cloudformation list-types

Output:

{
    "TypeSummaries": [
        {
            "Description": "WordPress blog resource for internal use",
            "LastUpdated": "2019-12-04T18:28:15.059Z",
            "TypeName": "My::WordPress::BlogExample",
            "TypeArn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/My-WordPress-BlogExample",
            "DefaultVersionId": "00000005",
            "Type": "RESOURCE"
        },
        {
            "Description": "Customized resource derived from AWS::Logs::LogGroup",
            "LastUpdated": "2019-12-04T18:28:15.059Z",
            "TypeName": "My::Logs::LogGroup",
            "TypeArn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/My-Logs-LogGroup",
            "DefaultVersionId": "00000003",
            "Type": "RESOURCE"
        }
    ]
}

Untuk informasi selengkapnya, lihat Menggunakan CloudFormation Registri di Panduan AWS CloudFormation Pengguna.

  • Untuk API detailnya, lihat ListTypesdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanpackage.

AWS CLI

Perintah berikut mengekspor template bernama template.json dengan mengunggah artefak lokal ke bucket S3 bucket-name dan menulis template yang diekspor ke: packaged-template.json

aws cloudformation package --template-file /path_to_template/template.json --s3-bucket bucket-name --output-template-file packaged-template.json --use-json

  • Untuk API detailnya, lihat Package in AWS CLI Command Reference.

Contoh kode berikut menunjukkan cara menggunakanpublish-type.

AWS CLI

Untuk mempublikasikan ekstensi

publish-typeContoh berikut menerbitkan ekstensi yang ditentukan ke CloudFormation registri sebagai ekstensi publik di Wilayah ini.

aws cloudformation publish-type \
  --region us-west-2 \
  --type RESOURCE \
  --type-name Example::Test::1234567890abcdef0

Output:

{
    "PublicTypeArn":"arn:aws:cloudformation:us-west-2::type/resource/000q6TfUovXsEMmgKowxDZLlwqr2QUshd2e75c8c/Example-Test-1234567890abcdef0/1.0.0"
}

Untuk informasi selengkapnya, lihat Menggunakan AWS CloudFormation registri di Panduan AWS CloudFormation Pengguna.

  • Untuk API detailnya, lihat PublishTypedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanregister-publisher.

AWS CLI

Untuk mendaftarkan penerbit

register-publisherContoh berikut mendaftarkan penerbit dan menerima parameter syarat dan kondisi.

aws cloudformation register-publisher \
  --region us-west-2 \
  --accept-terms-and-conditions

Output:

{
    "PublisherId": "000q6TfUovXsEMmgKowxDZLlwqr2QUshd2e75c8c"
}

Untuk informasi selengkapnya, lihat Menggunakan AWS CloudFormation registri di Panduan AWS CloudFormation Pengguna.

Contoh kode berikut menunjukkan cara menggunakanregister-type.

AWS CLI

Untuk mendaftarkan jenis sumber daya

register-typeContoh berikut mendaftarkan jenis sumber daya yang ditentukan sebagai tipe sumber daya pribadi di akun pengguna.

aws cloudformation register-type \
    --type-name My::Organization::ResourceName \
    --schema-handler-package s3://bucket_name/my-organization-resource_name.zip \
    --type RESOURCE

Output:

{
    "RegistrationToken": "f5525280-104e-4d35-bef5-8f1f1example"
}

Untuk informasi selengkapnya, lihat Mendaftarkan Penyedia Sumber Daya di Panduan Pengguna Antarmuka Baris CloudFormation Perintah untuk Pengembangan Jenis.

  • Untuk API detailnya, lihat RegisterTypedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanset-stack-policy.

AWS CLI

Untuk menerapkan kebijakan tumpukan

set-stack-policyContoh berikut menonaktifkan pembaruan untuk sumber daya yang ditentukan dalam tumpukan yang ditentukan. stack-policy.jsonadalah JSON dokumen yang mendefinisikan operasi yang diizinkan pada sumber daya di tumpukan.

aws cloudformation set-stack-policy \
    --stack-name my-stack \
    --stack-policy-body file://stack-policy.json

Output:

{
  "Statement" : [
    {
      "Effect" : "Allow",
      "Action" : "Update:*",
      "Principal": "*",
      "Resource" : "*"
    },
    {
      "Effect" : "Deny",
      "Action" : "Update:*",
      "Principal": "*",
      "Resource" : "LogicalResourceId/bucket"
    }
  ]
}

  • Untuk API detailnya, lihat SetStackPolicydi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanset-type-configuration.

AWS CLI

Untuk mengkonfigurasi data

set-type-configurationContoh berikut menentukan data konfigurasi untuk CloudFormation ekstensi terdaftar, di akun yang diberikan dan Wilayah.

aws cloudformation set-type-configuration \
    --region us-west-2 \
    --type RESOURCE \
    --type-name Example::Test::Type \
    --configuration-alias default \
    --configuration "{\"CredentialKey\": \"testUserCredential\"}"

Output:

{
    "ConfigurationArn": "arn:aws:cloudformation:us-west-2:123456789012:type-configuration/resource/Example-Test-Type/default"
}

Untuk informasi selengkapnya, lihat Menggunakan AWS CloudFormation registri di Panduan AWS CloudFormation Pengguna.

Contoh kode berikut menunjukkan cara menggunakanset-type-default-version.

AWS CLI

Untuk menyetel versi default tipe

set-type-default-versionContoh berikut menetapkan versi tipe tertentu yang akan digunakan sebagai default untuk jenis ini.

aws cloudformation set-type-default-version \
    --type RESOURCE \
    --type-name My::Logs::LogGroup \
    --version-id 00000003

Perintah ini tidak menghasilkan output.

Untuk informasi selengkapnya, lihat Menggunakan CloudFormation Registri di Panduan AWS CloudFormation Pengguna.

Contoh kode berikut menunjukkan cara menggunakansignal-resource.

AWS CLI

Untuk memberi sinyal sumber daya

signal-resourceContoh berikut sinyal success untuk memenuhi kondisi tunggu bernama MyWaitCondition dalam tumpukan bernamamy-stack.

aws cloudformation signal-resource \
    --stack-name my-stack \
    --logical-resource-id MyWaitCondition \
    --unique-id 1234 \
    --status SUCCESS

Perintah ini tidak menghasilkan output.

  • Untuk API detailnya, lihat SignalResourcedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanstop-stack-set-operation.

AWS CLI

Untuk menghentikan operasi set tumpukan

stop-stack-set-operationContoh berikut menghentikan operasi pembaruan dalam progess pada set tumpukan yang ditentukan.

aws cloudformation stop-stack-set-operation \
    --stack-set-name my-stack-set \
    --operation-id 1261cd27-490b-xmpl-ab42-793a896c69e6

Perintah ini tidak menghasilkan output.

Contoh kode berikut menunjukkan cara menggunakantest-type.

AWS CLI

Untuk menguji ekstensi

test-typeContoh berikut menguji ekstensi terdaftar untuk memastikannya memenuhi semua persyaratan yang diperlukan untuk dipublikasikan di CloudFormation registri.

aws cloudformation test-type \
    --arn arn:aws:cloudformation:us-west-2:123456789012:type/resource/Sample-Test-Resource123/00000001

Output:

{
    "TypeVersionArn": "arn:aws:cloudformation:us-west-2:123456789012:type/resource/Sample-Test-Resource123/00000001"
}

Untuk informasi selengkapnya, lihat Menggunakan AWS CloudFormation registri di Panduan AWS CloudFormation Pengguna.

  • Untuk API detailnya, lihat TestTypedi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanupdate-stack-instances.

AWS CLI

Untuk memperbarui instance tumpukan

update-stack-instancesContoh berikut mencoba ulang pembaruan pada instance tumpukan di dua akun di dua wilayah dengan pengaturan terbaru. Pengaturan toleransi kesalahan yang ditentukan memastikan bahwa pembaruan dicoba di semua akun dan wilayah, bahkan jika beberapa tumpukan tidak dapat diperbarui.

aws cloudformation update-stack-instances \
    --stack-set-name my-stack-set \
    --accounts 123456789012 567890123456 \
    --regions us-east-1 us-west-2 \
    --operation-preferences FailureToleranceCount=3

Output:

{
    "OperationId": "103ebdf2-21ea-xmpl-8892-de5e30733132"
}

Contoh kode berikut menunjukkan cara menggunakanupdate-stack-set.

AWS CLI

Untuk memperbarui set tumpukan

update-stack-setContoh berikut menambahkan tag dengan nama kunci Owner dan nilai IT untuk instance stack dalam set stack yang ditentukan.

aws cloudformation update-stack-set \
    --stack-set-name my-stack-set \
    --use-previous-template \
    --tags Key=Owner,Value=IT

Output:

{
    "OperationId": "e2b60321-6cab-xmpl-bde7-530c6f47950e"
}

  • Untuk API detailnya, lihat UpdateStackSetdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanupdate-stack.

AWS CLI

Untuk memperbarui AWS CloudFormation tumpukan

update-stackPerintah berikut 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

update-stackPerintah berikut memperbarui hanya nilai SubnetIDs 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

update-stackPerintah berikut menambahkan dua topik notifikasi mystack tumpukan ke 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-east-1:123456789012:mytopic2"

Untuk informasi selengkapnya, lihat AWS CloudFormation tumpukan pembaruan di Panduan AWS CloudFormation Pengguna.

  • Untuk API detailnya, lihat UpdateStackdi Referensi AWS CLI Perintah.

Contoh kode berikut menunjukkan cara menggunakanupdate-termination-protection.

AWS CLI

Untuk mengaktifkan perlindungan terminasi

update-termination-protectionContoh berikut memungkinkan perlindungan terminasi pada tumpukan yang ditentukan.

aws cloudformation update-termination-protection \
    --stack-name my-stack \
    --enable-termination-protection

Output:

{
    "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/d0a825a0-e4cd-xmpl-b9fb-061c69e99204"
}

Contoh kode berikut menunjukkan cara menggunakanvalidate-template.

AWS CLI

Untuk memvalidasi template AWS CloudFormation

validate-templatePerintah berikut memvalidasi sampletemplate.json template:

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

Output:

{
    "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.",
    "Parameters": [],
    "Capabilities": []
}

Untuk informasi selengkapnya, lihat Bekerja dengan AWS CloudFormation Template di Panduan AWS CloudFormation Pengguna.