Getting the number of configuration changes

Ops Center Analyzer REST API Reference Guide

Version
11.0.x
Audience
anonymous
Part Number
MK-99ANA003-18

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.)

  • Server
  • Storage
  • NetworkDevice
  • Datastore

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.)

  • Server
  • Storage
  • NetworkDevice
  • Datastore

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
  } ]
}