Configuration

GET: Get Supported Northbound Notifications

Description

This API returns all supported northbound notification types and applicable attributes for the notification rules.

HTTP Method

GET

Resource URI

/api/configuration/v1/attributes

Requires OAuth

N

Parameters

None.

Content Type

application/json

Sample Output

{
    "networkdesignchanged": {
        "triggerHeterarchyChanged": {
            "name": "triggerHeterarchyChanged",
            "dataType": "BOOLEAN",
            "needValueCheck": false,
            "evaluateByProvider": false,
            "validValueSet": [],
            "nameSpace": "networkdesignchanged"
        },
        "triggerNetworkDesignChanged": {
            "name": "triggerNetworkDesignChanged",
            "dataType": "BOOLEAN",
            "needValueCheck": false,
            "evaluateByProvider": false,
            "validValueSet": [],
            "nameSpace": "networkdesignchanged"
        }
    },
    "servicestatus": {
        "oldStatus": {
            "name": "oldStatus",
            "dataType": "ENUM",
            "needValueCheck": false,
            "evaluateByProvider": false,
            "validValueSet": [
                "STOPPED",
                "RUNNING",
                "CRASHED",
                "DISABLED"
            ],
            "nameSpace": "servicestatus"
        },
        "status": {
            "name": "status",
            "dataType": "ENUM",
            "needValueCheck": true,
            "evaluateByProvider": true,
            "validValueSet": [
                "STOPPED",
                "RUNNING",
                "CRASHED",
                "DISABLED"
            ],
            "nameSpace": "servicestatus"
        },
        "statusChanged": {
            "name": "statusChanged",
            "dataType": "BOOLEAN",
            "needValueCheck": true,
            "evaluateByProvider": false,
            "validValueSet": [],
            "nameSpace": "servicestatus"
        }
    }
}

GET: Current CMX Image Version

Description

This API returns the current version of the CMX Image.

HTTP Method

GET

Resource URI

/api/config/v1/version/image

Requires OAuth

N

Parameters

None.

Content Type

application/json

Sample Output (JSON)

{
    "cmx_image_version": "CISCO_CMX-10.4.0-93.cmx",
    "cmx_rpm_versions": [
        "cisco_cmx_connect-10.4.0-18",
        "cisco_cmx_wips-10.2.0-96",
        "cisco_cmx-10.4.0-1234"
    ]
}

GET: Count of Active Alerts

Description

This API returns a count of active alerts.

HTTP Method

GET

Resource URI

/api/config/v1/alerts/count

Requires OAuth

N

Parameters

None.

Content Type

application/json

GET: All Alerts

Description

This API returns all active alerts.

HTTP Method

GET

Resource URI

/api/config/v1/alerts

Requires OAuth

N

Parameters

None.

Content Type

application/json

Sample Output (JSON)

[
  {
    "changedOn": 1490159411911,
    "tenantId": 0,
    "lastNotificationTime": 1490159411918,
    "hashkey": -1446685026,
    "alertType": "NMSP_CONNECTION_STATUS",
    "alertStatus": "Unhandled",
    "severity": "Critical",
    "origin": "cmx-vmdev83 WLC: 10.32.168.50",
    "source": "NMSPLB",
    "alarmDescription": "NMSP connection status is inactive for WLC 10.32.168.50",
    "lastEmail": 0,
    "refId": "NMSPLB"
  }
]

POST: Add Role to User

Description

This API adds a role to a user.

HTTP Method

POST

Resource URI

/api/config/v1/aaa/users/:username/role/:rolename

Requires Basic Auth

N

Parameters

Table 1. Parameter Details

Name

Required

Default

Type

Location

Description

username

Y

—

String

pathReplace

Username of the user.

rolename

Y

—

String

pathReplace

Role name to be added to the user.

Content Type

application/json

DELETE: Role from User

Description

Remove role from a user.

HTTP Method

DELETE

Resource URI

/api/config/v1/aaa/users/:username/role/:rolename

Requires OAuth

N

Parameters

Table 2. Parameter Details

Name

Required

Default

Type

Location

Description

username

Y

—

String

pathReplace

Username of user.

rolename

Y

—

String

pathReplace

Role name that needs to be deleted from this user.

Content Type

application/json

GET: All Users in the System

Description

This API gets the details of all users in the system.

HTTP Method

GET

Resource URI

/api/config/v1/aaa/users

Requires Basic Auth

N

Parameters

None.

Content Type

application/json

Sample Output

[
    {
        "id": 1,
        "username": "admin",
        "password": "*****",
        "firstname": "Admin",
        "lastname": "User",
        "userGroups": [],
        "roles": [
            {
                "id": 9,
                "name": "Admin",
                "privileges": []
            }
        ],
        "developerkey": "xjPksHwUQm6bUdITCymREKaoShqB2HPQ",
        "lastlogin": 1519852131789
    }
]

POST: Create a User

Description

This API enables you to create a user.

HTTP Method

POST

Resource URI

/api/config/v1/aaa/users

Requires Basic Auth

N

Parameters

Table 3. Parameter Details

Name

Required

Default

Type

Location

Description

___username

Y

—

string

body

Username of the user.

password

Y

—

string

body

Password of the user.

firstname

N

—

string

body

First name of the user.

lastname

N

—

string

body

Last name of the user.

roles

N

—

text

body

Roles for this user.

developerkey

N

—

string

body

CMX API Developer Key.

lastlogin

N

—

text

body

User's last login.

Content Type

application/json

POST: Modify User

Description

This API modifies the attributes of a user.

HTTP Method

POST

Resource URI

/api/config/v1/aaa/users/:username

Requires Basic Auth

N

Parameters

Table 4. Parameter Details

Name

Required

Default

Type

Location

Description

username

Y

—

String

pathReplace

Username name of the user

___username

Y

—

string

body

Username of the user.

password

Y

—

string

body

Password of the user.

firstname

N

—

string

body

First name of the user.

lastname

N

—

string

body

Last name of the user.

roles

N

—

text

body

Roles assigned to this user.

developerkey

N

—

string

body

CMX API Developer Key.

lastlogin

N

—

text

body

User's Last Login.

Content Type

application/json

GET: User by Username

Description

This API retrives user by username.

HTTP Method

GET

Resource URI

/api/config/v1/aaa/users/:username

Requires Basic Auth

N

Parameters

Table 5. Parameter Details

Name

Required

Default

Type

Location

Description

username

Y

—

String

pathReplace

Username

Content Type

application/json

Sample Output (JSON)

10.30.114.188/api/config/v1/aaa/users/admin

{
    "id": 102,
    "username": "mika",
    "password": "*****",
    "firstname": "mika",
    "lastname": "mika",
    "userGroups": [],
    "roles": [
        {
            "id": 5,
            "name": "Read Only",
            "privileges": []
        }
    ],
    "developerkey": null,
    "lastlogin": 1507596970322
}

DELETE: User by Username

Description

This API deletes a user.

HTTP Method

DELETE

Resource URI

/api/config/v1/aaa/users/:username

Requires Basic Auth

N

Parameters

Table 6. Parameter Details

Name

Required

Default

Type

Location

Description

username

Y

—

String

pathReplace

Username.

Content Type

application/json

GET: All Roles

Description

This API gets all roles.

HTTP Method

GET

Resource URI

/api/config/v1/aaa/roles

Requires Basic Auth

N

Parameters

None.

Content Type

application/json

Sample Output (JSON)

[
    {
        "id": 1,
        "name": "System",
        "privileges": []
    },
    {
        "id": 2,
        "name": "Manage",
        "privileges": []
    },
    {
        "id": 3,
        "name": "Analytics",
        "privileges": []
    },
    {
        "id": 4,
        "name": "Connect",
        "privileges": []
    },
    {
        "id": 7,
        "name": "Location",
        "privileges": []
    },
    {
        "id": 8,
        "name": "ConnectExperience",
        "privileges": []
    },
    {
        "id": 9,
        "name": "Admin",
        "privileges": []
    },
    {
        "id": 5,
        "name": "Read Only",
        "privileges": []
    }
]

GET: All Campuses

Description

This API gets information about all campuses.

HTTP Method

GET

Resource URI

/api/config/v1/campuses

Requires OAuth

N

Parameters

None.

Content Type

application/json

GET: Campus by Name

Description

This API returns a campus by name.

HTTP Method

GET

Resource URI

/api/config/v1/campuses/:name

Requires OAuth

N

Parameters

Table 7. Parameter Details

Name

Required

Default

Type

Location

Description

name

Y

—

String

pathReplace

Campus Name .

Content Type

application/json

PUT: Add Campus

Description

This API enables you to add a campus.

HTTP Method

PUT

Resource URI

/api/config/v1/campuses

Requires OAuth

N

Parameters

Table 8. Parameter Details

Name

Required

Default

Type

Location

Description

objectVersion

N

—

number

body

objectVersion

name

Y

—

string

body

Name of the campus. This value should be unique.

dimension

N

—

text

body

Dimension

image

N

—

text

body

image

buildingList

N

—

text

body

List of buildings inside the campus.

aesUid

N

—

number

body

aesUid

aesUidString

N

—

string

body

aesUidString

members

N

—

text

body

members

Content Type

application/json

GET: Count of All Map Elements

Description

This API provides count of campuses, buildings, and floors.

HTTP Method

GET

Resource URI

/api/config/v1/maps/count

Requires OAuth

N

Parameters

None.

Content Type

application/json

Sample Output (JSON)

{
    "totalCampuses": 2,
    "totalBuildings": 3,
    "totalFloors": 8,
    "totalAps": 158,
    "campusCounts": [
        {
            "campusName": "Nortech Campus",
            "totalBuildings": 1,
            "buildingCounts": [
                {
                    "buildingName": "Nortech-1",
                    "totalFloors": 1,
                    "floorCounts": [
                        {
                            "floorName": "1st Floor",
                            "apCount": 14
                        }
                    ]
                }
            ]
        },
        {
            "campusName": "System Campus",
            "totalBuildings": 2,
            "buildingCounts": [
                {
                    "buildingName": "SJC23",
                    "totalFloors": 3,
                    "floorCounts": [
                        {
                            "floorName": "1st floor (CCW remodel)",
                            "apCount": 25
                        },
                        {
                            "floorName": "2nd floor (CCW remodel)",
                            "apCount": 25
                        },
                        {
                            "floorName": "3rd floor (CCW remodel)",
                            "apCount": 24
                        }
                    ]
                },
                {
                    "buildingName": "SJC24",
                    "totalFloors": 4,
                    "floorCounts": [
                        {
                            "floorName": "2nd floor (CCW remodel)",
                            "apCount": 21
                        },
                        {
                            "floorName": "2nd floor (Area Addition)",
                            "apCount": 0
                        },
                        {
                            "floorName": "3rd floor (CCW remodel)",
                            "apCount": 24
                        },
                        {
                            "floorName": "1st floor (CCW remodel)",
                            "apCount": 25
                        }
                    ]
                }
            ]
        }
    ]
}

GET: List of all Building Names.

Description

This API provides a list of all buildings.

HTTP Method

GET

Resource URI

/api/config/v1/maps/building/list/:name

Requires Basic Auth

N

Parameters

Table 9. Parameter Details

Name

Required

Default

Type

Location

Description

name

Y

—

String

pathReplace

Campus Name

Content Type

application/json

API History

Table 10. API History

Release

Modification

Cisco CMX Release 10.4

This API is introduced.

GET: List of all Building Names

Description

This API provides a list of all buildings.

HTTP Method

GET

Resource URI

/api/config/v1/maps/building/list

Requires Basic Auth

N

Parameters

None.

Content Type

application/json

Sample Output (JSON)

[
    "Nortech Campus>Nortech-1",
    "System Campus>SJC24",
    "System Campus>SJC23"
]

API History

Table 11. API History

Release

Modification

Cisco CMX Release 10.4

This API is introduced.

GET: List of all Floor Names

Description

This API provides a list of all Floors in the system.

HTTP Method

GET

Resource URI

/api/config/v1/maps/floor/list/:name

Requires Basic Auth

N

Parameters

Table 12. Parameter Details

Name

Required

Default

Type

Location

Description

name

Y

—

String

pathReplace

Building Name

Content Type

application/json

API History

Table 13. API History

Release

Modification

Cisco CMX Release 10.4

This API is introduced.

GET: List of all Floor Names

Description

This API provides a list of all floors in the system.

HTTP Method

GET

Resource URI

/api/config/v1/maps/floor/list

Requires Basic Auth

N

Parameters

None.

Content Type

application/json

Sample Output (JSON)

[
    "System Campus>SJC23>3rd floor (CCW remodel)",
    "System Campus>SJC23>2nd floor (CCW remodel)",
    "Nortech Campus>Nortech-1>1st Floor",
    "System Campus>SJC23>1st floor (CCW remodel)",
    "System Campus>SJC24>2nd floor (CCW remodel)",
    "System Campus>SJC24>3rd floor (CCW remodel)",
    "System Campus>SJC24>2nd floor (Area Addition)",
    "System Campus>SJC24>1st floor (CCW remodel)"
]

API History

Table 14. API History

Release

Modification

Cisco CMX Release 10.4

This API is introduced.

GET: All Maps

Description

This API returns all maps.

HTTP Method

GET

Resource URI

/api/config/v1/maps

Requires OAuth

N

Parameters

None.

Content Type

application/json

Sample Output (JSON)


{
    "version": 0,
    "campuses": [
        {
            "objectVersion": 0,
            "name": "System Campus",
            "dimension": {
                "length": 99999,
                "width": 99999,
                "height": 99999,
                "offsetX": 0,
                "offsetY": 0,
                "unit": "FEET"
            },
            "image": null,
            "buildingList": [
                {
                    "aesUid": -6105692415270583000,
                    "objectVersion": 0,
                    "name": "SJC23",
                    "dimension": {
                        "length": 300,
                        "width": 500,
                        "height": 10,
                        "offsetX": 0,
                        "offsetY": 0,
                        "unit": "FEET"
                    },
                    "image": null,
                    "floorList": [
                        {
                            "aesUid": -5970502993869536000,
                            "calibrationModelId": -5970502993867530000,
                            "objectVersion": 0,
                            "name": "1st floor (CCW remodel)",
                            "dimension": {
                                "length": 249.9,
                                "width": 299.9,
                                "height": 10,
                                "offsetX": 0,
                                "offsetY": 0,
                                "unit": "FEET"
                            },
                            "isOutdoor": false,
                            "floorNumber": 1,
                            "image": {
                                "imageName": "cadConversion_1463400556649_f.jpg",
                                "zoomLevel": 5,
                                "width": 3276,
                                "height": 2715,
                                "size": 3276,
                                "maxResolution": 16,
                                "colorDepth": 8
                            },
                            "gpsMarkers": null,
                            "zones": null,
                            "obstacles": [
                                {
                                    "type": "THICK_WALL",
                                    "attenuation": 0,
                                    "obstacleCoordinates": [
                                        {
                                            "x": 2.0488472,
                                            "y": 3.2261696,
                                            "z": 0,
                                            "unit": "FEET"
                                        },
                                        {
                                            "x": 2.561059,
                                            "y": 236.22719,
                                            "z": 0,
                                            "unit": "FEET"
                                        }
                                    ]
                                },
                                {
                                    "type": "NORMAL_WALL",
                                    "attenuation": 0,
                                    "obstacleCoordinates": [
                                        {
                                            "x": 91.68591,
                                            "y": 233.66675,
                                            "z": 0,
                                            "unit": "FEET"
                                        },
                                        {
                                            "x": 93.73476,
                                            "y": 212.15895,
                                            "z": 0,
                                            "unit": "FEET"
                                        }
                                    ]
                                }
                            ],
                            "accessPoints": [
                                {
                                    "floorId": -5970502993869536000,
                                    "angle": 1.57,
                                    "apType": 2,
                                    "switchName": null,
                                    "name": "sjc23-11-cap1",
                                    "radioMacAddress": "00:42:68:a2:2a:80",
                                    "ethMacAddress": null,
                                    "ipAddress": null,
                                    "numOfSlots": 2,
                                    "mapCoordinates": {
                                        "x": 12.216251,
                                        "y": 13.826434,
                                        "z": 10,
                                        "unit": "FEET"
                                    },
                                    "apMode": "LOCAL",
                                    "apInterfaces": [
                                        {
                                            "band": "IEEE_802_11_B",
                                            "slotNumber": 0,
                                            "channelAssignment": 1,
                                            "channelNumber": 1,
                                            "txPowerLevel": 8,
                                            "antennaPattern": "Internal-3700-2.4GHz",
                                            "antennaAngle": 1.5707964,
                                            "antennaElevAngle": 0,
                                            "antennaGain": 8,
                                            "antennaDiversity": 3,
                                            "antennaMode": 1,
                                            "antennaType": 1,
                                            "txPowerControl": 1,
                                            "unit": "RADIAN",
                                            "dualBandSlot": false
                                        },
                                        {
                                            "band": "IEEE_802_11_A",
                                            "slotNumber": 1,
                                            "channelAssignment": 1,
                                            "channelNumber": 36,
                                            "txPowerLevel": 3,
                                            "antennaPattern": "Internal-3700-5GHz",
                                            "antennaAngle": 1.5707964,
                                            "antennaElevAngle": 0,
                                            "antennaGain": 8,
                                            "antennaDiversity": 3,
                                            "antennaMode": 1,
                                            "antennaType": 1,
                                            "txPowerControl": 1,
                                            "unit": "RADIAN",
                                            "dualBandSlot": false
                                        }
                                    ],
                                    "floorIdString": "-5970502993869536658",
                                    "geoCoordinate": null,
                                    "deviceDetails": null
                                },
                                {
                                    "floorId": -5970502993869536000,
                                    "angle": 1.57,
                                    "apType": 2,
                                    "switchName": null,
                                    "name": "sjc23-11-cap10",
                                    "radioMacAddress": "00:42:68:ae:2c:20",
                                    "ethMacAddress": null,
                                    "ipAddress": null,
                                    "numOfSlots": 2,
                                    "mapCoordinates": {
                                        "x": 22.229992,
                                        "y": 100.062416,
                                        "z": 10,
                                        "unit": "FEET"
                                    },
                                    "apMode": "LOCAL",
                                    "apInterfaces": [
                                        {
                                            "band": "IEEE_802_11_B",
                                            "slotNumber": 0,
                                            "channelAssignment": 1,
                                            "channelNumber": 1,
                                            "txPowerLevel": 8,
                                            "antennaPattern": "Internal-3700-2.4GHz",
                                            "antennaAngle": 1.5707964,
                                            "antennaElevAngle": 0,
                                            "antennaGain": 8,
                                            "antennaDiversity": 3,
                                            "antennaMode": 1,
                                            "antennaType": 1,
                                            "txPowerControl": 1,
                                            "unit": "RADIAN",
                                            "dualBandSlot": false
                                        },
                                        {
                                            "band": "IEEE_802_11_A",
                                            "slotNumber": 1,
                                            "channelAssignment": 1,
                                            "channelNumber": 64,
                                            "txPowerLevel": 4,
                                            "antennaPattern": "Internal-3700-5GHz",
                                            "antennaAngle": 1.5707964,
                                            "antennaElevAngle": 0,
                                            "antennaGain": 8,
                                            "antennaDiversity": 3,
                                            "antennaMode": 1,
                                            "antennaType": 1,
                                            "txPowerControl": 1,
                                            "unit": "RADIAN",
                                            "dualBandSlot": false
                                        }
                                    ],
                                    "floorIdString": "-5970502993869536658",
                                    "geoCoordinate": null,
                                    "deviceDetails": null
                                }
                                    ],
                                    "floorIdString": "-5970502993869536658",
                                    "geoCoordinate": null,
                                    "deviceDetails": null
                                }
                            ],
                            "referenceMarkers": null,
                            "exciters": null,
                            "filterRegions": [
                                {
                                    "regionType": "OUTSIDE",
                                    "regionCoordinates": [
                                        {
                                            "x": 0,
                                            "y": 0,
                                            "z": 0,
                                            "unit": "FEET"
                                        },
                                        {
                                            "x": 299.9,
                                            "y": 0,
                                            "z": 0,
                                            "unit": "FEET"
                                        },
                                        {
                                            "x": 299.9,
                                            "y": 249.9,
                                            "z": 0,
                                            "unit": "FEET"
                                        },
                                        {
                                            "x": 0,
                                            "y": 249.9,
                                            "z": 0,
                                            "unit": "FEET"
                                        }
                                    ],
                                    "isDefault": false
                                }
                            ],
                            "filterRails": null,
                            "hierarchyName": "System Campus>SJC23>1st floor (CCW remodel)",
                            "aesUidString": "-5970502993869536658",
                            "geoLocationCapable": "NO_GPS_MARKERS_PRESENT",
                            "mode": null,
                            "floorModeDetails": {
                                "mode": "RSSI",
                                "requestedModeSet": false
                            }
                        }
            ],
            "aesUid": 727035700041482200,
            "aesUidString": "727035700041482262",
            "members": null
        }
    ]
}

GET: Campus by Name

Description

This API returns a campus by name.

HTTP Method

GET

Resource URI

/api/config/v1/maps/info/:campusName

Requires OAuth

N

Parameters

Table 15. Parameter Details

Name

Required

Default

Type

Location

Description

campusName

Y

—

String

pathReplace

Campus Name

Content Type

application/json

GET: Building by Name Inside Specific Campus

Description

This API returns a building by name.

HTTP Method

GET

Resource URI

/api/config/v1/maps/info/:campusName/:buildingName

Requires OAuth

N

Parameters

Table 16. Parameter Details

Name

Required

Default

Type

Location

Description

campusName

Y

—

String

pathReplace

Campus Name.

buildingName

Y

—

String

pathReplace

Building Name.

Content Type

application/json

GET: Floor Inside Specific Building and Specific Campus

Description

This API returns a floor by name based on a specific building and campus.

HTTP Method

GET

Resource URI

/api/config/v1/maps/info/:campusName/:buildingName/:floorName

Requires OAuth

N

Parameters

Table 17. Parameter Details

Name

Required

Default

Type

Location

Description

campusName

Y

—

String

pathReplace

Campus Name.

buildingName

Y

—

String

pathReplace

Building Name.

floorName

Y

—

String

pathReplace

Floor Name.

Content Type

application/json

GET: Floor Image

Description

This API returns an image for a given combination of campus, building, and floor name.

HTTP Method

GET

Resource URI

/api/config/v1/maps/image/:campusName/:buildingName/:floorName

Requires Basic Auth

N

Parameters

Table 18. Parameter Details

Name

Required

Default

Type

Location

Description

campusName

Y

—

String

pathReplace

Campus Name.

buildingName

Y

—

String

pathReplace

Building Name.

floorName

Y

—

String

pathReplace

Floor Name.

Content Type

application/json

GET: Image by Name

Description

This API returns an image by image name.

HTTP Method

GET

Resource URI

/api/config/v1/maps/imagesource/:imageName

Requires OAuth

N

Parameters

Table 19. Parameter Details

Name

Required

Default

Type

Location

Description

imageName

Y

—

String

pathReplace

Image Name.

Content Type

application/json

GET: All Sites

Description

This API returns all the presence sites.

HTTP Method

GET

Resource URI

/api/config/v1/sites

Requires OAuth

N

Parameters

None.

Content Type

application/json

Example

[{"changedOn":0,"aesUId":1487056035936,"name":"PSL NOC","description":null,"aps":[],"rssiThresholdLow":-95,"rssiThresholdHigh":-65,"examinePeriod":900000,"minDuration":300000,"tags":null,"apCount":3,"timezone":"Asia/Kolkata","aesUidString":"1487056035936","tagList":null,"address":"Nagpur","latitude":0.0,"longitude":0.0,"applyExclusion":false,"exclusionParams":null,"currentTime":"Feb 28, 2017 3:37:50 PM","objectVersion":0},{"changedOn":0,"aesUId":1487260407843,"name":"NOC","description":null,"aps":[],"rssiThresholdLow":-95,"rssiThresholdHigh":-65,"examinePeriod":900000,"minDuration":300000,"tags":null,"apCount":1,"timezone":"Asia/Kolkata","aesUidString":"1487260407843","tagList":null,"address":"Nagpur","latitude":0.0,"longitude":0.0,"applyExclusion":false,"exclusionParams":null,"currentTime":"Feb 28, 2017 3:37:50 PM","objectVersion":0}]

GET: Site Details by ID or Name

Description

This API returns the presence site for the specified ID or Name.

HTTP Method

GET

Resource URI

/api/config/v1/sites/:id

Requires OAuth

N

Parameters

None.

Content Type

application/json

GET: System Settings Preferences

Description

This API retreives system settings.

HTTP Method

GET

Resource URI

/api/config/v1/system/preferences/:component/:key

Requires OAuth

N

Parameters

Table 20. Parameter Details

Name

Required

Default

Type

Location

Description

component

Y

—

String

pathReplace

The component.

key

N

—

String

pathReplace

The key to retrieve. If not set, retrieves all keys for the given component.

Content Type

application/json

PUT: System Settings

Description

This API enable you to store system settings. This operation can only be performed by users in the 'Admin' group.

HTTP Method

PUT

Resource URI

/api/config/v1/system/preferences/:component/:key

Requires OAuth

N

Parameters

Table 21. Parameter Details

Name

Required

Default

Type

Location

Description

component

Y

—

String

pathReplace

The component.

key

Y

—

String

pathReplace

The key.

String

Y

—

string

body

Value.

Content Type

application/json

GET: All Notification Subscriptions

Description

This API returns all notification subscriptions.

HTTP Method

GET

Resource URI

/api/config/v1/notifications

Requires OAuth

N

Parameters

None.

Content Type

application/json

Sample Output (JSON)

[
    {
        "name": "operational-insights-tag",
        "userId": "admin",
        "rules": [
            {
                "conditions": [
                    {
                        "condition": "locationupdate.deviceType == tag"
                    }
                ]
            }
        ],
        "subscribers": [
            {
                "receivers": [
                    {
                        "uri": "https://opinsights.cisco.com:443/api/am/v1/events",
                        "messageFormat": "JSON",
                        "headers": {
                            "Authorization": "JWT eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0ZW5hbnRJZCI6NCwibG9jYXRpb25FbmdpbmUiOjEsImlhdCI6MTUxMTkwOTkzMSwiYXVkIjoiTm90aWZpY2F0aW9uIiwianRpIjoiNjkzMzI0MzZjM2NlMTM4Zjc4ZWRiMzQ5OWI3NmRhZjVhYTVhOGM0NS00LTEifQ.VNWG1XCcMcbLFIDRqPnwtfcA8v2qTdiWbWaRPcNXno4"
                        },
                        "qos": "AT_MOST_ONCE"
                    }
                ]
            }
        ],
        "enabled": true,
        "internal": true,
        "cloud": true,
        "enableMacScrambling": false,
        "macScramblingSalt": "",
        "notificationType": "LocationUpdate"
    },
    {
        "name": "gateway-blemgmtadmin-feedback-io89bg",
        "userId": "local-user",
        "rules": [
            {
                "conditions": []
            }
        ],
        "subscribers": [
            {
                "receivers": [
                    {
                        "uri": "https://ce2rfd8puk.execute-api.us-west-2.amazonaws.com:443/stage/listener/5f5967a8-a0df-4674-92d5-86510ce72cc3?cmxidentifier=a1991c30-8cfd-11e7-b51c-bb23d688f84b",
                        "messageFormat": "JSON",
                        "headers": null,
                        "qos": "AT_MOST_ONCE"
                    }
                ]
            }
        ],
        "enabled": true,
        "internal": true,
        "cloud": true,
        "enableMacScrambling": false,
        "macScramblingSalt": "",
        "notificationType": "LodestarConfigUpdate"
    },
    {
        "name": "gateway-blemanager.cmxcis.co-feedback-io89bg",
        "userId": "local-user",
        "rules": [
            {
                "conditions": []
            }
        ],
        "subscribers": [
            {
                "receivers": [
                    {
                        "uri": "https://io89bg.cmxcis.co:443/api/vble/v1/beacon/xy?jwttoken=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0ZW5hbnRJZCI6ImlvODliZyJ9.09iVoaTFI7NdIUwHq2ULbZ6lGUD9zU0J9gBBAmYdNJg",
                        "messageFormat": "JSON",
                        "headers": null,
                        "qos": "AT_MOST_ONCE"
                    }
                ]
            }
        ],
        "enabled": true,
        "internal": true,
        "cloud": true,
        "enableMacScrambling": false,
        "macScramblingSalt": "",
        "notificationType": "LodestarConfigUpdate"
    },
    {
        "name": "Harvey Updates",
        "userId": "admin",
        "rules": [
            {
                "conditions": []
            }
        ],
        "subscribers": [
            {
                "receivers": [
                    {
                        "uri": "http://54.203.15.211:9094/api/v1/notify",
                        "messageFormat": "JSON",
                        "headers": null,
                        "qos": "AT_MOST_ONCE"
                    }
                ]
            }
        ],
        "enabled": true,
        "internal": false,
        "cloud": false,
        "enableMacScrambling": false,
        "macScramblingSalt": "",
        "notificationType": "LocationUpdate"
    },
    {
        "name": "gateway-blemanager.cmxcis.co-mapChange-io89bg",
        "userId": "local-user",
        "rules": [
            {
                "conditions": []
            }
        ],
        "subscribers": [
            {
                "receivers": [
                    {
                        "uri": "https://io89bg.cmxcis.co:443/api/vble/v1/beacon/xy?jwttoken=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0ZW5hbnRJZCI6ImlvODliZyJ9.09iVoaTFI7NdIUwHq2ULbZ6lGUD9zU0J9gBBAmYdNJg",
                        "messageFormat": "JSON",
                        "headers": null,
                        "qos": "AT_MOST_ONCE"
                    }
                ]
            }
        ],
        "enabled": true,
        "internal": true,
        "cloud": true,
        "enableMacScrambling": false,
        "macScramblingSalt": "",
        "notificationType": "NetworkDesignChanged"
    },
    {
        "name": "CMX_Api_Server_Notification_1",
        "userId": "admin",
        "rules": [
            {
                "conditions": [
                    {
                        "condition": "locationupdate.deviceType == client"
                    }
                ]
            }
        ],
        "subscribers": [
            {
                "receivers": [
                    {
                        "uri": "http://127.0.0.1:9094/api/notify/v1/location",
                        "messageFormat": "JSON",
                        "headers": null,
                        "qos": "AT_MOST_ONCE"
                    }
                ]
            }
        ],
        "enabled": true,
        "internal": true,
        "cloud": false,
        "enableMacScrambling": false,
        "macScramblingSalt": "",
        "notificationType": "LocationUpdate"
    },
    {
        "name": "Nbound Notification",
        "userId": "admin",
        "rules": [
            {
                "conditions": [
                    {
                        "condition": "locationupdate.deviceType == client"
                    }
                ]
            }
        ],
        "subscribers": [
            {
                "receivers": [
                    {
                        "uri": "https://data.cmxappsandbox.com:443/api/sdk/v1/notifications",
                        "messageFormat": "JSON",
                        "headers": {
                            "x-jwt-token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ0ZW5hbnRpZCI6MTUsInRlbmFudElkIjoxNX0.2S28kXWDSg-GPNfpTxYCKuI_ZnvHLR0oN9XLl9DaRm4",
                            "Content-Type": "application/json"
                        },
                        "qos": "AT_MOST_ONCE"
                    }
                ]
            }
        ],
        "enabled": true,
        "internal": false,
        "cloud": false,
        "enableMacScrambling": false,
        "macScramblingSalt": "secret",
        "notificationType": "LocationUpdate"
    },
    {
        "name": "gateway-blemgmtadmin-bleinfo-io89bg",
        "userId": "local-user",
        "rules": [
            {
                "conditions": [
                    {
                        "condition": "bletagupdate.isBle == true"
                    },
                    {
                        "condition": "bletagupdate.deviceType == tag"
                    }
                ]
            }
        ],
        "subscribers": [
            {
                "receivers": [
                    {
                        "uri": "https://ce2rfd8puk.execute-api.us-west-2.amazonaws.com:443/stage/listener/5f5967a8-a0df-4674-92d5-86510ce72cc3?cmxidentifier=a1991c30-8cfd-11e7-b51c-bb23d688f84b",
                        "messageFormat": "JSON",
                        "headers": null,
                        "qos": "AT_MOST_ONCE"
                    }
                ]
            }
        ],
        "enabled": true,
        "internal": true,
        "cloud": true,
        "enableMacScrambling": false,
        "macScramblingSalt": "",
        "notificationType": "BleTagUpdate"
    },
    {
        "name": "gateway-blemgmtadmin-mapChange-io89bg",
        "userId": "local-user",
        "rules": [
            {
                "conditions": []
            }
        ],
        "subscribers": [
            {
                "receivers": [
                    {
                        "uri": "https://ce2rfd8puk.execute-api.us-west-2.amazonaws.com:443/stage/listener/5f5967a8-a0df-4674-92d5-86510ce72cc3?cmxidentifier=a1991c30-8cfd-11e7-b51c-bb23d688f84b",
                        "messageFormat": "JSON",
                        "headers": null,
                        "qos": "AT_MOST_ONCE"
                    }
                ]
            }
        ],
        "enabled": true,
        "internal": true,
        "cloud": true,
        "enableMacScrambling": false,
        "macScramblingSalt": "",
        "notificationType": "NetworkDesignChanged"
    },
    {
        "name": "gateway-blemanager.cmxcis.co-bleinfo-io89bg",
        "userId": "local-user",
        "rules": [
            {
                "conditions": [
                    {
                        "condition": "bletagupdate.isBle == true"
                    },
                    {
                        "condition": "bletagupdate.deviceType == tag"
                    }
                ]
            }
        ],
        "subscribers": [
            {
                "receivers": [
                    {
                        "uri": "https://io89bg.cmxcis.co:443/api/vble/v1/beacon/xy?jwttoken=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0ZW5hbnRJZCI6ImlvODliZyJ9.09iVoaTFI7NdIUwHq2ULbZ6lGUD9zU0J9gBBAmYdNJg",
                        "messageFormat": "JSON",
                        "headers": null,
                        "qos": "AT_MOST_ONCE"
                    }
                ]
            }
        ],
        "enabled": true,
        "internal": true,
        "cloud": true,
        "enableMacScrambling": false,
        "macScramblingSalt": "",
        "notificationType": "BleTagUpdate"
    },
    {
        "name": "CMX_Api_Server_Notification_2",
        "userId": "admin",
        "rules": [
            {
                "conditions": []
            }
        ],
        "subscribers": [
            {
                "receivers": [
                    {
                        "uri": "http://127.0.0.1:9094/api/notify/v1/absence",
                        "messageFormat": "JSON",
                        "headers": null,
                        "qos": "AT_MOST_ONCE"
                    }
                ]
            }
        ],
        "enabled": true,
        "internal": true,
        "cloud": false,
        "enableMacScrambling": false,
        "macScramblingSalt": "",
        "notificationType": "Absence"
    },
    {
        "name": "PythonAW",
        "userId": "admin",
        "rules": [
            {
                "conditions": [
                    {
                        "condition": "locationupdate.macAddressList == 98:07:2d:8d:75:e8;"
                    },
                    {
                        "condition": "locationupdate.deviceType == tag"
                    }
                ]
            }
        ],
        "subscribers": [
            {
                "receivers": [
                    {
                        "uri": "http://dsladden.pythonanywhere.com:80",
                        "messageFormat": "JSON",
                        "headers": null,
                        "qos": "AT_MOST_ONCE"
                    }
                ]
            }
        ],
        "enabled": true,
        "internal": false,
        "cloud": false,
        "enableMacScrambling": false,
        "macScramblingSalt": "",
        "notificationType": "LocationUpdate"
    },
    {
        "name": "PythonAWN",
        "userId": "admin",
        "rules": [
            {
                "conditions": []
            }
        ],
        "subscribers": [
            {
                "receivers": [
                    {
                        "uri": "http://taibrahi.pythonanywhere.com:80",
                        "messageFormat": "JSON",
                        "headers": null,
                        "qos": "AT_MOST_ONCE"
                    }
                ]
            }
        ],
        "enabled": false,
        "internal": false,
        "cloud": false,
        "enableMacScrambling": true,
        "macScramblingSalt": "",
        "notificationType": "NetworkDesignChanged"
    },
    {
        "name": "HeaderDone",
        "userId": "admin",
        "rules": [
            {
                "conditions": []
            }
        ],
        "subscribers": [
            {
                "receivers": [
                    {
                        "uri": "http://10.41.32.235:8000",
                        "messageFormat": "JSON",
                        "headers": null,
                        "qos": "AT_MOST_ONCE"
                    }
                ]
            }
        ],
        "enabled": false,
        "internal": false,
        "cloud": false,
        "enableMacScrambling": false,
        "macScramblingSalt": "",
        "notificationType": "LocationUpdate"
    }
]

GET: Notifications by Name

Description

This API returns a notification subscription by name.

HTTP Method

GET

Resource URI

/api/config/v1/notifications/:name

Requires OAuth

N

Parameters

Table 22. Parameter Details

Name

Required

Default

Type

Location

Description

name

Y

—

String

pathReplace

Notification Name.

Content Type

application/json

GET: Notification Subscription Availability

Description

This API checks if a notification subscription exiets. It returns FOUND(302) if exists, 404 is not found.

HTTP Method

GET

Resource URI

/api/config/v1/notifications/exists/:name

Requires OAuth

N

Parameters

Table 23. Parameter Details

Name

Required

Default

Type

Location

Description

name

Y

—

String

pathReplace

Notification Name.

Content Type

application/json

PUT: Add Notification Subscription

Description

This API allows you to add a notification subscription.

HTTP Method

PUT

Resource URI

/api/config/v1/notification

Requires OAuth

N

Parameters

Table 24. Parameter Details

Name

Required

Default

Type

Location

Description

userId

Y

—

string

body

User ID.

rules

Y

—

text

body

List of rules.

subscribers

Y

—

text

body

Subscribers

notificationType

Y

—

enumerated

body

Choose one of the following notification types:

  • Any

  • Absence

  • AreaChange

  • Association

  • BatteryLife

  • Chokepoint

  • Containment

  • Emergency

  • Movement

  • Presence

  • LocationUpdate

  • Zone

  • Location

  • ServiceStatus

  • NetworkDesignChanged

  • CpuUsage

  • MemoryUsage

  • DiskUsage

  • BeaconMovement

  • BeaconAbsence

  • Update

  • InOut

  • PasserbyDetected

  • PasserbyBecameVisitor

  • VisitorWentAway

  • SiteEntryChanged

enabled

N

—

enumerated

body

enabled

  • true

  • false

enableMacScrambling

N

—

enumerated

body

enableMacScrambling

  • true

  • false

Content Type

application/json

Sample Input (JSON)

application/json

 {
        "name": "locupdate",
        "userId": "admin",
        "rules": [
            {
                "conditions": [
                    {
                        "condition": "locationupdate.macAddressList == 00:0c:cc:4f:5f:ba;00:24:d7:37:68:d8;00:24:d7:59:8f:2c;00:0b:6b:a8:56:9f;"
                    }
                ]
            }
        ],
        "subscribers": [
            {
                "receivers": [
                    {
                        "uri": "http://172.19.35.203:7123",
                        "messageFormat": "JSON",
                        "headers": null,
                        "qos": "AT_MOST_ONCE"
                    }
                ]
            }
        ],
        "enabled": true,
        "internal": false,
        "cloud": false,
        "enableMacScrambling": false,
        "macScramblingSalt": "",
        "notificationType": "LocationUpdate"
    }

PUT: List of Notification Subscriptions

Description

This API allows you to add a list of notification subscriptions.

HTTP Method

PUT

Resource URI

/api/config/v1/notifications

Requires OAuth

N

Parameters

None.

Content Type

application/json

DELETE: Notification Subscription by Notification Name

Description

This API allows you to delete a notification subscription.

HTTP Method

DELETE

Resource URI

/api/config/v1/notifications/:name

Requires OAuth

N

Parameters

Table 25. Parameter Details

Name

Required

Default

Type

Location

Description

name

Y

—

String

pathReplace

Notification Name.

Content Type

application/json

GET: System Alert Subscription

Description

This API returns a system alert notification subscription by name.

HTTP Method

GET

Resource URI

/api/config/v1/notifications/alerts

Requires OAuth

N

Parameters

None.

Content Type

application/json

Sample Output (JSON)

[
    {
        "name": "serviceIsCrashed",
        "userId": "admin",
        "rules": [
            {
                "conditions": [
                    {
                        "condition": "servicestatus.status == CRASHED"
                    }
                ]
            }
        ],
        "subscribers": [
            {
                "receivers": [
                    {
                        "uri": "local://local",
                        "messageFormat": "JSON",
                        "headers": null,
                        "qos": "AT_MOST_ONCE"
                    }
                ]
            }
        ],
        "enabled": true,
        "internal": false,
        "cloud": false,
        "enableMacScrambling": false,
        "macScramblingSalt": "",
        "severity": "Critical",
        "notificationType": "ServiceStatus"
    },
    {
        "name": "serviceIsDown",
        "userId": "admin",
        "rules": [
            {
                "conditions": [
                    {
                        "condition": "servicestatus.status == STOPPED"
                    }
                ]
            }
        ],
        "subscribers": [
            {
                "receivers": [
                    {
                        "uri": "local://local",
                        "messageFormat": "JSON",
                        "headers": null,
                        "qos": "AT_MOST_ONCE"
                    }
                ]
            }
        ],
        "enabled": true,
        "internal": false,
        "cloud": false,
        "enableMacScrambling": false,
        "macScramblingSalt": "",
        "severity": "Info",
        "notificationType": "ServiceStatus"
    }
]

GET: Notifications by Name

Description

This API returns a system alert notification subscription by name.

HTTP Method

GET

Resource URI

/api/config/v1/notifications/alerts/:name

Requires OAuth

N

Parameters

Table 26. Parameter Details

Name

Required

Default

Type

Location

Description

name

Y

—

String

pathReplace

Notification Name.

Content Type

application/json

PUT: System Alert Subscription

Description

This API allows you to add a system alert subscription.

HTTP Method

PUT

Resource URI

/api/config/v1/notifications/alert

Requires OAuth

N

Parameters

Table 27. Parameter Details

Name

Required

Default

Type

Location

Description

severity

Y

—

enumerated

body

Choose one of the following severity levels:

  • Critical

  • Major

  • Minor

  • Warning

  • Info

  • Cleared

userId

Y

—

string

body

User ID.

rules

Y

—

text

body

List of rules.

subscribers

Y

—

text

body

Subscribers

notificationType

Y

—

enumerated

body

Choose one of the following notification types:

  • Any

  • Absence

  • AreaChange

  • Association

  • BatteryLife

  • Chokepoint

  • Containment

  • Emergency

  • Movement

  • Presence

  • LocationUpdate

  • Zone

  • Location

  • ServiceStatus

  • NetworkDesignChanged

  • CpuUsage

  • MemoryUsage

  • DiskUsage

  • BeaconMovement

  • BeaconAbsence

  • Update

  • InOut

  • PasserbyDetected

  • PasserbyBecameVisitor

  • VisitorWentAway

  • SiteEntryChanged

enabled

N

—

enumerated

body

enabled

  • true

  • false

enableMacScrambling

N

—

enumerated

body

enableMacScrambling

  • true

  • false

Content Type

application/json

DELETE: Notification Alert Subscription

Description

This API allows you to delete a system alert notification subscription.

HTTP Method

DELETE

Resource URI

/api/config/v1/notifications/alerts/:name

Requires OAuth

N

Parameters

Table 28. Parameter Details

Name

Required

Default

Type

Location

Description

name

Y

—

String

pathReplace

Notification Name.

Content Type

application/json

POST: Change Status of Notification by Name

Description

This API enable/disable a notification subscription by name.

HTTP Method

POST

Resource URI

/api/config/v1/notifications/:name/:action

Requires OAuth

N

Parameters

Table 29. Parameter Details

Name

Required

Default

Type

Location

Description

name

Y

—

String

pathReplace

Notification Name.

action

Y

—

String

pathReplace

Enable/Disable

Content Type

application/json

GET: Unique Alerts by Time Interval

Description

This API returns a list of unique alerts by time interval.

HTTP Method

GET

Resource URI

/api/config/v1/history/alerts/unique

Requires Basic Auth

N

Parameters

Table 30. Parameter Details

Name

Required

Default

Type

Location

Description

startTime

Y

—

Number

query

Specifies the start time in milliseconds.

endTime

Y

—

Number

query

Specifies the end time in milliseconds.

Content Type

application/json

Table 31. API History

Release

Modification

Cisco CMX Release 10.4

This command is deprecated.

GET: Alert by Time Interval

Description

This API returns a list of alerts by time interval.

HTTP Method

GET

Resource URI

/api/config/v1/history/alerts

Requires OAuth

N

Parameters

Table 32. Parameter Details

Name

Required

Default

Type

Location

Description

startTime

Y

—

Number

query

Specifies the start time in milliseconds.

endTime

Y

—

Number

query

Specifies the end time in milliseconds.

Content Type

application/json

GET: Alerts by Time Interval and Hashkey

Description

This API returns a list of alerts by time interval and hashkey.

HTTP Method

GET

Resource URI

/api/config/v1/history/alerts/:key

Requires Basic Auth

N

Parameters

Table 33. Parameter Details

Name

Required

Default

Type

Location

Description

key

Y

—

String

pathReplace

Alert Hashkey which could be obtained by calling /config/v1/alerts.

startTime

Y

—

Number

query

Specifies the start time in milliseconds.

endTime

Y

—

Number

query

Specifies the end time in milliseconds.

Content Type

application/json

Table 34. API History

Release

Modification

Cisco CMX Release 10.4

This command is deprecated.

GET: Total Alerts Created for a Given Alert Key

Description

This API returns number of alerts for a given alert key.

HTTP Method

GET

Resource URI

/api/config/v1/history/alert/count/:key

Requires Basic Auth

N

Parameters

Table 35. Parameter Details

Name

Required

Default

Type

Location

Description

key

Y

—

String

pathReplace

Alert Hashkey which could be obtained by calling /config/v1/alerts.

Content Type

application/json

Table 36. API History

Release

Modification

Cisco CMX Release 10.4

This command is deprecated.

GET: All APs

Description

This API returns all APs.

HTTP Method

GET

Resource URI

/api/config/v1/aps

Requires OAuth

N

Parameters

None.

Content Type

application/json

GET: Access Point by MAC Address

Description

This API returns access point by given ap MAC address.

HTTP Method

GET

Resource URI

/api/config/v1/aps/:mac

Requires OAuth

N

Parameters

Table 37. Parameter Details

Name

Required

Default

Type

Location

Description

mac

Y

—

String

pathReplace

Access point MAC address.

Content Type

application/json

GET: Settings for a Given User

Description

This API retrieves settings for a given user.

HTTP Method

GET

Resource URI

/api/config/v1/user/preferences/:userid/:component/:key

Requires OAuth

N

Parameters

Table 38. Parameter Details

Name

Required

Default

Type

Location

Description

userid

Y

—

String

pathReplace

The user ID.

component

Y

—

String

pathReplace

The component.

key

N

—

String

pathReplace

The key to retrieve. If not set, retrieves all keys for the given component.

Content Type

application/json

PUT: Setting for a Given User

Description

This API stores the settings of a given user.

HTTP Method

PUT

Resource URI

/api/config/v1/user/preferences/:userid/:component/:key

Requires OAuth

N

Parameters

Table 39. Parameter Details

Name

Required

Default

Type

Location

Description

userid

Y

—

String

pathReplace

The user ID.

component

Y

—

String

pathReplace

The component.

key

Y

—

String

pathReplace

The key.

json

N

—

String

query

Whether the data passed is JSON - if set, this will validate the data and reject malformed JSON Allowed values/formats: true or false.

String

Y

—

string

body

Value

Content Type

application/json

GET: All Cisco WLC Controllers

Description

This API provides a list of all Cisco WLC Controllers.

HTTP Method

GET

Resource URI

/api/config/v1/controllers

Requires OAuth

N

Parameters

None.

Content Type

application/json

GET: Get Cisco WLC Controllers by IP address

Description

This API returns a controller given an IP address.

HTTP Method

GET

Resource URI

/api/config/v1/controllers/:ipAddress

Requires OAuth

N

Parameters

Table 40. Parameter Details

Name

Required

Default

Type

Location

Description

ipAddress

Y

—

String

pathReplace

IP Address.

Content Type

application/json

Sample Output

http://10.68.40.131/api/config/v1/controllers/10.68.40.124

{"name":null,"ipAddress":"10.68.40.124","readOnlyComm":null,"writeComm":
"iuBXuWikK4nfq52YKODcUg==","snmpVersion":1,"version":"8.1.131","userName":"admin",
"authType":0,"authPassword":null,"privType":0,"privPassword":null,"macAddress":null,
"sysUpTime":0,"unauthenticatedConnection":false,"applicableServices":[0],"aesUId":
1448982516930,"objectVersion":0,"tagNotificationInterval":0,"wlanConfigList":[],
"deviceVersion":null,"type":"WLC","enablePassword":null,"peerMode":false,"members":
null}

PUT: Controller

Description

This API allows you to add a controller.

HTTP Method

PUT

Resource URI

/api/config/v1/controllers

Requires OAuth

N

Parameters

Table 41. Parameter Details

Name

Required

Default

Type

Location

Description

name

Y

—

string

body

Name of the Wireless LAN controller.

ipAddress

Y

—

string

body

IP address of the Wireless LAN controller.

readOnlyComm

Y

—

string

body

SNMP Read Community.

writeComm

Y

—

string

body

SNMP Write Community.

snmpVersion

N

—

number

body

SNMP Version.

version

Y

—

string

body

Software version of the WLC Controller.

userName

Y

—

string

body

User name for the telnet connection.

authType

Y

—

number

body

SNMP v3 Auth Type.

authPassword

N

—

string

body

Authentication Password.

privType

N

—

number

body

Privacy Type.

privPassword

N

—

string

body

Password.

macAddress

N

—

string

body

MAC Address.

sysUpTime

N

—

number

body

System Up time.

unauthenticatedConnection

N

—

enumerated

body

Authentication to connect to the WLC Controller.

  • true

  • false

applicableServices

Y

—

array

body

Services to subscribe to the controller.

aesUId

Y

—

number

body

Cisco Prime Infrastructure generated unique ID. If not generated by Cisco Prime Infrastructure, please use a unique value.

objectVersion

N

—

number

body

Object version.

tagNotificationInterval

N

—

number

body

Tag notification interval.

wlanConfigList

N

—

text

body

WLC Controller Configuration list.

deviceVersion

N

—

string

body

Version of the device.

type

N

—

enumerated

body

type

  • WLC

  • NGWC

enablePassword

N

—

string

body

enablePassword

peerMode

N

—

enumerated

body

peerMode

  • true

  • false

members

N

—

text

body

Members.

Content Type

application/json

DELETE: All opt-out Devices

Description

This API allows to delete ALL opt-out devices from opt-out service.

HTTP Method

DELETE

Resource URI

/api/configuration/v1/optout/devices/all

Requires OAuth

N

Parameters

None.

Content Type

application/json

GET: List of Opt-out Devices Within a Date Range

Description

This API return a full list of opt-out devices within a date range.

HTTP Method

GET

Resource URI

/api/configuration/v1/optout/devices

Requires OAuth

N

Parameters

Table 42. Parameter Details

Name

Required

Default

Type

Location

Description

validFrom

N

—

String

query

Start date of range Allowed values/formats: yyyy-mm-dd hh:mm:ss

validTo

N

—

String

query

End date of range Allowed values/formats: yyyy-mm-dd hh:mm:ss

Content Type

application/json

GET: Count of opt-out Devices

Description

This API return a count of opt-out devices.

HTTP Method

GET

Resource URI

/api/configuration/v1/optout/count

Requires OAuth

N

Parameters

None.

Content Type

application/json

Sample Output

{"Opt-out Device count":0}

DELETE: Opt-out Devices Within a Date Range

Description

This API deletes opt-out devices.

HTTP Method

DELETE

Resource URI

/api/configuration/v1/optout/devices/date

Requires OAuth

N

Parameters

Table 43. Parameter Details

Name

Required

Default

Type

Location

Description

validFrom

N

—

String

query

Start date of range Allowed values/formats: yyyy-mm-dd hh:mm:ss.

validTo

N

—

String

query

End date of range Allowed values/formats: yyyy-mm-dd hh:mm:ss.

Content Type

application/json

GET: List of Children Superzone IDs of a Heterarchy Element

Description

The call retrieves children superzone IDs of a heterarchy element and, under them, the AES IDs of the nested children floors. The element is identified by the path of the API call (either the full path or the id of the element- see Add/Update zones or tags for details on obtaining the element id).

HTTP Method

GET

Resource URI

/api/config/v1/heterarchy/:pathSegments/childrenfloors

Requires Basic Auth

N

Parameters

Table 44. Parameter Details

Name

Required

Default

Type

Location

Description

pathSegments

N

—

String

pathReplace

Full path to the element or element id.

validDate

N

—

String

query

Show elements valid at given date (yyyy-mm-dd HH:mm:ss) Allowed values/formats: yyyy-mm-dd HH:mm:ss.

level

N

—

String

query

Level name (SUPERZONE, FLOOR, AP, POI, or ZONE) Allowed values/formats: SUPERZONE FLOOR AP ZONE POI.

Content Type

application/json

API History

Table 45. API History

Release

Modification

Cisco CMX Release 10.4

This API is introduced.

GET: Children Superzone IDs of Hiterarchy Element

Description

The call retrieves children superzone IDs of an heterarchy element and, under them, the counts of all the nested children elements. The element is identified by the path of the API call (either the full path or the ID of the element- see Add/Update zones or tags for details on obtaining the element id). Specifying a level retrieves only children of that level.

HTTP Method

GET

Resource URI

/api/config/v1/heterarchy/:pathSegments/childrencounts

Requires Basic Auth

N

Parameters

Table 46. Parameter Details

Name

Required

Default

Type

Location

Description

pathSegments

N

—

String

pathReplace

Full path to the element or element ID.

validDate

N

—

String

query

Show elements valid from given date (yyyy-mm-dd HH:mm:ss) Allowed values/formats: yyyy-mm-dd HH:mm:ss.

level

N

—

String

query

Level name (SUPERZONE, FLOOR, AP, POI, or ZONE) Allowed values/formats: SUPERZONE FLOOR AP ZONE POI.

Content Type

application/json

API History

Table 47. API History

Release

Modification

Cisco CMX Release 10.4

This API is introduced.

GET: Gets the System Time

Description

HTTP Method

GET

Resource URI

/api/config/v1/system/time

Requires OAuth

N

Parameters

None.

Content Type

application/json

Sample Output (JSON)

{
    "ISO8601Utils": "2017-12-18T08:56:16Z",
    "timeZoneOffset": -28800000,
    "serverTimeUTC": 1513587376429,
    "serverTime": "Mon Dec 18 00:56:16 PST 2017",
    "timeZone": "Pacific Standard Time"
}

DELETE: Removes all registered zones

Description

This API removes all registered zones.

HTTP Method

DELETE

Resource URI

/api/config/v1/zoneCountParams/:clusterId

Requires Basic Auth

N

Parameters

Table 48. Parameter Details

Name

Required

Default

Type

Location

Description

clusterId

Y

1

String

pathReplace

clusterId (default 1)

Content Type

application/json

GET: Returns All Registered Zones

Description

This API returns details of all registered zones.

HTTP Method

GET

Resource URI

/api/config/v1/zoneCountParams/:clusterId

Requires OAuth

N

Parameters

Table 49. Parameter Details

Name

Required

Default

Type

Location

Description

clusterId

Y

1

Number

pathReplace

clusterId (default 1)

Content Type

application/json

Usage Guidelines

http://<cmx-ip-address>/api/config/v1/zoneCountParams/<cluster-id>
For Example:
http://10.0.0.1/api/config/v1/zoneCountParams/1
			

Sample Output

{
name: "ZoneCountParams",
zoneHierarchy: [
"Simulator-2201-Campus0/Building2/Floor2/Zone2",
"Simulator-2201-Campus0/Building4/Floor4/Zone4",
"Simulator-2201-Campus0/Building7/Floor2/Zone3"
],
zoneIds: [ ],
zoneDetails: [
{
id: 65811,
hierarchy: "Simulator-2201-Campus0/Building2/Floor2/Zone2",
name: "Zone2",
active: true
},
{
id: 66475,
hierarchy: "Simulator-2201-Campus0/Building4/Floor4/Zone4",
name: "Zone4",
active: true
},
{
id: 67192,
hierarchy: "Simulator-2201-Campus0/Building7/Floor2/Zone3",
name: "Zone3",
active: true
}
],
totalZones: 3,
debug: false
}

POST: Add New Zone

Description

This API adds a zone to the existing list of zones. For all hierarchies, system tries to find them in the heterarchy and if the match is successful we have an ID for every zone specified. When the zone is not found, we drop that zone from the configuration.

HTTP Method

POST

Resource URI

/api/config/v1/zoneCountParams/:clusterId

Requires OAuth

N

Parameters

Table 50. Parameter Details

Name

Required

Default

Type

Location

Description

clusterId

Y

1

String

pathReplace

clusterId (default 1)

zoneHierarchy

Y

array

body

List of exact zone hierarchy separated by /, i.e. Campus/Building/Floor/Zone. (including spaces, if any of the campus / building /floor /zone has spaces in the name) Ensure zones hierarchy are nested within the square brackets [ ] to be considered as list, otherwise this operation would fail For specifying single zone, ["Campus/Building/Floor/Zone1"] For specifying multiple zones, ["Campus/Building/Floor/Zone1", "Campus/Building/Floor/Zone2"]

zoneIds

N

array

body

List of zoneids,

Ensure zoneIds are nested within the square brackets [ ] to be considered as list, otherwise this operation would fail

for e.g. single zone as [391] multiple zones as [391,392]

zoneDetails

N

text

body

Populated by API after parsing zoneHierarchy or zoneIds input

totalZones

N

number

body

Total registered zones, Populated by API after parsing zoneHierarchy or zoneIds input

debug

N

false

enumerated

body

debug flag to enable recording macaddresses for registered zones

  • true

  • false

Content Type

application/json

Sample Input (JSON)

{
"name": "ZoneCountParams",
"zoneHierarchy": ["Nortech Campus/Nortech Building/Security Floor/zone1",
"Nortech Campus/Nortech Building/Security Floor/zone2",
"System Campus/SJC-24/3rd Floor/Zone_2",
"System Campus/SJC-24/3rd Floor/Zone_1"
]
}

PUT: Add (Overwrite) New Zone

Description

This API is similar to the POST: Add New Zone API, but replaces rather than appends the new zone(s) to the resigtered zone(s) list.

HTTP Method

PUT

Resource URI

/api/config/v1/zoneCountParams/:clusterId

Requires Basic Auth

N

Parameters

Table 51. Parameter Details

Name

Required

Default

Type

Location

Description

clusterId

Y

1

String

pathReplace

clusterId (default 1)

zoneHierarchy

Y

array

body

List of exact zone hierarchy separated by /, i.e. Campus/Building/Floor/Zone. (including spaces, if any of the campus / building /floor /zone has spaces in the name)</p> Ensure zones hierarchy are nested within the square brackets [ ] to be considered as list, otherwise this operation would fail</p> For specifying single zone, ["Campus/Building/Floor/Zone1"]</p> For specifying multiple zones, ["Campus/Building/Floor/Zone1", "Campus/Building/Floor/Zone2"]</p>

zoneIds

N

array

body

List of zoneids

Ensure zoneIds are nested within the square brackets [ ] to be considered as list, otherwise this operation would fail

for e.g. single zone as [391] multiple zones as [391,392]

zoneDetails

N

text

body

Populated by API after parsing zoneHierarchy or zoneIds input

totalZones

N

number

body

Total registered zones, Populated by API after parsing zoneHierarchy or zoneIds input

debug

N

false

enumerated

body

debug flag to enable recording macaddresses for registered zones

  • true

  • false

Content Type

application/json

API History

Table 52. API History

Release

Modification

Cisco CMX Release 10.4

This API is introduced.

GET:Get All Subscriptions

Description

This API returns all subscriptions.

HTTP Method

GET

Resource URI

/config/v1/partnerStreamNotification

Requires OAuth

N

Parameters

None

Content Type

application/json

Sample Output

{
  "name": null,
  "subs": {
    "abc2": {
      "name": "abc2",
      "host": "127.0.0.1",
      "port": 8001,
      "enabled": false
    }
  },
  "lastActedSubs": [
    {
      "name": "abc2",
      "host": "127.0.0.1",
      "port": 8001,
      "enabled": false
    }
  ]
}

POST: Add or Update Subscriptions

Description

This API adds new or updates existing subscriptions. Subscriptions can not share a name. Their destinations (host+port combination) must be unique. You can have a maximum of five subscriptions (including disabled subscriptions).

HTTP Method

POST

Resource URI

/api/config/v1/partnerStreamNotification

Requires OAuth

N

Content Type

application/json

Sample Input

{"name":"abc2","host":"127.0.0.1","port":8001,"enabled":false}

Sample Output

Output is successful if the response code is 200.

DELETE: Delete All Subscriptions

Description

This API deletes a subscription.

HTTP Method

DELETE

Resource URI

/api/config/v1/partnerStreamNotification

Requires OAuth

N

Parameters

None

Content Type

application/json

Sample Input

{"name":"abc2"}

Sample Output

Output is successful if the response code is 200.

GET: Get Floors Managed by Controller

Description

This API gets a list of floors managed by Cisco WLC Controller.

HTTP Method

GET

Resource URI

/config/v1/controllers/:ipAddress/floor

Requires OAuth

N

Parameters

None

Content Type

application/json

Sample Output