Jobs - Query Scheduled Jobs

Gets the information about jobs using an IoT Hub query. See https://docs.microsoft.com/azure/iot-hub/iot-hub-devguide-query-language for more information.

GET https://fully-qualified-iothubname.azure-devices.net/jobs/v2/query?api-version=2021-04-12
GET https://fully-qualified-iothubname.azure-devices.net/jobs/v2/query?jobType={jobType}&jobStatus={jobStatus}&api-version=2021-04-12

URI Parameters

Name In Required Type Description
api-version
query True

string

Version of the Api.

jobStatus
query

string

The job status. See https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-devguide-jobs#querying-for-progress-on-jobs for a list of possible statuses.

jobType
query

string

The job type. See https://docs.microsoft.com/en-us/azure/iot-hub/iot-hub-devguide-jobs#querying-for-progress-on-jobs for a list of possible job types.

Responses

Name Type Description
200 OK

QueryResult

OK.

Definitions

QueryResult

The query result.

Name Type Description
continuationToken

string

The continuation token.

items

object[]

The query result items, as a collection.

type enum:
  • deviceJob
  • deviceRegistration
  • enrollment
  • enrollmentGroup
  • jobResponse
  • raw
  • twin
  • unknown

The query result type.