または UpdateStackAWS SDKで を使用する CLI

以下のコード例は、UpdateStack の使用方法を示しています。

CLI

AWS CLI

AWS CloudFormation スタックを更新するには

以下の update-stack コマンドは、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

以下の update-stack コマンドは、mystack スタックの SubnetIDs パラメータ値のみを更新します。パラメータ値を指定しない場合は、テンプレートで指定されているデフォルト値が使用されます。

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

以下の update-stack コマンドは、mystack スタックに 2 つのスタック通知トピックを追加します。

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"

詳細については、「 ユーザーガイド」の「 AWS CloudFormation スタックの更新AWS CloudFormation 」を参照してください。

• API 詳細については、「 コマンドリファレンスUpdateStack」の「」を参照してください。 AWS CLI

PowerShell

のツール PowerShell

例 1: 指定されたテンプレートとカスタマイズパラメータを使用してスタック 'myStack' を更新します。'PK1' はテンプレートで宣言されたパラメータの名前を表し、'PV1' はその値を表します。カスタマイズパラメータは、「Key」と「Value」ではなく「Key」と「ValueParameterKey」を使用して指定することもできますParameterValue。

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

例 2: 指定されたテンプレートとカスタマイズパラメータを使用してスタック 'myStack' を更新します。'PK1' と 'PK2' はテンプレートで宣言されたパラメータの名前を表し、'PV1' と 'PV2' は要求された値を表します。カスタマイズパラメータは、「Key」と「Value」ではなく「Key」と「ValueParameterKey」を使用して指定することもできますParameterValue。

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

例 3: 指定されたテンプレートとカスタマイズパラメータを使用してスタック 'myStack' を更新します。'PK1' はテンプレートで宣言されたパラメータの名前を表し、'PV2' はその値を表します。カスタマイズパラメータは、「Key」と「Value」ではなく「Key」と「ValueParameterKey」を使用して指定することもできますParameterValue。

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

例 4: Amazon S3 から取得した指定されたテンプレートとカスタマイズパラメータを使用してスタック 'myStack' を更新します。 Amazon S3 'PK1' と 'PK2' はテンプレートで宣言されたパラメータの名前を表し、'PV1' と 'PV2' は要求された値を表します。カスタマイズパラメータは、「Key」と「Value」ではなく「Key」と「ValueParameterKey」を使用して指定することもできますParameterValue。

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

例 5: この例で想定されているスタック 'myStack' を更新してIAM、指定されたテンプレート、Amazon S3 から取得したテンプレート、およびカスタマイズパラメータを使用してリソースを含めます。'PK1' と 'PK2' はテンプレートで宣言されたパラメータの名前を表し、'PV1' と 'PV2' は要求された値を表します。カスタマイズパラメータは、「Key」と「Value」ではなく「Key」と「ValueParameterKey」を使用して指定することもできますParameterValue。IAMリソースを含むスタックでは、-Capabilities "CAPABILITY_IAM" パラメータを指定する必要があります。指定しないと、更新はInsufficientCapabilities「」エラーで失敗します。

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

• API 詳細については、「 コマンドレットリファレンスUpdateStack」の「」を参照してください。 AWS Tools for PowerShell