2.4.3 Running a Discovery
This API run a discovery.
Execution permission
Admin
API version
v1
Request format
POST http[s]://host:port/Analytics/version/services/Discoveries/actions/submit/invoke
Request body
The structure of the request body and the object attributes are as follows:{ "name":"...", "href":"...", "method":"...", "type":"...", "parameters":[{ "autoManage":"...", "ipAddrRangeID":["...", ...] }, : ] }
Action (Type: Action)
Attribute |
Type |
Description |
---|---|---|
name |
string |
Name of the execute an operation. |
href |
string |
URL of the execute an operation. |
method |
string |
Name of the method. |
type |
string |
Data format of the object. |
parameters |
DiscoveryParam[] |
A list of DiscoveryParam objects necessary to execute an operation. For details about DiscoveryParam, see the table below. |
parameters (Type: DiscoveryParam)
Attribute |
Type |
Description |
---|---|---|
autoManage |
boolean |
To automatically manage discovered resources, set true. |
ipAddrRangeID |
long[] |
List of instance IDs in the IP address range used for discovery |
Response body
The structure of the response body and the object attributes are as follows:{ "instanceID":"...", "created":"...", "updated":"...", "completed":"...", "state":"...", "affectedResource":["...", ...], "result":["...", ...] }
Job (Type: Job)
Attribute |
Type |
Description |
---|---|---|
instanceID |
string |
Indicates the ID of the Instance. |
created |
string |
Indicates the date the object is generated in ISO 8601 format. |
updated |
string |
Indicates the time the object is updated in ISO 8601 format. The same value as for "created" is set. |
completed |
string |
Indicates the time the processing completed in ISO 8601 format. The same value as for "created" is set. |
state |
string |
One of the following values is set: "failed": The operation did not terminate normally. "success": The operation terminated normally. |
affectedResource |
string[] |
Indicates the URL of the API resource created or updated as a result of the operation. If no resources exist, this parameter is empty. |
result |
anyType[] |
A list of objects. No value is set. |
Status codes
Status code |
Reason phrase |
Description |
---|---|---|
200 |
OK |
Success. |
400 |
Bad Request |
A format of request body is invalid. |
401 |
Unauthorized |
No login privilege. |
403 |
Forbidden |
No execute privilege. |
404 |
Not Found |
The resource was not found. |
409 |
Conflict |
Executing now. |
412 |
Precondition Failed |
The server is not available. |
500 |
Internal Server Error |
Server processing error. |
Example code
[Request Header] POST http://localhost:22015/Analytics/v1/services/Discoveries/actions/submit/invoke HTTP/1.1 Host: localhost:22015 Accept: application/json Accept-Language: ja Content-Type: application/json Authorization: Basic c3lzdGVtOm1hbmFnZXI= Content-Length: 154 [Request Body] { "name":"submit", "href":"v1/services/Discoveries/actions/submit/invoke", "method":"POST", "parameters":[ { "ipAddrRangeID":[3,2,1,4,5,50], "autoManage":true } ] } [Response Header] HTTP/1.1 200 OK Date: Mon, 25 May 2020 02:53:26 GMT Server: Cosminexus HTTP Server Cache-Control: no-cache WWW-Authenticate: HSSO 765ce3a1aa398ad2f383653ce37491ea3744085_Vlo8Y30IFF0IHk4SCAJcHgUXDVg=_V0810 X-Frame-Options: SAMEORIGIN X-XSS-Protection: 1; mode=block X-Content-Type-Options: nosniff Content-Type: application/json Content-Length: 279 [Response Body] { "instanceID" : "ef724ea9-41ad-49d3-afe0-e174f534b846", "created" : "2020-05-25T11:53:26.350+09:00", "updated" : "2020-05-25T11:53:26.350+09:00", "completed" : "2020-05-25T11:53:26.350+09:00", "state" : "success", "affectedResource" : [ ], "result" : [ ] }