Skip to content

describe_task_execution async

describe_task_execution(
    task_execution_arn: TaskExecutionArn,
    *,
    config_overrides: Optional[AsyncDataSyncClientConfig] = None,
) -> DescribeTaskExecutionResponse

Provides information about an execution of your DataSync task. You can use this operation to help monitor the progress of an ongoing data transfer or check the results of the transfer.

Some DescribeTaskExecution response elements are only relevant to a specific task mode. For information, see Understanding task mode differences and Understanding data transfer performance counters.

Parameters:

  • task_execution_arn (TaskExecutionArn) –

    Specifies the Amazon Resource Name (ARN) of the task execution that you want information about.

Raises:

Source code in docs_src/capo_datasync/_services/async_data_sync.py
async def describe_task_execution(
    self,
    task_execution_arn: "capo_datasync.types.task_execution_arn.TaskExecutionArn",
    *,
    config_overrides: Optional[AsyncDataSyncClientConfig] = None,
) -> "capo_datasync.types.describe_task_execution_response.DescribeTaskExecutionResponse":
    """<p>Provides information about an execution of your DataSync task. You can use this operation to help monitor the progress of an ongoing data transfer or check the results of the transfer.</p> <note> <p>Some <code>DescribeTaskExecution</code> response elements are only relevant to a specific task mode. For information, see <a href="https://docs.aws.amazon.com/datasync/latest/userguide/choosing-task-mode.html#task-mode-differences">Understanding task mode differences</a> and <a href="https://docs.aws.amazon.com/datasync/latest/userguide/transfer-performance-counters.html">Understanding data transfer performance counters</a>.</p> </note>

    Args:
        task_execution_arn: <p>Specifies the Amazon Resource Name (ARN) of the task execution that you want information about.</p>

    Raises:
        capo_datasync.errors.internal_exception.InternalException: <p>This exception is thrown when an error occurs in the DataSync service.</p>
        capo_datasync.errors.invalid_request_exception.InvalidRequestException: <p>This exception is thrown when the client submits a malformed request.</p>
        capo_datasync.errors.UnknownServiceError: The service returned an error code this client does not model.
    """

    async def _handler(
        req: "AsyncOperationRequest[capo_datasync.types.describe_task_execution_request.DescribeTaskExecutionRequest]",
    ) -> AsyncOperationResponse[
        "capo_datasync.types.describe_task_execution_response.DescribeTaskExecutionResponse"
    ]:
        import capo_datasync._operations.fmrs_service.describe_task_execution

        (
            output,
            http_response,
        ) = await capo_datasync._operations.fmrs_service.describe_task_execution.async_describe_task_execution(
            req.options, req.input
        )
        return AsyncOperationResponse(output=output, response=http_response)

    interceptors_, options_ = self.operation_options(
        config_overrides, OperationLogging("DescribeTaskExecution")
    )
    input_: capo_datasync.types.describe_task_execution_request.DescribeTaskExecutionRequest = {
        "task_execution_arn": task_execution_arn
    }

    response = await aexecute_pipeline(
        AsyncOperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    await response.response.aclose()
    return response.output