Hitachi

JP1 Version 12 JP1/Operations Analytics REST APIリファレンス


2.27.2 指定した性能情報の時系列での性能値をCSVで取得

指定した性能情報の時系列での性能値をCSVで取得します。

権限

Admin, Modify

APIのバージョン

v1

リクエスト形式

POST http[s]://host:port/Analytics/version/services/PerfComponents/actions/getGraphDataCSV/invoke

リクエストボディー

リクエストボディーの構造とオブジェクトの属性を次に示します。
{
        "name":"...",
        "href":"...",
        "method":"...",
        "type":"...",
        "parameters":[{
            "perfComponentIDs":["...", ...],
            "baseTime":"...",
            "pointTimeRange":"..."
        },
        :
        ]
}

Action (Type: Action)

属性

データ型

説明

name

string

操作名です。

href

string

操作の実行先URLです。

method

string

メソッド名です。

type

string

データのデータ形式です。

parameters

GetGraphDataCSVParam[]

操作実行時に必要なGetGraphDataCSVParamのコレクション。GetGraphDataCSVParamの詳細は以下の表を参照ください。

parameters (Type: GetGraphDataCSVParam)

属性

データ型

説明

perfComponentIDs

long[]

PerfComponentのID

baseTime

dateTime

性能情報を取得する基点の時刻。指定した時刻からpointTimeRangeで指定した期間さかのぼった時刻までの性能情報を取得します。省略した場合は,APIを実行した時刻が基点として使用されます。

pointTimeRange

long

性能情報を取得する期間 [ミリ秒]

レスポンスボディー

レスポンスボディーの構造とオブジェクトの属性を次に示します。
{
        "instanceID":"...",
        "created":"...",
        "updated":"...",
        "completed":"...",
        "state":"...",
        "affectedResource":["...", ...],
        "result":[{
            "data":"..."
        },
        :
        ]
}

Job (Type: Job)

属性

データ型

説明

instanceID

string

インスタンスのIDを示します。

created

string

オブジェクトの生成日付を示します。ISO8601形式です。

updated

string

オブジェクトが更新された時刻を示します。createdと同時刻が設定されます。ISO8601形式です。

completed

string

処理が完了した時刻を示します。createdと同時刻が設定されます。ISO8601形式です。

state

string

以下の値が設定されます。

“failed”: 操作が正常終了しなかったことを示します。

“success”: 操作が正常終了したことを示します。

affectedResource

string[]

操作の結果,作成または更新されたAPIのリソースのURLを示します。リソースが存在しない場合、このパラメータは空欄です。

result

CsvData[]

実行結果のCsvDataのコレクション。CsvDataの詳細は以下の表を参照ください。

result (Type: CsvData)

属性

データ型

説明

data

string

CSVデータが格納されます。

ステータスコード

HTTPステータスコード

Reason phrase

説明

200

OK

正常終了

400

Bad Request

リクエストボディ形式不正

401

Unauthorized

ログイン権限がない

403

Forbidden

実行権限がない

412

Precondition Failed

サーバーが起動していない

500

Internal Server Error

サーバーサイドエラー

使用例

[Request Header]
POST /Analytics/v1/services/PerfComponents/actions/getGraphDataCSV/invoke HTTP/1.1
Host: JP1OAServer:22015
User-Agent: curl/7.63.0
Accept: application/json
Accept-Language: ja
Content-Type: application/json
Authorization: Basic c3lzdGVtOm1hbmFnZXI=
Content-Length: 325

[Request Body]
{
  "name" : "getGraphDataCSV",
  "href" : "http://JP1OAServer:22015/Analytics/v1/services/PerfComponents/actions/getGraphDataCSV/invoke",
  "method" : "POST",
  "type" : "application/json",
  "parameters" : [ {
    "perfComponentIDs" : [15,16,17],
    "baseTime" : "2019-09-12T12:10:45.435+09:00",
    "pointTimeRange" : 36000
  } ]
}

[Response Header]
HTTP/1.1 200 OK
Date: Thu, 12 Sep 2019 04:59:06 GMT
Server: Cosminexus HTTP Server
Cache-Control: no-cache
WWW-Authenticate: HSSO e3a9c17a51e3395f81fc1c431d87e295d3cf0f3_ZAlDSFUHGHp9UB8WcRQLdA==_V0810
X-Frame-Options: SAMEORIGIN
X-XSS-Protection: 1; mode=block 
X-Content-Type-Options: nosniff
Transfer-Encoding: chunked
Content-Type: application/json

[Response Body]
{
  "instanceID" : "0af73a36-cb9b-4f07-b2c7-4899c9c0be6f",
  "created" : "2019-09-12T13:59:06.990+09:00",
  "updated" : "2019-09-12T13:59:07.253+09:00",
  "completed" : "2019-09-12T13:59:07.253+09:00",
  "state" : "success",
  "affectedResource" : [ ],
  "result" : [ {
    "data" : "#JP1/Operations Analytics,111000,UTF-8 (BOM)\n#Time Series Performance Information\n#2019-09-12T13:59:07.252+0900\n#R.............."
  } ]
}