report_task_runner_heartbeat

report_task_runner_heartbeat(**kwargs)

Task runners call ReportTaskRunnerHeartbeat every 15 minutes to indicate that they are operational. If the AWS Data Pipeline Task Runner is launched on a resource managed by AWS Data Pipeline, the web service can use this call to detect when the task runner application has failed and restart a new instance.

See also: AWS API Documentation

Request Syntax

response = client.report_task_runner_heartbeat(
    taskrunnerId='string',
    workerGroup='string',
    hostname='string'
)
Parameters
  • taskrunnerId (string) --

    [REQUIRED]

    The ID of the task runner. This value should be unique across your AWS account. In the case of AWS Data Pipeline Task Runner launched on a resource managed by AWS Data Pipeline, the web service provides a unique identifier when it launches the application. If you have written a custom task runner, you should assign a unique identifier for the task runner.

  • workerGroup (string) -- The type of task the task runner is configured to accept and process. The worker group is set as a field on objects in the pipeline when they are created. You can only specify a single value for workerGroup . There are no wildcard values permitted in workerGroup ; the string must be an exact, case-sensitive, match.
  • hostname (string) -- The public DNS name of the task runner.
Return type

dict

Returns

Response Syntax

{
    'terminate': True|False
}

Response Structure

  • (dict) --

    Contains the output of ReportTaskRunnerHeartbeat.

    • terminate (boolean) --

      Indicates whether the calling task runner should terminate.

Exceptions

  • DataPipeline.Client.exceptions.InternalServiceError
  • DataPipeline.Client.exceptions.InvalidRequestException