You can obtain the number of configuration changes.
Execution permission
Admin, Modify
Request line
POST baseURL/v1/services/ChangeHistorys/actions/getCount/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 action. |
href |
string |
URL for the action. |
method |
string |
Name of the method. |
type |
string |
Data format for the object. |
parameters |
anyType[] |
A list of GetChangeCountParam objects necessary to execute an operation. For details, see the table below. |
GetChangeCountParam
{ "nodeIDs":["...", ...], "deviceTypes":["...", ...], "countFrom":"...", "countTo":"...", "interval":"..." }
GetChangeCountParam (Type: GetChangeCountParam)
Attribute |
Type |
Description |
---|---|---|
nodeIDs |
long[] |
ID of the device for which the configuration change occurred |
deviceTypes |
enum[] |
Type of device for which the configuration change occurred (For details about the valid values, see the table NodeDisplayType in List of enumerators.)
|
countFrom |
dateTime |
Aggregation start time of the configuration change history |
countTo |
dateTime |
Aggregation end time of the configuration change history |
interval |
long |
Aggregation interval of the configuration change history (ms). |
Response body
The structure of the response body and the object attributes is as follows:ChangeCount
{ "deviceType":"...", "periodFrom":"...", "count":"..." }
ChangeCount (Type: ChangeCount)
Attribute |
Type |
Description |
---|---|---|
deviceType |
enum |
Type of device for which the configuration change occurred (For details about the valid values, see the table NodeDisplayType in List of enumerators.)
|
periodFrom |
dateTime |
Start time for the aggregation of the configuration change history |
count |
long |
Number of configuration change histories |
Status codes
Status code |
Reason phrase |
Description |
---|---|---|
200 |
OK |
Success. |
400 |
Bad Request |
The format of the request body is invalid. |
401 |
Unauthorized |
No login privilege. |
403 |
Forbidden |
No update privilege. |
412 |
Precondition Failed |
The server is not available. |
500 |
Internal Server Error |
Server processing error. |
Example code
[Request Header] POST /Analytics/v1/services/ChangeHistorys/actions/getCount/invoke HTTP/1.1 Authorization: Basic c3lzdGVtOm1hbmFnZXI= Host: localhost:22015 Accept: application/json Content-Type: application/json [Request Body] { "name" : "getCount", "href" : "http://localhost:22015/Analytics/v1/services/ChangeHistorys/actions/getCount/invoke", "method" : "POST", "type" : "application/json", "parameters" : [ { "nodeIDs" : [ ], "deviceTypes" : [ "Server" ], "countFrom" : "2016-08-22T21:21:20.236+09:00", "countTo" : "2016-08-23T21:21:20.236+09:00", "interval" : 3600000 } ] } [Response Header] HTTP/1.1 200 OK Date: Tue, 23 Aug 2016 12:24:16 GMT Server: Cosminexus HTTP Server Cache-Control: no-cache WWW-Authenticate: HSSO d5edd16e4304d187c184cff39dc443fae882c0_YXZvNFILd2IcDAIaWXcFMFR3FVc=_V0810 X-Frame-Options: SAMEORIGIN X-XSS-Protection: 1; mode=block X-Content-Type-Options: nosniff Content-Type: application/json [Response Body] { "instanceID" : "d0d9f541-62e6-450d-8a8e-abbbdf04586a", "created" : "2016-08-23T21:24:16.408+09:00", "updated" : "2016-08-23T21:24:16.408+09:00", "completed" : "2016-08-23T21:24:16.408+09:00", "state" : "success", "affectedResource" : [ ], "result" : [ { "deviceType" : "Server", "periodFrom" : "2016-08-22T21:21:20.236+09:00", "count" : 0 }, { "deviceType" : "Server", "periodFrom" : "2016-08-22T22:21:20.236+09:00", "count" : 0 }, { "deviceType" : "Server", "periodFrom" : "2016-08-22T23:21:20.236+09:00", "count" : 0 }, { "deviceType" : "Server", "periodFrom" : "2016-08-23T00:21:20.236+09:00", "count" : 0 }, { "deviceType" : "Server", "periodFrom" : "2016-08-23T01:21:20.236+09:00", "count" : 0 }, { "deviceType" : "Server", "periodFrom" : "2016-08-23T02:21:20.236+09:00", "count" : 0 }, { "deviceType" : "Server", "periodFrom" : "2016-08-23T03:21:20.236+09:00", "count" : 0 }, { "deviceType" : "Server", "periodFrom" : "2016-08-23T04:21:20.236+09:00", "count" : 0 }, { "deviceType" : "Server", "periodFrom" : "2016-08-23T05:21:20.236+09:00", "count" : 0 }, { "deviceType" : "Server", "periodFrom" : "2016-08-23T06:21:20.236+09:00", "count" : 0 }, { "deviceType" : "Server", "periodFrom" : "2016-08-23T07:21:20.236+09:00", "count" : 7 }, { "deviceType" : "Server", "periodFrom" : "2016-08-23T08:21:20.236+09:00", "count" : 11 }, { "deviceType" : "Server", "periodFrom" : "2016-08-23T09:21:20.236+09:00", "count" : 0 }, { "deviceType" : "Server", "periodFrom" : "2016-08-23T10:21:20.236+09:00", "count" : 0 }, { "deviceType" : "Server", "periodFrom" : "2016-08-23T11:21:20.236+09:00", "count" : 0 }, { "deviceType" : "Server", "periodFrom" : "2016-08-23T12:21:20.236+09:00", "count" : 6 }, { "deviceType" : "Server", "periodFrom" : "2016-08-23T13:21:20.236+09:00", "count" : 0 }, { "deviceType" : "Server", "periodFrom" : "2016-08-23T14:21:20.236+09:00", "count" : 0 }, { "deviceType" : "Server", "periodFrom" : "2016-08-23T15:21:20.236+09:00", "count" : 1 }, { "deviceType" : "Server", "periodFrom" : "2016-08-23T16:21:20.236+09:00", "count" : 0 }, { "deviceType" : "Server", "periodFrom" : "2016-08-23T17:21:20.236+09:00", "count" : 0 }, { "deviceType" : "Server", "periodFrom" : "2016-08-23T18:21:20.236+09:00", "count" : 2 }, { "deviceType" : "Server", "periodFrom" : "2016-08-23T19:21:20.236+09:00", "count" : 5 }, { "deviceType" : "Server", "periodFrom" : "2016-08-23T20:21:20.236+09:00", "count" : 8 } ] }