2.28.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.............."
} ]
}