\TaskInstanceApi

All URIs are relative to http://localhost/api/v1

MethodHTTP requestDescription
GetExtraLinksGet /dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}/linksGet extra links for task instance
GetLogGet /dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}/logs/{task_try_number}Get logs for a task instance
GetTaskInstanceGet /dags/{dag_id}/dagRuns/{dag_run_id}/taskInstances/{task_id}Get a task instance
GetTaskInstancesGet /dags/{dag_id}/dagRuns/{dag_run_id}/taskInstancesGet a list of task instance of DAG
GetTaskInstancesBatchPost /dags//dagRuns//taskInstances/listGet list of task instances from all DAGs and DAG Runs.

GetExtraLinks

ExtraLinkCollection GetExtraLinks(ctx, dagId, dagRunId, taskId)

Get extra links for task instance

Required Parameters

NameTypeDescriptionNotes
ctxcontext.Contextcontext for authentication, logging, cancellation, deadlines, tracing, etc.
dagIdstringThe DAG ID.
dagRunIdstringThe DAG Run ID.
taskIdstringThe Task ID.

Return type

ExtraLinkCollection

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetLog

InlineResponse200 GetLog(ctx, dagId, dagRunId, taskId, taskTryNumber, optional)

Get logs for a task instance

Get logs for a specific task instance and its try number

Required Parameters

NameTypeDescriptionNotes
ctxcontext.Contextcontext for authentication, logging, cancellation, deadlines, tracing, etc.
dagIdstringThe DAG ID.
dagRunIdstringThe DAG Run ID.
taskIdstringThe Task ID.
taskTryNumberint32The Task Try Number.
optional*GetLogOptsoptional parametersnil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetLogOpts struct

NameTypeDescriptionNotes

fullContent | optional.Bool| A full content will be returned. By default, only the first fragment will be returned. | token | optional.String| A token that allows you to continue fetching logs. If passed, it will specify the location from which the download should be continued. |

Return type

InlineResponse200

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json, text/plain

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetTaskInstance

TaskInstance GetTaskInstance(ctx, dagId, dagRunId, taskId)

Get a task instance

Required Parameters

NameTypeDescriptionNotes
ctxcontext.Contextcontext for authentication, logging, cancellation, deadlines, tracing, etc.
dagIdstringThe DAG ID.
dagRunIdstringThe DAG Run ID.
taskIdstringThe Task ID.

Return type

TaskInstance

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetTaskInstances

TaskInstanceCollection GetTaskInstances(ctx, dagId, dagRunId, optional)

Get a list of task instance of DAG

This endpoint allows specifying ~ as the dag_id, dag_run_id to retrieve DAG Runs for all DAGs and DAG Runs.

Required Parameters

NameTypeDescriptionNotes
ctxcontext.Contextcontext for authentication, logging, cancellation, deadlines, tracing, etc.
dagIdstringThe DAG ID.
dagRunIdstringThe DAG Run ID.
optional*GetTaskInstancesOptsoptional parametersnil if no parameters

Optional Parameters

Optional parameters are passed through a pointer to a GetTaskInstancesOpts struct

NameTypeDescriptionNotes

executionDateGte | optional.Time| Returns objects greater or equal to the specified date. This can be combined with execution_date_lte parameter to receive only the selected period. | executionDateLte | optional.Time| Returns objects less than or equal to the specified date. This can be combined with execution_date_gte parameter to receive only the selected period. | startDateGte | optional.Time| Returns objects greater or equal the specified date. This can be combined with startd_ate_lte parameter to receive only the selected period. | startDateLte | optional.Time| Returns objects less or equal the specified date. This can be combined with start_date_gte parameter to receive only the selected period. | endDateGte | optional.Time| Returns objects greater or equal the specified date. This can be combined with start_date_lte parameter to receive only the selected period. | endDateLte | optional.Time| Returns objects less than or equal to the specified date. This can be combined with start_date_gte parameter to receive only the selected period. | durationGte | optional.Float32| Returns objects greater than or equal to the specified values. This can be combined with duration_lte parameter to receive only the selected period. | durationLte | optional.Float32| Returns objects less than or equal to the specified values. This can be combined with duration_gte parameter to receive only the selected range. | state | optional.Interface of []string| The value can be repeated to retrieve multiple matching values (OR condition). | pool | optional.Interface of []string| The value can be repeated to retrieve multiple matching values (OR condition). | queue | optional.Interface of []string| The value can be repeated to retrieve multiple matching values (OR condition). | limit | optional.Int32| The numbers of items to return. | [default to 100] offset | optional.Int32| The number of items to skip before starting to collect the result set. |

Return type

TaskInstanceCollection

Authorization

No authorization required

HTTP request headers

  • Content-Type: Not defined
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]

GetTaskInstancesBatch

TaskInstanceCollection GetTaskInstancesBatch(ctx, listTaskInstanceForm)

Get list of task instances from all DAGs and DAG Runs.

This endpoint is a POST to allow filtering across a large number of DAG IDs, where as a GET it would run in to maximum HTTP request URL length limits.

Required Parameters

NameTypeDescriptionNotes
ctxcontext.Contextcontext for authentication, logging, cancellation, deadlines, tracing, etc.
listTaskInstanceFormListTaskInstanceForm

Return type

TaskInstanceCollection

Authorization

No authorization required

HTTP request headers

  • Content-Type: application/json
  • Accept: application/json

[Back to top] [Back to API list] [Back to Model list] [Back to README]