describe_change_set_hooks

describe_change_set_hooks(**kwargs)

Returns hook-related information for the change set and a list of changes that CloudFormation makes when you run the change set.

See also: AWS API Documentation

Request Syntax

response = client.describe_change_set_hooks(
    ChangeSetName='string',
    StackName='string',
    NextToken='string',
    LogicalResourceId='string'
)

Parameters

• ChangeSetName (string) --

  [REQUIRED]

  The name or Amazon Resource Name (ARN) of the change set that you want to describe.

• StackName (string) -- If you specified the name of a change set, specify the stack name or stack ID (ARN) of the change set you want to describe.
• NextToken (string) -- A string, provided by the DescribeChangeSetHooks response output, that identifies the next page of information that you want to retrieve.
• LogicalResourceId (string) -- If specified, lists only the hooks related to the specified LogicalResourceId .

Return type

dict

Returns

Response Syntax

{
    'ChangeSetId': 'string',
    'ChangeSetName': 'string',
    'Hooks': [
        {
            'InvocationPoint': 'PRE_PROVISION',
            'FailureMode': 'FAIL'|'WARN',
            'TypeName': 'string',
            'TypeVersionId': 'string',
            'TypeConfigurationVersionId': 'string',
            'TargetDetails': {
                'TargetType': 'RESOURCE',
                'ResourceTargetDetails': {
                    'LogicalResourceId': 'string',
                    'ResourceType': 'string',
                    'ResourceAction': 'Add'|'Modify'|'Remove'|'Import'|'Dynamic'
                }
            }
        },
    ],
    'Status': 'PLANNING'|'PLANNED'|'UNAVAILABLE',
    'NextToken': 'string',
    'StackId': 'string',
    'StackName': 'string'
}

Response Structure

• (dict) --

  • ChangeSetId (string) --

    The change set identifier (stack ID).

  • ChangeSetName (string) --

    The change set name.

  • Hooks (list) --

    List of hook objects.

    • (dict) --

      Specifies the resource, the hook, and the hook version to be invoked.

      • InvocationPoint (string) --

        Specifies the points in provisioning logic where a hook is invoked.

      • FailureMode (string) --

        Specify the hook failure mode for non-compliant resources in the followings ways.

        • FAIL Stops provisioning resources.
        • WARN Allows provisioning to continue with a warning message.

      • TypeName (string) --

        The unique name for your hook. Specifies a three-part namespace for your hook, with a recommended pattern of Organization::Service::Hook .

        Note

        The following organization namespaces are reserved and can't be used in your hook type names:

        • Alexa
        • AMZN
        • Amazon
        • ASK
        • AWS
        • Custom
        • Dev

      • TypeVersionId (string) --

        The version ID of the type specified.

      • TypeConfigurationVersionId (string) --

        The version ID of the type configuration.

      • TargetDetails (dict) --

        Specifies details about the target that the hook will run against.

        • TargetType (string) --

          The name of the type.

        • ResourceTargetDetails (dict) --

          Required if TargetType is RESOURCE .

          • LogicalResourceId (string) --

            The resource's logical ID, which is defined in the stack's template.

          • ResourceType (string) --

            The type of CloudFormation resource, such as AWS::S3::Bucket .

          • ResourceAction (string) --

            Specifies the action of the resource.

  • Status (string) --

    Provides the status of the change set hook.

  • NextToken (string) --

    Pagination token, null or empty if no more results.

  • StackId (string) --

    The stack identifier (stack ID).

  • StackName (string) --

    The stack name.

Exceptions

• CloudFormation.Client.exceptions.ChangeSetNotFoundException