Apache Giraph Job Management API
The Job Management API from Apache Giraph — 2 operation(s) for job management.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/apache-giraph-job-management-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Apache Giraph Job Monitoring Cluster Job Management API
version: 1.3.0
description: Monitoring and status API for Apache Giraph graph processing jobs running on Apache Hadoop YARN. Note - Apache Giraph has been retired (2024).
contact:
email: dev@giraph.apache.org
license:
name: Apache 2.0
url: https://www.apache.org/licenses/LICENSE-2.0
servers:
- url: http://localhost:8088
description: YARN ResourceManager REST API (for Giraph job monitoring)
tags:
- name: Job Management
paths:
/ws/v1/cluster/apps:
get:
operationId: listGiraphJobs
summary: Apache Giraph List Graph Processing Jobs
description: List Giraph graph processing jobs running on YARN cluster via the ResourceManager REST API.
tags:
- Job Management
parameters:
- name: applicationTypes
in: query
required: false
description: Filter by application type (e.g., MAPREDUCE for Giraph jobs)
schema:
type: string
example: MAPREDUCE
- name: states
in: query
required: false
description: Filter by job state (RUNNING, FINISHED, FAILED, KILLED)
schema:
type: string
example: RUNNING
responses:
'200':
description: Jobs listed successfully
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationsResponse'
examples:
ListGiraphJobs200Example:
summary: Default listGiraphJobs 200 response
x-microcks-default: true
value:
apps:
app:
- id: application_1718153645993_0001
name: 'Giraph: PageRank'
applicationType: MAPREDUCE
state: RUNNING
finalStatus: UNDEFINED
progress: 50.0
trackingUrl: http://localhost:8088/proxy/application_1718153645993_0001/
queue: default
startedTime: 1718153645993
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
/ws/v1/cluster/apps/{appId}:
get:
operationId: getGiraphJob
summary: Apache Giraph Get Graph Processing Job
description: Get detailed status and metrics for a specific Giraph job running on YARN.
tags:
- Job Management
parameters:
- name: appId
in: path
required: true
description: YARN application ID for the Giraph job
schema:
type: string
example: application_1718153645993_0001
responses:
'200':
description: Job details retrieved successfully
content:
application/json:
schema:
$ref: '#/components/schemas/ApplicationResponse'
'404':
description: Job not found
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
components:
schemas:
ApplicationResponse:
type: object
description: Single YARN application response
properties:
app:
$ref: '#/components/schemas/ApplicationInfo'
ApplicationInfo:
type: object
description: YARN application (Giraph job) status information
properties:
id:
type: string
description: YARN application ID
example: application_1718153645993_0001
name:
type: string
description: Application name (usually Giraph followed by the algorithm name)
example: Giraph PageRank
applicationType:
type: string
description: Application type (MAPREDUCE for Giraph)
example: MAPREDUCE
state:
type: string
description: Current application state
enum:
- NEW
- NEW_SAVING
- SUBMITTED
- ACCEPTED
- RUNNING
- FINISHED
- FAILED
- KILLED
example: RUNNING
finalStatus:
type: string
description: Final status after completion
enum:
- UNDEFINED
- SUCCEEDED
- FAILED
- KILLED
example: UNDEFINED
progress:
type: number
description: Job completion percentage (0-100)
example: 50.0
trackingUrl:
type: string
description: URL for job tracking UI
example: http://localhost:8088/proxy/application_1718153645993_0001/
queue:
type: string
description: YARN queue name
example: default
startedTime:
type: integer
format: int64
description: Job start time in milliseconds since epoch
example: 1718153645993
finishedTime:
type: integer
format: int64
description: Job finish time in milliseconds (0 if still running)
example: 0
elapsedTime:
type: integer
format: int64
description: Elapsed time in milliseconds
example: 30000
numContainers:
type: integer
description: Number of running containers
example: 4
ApplicationsResponse:
type: object
description: YARN applications list response
properties:
apps:
type: object
description: Applications wrapper
properties:
app:
type: array
description: List of application entries
items:
$ref: '#/components/schemas/ApplicationInfo'