CloudFormation Beispiele mit AWS CLI

So aktivieren Sie einen Typ

Im folgenden Beispiel für activate-type wird eine öffentliche Erweiterung eines Drittanbieters aktiviert und für die Verwendung in Stack-Vorlagen zur Verfügung gestellt.

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

Ausgabe:

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

Weitere Informationen finden Sie im AWS CloudFormation Benutzerhandbuch unter Verwenden der AWS CloudFormation Registrierung.

So beschreiben Sie eine Typkonfiguration stapelweise

Im folgenden Beispiel für batch-describe-type-configurations werden die Daten für den Typ konfiguriert.

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"

Ausgabe:

{
    "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"
        }
    ]
}

Weitere Informationen finden Sie im AWS CloudFormation Benutzerhandbuch unter Verwenden der AWS CloudFormation Registrierung.

So brechen Sie eine Stack-Aktualisierung ab, die gerade ausgeführt wird

Der folgende cancel-update-stack-Befehl bricht eine Stackaktualisierung auf dem myteststack-Stack ab:

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

So wiederholen Sie einen Update-Rollback

Das folgende continue-update-rollback-Beispiel setzt einen Rollback-Vorgang nach einer zuvor fehlgeschlagenen Stack-Aktualisierung fort.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Um einen Änderungssatz zu erstellen

Im folgenden Beispiel für create-change-set wird ein Änderungssatz mit der CAPABILITY_IAM-Fähigkeit erstellt. Die Datei template.yaml ist eine AWS CloudFormation Vorlage im aktuellen Ordner, die einen Stapel definiert, der IAM-Ressourcen enthält.

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

Ausgabe:

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

Um eine generierte Vorlage aus gescannten Ressourcen zu erstellen

Im folgenden create-generated-template Beispiel wird eine generierte Vorlage erstellt, die MyTemplate aus gescannten Ressourcen benannt wurde.

aws cloudformation create-generated-template \
    --generated-template-name MyTemplate \
    --resources file://resources.json

Inhalt von resources.json:

[
    {
        "ResourceType": "AWS::EKS::Cluster",
        "LogicalResourceId":"MyCluster",
        "ResourceIdentifier": {
            "ClusterName": "MyAppClusterName"
        }
    },
    {
        "ResourceType": "AWS::AutoScaling::AutoScalingGroup",
        "LogicalResourceId":"MyASG",
        "ResourceIdentifier": {
            "AutoScalingGroupName": "MyAppASGName"
        }
    },
    {
        "ResourceType": "AWS::EKS::Nodegroup",
        "LogicalResourceId":"MyNodegroup",
        "ResourceIdentifier": {
            "NodegroupName": "MyAppNodegroupName"
        }
    },
    {
        "ResourceType": "AWS::IAM::Role",
        "LogicalResourceId":"MyRole",
        "ResourceIdentifier": {
            "RoleId": "arn:aws::iam::123456789012:role/MyAppIAMRole"
        }
    }
]

Ausgabe:

{
  "Arn":
    "arn:aws:cloudformation:us-east-1:123456789012:generatedtemplate/7fc8512c-d8cb-4e02-b266-d39c48344e48",
  "Name": "MyTemplate"
}

Weitere Informationen finden Sie im AWS CloudFormation Benutzerhandbuch unter Erstellen einer CloudFormation Vorlage aus Ressourcen, die mit dem IaC-Generator gescannt wurden.

So erstellen Sie Stack-Instances

Im folgenden Beispiel für create-stack-instances werden Instances eines Stack-Sets in zwei Konten und vier Regionen erstellt. Die Einstellung für die Fehlertoleranz stellt sicher, dass die Aktualisierung in allen Konten und Regionen versucht wird, auch wenn einige Stacks nicht erstellt werden können.

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

Ausgabe:

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

Verwenden Sie den Befehl create-stack-set, um einen Stack zu erstellen.

Um die Stack-Definition für eine Stack-Refactor-Operation zu erstellen

Im folgenden create-stack-refactor Beispiel wird die Stack-Definition für das Stack-Refactoring erstellt.

aws cloudformation create-stack-refactor \
    --stack-definitions \
      StackName=Stack1,TemplateBody@=file://template1-updated.yaml \
      StackName=Stack2,TemplateBody@=file://template2-updated.yaml

Ausgabe:

{
    "StackRefactorId": "9c384f70-4e07-4ed7-a65d-fee5eb430841"
}

Weitere Informationen finden Sie unter Stack-Refactoring im Benutzerhandbuch.AWS CloudFormation

So erstellen Sie ein Stack-Set

Das folgende create-stack-set Beispiel erstellt ein Stack-Set unter Verwendung der angegebenen YAML-Dateivorlage. template.yamlist eine AWS CloudFormation Vorlage im aktuellen Ordner, die einen Stapel definiert.

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

Ausgabe:

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

Führen Sie den create-stack-instances-Befehl aus, um Stack-Instances zum Stack-Set hinzuzufügen.

Um einen AWS CloudFormation Stapel zu erstellen

Der folgende Befehl create-stacks erstellt einen Stapel mit dem Namen myteststack unter Verwendung der Vorlage sampletemplate.json :

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

Ausgabe:

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

Weitere Informationen finden Sie unter Stacks im AWS CloudFormation Benutzerhandbuch.

So deaktivieren Sie einen Typ

Im folgenden Beispiel für deactivate-type wird eine öffentliche Erweiterung deaktiviert, die zuvor in diesem Konto und in dieser Region aktiviert war.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie im AWS CloudFormation Benutzerhandbuch unter Verwenden der AWS CloudFormation Registrierung.

Um einen Änderungssatz zu löschen

Im folgenden Beispiel für delete-change-set wird ein Änderungssatz gelöscht, indem der Name des Änderungssatzes und der Name des Stacks angegeben werden.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Im folgenden Beispiel für delete-change-set wird ein Änderungssatz gelöscht, indem der vollständige ARN des Änderungssatzes angegeben wird.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Um eine generierte Vorlage zu löschen

Im folgenden delete-generated-template Beispiel wird die angegebene Vorlage gelöscht.

aws cloudformation delete-generated-template \
    --generated-template-name MyTemplate

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie im AWS CloudFormation Benutzerhandbuch unter Generieren von Vorlagen aus vorhandenen Ressourcen.

So löschen Sie Stack-Instances

Im folgenden Beispiel für delete-stack-instances werden Instances eines Stack-Satzes in zwei Konten und vier Regionen gelöscht und die Stack beendet.

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

Ausgabe:

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

Verwenden Sie den Befehl delete-stack-set, um einen leeren Stack-Satz zu löschen.

So löschen Sie einen Stack-Satz

Mit dem folgenden Befehl wird der angegebene leere Stack-Satz gelöscht. Das Stack-Set muss leer sein.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Führen Sie den delete-stack-instances-Befehl aus, um Instances auf dem Stack-Satz zu löschen.

So löschen Sie einen Stack

Das folgende Beispiel delete-stack löscht den angegebenen Stapel.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Mit dem folgenden Befehl wird eine Vorlage namens template.json für einen Stack mit dem Namen my-new-stack bereitgestellt:

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

So heben Sie die Registrierung einer Typversion auf

Das folgende deregister-type Beispiel entfernt die angegebene Typversion aus der aktiven Verwendung in der CloudFormation Registrierung, sodass sie nicht mehr in CloudFormation Vorgängen verwendet werden kann.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie im AWS CloudFormation Benutzerhandbuch unter Verwenden der CloudFormation Registrierung.

So rufen Sie Informationen über Ihre Kontolimits ab

Mit dem folgenden Befehl wird eine Liste der regionalen Limits für das aktuelle Konto abgerufen.

aws cloudformation describe-account-limits

Ausgabe:

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

So rufen Sie Informationen über einen Änderungssatz ab

Im folgenden Beispiel für describe-change-set werden die Details des Änderungssatzes angezeigt, der mit dem Namen des Änderungssatzes und dem Namen des Stacks angegeben wird.

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

Im folgenden Beispiel für describe-change-set werden die Details des Änderungssatzes angezeigt, der mit dem vollständigen ARN des Änderungssatzes angegeben wird:

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

Ausgabe:

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

Um eine generierte Vorlage zu beschreiben

Das folgende describe-generated-template Beispiel beschreibt die angegebene Vorlage.

aws cloudformation describe-generated-template \
    --generated-template-name MyTemplate

Ausgabe:

{
    "GeneratedTemplateId": "arn:aws:cloudformation:us-east-1:123456789012:generatedTemplate/7d881acf-f307-4ded-910e-f8fb49b96894",
    "GeneratedTemplateName": "MyTemplate",
    "Resources": [
        {
            "ResourceType": "AWS::EC2::SecurityGroup",
            "LogicalResourceId": "EC2SecurityGroup",
            "ResourceIdentifier": {
                "Id": "sg-1234567890abcdef0"
            },
            "ResourceStatus": "COMPLETE",
            "ResourceStatusReason": "Resource Template complete",
            "Warnings": []
        },
        {
            "ResourceType": "AWS::EC2::Instance",
            "LogicalResourceId": "EC2Instance",
            "ResourceIdentifier": {
                "InstanceId": "i-1234567890abcdef0"
            },
            "ResourceStatus": "COMPLETE",
            "ResourceStatusReason": "Resource Template complete",
            "Warnings": []
        },
        {
            "ResourceType": "AWS::EC2::KeyPair",
            "LogicalResourceId": "EC2KeyPairSshkeypair",
            "ResourceIdentifier": {
                "KeyName": "sshkeypair"
            },
            "ResourceStatus": "COMPLETE",
            "ResourceStatusReason": "Resource Template complete",
            "Warnings": []
        }
    ],
    "Status": "COMPLETE",
    "StatusReason": "All resources complete",
    "CreationTime": "2025-09-23T19:38:06.435000+00:00",
    "LastUpdatedTime": "2025-09-23T19:38:10.798000+00:00",
    "Progress": {
        "ResourcesSucceeded": 3,
        "ResourcesFailed": 0,
        "ResourcesProcessing": 0,
        "ResourcesPending": 0
    },
    "TemplateConfiguration": {
        "DeletionPolicy": "RETAIN",
        "UpdateReplacePolicy": "RETAIN"
    },
    "TotalWarnings": 0
}

Weitere Informationen finden Sie im AWS CloudFormation Benutzerhandbuch unter Generieren von Vorlagen aus vorhandenen Ressourcen.

So beschreiben Sie einen Publisher

Im folgenden Beispiel für describe-publisher werden die Informationen für einen Publisher konfiguriert.

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

Ausgabe:

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

Weitere Informationen finden Sie im AWS CloudFormation Benutzerhandbuch unter Verwenden der AWS CloudFormation Registrierung.

Um einen Ressourcenscan zu beschreiben

Das folgende describe-resource-scan Beispiel beschreibt den Ressourcenscan mit der angegebenen Scan-ID.

aws cloudformation describe-resource-scan --region \
    --resource-scan-id arn:aws:cloudformation:us-east-1:123456789012:resourceScan/0a699f15-489c-43ca-a3ef-3e6ecfa5da60

Ausgabe:

{
    "ResourceScanId": "arn:aws:cloudformation:us-east-1:123456789012:resourceScan/0a699f15-489c-43ca-a3ef-3e6ecfa5da60",
    "Status": "COMPLETE",
    "StartTime": "2025-08-21T03:10:38.485000+00:00",
    "EndTime": "2025-08-21T03:20:28.485000+00:00",
    "PercentageCompleted": 100.0,
    "ResourceTypes": [
        "AWS::CloudFront::CachePolicy",
        "AWS::CloudFront::OriginRequestPolicy",
        "AWS::EC2::DHCPOptions",
        "AWS::EC2::InternetGateway",
        "AWS::EC2::KeyPair",
        "AWS::EC2::NetworkAcl",
        "AWS::EC2::NetworkInsightsPath",
        "AWS::EC2::NetworkInterface",
        "AWS::EC2::PlacementGroup",
        "AWS::EC2::Route",
        "AWS::EC2::RouteTable",
        "AWS::EC2::SecurityGroup",
        "AWS::EC2::Subnet",
        "AWS::EC2::SubnetCidrBlock",
        "AWS::EC2::SubnetNetworkAclAssociation",
        "AWS::EC2::SubnetRouteTableAssociation",
        ...
    ],
    "ResourcesRead": 676
}

Weitere Informationen finden Sie im AWS CloudFormation Benutzerhandbuch unter Generieren von Vorlagen aus vorhandenen Ressourcen.

So überprüfen Sie den Status einer Operation zur Abweichungserkennung

Im folgenden Beispiel für describe-stack-drift-detection-status wird der Status einer Operation zur Abweichungserkennung angezeigt. Führen Sie den Befehl detect-stack-drift aus, um die ID abzurufen.

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

Ausgabe:

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

So beschreiben Sie Stack-Ereignisse

Das folgende Beispiel describe-stack-events zeigt die 2 jüngsten Ereignisse für den angegebenen Stapel an.

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

So beschreiben Sie eine Stack-Instance

Der folgende Befehl beschreibt eine Instance des angegebenen Stack-Satzes im spezifizierten Konto und der angegebenen Region. Der Stack-Satz befindet sich in der aktuellen Region und dem aktuellen Konto, während sich die Instance in der us-west-2-Region im Konto 123456789012 befindet.

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

Ausgabe:

{
    "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=)."
    }
}

Um einen Stack-Refactoring-Vorgang zu beschreiben

Das folgende describe-stack-refactor Beispiel beschreibt den Stack-Refactoring-Vorgang mit der angegebenen Stack-Refactor-ID.

aws cloudformation describe-stack-refactor \
    --stack-refactor-id 9c384f70-4e07-4ed7-a65d-fee5eb430841

Ausgabe:

{
    "StackRefactorId": "9c384f70-4e07-4ed7-a65d-fee5eb430841",
    "StackIds": [
        "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack1/3e6a1ff0-94b1-11f0-aa6f-0a88d2e03acf",
        "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack2/5da91650-94b1-11f0-81cf-0a23500e151b"
    ],
    "ExecutionStatus": "AVAILABLE",
    "Status": "CREATE_COMPLETE"
}

Weitere Informationen finden Sie unter Stack-Refactoring im Benutzerhandbuch.AWS CloudFormation

So rufen Sie Informationen über Ressourcen ab, die von der Stack-Definition abweichen

Der folgende Befehl zeigt Informationen zu den angegebenen Stack an. Verwenden Sie den detect-stack-drift-Befehl, um die Abweichungserkennung zu initiieren.

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

Die Ausgabe zeigt eine AWS Lambda-Funktion, die geändert wurde: 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"
        }
    ]
}

So erhalten Sie Informationen zu einer Stack-Ressource

Das folgende Beispiel describe-stack-resource zeigt Details für die Ressource mit dem Namen MyFunction im angegebenen Stapel an.

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

Ausgabe:

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

So erhalten Sie Informationen zu einer Stack-Ressource

Das folgende Beispiel describe-stack-resources zeigt Details zu den Ressourcen im angegebenen Stapel an.

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

Ausgabe:

{
    "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"
            }
        }
    ]
}

So rufen Sie Informationen über eine Stack-Satz-Operation ab

Das folgende describe-stack-set-operation `-Beispiel zeigt Details für einen Aktualisierungsvorgang auf dem angegebenen Stack-Set an.

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

Ausgabe:

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

So rufen Sie Informationen über einen Stack-Satz ab

Das folgende describe-stack-set `-Beispiel zeigt Details zum angegebenen Stack-Set an.

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

Ausgabe:

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

Um AWS CloudFormation Stapel zu beschreiben

Der folgende describe-stacks-Befehl zeigt eine Zusammenfassung der Informationen für den myteststack-Stack:

aws cloudformation describe-stacks --stack-name myteststack

Ausgabe:

{
    "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
        }
    ]
}

Weitere Informationen finden Sie unter Stacks im AWS CloudFormation Benutzerhandbuch.

So zeigen Sie Informationen zur Typregistrierung an

Im folgenden Beispiel für describe-type-registration werden Informationen zur angegebenen Typregistrierung angezeigt, einschließlich des aktuellen Status, des Typs und der Version des Typs.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Using the CloudFormation Registry im AWS CloudFormation Benutzerhandbuch.

So zeigen Sie Typinformationen an

Im folgenden Beispiel für describe-type werden Informationen für den angegebenen Typ angezeigt.

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

Ausgabe:

{
    "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]"
}

Weitere Informationen finden Sie unter Using the CloudFormation Registry im AWS CloudFormation Benutzerhandbuch.

So erkennen Sie abweichende Ressourcen

Im folgenden Beispiel für detect-stack-drift wird die Abweichungserkennung für den angegebenen Stack initiiert.

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

Ausgabe:

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

Sie können diese ID dann zusammen mit dem Befehl describe-stack-resource-drifts verwenden, um abweichende Ressourcen zu beschreiben.

So erkennen Sie eine Abweichung für eine Ressource

Im folgenden Beispiel für detect-stack-resource-drift wird eine Ressource mit dem Namen MyFunction in einem Stack mit dem Namen MyStack auf Abweichungen überprüft:

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

Die Ausgabe zeigt eine AWS Lambda-Funktion, die geändert wurde: 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"
    }
}

So erkennen Sie eine Abweichung in einem Stack-Satz und allen zugehörigen Stack-Instances

Im folgenden Beispiel für detect-stack-set-drift werden Operationen zur Abweichungserkennung für den angegebenen Stack-Satz initiiert, einschließlich aller diesem Stack-Satz zugeordneter Stack-Instances. Außerdem wird eine Operations-ID zurückgegeben, mit der der Status der Abweichungsoperation verfolgt werden kann.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Erkennen nicht verwalteter Konfigurationsänderungen in Stacksets im AWS CloudFormation Benutzerhandbuch.

So schätzen Sie die Kosten für eine Vorlage ein

Im folgenden Beispiel für estimate-template-cost wird eine Kostenschätzung für eine Vorlage mit dem Namen template.yaml im aktuellen Ordner erstellt.

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

Ausgabe:

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

Um einen Änderungssatz auszuführen

Im folgenden Beispiel für execute-change-set wird ein Änderungssatz ausgeführt, der durch den Namen des Änderungssatzes und den Namen des Stacks angegeben wird.

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

Im folgenden Beispiel für execute-change-set wird ein Änderungssatz ausgeführt, der durch den vollständigen ARN des Änderungssatzes angegeben wird.

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

Um einen Stack-Refactoring-Vorgang abzuschließen

Im folgenden execute-stack-refactor Beispiel wird der Stack-Refactor-Vorgang mit der angegebenen Stack-Refactor-ID abgeschlossen.

aws cloudformation execute-stack-refactor \
    --stack-refactor-id 9c384f70-4e07-4ed7-a65d-fee5eb430841

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Stack-Refactoring im Benutzerhandbuch.AWS CloudFormation

So zeigen Sie eine Stack-Richtlinie an

Im folgenden Beispiel für get-stack-policy wird die Stack-Richtlinie für den angegebenen Stack angezeigt. Verwenden Sie den set-stack-policy-Befehl, um eine Richtlinie einem Stack anzufügen.

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

Ausgabe:

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

So zeigen Sie eine Vorlagenzusammenfassung an

Mit dem folgenden Befehl werden zusammenfassende Informationen über die Ressourcen und Metadaten für die angegebene Vorlagendatei angezeigt.

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

Ausgabe:

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

Um den Vorlagentext für einen AWS CloudFormation Stapel anzuzeigen

Der folgende Befehl get-template zeigt die Vorlage für den Stapel myteststack :

aws cloudformation get-template --stack-name myteststack

Ausgabe:

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

So listen Sie Änderungssätze auf

Im folgenden Beispiel für list-change-sets wird eine Liste der ausstehenden Änderungssätze für den angegebenen Stack angezeigt.

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

Ausgabe:

{
    "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"
        }
    ]
}

So listen Sie Exporte auf

Im folgenden Beispiel für list-exports wird eine Liste der Exporte aus Stacks in der aktuellen Region angezeigt.

aws cloudformation list-exports

Ausgabe:

{
    "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"
        }
    ]
}

Um generierte Vorlagen aufzulisten

Das folgende list-generated-templates Beispiel listet alle generierten Vorlagen auf.

aws cloudformation list-generated-templates

Ausgabe:

{
    "Summaries": [
        {
            "GeneratedTemplateId": "arn:aws:cloudformation:us-east-1:123456789012:generatedtemplate/7fc8512c-d8cb-4e02-b266-d39c48344e48",
            "GeneratedTemplateName": "MyTemplate",
            "Status": "COMPLETE",
            "StatusReason": "All resources complete",
            "CreationTime": "2025-09-23T20:13:24.283000+00:00",
            "LastUpdatedTime": "2025-09-23T20:13:28.610000+00:00",
            "NumberOfResources": 4
        },
        {
            "GeneratedTemplateId": "arn:aws:cloudformation:us-east-1:123456789012:generatedTemplate/f10dd1c4-edc6-4823-8153-ab6112b8d051",
            "GeneratedTemplateName": "MyEC2InstanceTemplate",
            "Status": "COMPLETE",
            "StatusReason": "All resources complete",
            "CreationTime": "2024-08-08T19:35:49.790000+00:00",
            "LastUpdatedTime": "2024-08-08T19:35:52.207000+00:00",
            "NumberOfResources": 3
        },
        {
            "GeneratedTemplateId": "arn:aws:cloudformation:us-east-1:123456789012:generatedTemplate/e5a1c89f-7ce2-41bd-9bdf-75b7c852e3ca",
            "GeneratedTemplateName": "MyEKSNodeGroupTemplate",
            "Status": "COMPLETE",
            "StatusReason": "All resources complete",
            "CreationTime": "2024-07-16T20:39:27.883000+00:00",
            "LastUpdatedTime": "2024-07-16T20:39:35.766000+00:00",
            "NumberOfResources": 4
        }
    ]
}

Weitere Informationen finden Sie im AWS CloudFormation Benutzerhandbuch unter Generieren von Vorlagen aus vorhandenen Ressourcen.

So listen Sie Importe auf

Im folgenden Beispiel für list-imports werden die Stacks aufgelistet, die den angegebenen Export importieren. Verwenden Sie den Befehl list-exports, um die Liste der verfügbaren Exporte abzurufen.

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

Ausgabe:

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

Um verwandte Ressourcen aus einem Ressourcenscan aufzulisten

Im folgenden list-resource-scan-related-resources Beispiel werden Ressourcen aus dem angegebenen Ressourcenscan aufgeführt, die sich auf Ressourcen in beziehenresources.json.

aws cloudformation list-resource-scan-related-resources \
    --resource-scan-id arn:aws:cloudformation:us-east-1:123456789012:resourceScan/0a699f15-489c-43ca-a3ef-3e6ecfa5da60 \
    --resources file://resources.json

Inhalt von resources.json:

[
    {
        "ResourceType": "AWS::EKS::Cluster",
        "ResourceIdentifier": {
            "ClusterName": "MyAppClusterName"
        }
    },
    {
        "ResourceType": "AWS::AutoScaling::AutoScalingGroup",
        "ResourceIdentifier": {
            "AutoScalingGroupName": "MyAppASGName"
        }
    }
]

Ausgabe:

{
    "RelatedResources": [
        {
            "ResourceType": "AWS::EKS::Nodegroup",
            "ResourceIdentifier": {
                "NodegroupName": "MyAppNodegroupName"
            },
            "ManagedByStack": false
        },
        {
            "ResourceType": "AWS::IAM::Role",
            "ResourceIdentifier": {
                "RoleId": "arn:aws::iam::123456789012:role/MyAppIAMRole"
            },
            "ManagedByStack": false
        }
    ]
}

Weitere Informationen finden Sie im AWS CloudFormation Benutzerhandbuch unter Erstellen einer CloudFormation Vorlage aus Ressourcen, die mit dem IaC-Generator gescannt wurden.

Um Ressourcen aus einem Ressourcenscan aufzulisten

Das folgende list-resource-scan-resources Beispiel listet Ressourcen aus dem angegebenen Ressourcenscan auf, gefiltert nach der Ressourcen-ID.

aws cloudformation list-resource-scan-resources \
    --resource-scan-id arn:aws:cloudformation:us-east-1:123456789012:resourceScan/0a699f15-489c-43ca-a3ef-3e6ecfa5da60 \
    --resource-identifier MyApp

Ausgabe:

{
    "Resources": [
        {
            "ResourceType": "AWS::EKS::Cluster",
            "ResourceIdentifier": {
                "ClusterName": "MyAppClusterName"
            },
            "ManagedByStack": false
        },
        {
            "ResourceType": "AWS::AutoScaling::AutoScalingGroup",
            "ResourceIdentifier": {
                "AutoScalingGroupName": "MyAppASGName"
            },
            "ManagedByStack": false
        }
    ]
}

Weitere Informationen finden Sie im AWS CloudFormation Benutzerhandbuch unter Erstellen einer CloudFormation Vorlage aus Ressourcen, die mit dem IaC-Generator gescannt wurden.

So listen Sie Instances für einen Stack auf

Im folgenden Beispiel für list-stack-instances werden die Instances aufgelistet, die aus dem angegebenen Stack-Satz erstellt wurden.

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

Die Beispielausgabe enthält Details zu einem Stack, der aufgrund eines Fehlers nicht aktualisiert werden konnte:

{
    "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)."
        }
    ]
}

Um Aktionen für einen Stack-Refactoring-Vorgang aufzulisten

Das folgende list-stack-refactor-actions Beispiel listet Aktionen für den Stack-Refactoring-Vorgang mit der angegebenen Stack-Refactor-ID auf.

aws cloudformation list-stack-refactor-actions \
    --stack-refactor-id 9c384f70-4e07-4ed7-a65d-fee5eb430841

Ausgabe:

{
    "StackRefactorActions": [
        {
            "Action": "MOVE",
            "Entity": "RESOURCE",
            "PhysicalResourceId": "MyTestLambdaRole",
            "Description": "No configuration changes detected.",
            "Detection": "AUTO",
            "TagResources": [],
            "UntagResources": [],
            "ResourceMapping": {
                "Source": {
                    "StackName": "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack1/3e6a1ff0-94b1-11f0-aa6f-0a88d2e03acf",
                    "LogicalResourceId": "MyLambdaRole"
                },
                "Destination": {
                    "StackName": "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack2/5da91650-94b1-11f0-81cf-0a23500e151b",
                    "LogicalResourceId": "MyLambdaRole"
                }
            }
        },
        {
            "Action": "MOVE",
            "Entity": "RESOURCE",
            "PhysicalResourceId": "MyTestFunction",
            "Description": "Resource configuration changes will be validated during refactor execution.",
            "Detection": "AUTO",
            "TagResources": [
                {
                    "Key": "aws:cloudformation:stack-name",
                    "Value": "Stack2"
                },
                {
                    "Key": "aws:cloudformation:logical-id",
                    "Value": "MyFunction"
                },
                {
                    "Key": "aws:cloudformation:stack-id",
                    "Value": "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack2/5da91650-94b1-11f0-81cf-0a23500e151b"
                }
            ],
            "UntagResources": [
                "aws:cloudformation:stack-name",
                "aws:cloudformation:logical-id",
                "aws:cloudformation:stack-id"
            ],
            "ResourceMapping": {
                "Source": {
                    "StackName": "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack1/3e6a1ff0-94b1-11f0-aa6f-0a88d2e03acf",
                    "LogicalResourceId": "MyFunction"
                },
                "Destination": {
                    "StackName": "arn:aws:cloudformation:us-east-1:123456789012:stack/Stack2/5da91650-94b1-11f0-81cf-0a23500e151b",
                    "LogicalResourceId": "MyFunction"
                }
            }
        }
    ]
}

Weitere Informationen finden Sie unter Stack-Refactoring im Benutzerhandbuch.AWS CloudFormation

So listen Sie Ressourcen in einem Stack auf

Der folgende Befehl zeigt die Liste der Ressourcen im angegebenen Stapel an.

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

Ausgabe:

{
    "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"
            }
        }
    ]
}

So listen Sie die Ergebnisse von Stack-Satz-Operationen auf

Mit dem folgenden Befehl werden die Ergebnisse einer Aktualisierungsoperation für Instances im angegebenen Stack-Satz angezeigt.

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

Ausgabe:

{
    "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"
        }
    ]
}

Hinweis: Der Status SKIPPED für AccountGateResult wird für erfolgreiche Operationen erwartet, sofern Sie keine Konto-Gate-Funktion erstellen.

So listen Sie Stack-Satz-Operationen auf

Im folgenden Beispiel für list-stack-set-operations wird die Liste der letzten Operationen im angegebenen Stack-Satz angezeigt.

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

Ausgabe:

{
    "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"
        }
    ]
}

So listen Sie Stack-Sätze auf

Im folgenden Beispiel für list-stack-sets wird die Liste der Stack-Sätze in der aktuellen Region und im aktuellen Konto angezeigt.

aws cloudformation list-stack-sets

Ausgabe:

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

Um AWS CloudFormation Stapel aufzulisten

Der folgende list-stacks-Befehl zeigt eine Zusammenfassung aller Stack an, die den Status CREATE_COMPLETEhaben:

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

Ausgabe:

[
    {
        "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"
    }
]

So listen Sie die abgeschlossenen Registrierungen eines Typs auf

Im folgenden Beispiel für list-type-registrations wird eine Liste der abgeschlossenen Typregistrierungen für den angegebenen Typ angezeigt.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Using the CloudFormation Registry im AWS CloudFormation Benutzerhandbuch.

So listen Sie die Version einer Erweiterung auf

Im folgenden Beispiel für list-type-versions werden zusammenfassende Informationen zu den Versionen einer Erweiterung zurückgegeben.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie im AWS CloudFormation Benutzerhandbuch unter Verwenden der AWS CloudFormation Registrierung.

So listen Sie die privaten Ressourcentypen in einem Konto auf

Im folgenden list-types Beispiel wird eine Liste der privaten Ressourcentypen angezeigt, die derzeit im aktuellen AWS Konto registriert sind.

aws cloudformation list-types

Ausgabe:

{
    "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"
        }
    ]
}

Weitere Informationen finden Sie im AWS CloudFormation Benutzerhandbuch unter Verwenden der CloudFormation Registrierung.

Mit dem folgenden Befehl wird eine Vorlage namens template.json exportiert, indem lokale Artefakte in den S3-Bucket bucket-name hochgeladen werden und die exportierte Vorlage in packaged-template.json geschrieben wird:

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

So veröffentlichen Sie eine Erweiterung

Im folgenden publish-type Beispiel wird die angegebene Erweiterung in der CloudFormation Registrierung als öffentliche Erweiterung in dieser Region veröffentlicht.

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

Ausgabe:

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

Weitere Informationen finden Sie im AWS CloudFormation Benutzerhandbuch unter Verwenden der AWS CloudFormation Registrierung.

So registrieren Sie einen Publisher

Im folgenden Beispiel für register-publisher wird ein Publisher registriert und der Parameter „terms and condition“ akzeptiert.

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

Ausgabe:

{
    "PublisherId": "000q6TfUovXsEMmgKowxDZLlwqr2QUshd2e75c8c"
}

Weitere Informationen finden Sie im AWS CloudFormation Benutzerhandbuch unter Verwenden der AWS CloudFormation Registrierung.

Um einen Ressourcentyp zu registrieren

Im folgenden Beispiel für register-type wird der angegebene Ressourcentyp als privater Ressourcentyp im Benutzerkonto registriert.

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

Ausgabe:

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

Weitere Informationen finden Sie unter Registrierung von Ressourcenanbietern im Benutzerhandbuch für die CloudFormation Befehlszeilenschnittstelle für die Typentwicklung.

So wenden Sie eine Stack-Richtlinie an

Im folgenden Beispiel für set-stack-policy werden Aktualisierungen für die angegebene Ressource im spezifizierten Stack aktualisiert. stack-policy.json ist ein JSON-Dokument, in dem die Operationen definiert werden, die für Ressourcen im Stack zulässig sind.

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

Ausgabe:

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

So konfigurieren Sie Daten

Im folgenden set-type-configuration Beispiel werden die Konfigurationsdaten für eine registrierte CloudFormation Erweiterung im angegebenen Konto und in der angegebenen Region angegeben.

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

Ausgabe:

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

Weitere Informationen finden Sie im AWS CloudFormation Benutzerhandbuch unter Verwenden der AWS CloudFormation Registrierung.

So legen Sie die Standardversion eines Typs fest

Im folgenden Beispiel für set-type-default-version wird die angegebene Typversion festgelegt, die als Standard für diesen Typ verwendet werden soll.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Using the CloudFormation Registry im AWS CloudFormation Benutzerhandbuch.

So signalisieren Sie eine Ressource

Im folgenden Beispiel für signal-resource wird success signalisiert, die Wartebedingung mit dem Namen MyWaitCondition im Stack mit dem Namen my-stack zu erfüllen.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Um einen Ressourcenscan zu starten

Im folgenden start-resource-scan Beispiel wird ein Ressourcenscan gestartet, bei dem alle vorhandenen Ressourcen im aktuellen Konto und in der Region gescannt werden.

aws cloudformation start-resource-scan

Ausgabe:

{
    "ResourceScanId":
      "arn:aws:cloudformation:us-east-1:123456789012:resourceScan/0a699f15-489c-43ca-a3ef-3e6ecfa5da60"
}

Weitere Informationen finden Sie im AWS CloudFormation Benutzerhandbuch unter Starten eines Ressourcenscans mit dem CloudFormation IaC-Generator.

So beenden Sie eine Stack-Satz-Operation

Im folgenden Beispiel für stop-stack-set-operation wird eine laufende Aktualisierungsoperation für den angegebene Stack-Satz beendet.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

So testen Sie eine Erweiterung

Im folgenden test-type Beispiel wird eine registrierte Erweiterung getestet, um sicherzustellen, dass sie alle Anforderungen erfüllt, die für die Veröffentlichung in der CloudFormation Registrierung erforderlich sind.

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

Ausgabe:

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

Weitere Informationen finden Sie im AWS CloudFormation Benutzerhandbuch unter Verwenden der AWS CloudFormation Registrierung.

So erstellen Sie Stack-Instances

Im folgenden Beispiel für update-stack-instances wird erneut versucht, Stack-Instances in zwei Konten in zwei Regionen mit den neuesten Einstellungen zu aktualisieren. Die angegebene Einstellung für die Fehlertoleranz stellt sicher, dass die Aktualisierung in allen Konten und Regionen versucht wird, auch wenn einige Stacks nicht aktualisiert werden können.

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

Ausgabe:

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

So aktualisieren Sie einen Stack-Satz

Im folgenden Beispiel für update-stack-set wird ein Tag mit dem Schlüsselnamen Owner und einem Wert von IT zu den Stack-Instances im angegebenen Stack-Satz hinzugefügt.

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

Ausgabe:

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

Um AWS CloudFormation Stacks zu aktualisieren

Der folgende Befehl update-stack aktualisiert die Vorlage und die Eingabeparameter für den Stapel mystack :

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

Der folgende Befehl update-stack aktualisiert nur den Wert des Parameters SubnetIDs für den Stapel mystack . Wenn Sie keinen Parameterwert angeben, wird der Standardwert verwendet, der in der Vorlage angegeben ist:

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

Der folgende update-stack-Befehl fügt dem mystack-Stack zwei Themen für Stackbenachrichtigungen hinzu:

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"

Weitere Informationen finden Sie unter AWS CloudFormation Stack-Updates im AWS CloudFormation Benutzerhandbuch.

So aktivieren Sie den Beendigungsschutz

Im folgenden Beispiel für update-termination-protection wird der Beendigungsschutz für den angegebenen Stack aktiviert.

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

Ausgabe:

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

Um eine AWS CloudFormation Vorlage zu validieren

Der folgende Befehl validate-template validiert die Vorlage sampletemplate.json :

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

Ausgabe:

{
    "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": []
}

Weitere Informationen finden Sie im AWS CloudFormation Benutzerhandbuch unter Arbeiten mit AWS CloudFormation Vorlagen.