v1

latestOpenAPI 3.0.02026-08-0484453.8 KB
Get Jobs

List jobs

Retrieves a list of jobs with optional filtering by time ranges and status. Incomplete jobs will only include basic information.

get/v1/jobs

Query parameters

query.createdTimeRange.startstring date-time

The start of the time range

query.createdTimeRange.endstring date-time

The end of the time range

query.createdTimeRange.inclusiveboolean

Whether to treat the time range as inclusive or exclusive

query.updatedTimeRange.startstring date-time

The start of the time range

query.updatedTimeRange.endstring date-time

The end of the time range

query.updatedTimeRange.inclusiveboolean

Whether to treat the time range as inclusive or exclusive

query.completedTimeRange.startstring date-time

The start of the time range

query.completedTimeRange.endstring date-time

The end of the time range

query.completedTimeRange.inclusiveboolean

Whether to treat the time range as inclusive or exclusive

query.status'JOB_STATUS_UNSPECIFIED' | 'JOB_STATUS_PENDING' | 'JOB_STATUS_RUNNING' | 'JOB_STATUS_COMPLETED' | 'JOB_STATUS_FAILED' | 'JOB_STATUS_CANCELED'

The status of the job

query.policyIdstring

Policy ID that created the job

pageSizeinteger

The maximum number of jobs to return. Defaults to 10, capped at 1000.

pageTokenstring

A token identifying the page to return; for keyset pagination

Response

A successful response.

nextPageTokenstring