2.4.2 探索の実行に必要な情報の取得
探索を実行するために必要な情報を取得します。
権限
Admin
APIのバージョン
v1
リクエスト形式
GET http[s]://host:port/Analytics/version/services/Discoveries/actions/submit
リクエストボディー
リクエストボディーには何も設定しません。
レスポンスボディー
レスポンスボディーの構造とオブジェクトの属性を次に示します。{ "name":"...", "href":"...", "method":"...", "type":"...", "parameters":[{ "autoManage":"...", "ipAddrRangeID":["...", ...] }, : ] }
Action (Type: Action)
属性 |
データ型 |
説明 |
---|---|---|
name |
string |
操作名です。 |
href |
string |
操作の実行先URLです。 |
method |
string |
メソッド名です。 |
type |
string |
データのデータ形式です。 |
parameters |
DiscoveryParam[] |
操作実行時に必要なDiscoveryParamのコレクション。DiscoveryParamの詳細は以下の表を参照ください。 |
parameters (Type: DiscoveryParam)
属性 |
データ型 |
説明 |
---|---|---|
autoManage |
boolean |
探索により発見したリソースを自動的に管理対象にする場合true |
ipAddrRangeID |
long[] |
探索する探索範囲のインスタンスIDのリスト |
ステータスコード
HTTPステータスコード |
Reason phrase |
説明 |
---|---|---|
200 |
OK |
正常終了 |
401 |
Unauthorized |
ログイン権限がない, |
403 |
Forbidden |
参照権限がない |
412 |
Precondition Failed |
サーバーが起動していない, |
500 |
Internal Server Error |
サーバーサイドエラー, |
使用例
[Request Header] GET http://localhost:22015/Analytics/v1/services/Discoveries/actions/submit/ HTTP/1.1 Host: localhost:22015 Accept: application/json Accept-Language: ja Content-Type: application/json Authorization: Basic c3lzdGVtOm1hbmFnZXI= [Response Header] HTTP/1.1 200 OK Date: Mon, 25 May 2020 02:47:16 GMT Server: Cosminexus HTTP Server Cache-Control: no-cache WWW-Authenticate: HSSO ffcce126318d18ca63c8fd870a3bbbde84ca57b_Vlo8Y30IFF0IHk4SCAJcHgUXDVg=_V0810 X-Frame-Options: SAMEORIGIN X-XSS-Protection: 1; mode=block X-Content-Type-Options: nosniff Content-Type: application/json Content-Length: 274 [Response Body] { "name" : "submit", "href" : "http://localhost:22015/Analytics/v1/services/Discoveries/actions/submit/invoke", "method" : "POST", "type" : "application/json", "parameters" : [ { "autoManage" : true, "ipAddrRangeID" : [ 3, 2, 1, 4, 5, 50 ] } ] }