Class: Aws::CloudFormation::Types::DescribeChangeSetOutput

Inherits:

Struct

• Object
• Struct
• Aws::CloudFormation::Types::DescribeChangeSetOutput

Includes:

Structure

Defined in:

lib/aws-sdk-cloudformation/types.rb

Overview

The output for the DescribeChangeSet action.

See Also:

• AWS API Documentation

Constant Summary

SENSITIVE =

[]

Instance Attribute Summary

• #capabilities ⇒ Array<String>

  If you execute the change set, the list of capabilities that were explicitly acknowledged when the change set was created.

• #change_set_id ⇒ String

  The Amazon Resource Name (ARN) of the change set.

• #change_set_name ⇒ String

  The name of the change set.

• #changes ⇒ Array<Types::Change>

  A list of Change structures that describes the resources CloudFormation changes if you execute the change set.

• #creation_time ⇒ Time

  The start time when the change set was created, in UTC.

• #deployment_mode ⇒ String

  The deployment mode specified when the change set was created.

• #description ⇒ String

  Information about the change set.

• #execution_status ⇒ String

  If the change set execution status is AVAILABLE, you can execute the change set.

• #import_existing_resources ⇒ Boolean

  Indicates if the change set imports resources that already exist.

• #include_nested_stacks ⇒ Boolean

  Verifies if IncludeNestedStacks is set to True.

• #next_token ⇒ String

  If the output exceeds 1 MB, a string that identifies the next page of changes.

• #notification_arns ⇒ Array<String>

  The ARNs of the Amazon SNS topics that will be associated with the stack if you execute the change set.

• #on_stack_failure ⇒ String

  Determines what action will be taken if stack creation fails.

• #parameters ⇒ Array<Types::Parameter>

  A list of Parameter structures that describes the input parameters and their values used to create the change set.

• #parent_change_set_id ⇒ String

  Specifies the change set ID of the parent change set in the current nested change set hierarchy.

• #rollback_configuration ⇒ Types::RollbackConfiguration

  The rollback triggers for CloudFormation to monitor during stack creation and updating operations, and for the specified monitoring period afterwards.

• #root_change_set_id ⇒ String

  Specifies the change set ID of the root change set in the current nested change set hierarchy.

• #stack_drift_status ⇒ String

  The drift status of the stack when the change set was created.

• #stack_id ⇒ String

  The Amazon Resource Name (ARN) of the stack that’s associated with the change set.

• #stack_name ⇒ String

  The name of the stack that’s associated with the change set.

• #status ⇒ String

  The current status of the change set, such as CREATE_PENDING, CREATE_COMPLETE, or FAILED.

• #status_reason ⇒ String

  A description of the change set’s status.

• #tags ⇒ Array<Types::Tag>

  If you execute the change set, the tags that will be associated with the stack.

Instance Attribute Details

#capabilities ⇒ Array<String>

If you execute the change set, the list of capabilities that were explicitly acknowledged when the change set was created.

# File 'lib/aws-sdk-cloudformation/types.rb', line 2725

class DescribeChangeSetOutput < Struct.new(
  :change_set_name,
  :change_set_id,
  :stack_id,
  :stack_name,
  :description,
  :parameters,
  :creation_time,
  :execution_status,
  :status,
  :status_reason,
  :stack_drift_status,
  :notification_arns,
  :rollback_configuration,
  :capabilities,
  :tags,
  :changes,
  :next_token,
  :include_nested_stacks,
  :parent_change_set_id,
  :root_change_set_id,
  :on_stack_failure,
  :import_existing_resources,
  :deployment_mode)
  SENSITIVE = []
  include Aws::Structure
end

#change_set_id ⇒ String

The Amazon Resource Name (ARN) of the change set.

# File 'lib/aws-sdk-cloudformation/types.rb', line 2725

class DescribeChangeSetOutput < Struct.new(
  :change_set_name,
  :change_set_id,
  :stack_id,
  :stack_name,
  :description,
  :parameters,
  :creation_time,
  :execution_status,
  :status,
  :status_reason,
  :stack_drift_status,
  :notification_arns,
  :rollback_configuration,
  :capabilities,
  :tags,
  :changes,
  :next_token,
  :include_nested_stacks,
  :parent_change_set_id,
  :root_change_set_id,
  :on_stack_failure,
  :import_existing_resources,
  :deployment_mode)
  SENSITIVE = []
  include Aws::Structure
end

#change_set_name ⇒ String

The name of the change set.

# File 'lib/aws-sdk-cloudformation/types.rb', line 2725

class DescribeChangeSetOutput < Struct.new(
  :change_set_name,
  :change_set_id,
  :stack_id,
  :stack_name,
  :description,
  :parameters,
  :creation_time,
  :execution_status,
  :status,
  :status_reason,
  :stack_drift_status,
  :notification_arns,
  :rollback_configuration,
  :capabilities,
  :tags,
  :changes,
  :next_token,
  :include_nested_stacks,
  :parent_change_set_id,
  :root_change_set_id,
  :on_stack_failure,
  :import_existing_resources,
  :deployment_mode)
  SENSITIVE = []
  include Aws::Structure
end

#changes ⇒ Array<Types::Change>

A list of Change structures that describes the resources CloudFormation changes if you execute the change set.

# File 'lib/aws-sdk-cloudformation/types.rb', line 2725

class DescribeChangeSetOutput < Struct.new(
  :change_set_name,
  :change_set_id,
  :stack_id,
  :stack_name,
  :description,
  :parameters,
  :creation_time,
  :execution_status,
  :status,
  :status_reason,
  :stack_drift_status,
  :notification_arns,
  :rollback_configuration,
  :capabilities,
  :tags,
  :changes,
  :next_token,
  :include_nested_stacks,
  :parent_change_set_id,
  :root_change_set_id,
  :on_stack_failure,
  :import_existing_resources,
  :deployment_mode)
  SENSITIVE = []
  include Aws::Structure
end

#creation_time ⇒ Time

The start time when the change set was created, in UTC.

# File 'lib/aws-sdk-cloudformation/types.rb', line 2725

class DescribeChangeSetOutput < Struct.new(
  :change_set_name,
  :change_set_id,
  :stack_id,
  :stack_name,
  :description,
  :parameters,
  :creation_time,
  :execution_status,
  :status,
  :status_reason,
  :stack_drift_status,
  :notification_arns,
  :rollback_configuration,
  :capabilities,
  :tags,
  :changes,
  :next_token,
  :include_nested_stacks,
  :parent_change_set_id,
  :root_change_set_id,
  :on_stack_failure,
  :import_existing_resources,
  :deployment_mode)
  SENSITIVE = []
  include Aws::Structure
end

#deployment_mode ⇒ String

The deployment mode specified when the change set was created. Valid value is REVERT_DRIFT. Only present for drift-aware change sets.

# File 'lib/aws-sdk-cloudformation/types.rb', line 2725

class DescribeChangeSetOutput < Struct.new(
  :change_set_name,
  :change_set_id,
  :stack_id,
  :stack_name,
  :description,
  :parameters,
  :creation_time,
  :execution_status,
  :status,
  :status_reason,
  :stack_drift_status,
  :notification_arns,
  :rollback_configuration,
  :capabilities,
  :tags,
  :changes,
  :next_token,
  :include_nested_stacks,
  :parent_change_set_id,
  :root_change_set_id,
  :on_stack_failure,
  :import_existing_resources,
  :deployment_mode)
  SENSITIVE = []
  include Aws::Structure
end

#description ⇒ String

Information about the change set.

# File 'lib/aws-sdk-cloudformation/types.rb', line 2725

class DescribeChangeSetOutput < Struct.new(
  :change_set_name,
  :change_set_id,
  :stack_id,
  :stack_name,
  :description,
  :parameters,
  :creation_time,
  :execution_status,
  :status,
  :status_reason,
  :stack_drift_status,
  :notification_arns,
  :rollback_configuration,
  :capabilities,
  :tags,
  :changes,
  :next_token,
  :include_nested_stacks,
  :parent_change_set_id,
  :root_change_set_id,
  :on_stack_failure,
  :import_existing_resources,
  :deployment_mode)
  SENSITIVE = []
  include Aws::Structure
end

#execution_status ⇒ String

If the change set execution status is AVAILABLE, you can execute the change set. If you can’t execute the change set, the status indicates why. For example, a change set might be in an UNAVAILABLE state because CloudFormation is still creating it or in an OBSOLETE state because the stack was already updated.

# File 'lib/aws-sdk-cloudformation/types.rb', line 2725

class DescribeChangeSetOutput < Struct.new(
  :change_set_name,
  :change_set_id,
  :stack_id,
  :stack_name,
  :description,
  :parameters,
  :creation_time,
  :execution_status,
  :status,
  :status_reason,
  :stack_drift_status,
  :notification_arns,
  :rollback_configuration,
  :capabilities,
  :tags,
  :changes,
  :next_token,
  :include_nested_stacks,
  :parent_change_set_id,
  :root_change_set_id,
  :on_stack_failure,
  :import_existing_resources,
  :deployment_mode)
  SENSITIVE = []
  include Aws::Structure
end

#import_existing_resources ⇒ Boolean

Indicates if the change set imports resources that already exist.

<note markdown=“1”> This parameter can only import resources that have [custom names] in templates. To import resources that do not accept custom names, such as EC2 instances, use the [resource import] feature instead.

</note>

[1]: docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-properties-name.html [2]: docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/resource-import.html

# File 'lib/aws-sdk-cloudformation/types.rb', line 2725

class DescribeChangeSetOutput < Struct.new(
  :change_set_name,
  :change_set_id,
  :stack_id,
  :stack_name,
  :description,
  :parameters,
  :creation_time,
  :execution_status,
  :status,
  :status_reason,
  :stack_drift_status,
  :notification_arns,
  :rollback_configuration,
  :capabilities,
  :tags,
  :changes,
  :next_token,
  :include_nested_stacks,
  :parent_change_set_id,
  :root_change_set_id,
  :on_stack_failure,
  :import_existing_resources,
  :deployment_mode)
  SENSITIVE = []
  include Aws::Structure
end

#include_nested_stacks ⇒ Boolean

Verifies if IncludeNestedStacks is set to True.

# File 'lib/aws-sdk-cloudformation/types.rb', line 2725

class DescribeChangeSetOutput < Struct.new(
  :change_set_name,
  :change_set_id,
  :stack_id,
  :stack_name,
  :description,
  :parameters,
  :creation_time,
  :execution_status,
  :status,
  :status_reason,
  :stack_drift_status,
  :notification_arns,
  :rollback_configuration,
  :capabilities,
  :tags,
  :changes,
  :next_token,
  :include_nested_stacks,
  :parent_change_set_id,
  :root_change_set_id,
  :on_stack_failure,
  :import_existing_resources,
  :deployment_mode)
  SENSITIVE = []
  include Aws::Structure
end

#next_token ⇒ String

If the output exceeds 1 MB, a string that identifies the next page of changes. If there is no additional page, this value is null.

# File 'lib/aws-sdk-cloudformation/types.rb', line 2725

class DescribeChangeSetOutput < Struct.new(
  :change_set_name,
  :change_set_id,
  :stack_id,
  :stack_name,
  :description,
  :parameters,
  :creation_time,
  :execution_status,
  :status,
  :status_reason,
  :stack_drift_status,
  :notification_arns,
  :rollback_configuration,
  :capabilities,
  :tags,
  :changes,
  :next_token,
  :include_nested_stacks,
  :parent_change_set_id,
  :root_change_set_id,
  :on_stack_failure,
  :import_existing_resources,
  :deployment_mode)
  SENSITIVE = []
  include Aws::Structure
end

#notification_arns ⇒ Array<String>

The ARNs of the Amazon SNS topics that will be associated with the stack if you execute the change set.

# File 'lib/aws-sdk-cloudformation/types.rb', line 2725

class DescribeChangeSetOutput < Struct.new(
  :change_set_name,
  :change_set_id,
  :stack_id,
  :stack_name,
  :description,
  :parameters,
  :creation_time,
  :execution_status,
  :status,
  :status_reason,
  :stack_drift_status,
  :notification_arns,
  :rollback_configuration,
  :capabilities,
  :tags,
  :changes,
  :next_token,
  :include_nested_stacks,
  :parent_change_set_id,
  :root_change_set_id,
  :on_stack_failure,
  :import_existing_resources,
  :deployment_mode)
  SENSITIVE = []
  include Aws::Structure
end

#on_stack_failure ⇒ String

Determines what action will be taken if stack creation fails. When this parameter is specified, the DisableRollback parameter to the

ExecuteChangeSet][1

API operation must not be specified. This must

be one of these values:

• DELETE - Deletes the change set if the stack creation fails. This is only valid when the ChangeSetType parameter is set to CREATE. If the deletion of the stack fails, the status of the stack is DELETE_FAILED.

• DO_NOTHING - if the stack creation fails, do nothing. This is equivalent to specifying true for the DisableRollback parameter to the [ExecuteChangeSet] API operation.

• ROLLBACK - if the stack creation fails, roll back the stack. This is equivalent to specifying false for the DisableRollback parameter to the [ExecuteChangeSet] API operation.

[1]: docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_ExecuteChangeSet.html

# File 'lib/aws-sdk-cloudformation/types.rb', line 2725

class DescribeChangeSetOutput < Struct.new(
  :change_set_name,
  :change_set_id,
  :stack_id,
  :stack_name,
  :description,
  :parameters,
  :creation_time,
  :execution_status,
  :status,
  :status_reason,
  :stack_drift_status,
  :notification_arns,
  :rollback_configuration,
  :capabilities,
  :tags,
  :changes,
  :next_token,
  :include_nested_stacks,
  :parent_change_set_id,
  :root_change_set_id,
  :on_stack_failure,
  :import_existing_resources,
  :deployment_mode)
  SENSITIVE = []
  include Aws::Structure
end

#parameters ⇒ Array<Types::Parameter>

A list of Parameter structures that describes the input parameters and their values used to create the change set. For more information, see the [Parameter] data type.

[1]: docs.aws.amazon.com/AWSCloudFormation/latest/APIReference/API_Parameter.html

# File 'lib/aws-sdk-cloudformation/types.rb', line 2725

class DescribeChangeSetOutput < Struct.new(
  :change_set_name,
  :change_set_id,
  :stack_id,
  :stack_name,
  :description,
  :parameters,
  :creation_time,
  :execution_status,
  :status,
  :status_reason,
  :stack_drift_status,
  :notification_arns,
  :rollback_configuration,
  :capabilities,
  :tags,
  :changes,
  :next_token,
  :include_nested_stacks,
  :parent_change_set_id,
  :root_change_set_id,
  :on_stack_failure,
  :import_existing_resources,
  :deployment_mode)
  SENSITIVE = []
  include Aws::Structure
end

#parent_change_set_id ⇒ String

Specifies the change set ID of the parent change set in the current nested change set hierarchy.

# File 'lib/aws-sdk-cloudformation/types.rb', line 2725

class DescribeChangeSetOutput < Struct.new(
  :change_set_name,
  :change_set_id,
  :stack_id,
  :stack_name,
  :description,
  :parameters,
  :creation_time,
  :execution_status,
  :status,
  :status_reason,
  :stack_drift_status,
  :notification_arns,
  :rollback_configuration,
  :capabilities,
  :tags,
  :changes,
  :next_token,
  :include_nested_stacks,
  :parent_change_set_id,
  :root_change_set_id,
  :on_stack_failure,
  :import_existing_resources,
  :deployment_mode)
  SENSITIVE = []
  include Aws::Structure
end

#rollback_configuration ⇒ Types::RollbackConfiguration

The rollback triggers for CloudFormation to monitor during stack creation and updating operations, and for the specified monitoring period afterwards.

# File 'lib/aws-sdk-cloudformation/types.rb', line 2725

class DescribeChangeSetOutput < Struct.new(
  :change_set_name,
  :change_set_id,
  :stack_id,
  :stack_name,
  :description,
  :parameters,
  :creation_time,
  :execution_status,
  :status,
  :status_reason,
  :stack_drift_status,
  :notification_arns,
  :rollback_configuration,
  :capabilities,
  :tags,
  :changes,
  :next_token,
  :include_nested_stacks,
  :parent_change_set_id,
  :root_change_set_id,
  :on_stack_failure,
  :import_existing_resources,
  :deployment_mode)
  SENSITIVE = []
  include Aws::Structure
end

#root_change_set_id ⇒ String

Specifies the change set ID of the root change set in the current nested change set hierarchy.

# File 'lib/aws-sdk-cloudformation/types.rb', line 2725

class DescribeChangeSetOutput < Struct.new(
  :change_set_name,
  :change_set_id,
  :stack_id,
  :stack_name,
  :description,
  :parameters,
  :creation_time,
  :execution_status,
  :status,
  :status_reason,
  :stack_drift_status,
  :notification_arns,
  :rollback_configuration,
  :capabilities,
  :tags,
  :changes,
  :next_token,
  :include_nested_stacks,
  :parent_change_set_id,
  :root_change_set_id,
  :on_stack_failure,
  :import_existing_resources,
  :deployment_mode)
  SENSITIVE = []
  include Aws::Structure
end

#stack_drift_status ⇒ String

The drift status of the stack when the change set was created. Valid values:

• DRIFTED – The stack has drifted from its last deployment.

• IN_SYNC – The stack is in sync with its last deployment.

• NOT_CHECKED – CloudFormation doesn’t currently return this value.

• UNKNOWN – The drift status could not be determined.

Only present for drift-aware change sets.

# File 'lib/aws-sdk-cloudformation/types.rb', line 2725

class DescribeChangeSetOutput < Struct.new(
  :change_set_name,
  :change_set_id,
  :stack_id,
  :stack_name,
  :description,
  :parameters,
  :creation_time,
  :execution_status,
  :status,
  :status_reason,
  :stack_drift_status,
  :notification_arns,
  :rollback_configuration,
  :capabilities,
  :tags,
  :changes,
  :next_token,
  :include_nested_stacks,
  :parent_change_set_id,
  :root_change_set_id,
  :on_stack_failure,
  :import_existing_resources,
  :deployment_mode)
  SENSITIVE = []
  include Aws::Structure
end

#stack_id ⇒ String

The Amazon Resource Name (ARN) of the stack that’s associated with the change set.

# File 'lib/aws-sdk-cloudformation/types.rb', line 2725

class DescribeChangeSetOutput < Struct.new(
  :change_set_name,
  :change_set_id,
  :stack_id,
  :stack_name,
  :description,
  :parameters,
  :creation_time,
  :execution_status,
  :status,
  :status_reason,
  :stack_drift_status,
  :notification_arns,
  :rollback_configuration,
  :capabilities,
  :tags,
  :changes,
  :next_token,
  :include_nested_stacks,
  :parent_change_set_id,
  :root_change_set_id,
  :on_stack_failure,
  :import_existing_resources,
  :deployment_mode)
  SENSITIVE = []
  include Aws::Structure
end

#stack_name ⇒ String

The name of the stack that’s associated with the change set.

# File 'lib/aws-sdk-cloudformation/types.rb', line 2725

class DescribeChangeSetOutput < Struct.new(
  :change_set_name,
  :change_set_id,
  :stack_id,
  :stack_name,
  :description,
  :parameters,
  :creation_time,
  :execution_status,
  :status,
  :status_reason,
  :stack_drift_status,
  :notification_arns,
  :rollback_configuration,
  :capabilities,
  :tags,
  :changes,
  :next_token,
  :include_nested_stacks,
  :parent_change_set_id,
  :root_change_set_id,
  :on_stack_failure,
  :import_existing_resources,
  :deployment_mode)
  SENSITIVE = []
  include Aws::Structure
end

#status ⇒ String

The current status of the change set, such as CREATE_PENDING, CREATE_COMPLETE, or FAILED.

# File 'lib/aws-sdk-cloudformation/types.rb', line 2725

class DescribeChangeSetOutput < Struct.new(
  :change_set_name,
  :change_set_id,
  :stack_id,
  :stack_name,
  :description,
  :parameters,
  :creation_time,
  :execution_status,
  :status,
  :status_reason,
  :stack_drift_status,
  :notification_arns,
  :rollback_configuration,
  :capabilities,
  :tags,
  :changes,
  :next_token,
  :include_nested_stacks,
  :parent_change_set_id,
  :root_change_set_id,
  :on_stack_failure,
  :import_existing_resources,
  :deployment_mode)
  SENSITIVE = []
  include Aws::Structure
end

#status_reason ⇒ String

A description of the change set’s status. For example, if your attempt to create a change set failed, CloudFormation shows the error message.

# File 'lib/aws-sdk-cloudformation/types.rb', line 2725

class DescribeChangeSetOutput < Struct.new(
  :change_set_name,
  :change_set_id,
  :stack_id,
  :stack_name,
  :description,
  :parameters,
  :creation_time,
  :execution_status,
  :status,
  :status_reason,
  :stack_drift_status,
  :notification_arns,
  :rollback_configuration,
  :capabilities,
  :tags,
  :changes,
  :next_token,
  :include_nested_stacks,
  :parent_change_set_id,
  :root_change_set_id,
  :on_stack_failure,
  :import_existing_resources,
  :deployment_mode)
  SENSITIVE = []
  include Aws::Structure
end

#tags ⇒ Array<Types::Tag>

If you execute the change set, the tags that will be associated with the stack.

# File 'lib/aws-sdk-cloudformation/types.rb', line 2725

class DescribeChangeSetOutput < Struct.new(
  :change_set_name,
  :change_set_id,
  :stack_id,
  :stack_name,
  :description,
  :parameters,
  :creation_time,
  :execution_status,
  :status,
  :status_reason,
  :stack_drift_status,
  :notification_arns,
  :rollback_configuration,
  :capabilities,
  :tags,
  :changes,
  :next_token,
  :include_nested_stacks,
  :parent_change_set_id,
  :root_change_set_id,
  :on_stack_failure,
  :import_existing_resources,
  :deployment_mode)
  SENSITIVE = []
  include Aws::Structure
end