変更セットの表示

変更セットの作成後、実行前に目的の変更を確認できます。変更セットの表示には AWS CloudFormation コンソール、AWS CLI、または AWS CloudFormation API を使用できます。AWS CloudFormation コンソールは、変更の概要、および JSON 形式の変更の詳細なリストを提供します。AWS CLI および AWS CloudFormation API は、JSON 形式の変更の詳細なリストを返します。

View a change set for nested stack (console)

ネストされたスタックの変更セットを表示するには (コンソール)

AWS CloudFormation コンソールの [スタック] で、表示する変更セットを含むスタックの名前を選択します。
ナビゲーションペインで、[変更セット] を選択して、スタックの変更セットのリストを表示します。
表示する変更セットの名前を選択します。

AWS CloudFormation コンソールに変更セットの詳細ページが表示されます。ここで変更セットの作成時刻、ステータス、変更セットの生成に使用された入力、および変更の要約を確認できます。

[Changes] セクションの各行は、AWS CloudFormation が動的な状態を追加、変更、削除、表示するリソースを表します。
- Add - スタックのテンプレートにリソースを追加すると、AWS CloudFormation によってリソースが作成されます。
- Modify - スタックのテンプレート内のリソースのプロパティを変更すると、AWS CloudFormation はリソースを変更します。
- Remove - スタックのテンプレートから既存のリソースを削除すると、AWS CloudFormation によってリソースが削除されます。
- Dynamic - AWS CloudFormation はネストされたスタックのテンプレートから正確なリソース変更アクションを特定できません。
注記

変更によってリソースが中断されたり置き換え (再作成) されたりすることがあります。リソースの更新動作の詳細については、スタックのリソースの更新動作を参照してください。

特定の変更に注目するには、フィルタビューを使用します。たとえば、AWS::CloudFormation::Stack などの特定のリソースタイプをフィルタリングします。特定のリソースをフィルタリングするには、DeadLetterQueue や NestedStack のような論理 ID または物理 ID を指定します。
[Changes] セクションで、表示するネストされた変更セットの [View nested change set] を選択します。

AWS CloudFormation コンソールによって、ネストされた変更セットの詳細ページへ移動します。[Go to root change set] を選択してルート変更セットを表示するか、[View parent change set] を選択して親変更セットを表示できます。詳細については、「ネストされたスタックの変更セット」を参照してください。

View a change set (console)

変更セットを表示するには (コンソール)

AWS CloudFormation コンソールの [スタック] で、表示する変更セットを含むスタックの名前を選択します。
ナビゲーションペインで、[変更セット] を選択して、スタックの変更セットのリストを表示します。
表示する変更セットの名前を選択します。

AWS CloudFormation コンソールに変更セットの詳細ページが表示されます。ここで変更セットの作成時刻、ステータス、変更セットの生成に使用された入力、および変更の要約を確認できます。

[Changes] セクションの各行は、AWS CloudFormation が追加、変更、削除するリソースを表します。
- Add - スタックのテンプレートにリソースを追加すると、AWS CloudFormation によってリソースが作成されます。
- Modify - スタックのテンプレート内のリソースのプロパティを変更すると、AWS CloudFormation はリソースを変更します。
- Remove - スタックのテンプレートから既存のリソースを削除すると、AWS CloudFormation によってリソースが削除されます。
注記

変更によってリソースが中断されたり置き換え (再作成) されたりすることがあります。リソースの更新動作の詳細については、スタックのリソースの更新動作を参照してください。

特定の変更に注目するには、フィルタビューを使用します。たとえば、AWS::EC2::Instance などの特定のリソースタイプをフィルタリングします。特定のリソースをフィルタリングするには、myWebServer や i-123abcd4 のような論理 ID または物理 ID を指定します。

変更セットを表示するには (AWS CLI)

変更セットの ID を取得するには、aws cloudformation list-change-sets コマンドを実行します。

次の例のように、表示する変更セットがあるスタックのスタック ID を指定します。


aws cloudformation list-change-sets --stack-name arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/1a2345b6-0000-00a0-a123-00abc0abc000

AWS CloudFormation から、次のような変更セットのリストが返されます。


{
    "Summaries": [
        {
            "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/1a2345b6-0000-00a0-a123-00abc0abc000",
            "Status": "CREATE_COMPLETE",
            "ChangeSetName": "SampleChangeSet",
            "CreationTime": "2020-11-18T20:44:05.889Z",
            "StackName": "SampleStack",
            "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet/1a2345b6-0000-00a0-a123-00abc0abc000"
        },
        {
            "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/1a2345b6-0000-00a0-a123-00abc0abc000",
            "Status": "CREATE_COMPLETE",
            "ChangeSetName": "SampleChangeSet-conditional",
            "CreationTime": "2020-11-18T21:15:56.398Z",
            "StackName": "SampleStack",
            "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet-conditional/1a2345b6-0000-00a0-a123-00abc0abc000"
        },
        {
            "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/1a2345b6-0000-00a0-a123-00abc0abc000",
            "Status": "CREATE_COMPLETE",
            "ChangeSetName": "SampleChangeSet-replacement",
            "CreationTime": "2020-11-18T21:03:37.706Z",
            "StackName": "SampleStack",
            "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet-replacement/1a2345b6-0000-00a0-a123-00abc0abc000"
        }
    ]
}

表示する変更セットの ID を指定して aws cloudformation describe-change-set コマンドを実行します。以下に例を示します。


aws cloudformation describe-change-set --change-set-name arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet/1a2345b6-0000-00a0-a123-00abc0abc000

AWS CloudFormation から、指定された変更セットに関する情報が返されます。


{
    "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/1a2345b6-0000-00a0-a123-00abc0abc000",
    "Status": "CREATE_COMPLETE",
    "ChangeSetName": "SampleChangeSet-direct",
    "Parameters": [
        {
            "ParameterValue": "testing",
            "ParameterKey": "Purpose"
        },
        {
            "ParameterValue": "ellioty-useast1",
            "ParameterKey": "KeyPairName"
        },
        {
            "ParameterValue": "t2.micro",
            "ParameterKey": "InstanceType"
        }
    ],
    "Changes": [
        {
            "ResourceChange": {
                "ResourceType": "AWS::EC2::Instance",
                "PhysicalResourceId": "i-1abc23d4",
                "Details": [
                    {
                        "ChangeSource": "DirectModification",
                        "Evaluation": "Static",
                        "Target": {
                            "Attribute": "Tags",
                            "RequiresRecreation": "Never"
                        }
                    }
                ],
                "Action": "Modify",
                "Scope": [
                    "Tags"
                ],
                "LogicalResourceId": "MyEC2Instance",
                "Replacement": "False"
            },
            "Type": "Resource"
        }
    ],
    "CreationTime": "2020-11-18T23:35:25.813Z",
    "Capabilities": [],
    "StackName": "SampleStack",
    "NotificationARNs": [],
    "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet-direct/9edde307-960d-4e6e-ad66-b09ea2f20255"
}

Changes キーリストはリソースを変更します。この変更セットを実行した場合、AWS CloudFormation によって i-1abc23d4 EC2 インスタンスのタグが更新されます。各フィールドの詳細については、AWS CloudFormation API Reference の Change データ型を参照してください。

変更セットのその他の例については、変更セットのサンプルを参照してください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

変更セットの作成

変更セットの実行