Tuning Manager APIリファレンスガイド

5.4 HTM - Agents管理のアクション一覧の取得（パフォーマンスデータの取得の場合）

HTM - Agents管理のアクション一覧の取得方法について示します。

このAPIは，HTM - Agents管理が提供するすべてのアクションについて，parametersフィールドが省略されたActionオブジェクトをCollectionオブジェクトに格納して，APIクライアントに返します。このCollectionオブジェクト（アクション一覧）はどのようなアクションが存在するかを知るために使用できます。

HTTPリクエスト構文（URI）

GET  <scheme>://<host>:<port>/<application>/<version>/services/AgentManager/actions

リクエストの構造

リクエストボディは，空でなければいけません。

レスポンスの構造

レスポンスボディの構造を次に示します。

 
{
    "items":[{"name":"<アクション名>", 
       "url":"<アクションを実行するURI>",
       "method":"<アクション実行時のHTTPメソッド>",
       "type":"<アクション実行時のリクエストのContent-Typeヘッダに指定するメディアタイプ>"
            }]
}

レスポンスボディに含むデータフォーマットを次の表に示します。

表5-2 HTM - Agents管理のアクション一覧取得のデータフォーマット

オブジェクト名		個数	説明
Collection		1	Actionオブジェクトを子に持つCollectionオブジェクト。
―	Action	0...n	Actionオブジェクト。 ただし，parameters変数はありません。

実行例（HTM - Agents管理のアクション一覧の取得）

curlコマンドを使用したリクエストメッセージ：

curl -v -H "Content-Type: application/json" -u system:manager -X
GET https://server_1:22016/TuningManager/v1/services/AgentManager/actions

リクエストに対する実行結果／

リクエストヘッダー：

GET /TuningManager/v1/services/AgentManager/actions HTTP/1.1
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
User-Agent: curl/7.19.7 (i386-redhat-linux-gnu) libcurl/7.19.7 
NSS/3.12.9.0 zlib/1.2.3 libidn/1.18 libssh2/1.2.2
Host: server_1:22016
Accept: */*
Content-Type: application/json

レスポンスヘッダー：

HTTP/1.1 200 OK
Date: Thu, 19 Jun 2014 04:52:26 GMT
Server: Cosminexus HTTP Server
Cache-Control: no-cache
Transfer-Encoding: chunked
Content-Type: application/json;charset=utf-8

レスポンスボディ：

{
 "items":[{"name":"RefreshAgentInstancesParameters",
    "url":"https://server_1:22016/TuningManager/v1/services/AgentManager/actions/refresh/invoke",
    "method":"POST",
 　 "type":"application/json"
         }]
}

[目次] [前へ] [次へ]

All Rights Reserved. Copyright© 2014, 2020, Hitachi, Ltd.