Copyright	(c) 2013-2023 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	Safe-Inferred
Language	Haskell2010

Amazonka.DataSync.StartTaskExecution

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Starts an DataSync task. For each task, you can only run one task execution at a time.

There are several phases to a task execution. For more information, see Task execution statuses.

Synopsis

data StartTaskExecution = StartTaskExecution' {
- excludes :: Maybe [FilterRule]
- includes :: Maybe [FilterRule]
- overrideOptions :: Maybe Options
- tags :: Maybe [TagListEntry]
- taskArn :: Text
}
newStartTaskExecution :: Text -> StartTaskExecution
startTaskExecution_excludes :: Lens' StartTaskExecution (Maybe [FilterRule])
startTaskExecution_includes :: Lens' StartTaskExecution (Maybe [FilterRule])
startTaskExecution_overrideOptions :: Lens' StartTaskExecution (Maybe Options)
startTaskExecution_tags :: Lens' StartTaskExecution (Maybe [TagListEntry])
startTaskExecution_taskArn :: Lens' StartTaskExecution Text
data StartTaskExecutionResponse = StartTaskExecutionResponse' {
- taskExecutionArn :: Maybe Text
- httpStatus :: Int
}
newStartTaskExecutionResponse :: Int -> StartTaskExecutionResponse
startTaskExecutionResponse_taskExecutionArn :: Lens' StartTaskExecutionResponse (Maybe Text)
startTaskExecutionResponse_httpStatus :: Lens' StartTaskExecutionResponse Int

Creating a Request

data StartTaskExecution Source #

StartTaskExecutionRequest

See: newStartTaskExecution smart constructor.

Constructors

StartTaskExecution'

Fields

excludes :: Maybe [FilterRule]
Specifies a list of filter rules that determines which files to exclude from a task. The list contains a single filter string that consists of the patterns to exclude. The patterns are delimited by "|" (that is, a pipe), for example, "/folder1|/folder2".
includes :: Maybe [FilterRule]
Specifies a list of filter rules that determines which files to include when running a task. The pattern should contain a single filter string that consists of the patterns to include. The patterns are delimited by "|" (that is, a pipe), for example, "/folder1|/folder2".
overrideOptions :: Maybe Options
tags :: Maybe [TagListEntry]
Specifies the tags that you want to apply to the Amazon Resource Name (ARN) representing the task execution.
Tags are key-value pairs that help you manage, filter, and search for your DataSync resources.
taskArn :: Text
Specifies the Amazon Resource Name (ARN) of the task that you want to start.

Instances

Instances details

ToJSON StartTaskExecution Source #
Instance details Defined in Amazonka.DataSync.StartTaskExecution Methods toJSON :: StartTaskExecution -> Value # toEncoding :: StartTaskExecution -> Encoding # toJSONList :: [StartTaskExecution] -> Value # toEncodingList :: [StartTaskExecution] -> Encoding #
ToHeaders StartTaskExecution Source #
Instance details Defined in Amazonka.DataSync.StartTaskExecution Methods toHeaders :: StartTaskExecution -> [Header] #
ToPath StartTaskExecution Source #
Instance details Defined in Amazonka.DataSync.StartTaskExecution Methods toPath :: StartTaskExecution -> ByteString #
ToQuery StartTaskExecution Source #
Instance details Defined in Amazonka.DataSync.StartTaskExecution Methods toQuery :: StartTaskExecution -> QueryString #
AWSRequest StartTaskExecution Source #
Instance details Defined in Amazonka.DataSync.StartTaskExecution Associated Types type AWSResponse StartTaskExecution # Methods request :: (Service -> Service) -> StartTaskExecution -> Request StartTaskExecution # response :: MonadResource m => (ByteStringLazy -> IO ByteStringLazy) -> Service -> Proxy StartTaskExecution -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse StartTaskExecution))) #
Generic StartTaskExecution Source #
Instance details Defined in Amazonka.DataSync.StartTaskExecution Associated Types type Rep StartTaskExecution :: Type -> Type # Methods from :: StartTaskExecution -> Rep StartTaskExecution x # to :: Rep StartTaskExecution x -> StartTaskExecution #
Read StartTaskExecution Source #
Instance details Defined in Amazonka.DataSync.StartTaskExecution Methods readsPrec :: Int -> ReadS StartTaskExecution # readList :: ReadS [StartTaskExecution] # readPrec :: ReadPrec StartTaskExecution # readListPrec :: ReadPrec [StartTaskExecution] #
Show StartTaskExecution Source #
Instance details Defined in Amazonka.DataSync.StartTaskExecution Methods showsPrec :: Int -> StartTaskExecution -> ShowS # show :: StartTaskExecution -> String # showList :: [StartTaskExecution] -> ShowS #
NFData StartTaskExecution Source #
Instance details Defined in Amazonka.DataSync.StartTaskExecution Methods rnf :: StartTaskExecution -> () #
Eq StartTaskExecution Source #
Instance details Defined in Amazonka.DataSync.StartTaskExecution Methods (==) :: StartTaskExecution -> StartTaskExecution -> Bool # (/=) :: StartTaskExecution -> StartTaskExecution -> Bool #
Hashable StartTaskExecution Source #
Instance details Defined in Amazonka.DataSync.StartTaskExecution Methods hashWithSalt :: Int -> StartTaskExecution -> Int # hash :: StartTaskExecution -> Int #
type AWSResponse StartTaskExecution Source #
Instance details Defined in Amazonka.DataSync.StartTaskExecution type AWSResponse StartTaskExecution = StartTaskExecutionResponse
type Rep StartTaskExecution Source #
Instance details Defined in Amazonka.DataSync.StartTaskExecution type Rep StartTaskExecution = D1 ('MetaData "StartTaskExecution" "Amazonka.DataSync.StartTaskExecution" "amazonka-datasync-2.0-LCcm4ddRe2z4CES4wun76Z" 'False) (C1 ('MetaCons "StartTaskExecution'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "excludes") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [FilterRule])) :: S1 ('MetaSel ('Just "includes") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [FilterRule]))) :: (S1 ('MetaSel ('Just "overrideOptions") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Options)) :: (S1 ('MetaSel ('Just "tags") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [TagListEntry])) :: S1 ('MetaSel ('Just "taskArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)))))

newStartTaskExecution Source #

Arguments

:: Text	`StartTaskExecution`
-> StartTaskExecution

Create a value of StartTaskExecution 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:excludes:StartTaskExecution', startTaskExecution_excludes - Specifies a list of filter rules that determines which files to exclude from a task. The list contains a single filter string that consists of the patterns to exclude. The patterns are delimited by "|" (that is, a pipe), for example, "/folder1|/folder2".

$sel:includes:StartTaskExecution', startTaskExecution_includes - Specifies a list of filter rules that determines which files to include when running a task. The pattern should contain a single filter string that consists of the patterns to include. The patterns are delimited by "|" (that is, a pipe), for example, "/folder1|/folder2".

$sel:overrideOptions:StartTaskExecution', startTaskExecution_overrideOptions - Undocumented member.

$sel:tags:StartTaskExecution', startTaskExecution_tags - Specifies the tags that you want to apply to the Amazon Resource Name (ARN) representing the task execution.

Tags are key-value pairs that help you manage, filter, and search for your DataSync resources.

StartTaskExecution, startTaskExecution_taskArn - Specifies the Amazon Resource Name (ARN) of the task that you want to start.

Request Lenses

startTaskExecution_excludes :: Lens' StartTaskExecution (Maybe [FilterRule]) Source #

Specifies a list of filter rules that determines which files to exclude from a task. The list contains a single filter string that consists of the patterns to exclude. The patterns are delimited by "|" (that is, a pipe), for example, "/folder1|/folder2".

startTaskExecution_includes :: Lens' StartTaskExecution (Maybe [FilterRule]) Source #

Specifies a list of filter rules that determines which files to include when running a task. The pattern should contain a single filter string that consists of the patterns to include. The patterns are delimited by "|" (that is, a pipe), for example, "/folder1|/folder2".

startTaskExecution_overrideOptions :: Lens' StartTaskExecution (Maybe Options) Source #

Undocumented member.

startTaskExecution_tags :: Lens' StartTaskExecution (Maybe [TagListEntry]) Source #

Specifies the tags that you want to apply to the Amazon Resource Name (ARN) representing the task execution.

Tags are key-value pairs that help you manage, filter, and search for your DataSync resources.

startTaskExecution_taskArn :: Lens' StartTaskExecution Text Source #

Specifies the Amazon Resource Name (ARN) of the task that you want to start.

Destructuring the Response

data StartTaskExecutionResponse Source #

StartTaskExecutionResponse

See: newStartTaskExecutionResponse smart constructor.

Constructors

StartTaskExecutionResponse'
Fields taskExecutionArn :: Maybe Text The ARN of the running task execution. httpStatus :: Int The response's http status code.

Instances

Instances details

Generic StartTaskExecutionResponse Source #
Instance details Defined in Amazonka.DataSync.StartTaskExecution Associated Types type Rep StartTaskExecutionResponse :: Type -> Type # Methods from :: StartTaskExecutionResponse -> Rep StartTaskExecutionResponse x # to :: Rep StartTaskExecutionResponse x -> StartTaskExecutionResponse #
Read StartTaskExecutionResponse Source #
Instance details Defined in Amazonka.DataSync.StartTaskExecution Methods readsPrec :: Int -> ReadS StartTaskExecutionResponse # readList :: ReadS [StartTaskExecutionResponse] # readPrec :: ReadPrec StartTaskExecutionResponse # readListPrec :: ReadPrec [StartTaskExecutionResponse] #
Show StartTaskExecutionResponse Source #
Instance details Defined in Amazonka.DataSync.StartTaskExecution Methods showsPrec :: Int -> StartTaskExecutionResponse -> ShowS # show :: StartTaskExecutionResponse -> String # showList :: [StartTaskExecutionResponse] -> ShowS #
NFData StartTaskExecutionResponse Source #
Instance details Defined in Amazonka.DataSync.StartTaskExecution Methods rnf :: StartTaskExecutionResponse -> () #
Eq StartTaskExecutionResponse Source #
Instance details Defined in Amazonka.DataSync.StartTaskExecution Methods (==) :: StartTaskExecutionResponse -> StartTaskExecutionResponse -> Bool # (/=) :: StartTaskExecutionResponse -> StartTaskExecutionResponse -> Bool #
type Rep StartTaskExecutionResponse Source #
Instance details Defined in Amazonka.DataSync.StartTaskExecution type Rep StartTaskExecutionResponse = D1 ('MetaData "StartTaskExecutionResponse" "Amazonka.DataSync.StartTaskExecution" "amazonka-datasync-2.0-LCcm4ddRe2z4CES4wun76Z" 'False) (C1 ('MetaCons "StartTaskExecutionResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "taskExecutionArn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newStartTaskExecutionResponse Source #

Arguments

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

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

StartTaskExecutionResponse, startTaskExecutionResponse_taskExecutionArn - The ARN of the running task execution.

$sel:httpStatus:StartTaskExecutionResponse', startTaskExecutionResponse_httpStatus - The response's http status code.

Response Lenses

startTaskExecutionResponse_taskExecutionArn :: Lens' StartTaskExecutionResponse (Maybe Text) Source #

The ARN of the running task execution.

startTaskExecutionResponse_httpStatus :: Lens' StartTaskExecutionResponse Int Source #

The response's http status code.