cancel_steps

cancel_steps(**kwargs)

Cancels a pending step or steps in a running cluster. Available only in Amazon EMR versions 4.8.0 and later, excluding version 5.0.0. A maximum of 256 steps are allowed in each CancelSteps request. CancelSteps is idempotent but asynchronous; it does not guarantee that a step will be canceled, even if the request is successfully submitted. When you use Amazon EMR versions 5.28.0 and later, you can cancel steps that are in a PENDING or RUNNING state. In earlier versions of Amazon EMR, you can only cancel steps that are in a PENDING state.

See also: AWS API Documentation

Request Syntax

response = client.cancel_steps(
    ClusterId='string',
    StepIds=[
        'string',
    ],
    StepCancellationOption='SEND_INTERRUPT'|'TERMINATE_PROCESS'
)

Parameters

• ClusterId (string) --

  [REQUIRED]

  The ClusterID for the specified steps that will be canceled. Use RunJobFlow and ListClusters to get ClusterIDs.

• StepIds (list) --

  [REQUIRED]

  The list of StepIDs to cancel. Use ListSteps to get steps and their states for the specified cluster.

  • (string) --
• StepCancellationOption (string) -- The option to choose to cancel RUNNING steps. By default, the value is SEND_INTERRUPT .

Return type

dict

Returns

Response Syntax

{
    'CancelStepsInfoList': [
        {
            'StepId': 'string',
            'Status': 'SUBMITTED'|'FAILED',
            'Reason': 'string'
        },
    ]
}

Response Structure

• (dict) --

  The output for the CancelSteps operation.

  • CancelStepsInfoList (list) --

    A list of CancelStepsInfo, which shows the status of specified cancel requests for each StepID specified.

    • (dict) --

      Specification of the status of a CancelSteps request. Available only in Amazon EMR version 4.8.0 and later, excluding version 5.0.0.

      • StepId (string) --

        The encrypted StepId of a step.

      • Status (string) --

        The status of a CancelSteps Request. The value may be SUBMITTED or FAILED.

      • Reason (string) --

        The reason for the failure if the CancelSteps request fails.

Exceptions

• EMR.Client.exceptions.InternalServerError
• EMR.Client.exceptions.InvalidRequestException