UPDATETASKEXECUTION()`¶

About UpdateTaskExecution¶

Updates the configuration of a running DataSync task execution.

Currently, the only Option that you can modify with UpdateTaskExecution is BytesPerSecond, which throttles bandwidth for a running or queued task execution.

Method Signature¶

METHODS /AWS1/IF_DSY~UPDATETASKEXECUTION
  IMPORTING
    !IV_TASKEXECUTIONARN TYPE /AWS1/DSYTASKEXECUTIONARN OPTIONAL
    !IO_OPTIONS TYPE REF TO /AWS1/CL_DSYOPTIONS OPTIONAL
  RETURNING
    VALUE(OO_OUTPUT) TYPE REF TO /aws1/cl_dsyupdatetaskexecrsp
  RAISING
    /AWS1/CX_DSYINTERNALEXCEPTION
    /AWS1/CX_DSYINVALIDREQUESTEX
    /AWS1/CX_DSYCLIENTEXC
    /AWS1/CX_DSYSERVEREXC
    /AWS1/CX_RT_TECHNICAL_GENERIC
    /AWS1/CX_RT_SERVICE_GENERIC.

IMPORTING¶

Required arguments:¶

`iv_taskexecutionarn` `TYPE /AWS1/DSYTASKEXECUTIONARN` `/AWS1/DSYTASKEXECUTIONARN`¶

Specifies the Amazon Resource Name (ARN) of the task execution that you're updating.

`io_options` `TYPE REF TO /AWS1/CL_DSYOPTIONS` `/AWS1/CL_DSYOPTIONS`¶

Indicates how your transfer task is configured. These options include how DataSync handles files, objects, and their associated metadata during your transfer. You also can specify how to verify data integrity, set bandwidth limits for your task, among other options.

Each option has a default value. Unless you need to, you don't have to configure any option before calling StartTaskExecution.

You also can override your task options for each task execution. For example, you might want to adjust the LogLevel for an individual execution.

RETURNING¶

`oo_output` `TYPE REF TO /aws1/cl_dsyupdatetaskexecrsp` `/AWS1/CL_DSYUPDATETASKEXECRSP`¶

Examples¶

Syntax Example¶

This is an example of the syntax for calling the method. It includes every possible argument and initializes every possible value. The data provided is not necessarily semantically accurate (for example the value "string" may be provided for something that is intended to be an instance ID, or in some cases two arguments may be mutually exclusive). The syntax shows the ABAP syntax for creating the various data structures.

DATA(lo_result) = lo_client->updatetaskexecution(
  io_options = new /aws1/cl_dsyoptions(
    iv_atime = |string|
    iv_bytespersecond = 123
    iv_gid = |string|
    iv_loglevel = |string|
    iv_mtime = |string|
    iv_objecttags = |string|
    iv_overwritemode = |string|
    iv_posixpermissions = |string|
    iv_preservedeletedfiles = |string|
    iv_preservedevices = |string|
    iv_secdescriptorcopyflags = |string|
    iv_taskqueueing = |string|
    iv_transfermode = |string|
    iv_uid = |string|
    iv_verifymode = |string|
  )
  iv_taskexecutionarn = |string|
).

This is an example of reading all possible response values

lo_result = lo_result.
IF lo_result IS NOT INITIAL.
ENDIF.

/AWS1/IF_DSY=>UPDATETASKEXECUTION()¶