Get all discovery tasks in a domain

Use this API to get all discovery tasks in the current domain.

Tip: If there are no discovery tasks in the system, add a new discovery task from the Domain Management page. In the discovery task, select Once on the Frequency tab and Discover the following IPs on the Discovery Seed tab.

Resource Information

Method

URL

Required authentication

GET

/V1/CMDB/Discovery/Tasks

Yes

Parameters

Name

Description

Token*required
(header)

Place the token received from the API Log in to get an authentication token.

Response

Parameter

Type

Description

Example

tasks

list

A list of all discovery tasks.

{
  "statusCode": 790200,
  "statusDescription": "success",
  "tasks": [
    {
      "id": "1696faa7-749c-78a7-eaad-fcf815b11e4a",
      "name": "Scheduled System Discovery",
      "enable": true,
      "lastStatus": "",
      "lastRunSpan": "00:00:00",
      "curStatus": "Not Started",
      "nextRunTime": "1/2/3000,12:00:00 AM",
      "frequency": "Once"
    },
    {
      "id": "1696faa7-749c-78a7-eaad-fcf815b11e4b",
      "name": "Scheduled Discovery1",
      "enable": true,
      "lastStatus": "",
      "lastRunSpan": "00:00:00",
      "curStatus": "Not Started",
      "nextRunTime": "2/2/3000,12:00:00 AM",
      "frequency": "Once"
    }
  ]
}

id

string

The ID of a discovery task.

name

string

The name of a discovery task.

enable

bool

Whether a discovery task is enabled.

lastStatus

string

The last run (result) status of a discovery task.

lastRunSpan

integer

The duration of the last run of a discovery task.

curStatus

string

The current status of a discovery task.

nextRunTime

string

The start time of the next run of a discovery task.

frequency

string

The run frequency of a discovery task.

statusCode

integer

The returned status code of executing the API.

statusDescription

string

The explanation of the status code.