2.17.2 Collecting, into a CSV file, the performance values in a time series of specified performance information
This request collects, into a CSV file, the performance values in a time series of specified performance information.
Execution permission
Admin, Modify
API version
v1
Request format
POST http[s]://host:port/Analytics/version/services/PerfComponents/actions/getGraphDataCSV/invoke
Request body
The structure of the request body and the object attributes are as follows:Action
{ "name":"...", "href":"...", "method":"...", "type":"...", "parameters":["...", ...] }
Action (Type: Action)
Attribute |
Type |
Description |
---|---|---|
name |
string |
Name of the execute an operation. |
href |
string |
URL of the execute an operation. |
method |
string |
Name of the method. |
type |
string |
Data format of the object. |
parameters |
anyType[] |
A list of GetGraphDataCSVParam objects necessary to execute an operation. For details about GetGraphDataCSVParam, see the table below. |
GetGraphDataCSVParam
{ "perfComponentIDs":["...", ...], "baseTime":"...", "pointTimeRange":"..." }
GetGraphDataCSVParam (Type: GetGraphDataCSVParam)
Attribute |
Type |
Description |
---|---|---|
perfComponentIDs |
long[] |
ID of perfComponents |
baseTime |
dateTime |
Start time for obtaining performance information. The performance information for a certain period before the specified start time is obtained. The period is specified by pointTimeRange. If this item is omitted, the time that the API was executed is used as the start time. |
pointTimeRange |
long |
Period during which performance information is obtained (ms.) |
Response body
The structure of the response body and the object attributes are as follows:Job
{ "instanceID":"...", "created":"...", "updated":"...", "completed":"...", "state":"...", "affectedResource":["...", ...], "result":["...", ...] }
Job (Type: Job)
Attribute |
Type |
Description |
---|---|---|
instanceID |
string |
Indicates the ID of the Instance. |
created |
string |
Indicates the date the object is generated in ISO 8601 format. |
updated |
string |
Indicates the time the object is updated in ISO 8601 format. The same value as for "created" is set. |
completed |
string |
Indicates the time the processing completed in ISO 8601 format. The same value as for "created" is set. |
state |
string |
One of the following values is set: "failed": The operation did not terminate normally. "success": The operation terminated normally. |
affectedResource |
string[] |
Indicates the URL of the API resource created or updated as a result of the operation. If no resources exist, this parameter is empty. |
result |
anyType[] |
A list of CsvData objects. For details about CsvData, see the table below. |
CsvData
{ "data":"..." }
CsvData (Type: CsvData)
Attribute |
Type |
Description |
---|---|---|
data |
string |
The CSV data is stored. |
Status codes
Status code |
Reason phrase |
Description |
---|---|---|
200 |
OK |
Success. |
400 |
Bad Request |
A format of request body is invalid. |
401 |
Unauthorized |
No login privilege. |
403 |
Forbidden |
No execute privilege. |
412 |
Precondition Failed |
The server is not available. |
500 |
Internal Server Error |
Server processing error. |
Example code
[Request Header] POST /Analytics/v1/services/PerfComponents/actions/getGraphDataCSV/invoke HTTP/1.1 Authorization: Basic c3lzdGVtOm1hbmFnZXI= User-Agent: curl/7.33.0 Host: localhost:22015 Accept: application/json Content-Type: application/json Accept-Language: ja Content-Length: 296 [Request Body] { "name" : "getGraphDataCSV", "href" : "http://localhost:22015/Analytics/v1/services/PerfComponents/actions/getGraphDataCSV/invoke", "method" : "POST", "type" : "application/json", "parameters" : [ { "perfComponentIDs" : [ ], "baseTime" : "2016-11-25T11:11:04.489+09:00", "pointTimeRange" : 86400000 } ] } [Response Header] HTTP/1.1 200 OK Date: Fri, 27 Nov 2015 09:22:28 GMT Server: Cosminexus HTTP Server Cache-Control: no-cache WWW-Authenticate: HSSO 284045794595c1ed7a98d2184419b8656e48a15_WVlGcHsLfg5ffg0I_V0810 X-Frame-Options: SAMEORIGIN Transfer-Encoding: chunked Content-Type: application/json [Response Body] { "instanceID" : "0052a2e2-713c-4cfb-892c-e9aaefb32b50", "created" : "2016-11-22T11:53:42.188+09:00", "updated" : "2016-11-22T11:53:42.354+09:00", "completed" : "2016-11-22T11:53:42.354+09:00", "state" : "success", "affectedResource" : [ ], "result" : [ { "data": ""#JP1/Operations Analytics","111000","UTF-8 (BOM)"\n"#Time Series Performance Information"\n..." } ] }