2.4.2　探索の実行に必要な情報の取得

探索を実行するために必要な情報を取得します。

権限

Admin

APIのバージョン

リクエスト形式

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 ]
  } ]
}

2.4.2 探索の実行に必要な情報の取得

2.4.2　探索の実行に必要な情報の取得