amazonka-sagemaker-2.0: Amazon SageMaker Service SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.SageMaker.StopPipelineExecution

Description

Stops a pipeline execution.

Callback Step

A pipeline execution won't stop while a callback step is running. When you call StopPipelineExecution on a pipeline execution with a running callback step, SageMaker Pipelines sends an additional Amazon SQS message to the specified SQS queue. The body of the SQS message contains a "Status" field which is set to "Stopping".

You should add logic to your Amazon SQS message consumer to take any needed action (for example, resource cleanup) upon receipt of the message followed by a call to SendPipelineExecutionStepSuccess or SendPipelineExecutionStepFailure.

Only when SageMaker Pipelines receives one of these calls will it stop the pipeline execution.

Lambda Step

A pipeline execution can't be stopped while a lambda step is running because the Lambda function invoked by the lambda step can't be stopped. If you attempt to stop the execution while the Lambda function is running, the pipeline waits for the Lambda function to finish or until the timeout is hit, whichever occurs first, and then stops. If the Lambda function finishes, the pipeline execution status is Stopped. If the timeout is hit the pipeline execution status is Failed.

Synopsis

Creating a Request

data StopPipelineExecution Source #

See: newStopPipelineExecution smart constructor.

Constructors

StopPipelineExecution' 

Fields

  • pipelineExecutionArn :: Text

    The Amazon Resource Name (ARN) of the pipeline execution.

  • clientRequestToken :: Text

    A unique, case-sensitive identifier that you provide to ensure the idempotency of the operation. An idempotent operation completes no more than once.

Instances

Instances details
ToJSON StopPipelineExecution Source # 
Instance details

Defined in Amazonka.SageMaker.StopPipelineExecution

ToHeaders StopPipelineExecution Source # 
Instance details

Defined in Amazonka.SageMaker.StopPipelineExecution

ToPath StopPipelineExecution Source # 
Instance details

Defined in Amazonka.SageMaker.StopPipelineExecution

ToQuery StopPipelineExecution Source # 
Instance details

Defined in Amazonka.SageMaker.StopPipelineExecution

AWSRequest StopPipelineExecution Source # 
Instance details

Defined in Amazonka.SageMaker.StopPipelineExecution

Associated Types

type AWSResponse StopPipelineExecution #

Generic StopPipelineExecution Source # 
Instance details

Defined in Amazonka.SageMaker.StopPipelineExecution

Associated Types

type Rep StopPipelineExecution :: Type -> Type #

Read StopPipelineExecution Source # 
Instance details

Defined in Amazonka.SageMaker.StopPipelineExecution

Show StopPipelineExecution Source # 
Instance details

Defined in Amazonka.SageMaker.StopPipelineExecution

NFData StopPipelineExecution Source # 
Instance details

Defined in Amazonka.SageMaker.StopPipelineExecution

Methods

rnf :: StopPipelineExecution -> () #

Eq StopPipelineExecution Source # 
Instance details

Defined in Amazonka.SageMaker.StopPipelineExecution

Hashable StopPipelineExecution Source # 
Instance details

Defined in Amazonka.SageMaker.StopPipelineExecution

type AWSResponse StopPipelineExecution Source # 
Instance details

Defined in Amazonka.SageMaker.StopPipelineExecution

type Rep StopPipelineExecution Source # 
Instance details

Defined in Amazonka.SageMaker.StopPipelineExecution

type Rep StopPipelineExecution = D1 ('MetaData "StopPipelineExecution" "Amazonka.SageMaker.StopPipelineExecution" "amazonka-sagemaker-2.0-9SyrKZ4KqhsL1qX9u3ILA3" 'False) (C1 ('MetaCons "StopPipelineExecution'" 'PrefixI 'True) (S1 ('MetaSel ('Just "pipelineExecutionArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "clientRequestToken") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)))

newStopPipelineExecution Source #

Create a value of StopPipelineExecution with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

StopPipelineExecution, stopPipelineExecution_pipelineExecutionArn - The Amazon Resource Name (ARN) of the pipeline execution.

$sel:clientRequestToken:StopPipelineExecution', stopPipelineExecution_clientRequestToken - A unique, case-sensitive identifier that you provide to ensure the idempotency of the operation. An idempotent operation completes no more than once.

Request Lenses

stopPipelineExecution_pipelineExecutionArn :: Lens' StopPipelineExecution Text Source #

The Amazon Resource Name (ARN) of the pipeline execution.

stopPipelineExecution_clientRequestToken :: Lens' StopPipelineExecution Text Source #

A unique, case-sensitive identifier that you provide to ensure the idempotency of the operation. An idempotent operation completes no more than once.

Destructuring the Response

data StopPipelineExecutionResponse Source #

See: newStopPipelineExecutionResponse smart constructor.

Constructors

StopPipelineExecutionResponse' 

Fields

Instances

Instances details
Generic StopPipelineExecutionResponse Source # 
Instance details

Defined in Amazonka.SageMaker.StopPipelineExecution

Associated Types

type Rep StopPipelineExecutionResponse :: Type -> Type #

Read StopPipelineExecutionResponse Source # 
Instance details

Defined in Amazonka.SageMaker.StopPipelineExecution

Show StopPipelineExecutionResponse Source # 
Instance details

Defined in Amazonka.SageMaker.StopPipelineExecution

NFData StopPipelineExecutionResponse Source # 
Instance details

Defined in Amazonka.SageMaker.StopPipelineExecution

Eq StopPipelineExecutionResponse Source # 
Instance details

Defined in Amazonka.SageMaker.StopPipelineExecution

type Rep StopPipelineExecutionResponse Source # 
Instance details

Defined in Amazonka.SageMaker.StopPipelineExecution

type Rep StopPipelineExecutionResponse = D1 ('MetaData "StopPipelineExecutionResponse" "Amazonka.SageMaker.StopPipelineExecution" "amazonka-sagemaker-2.0-9SyrKZ4KqhsL1qX9u3ILA3" 'False) (C1 ('MetaCons "StopPipelineExecutionResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "pipelineExecutionArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newStopPipelineExecutionResponse Source #

Create a value of StopPipelineExecutionResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

StopPipelineExecution, stopPipelineExecutionResponse_pipelineExecutionArn - The Amazon Resource Name (ARN) of the pipeline execution.

$sel:httpStatus:StopPipelineExecutionResponse', stopPipelineExecutionResponse_httpStatus - The response's http status code.

Response Lenses

stopPipelineExecutionResponse_pipelineExecutionArn :: Lens' StopPipelineExecutionResponse (Maybe Text) Source #

The Amazon Resource Name (ARN) of the pipeline execution.