変更セットの表示 - AWS CloudFormation

変更セットの表示

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

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

  1. AWS CloudFormation コンソールの [スタック] で、表示する変更セットを含むスタックの名前を選択します。

  2. ナビゲーションペインで、[変更セット] を選択して、スタックの変更セットのリストを表示します。

  3. 表示する変更セットの名前を選択します。

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

    変更セットの詳細ページ。

    [変更] セクションの各行は、AWS CloudFormation によって追加、削除、または変更されるリソースを表します。スタックのテンプレートにリソースを追加すると、AWS CloudFormation によってリソースが追加されます。スタックのテンプレートから既存のリソースを削除すると、AWS CloudFormation によってリソースが削除されます。スタックのテンプレートでリソースのプロパティを変更すると、AWS CloudFormation によってリソースが変更されます。変更によってリソースが中断されたり置き換え (再作成) されたりすることがあることに注意してください。リソースの更新動作の詳細については、スタックのリソースの更新動作を参照してください。

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

    実行する変更を決定する前に他の変更を検討する場合は、追加で変更セットを作成します。

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

  1. 変更セットの 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": "2016-03-16T20: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": "2016-03-16T21: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": "2016-03-16T21:03:37.706Z",
            "StackName": "SampleStack",
            "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet-replacement/1a2345b6-0000-00a0-a123-00abc0abc000"
        }
    ]
}

  2. 表示する変更セットの 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": "2016-03-17T23: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 データ型を参照してください。

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