openapi: 3.0.1 info: title: Flink JobManager REST Cluster Jobs API contact: email: user@flink.apache.org license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0.html version: v1/2.0-SNAPSHOT tags: - name: Jobs paths: /jobs: get: description: Returns an overview over all jobs and their current state. operationId: getJobIdsWithStatusesOverview responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/JobIdsWithStatusOverview' summary: Apache Flink List Jobs tags: - Jobs /jobs/metrics: get: description: Provides access to aggregated job metrics. operationId: getAggregatedJobMetrics parameters: - name: get in: query description: Comma-separated list of string values to select specific metrics. required: false style: form schema: type: string - name: agg in: query description: 'Comma-separated list of aggregation modes which should be calculated. Available aggregations are: "min, max, sum, avg, skew".' required: false style: form schema: $ref: '#/components/schemas/AggregationMode' - name: jobs in: query description: Comma-separated list of 32-character hexadecimal strings to select specific jobs. required: false style: form schema: $ref: '#/components/schemas/JobID' responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/AggregatedMetricsResponseBody' summary: Apache Flink List Jobs Metrics tags: - Jobs /jobs/overview: get: description: Returns an overview over all jobs. operationId: getJobsOverview responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/MultipleJobsDetails' summary: Apache Flink List Jobs Overview tags: - Jobs /jobs/{jobid}: get: description: Returns details of a job. operationId: getJobDetails parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/JobDetailsInfo' summary: Apache Flink Get Jobs tags: - Jobs patch: description: Terminates a job. operationId: cancelJob parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' - name: mode in: query description: 'String value that specifies the termination mode. The only supported value is: "cancel".' required: false style: form schema: $ref: '#/components/schemas/TerminationMode' responses: '202': description: The request was successful. summary: Apache Flink Update Jobs tags: - Jobs /jobs/{jobid}/accumulators: get: description: Returns the accumulators for all tasks of a job, aggregated across the respective subtasks. operationId: getJobAccumulators parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' - name: includeSerializedValue in: query description: Boolean value that specifies whether serialized user task accumulators should be included in the response. required: false style: form schema: type: boolean responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/JobAccumulatorsInfo' summary: Apache Flink List Jobs Accumulators tags: - Jobs /jobs/{jobid}/checkpoints: get: description: Returns checkpointing statistics for a job. operationId: getCheckpointingStatistics parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/CheckpointingStatistics' summary: Apache Flink List Jobs Checkpoints tags: - Jobs post: description: Triggers a checkpoint. The 'checkpointType' parameter does not support 'INCREMENTAL' option for now. See FLINK-33723. This async operation would return a 'triggerid' for further query identifier. operationId: triggerCheckpoint parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' requestBody: content: application/json: schema: $ref: '#/components/schemas/CheckpointTriggerRequestBody' responses: '202': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/TriggerResponse' summary: Apache Flink Create Jobs Checkpoints tags: - Jobs /jobs/{jobid}/checkpoints/config: get: description: Returns the checkpointing configuration. operationId: getCheckpointConfig parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/CheckpointConfigInfo' summary: Apache Flink List Checkpoints Config tags: - Jobs /jobs/{jobid}/checkpoints/details/{checkpointid}: get: description: Returns details for a checkpoint. operationId: getCheckpointStatisticDetails parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' - name: checkpointid in: path description: Long value that identifies a checkpoint. required: true schema: type: integer format: int64 responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/CheckpointStatistics' summary: Apache Flink Get Checkpoints Details tags: - Jobs /jobs/{jobid}/checkpoints/details/{checkpointid}/subtasks/{vertexid}: get: description: Returns checkpoint statistics for a task and its subtasks. operationId: getTaskCheckpointStatistics parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' - name: checkpointid in: path description: Long value that identifies a checkpoint. required: true schema: type: integer format: int64 - name: vertexid in: path description: 32-character hexadecimal string value that identifies a job vertex. required: true schema: $ref: '#/components/schemas/JobVertexID' responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/TaskCheckpointStatisticsWithSubtaskDetails' summary: Apache Flink Get Details Subtasks tags: - Jobs /jobs/{jobid}/checkpoints/{triggerid}: get: description: Returns the status of a checkpoint trigger operation. operationId: getCheckpointStatus parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' - name: triggerid in: path description: 32-character hexadecimal string that identifies an asynchronous operation trigger ID. The ID was returned then the operation was triggered. required: true schema: $ref: '#/components/schemas/TriggerId' responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/AsynchronousOperationResult' summary: Apache Flink Get Jobs Checkpoints tags: - Jobs /jobs/{jobid}/clientHeartbeat: patch: description: Report the jobClient's aliveness. operationId: triggerHeartbeat parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' requestBody: content: application/json: schema: $ref: '#/components/schemas/JobClientHeartbeatRequestBody' responses: '202': description: The request was successful. summary: Apache Flink Update Jobs Clientheartbeat tags: - Jobs /jobs/{jobid}/config: get: description: Returns the configuration of a job. operationId: getJobConfig parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/JobConfigInfo' summary: Apache Flink List Jobs Config tags: - Jobs /jobs/{jobid}/exceptions: get: description: 'Returns the most recent exceptions that have been handled by Flink for this job. The ''exceptionHistory.truncated'' flag defines whether exceptions were filtered out through the GET parameter. The backend collects only a specific amount of most recent exceptions per job. This can be configured through web.exception-history-size in the Flink configuration. The following first-level members are deprecated: ''root-exception'', ''timestamp'', ''all-exceptions'', and ''truncated''. Use the data provided through ''exceptionHistory'', instead.' operationId: getJobExceptions parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' - name: maxExceptions in: query description: Comma-separated list of integer values that specifies the upper limit of exceptions to return. required: false style: form schema: type: integer format: int32 - name: failureLabelFilter in: query description: Collection of string values working as a filter in the form of `key:value` pairs allowing only exceptions with ALL of the specified failure labels to be returned. required: false style: form schema: $ref: '#/components/schemas/FailureLabel' responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/JobExceptionsInfoWithHistory' summary: Apache Flink List Jobs Exceptions tags: - Jobs /jobs/{jobid}/execution-result: get: description: Returns the result of a job execution. Gives access to the execution time of the job and to all accumulators created by this job. operationId: getJobExecutionResult parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/JobExecutionResultResponseBody' summary: Apache Flink List Jobs Execution-Result tags: - Jobs /jobs/{jobid}/jobmanager/config: get: description: Returns the jobmanager's configuration of a specific job. operationId: getJobManagerJobConfiguration parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' responses: '200': description: The request was successful. content: application/json: schema: type: array items: $ref: '#/components/schemas/ConfigurationInfoEntry' summary: Apache Flink List Jobmanager Config tags: - Jobs /jobs/{jobid}/jobmanager/environment: get: description: Returns the jobmanager's environment of a specific job. operationId: getJobManagerJobEnvironment parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/EnvironmentInfo' summary: Apache Flink List Jobmanager Environment tags: - Jobs /jobs/{jobid}/jobmanager/log-url: get: description: Returns the log url of jobmanager of a specific job. operationId: getJobManagerLogUrl parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/LogUrlResponse' summary: Apache Flink List Jobmanager Log-Url tags: - Jobs /jobs/{jobid}/metrics: get: description: Provides access to job metrics. operationId: getJobMetrics parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' - name: get in: query description: Comma-separated list of string values to select specific metrics. required: false style: form schema: type: string responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/MetricCollectionResponseBody' summary: Apache Flink List Jobs Metrics tags: - Jobs /jobs/{jobid}/plan: get: description: Returns the dataflow plan of a job. operationId: getJobPlan parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/JobPlanInfo' summary: Apache Flink List Jobs Plan tags: - Jobs /jobs/{jobid}/rescaling: patch: description: Triggers the rescaling of a job. This async operation would return a 'triggerid' for further query identifier. operationId: rescaleJob parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' - name: parallelism in: query description: Positive integer value that specifies the desired parallelism. required: true style: form schema: type: integer format: int32 responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/TriggerResponse' summary: Apache Flink Update Jobs Rescaling tags: - Jobs /jobs/{jobid}/rescaling/{triggerid}: get: description: Returns the status of a rescaling operation. operationId: getRescalingStatus parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' - name: triggerid in: path description: 32-character hexadecimal string that identifies an asynchronous operation trigger ID. The ID was returned then the operation was triggered. required: true schema: $ref: '#/components/schemas/TriggerId' responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/AsynchronousOperationResult' summary: Apache Flink Get Jobs Rescaling tags: - Jobs /jobs/{jobid}/resource-requirements: get: description: Request details on the job's resource requirements. operationId: getJobResourceRequirements parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/JobResourceRequirementsBody' summary: Apache Flink List Jobs Resource-Requirements tags: - Jobs put: description: Request to update job's resource requirements. operationId: updateJobResourceRequirements parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' requestBody: content: application/json: schema: $ref: '#/components/schemas/JobResourceRequirementsBody' responses: '200': description: The request was successful. summary: Apache Flink Update Jobs Resource-Requirements tags: - Jobs /jobs/{jobid}/savepoints: post: description: Triggers a savepoint, and optionally cancels the job afterwards. This async operation would return a 'triggerid' for further query identifier. operationId: triggerSavepoint parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' requestBody: content: application/json: schema: $ref: '#/components/schemas/SavepointTriggerRequestBody' responses: '202': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/TriggerResponse' summary: Apache Flink Create Jobs Savepoints tags: - Jobs /jobs/{jobid}/savepoints/{triggerid}: get: description: Returns the status of a savepoint operation. operationId: getSavepointStatus parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' - name: triggerid in: path description: 32-character hexadecimal string that identifies an asynchronous operation trigger ID. The ID was returned then the operation was triggered. required: true schema: $ref: '#/components/schemas/TriggerId' responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/AsynchronousOperationResult' summary: Apache Flink Get Jobs Savepoints tags: - Jobs /jobs/{jobid}/status: get: description: Returns the current status of a job execution. operationId: getJobStatusInfo parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/JobStatusInfo' summary: Apache Flink List Jobs Status tags: - Jobs /jobs/{jobid}/stop: post: description: Stops a job with a savepoint. Optionally, it can also emit a MAX_WATERMARK before taking the savepoint to flush out any state waiting for timers to fire. This async operation would return a 'triggerid' for further query identifier. operationId: triggerStopWithSavepoint parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' requestBody: content: application/json: schema: $ref: '#/components/schemas/StopWithSavepointRequestBody' responses: '202': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/TriggerResponse' summary: Apache Flink Create Jobs Stop tags: - Jobs /jobs/{jobid}/taskmanagers/{taskmanagerid}/log-url: get: description: Returns the log url of jobmanager of a specific job. operationId: getTaskManagerLogUrl parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' - name: taskmanagerid in: path description: 32-character hexadecimal string that identifies a task manager. required: true schema: $ref: '#/components/schemas/ResourceID' responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/LogUrlResponse' summary: Apache Flink List Taskmanagers Log-Url tags: - Jobs /jobs/{jobid}/vertices/{vertexid}: get: description: Returns details for a task, with a summary for each of its subtasks. operationId: getJobVertexDetails parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' - name: vertexid in: path description: 32-character hexadecimal string value that identifies a job vertex. required: true schema: $ref: '#/components/schemas/JobVertexID' responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/JobVertexDetailsInfo' summary: Apache Flink Get Jobs Vertices tags: - Jobs /jobs/{jobid}/vertices/{vertexid}/accumulators: get: description: Returns user-defined accumulators of a task, aggregated across all subtasks. operationId: getJobVertexAccumulators parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' - name: vertexid in: path description: 32-character hexadecimal string value that identifies a job vertex. required: true schema: $ref: '#/components/schemas/JobVertexID' responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/JobVertexAccumulatorsInfo' summary: Apache Flink List Vertices Accumulators tags: - Jobs /jobs/{jobid}/vertices/{vertexid}/backpressure: get: description: Returns back-pressure information for a job, and may initiate back-pressure sampling if necessary. operationId: getJobVertexBackPressure parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' - name: vertexid in: path description: 32-character hexadecimal string value that identifies a job vertex. required: true schema: $ref: '#/components/schemas/JobVertexID' responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/JobVertexBackPressureInfo' summary: Apache Flink List Vertices Backpressure tags: - Jobs /jobs/{jobid}/vertices/{vertexid}/flamegraph: get: description: Returns flame graph information for a vertex, and may initiate flame graph sampling if necessary. operationId: getJobVertexFlameGraph parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' - name: vertexid in: path description: 32-character hexadecimal string value that identifies a job vertex. required: true schema: $ref: '#/components/schemas/JobVertexID' - name: type in: query description: 'String value that specifies the Flame Graph type. Supported options are: "[FULL, ON_CPU, OFF_CPU]".' required: false style: form schema: $ref: '#/components/schemas/ThreadStates' - name: subtaskindex in: query description: Positive integer value that identifies a subtask. required: false style: form schema: type: integer format: int32 responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/VertexFlameGraph' summary: Apache Flink List Vertices Flamegraph tags: - Jobs /jobs/{jobid}/vertices/{vertexid}/jm-operator-metrics: get: description: Provides access to jobmanager operator metrics. This is an operator that executes on the jobmanager and the coordinator for FLIP 27 sources is one example of such an operator. operationId: getJobManagerOperatorMetrics parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' - name: vertexid in: path description: 32-character hexadecimal string value that identifies a job vertex. required: true schema: $ref: '#/components/schemas/JobVertexID' - name: get in: query description: Comma-separated list of string values to select specific metrics. required: false style: form schema: type: string responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/MetricCollectionResponseBody' summary: Apache Flink List Vertices Jm-Operator-Metrics tags: - Jobs /jobs/{jobid}/vertices/{vertexid}/metrics: get: description: Provides access to task metrics. operationId: getJobVertexMetrics parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' - name: vertexid in: path description: 32-character hexadecimal string value that identifies a job vertex. required: true schema: $ref: '#/components/schemas/JobVertexID' - name: get in: query description: Comma-separated list of string values to select specific metrics. required: false style: form schema: type: string responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/MetricCollectionResponseBody' summary: Apache Flink List Vertices Metrics tags: - Jobs /jobs/{jobid}/vertices/{vertexid}/subtasks/accumulators: get: description: Returns all user-defined accumulators for all subtasks of a task. operationId: getSubtasksAllAccumulators parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' - name: vertexid in: path description: 32-character hexadecimal string value that identifies a job vertex. required: true schema: $ref: '#/components/schemas/JobVertexID' responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/SubtasksAllAccumulatorsInfo' summary: Apache Flink List Subtasks Accumulators tags: - Jobs /jobs/{jobid}/vertices/{vertexid}/subtasks/metrics: get: description: Provides access to aggregated subtask metrics. operationId: getAggregatedSubtaskMetrics parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' - name: vertexid in: path description: 32-character hexadecimal string value that identifies a job vertex. required: true schema: $ref: '#/components/schemas/JobVertexID' - name: get in: query description: Comma-separated list of string values to select specific metrics. required: false style: form schema: type: string - name: agg in: query description: 'Comma-separated list of aggregation modes which should be calculated. Available aggregations are: "min, max, sum, avg, skew".' required: false style: form schema: $ref: '#/components/schemas/AggregationMode' - name: subtasks in: query description: Comma-separated list of integer ranges (e.g. "1,3,5-9") to select specific subtasks. required: false style: form schema: type: string responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/AggregatedMetricsResponseBody' summary: Apache Flink List Subtasks Metrics tags: - Jobs /jobs/{jobid}/vertices/{vertexid}/subtasks/{subtaskindex}: get: description: Returns details of the current or latest execution attempt of a subtask. operationId: getSubtaskCurrentAttemptDetails parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' - name: vertexid in: path description: 32-character hexadecimal string value that identifies a job vertex. required: true schema: $ref: '#/components/schemas/JobVertexID' - name: subtaskindex in: path description: Positive integer value that identifies a subtask. required: true schema: type: integer format: int32 responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/SubtaskExecutionAttemptDetailsInfo' summary: Apache Flink Get Vertices Subtasks tags: - Jobs /jobs/{jobid}/vertices/{vertexid}/subtasks/{subtaskindex}/attempts/{attempt}: get: description: Returns details of an execution attempt of a subtask. Multiple execution attempts happen in case of failure/recovery. operationId: getSubtaskExecutionAttemptDetails parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' - name: vertexid in: path description: 32-character hexadecimal string value that identifies a job vertex. required: true schema: $ref: '#/components/schemas/JobVertexID' - name: subtaskindex in: path description: Positive integer value that identifies a subtask. required: true schema: type: integer format: int32 - name: attempt in: path description: Positive integer value that identifies an execution attempt. required: true schema: type: integer format: int32 responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/SubtaskExecutionAttemptDetailsInfo' summary: Apache Flink Get Subtasks Attempts tags: - Jobs /jobs/{jobid}/vertices/{vertexid}/subtasks/{subtaskindex}/attempts/{attempt}/accumulators: get: description: Returns the accumulators of an execution attempt of a subtask. Multiple execution attempts happen in case of failure/recovery. operationId: getSubtaskExecutionAttemptAccumulators parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' - name: vertexid in: path description: 32-character hexadecimal string value that identifies a job vertex. required: true schema: $ref: '#/components/schemas/JobVertexID' - name: subtaskindex in: path description: Positive integer value that identifies a subtask. required: true schema: type: integer format: int32 - name: attempt in: path description: Positive integer value that identifies an execution attempt. required: true schema: type: integer format: int32 responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/SubtaskExecutionAttemptAccumulatorsInfo' summary: Apache Flink List Attempts Accumulators tags: - Jobs /jobs/{jobid}/vertices/{vertexid}/subtasks/{subtaskindex}/metrics: get: description: Provides access to subtask metrics. operationId: getSubtaskMetrics parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' - name: vertexid in: path description: 32-character hexadecimal string value that identifies a job vertex. required: true schema: $ref: '#/components/schemas/JobVertexID' - name: subtaskindex in: path description: Positive integer value that identifies a subtask. required: true schema: type: integer format: int32 - name: get in: query description: Comma-separated list of string values to select specific metrics. required: false style: form schema: type: string responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/MetricCollectionResponseBody' summary: Apache Flink List Subtasks Metrics tags: - Jobs /jobs/{jobid}/vertices/{vertexid}/subtasktimes: get: description: Returns time-related information for all subtasks of a task. operationId: getSubtasksTimes parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' - name: vertexid in: path description: 32-character hexadecimal string value that identifies a job vertex. required: true schema: $ref: '#/components/schemas/JobVertexID' responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/SubtasksTimesInfo' summary: Apache Flink List Vertices Subtasktimes tags: - Jobs /jobs/{jobid}/vertices/{vertexid}/taskmanagers: get: description: Returns task information aggregated by task manager. operationId: getJobVertexTaskManagers parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' - name: vertexid in: path description: 32-character hexadecimal string value that identifies a job vertex. required: true schema: $ref: '#/components/schemas/JobVertexID' responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/JobVertexTaskManagersInfo' summary: Apache Flink List Vertices Taskmanagers tags: - Jobs /jobs/{jobid}/vertices/{vertexid}/watermarks: get: description: Returns the watermarks for all subtasks of a task. operationId: getJobVertexWatermarks parameters: - name: jobid in: path description: 32-character hexadecimal string value that identifies a job. required: true schema: $ref: '#/components/schemas/JobID' - name: vertexid in: path description: 32-character hexadecimal string value that identifies a job vertex. required: true schema: $ref: '#/components/schemas/JobVertexID' responses: '200': description: The request was successful. content: application/json: schema: $ref: '#/components/schemas/MetricCollectionResponseBody' summary: Apache Flink List Vertices Watermarks tags: - Jobs components: schemas: VertexBackPressureLevel: type: string enum: - ok - low - high SerializedValueOptionalFailureObject: type: object properties: byteArray: type: array items: type: string format: byte SubtasksTimesInfo: type: object properties: id: type: string name: type: string now: type: integer format: int64 subtasks: type: array items: $ref: '#/components/schemas/SubtaskTimeInfo' SubtaskAccumulatorsInfo: type: object properties: attempt: type: integer format: int32 endpoint: type: string subtask: type: integer format: int32 user-accumulators: type: array items: $ref: '#/components/schemas/UserAccumulator' JobStatus: type: string enum: - INITIALIZING - CREATED - RUNNING - FAILING - FAILED - CANCELLING - CANCELED - FINISHED - RESTARTING - SUSPENDED - RECONCILING SubtaskTimeInfo: type: object properties: duration: type: integer format: int64 endpoint: type: string subtask: type: integer format: int32 timestamps: type: object additionalProperties: type: integer format: int64 Counts: type: object properties: completed: type: integer format: int64 failed: type: integer format: int64 in_progress: type: integer format: int32 restored: type: integer format: int64 total: type: integer format: int64 JobIdWithStatus: type: object properties: id: $ref: '#/components/schemas/JobID' status: $ref: '#/components/schemas/JobStatus' CheckpointStatisticsSummary: type: object properties: alignment_buffered: $ref: '#/components/schemas/StatsSummaryDto' checkpointed_size: $ref: '#/components/schemas/StatsSummaryDto' end_to_end_duration: $ref: '#/components/schemas/StatsSummaryDto' persisted_data: $ref: '#/components/schemas/StatsSummaryDto' processed_data: $ref: '#/components/schemas/StatsSummaryDto' state_size: $ref: '#/components/schemas/StatsSummaryDto' LatestCheckpoints: type: object properties: completed: $ref: '#/components/schemas/CompletedCheckpointStatistics' failed: $ref: '#/components/schemas/FailedCheckpointStatistics' restored: $ref: '#/components/schemas/RestoredCheckpointStatistics' savepoint: $ref: '#/components/schemas/CompletedCheckpointStatistics' ResourceID: pattern: '[0-9a-f]{32}' type: string ProcessingMode: type: string enum: - AT_LEAST_ONCE - EXACTLY_ONCE QueueStatus: required: - id type: object properties: id: $ref: '#/components/schemas/Id' AggregatedMetricsResponseBody: type: object CompletedCheckpointStatistics: type: object allOf: - $ref: '#/components/schemas/CheckpointStatistics' - type: object properties: external_path: type: string discarded: type: boolean CheckpointInfo: type: object properties: checkpointId: type: integer format: int64 failureCause: $ref: '#/components/schemas/SerializedThrowable' RestAPICheckpointType: type: string enum: - CHECKPOINT - UNALIGNED_CHECKPOINT - SAVEPOINT - SYNC_SAVEPOINT TriggerId: pattern: '[0-9a-f]{32}' type: string AsynchronousOperationResult: type: object properties: operation: oneOf: - $ref: '#/components/schemas/AsynchronousOperationInfo' - $ref: '#/components/schemas/CheckpointInfo' - $ref: '#/components/schemas/SavepointInfo' status: $ref: '#/components/schemas/QueueStatus' JobVertexDetailsInfo: type: object properties: aggregated: $ref: '#/components/schemas/AggregatedTaskDetailsInfo' id: $ref: '#/components/schemas/JobVertexID' maxParallelism: type: integer format: int32 name: type: string now: type: integer format: int64 parallelism: type: integer format: int32 subtasks: type: array items: $ref: '#/components/schemas/SubtaskExecutionAttemptDetailsInfo' TaskCheckpointStatisticsWithSubtaskDetailsSummary: type: object properties: alignment: $ref: '#/components/schemas/CheckpointAlignmentSummary' checkpoint_duration: $ref: '#/components/schemas/CheckpointDurationSummary' checkpointed_size: $ref: '#/components/schemas/StatsSummaryDto' end_to_end_duration: $ref: '#/components/schemas/StatsSummaryDto' start_delay: $ref: '#/components/schemas/StatsSummaryDto' state_size: $ref: '#/components/schemas/StatsSummaryDto' SubtaskExecutionAttemptDetailsInfo: type: object properties: attempt: type: integer format: int32 duration: type: integer format: int64 end-time: type: integer format: int64 endpoint: type: string metrics: $ref: '#/components/schemas/IOMetricsInfo' other-concurrent-attempts: type: array items: $ref: '#/components/schemas/SubtaskExecutionAttemptDetailsInfo' start-time: type: integer format: int64 status: $ref: '#/components/schemas/ExecutionState' status-duration: type: object additionalProperties: type: integer format: int64 subtask: type: integer format: int32 taskmanager-id: type: string SubtasksAllAccumulatorsInfo: type: object properties: id: $ref: '#/components/schemas/JobVertexID' parallelism: type: integer format: int32 subtasks: type: array items: $ref: '#/components/schemas/SubtaskAccumulatorsInfo' JobDetails: type: object properties: duration: type: integer format: int64 end-time: type: integer format: int64 jid: $ref: '#/components/schemas/JobID' last-modification: type: integer format: int64 name: type: string pending-operators: type: integer format: int32 start-time: type: integer format: int64 state: $ref: '#/components/schemas/JobStatus' tasks: type: object additionalProperties: type: integer format: int32 JobExceptionHistory: type: object properties: entries: type: array items: $ref: '#/components/schemas/RootExceptionInfo' truncated: type: boolean JobExceptionsInfoWithHistory: type: object properties: exceptionHistory: $ref: '#/components/schemas/JobExceptionHistory' LogUrlResponse: type: object properties: url: type: string JobResourceRequirementsBody: type: object additionalProperties: $ref: '#/components/schemas/JobVertexResourceRequirements' JobResult: type: object properties: accumulatorResults: type: object additionalProperties: $ref: '#/components/schemas/SerializedValueOptionalFailureObject' applicationStatus: $ref: '#/components/schemas/ApplicationStatus' jobId: $ref: '#/components/schemas/JobID' netRuntime: type: integer format: int64 serializedThrowable: $ref: '#/components/schemas/SerializedThrowable' success: type: boolean SavepointTriggerRequestBody: type: object properties: cancel-job: type: boolean formatType: $ref: '#/components/schemas/SavepointFormatType' target-directory: type: string triggerId: $ref: '#/components/schemas/TriggerId' CheckpointDurationSummary: type: object properties: async: $ref: '#/components/schemas/StatsSummaryDto' sync: $ref: '#/components/schemas/StatsSummaryDto' RootExceptionInfo: type: object properties: concurrentExceptions: type: array items: $ref: '#/components/schemas/ExceptionInfo' endpoint: type: string exceptionName: type: string failureLabels: type: object additionalProperties: type: string stacktrace: type: string taskManagerId: type: string taskName: type: string timestamp: type: integer format: int64 ExceptionInfo: type: object properties: endpoint: type: string exceptionName: type: string failureLabels: type: object additionalProperties: type: string stacktrace: type: string taskManagerId: type: string taskName: type: string timestamp: type: integer format: int64 JobDetailsVertexInfo: type: object properties: duration: type: integer format: int64 end-time: type: integer format: int64 id: $ref: '#/components/schemas/JobVertexID' maxParallelism: type: integer format: int32 metrics: $ref: '#/components/schemas/IOMetricsInfo' name: type: string parallelism: type: integer format: int32 slotSharingGroupId: $ref: '#/components/schemas/SlotSharingGroupId' start-time: type: integer format: int64 status: $ref: '#/components/schemas/ExecutionState' tasks: type: object additionalProperties: type: integer format: int32 CheckpointConfigInfo: type: object properties: aligned_checkpoint_timeout: type: integer format: int64 changelog_periodic_materialization_interval: type: integer format: int64 changelog_storage: type: string checkpoint_storage: type: string checkpoints_after_tasks_finish: type: boolean externalization: $ref: '#/components/schemas/ExternalizedCheckpointInfo' interval: type: integer format: int64 max_concurrent: type: integer format: int64 min_pause: type: integer format: int64 mode: $ref: '#/components/schemas/ProcessingMode' state_backend: type: string state_changelog_enabled: type: boolean timeout: type: integer format: int64 tolerable_failed_checkpoints: type: integer format: int32 unaligned_checkpoints: type: boolean EnvironmentInfo: type: object properties: classpath: type: array items: type: string jvm: $ref: '#/components/schemas/JVMInfo' AsynchronousOperationInfo: type: object properties: failure-cause: $ref: '#/components/schemas/SerializedThrowable' JobExecutionResultResponseBody: required: - status type: object properties: job-execution-result: $ref: '#/components/schemas/JobResult' status: $ref: '#/components/schemas/QueueStatus' MetricCollectionResponseBody: type: object properties: metrics: type: array items: $ref: '#/components/schemas/Metric' UserAccumulator: type: object properties: name: type: string type: type: string value: type: string ExecutionState: type: string enum: - CREATED - SCHEDULED - DEPLOYING - RUNNING - FINISHED - CANCELING - CANCELED - FAILED - RECONCILING - INITIALIZING ExternalizedCheckpointInfo: type: object properties: delete_on_cancellation: type: boolean enabled: type: boolean CheckpointStatsStatus: type: string enum: - IN_PROGRESS - COMPLETED - FAILED JobType: type: string enum: - BATCH - STREAMING JobDetailsInfo: type: object properties: duration: type: integer format: int64 end-time: type: integer format: int64 isStoppable: type: boolean jid: $ref: '#/components/schemas/JobID' job-type: $ref: '#/components/schemas/JobType' maxParallelism: type: integer format: int64 name: type: string now: type: integer format: int64 pending-operators: type: integer format: int32 plan: $ref: '#/components/schemas/RawJson' start-time: type: integer format: int64 state: $ref: '#/components/schemas/JobStatus' status-counts: type: object additionalProperties: type: integer format: int32 stream-graph: $ref: '#/components/schemas/RawJson' timestamps: type: object additionalProperties: type: integer format: int64 vertices: type: array items: $ref: '#/components/schemas/JobDetailsVertexInfo' TaskCheckpointStatistics: type: object properties: alignment_buffered: type: integer format: int64 checkpointed_size: type: integer format: int64 end_to_end_duration: type: integer format: int64 id: type: integer format: int64 latest_ack_timestamp: type: integer format: int64 num_acknowledged_subtasks: type: integer format: int32 num_subtasks: type: integer format: int32 persisted_data: type: integer format: int64 processed_data: type: integer format: int64 state_size: type: integer format: int64 status: $ref: '#/components/schemas/CheckpointStatsStatus' RestoredCheckpointStatistics: type: object properties: external_path: type: string id: type: integer format: int64 is_savepoint: type: boolean restore_timestamp: type: integer format: int64 JobPlanInfo: type: object properties: plan: $ref: '#/components/schemas/RawJson' JobVertexID: pattern: '[0-9a-f]{32}' type: string JobAccumulator: type: object JobVertexTaskManagerInfo: type: object properties: aggregated: $ref: '#/components/schemas/AggregatedTaskDetailsInfo' duration: type: integer format: int64 end-time: type: integer format: int64 endpoint: type: string metrics: $ref: '#/components/schemas/IOMetricsInfo' start-time: type: integer format: int64 status: $ref: '#/components/schemas/ExecutionState' status-counts: type: object additionalProperties: type: integer format: int32 taskmanager-id: type: string ExecutionConfigInfo: type: object properties: job-parallelism: type: integer format: int32 object-reuse-mode: type: boolean restart-strategy: type: string user-config: type: object additionalProperties: type: string JobAccumulatorsInfo: type: object properties: job-accumulators: type: array items: $ref: '#/components/schemas/JobAccumulator' serialized-user-task-accumulators: type: object additionalProperties: $ref: '#/components/schemas/SerializedValueOptionalFailureObject' user-task-accumulators: type: array items: $ref: '#/components/schemas/UserTaskAccumulator' SlotSharingGroupId: type: object properties: bytes: type: array items: type: string format: byte lowerPart: type: integer format: int64 upperPart: type: integer format: int64 FailureLabel: type: object properties: key: type: string value: type: string SubtaskCheckpointStatistics: required: - className type: object properties: className: type: string index: type: integer format: int32 status: type: string discriminator: propertyName: className mapping: completed: '#/components/schemas/CompletedSubtaskCheckpointStatistics' pending: '#/components/schemas/PendingSubtaskCheckpointStatistics' JobStatusInfo: type: object properties: status: $ref: '#/components/schemas/JobStatus' MultipleJobsDetails: type: object properties: jobs: type: array items: $ref: '#/components/schemas/JobDetails' SubtaskBackPressureInfo: type: object properties: attempt-number: type: integer format: int32 backpressureLevel: $ref: '#/components/schemas/VertexBackPressureLevel' busyRatio: type: number format: double idleRatio: type: number format: double other-concurrent-attempts: type: array items: $ref: '#/components/schemas/SubtaskBackPressureInfo' ratio: type: number format: double subtask: type: integer format: int32 JobVertexAccumulatorsInfo: type: object properties: id: type: string user-accumulators: type: array items: $ref: '#/components/schemas/UserAccumulator' TriggerResponse: type: object properties: request-id: $ref: '#/components/schemas/TriggerId' Parallelism: type: object properties: lowerBound: type: integer format: int32 upperBound: type: integer format: int32 CheckpointAlignmentSummary: type: object properties: buffered: $ref: '#/components/schemas/StatsSummaryDto' duration: $ref: '#/components/schemas/StatsSummaryDto' persisted: $ref: '#/components/schemas/StatsSummaryDto' processed: $ref: '#/components/schemas/StatsSummaryDto' TaskCheckpointStatisticsWithSubtaskDetails: type: object properties: alignment_buffered: type: integer format: int64 checkpointed_size: type: integer format: int64 end_to_end_duration: type: integer format: int64 id: type: integer format: int64 latest_ack_timestamp: type: integer format: int64 num_acknowledged_subtasks: type: integer format: int32 num_subtasks: type: integer format: int32 persisted_data: type: integer format: int64 processed_data: type: integer format: int64 state_size: type: integer format: int64 status: $ref: '#/components/schemas/CheckpointStatsStatus' subtasks: type: array items: $ref: '#/components/schemas/SubtaskCheckpointStatistics' summary: $ref: '#/components/schemas/TaskCheckpointStatisticsWithSubtaskDetailsSummary' Id: type: string enum: - IN_PROGRESS - COMPLETED RawJson: type: object AggregationMode: type: string enum: - MIN - MAX - SUM - AVG - SKEW StatsSummaryDto: type: object properties: avg: type: integer format: int64 max: type: integer format: int64 min: type: integer format: int64 p50: type: number format: double p90: type: number format: double p95: type: number format: double p99: type: number format: double p999: type: number format: double JobVertexTaskManagersInfo: type: object properties: id: $ref: '#/components/schemas/JobVertexID' name: type: string now: type: integer format: int64 taskmanagers: type: array items: $ref: '#/components/schemas/JobVertexTaskManagerInfo' VertexFlameGraph: type: object properties: data: $ref: '#/components/schemas/Node' endTimestamp: type: integer format: int64 SubtaskExecutionAttemptAccumulatorsInfo: type: object properties: attempt: type: integer format: int32 id: type: string subtask: type: integer format: int32 user-accumulators: type: array items: $ref: '#/components/schemas/UserAccumulator' UserTaskAccumulator: type: object properties: name: type: string type: type: string value: type: string JobConfigInfo: type: object properties: executionConfigInfo: $ref: '#/components/schemas/ExecutionConfigInfo' jobId: $ref: '#/components/schemas/JobID' jobName: type: string TerminationMode: type: string enum: - CANCEL - STOP JobClientHeartbeatRequestBody: type: object properties: expiredTimestamp: type: integer format: int64 CheckpointingStatistics: type: object properties: counts: $ref: '#/components/schemas/Counts' history: type: array items: $ref: '#/components/schemas/CheckpointStatistics' latest: $ref: '#/components/schemas/LatestCheckpoints' summary: $ref: '#/components/schemas/CheckpointStatisticsSummary' ConfigurationInfoEntry: type: object properties: key: type: string value: type: string CheckpointTriggerRequestBody: type: object properties: checkpointType: $ref: '#/components/schemas/CheckpointType' triggerId: $ref: '#/components/schemas/TriggerId' ApplicationStatus: type: string enum: - SUCCEEDED - FAILED - CANCELED - UNKNOWN SavepointInfo: type: object properties: failure-cause: $ref: '#/components/schemas/SerializedThrowable' location: type: string SavepointFormatType: type: string enum: - CANONICAL - NATIVE SerializedThrowable: type: object properties: serialized-throwable: type: string format: binary VertexBackPressureStatus: type: string enum: - deprecated - ok AggregatedTaskDetailsInfo: type: object properties: metrics: type: object additionalProperties: type: object additionalProperties: type: integer format: int64 status-duration: type: object additionalProperties: type: object additionalProperties: type: integer format: int64 CheckpointStatistics: required: - className type: object properties: alignment_buffered: type: integer format: int64 checkpoint_type: $ref: '#/components/schemas/RestAPICheckpointType' checkpointed_size: type: integer format: int64 className: type: string end_to_end_duration: type: integer format: int64 id: type: integer format: int64 is_savepoint: type: boolean latest_ack_timestamp: type: integer format: int64 num_acknowledged_subtasks: type: integer format: int32 num_subtasks: type: integer format: int32 persisted_data: type: integer format: int64 processed_data: type: integer format: int64 savepointFormat: type: string state_size: type: integer format: int64 status: $ref: '#/components/schemas/CheckpointStatsStatus' tasks: type: object additionalProperties: $ref: '#/components/schemas/TaskCheckpointStatistics' trigger_timestamp: type: integer format: int64 discriminator: propertyName: className mapping: completed: '#/components/schemas/CompletedCheckpointStatistics' failed: '#/components/schemas/FailedCheckpointStatistics' in_progress: '#/components/schemas/PendingCheckpointStatistics' Metric: required: - id type: object properties: id: type: string value: type: string IOMetricsInfo: type: object properties: accumulated-backpressured-time: type: integer format: int64 accumulated-busy-time: type: number format: double accumulated-idle-time: type: integer format: int64 read-bytes: type: integer format: int64 read-bytes-complete: type: boolean read-records: type: integer format: int64 read-records-complete: type: boolean write-bytes: type: integer format: int64 write-bytes-complete: type: boolean write-records: type: integer format: int64 write-records-complete: type: boolean ThreadStates: type: string enum: - FULL - ON_CPU - OFF_CPU JVMInfo: type: object properties: arch: type: string options: type: array items: type: string version: type: string StopWithSavepointRequestBody: type: object properties: drain: type: boolean formatType: $ref: '#/components/schemas/SavepointFormatType' targetDirectory: type: string triggerId: $ref: '#/components/schemas/TriggerId' JobVertexBackPressureInfo: type: object properties: backpressureLevel: $ref: '#/components/schemas/VertexBackPressureLevel' end-timestamp: type: integer format: int64 status: $ref: '#/components/schemas/VertexBackPressureStatus' subtasks: type: array items: $ref: '#/components/schemas/SubtaskBackPressureInfo' JobIdsWithStatusOverview: type: object properties: jobs: type: array items: $ref: '#/components/schemas/JobIdWithStatus' FailedCheckpointStatistics: type: object allOf: - $ref: '#/components/schemas/CheckpointStatistics' - type: object properties: failure_timestamp: type: integer format: int64 failure_message: type: string Node: type: object properties: children: type: array items: $ref: '#/components/schemas/Node' name: type: string value: type: integer format: int32 JobVertexResourceRequirements: type: object properties: parallelism: $ref: '#/components/schemas/Parallelism' CheckpointType: type: string enum: - CONFIGURED - FULL - INCREMENTAL JobID: pattern: '[0-9a-f]{32}' type: string