View a markdown version of this page

Beispiele für CloudFormation Befehle für den Stapelbetrieb AWS CLI und PowerShell - AWS CloudFormation

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Beispiele für CloudFormation Befehle für den Stapelbetrieb AWS CLI und PowerShell

Die folgenden Befehlszeilenbeispiele veranschaulichen, wie Sie einzelne ausführen CloudFormation Aktionen mit dem AWS CLI und PowerShell. Diese Beispiele umfassen nur die am häufigsten verwendeten Aktionen. Eine vollständige Liste finden Sie unter cloudformation in der AWS CLI Befehlsreferenz.

Die Beispiele in diesem Handbuch verwenden die Konvention eines Backslash (\), um anzuzeigen, dass eine lange Befehlszeile in der nächsten Zeile fortgesetzt wird.

Eine Stapelaktualisierung abbrechen

Verwenden Sie den Befehl cancel-update-stack, um eine Stack-Aktualisierung abzubrechen. Weitere Informationen finden Sie unter Eine Stapelaktualisierung abbrechen.

CLI
AWS CLI

So brechen Sie eine laufende Stapelaktualisierung ab

Folgendes cancel-update-stack Beispiel storniert ein Stack-Update auf dem myteststack stapeln.

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Weitere Informationen finden Sie unter Brechen Sie ein Stack-Update ab in der AWS CloudFormation Benutzerleitfaden.

  • Einzelheiten zur API finden Sie unter CancelUpdateStack in AWS CLI Befehlsreferenz.

PowerShell
Werkzeuge für PowerShell V4

Beispiel 1: Bricht eine Aktualisierung auf dem angegebenen Stapel ab.

Stop-CFNUpdateStack -StackName "myStack"
  • API-Details finden Sie unter CancelUpdateStack in AWS -Tools für PowerShell Cmdlet-Referenz (V4).

Werkzeuge für PowerShell V5

Beispiel 1: Bricht eine Aktualisierung auf dem angegebenen Stapel ab.

Stop-CFNUpdateStack -StackName "myStack"
  • API-Details finden Sie unter CancelUpdateStack in AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Rollback einer Aktualisierung fortsetzen

Verwenden Sie den Befehl continue-update-rollback, um ein Update zurückzusetzen. Weitere Informationen finden Sie unter Rollback einer Aktualisierung fortsetzen.

CLI
AWS CLI

Wiederholung eines Update-Rollbacks

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.

Weitere Informationen finden Sie unter Rollback einer Aktualisierung fortsetzen im Benutzerhandbuch für AWS CloudFormation .

PowerShell
Werkzeuge für PowerShell V4

Beispiel 1: Setzt Rollback des benannten Stapels fort, der sich im Zustand 'UPDATE_ROLLBACK_FAILED' befinden sollte. Wenn das fortgesetzte Rollback erfolgreich ist, geht der Stack in den Zustand 'UPDATE_ROLLBACK_COMPLETE' über.

Resume-CFNUpdateRollback -StackName "myStack"
Werkzeuge für PowerShell V5

Beispiel 1: Setzt Rollback des benannten Stapels fort, der sich im Zustand 'UPDATE_ROLLBACK_FAILED' befinden sollte. Wenn das fortgesetzte Rollback erfolgreich ist, geht der Stack in den Zustand 'UPDATE_ROLLBACK_COMPLETE' über.

Resume-CFNUpdateRollback -StackName "myStack"

Erstellen eines Stacks

Verwenden Sie den Befehl create-stack, um einen Stack zu erstellen. Sie müssen den Stack-Namen, den Speicherort einer gültigen Vorlage und alle Eingabeparameter angeben. Bei den Namen der Parameterschlüssel wird zwischen Groß- und Kleinschreibung unterschieden. Wenn Sie den Namen eines Parameterschlüssels falsch eingeben, CloudFormation erstellt den Stapel nicht und meldet, dass die Vorlage diesen Parameter nicht enthält.

Die folgenden Beispiele zeigen, wie Sie einen neuen Stapel mit dem angegebenen Namen, der Vorlage und den Eingabeparametern erstellen.

CLI
AWS CLI

Um eine zu erstellen AWS CloudFormation stapeln

Folgendes create-stack Beispiel erstellt einen Stapel mit dem Namen myteststack mit dem sampletemplate.json Vorlage.

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

Inhalt von sampletemplate.json:

{ "AWSTemplateFormatVersion": "2010-09-09", "Description": "Sample template that creates an Amazon EC2 instance in the first of the specified subnets.", "Parameters": { "KeyPairName": { "Type": "AWS::EC2::KeyPair::KeyName", "Description": "Name of an existing EC2 key pair for SSH access to the instance." }, "SubnetIDs": { "Type": "CommaDelimitedList", "Description": "Comma-delimited list of subnet IDs." } }, "Resources": { "MyInstance": { "Type": "AWS::EC2::Instance", "Properties": { "ImageId": "ami-0abcdef1234567890", "InstanceType": "t3.micro", "KeyName": { "Ref": "KeyPairName" }, "SubnetId": { "Fn::Select": [ "0", { "Ref": "SubnetIDs" } ] } } } } }

Ausgabe:

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

Weitere Informationen finden Sie unter Verwaltung AWS Ressourcen als eine Einheit mit CloudFormation Stapel in der AWS CloudFormation Benutzerleitfaden.

  • Einzelheiten zur API finden Sie unter CreateStack in AWS CLI Befehlsreferenz.

PowerShell
Werkzeuge für PowerShell V4

Beispiel 1: Erzeugt einen neuen Stapel mit dem angegebenen Namen. Die Vorlage wird aus dem gelieferten Inhalt mit Anpassungsparametern geparst ('PK1' und 'PK2' stehen für die Namen der im Vorlageninhalt deklarierten Parameter, 'PV1' und 'PV2' für die Werte dieser Parameter. Die Anpassungsparameter können auch mit 'Key' und 'Value' anstelle von 'angegeben werdenParameterKey'und'ParameterValue'. Wenn die Erstellung des Stapels fehlschlägt, wird er nicht zurückgesetzt.

New-CFNStack -StackName "myStack" ` -TemplateBody "{TEMPLATE CONTENT HERE}" ` -Parameter @( @{ ParameterKey="PK1"; ParameterValue="PV1" }, @{ ParameterKey="PK2"; ParameterValue="PV2" }) ` -DisableRollback $true

Beispiel 2: Erzeugt einen neuen Stapel mit dem angegebenen Namen. Die Vorlage wird aus dem gelieferten Inhalt mit Anpassungsparametern geparst ('PK1' und 'PK2' stehen für die Namen der im Vorlageninhalt deklarierten Parameter, 'PV1' und 'PV2' für die Werte dieser Parameter. Die Anpassungsparameter können auch mit 'Key' und 'Value' anstelle von 'angegeben werdenParameterKey'und'ParameterValue'. Wenn die Erstellung des Stapels fehlschlägt, wird er zurückgerollt.

$p1 = New-Object -Type Amazon.CloudFormation.Model.Parameter $p1.ParameterKey = "PK1" $p1.ParameterValue = "PV1" $p2 = New-Object -Type Amazon.CloudFormation.Model.Parameter $p2.ParameterKey = "PK2" $p2.ParameterValue = "PV2" New-CFNStack -StackName "myStack" ` -TemplateBody "{TEMPLATE CONTENT HERE}" ` -Parameter @( $p1, $p2 ) ` -OnFailure "ROLLBACK"

Beispiel 3: Erzeugt einen neuen Stapel mit dem angegebenen Namen. Die Vorlage wird von der Amazon S3-URL mit Anpassungsparametern abgerufen ('PK1' steht für den Namen eines Parameters, der im Vorlageninhalt deklariert ist, 'PV1' steht für den Wert für den Parameter). Die Anpassungsparameter können auch mithilfe von 'Key' und 'Value' anstelle von 'angegeben werdenParameterKey'und'ParameterValue'. Wenn die Erstellung des Stacks fehlschlägt, wird er zurückgesetzt (genau wie bei der Angabe von -DisableRollback $ falsch).

New-CFNStack -StackName "myStack" ` -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template ` -Parameter @{ ParameterKey="PK1"; ParameterValue="PV1" }

Beispiel 4: Erzeugt einen neuen Stapel mit dem angegebenen Namen. Die Vorlage wird von der Amazon S3-URL mit Anpassungsparametern abgerufen ('PK1' steht für den Namen eines Parameters, der im Vorlageninhalt deklariert ist, 'PV1' steht für den Wert für den Parameter. Die Anpassungsparameter können auch mithilfe von 'Key' und 'Value' anstelle von 'angegeben werdenParameterKey'und'ParameterValue'. Wenn die Erstellung des Stacks fehlschlägt, wird er zurückgesetzt (genau wie bei der Angabe von -DisableRollback $ falsch). Die angegebenen Benachrichtigungs-AENs empfangen veröffentlichte stapelbezogene Ereignisse.

New-CFNStack -StackName "myStack" ` -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template ` -Parameter @{ ParameterKey="PK1"; ParameterValue="PV1" } ` -NotificationARN @( "arn1", "arn2" )
  • API-Details finden Sie unter CreateStack in AWS -Tools für PowerShell Cmdlet-Referenz (V4).

Werkzeuge für PowerShell V5

Beispiel 1: Erzeugt einen neuen Stapel mit dem angegebenen Namen. Die Vorlage wird aus dem gelieferten Inhalt mit Anpassungsparametern geparst ('PK1' und 'PK2' stehen für die Namen der im Vorlageninhalt deklarierten Parameter, 'PV1' und 'PV2' für die Werte dieser Parameter. Die Anpassungsparameter können auch mit 'Key' und 'Value' anstelle von 'angegeben werdenParameterKey'und'ParameterValue'. Wenn die Erstellung des Stapels fehlschlägt, wird er nicht zurückgesetzt.

New-CFNStack -StackName "myStack" ` -TemplateBody "{TEMPLATE CONTENT HERE}" ` -Parameter @( @{ ParameterKey="PK1"; ParameterValue="PV1" }, @{ ParameterKey="PK2"; ParameterValue="PV2" }) ` -DisableRollback $true

Beispiel 2: Erzeugt einen neuen Stapel mit dem angegebenen Namen. Die Vorlage wird aus dem gelieferten Inhalt mit Anpassungsparametern geparst ('PK1' und 'PK2' stehen für die Namen der im Vorlageninhalt deklarierten Parameter, 'PV1' und 'PV2' für die Werte dieser Parameter. Die Anpassungsparameter können auch mit 'Key' und 'Value' anstelle von 'angegeben werdenParameterKey'und'ParameterValue'. Wenn die Erstellung des Stapels fehlschlägt, wird er zurückgerollt.

$p1 = New-Object -Type Amazon.CloudFormation.Model.Parameter $p1.ParameterKey = "PK1" $p1.ParameterValue = "PV1" $p2 = New-Object -Type Amazon.CloudFormation.Model.Parameter $p2.ParameterKey = "PK2" $p2.ParameterValue = "PV2" New-CFNStack -StackName "myStack" ` -TemplateBody "{TEMPLATE CONTENT HERE}" ` -Parameter @( $p1, $p2 ) ` -OnFailure "ROLLBACK"

Beispiel 3: Erzeugt einen neuen Stapel mit dem angegebenen Namen. Die Vorlage wird von der Amazon S3-URL mit Anpassungsparametern abgerufen ('PK1' steht für den Namen eines Parameters, der im Vorlageninhalt deklariert ist, 'PV1' steht für den Wert für den Parameter). Die Anpassungsparameter können auch mithilfe von 'Key' und 'Value' anstelle von 'angegeben werdenParameterKey'und'ParameterValue'. Wenn die Erstellung des Stacks fehlschlägt, wird er zurückgesetzt (genau wie bei der Angabe von -DisableRollback $ falsch).

New-CFNStack -StackName "myStack" ` -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template ` -Parameter @{ ParameterKey="PK1"; ParameterValue="PV1" }

Beispiel 4: Erzeugt einen neuen Stapel mit dem angegebenen Namen. Die Vorlage wird von der Amazon S3-URL mit Anpassungsparametern abgerufen ('PK1' steht für den Namen eines Parameters, der im Vorlageninhalt deklariert ist, 'PV1' steht für den Wert für den Parameter. Die Anpassungsparameter können auch mithilfe von 'Key' und 'Value' anstelle von 'angegeben werdenParameterKey'und'ParameterValue'. Wenn die Erstellung des Stacks fehlschlägt, wird er zurückgesetzt (genau wie bei der Angabe von -DisableRollback $ falsch). Die angegebenen Benachrichtigungs-AENs empfangen veröffentlichte stapelbezogene Ereignisse.

New-CFNStack -StackName "myStack" ` -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template ` -Parameter @{ ParameterKey="PK1"; ParameterValue="PV1" } ` -NotificationARN @( "arn1", "arn2" )
  • API-Details finden Sie unter CreateStack in AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Anmerkung

Sie können das verwenden AWS CLI --template-url Option zur Angabe eines Speicherorts für die Vorlagendatei in Amazon S3 oder AWS Systems Manager.

Bei Amazon S3 muss die URL mit https://beginnen. Statische S3-Website-URLs werden nicht unterstützt.

--template-url https://s3.region-code.amazonaws.com/bucket-name/template-name

Für AWS Systems Manager, verwenden Sie das folgende Format:

--template-url "ssm-doc://arn:aws:ssm:region-code:account-id:document/document-name"
Express-Modus

Um einen Stapel im Expressmodus zu erstellen, fügen Sie den --deployment-config Parameter. Der Express-Modus schließt den Stack-Vorgang ab, sobald CloudFormation wendet die Ressourcenkonfiguration an. Weitere Informationen finden Sie unter Express-Modus.

aws cloudformation create-stack --stack-name myteststack \ --template-body file://sampletemplate.json \ --deployment-config '{"mode": "EXPRESS"}'

Erstellen Sie einen Stapel, der Transformationen enthält

Verwenden Sie den Befehl deploy, um einen Stack zu erstellen, der Transformationen enthält. Wenn Sie einen Stapel aus einer Vorlage erstellen, die Transformationen enthält, müssen Sie ein Änderungsset verwenden. Der Befehl deploy kombiniert zwei Schritte (Erstellung eines Änderungssatzes und dessen Ausführung) in einem einzigen Befehl.

AWS CLI

Der folgende Befehl deploy erstellt einen Stapel mit dem angegebenen Namen, der Vorlage und den Eingabeparametern.

aws cloudformation deploy --stack-name myteststack \ --template /path_to_template/my-template.json \ --parameter-overrides Key1=Value1 Key2=Value2

Löschen eines Stacks

Verwenden Sie den Befehl delete-stack, um einen Stack zu löschen. Weitere Informationen finden Sie unter Löschen eines Stacks.

CLI
AWS CLI

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.

Weitere Informationen finden Sie unter Verwaltung AWS Ressourcen als eine Einheit mit CloudFormation Stapel in der AWS CloudFormation Benutzerleitfaden.

  • Einzelheiten zur API finden Sie unter DeleteStack in AWS CLI Befehlsreferenz.

PowerShell
Werkzeuge für PowerShell V4

Beispiel 1: Löscht den angegebenen Stapel.

Remove-CFNStack -StackName "myStack"
  • API-Details finden Sie unter DeleteStack in AWS -Tools für PowerShell Cmdlet-Referenz (V4).

Werkzeuge für PowerShell V5

Beispiel 1: Löscht den angegebenen Stapel.

Remove-CFNStack -StackName "myStack"
  • API-Details finden Sie unter DeleteStack in AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Wenn der Löschvorgang fehlschlägt und den Status DELETE_FAILED zurückgibt, können Sie den Stapel mit der Option --deletion-mode zwangsweise löschen. Dies sind die folgenden Werte, die mit deletion-modeverwendet werden können:

  • STANDARD: Löscht den Stapel normal. Dies ist der Standard-Löschmodus.

  • FORCE_DELETE_STACK: Löscht den Stapel und überspringt alle Ressourcen, die nicht gelöscht werden können.

AWS CLI

Der folgende delete-stack-Befehl erzwingt das Löschen des myteststack-Stacks unter Verwendung des FORCE_DELETE_STACK-Werts mit dem deletion-mode-Parameter:

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

Mit diesem Befehl wird keine Ausgabe zurückgegeben.

Nachdem Sie FORCE_DELETE_STACKverwendet haben, können Sie den Befehl list-stack-resources verwenden, um die Ressourcen aufzulisten, die beim Löschen des Stapels übersprungen wurden. Die zurückbehaltenen Ressourcen erhalten den Status DELETE_SKIPPED. Weitere Informationen finden Sie unter Stack-Ressourcen auflisten.

Express-Modus

Um einen Stapel im Expressmodus zu löschen, fügen Sie den --deployment-config Parameter:

aws cloudformation delete-stack --stack-name myteststack \ --deployment-config '{"mode": "EXPRESS"}'

Weitere Informationen finden Sie unter Express-Modus.

Beschreiben Sie Stack-Ereignisse

Verwenden Sie den Befehl describe-stack-events, um Stack-Ereignisse zu beschreiben. Weitere Informationen finden Sie unter Fortschritt des Stapels überwachen.

CLI
AWS CLI

Zur Beschreibung von Stapelereignissen

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

Ausgabe:

{ "StackEvents": [ { "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "EventId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222", "StackName": "my-stack", "LogicalResourceId": "my-stack", "PhysicalResourceId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "ResourceType": "AWS::CloudFormation::Stack", "Timestamp": "2019-10-02T05:34:29.556Z", "ResourceStatus": "UPDATE_COMPLETE" }, { "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "EventId": "a1b2c3d4-5678-90ab-cdef-EXAMPLE33333", "StackName": "my-stack", "LogicalResourceId": "my-stack", "PhysicalResourceId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "ResourceType": "AWS::CloudFormation::Stack", "Timestamp": "2019-10-02T05:34:29.127Z", "ResourceStatus": "UPDATE_COMPLETE_CLEANUP_IN_PROGRESS" } ], "NextToken": "eyJOZXh0VG9XMPLiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAyfQ==" }

Weitere Informationen finden Sie unter Überwachen Sie den Fortschritt des Stap in der AWS CloudFormation Benutzerleitfaden.

PowerShell
Werkzeuge für PowerShell V4

Beispiel 1: Gibt alle stapelbezogenen Ereignisse für den angegebenen Stapel zurück.

Get-CFNStackEvent -StackName "myStack"
  • API-Details finden Sie unter DescribeStackEvents in AWS -Tools für PowerShell Cmdlet-Referenz (V4).

Werkzeuge für PowerShell V5

Beispiel 1: Gibt alle stapelbezogenen Ereignisse für den angegebenen Stapel zurück.

Get-CFNStackEvent -StackName "myStack"
  • API-Details finden Sie unter DescribeStackEvents in AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Beschreiben Sie eine Stapelressource

CLI
AWS CLI

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-west-2:123456789012:stack/MyStack/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "LogicalResourceId": "MyFunction", "PhysicalResourceId": "my-function-SEZV4XMPL4S5", "ResourceType": "AWS::Lambda::Function", "LastUpdatedTimestamp": "2019-10-02T05:34:27.989Z", "ResourceStatus": "UPDATE_COMPLETE", "Metadata": "{}", "DriftInformation": { "StackResourceDriftStatus": "IN_SYNC" } } }

Weitere Informationen finden Sie unter Verwaltung AWS Ressourcen als eine Einheit mit CloudFormation Stapel in der AWS CloudFormation Benutzerleitfaden.

PowerShell
Werkzeuge für PowerShell V4

Beispiel 1: Gibt die Beschreibung einer Ressource zurück, die in der Vorlage, die mit dem angegebenen Stack verbunden ist, durch die logische ID "MyDBInstance" identifiziert wurde.

Get-CFNStackResource -StackName "myStack" -LogicalResourceId "MyDBInstance"
Werkzeuge für PowerShell V5

Beispiel 1: Gibt die Beschreibung einer Ressource zurück, die in der Vorlage, die mit dem angegebenen Stack verbunden ist, durch die logische ID "MyDBInstance" identifiziert wurde.

Get-CFNStackResource -StackName "myStack" -LogicalResourceId "MyDBInstance"

Beschreiben Sie Stack-Ressourcen

CLI
AWS CLI

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/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "LogicalResourceId": "bucket", "PhysicalResourceId": "my-stack-bucket-1vc62xmplgguf", "ResourceType": "AWS::S3::Bucket", "Timestamp": "2019-10-02T04:34:11.345Z", "ResourceStatus": "CREATE_COMPLETE", "DriftInformation": { "StackResourceDriftStatus": "IN_SYNC" } }, { "StackName": "my-stack", "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "LogicalResourceId": "function", "PhysicalResourceId": "my-function-SEZV4XMPL4S5", "ResourceType": "AWS::Lambda::Function", "Timestamp": "2019-10-02T05:34:27.989Z", "ResourceStatus": "UPDATE_COMPLETE", "DriftInformation": { "StackResourceDriftStatus": "IN_SYNC" } }, { "StackName": "my-stack", "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/my-stack/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "LogicalResourceId": "functionRole", "PhysicalResourceId": "my-functionRole-HIZXMPLEOM9E", "ResourceType": "AWS::IAM::Role", "Timestamp": "2019-10-02T04:34:06.350Z", "ResourceStatus": "CREATE_COMPLETE", "DriftInformation": { "StackResourceDriftStatus": "IN_SYNC" } } ] }

Weitere Informationen finden Sie unter Verwaltung AWS Ressourcen als eine Einheit mit CloudFormation Stapel in der AWS CloudFormation Benutzerleitfaden.

PowerShell
Werkzeuge für PowerShell V4

Beispiel 1: Gibt den AWS zurückRessourcenbeschreibungen für bis zu 100 Ressourcen, die dem angegebenen Stack zugeordnet sind. Um Details zu allen Ressourcen zu erhalten, die einem Stack zugeordnet sind, verwenden Sie den Get-CFNStackResourceSummary, das auch das manuelle Paging der Ergebnisse unterstützt.

Get-CFNStackResourceList -StackName "myStack"

Beispiel 2: Gibt die Beschreibung der Amazon EC2-Instance zurück, die in der Vorlage, die mit dem angegebenen Stack verbunden ist, durch die logische ID "Ec2Instance" identifiziert wurde.

Get-CFNStackResourceList -StackName "myStack" -LogicalResourceId "Ec2Instance"

Beispiel 3: Gibt die Beschreibung von bis zu 100 Ressourcen zurück, die mit dem Stack verbunden sind, der eine Amazon EC2-Instance enthält, die durch die Instance-ID "i-123456" identifiziert wird. Um Details zu allen Ressourcen zu erhalten, die einem Stack zugeordnet sind, verwenden Sie den Get-CFNStackResourceSummary, das auch das manuelle Paging der Ergebnisse unterstützt.

Get-CFNStackResourceList -PhysicalResourceId "i-123456"

Beispiel 4: Gibt die Beschreibung der Amazon EC2-Instance zurück, die durch die logische ID "Ec2Instance" in der Vorlage für einen Stack identifiziert wird. Der Stack wird anhand der physischen Ressourcen-ID einer darin enthaltenen Ressource identifiziert, in diesem Fall also einer Amazon EC2-Instance mit der Instance-ID "i-123456". Je nach Inhalt der Vorlage könnte auch eine andere physische Ressource zur Identifizierung des Stacks verwendet werden, zum Beispiel ein Amazon S3-Bucket.

Get-CFNStackResourceList -PhysicalResourceId "i-123456" -LogicalResourceId "Ec2Instance"
  • Einzelheiten zur API finden Sie unter DescribeStackResources in AWS -Tools für PowerShell Cmdlet-Referenz (V4).

Werkzeuge für PowerShell V5

Beispiel 1: Gibt den AWS zurückRessourcenbeschreibungen für bis zu 100 Ressourcen, die dem angegebenen Stack zugeordnet sind. Um Details zu allen Ressourcen zu erhalten, die einem Stack zugeordnet sind, verwenden Sie den Get-CFNStackResourceSummary, das auch das manuelle Paging der Ergebnisse unterstützt.

Get-CFNStackResourceList -StackName "myStack"

Beispiel 2: Gibt die Beschreibung der Amazon EC2-Instance zurück, die in der Vorlage, die mit dem angegebenen Stack verbunden ist, durch die logische ID "Ec2Instance" identifiziert wurde.

Get-CFNStackResourceList -StackName "myStack" -LogicalResourceId "Ec2Instance"

Beispiel 3: Gibt die Beschreibung von bis zu 100 Ressourcen zurück, die mit dem Stack verbunden sind, der eine Amazon EC2-Instance enthält, die durch die Instance-ID "i-123456" identifiziert wird. Um Details zu allen Ressourcen zu erhalten, die einem Stack zugeordnet sind, verwenden Sie den Get-CFNStackResourceSummary, das auch das manuelle Paging der Ergebnisse unterstützt.

Get-CFNStackResourceList -PhysicalResourceId "i-123456"

Beispiel 4: Gibt die Beschreibung der Amazon EC2-Instance zurück, die durch die logische ID "Ec2Instance" in der Vorlage für einen Stack identifiziert wird. Der Stack wird anhand der physischen Ressourcen-ID einer darin enthaltenen Ressource identifiziert, in diesem Fall also einer Amazon EC2-Instance mit der Instance-ID "i-123456". Je nach Inhalt der Vorlage könnte auch eine andere physische Ressource zur Identifizierung des Stacks verwendet werden, zum Beispiel ein Amazon S3-Bucket.

Get-CFNStackResourceList -PhysicalResourceId "i-123456" -LogicalResourceId "Ec2Instance"
  • Einzelheiten zur API finden Sie unter DescribeStackResources in AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Beschreiben Sie Stapel

CLI
AWS CLI

Um zu beschreiben AWS CloudFormation Stapel

Das Folgende describe-stacks Das Beispiel zeigt zusammenfassende Informationen für myteststack stapeln.

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

Ausgabe:

{ "Stacks": [ { "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/myteststack/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "Description": "AWS CloudFormation Sample Template S3_Bucket: Sample template showing how to create a publicly accessible S3 bucket. **WARNING** This template creates an S3 bucket. You will be billed for the AWS resources used if you create a stack from this template.", "Tags": [], "Outputs": [ { "Description": "Name of S3 bucket to hold website content", "OutputKey": "BucketName", "OutputValue": "myteststack-s3bucket-jssofi1zie2w" } ], "StackStatusReason": null, "CreationTime": "2013-08-23T01:02:15.422Z", "Capabilities": [], "StackName": "myteststack", "StackStatus": "CREATE_COMPLETE", "DisableRollback": false } ] }

Weitere Informationen finden Sie unter Verwaltung AWS Ressourcen als eine Einheit mit CloudFormation Stapel in der AWS CloudFormation Benutzerleitfaden.

  • Einzelheiten zur API finden Sie unter DescribeStacks in AWS CLI Befehlsreferenz.

Go
SDK für Go V2
Anmerkung

Es gibt noch mehr GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das AWS -Code-Beispiel- einrichten und ausführen.

import ( "context" "log" "github.com/aws/aws-sdk-go-v2/aws" "github.com/aws/aws-sdk-go-v2/service/cloudformation" ) // StackOutputs defines a map of outputs from a specific stack. type StackOutputs map[string]string type CloudFormationActions struct { CfnClient *cloudformation.Client } // GetOutputs gets the outputs from a CloudFormation stack and puts them into a structured format. func (actor CloudFormationActions) GetOutputs(ctx context.Context, stackName string) StackOutputs { output, err := actor.CfnClient.DescribeStacks(ctx, &cloudformation.DescribeStacksInput{ StackName: aws.String(stackName), }) if err != nil || len(output.Stacks) == 0 { log.Panicf("Couldn't find a CloudFormation stack named %v. Here's why: %v\n", stackName, err) } stackOutputs := StackOutputs{} for _, out := range output.Stacks[0].Outputs { stackOutputs[*out.OutputKey] = *out.OutputValue } return stackOutputs }
  • Einzelheiten zur API finden Sie unter DescribeStacks in AWS SDK für Go API-Referenz.

PowerShell
Werkzeuge für PowerShell V4

Beispiel 1: Gibt eine Sammlung von Stack-Instances zurück, die alle Stacks des Benutzers beschreiben.

Get-CFNStack

Beispiel 2: Gibt eine Stack-Instance zurück, die den angegebenen Stack beschreibt

Get-CFNStack -StackName "myStack"
  • API-Details finden Sie unter DescribeStacks in AWS -Tools für PowerShell Cmdlet-Referenz (V4).

Werkzeuge für PowerShell V5

Beispiel 1: Gibt eine Sammlung von Stack-Instances zurück, die alle Stacks des Benutzers beschreiben.

Get-CFNStack

Beispiel 2: Gibt eine Stack-Instance zurück, die den angegebenen Stack beschreibt

Get-CFNStack -StackName "myStack"
  • API-Details finden Sie unter DescribeStacks in AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Der Befehl describe-stacks gibt standardmäßig Parameterwerte zurück. Um zu verhindern, dass vertrauliche Parameterwerte wie Passwörter zurückgegeben werden, fügen Sie ein NoEcho Eigenschaft festgelegt auf TRUE in deinem CloudFormation Vorlagen.

Wichtig

Durch die Verwendung des NoEcho-Attributs werden keine Informationen maskiert, die im Folgenden gespeichert sind:

  • Die Metadata Abschnitt „Vorlage“. CloudFormation transformiert, modifiziert oder redigiert keine Informationen, die Sie in den Metadata Abschnitt. Weitere Informationen finden Sie unter Metadaten.

  • Der Outputs-Vorlagenabschnitt. Weitere Informationen finden Sie unter Ausgaben:

  • Das Metadata-Attribut einer Ressourcendefinition. Weitere Informationen finden Sie unter Metadata-Attribut.

Es wird dringend empfohlen, diese Mechanismen nicht zu verwenden, um vertrauliche Informationen wie Passwörter oder Geheimnisse einzugeben.

Wichtig

Anstatt vertrauliche Informationen direkt in Ihre einzubetten CloudFormation Bei Vorlagen empfehlen wir Ihnen, dynamische Parameter in der Stack-Vorlage zu verwenden, um auf vertrauliche Informationen zu verweisen, die außerhalb von gespeichert und verwaltet werden CloudFormation, wie zum Beispiel in der AWS Systems Manager Parameterspeicher oder AWS Secrets Manager.

Weitere Informationen finden Sie in den bewährten Methoden zu Keine Anmeldeinformationen in Ihre Vorlagen einbetten.

Eine Vorlage erhalten

CLI
AWS CLI

Um den Vorlagentext für eine anzuzeigen AWS CloudFormation stapeln

Folgendes get-template Das Beispiel zeigt die Vorlage für myteststack stapeln.

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

Weitere Informationen finden Sie unter Arbeiten mit CloudFormation Vorlagen in der AWS CloudFormation Benutzerleitfaden.

  • Einzelheiten zur API finden Sie unter GetTemplate in AWS CLI Befehlsreferenz.

PowerShell
Werkzeuge für PowerShell V4

Beispiel 1: Gibt die Vorlage zurück, die mit dem angegebenen Stapel verbunden ist.

Get-CFNTemplate -StackName "myStack"
  • API-Details finden Sie unter GetTemplate in AWS -Tools für PowerShell Cmdlet-Referenz (V4).

Werkzeuge für PowerShell V5

Beispiel 1: Gibt die Vorlage zurück, die mit dem angegebenen Stapel verbunden ist.

Get-CFNTemplate -StackName "myStack"
  • API-Details finden Sie unter GetTemplate in AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Stack-Ressourcen auflisten

CLI
AWS CLI

So listen Sie Ressourcen in einem Stack auf

Folgendes list-stack-resources Beispiel 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" } } ] }

Weitere Informationen finden Sie unter Verwaltung AWS Ressourcen als eine Einheit mit CloudFormation Stapel in der AWS CloudFormation Benutzerleitfaden.

PowerShell
Werkzeuge für PowerShell V4

Beispiel 1: Gibt Beschreibungen aller Ressourcen zurück, die mit dem angegebenen Stapel verbunden sind.

Get-CFNStackResourceSummary -StackName "myStack"
  • API-Details finden Sie unter ListStackResources in AWS -Tools für PowerShell Cmdlet-Referenz (V4).

Werkzeuge für PowerShell V5

Beispiel 1: Gibt Beschreibungen aller Ressourcen zurück, die mit dem angegebenen Stapel verbunden sind.

Get-CFNStackResourceSummary -StackName "myStack"
  • API-Details finden Sie unter ListStackResources in AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Stapel auflisten

Verwenden Sie den Befehl list-stacks, um Stack aufzulisten. Um nur Stapel mit den angegebenen Statuscodes aufzulisten, fügen Sie die Option --stack-status-filter hinzu. Sie können einen oder mehrere Stack-Statuscodes für die Option --stack-status-filter angeben. Weitere Informationen finden Sie unter Stack-Statuscodes.

CLI
AWS CLI

Zur Aufzählung AWS CloudFormation Stapel

Das Folgende list-stacks Das Beispiel zeigt eine Zusammenfassung aller Stapel, die den Status von haben CREATE_COMPLETE.

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

Ausgabe:

{ "StackSummaries": [ { "StackId": "arn:aws:cloudformation:us-west-2:123456789012:stack/myteststack/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111", "TemplateDescription": "AWS CloudFormation Sample Template S3_Bucket: Sample template showing how to create a publicly accessible S3 bucket. **WARNING** This template creates an S3 bucket. You will be billed for the AWS resources used if you create a stack from this template.", "StackStatusReason": null, "CreationTime": "2013-08-26T03:27:10.190Z", "StackName": "myteststack", "StackStatus": "CREATE_COMPLETE" } ] }

Weitere Informationen finden Sie unter Verwaltung AWS Ressourcen als eine Einheit mit CloudFormation Stapel in der AWS CloudFormation Benutzerleitfaden.

  • Einzelheiten zur API finden Sie unter ListStacks in AWS CLI Befehlsreferenz.

PowerShell
Werkzeuge für PowerShell V4

Beispiel 1: Gibt zusammenfassende Informationen für alle Stapel zurück.

Get-CFNStackSummary

Beispiel 2: Gibt zusammenfassende Informationen für alle Stapel zurück, die gerade erstellt werden.

Get-CFNStackSummary -StackStatusFilter "CREATE_IN_PROGRESS"

Beispiel 3: Gibt zusammenfassende Informationen für alle Stapel zurück, die gerade erstellt oder aktualisiert werden.

Get-CFNStackSummary -StackStatusFilter @("CREATE_IN_PROGRESS", "UPDATE_IN_PROGRESS")
  • API-Details finden Sie unter ListStacks in AWS -Tools für PowerShell Cmdlet-Referenz (V4).

Werkzeuge für PowerShell V5

Beispiel 1: Gibt zusammenfassende Informationen für alle Stapel zurück.

Get-CFNStackSummary

Beispiel 2: Gibt zusammenfassende Informationen für alle Stapel zurück, die gerade erstellt werden.

Get-CFNStackSummary -StackStatusFilter "CREATE_IN_PROGRESS"

Beispiel 3: Gibt zusammenfassende Informationen für alle Stapel zurück, die gerade erstellt oder aktualisiert werden.

Get-CFNStackSummary -StackStatusFilter @("CREATE_IN_PROGRESS", "UPDATE_IN_PROGRESS")
  • API-Details finden Sie unter ListStacks in AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Einen Stack aktualisieren

Verwenden Sie den Befehl update-stack, um einen Stack direkt zu aktualisieren. Sie geben den Stack und Parameterwerte und Funktionen an, die Sie aktualisieren möchten, sowie, falls Sie eine aktualisierte Vorlage verwenden möchten, den Namen der Vorlage. Weitere Informationen finden Sie unter Stapel direkt aktualisieren.

CLI
AWS CLI

Um zu aktualisieren AWS CloudFormation Stapel

Das Folgende update-stack Beispiel aktualisiert die Vorlage und die Eingabeparameter für mystack stapeln.

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

Ausgabe:

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

Folgendes update-stack Das Beispiel aktualisiert nur die SubnetIDs Parameterwert für mystack stapeln. Wenn Sie keinen Parameterwert angeben, wird der in der Vorlage angegebene Standardwert verwendet.

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

Ausgabe:

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

Folgendes update-stack Das Beispiel fügt zwei Stack-Benachrichtigungsthemen zum mystack stapeln.

aws cloudformation update-stack \ --stack-name mystack \ --use-previous-template \ --notification-arns "arn:aws:sns:use-east-1:123456789012:mytopic1" "arn:aws:sns:us-west-2:123456789012:mytopic2"

Ausgabe:

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

Weitere Informationen finden Sie unter AWS CloudFormation Aktualisierungen stapeln in der AWS CloudFormation Benutzerleitfaden.

  • Einzelheiten zur API finden Sie unter UpdateStack in AWS CLI Befehlsreferenz.

PowerShell
Werkzeuge für PowerShell V4

Beispiel 1: Aktualisiert den Stack 'myStack' mit der angegebenen Vorlage und den Anpassungsparametern. 'PK1' steht für den Namen eines in der Vorlage deklarierten Parameters und 'PV1' für dessen Wert. Die Anpassungsparameter können auch mit 'Key' und 'Value' anstelle von 'angegeben werdenParameterKey'und'ParameterValue'.

Update-CFNStack -StackName "myStack" ` -TemplateBody "{Template Content Here}" ` -Parameter @{ ParameterKey="PK1"; ParameterValue="PV1" }

Beispiel 2: Aktualisiert den Stack 'myStack' mit der angegebenen Vorlage und den Anpassungsparametern. 'PK1' und 'PK2' stehen für die Namen der in der Vorlage deklarierten Parameter, 'PV1' und 'PV2' für die gewünschten Werte. Die Anpassungsparameter können auch mit 'Key' und 'Value' anstelle von 'angegeben werdenParameterKey'und'ParameterValue'.

Update-CFNStack -StackName "myStack" ` -TemplateBody "{Template Content Here}" ` -Parameter @( @{ ParameterKey="PK1"; ParameterValue="PV1" }, @{ ParameterKey="PK2"; ParameterValue="PV2" } )

Beispiel 3: Aktualisiert den Stack 'myStack' mit der angegebenen Vorlage und den Anpassungsparametern. 'PK1' steht für den Namen eines in der Vorlage deklarierten Parameters und 'PV2' für dessen Wert. Die Anpassungsparameter können auch mit 'Key' und 'Value' anstelle von 'angegeben werdenParameterKey'und'ParameterValue'.

Update-CFNStack -StackName "myStack" -TemplateBody "{Template Content Here}" -Parameters @{ ParameterKey="PK1"; ParameterValue="PV1" }

Beispiel 4: Aktualisiert den Stack 'myStack' mit der angegebenen, von Amazon S3 bezogenen Vorlage und den Anpassungsparametern. 'PK1' und 'PK2' stehen für die Namen der in der Vorlage deklarierten Parameter, 'PV1' und 'PV2' für die gewünschten Werte. Die Anpassungsparameter können auch mit 'Key' und 'Value' anstelle von 'angegeben werdenParameterKey'und'ParameterValue'.

Update-CFNStack -StackName "myStack" ` -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template ` -Parameter @( @{ ParameterKey="PK1"; ParameterValue="PV1" }, @{ ParameterKey="PK2"; ParameterValue="PV2" } )

Beispiel 5: Aktualisiert den Stack 'myStack', von dem in diesem Beispiel angenommen wird, dass er IAM-Ressourcen enthält, mit der angegebenen, von Amazon S3 bezogenen Vorlage und den Anpassungsparametern. 'PK1' und 'PK2' stehen für die Namen der in der Vorlage deklarierten Parameter, 'PV1' und 'PV2' für die gewünschten Werte. Die Anpassungsparameter können auch mit 'Key' und 'Value' anstelle von 'angegeben werdenParameterKey'und'ParameterValue'. Bei Stacks, die IAM-Ressourcen enthalten, müssen Sie den Parameter -Capabilities „CAPABILITY_IAM“ angeben. Andernfalls schlägt das Update mit einem 'fehlInsufficientCapabilities'Fehler.

Update-CFNStack -StackName "myStack" ` -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template ` -Parameter @( @{ ParameterKey="PK1"; ParameterValue="PV1" }, @{ ParameterKey="PK2"; ParameterValue="PV2" } ) ` -Capabilities "CAPABILITY_IAM"
  • API-Details finden Sie unter UpdateStack in AWS -Tools für PowerShell Cmdlet-Referenz (V4).

Werkzeuge für PowerShell V5

Beispiel 1: Aktualisiert den Stack 'myStack' mit der angegebenen Vorlage und den Anpassungsparametern. 'PK1' steht für den Namen eines in der Vorlage deklarierten Parameters und 'PV1' für dessen Wert. Die Anpassungsparameter können auch mit 'Key' und 'Value' anstelle von 'angegeben werdenParameterKey'und'ParameterValue'.

Update-CFNStack -StackName "myStack" ` -TemplateBody "{Template Content Here}" ` -Parameter @{ ParameterKey="PK1"; ParameterValue="PV1" }

Beispiel 2: Aktualisiert den Stack 'myStack' mit der angegebenen Vorlage und den Anpassungsparametern. 'PK1' und 'PK2' stehen für die Namen der in der Vorlage deklarierten Parameter, 'PV1' und 'PV2' für die gewünschten Werte. Die Anpassungsparameter können auch mit 'Key' und 'Value' anstelle von 'angegeben werdenParameterKey'und'ParameterValue'.

Update-CFNStack -StackName "myStack" ` -TemplateBody "{Template Content Here}" ` -Parameter @( @{ ParameterKey="PK1"; ParameterValue="PV1" }, @{ ParameterKey="PK2"; ParameterValue="PV2" } )

Beispiel 3: Aktualisiert den Stack 'myStack' mit der angegebenen Vorlage und den Anpassungsparametern. 'PK1' steht für den Namen eines in der Vorlage deklarierten Parameters und 'PV2' für dessen Wert. Die Anpassungsparameter können auch mit 'Key' und 'Value' anstelle von 'angegeben werdenParameterKey'und'ParameterValue'.

Update-CFNStack -StackName "myStack" -TemplateBody "{Template Content Here}" -Parameters @{ ParameterKey="PK1"; ParameterValue="PV1" }

Beispiel 4: Aktualisiert den Stack 'myStack' mit der angegebenen, von Amazon S3 bezogenen Vorlage und den Anpassungsparametern. 'PK1' und 'PK2' stehen für die Namen der in der Vorlage deklarierten Parameter, 'PV1' und 'PV2' für die gewünschten Werte. Die Anpassungsparameter können auch mit 'Key' und 'Value' anstelle von 'angegeben werdenParameterKey'und'ParameterValue'.

Update-CFNStack -StackName "myStack" ` -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template ` -Parameter @( @{ ParameterKey="PK1"; ParameterValue="PV1" }, @{ ParameterKey="PK2"; ParameterValue="PV2" } )

Beispiel 5: Aktualisiert den Stack 'myStack', von dem in diesem Beispiel angenommen wird, dass er IAM-Ressourcen enthält, mit der angegebenen, von Amazon S3 bezogenen Vorlage und den Anpassungsparametern. 'PK1' und 'PK2' stehen für die Namen der in der Vorlage deklarierten Parameter, 'PV1' und 'PV2' für die gewünschten Werte. Die Anpassungsparameter können auch mit 'Key' und 'Value' anstelle von 'angegeben werdenParameterKey'und'ParameterValue'. Bei Stacks, die IAM-Ressourcen enthalten, müssen Sie den Parameter -Capabilities „CAPABILITY_IAM“ angeben. Andernfalls schlägt das Update mit einem 'fehlInsufficientCapabilities'Fehler.

Update-CFNStack -StackName "myStack" ` -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template ` -Parameter @( @{ ParameterKey="PK1"; ParameterValue="PV1" }, @{ ParameterKey="PK2"; ParameterValue="PV2" } ) ` -Capabilities "CAPABILITY_IAM"
  • API-Details finden Sie unter UpdateStack in AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Anmerkung

Um alle Benachrichtigungen zu entfernen, geben Sie für [] die Option --notification-arns an.

Express-Modus

Um einen Stapel im Expressmodus zu aktualisieren, fügen Sie den --deployment-config Parameter:

aws cloudformation update-stack --stack-name myteststack \ --template-body file://sampletemplate.json \ --deployment-config '{"mode": "EXPRESS"}'

Weitere Informationen finden Sie unter Express-Modus.

Validieren Sie Ihre Vorlage

Verwenden Sie den Befehl validate-template, um Ihre Vorlagendatei auf Syntaxfehler zu überprüfen.

Während der Validierung CloudFormation prüft zunächst, ob die Vorlage ein gültiges JSON ist. Wenn dies nicht der Fall ist, wird von CloudFormation geprüft, ob die Vorlage gültiger YAML-Code ist. Wenn beide Prüfungen fehlschlagen, CloudFormation gibt einen Fehler bei der Vorlagenüberprüfung zurück.

CLI
AWS CLI

Um eine zu validieren AWS CloudFormation Muster

Das Folgende validate-template Beispiel validiert die sampletemplate.json Vorlage.

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

Inhalt von sampletemplate.json:

{ "AWSTemplateFormatVersion": "2010-09-09", "Description": "AWS CloudFormation Sample Template S3_Bucket: Sample template showing how to create an S3 bucket. **WARNING** This template creates an S3 bucket. You will be billed for the AWS resources used if you create a stack from this template.", "Resources": { "S3Bucket": { "Type": "AWS::S3::Bucket", "DeletionPolicy": "Retain" } }, "Outputs": { "BucketName": { "Value": { "Ref": "S3Bucket" }, "Description": "Name of the sample Amazon S3 bucket." } } }

Ausgabe:

{ "Description": "AWS CloudFormation Sample Template S3_Bucket: Sample template showing how to create an S3 bucket. **WARNING** This template creates an S3 bucket. You will be billed for the AWS resources used if you create a stack from this template.", "Parameters": [], "Capabilities": [] }

Weitere Informationen finden Sie unter Arbeiten mit CloudFormation Vorlagen in der AWS CloudFormation Benutzerleitfaden.

  • Einzelheiten zur API finden Sie unter ValidateTemplate in AWS CLI Befehlsreferenz.

PowerShell
Werkzeuge für PowerShell V4

Beispiel 1: Validiert den angegebenen Vorlageninhalt. Die Ausgabe enthält die Fähigkeiten, Beschreibung und Parameter der Vorlage.

Test-CFNTemplate -TemplateBody "{TEMPLATE CONTENT HERE}"

Beispiel 2: Validiert die angegebene Vorlage, auf die über eine Amazon S3 URL zugegriffen wird. Die Ausgabe enthält die Fähigkeiten, Beschreibung und Parameter der Vorlage.

Test-CFNTemplate -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template
  • API-Details finden Sie unter ValidateTemplate in AWS -Tools für PowerShell Cmdlet-Referenz (V4).

Werkzeuge für PowerShell V5

Beispiel 1: Validiert den angegebenen Vorlageninhalt. Die Ausgabe enthält die Fähigkeiten, Beschreibung und Parameter der Vorlage.

Test-CFNTemplate -TemplateBody "{TEMPLATE CONTENT HERE}"

Beispiel 2: Validiert die angegebene Vorlage, auf die über eine Amazon S3 URL zugegriffen wird. Die Ausgabe enthält die Fähigkeiten, Beschreibung und Parameter der Vorlage.

Test-CFNTemplate -TemplateURL https://s3.amazonaws.com/amzn-s3-demo-bucket/templatefile.template
  • API-Details finden Sie unter ValidateTemplate in AWS -Tools für PowerShell Cmdlet-Referenz (V5).

Im Folgenden sehen Sie eine Beispielantwort, die einen Validierungsfehler erzeugt.

{ "ResponseMetadata": { "RequestId": "4ae33ec0-1988-11e3-818b-e15a6df955cd" }, "Errors": [ { "Message": "Template format error: JSON not well-formed. (line 11, column 8)", "Code": "ValidationError", "Type": "Sender" } ], "Capabilities": [], "Parameters": [] } A client error (ValidationError) occurred: Template format error: JSON not well-formed. (line 11, column 8)
Anmerkung

Der validate-template-Befehl wurde entwickelt, um nur die Syntax Ihrer Vorlage zu überprüfen. Er stellt nicht sicher, dass die Eigenschaftswerte, die Sie für eine Ressource angegeben haben, für diese Ressource gültig sind. Er bestimmt auch nicht die Anzahl der Ressourcen, die bei der Erstellung des Stacks vorhanden sein werden.

Um die Betriebsgültigkeit zu überprüfen, müssen Sie versuchen, den Stack zu erstellen. Es gibt keinen Sandkasten oder Testbereich für CloudFormation Stapel, sodass Ihnen die Ressourcen, die Sie beim Testen erstellen, in Rechnung gestellt werden.

Beispiel für die Verfügbarkeit

Sie können nicht finden, was Sie brauchen? Fordern Sie ein neues Beispiel an, indem Sie den Link Feedback geben unten auf dieser Seite verwenden.