Apache Giraph

Apache Giraph Job Management API

The Job Management API from Apache Giraph — 2 operation(s) for job management.

Documentation GitHub OpenAPI

Operations 2

GET /ws/v1/cluster/apps Apache Giraph List Graph Processing Jobs #

GET /ws/v1/cluster/apps/{appId} Apache Giraph Get Graph Processing Job #

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.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/apache-giraph:apache-giraph-job-management-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.

GitHub Google LinkedIn

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 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:
    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'
    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
    ApplicationResponse:
      type: object
      description: Single YARN application response
      properties:
        app:
          $ref: '#/components/schemas/ApplicationInfo'

Apache Giraph Job Management API

Operations 2

Documentation

Specifications

Schemas & Data

Other Resources