report_task_runner_heartbeat

DataPipeline.Client.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