Table of contents

Job Status API

The Job Status API tracks the running state of harvest and reindex jobs. It is used to establish job status records, as well as, both query and update the count of tems walked and indexed.

Job completion percentage will be calculated as: (job.walked_count / job.indexed_count) * 100. Thus, the whole job will be 100% when job.walked_count == job.indexed_count.

List Jobs

GET /api/data/v3/jobstatus?all={all}&page-token={page_token}"

  • all - Include complete jobs? (default: false)
  • page-token - Token specifying results page (for multi-page results).

Response:

  • Status 200 (OK)
{
	"jobs": [
		{
			"request_id": string,
			"container_id": string,
			"user_id": string,
			"walked_count": int,
			"indexed_count": int,
			"created": zulu timestamp,
			"updated": zulu timestamp
		},
		...
	],
	"next_page_token": string
}

Job Details

GET /api/data/v3/jobstatus/{request_id}

Response:

  • Status 200 (OK)
{
	"job": {
		"request_id": string,
		"container_id": string,
		"user_id": string,
		"walked_count": int,
		"indexed_count": int,
		"created": zulu timestamp,
		"updated": zulu timestamp
	}
}

Errors:

  • Status 404 (Not Found) - When request_id not found.

This documentation is generated from the latest version of GrayMeta Platform. For documentation relevant to your own deployed version, please use the documentation inside the application.