Copyright	(c) 2013-2021 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay <brendan.g.hay+amazonka@gmail.com>
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	None

Amazonka.Batch.CancelJob

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Cancels a job in an Batch job queue. Jobs that are in the SUBMITTED, PENDING, or RUNNABLE state are canceled. Jobs that have progressed to STARTING or RUNNING aren't canceled, but the API operation still succeeds, even if no job is canceled. These jobs must be terminated with the TerminateJob operation.

Synopsis

data CancelJob = CancelJob' {
- jobId :: Text
- reason :: Text
}
newCancelJob :: Text -> Text -> CancelJob
cancelJob_jobId :: Lens' CancelJob Text
cancelJob_reason :: Lens' CancelJob Text
data CancelJobResponse = CancelJobResponse' {
- httpStatus :: Int
}
newCancelJobResponse :: Int -> CancelJobResponse
cancelJobResponse_httpStatus :: Lens' CancelJobResponse Int

Creating a Request

data CancelJob Source #

Contains the parameters for CancelJob.

See: newCancelJob smart constructor.

Constructors

CancelJob'
Fields jobId :: Text The Batch job ID of the job to cancel. reason :: Text A message to attach to the job that explains the reason for canceling it. This message is returned by future DescribeJobs operations on the job. This message is also recorded in the Batch activity logs.

Instances

Instances details

Eq CancelJob Source #
Instance details Defined in Amazonka.Batch.CancelJob Methods (==) :: CancelJob -> CancelJob -> Bool # (/=) :: CancelJob -> CancelJob -> Bool #
Read CancelJob Source #
Instance details Defined in Amazonka.Batch.CancelJob Methods readsPrec :: Int -> ReadS CancelJob # readList :: ReadS [CancelJob] # readPrec :: ReadPrec CancelJob # readListPrec :: ReadPrec [CancelJob] #
Show CancelJob Source #
Instance details Defined in Amazonka.Batch.CancelJob Methods showsPrec :: Int -> CancelJob -> ShowS # show :: CancelJob -> String # showList :: [CancelJob] -> ShowS #
Generic CancelJob Source #
Instance details Defined in Amazonka.Batch.CancelJob Associated Types type Rep CancelJob :: Type -> Type # Methods from :: CancelJob -> Rep CancelJob x # to :: Rep CancelJob x -> CancelJob #
NFData CancelJob Source #
Instance details Defined in Amazonka.Batch.CancelJob Methods rnf :: CancelJob -> () #
Hashable CancelJob Source #
Instance details Defined in Amazonka.Batch.CancelJob Methods hashWithSalt :: Int -> CancelJob -> Int # hash :: CancelJob -> Int #
ToJSON CancelJob Source #
Instance details Defined in Amazonka.Batch.CancelJob Methods toJSON :: CancelJob -> Value # toEncoding :: CancelJob -> Encoding # toJSONList :: [CancelJob] -> Value # toEncodingList :: [CancelJob] -> Encoding #
AWSRequest CancelJob Source #
Instance details Defined in Amazonka.Batch.CancelJob Associated Types type AWSResponse CancelJob # Methods request :: CancelJob -> Request CancelJob # response :: MonadResource m => Logger -> Service -> Proxy CancelJob -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse CancelJob))) #
ToHeaders CancelJob Source #
Instance details Defined in Amazonka.Batch.CancelJob Methods toHeaders :: CancelJob -> [Header] #
ToPath CancelJob Source #
Instance details Defined in Amazonka.Batch.CancelJob Methods toPath :: CancelJob -> ByteString #
ToQuery CancelJob Source #
Instance details Defined in Amazonka.Batch.CancelJob Methods toQuery :: CancelJob -> QueryString #
type Rep CancelJob Source #
Instance details Defined in Amazonka.Batch.CancelJob type Rep CancelJob = D1 ('MetaData "CancelJob" "Amazonka.Batch.CancelJob" "libZSservicesZSamazonka-batchZSamazonka-batch" 'False) (C1 ('MetaCons "CancelJob'" 'PrefixI 'True) (S1 ('MetaSel ('Just "jobId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "reason") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)))
type AWSResponse CancelJob Source #
Instance details Defined in Amazonka.Batch.CancelJob type AWSResponse CancelJob = CancelJobResponse

newCancelJob Source #

Arguments

:: Text	`$sel:jobId:CancelJob'`
-> Text	`$sel:reason:CancelJob'`
-> CancelJob

Create a value of CancelJob 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:

$sel:jobId:CancelJob', cancelJob_jobId - The Batch job ID of the job to cancel.

$sel:reason:CancelJob', cancelJob_reason - A message to attach to the job that explains the reason for canceling it. This message is returned by future DescribeJobs operations on the job. This message is also recorded in the Batch activity logs.

Request Lenses

cancelJob_jobId :: Lens' CancelJob Text Source #

The Batch job ID of the job to cancel.

cancelJob_reason :: Lens' CancelJob Text Source #

A message to attach to the job that explains the reason for canceling it. This message is returned by future DescribeJobs operations on the job. This message is also recorded in the Batch activity logs.

Destructuring the Response

data CancelJobResponse Source #

See: newCancelJobResponse smart constructor.

Constructors

CancelJobResponse'
Fields httpStatus :: Int The response's http status code.

Instances

Instances details

Eq CancelJobResponse Source #
Instance details Defined in Amazonka.Batch.CancelJob Methods (==) :: CancelJobResponse -> CancelJobResponse -> Bool # (/=) :: CancelJobResponse -> CancelJobResponse -> Bool #
Read CancelJobResponse Source #
Instance details Defined in Amazonka.Batch.CancelJob Methods readsPrec :: Int -> ReadS CancelJobResponse # readList :: ReadS [CancelJobResponse] # readPrec :: ReadPrec CancelJobResponse # readListPrec :: ReadPrec [CancelJobResponse] #
Show CancelJobResponse Source #
Instance details Defined in Amazonka.Batch.CancelJob Methods showsPrec :: Int -> CancelJobResponse -> ShowS # show :: CancelJobResponse -> String # showList :: [CancelJobResponse] -> ShowS #
Generic CancelJobResponse Source #
Instance details Defined in Amazonka.Batch.CancelJob Associated Types type Rep CancelJobResponse :: Type -> Type # Methods from :: CancelJobResponse -> Rep CancelJobResponse x # to :: Rep CancelJobResponse x -> CancelJobResponse #
NFData CancelJobResponse Source #
Instance details Defined in Amazonka.Batch.CancelJob Methods rnf :: CancelJobResponse -> () #
type Rep CancelJobResponse Source #
Instance details Defined in Amazonka.Batch.CancelJob type Rep CancelJobResponse = D1 ('MetaData "CancelJobResponse" "Amazonka.Batch.CancelJob" "libZSservicesZSamazonka-batchZSamazonka-batch" 'False) (C1 ('MetaCons "CancelJobResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newCancelJobResponse Source #

Arguments

:: Int	`$sel:httpStatus:CancelJobResponse'`
-> CancelJobResponse

Create a value of CancelJobResponse 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:

$sel:httpStatus:CancelJobResponse', cancelJobResponse_httpStatus - The response's http status code.

Response Lenses

cancelJobResponse_httpStatus :: Lens' CancelJobResponse Int Source #

The response's http status code.