Switch Manager
Overview
This reference guide describes the public APIs supported by the Switch Manager. All API URIs in this guide could use the below all common prefix, where {host} is the IP address of the management interface of the controller.
Prefix Pattern |
---|
https://{host}:8443/switchm/api |
Version Matrix
The API version would follow the SmartZone support versions, please refer to the following matrix.
SZ Version | API Version |
---|---|
6.1.2 |
v9_0 v9_1 v10_0 v11_0 v11_1 |
Common Request URI Parameters
The following parameters are required in the Request URI Parameters of all API requests (except for the logon API).
Parameter | Value |
---|---|
serviceTicket | {serviceTicket} |
serviceTicket is returned as the following parameter in the response payload of the Service Ticket Logon API of the Smart Zone.
OpenAPI documents
OpenAPI documents is based on OAS 2.0, Please try it for free.
Installed Smart Zone Software Release and link to https://{host}:8443/switchm/api/openapi for the detail.
You can get the usage at https://swagger.io/, use the Swagger tools to meet your needs.
Switch Event Management Setting ¶
Get Switch Group Switch Event E-mail Setting ¶
GET/v11_1/group/{switchGroupId}/eventEmailSettings
Get Switch Event E-mail Setting of Switch Group Override.
Headers
Content-Type: text/plain,*/*
200
Body
{
"emailEnabled": true,
"mailTo": "[email protected]"
}
Schema
{
"additionalProperties": false,
"type": "object",
"properties": {
"emailEnabled": {
"description": "Enable/Disable Email sending function",
"type": "boolean"
},
"mailTo": {
"description": "E-mail recipients",
"type": "string"
}
}
}
Get Switch Group Switch Event Notification Setting ¶
GET/v11_1/group/{switchGroupId}/eventNotificationSettings
Get Switch Event Notification Setting of Switch Group Override.
Headers
Content-Type: text/plain,*/*
200
Body
{
"success": true,
"error": null,
"data": {
"totalCount": 2,
"rawDataTotalCount": 0,
"hasMore": false,
"list": [
{
"eventCode": 20000,
"category": "Switch",
"type": "Switch Critical Message",
"severity": "Critical",
"configPageDesc": "This event occurs when there is a Switch Critical Message",
"triggerEmail": true,
"switchGroupOverride": true
},
{
"eventCode": 20001,
"category": "Switch",
"type": "Switch Alert Message",
"severity": "Major",
"configPageDesc": "This event occurs when there is a Switch Alert Message",
"triggerEmail": false,
"switchGroupOverride": false
}
]
},
"extra": null
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"success": {
"description": "The status of http request",
"type": "boolean"
},
"error": {
"description": "The error message of http request",
"type": "string"
},
"data": {
"additionalProperties": false,
"type": "object",
"properties": {
"totalCount": {
"type": "integer"
},
"hasMore": {
"type": "boolean"
},
"rawDataTotalCount": {
"type": "integer"
},
"list": {
"type": "array",
"items": {
"additionalProperties": false,
"type": "object",
"properties": {
"eventCode": {
"description": "Event code",
"type": "integer"
},
"severity": {
"description": "Event severity",
"type": "string"
},
"category": {
"description": "Event category",
"type": "string"
},
"type": {
"description": "Event type",
"type": "string"
},
"triggerEmail": {
"description": "Enable/Disable Email sending for this event",
"type": "boolean"
},
"switchGroupOverride": {
"description": "Enable/Disable override event system settings by switch group level",
"type": "boolean"
},
"configPageDesc": {
"description": "Event description",
"type": "string"
}
}
}
}
}
},
"extra": {
"description": "Extra information for event management setting",
"type": "string"
}
}
}
Modify Switch Group Switch Event E-mail Setting ¶
PUT/v11_1/group/{switchGroupId}/eventEmailSettings
Modify Switch Event E-mail Setting of Switch Group Override.
Headers
Content-Type: text/plain,*/*
Body
{
"emailEnabled": true,
"mailTo": "[email protected]"
}
Schema
{
"additionalProperties": false,
"type": "object",
"properties": {
"emailEnabled": {
"description": "Enable/Disable Email sending function",
"type": "boolean"
},
"mailTo": {
"description": "E-mail recipients",
"type": "string"
}
}
}
200
Modify Switch Group Switch Event Notification Setting ¶
PUT/v11_1/group/{switchGroupId}/eventNotificationSettings
Modify Switch Event Notification Setting of Switch Group Override.
Headers
Content-Type: text/plain,*/*
Body
[
{
"eventCode": 20000,
"triggerEmail": true,
"switchGroupOverride": true
},
{
"eventCode": 20001,
"triggerEmail": true,
"switchGroupOverride": true
}
]
Schema
{
"additionalProperties": false,
"type": "array",
"items": {
"additionalProperties": false,
"type": "object",
"properties": {
"eventCode": {
"description": "Event code",
"type": "integer"
},
"severity": {
"description": "Event severity",
"type": "string"
},
"category": {
"description": "Event category",
"type": "string"
},
"type": {
"description": "Event type",
"type": "string"
},
"triggerEmail": {
"description": "Enable/Disable Email sending for this event",
"type": "boolean"
},
"switchGroupOverride": {
"description": "Enable/Disable override event system settings by switch group level",
"type": "boolean"
},
"configPageDesc": {
"description": "Event description",
"type": "string"
}
}
}
}
200
Switch Configuration ¶
Retrieve Configuration Backup Content ¶
GET/v11_1/switchconfig/{configId}
Use this API command to retrieve configuration backup content.
200
Body
"content"
Schema
{
"type": "string"
}
Download Configuration Backup Content ¶
GET/v11_1/switchconfig/download/{configId}
Use this API command to download configuration backup content as plain text.
200
Body
"content"
Schema
{
"type": "string"
}
Get the master config backup alert ¶
GET/v11_1/switchconfig/backup/master/alert/{switchId}
Get the difference between the master backup and the latest backup of a switch
200
Body
{
"masterBackupId": "844db453-2112-42ad-b6eb-6bf5a0fd987b",
"configBackup1": {
"id": "844db453-2112-42ad-b6eb-6bf5a0fd987b",
"name": "60:9C:9F:DA:63:80-1528934400165",
"config": "ver 08.0.80b254T201\n!\nstack unit 1\n module 1 icx7750-48-xgc-port-management-module\n"
},
"configBackup2": {
"id": "69acdc88-ab7c-4007-9301-91df234bb185",
"name": "60:9C:9F:DA:63:80-1528761600156",
"config": "ver 08.0.80b207T201\n!\nstack unit 1\n module 1 icx7750-48-xgc-port-management-module\n"
}
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"masterBackupId": {
"description": "master backup ID",
"type": "string"
},
"configBackup1": {
"description": "config backup 1 ID",
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"description": "the identifier of the ConfigBackup Content",
"type": "string"
},
"name": {
"description": "Name of the ConfigBackup Content",
"type": "string"
},
"config": {
"description": "Content of the ConfigBackup",
"type": "string"
}
}
},
"configBackup2": {
"description": "config backup 2 ID",
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"description": "the identifier of the ConfigBackup Content",
"type": "string"
},
"name": {
"description": "Name of the ConfigBackup Content",
"type": "string"
},
"config": {
"description": "Content of the ConfigBackup",
"type": "string"
}
}
}
}
}
Get all master config backup alert ¶
GET/v11_1/switchconfig/backup/master/alert
Get all the differences between the master backup and the latest backup
- page
number
(optional)- limit
number
(optional)
200
Body
{
"rawDataTotalCount": 0,
"totalCount": 2,
"hasMore": false,
"firstIndex": 0,
"list": [
{
"switchId": "CC:4E:24:8B:5C:30",
"switchGroupName": "sg1"
},
{
"switchId": "CC:4E:24:8B:5C:60",
"switchGroupName": "sg2"
}
],
"extra": null
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"rawDataTotalCount": {
"description": "Total ConfigBackupInfo count",
"type": "integer"
},
"totalCount": {
"description": "Current ConfigBackupInfo count",
"type": "integer"
},
"hasMore": {
"description": "Has more data or not",
"type": "boolean"
},
"firstIndex": {
"description": "Index of first index in current page",
"type": "integer"
},
"extra": {
"description": "Extra information for config backup policy",
"type": "object",
"properties": {
"rbacMetadata": {
"type": "array",
"items": {
"additionalProperties": {
"type": "string"
},
"properties": {}
}
}
}
},
"list": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"switchId": {
"description": "switch ID",
"type": "string"
},
"switchGroupName": {
"description": "switch's group name",
"type": "string"
},
"switchName": {
"description": "switch's name",
"type": "string"
}
}
}
}
}
}
Get Config Backup List ¶
POST/v11_1/switchconfig
Use this API command to retrieve configuration backup list with specified filters.
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"filters": {
"description": "Filters used to select specific resource scope",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Group type",
"enum": [
"SYSTEM",
"CATEGORY",
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"BLADE",
"SYNCEDSTATUS",
"REGISTRATIONSTATE",
"STATUS",
"SWITCH_GROUP",
"FAMILY_ID",
"PORT",
"SWITCH_ID_PORT_IDENTIFIER",
"transactionId",
"dispatchStatus",
"configType",
"yang",
"removeYang"
],
"type": "string"
},
"value": {
"description": "Group ID",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraFilters": {
"description": "\"AND\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"SWITCH_GROUP",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"transactionId",
"hasLayerThreeConfig",
"clientAuthType",
"clientIpv4Addr",
"clientIpv6Addr",
"clientMac",
"clientUserName",
"switchName",
"ADMIN_STATUS",
"PORT_STATUS",
"POE_ENABLED",
"cliType",
"dispatchStatus",
"configType",
"yang",
"removeYang",
"reservedField1",
"FIRMWARE",
"dot1XIpv4Addr",
"dot1XIpv6Addr"
],
"type": "string"
},
"value": {
"description": "Value to search",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraNotFilters": {
"description": "\"NOT\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"switchStatus.alerts",
"switchStatus.status",
"transactionId",
"hasLayerThreeConfig",
"reservedField1",
"dispatchStatus",
"configType",
"clis",
"yang",
"removeYang",
"clientType"
],
"type": "string"
},
"value": {
"description": "Value not to search",
"type": "string"
}
}
}
},
"options": {
"description": "Specified feature required informaion",
"type": "object",
"additionalProperties": false,
"properties": {
"auth_includeNa": {
"description": "Include Not Available auth service option while returning result",
"type": "boolean"
},
"auth_includeLocalDb": {
"description": "Include LocalDB auth service while returning result",
"type": "boolean"
},
"auth_includeGuest": {
"description": "Include Guest auth service while returning result",
"type": "boolean"
},
"auth_includeAdGlobal": {
"description": "If AD is in list, include only AD with Global Catalog configured",
"type": "boolean"
},
"auth_type": {
"description": "Authentication service types to get, use comma to separate, Ex: RADIUS,AD",
"type": "string"
},
"auth_realmType": {
"description": "To get specific authentication service information for configuring realm based authentication profile",
"enum": [
"ALL",
"RADIUS"
],
"type": "string"
},
"acct_type": {
"description": "Accounting service types to get, use comma to separate, Ex: RADIUS,CGF",
"type": "string"
},
"auth_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_includeNa": {
"description": "Include Not Available acct service option while returning result",
"type": "boolean"
},
"forwarding_type": {
"description": "Forwarding service types to get, use comma to separate, Ex: L2oGRE,TTGPDG,Bridge,Advanced",
"type": "string"
},
"includeSharedResources": {
"description": "Whether to include the resources of parent domain or not",
"type": "boolean"
},
"INCLUDE_RBAC_METADATA": {
"description": "Whether to include RBAC metadata or not",
"type": "boolean"
},
"TENANT_ID": {
"description": "Specify Tenant ID for query",
"type": "string"
},
"inMap": {
"description": "Specify inMap status for query",
"type": "boolean"
},
"globalFilterId": {
"description": "Specify GlobalFilter ID for query",
"type": "string"
},
"auth_hostedAaaSupportedEnabled": {
"description": "Indicate if Hosted AAA Support is enabled",
"type": "boolean"
},
"auth_plmnIdentifierEnabled": {
"description": "Indicate if Configure PLMN identifier is enabled",
"type": "boolean"
},
"includeUsers": {
"description": "Should also retrieve users or not",
"type": "boolean"
}
}
},
"extraTimeRange": {
"description": "Specified data time range of selection",
"type": "object",
"additionalProperties": false,
"properties": {
"start": {
"description": "start time for collecting data",
"type": "number"
},
"end": {
"description": "end time for collecting data",
"type": "number"
},
"interval": {
"description": "time interval in second",
"type": "number"
},
"field": {
"description": "time field for collecting data",
"enum": [
"insertionTime",
"startTime",
"endTime"
],
"type": "string"
}
}
},
"fullTextSearch": {
"description": "Specified search string",
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Search logic operator",
"enum": [
"AND",
"OR"
],
"type": "string"
},
"value": {
"description": "Text or number to search",
"type": "string"
},
"fields": {
"description": "Specific fields to search",
"type": "array",
"items": {
"type": "string"
}
}
}
},
"sortInfo": {
"description": "About sorting",
"type": "object",
"additionalProperties": false,
"properties": {
"sortColumn": {
"type": "string"
},
"dir": {
"enum": [
"ASC",
"DESC"
],
"type": "string"
}
}
},
"page": {
"description": "Page number to get",
"type": "integer",
"minimum": 1
},
"limit": {
"description": "Size of one page",
"type": "integer",
"minimum": 1
},
"expandDomains": {
"description": "Whether to expand domains into sub domains/ zones or not",
"type": "boolean"
},
"criteria": {
"description": "Add backward compatibility for UI framework",
"type": "string"
},
"query": {
"description": "Add backward compatibility for UI framework",
"type": "string"
}
}
}
200
Body
{
"rawDataTotalCount": 0,
"totalCount": 2,
"hasMore": false,
"firstIndex": 8,
"list": [
{
"id": "844db453-2112-42ad-b6eb-6bf5a0fd987b",
"name": "60:9C:9F:DA:63:80-1528934400165",
"type": "SCHEDULED",
"switchName": "ICX7750-1",
"status": "SUCCESS",
"timestamp": 1650511800376,
"endTimestamp": 1650511804100,
"restoreStatus": null,
"restoreTimestamp": null,
"failureReason": ""
},
{
"id": "69acdc88-ab7c-4007-9301-91df234bb185",
"name": "60:9C:9F:DA:63:80-1528761600156",
"type": "SCHEDULED",
"switchName": "ICX7750-1",
"status": "SUCCESS",
"timestamp": 1650511800376,
"endTimestamp": 1650511804100,
"restoreStatus": null,
"restoreTimestamp": null,
"failureReason": ""
}
],
"extra": null
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"rawDataTotalCount": {
"description": "ConfigBackup count",
"type": "integer"
},
"totalCount": {
"description": "Total ConfigBackup count",
"type": "integer"
},
"hasMore": {
"description": "Indicator of whether there are more ConfigBackup after the current displayed list",
"type": "boolean"
},
"firstIndex": {
"description": "Index of the first ConfigBackup returned out of the complete ConfigBackup list",
"type": "integer"
},
"extra": {
"description": "Extra information for ConfigBackup list",
"type": "object",
"properties": {
"rbacMetadata": {
"type": "array",
"items": {
"additionalProperties": {
"type": "string"
},
"properties": {}
}
}
}
},
"list": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"description": "the identifier of the config backup",
"type": "string"
},
"name": {
"description": "the name of the config backup",
"type": "string"
},
"type": {
"description": "Scheduled or Manual",
"type": "string"
},
"switchName": {
"description": "Switch Name of the config backup",
"type": "string"
},
"status": {
"description": "the status of the config backup",
"type": "string"
},
"timestamp": {
"description": "the start timestamp of the config backup",
"type": "integer",
"format": "int64"
},
"endTimestamp": {
"description": "the end timestamp of the config backup",
"type": "integer",
"format": "int64"
},
"restoreStatus": {
"description": "Status of config restore",
"type": "string"
},
"restoreTimestamp": {
"description": "the timestamp of the config restore",
"type": "integer",
"format": "int64"
},
"failureReason": {
"description": "Failure reason of the config backup and config restore",
"type": "string"
},
"master": {
"description": "the master config backup",
"type": "boolean"
},
"latestDiffFromMaster": {
"description": "the indicator of the latest backup different from the master backup",
"type": "boolean"
}
}
}
}
}
}
Backup Configuration for Switches ¶
POST/v11_1/switchconfig/backup
Use this API command to backup configuration for a list of switches.
- master
string
(optional)Backup switch configuration and set it as a master backup(master=true), set it as a normal backup(master=false).
Body
[
"CC:4E:24:8B:5C:30",
"CC:4E:24:8B:19:D8"
]
Schema
{
"type": "array",
"items": {
"description": "Switch id",
"type": "string"
}
}
201
Body
{
"rawDataTotalCount": 0,
"totalCount": 2,
"hasMore": false,
"firstIndex": 0,
"list": [
{
"switchId": "CC:4E:24:8B:5C:30",
"configBackupId": "b3921397-d6e9-4877-befc-2bcbf65158e7",
"errorMessage": ""
},
{
"switchId": "CC:4E:24:8B:19:D8",
"configBackupId": "",
"errorMessage": "provision doesn't finished yet"
}
],
"extra": null
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"rawDataTotalCount": {
"description": "Total ConfigBackupInfo count",
"type": "integer"
},
"totalCount": {
"description": "Current ConfigBackupInfo count",
"type": "integer"
},
"hasMore": {
"description": "Has more data or not",
"type": "boolean"
},
"firstIndex": {
"description": "Index of first index in current page",
"type": "integer"
},
"extra": {
"description": "Extra information for config backup policy",
"type": "object",
"properties": {
"rbacMetadata": {
"type": "array",
"items": {
"additionalProperties": {
"type": "string"
},
"properties": {}
}
}
}
},
"list": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"configBackupId": {
"description": "Identifier of config backup",
"type": "string"
},
"switchId": {
"description": "Identifier of switch",
"type": "string"
},
"errorMessage": {
"description": "Error message",
"type": "string"
}
}
}
}
}
}
Manual Trigger Config Backup ¶
POST/v11_1/switchconfig/backup/manual
Use this API command to manual trigger config backup
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"switchId": {
"description": "the switch id of config backup",
"type": "string"
},
"switchName": {
"description": "the switch name of config backup",
"type": "string"
}
}
}
201
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"configBackupId": {
"description": "the config backup id",
"type": "string"
},
"switchId": {
"description": "the switch id of config backup",
"type": "string"
},
"errorMessage": {
"description": "the error message if config backup",
"type": "string"
}
}
}
Diff between two Config Backup Files ¶
POST/v11_1/switchconfig/backup/diff
Use this API command to diff between two config back up files for a switch.
Body
{
"configBackupId1": "844db453-2112-42ad-b6eb-6bf5a0fd987b",
"configBackupId2": "69acdc88-ab7c-4007-9301-91df234bb185"
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"configBackupId1": {
"description": "The first config backup id of diff input",
"type": "string"
},
"configBackupId2": {
"description": "The second config backup id of diff input",
"type": "string"
}
}
}
200
Body
{
"configBackup1": {
"id": "844db453-2112-42ad-b6eb-6bf5a0fd987b",
"name": "60:9C:9F:DA:63:80-1528934400165",
"config": "ver 08.0.80b254T201\n!\nstack unit 1\n module 1 icx7750-48-xgc-port-management-module\n module 2 icx7750-qsfp-6port-qsfp-240g-module\n!\n\n!\n!\n!\n!\n!\nvlan 1 name DEFAULT-VLAN by port\n!\nvlan 192 by port\n tagged ethe 1/1/1 \n!\n!\n!\n!\n!\n!\n!\n!\n!\n!\n!\n!\nboot sys fl pri\nhostname ICX7750-1\nip address 192.168.240.31 255.255.0.0\nip default-gateway 192.168.253.253\n!\n!\n!\nsnmp-server community 2 $U2kyXj1k ro\n!\n!\n!\n!\nntp\n server 192.168.253.254\n!\n!\n!\nsz active-list 192.168.240.204\n!\n!\n!\n!\nlldp run\n!\n!\n!\n!\n!\nend\n"
},
"configBackup2": {
"id": "69acdc88-ab7c-4007-9301-91df234bb185",
"name": "60:9C:9F:DA:63:80-1528761600156",
"config": "ver 08.0.80b207T201\n!\nstack unit 1\n module 1 icx7750-48-xgc-port-management-module\n module 2 icx7750-qsfp-6port-qsfp-240g-module\n!\n\n!\n!\n!\n!\n!\nvlan 1 name DEFAULT-VLAN by port\n!\nvlan 192 by port\n tagged ethe 1/1/1 \n!\n!\n!\n!\n!\n!\n!\n!\n!\n!\n!\n!\nboot sys fl pri\nhostname ICX7750-1\nip address 192.168.240.31 255.255.0.0\n!\n!\n!\nsnmp-server community 2 $U2kyXj1k ro\n!\n!\n!\n!\nntp\n server 192.168.253.254\n!\n!\nsz active 192.168.240.204\n!\n!\n!\nlldp run\n!\n!\n!\n!\n!\nend\n"
}
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"configBackup1": {
"description": "The first config backup content of diff input",
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"description": "the identifier of the ConfigBackup Content",
"type": "string"
},
"name": {
"description": "Name of the ConfigBackup Content",
"type": "string"
},
"config": {
"description": "Content of the ConfigBackup",
"type": "string"
}
}
},
"configBackup2": {
"description": "The second config backup content of diff input",
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"description": "the identifier of the ConfigBackup Content",
"type": "string"
},
"name": {
"description": "Name of the ConfigBackup Content",
"type": "string"
},
"config": {
"description": "Content of the ConfigBackup",
"type": "string"
}
}
}
}
}
Set master backup ¶
POST/v11_1/switchconfig/backup/master
Set a config backup as master
Body
[
{
"switchId": "CC:4E:24:8B:5C:30",
"backupId": "e5d97e16-bcfa-49e0-8baa-02348f62ba24"
},
{
"switchId": "CC:4E:24:8B:5C:60",
"backupId": "e5d97e16-bcfa-49e0-8baa-abds828413542"
}
]
Schema
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"switchId": {
"description": "switch ID",
"type": "string"
},
"backupId": {
"description": "backup ID",
"type": "string"
}
}
}
}
204
Backup Configurations for a Group ¶
PUT/v11_1/switchconfig/{groupType}/{groupId}/backup
Use this API command to backup configurations for all switches under a group.
- master
string
(optional)Backup switch configuration for a group and set them as master backups(master=true), set them as normal backups(master=false)
204
Restore Configuration ¶
PUT/v11_1/switchconfig/backup/{backupId}/restore
Restore a configuration backup to the switch.
200
Delete Config Backup ¶
DELETE/v11_1/switchconfig/{configId}
Use this API command to delete the configuration backup.
204
Delete Config Backups ¶
DELETE/v11_1/switchconfig
Use this API command to delete config backups by a list of config backup id.
Body
[
"844db453-2112-42ad-b6eb-6bf5a0fd987b",
"69acdc88-ab7c-4007-9301-91df234bb185"
]
Schema
{
"type": "array",
"items": {
"description": "Config backup id",
"type": "string"
}
}
204
Remove master backup ¶
DELETE/v11_1/switchconfig/backup/master
Remove the master flag of a config backup
Body
[
"CC:4E:24:8B:5C:30",
"CC:4E:24:8B:19:D8"
]
Schema
{
"type": "array",
"items": {
"description": "Switch id",
"type": "string"
}
}
204
Switch Firmware ¶
List Firmwares ¶
GET/v11_1/firmware
Use this API command to retrieve list of switch firmwares uploaded to SmartZone.
200
Body
{
"rawDataTotalCount": 0,
"totalCount": 2,
"hasMore": false,
"firstIndex": 0,
"list": [
{
"version": "B254",
"switchModels": [
{
"name": "ICX7750",
"imageFileNames": [
"SWS08080b254ufi.bin",
"SWR08080b254ufi.bin"
]
}
]
},
{
"version": "B207",
"switchModels": [
{
"name": "ICX7750",
"imageFileNames": [
"SWS08080b207ufi.bin",
"SWR08080b207ufi.bin"
]
}
]
}
],
"extra": null
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"rawDataTotalCount": {
"description": "Firmware list count",
"type": "integer"
},
"totalCount": {
"description": "Total Firmware list count",
"type": "integer"
},
"hasMore": {
"description": "Indicator of whether there are more Firmwares after the current displayed list",
"type": "boolean"
},
"firstIndex": {
"description": "Index of the first firmware list returned out of the complete Firmware list",
"type": "integer"
},
"extra": {
"description": "Extra information for Firmware list",
"type": "object"
},
"list": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"version": {
"description": "Firmware version of the Switch",
"type": "string"
},
"switchModels": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"name": {
"description": "Name of the Switch Model",
"type": "string"
},
"imageFileNames": {
"description": "Name of the Switch Image File",
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}
}
}
}
}
List Firmwares ¶
POST/v11_1/firmware
Use this API command to retrieve list of switch firmwares uploaded to SmartZone.
Body
{
"filters": [
{
"type": "DOMAIN",
"value": "8b2081d5-9662-40d9-a3db-2a3cf4dde3f7"
}
],
"extraFilters": [
{
"value": "60:9C:9F:DA:63:80",
"type": "SWITCH"
}
]
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"filters": {
"description": "Filters used to select specific resource scope",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Group type",
"enum": [
"SYSTEM",
"CATEGORY",
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"BLADE",
"SYNCEDSTATUS",
"REGISTRATIONSTATE",
"STATUS",
"SWITCH_GROUP",
"FAMILY_ID",
"PORT",
"SWITCH_ID_PORT_IDENTIFIER",
"transactionId",
"dispatchStatus",
"configType",
"yang",
"removeYang"
],
"type": "string"
},
"value": {
"description": "Group ID",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraFilters": {
"description": "\"AND\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"SWITCH_GROUP",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"transactionId",
"hasLayerThreeConfig",
"clientAuthType",
"clientIpv4Addr",
"clientIpv6Addr",
"clientMac",
"clientUserName",
"switchName",
"ADMIN_STATUS",
"PORT_STATUS",
"POE_ENABLED",
"cliType",
"dispatchStatus",
"configType",
"yang",
"removeYang",
"reservedField1",
"FIRMWARE",
"dot1XIpv4Addr",
"dot1XIpv6Addr"
],
"type": "string"
},
"value": {
"description": "Value to search",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraNotFilters": {
"description": "\"NOT\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"switchStatus.alerts",
"switchStatus.status",
"transactionId",
"hasLayerThreeConfig",
"reservedField1",
"dispatchStatus",
"configType",
"clis",
"yang",
"removeYang",
"clientType"
],
"type": "string"
},
"value": {
"description": "Value not to search",
"type": "string"
}
}
}
},
"options": {
"description": "Specified feature required informaion",
"type": "object",
"additionalProperties": false,
"properties": {
"auth_includeNa": {
"description": "Include Not Available auth service option while returning result",
"type": "boolean"
},
"auth_includeLocalDb": {
"description": "Include LocalDB auth service while returning result",
"type": "boolean"
},
"auth_includeGuest": {
"description": "Include Guest auth service while returning result",
"type": "boolean"
},
"auth_includeAdGlobal": {
"description": "If AD is in list, include only AD with Global Catalog configured",
"type": "boolean"
},
"auth_type": {
"description": "Authentication service types to get, use comma to separate, Ex: RADIUS,AD",
"type": "string"
},
"auth_realmType": {
"description": "To get specific authentication service information for configuring realm based authentication profile",
"enum": [
"ALL",
"RADIUS"
],
"type": "string"
},
"acct_type": {
"description": "Accounting service types to get, use comma to separate, Ex: RADIUS,CGF",
"type": "string"
},
"auth_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_includeNa": {
"description": "Include Not Available acct service option while returning result",
"type": "boolean"
},
"forwarding_type": {
"description": "Forwarding service types to get, use comma to separate, Ex: L2oGRE,TTGPDG,Bridge,Advanced",
"type": "string"
},
"includeSharedResources": {
"description": "Whether to include the resources of parent domain or not",
"type": "boolean"
},
"INCLUDE_RBAC_METADATA": {
"description": "Whether to include RBAC metadata or not",
"type": "boolean"
},
"TENANT_ID": {
"description": "Specify Tenant ID for query",
"type": "string"
},
"inMap": {
"description": "Specify inMap status for query",
"type": "boolean"
},
"globalFilterId": {
"description": "Specify GlobalFilter ID for query",
"type": "string"
},
"auth_hostedAaaSupportedEnabled": {
"description": "Indicate if Hosted AAA Support is enabled",
"type": "boolean"
},
"auth_plmnIdentifierEnabled": {
"description": "Indicate if Configure PLMN identifier is enabled",
"type": "boolean"
},
"includeUsers": {
"description": "Should also retrieve users or not",
"type": "boolean"
}
}
},
"extraTimeRange": {
"description": "Specified data time range of selection",
"type": "object",
"additionalProperties": false,
"properties": {
"start": {
"description": "start time for collecting data",
"type": "number"
},
"end": {
"description": "end time for collecting data",
"type": "number"
},
"interval": {
"description": "time interval in second",
"type": "number"
},
"field": {
"description": "time field for collecting data",
"enum": [
"insertionTime",
"startTime",
"endTime"
],
"type": "string"
}
}
},
"fullTextSearch": {
"description": "Specified search string",
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Search logic operator",
"enum": [
"AND",
"OR"
],
"type": "string"
},
"value": {
"description": "Text or number to search",
"type": "string"
},
"fields": {
"description": "Specific fields to search",
"type": "array",
"items": {
"type": "string"
}
}
}
},
"sortInfo": {
"description": "About sorting",
"type": "object",
"additionalProperties": false,
"properties": {
"sortColumn": {
"type": "string"
},
"dir": {
"enum": [
"ASC",
"DESC"
],
"type": "string"
}
}
},
"page": {
"description": "Page number to get",
"type": "integer",
"minimum": 1
},
"limit": {
"description": "Size of one page",
"type": "integer",
"minimum": 1
},
"expandDomains": {
"description": "Whether to expand domains into sub domains/ zones or not",
"type": "boolean"
},
"criteria": {
"description": "Add backward compatibility for UI framework",
"type": "string"
},
"query": {
"description": "Add backward compatibility for UI framework",
"type": "string"
}
}
}
200
Body
{
"rawDataTotalCount": 0,
"totalCount": 2,
"hasMore": false,
"firstIndex": 0,
"list": [
{
"version": "B254",
"switchModels": [
{
"name": "ICX7750",
"imageFileNames": [
"SWS08080b254ufi.bin",
"SWR08080b254ufi.bin"
]
}
]
},
{
"version": "B207",
"switchModels": [
{
"name": "ICX7750",
"imageFileNames": [
"SWS08080b207ufi.bin",
"SWR08080b207ufi.bin"
]
}
]
}
],
"extra": null
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"rawDataTotalCount": {
"description": "Firmware list count",
"type": "integer"
},
"totalCount": {
"description": "Total Firmware list count",
"type": "integer"
},
"hasMore": {
"description": "Indicator of whether there are more Firmwares after the current displayed list",
"type": "boolean"
},
"firstIndex": {
"description": "Index of the first firmware list returned out of the complete Firmware list",
"type": "integer"
},
"extra": {
"description": "Extra information for Firmware list",
"type": "object"
},
"list": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"version": {
"description": "Firmware version of the Switch",
"type": "string"
},
"switchModels": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"name": {
"description": "Name of the Switch Model",
"type": "string"
},
"imageFileNames": {
"description": "Name of the Switch Image File",
"type": "array",
"items": {
"type": "string"
}
}
}
}
}
}
}
}
}
}
Upload Firmware Image ¶
POST/v11_1/firmware/upload
Use this API command to upload a firmware image zip file to SmartZone.
Headers
Content-Type: multipart/form-data
200
Apply Firmware Update ¶
PATCH/v11_1/firmware/{version}
Use this API command to update the given firmware version on switches matching criteria.
Body
{
"filters": [
{
"type": "DOMAIN",
"value": "8b2081d5-9662-40d9-a3db-2a3cf4dde3f7"
}
],
"fullTextSearch": {
"type": "AND",
"value": ""
},
"attributes": [
"*"
],
"sortInfo": {
"sortColumn": "",
"dir": "ASC"
},
"page": 1,
"limit": 8
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"filters": {
"description": "Filters used to select specific resource scope",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Group type",
"enum": [
"SYSTEM",
"CATEGORY",
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"BLADE",
"SYNCEDSTATUS",
"REGISTRATIONSTATE",
"STATUS",
"SWITCH_GROUP",
"FAMILY_ID",
"PORT",
"SWITCH_ID_PORT_IDENTIFIER",
"transactionId",
"dispatchStatus",
"configType",
"yang",
"removeYang"
],
"type": "string"
},
"value": {
"description": "Group ID",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraFilters": {
"description": "\"AND\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"SWITCH_GROUP",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"transactionId",
"hasLayerThreeConfig",
"clientAuthType",
"clientIpv4Addr",
"clientIpv6Addr",
"clientMac",
"clientUserName",
"switchName",
"ADMIN_STATUS",
"PORT_STATUS",
"POE_ENABLED",
"cliType",
"dispatchStatus",
"configType",
"yang",
"removeYang",
"reservedField1",
"FIRMWARE",
"dot1XIpv4Addr",
"dot1XIpv6Addr"
],
"type": "string"
},
"value": {
"description": "Value to search",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraNotFilters": {
"description": "\"NOT\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"switchStatus.alerts",
"switchStatus.status",
"transactionId",
"hasLayerThreeConfig",
"reservedField1",
"dispatchStatus",
"configType",
"clis",
"yang",
"removeYang",
"clientType"
],
"type": "string"
},
"value": {
"description": "Value not to search",
"type": "string"
}
}
}
},
"options": {
"description": "Specified feature required informaion",
"type": "object",
"additionalProperties": false,
"properties": {
"auth_includeNa": {
"description": "Include Not Available auth service option while returning result",
"type": "boolean"
},
"auth_includeLocalDb": {
"description": "Include LocalDB auth service while returning result",
"type": "boolean"
},
"auth_includeGuest": {
"description": "Include Guest auth service while returning result",
"type": "boolean"
},
"auth_includeAdGlobal": {
"description": "If AD is in list, include only AD with Global Catalog configured",
"type": "boolean"
},
"auth_type": {
"description": "Authentication service types to get, use comma to separate, Ex: RADIUS,AD",
"type": "string"
},
"auth_realmType": {
"description": "To get specific authentication service information for configuring realm based authentication profile",
"enum": [
"ALL",
"RADIUS"
],
"type": "string"
},
"acct_type": {
"description": "Accounting service types to get, use comma to separate, Ex: RADIUS,CGF",
"type": "string"
},
"auth_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_includeNa": {
"description": "Include Not Available acct service option while returning result",
"type": "boolean"
},
"forwarding_type": {
"description": "Forwarding service types to get, use comma to separate, Ex: L2oGRE,TTGPDG,Bridge,Advanced",
"type": "string"
},
"includeSharedResources": {
"description": "Whether to include the resources of parent domain or not",
"type": "boolean"
},
"INCLUDE_RBAC_METADATA": {
"description": "Whether to include RBAC metadata or not",
"type": "boolean"
},
"TENANT_ID": {
"description": "Specify Tenant ID for query",
"type": "string"
},
"inMap": {
"description": "Specify inMap status for query",
"type": "boolean"
},
"globalFilterId": {
"description": "Specify GlobalFilter ID for query",
"type": "string"
},
"auth_hostedAaaSupportedEnabled": {
"description": "Indicate if Hosted AAA Support is enabled",
"type": "boolean"
},
"auth_plmnIdentifierEnabled": {
"description": "Indicate if Configure PLMN identifier is enabled",
"type": "boolean"
},
"includeUsers": {
"description": "Should also retrieve users or not",
"type": "boolean"
}
}
},
"extraTimeRange": {
"description": "Specified data time range of selection",
"type": "object",
"additionalProperties": false,
"properties": {
"start": {
"description": "start time for collecting data",
"type": "number"
},
"end": {
"description": "end time for collecting data",
"type": "number"
},
"interval": {
"description": "time interval in second",
"type": "number"
},
"field": {
"description": "time field for collecting data",
"enum": [
"insertionTime",
"startTime",
"endTime"
],
"type": "string"
}
}
},
"fullTextSearch": {
"description": "Specified search string",
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Search logic operator",
"enum": [
"AND",
"OR"
],
"type": "string"
},
"value": {
"description": "Text or number to search",
"type": "string"
},
"fields": {
"description": "Specific fields to search",
"type": "array",
"items": {
"type": "string"
}
}
}
},
"attributes": {
"description": "Get specific columns only",
"type": "array",
"items": {
"type": "string"
}
},
"sortInfo": {
"description": "About sorting",
"type": "object",
"additionalProperties": false,
"properties": {
"sortColumn": {
"type": "string"
},
"dir": {
"enum": [
"ASC",
"DESC"
],
"type": "string"
}
}
},
"page": {
"description": "Page number to get",
"type": "integer",
"minimum": 1
},
"limit": {
"description": "Size of one page",
"type": "integer",
"minimum": 1
},
"expandDomains": {
"description": "Whether to expand domains into sub domains/ zones or not",
"type": "boolean"
},
"criteria": {
"description": "Add backward compatibility for UI framework",
"type": "string"
},
"query": {
"description": "Add backward compatibility for UI framework",
"type": "string"
}
}
}
200
Body
{
"rawDataTotalCount": 0,
"totalCount": 1,
"hasMore": false,
"firstIndex": 0,
"list": [
"firmware-update-ONE_TIME-1524822740577"
],
"extra": null
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"rawDataTotalCount": {
"description": "Firmware list count",
"type": "integer"
},
"totalCount": {
"description": "Total Schedule Ids count",
"type": "integer"
},
"hasMore": {
"description": "Indicator of whether there are more Schedule Ids after the current displayed list",
"type": "boolean"
},
"firstIndex": {
"description": "Index of the first Schedule Ids returned out of the complete ConfigBackup list",
"type": "integer"
},
"extra": {
"description": "Extra information for Schedule Ids list",
"type": "object"
},
"list": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
Switch Health ¶
Hardware Status ¶
POST/v11_1/health/status/all
Use this API command to retrieve fan, temperature and power supply status for the switch managed by SmartZone.
Body
{
"filters": [
{
"type": "DOMAIN",
"value": "8b2081d5-9662-40d9-a3db-2a3cf4dde3f7"
}
],
"extraFilters": [
{
"type": "SWITCH",
"value": "60:9C:9F:DA:63:80"
}
],
"extraTimeRange": {
"start": 1547012879222,
"end": 1547016479222,
"interval": 300000
}
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"filters": {
"description": "Filters used to select specific resource scope",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Group type",
"enum": [
"SYSTEM",
"CATEGORY",
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"BLADE",
"SYNCEDSTATUS",
"REGISTRATIONSTATE",
"STATUS",
"SWITCH_GROUP",
"FAMILY_ID",
"PORT",
"SWITCH_ID_PORT_IDENTIFIER",
"transactionId",
"dispatchStatus",
"configType",
"yang",
"removeYang"
],
"type": "string"
},
"value": {
"description": "Group ID",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraFilters": {
"description": "\"AND\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"SWITCH_GROUP",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"transactionId",
"hasLayerThreeConfig",
"clientAuthType",
"clientIpv4Addr",
"clientIpv6Addr",
"clientMac",
"clientUserName",
"switchName",
"ADMIN_STATUS",
"PORT_STATUS",
"POE_ENABLED",
"cliType",
"dispatchStatus",
"configType",
"yang",
"removeYang",
"reservedField1",
"FIRMWARE",
"dot1XIpv4Addr",
"dot1XIpv6Addr"
],
"type": "string"
},
"value": {
"description": "Value to search",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraNotFilters": {
"description": "\"NOT\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"switchStatus.alerts",
"switchStatus.status",
"transactionId",
"hasLayerThreeConfig",
"reservedField1",
"dispatchStatus",
"configType",
"clis",
"yang",
"removeYang",
"clientType"
],
"type": "string"
},
"value": {
"description": "Value not to search",
"type": "string"
}
}
}
},
"options": {
"description": "Specified feature required informaion",
"type": "object",
"additionalProperties": false,
"properties": {
"auth_includeNa": {
"description": "Include Not Available auth service option while returning result",
"type": "boolean"
},
"auth_includeLocalDb": {
"description": "Include LocalDB auth service while returning result",
"type": "boolean"
},
"auth_includeGuest": {
"description": "Include Guest auth service while returning result",
"type": "boolean"
},
"auth_includeAdGlobal": {
"description": "If AD is in list, include only AD with Global Catalog configured",
"type": "boolean"
},
"auth_type": {
"description": "Authentication service types to get, use comma to separate, Ex: RADIUS,AD",
"type": "string"
},
"auth_realmType": {
"description": "To get specific authentication service information for configuring realm based authentication profile",
"enum": [
"ALL",
"RADIUS"
],
"type": "string"
},
"acct_type": {
"description": "Accounting service types to get, use comma to separate, Ex: RADIUS,CGF",
"type": "string"
},
"auth_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_includeNa": {
"description": "Include Not Available acct service option while returning result",
"type": "boolean"
},
"forwarding_type": {
"description": "Forwarding service types to get, use comma to separate, Ex: L2oGRE,TTGPDG,Bridge,Advanced",
"type": "string"
},
"includeSharedResources": {
"description": "Whether to include the resources of parent domain or not",
"type": "boolean"
},
"INCLUDE_RBAC_METADATA": {
"description": "Whether to include RBAC metadata or not",
"type": "boolean"
},
"TENANT_ID": {
"description": "Specify Tenant ID for query",
"type": "string"
},
"inMap": {
"description": "Specify inMap status for query",
"type": "boolean"
},
"globalFilterId": {
"description": "Specify GlobalFilter ID for query",
"type": "string"
},
"auth_hostedAaaSupportedEnabled": {
"description": "Indicate if Hosted AAA Support is enabled",
"type": "boolean"
},
"auth_plmnIdentifierEnabled": {
"description": "Indicate if Configure PLMN identifier is enabled",
"type": "boolean"
},
"includeUsers": {
"description": "Should also retrieve users or not",
"type": "boolean"
}
}
},
"extraTimeRange": {
"description": "Specified data time range of selection",
"type": "object",
"additionalProperties": false,
"properties": {
"start": {
"description": "start time for collecting data",
"type": "number"
},
"end": {
"description": "end time for collecting data",
"type": "number"
},
"interval": {
"description": "time interval in second",
"type": "number"
},
"field": {
"description": "time field for collecting data",
"enum": [
"insertionTime",
"startTime",
"endTime"
],
"type": "string"
}
}
},
"fullTextSearch": {
"description": "Specified search string",
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Search logic operator",
"enum": [
"AND",
"OR"
],
"type": "string"
},
"value": {
"description": "Text or number to search",
"type": "string"
},
"fields": {
"description": "Specific fields to search",
"type": "array",
"items": {
"type": "string"
}
}
}
},
"sortInfo": {
"description": "About sorting",
"type": "object",
"additionalProperties": false,
"properties": {
"sortColumn": {
"type": "string"
},
"dir": {
"enum": [
"ASC",
"DESC"
],
"type": "string"
}
}
},
"page": {
"description": "Page number to get",
"type": "integer",
"minimum": 1
},
"limit": {
"description": "Size of one page",
"type": "integer",
"minimum": 1
},
"expandDomains": {
"description": "Whether to expand domains into sub domains/ zones or not",
"type": "boolean"
},
"criteria": {
"description": "Add backward compatibility for UI framework",
"type": "string"
},
"query": {
"description": "Add backward compatibility for UI framework",
"type": "string"
}
}
}
200
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"onlineCount": {
"description": "Online status count",
"type": "integer"
},
"flaggedCount": {
"description": "Flagged status count",
"type": "integer"
},
"offlineCount": {
"description": "Offline status count",
"type": "integer"
},
"powerSupply": {
"description": "Powersupply",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"serialNumber": {
"type": "string"
},
"slotNumber": {
"description": "Power supply slot number",
"type": "integer"
},
"type": {
"description": "Power supply type",
"type": "string"
},
"status": {
"description": "Power supply status",
"type": "string"
}
}
}
},
"temperature": {
"description": "Temperature",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"slotNumber": {
"description": "Solt number",
"type": "integer"
},
"temperatureValue": {
"description": "Slot temperature",
"type": "number"
},
"serialNumber": {
"type": "string"
}
}
}
},
"fan": {
"description": "Fan",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"serialNumber": {
"type": "string"
},
"slotNumber": {
"description": "Fan slot number",
"type": "integer"
},
"type": {
"description": "Fan type",
"type": "string"
},
"status": {
"description": "Fan status",
"type": "string"
}
}
}
},
"powerHealthStatus": {
"description": "Health status for ICX/Stack that contains power supply, temperature and fan",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"serialNumber": {
"type": "string"
},
"fan": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"serialNumber": {
"type": "string"
},
"slotNumber": {
"description": "Fan slot number",
"type": "integer"
},
"type": {
"description": "Fan type",
"type": "string"
},
"status": {
"description": "Fan status",
"type": "string"
}
}
}
},
"temperature": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"slotNumber": {
"description": "Solt number",
"type": "integer"
},
"temperatureValue": {
"description": "Slot temperature",
"type": "number"
},
"serialNumber": {
"type": "string"
}
}
}
},
"powerSupply": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"serialNumber": {
"type": "string"
},
"slotNumber": {
"description": "Power supply slot number",
"type": "integer"
},
"type": {
"description": "Power supply type",
"type": "string"
},
"status": {
"description": "Power supply status",
"type": "string"
}
}
}
}
}
}
}
}
}
Switch Health Status ¶
POST/v11_1/health/status
Use this API command to retrieve switch health status.
Body
{
"filters": [
{
"type": "DOMAIN",
"value": "8b2081d5-9662-40d9-a3db-2a3cf4dde3f7"
}
],
"extraFilters": [
{
"type": "SWITCH",
"value": "60:9C:9F:DA:63:80"
}
],
"extraTimeRange": {
"start": 1547012879222,
"end": 1547016479222,
"interval": 300000
}
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"filters": {
"description": "Filters used to select specific resource scope",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Group type",
"enum": [
"SYSTEM",
"CATEGORY",
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"BLADE",
"SYNCEDSTATUS",
"REGISTRATIONSTATE",
"STATUS",
"SWITCH_GROUP",
"FAMILY_ID",
"PORT",
"SWITCH_ID_PORT_IDENTIFIER",
"transactionId",
"dispatchStatus",
"configType",
"yang",
"removeYang"
],
"type": "string"
},
"value": {
"description": "Group ID",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraFilters": {
"description": "\"AND\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"SWITCH_GROUP",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"transactionId",
"hasLayerThreeConfig",
"clientAuthType",
"clientIpv4Addr",
"clientIpv6Addr",
"clientMac",
"clientUserName",
"switchName",
"ADMIN_STATUS",
"PORT_STATUS",
"POE_ENABLED",
"cliType",
"dispatchStatus",
"configType",
"yang",
"removeYang",
"reservedField1",
"FIRMWARE",
"dot1XIpv4Addr",
"dot1XIpv6Addr"
],
"type": "string"
},
"value": {
"description": "Value to search",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraNotFilters": {
"description": "\"NOT\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"switchStatus.alerts",
"switchStatus.status",
"transactionId",
"hasLayerThreeConfig",
"reservedField1",
"dispatchStatus",
"configType",
"clis",
"yang",
"removeYang",
"clientType"
],
"type": "string"
},
"value": {
"description": "Value not to search",
"type": "string"
}
}
}
},
"options": {
"description": "Specified feature required informaion",
"type": "object",
"additionalProperties": false,
"properties": {
"auth_includeNa": {
"description": "Include Not Available auth service option while returning result",
"type": "boolean"
},
"auth_includeLocalDb": {
"description": "Include LocalDB auth service while returning result",
"type": "boolean"
},
"auth_includeGuest": {
"description": "Include Guest auth service while returning result",
"type": "boolean"
},
"auth_includeAdGlobal": {
"description": "If AD is in list, include only AD with Global Catalog configured",
"type": "boolean"
},
"auth_type": {
"description": "Authentication service types to get, use comma to separate, Ex: RADIUS,AD",
"type": "string"
},
"auth_realmType": {
"description": "To get specific authentication service information for configuring realm based authentication profile",
"enum": [
"ALL",
"RADIUS"
],
"type": "string"
},
"acct_type": {
"description": "Accounting service types to get, use comma to separate, Ex: RADIUS,CGF",
"type": "string"
},
"auth_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_includeNa": {
"description": "Include Not Available acct service option while returning result",
"type": "boolean"
},
"forwarding_type": {
"description": "Forwarding service types to get, use comma to separate, Ex: L2oGRE,TTGPDG,Bridge,Advanced",
"type": "string"
},
"includeSharedResources": {
"description": "Whether to include the resources of parent domain or not",
"type": "boolean"
},
"INCLUDE_RBAC_METADATA": {
"description": "Whether to include RBAC metadata or not",
"type": "boolean"
},
"TENANT_ID": {
"description": "Specify Tenant ID for query",
"type": "string"
},
"inMap": {
"description": "Specify inMap status for query",
"type": "boolean"
},
"globalFilterId": {
"description": "Specify GlobalFilter ID for query",
"type": "string"
},
"auth_hostedAaaSupportedEnabled": {
"description": "Indicate if Hosted AAA Support is enabled",
"type": "boolean"
},
"auth_plmnIdentifierEnabled": {
"description": "Indicate if Configure PLMN identifier is enabled",
"type": "boolean"
},
"includeUsers": {
"description": "Should also retrieve users or not",
"type": "boolean"
}
}
},
"extraTimeRange": {
"description": "Specified data time range of selection",
"type": "object",
"additionalProperties": false,
"properties": {
"start": {
"description": "start time for collecting data",
"type": "number"
},
"end": {
"description": "end time for collecting data",
"type": "number"
},
"interval": {
"description": "time interval in second",
"type": "number"
},
"field": {
"description": "time field for collecting data",
"enum": [
"insertionTime",
"startTime",
"endTime"
],
"type": "string"
}
}
},
"fullTextSearch": {
"description": "Specified search string",
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Search logic operator",
"enum": [
"AND",
"OR"
],
"type": "string"
},
"value": {
"description": "Text or number to search",
"type": "string"
},
"fields": {
"description": "Specific fields to search",
"type": "array",
"items": {
"type": "string"
}
}
}
},
"sortInfo": {
"description": "About sorting",
"type": "object",
"additionalProperties": false,
"properties": {
"sortColumn": {
"type": "string"
},
"dir": {
"enum": [
"ASC",
"DESC"
],
"type": "string"
}
}
},
"page": {
"description": "Page number to get",
"type": "integer",
"minimum": 1
},
"limit": {
"description": "Size of one page",
"type": "integer",
"minimum": 1
},
"expandDomains": {
"description": "Whether to expand domains into sub domains/ zones or not",
"type": "boolean"
},
"criteria": {
"description": "Add backward compatibility for UI framework",
"type": "string"
},
"query": {
"description": "Add backward compatibility for UI framework",
"type": "string"
}
}
}
200
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"onlineCount": {
"description": "Online status count",
"type": "integer"
},
"flaggedCount": {
"description": "Flagged status count",
"type": "integer"
},
"offlineCount": {
"description": "Offline status count",
"type": "integer"
},
"powerSupply": {
"description": "Powersupply",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"serialNumber": {
"type": "string"
},
"slotNumber": {
"description": "Power supply slot number",
"type": "integer"
},
"type": {
"description": "Power supply type",
"type": "string"
},
"status": {
"description": "Power supply status",
"type": "string"
}
}
}
},
"temperature": {
"description": "Temperature",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"slotNumber": {
"description": "Solt number",
"type": "integer"
},
"temperatureValue": {
"description": "Slot temperature",
"type": "number"
},
"serialNumber": {
"type": "string"
}
}
}
},
"fan": {
"description": "Fan",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"serialNumber": {
"type": "string"
},
"slotNumber": {
"description": "Fan slot number",
"type": "integer"
},
"type": {
"description": "Fan type",
"type": "string"
},
"status": {
"description": "Fan status",
"type": "string"
}
}
}
},
"powerHealthStatus": {
"description": "Health status for ICX/Stack that contains power supply, temperature and fan",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"serialNumber": {
"type": "string"
},
"fan": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"serialNumber": {
"type": "string"
},
"slotNumber": {
"description": "Fan slot number",
"type": "integer"
},
"type": {
"description": "Fan type",
"type": "string"
},
"status": {
"description": "Fan status",
"type": "string"
}
}
}
},
"temperature": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"slotNumber": {
"description": "Solt number",
"type": "integer"
},
"temperatureValue": {
"description": "Slot temperature",
"type": "number"
},
"serialNumber": {
"type": "string"
}
}
}
},
"powerSupply": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"serialNumber": {
"type": "string"
},
"slotNumber": {
"description": "Power supply slot number",
"type": "integer"
},
"type": {
"description": "Power supply type",
"type": "string"
},
"status": {
"description": "Power supply status",
"type": "string"
}
}
}
}
}
}
}
}
}
CPU Aggregated ¶
POST/v11_1/health/cpu/agg
Use this API command to retrieve aggregated CPU (min, max, avg, curr) data based on the time duration.
Body
{
"filters": [
{
"type": "DOMAIN",
"value": "8b2081d5-9662-40d9-a3db-2a3cf4dde3f7"
}
],
"extraFilters": [
{
"type": "SWITCH",
"value": "60:9C:9F:DA:63:80"
}
],
"extraTimeRange": {
"start": 1547012879222,
"end": 1547016479222,
"interval": 300000
}
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"filters": {
"description": "Filters used to select specific resource scope",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Group type",
"enum": [
"SYSTEM",
"CATEGORY",
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"BLADE",
"SYNCEDSTATUS",
"REGISTRATIONSTATE",
"STATUS",
"SWITCH_GROUP",
"FAMILY_ID",
"PORT",
"SWITCH_ID_PORT_IDENTIFIER",
"transactionId",
"dispatchStatus",
"configType",
"yang",
"removeYang"
],
"type": "string"
},
"value": {
"description": "Group ID",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraFilters": {
"description": "\"AND\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"SWITCH_GROUP",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"transactionId",
"hasLayerThreeConfig",
"clientAuthType",
"clientIpv4Addr",
"clientIpv6Addr",
"clientMac",
"clientUserName",
"switchName",
"ADMIN_STATUS",
"PORT_STATUS",
"POE_ENABLED",
"cliType",
"dispatchStatus",
"configType",
"yang",
"removeYang",
"reservedField1",
"FIRMWARE",
"dot1XIpv4Addr",
"dot1XIpv6Addr"
],
"type": "string"
},
"value": {
"description": "Value to search",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraNotFilters": {
"description": "\"NOT\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"switchStatus.alerts",
"switchStatus.status",
"transactionId",
"hasLayerThreeConfig",
"reservedField1",
"dispatchStatus",
"configType",
"clis",
"yang",
"removeYang",
"clientType"
],
"type": "string"
},
"value": {
"description": "Value not to search",
"type": "string"
}
}
}
},
"options": {
"description": "Specified feature required informaion",
"type": "object",
"additionalProperties": false,
"properties": {
"auth_includeNa": {
"description": "Include Not Available auth service option while returning result",
"type": "boolean"
},
"auth_includeLocalDb": {
"description": "Include LocalDB auth service while returning result",
"type": "boolean"
},
"auth_includeGuest": {
"description": "Include Guest auth service while returning result",
"type": "boolean"
},
"auth_includeAdGlobal": {
"description": "If AD is in list, include only AD with Global Catalog configured",
"type": "boolean"
},
"auth_type": {
"description": "Authentication service types to get, use comma to separate, Ex: RADIUS,AD",
"type": "string"
},
"auth_realmType": {
"description": "To get specific authentication service information for configuring realm based authentication profile",
"enum": [
"ALL",
"RADIUS"
],
"type": "string"
},
"acct_type": {
"description": "Accounting service types to get, use comma to separate, Ex: RADIUS,CGF",
"type": "string"
},
"auth_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_includeNa": {
"description": "Include Not Available acct service option while returning result",
"type": "boolean"
},
"forwarding_type": {
"description": "Forwarding service types to get, use comma to separate, Ex: L2oGRE,TTGPDG,Bridge,Advanced",
"type": "string"
},
"includeSharedResources": {
"description": "Whether to include the resources of parent domain or not",
"type": "boolean"
},
"INCLUDE_RBAC_METADATA": {
"description": "Whether to include RBAC metadata or not",
"type": "boolean"
},
"TENANT_ID": {
"description": "Specify Tenant ID for query",
"type": "string"
},
"inMap": {
"description": "Specify inMap status for query",
"type": "boolean"
},
"globalFilterId": {
"description": "Specify GlobalFilter ID for query",
"type": "string"
},
"auth_hostedAaaSupportedEnabled": {
"description": "Indicate if Hosted AAA Support is enabled",
"type": "boolean"
},
"auth_plmnIdentifierEnabled": {
"description": "Indicate if Configure PLMN identifier is enabled",
"type": "boolean"
},
"includeUsers": {
"description": "Should also retrieve users or not",
"type": "boolean"
}
}
},
"extraTimeRange": {
"description": "Specified data time range of selection",
"type": "object",
"additionalProperties": false,
"properties": {
"start": {
"description": "start time for collecting data",
"type": "number"
},
"end": {
"description": "end time for collecting data",
"type": "number"
},
"interval": {
"description": "time interval in second",
"type": "number"
},
"field": {
"description": "time field for collecting data",
"enum": [
"insertionTime",
"startTime",
"endTime"
],
"type": "string"
}
}
},
"fullTextSearch": {
"description": "Specified search string",
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Search logic operator",
"enum": [
"AND",
"OR"
],
"type": "string"
},
"value": {
"description": "Text or number to search",
"type": "string"
},
"fields": {
"description": "Specific fields to search",
"type": "array",
"items": {
"type": "string"
}
}
}
},
"sortInfo": {
"description": "About sorting",
"type": "object",
"additionalProperties": false,
"properties": {
"sortColumn": {
"type": "string"
},
"dir": {
"enum": [
"ASC",
"DESC"
],
"type": "string"
}
}
},
"page": {
"description": "Page number to get",
"type": "integer",
"minimum": 1
},
"limit": {
"description": "Size of one page",
"type": "integer",
"minimum": 1
},
"expandDomains": {
"description": "Whether to expand domains into sub domains/ zones or not",
"type": "boolean"
},
"criteria": {
"description": "Add backward compatibility for UI framework",
"type": "string"
},
"query": {
"description": "Add backward compatibility for UI framework",
"type": "string"
}
}
}
200
Body
{
"rawDataTotalCount": 0,
"totalCount": 4,
"hasMore": false,
"firstIndex": 0,
"list": [
{
"id": null,
"key": "MAX",
"value": 30
},
{
"id": null,
"key": "AVG",
"value": 5.142857142857143
},
{
"id": null,
"key": "MIN",
"value": 1
},
{
"id": null,
"key": "ICX7750-1",
"value": 1
}
],
"extra": null
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"rawDataTotalCount": {
"description": "Aggregation Metrics count",
"type": "integer"
},
"totalCount": {
"description": "Total of Aggregation Metrics count",
"type": "integer"
},
"hasMore": {
"description": "Indicates if there are more Aggregation Metrics after the currently displayed list",
"type": "boolean"
},
"firstIndex": {
"description": "Index of the first Aggregation Metrics returned out of the complete ICX Metrics list",
"type": "integer"
},
"extra": {
"description": "Extra information for Aggregation Metrics",
"type": "object"
},
"list": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"description": "Identifier of the aggregation value",
"type": "string"
},
"key": {
"description": "Key of the aggregation value",
"type": "string"
},
"value": {
"description": "Metrics of the aggregation value",
"type": "number"
}
}
}
}
}
}
Memory Aggregated ¶
POST/v11_1/health/mem/agg
Use this API command to retrieve aggregated CPU (min, max, avg, curr) data based on the time duration.
Body
{
"filters": [
{
"type": "DOMAIN",
"value": "8b2081d5-9662-40d9-a3db-2a3cf4dde3f7"
}
],
"extraFilters": [
{
"type": "SWITCH",
"value": "60:9C:9F:DA:63:80"
}
],
"extraTimeRange": {
"start": 1547012879222,
"end": 1547016479222,
"interval": 300000
}
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"filters": {
"description": "Filters used to select specific resource scope",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Group type",
"enum": [
"SYSTEM",
"CATEGORY",
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"BLADE",
"SYNCEDSTATUS",
"REGISTRATIONSTATE",
"STATUS",
"SWITCH_GROUP",
"FAMILY_ID",
"PORT",
"SWITCH_ID_PORT_IDENTIFIER",
"transactionId",
"dispatchStatus",
"configType",
"yang",
"removeYang"
],
"type": "string"
},
"value": {
"description": "Group ID",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraFilters": {
"description": "\"AND\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"SWITCH_GROUP",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"transactionId",
"hasLayerThreeConfig",
"clientAuthType",
"clientIpv4Addr",
"clientIpv6Addr",
"clientMac",
"clientUserName",
"switchName",
"ADMIN_STATUS",
"PORT_STATUS",
"POE_ENABLED",
"cliType",
"dispatchStatus",
"configType",
"yang",
"removeYang",
"reservedField1",
"FIRMWARE",
"dot1XIpv4Addr",
"dot1XIpv6Addr"
],
"type": "string"
},
"value": {
"description": "Value to search",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraNotFilters": {
"description": "\"NOT\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"switchStatus.alerts",
"switchStatus.status",
"transactionId",
"hasLayerThreeConfig",
"reservedField1",
"dispatchStatus",
"configType",
"clis",
"yang",
"removeYang",
"clientType"
],
"type": "string"
},
"value": {
"description": "Value not to search",
"type": "string"
}
}
}
},
"options": {
"description": "Specified feature required informaion",
"type": "object",
"additionalProperties": false,
"properties": {
"auth_includeNa": {
"description": "Include Not Available auth service option while returning result",
"type": "boolean"
},
"auth_includeLocalDb": {
"description": "Include LocalDB auth service while returning result",
"type": "boolean"
},
"auth_includeGuest": {
"description": "Include Guest auth service while returning result",
"type": "boolean"
},
"auth_includeAdGlobal": {
"description": "If AD is in list, include only AD with Global Catalog configured",
"type": "boolean"
},
"auth_type": {
"description": "Authentication service types to get, use comma to separate, Ex: RADIUS,AD",
"type": "string"
},
"auth_realmType": {
"description": "To get specific authentication service information for configuring realm based authentication profile",
"enum": [
"ALL",
"RADIUS"
],
"type": "string"
},
"acct_type": {
"description": "Accounting service types to get, use comma to separate, Ex: RADIUS,CGF",
"type": "string"
},
"auth_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_includeNa": {
"description": "Include Not Available acct service option while returning result",
"type": "boolean"
},
"forwarding_type": {
"description": "Forwarding service types to get, use comma to separate, Ex: L2oGRE,TTGPDG,Bridge,Advanced",
"type": "string"
},
"includeSharedResources": {
"description": "Whether to include the resources of parent domain or not",
"type": "boolean"
},
"INCLUDE_RBAC_METADATA": {
"description": "Whether to include RBAC metadata or not",
"type": "boolean"
},
"TENANT_ID": {
"description": "Specify Tenant ID for query",
"type": "string"
},
"inMap": {
"description": "Specify inMap status for query",
"type": "boolean"
},
"globalFilterId": {
"description": "Specify GlobalFilter ID for query",
"type": "string"
},
"auth_hostedAaaSupportedEnabled": {
"description": "Indicate if Hosted AAA Support is enabled",
"type": "boolean"
},
"auth_plmnIdentifierEnabled": {
"description": "Indicate if Configure PLMN identifier is enabled",
"type": "boolean"
},
"includeUsers": {
"description": "Should also retrieve users or not",
"type": "boolean"
}
}
},
"extraTimeRange": {
"description": "Specified data time range of selection",
"type": "object",
"additionalProperties": false,
"properties": {
"start": {
"description": "start time for collecting data",
"type": "number"
},
"end": {
"description": "end time for collecting data",
"type": "number"
},
"interval": {
"description": "time interval in second",
"type": "number"
},
"field": {
"description": "time field for collecting data",
"enum": [
"insertionTime",
"startTime",
"endTime"
],
"type": "string"
}
}
},
"fullTextSearch": {
"description": "Specified search string",
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Search logic operator",
"enum": [
"AND",
"OR"
],
"type": "string"
},
"value": {
"description": "Text or number to search",
"type": "string"
},
"fields": {
"description": "Specific fields to search",
"type": "array",
"items": {
"type": "string"
}
}
}
},
"sortInfo": {
"description": "About sorting",
"type": "object",
"additionalProperties": false,
"properties": {
"sortColumn": {
"type": "string"
},
"dir": {
"enum": [
"ASC",
"DESC"
],
"type": "string"
}
}
},
"page": {
"description": "Page number to get",
"type": "integer",
"minimum": 1
},
"limit": {
"description": "Size of one page",
"type": "integer",
"minimum": 1
},
"expandDomains": {
"description": "Whether to expand domains into sub domains/ zones or not",
"type": "boolean"
},
"criteria": {
"description": "Add backward compatibility for UI framework",
"type": "string"
},
"query": {
"description": "Add backward compatibility for UI framework",
"type": "string"
}
}
}
200
Body
{
"rawDataTotalCount": 0,
"totalCount": 4,
"hasMore": false,
"firstIndex": 0,
"list": [
{
"id": null,
"key": "MAX",
"value": 30
},
{
"id": null,
"key": "AVG",
"value": 5.142857142857143
},
{
"id": null,
"key": "MIN",
"value": 1
},
{
"id": null,
"key": "ICX7750-1",
"value": 1
}
],
"extra": null
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"rawDataTotalCount": {
"description": "Aggregation Metrics count",
"type": "integer"
},
"totalCount": {
"description": "Total of Aggregation Metrics count",
"type": "integer"
},
"hasMore": {
"description": "Indicates if there are more Aggregation Metrics after the currently displayed list",
"type": "boolean"
},
"firstIndex": {
"description": "Index of the first Aggregation Metrics returned out of the complete ICX Metrics list",
"type": "integer"
},
"extra": {
"description": "Extra information for Aggregation Metrics",
"type": "object"
},
"list": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"description": "Identifier of the aggregation value",
"type": "string"
},
"key": {
"description": "Key of the aggregation value",
"type": "string"
},
"value": {
"description": "Metrics of the aggregation value",
"type": "number"
}
}
}
}
}
}
Switch Unit Hardware Status ¶
POST/v11_1/health/status/{serialNumber}
Use this API command to retrieve fan, temperature and power supply status for the switch unit managed by SmartZone.
Body
{
"filters": [
{
"type": "DOMAIN",
"value": "8b2081d5-9662-40d9-a3db-2a3cf4dde3f7"
}
],
"extraFilters": [
{
"type": "SWITCH",
"value": "60:9C:9F:DA:63:80"
}
],
"extraTimeRange": {
"start": 1547012879222,
"end": 1547016479222,
"interval": 300000
}
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"filters": {
"description": "Filters used to select specific resource scope",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Group type",
"enum": [
"SYSTEM",
"CATEGORY",
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"BLADE",
"SYNCEDSTATUS",
"REGISTRATIONSTATE",
"STATUS",
"SWITCH_GROUP",
"FAMILY_ID",
"PORT",
"SWITCH_ID_PORT_IDENTIFIER",
"transactionId",
"dispatchStatus",
"configType",
"yang",
"removeYang"
],
"type": "string"
},
"value": {
"description": "Group ID",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraFilters": {
"description": "\"AND\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"SWITCH_GROUP",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"transactionId",
"hasLayerThreeConfig",
"clientAuthType",
"clientIpv4Addr",
"clientIpv6Addr",
"clientMac",
"clientUserName",
"switchName",
"ADMIN_STATUS",
"PORT_STATUS",
"POE_ENABLED",
"cliType",
"dispatchStatus",
"configType",
"yang",
"removeYang",
"reservedField1",
"FIRMWARE",
"dot1XIpv4Addr",
"dot1XIpv6Addr"
],
"type": "string"
},
"value": {
"description": "Value to search",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraNotFilters": {
"description": "\"NOT\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"switchStatus.alerts",
"switchStatus.status",
"transactionId",
"hasLayerThreeConfig",
"reservedField1",
"dispatchStatus",
"configType",
"clis",
"yang",
"removeYang",
"clientType"
],
"type": "string"
},
"value": {
"description": "Value not to search",
"type": "string"
}
}
}
},
"options": {
"description": "Specified feature required informaion",
"type": "object",
"additionalProperties": false,
"properties": {
"auth_includeNa": {
"description": "Include Not Available auth service option while returning result",
"type": "boolean"
},
"auth_includeLocalDb": {
"description": "Include LocalDB auth service while returning result",
"type": "boolean"
},
"auth_includeGuest": {
"description": "Include Guest auth service while returning result",
"type": "boolean"
},
"auth_includeAdGlobal": {
"description": "If AD is in list, include only AD with Global Catalog configured",
"type": "boolean"
},
"auth_type": {
"description": "Authentication service types to get, use comma to separate, Ex: RADIUS,AD",
"type": "string"
},
"auth_realmType": {
"description": "To get specific authentication service information for configuring realm based authentication profile",
"enum": [
"ALL",
"RADIUS"
],
"type": "string"
},
"acct_type": {
"description": "Accounting service types to get, use comma to separate, Ex: RADIUS,CGF",
"type": "string"
},
"auth_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_includeNa": {
"description": "Include Not Available acct service option while returning result",
"type": "boolean"
},
"forwarding_type": {
"description": "Forwarding service types to get, use comma to separate, Ex: L2oGRE,TTGPDG,Bridge,Advanced",
"type": "string"
},
"includeSharedResources": {
"description": "Whether to include the resources of parent domain or not",
"type": "boolean"
},
"INCLUDE_RBAC_METADATA": {
"description": "Whether to include RBAC metadata or not",
"type": "boolean"
},
"TENANT_ID": {
"description": "Specify Tenant ID for query",
"type": "string"
},
"inMap": {
"description": "Specify inMap status for query",
"type": "boolean"
},
"globalFilterId": {
"description": "Specify GlobalFilter ID for query",
"type": "string"
},
"auth_hostedAaaSupportedEnabled": {
"description": "Indicate if Hosted AAA Support is enabled",
"type": "boolean"
},
"auth_plmnIdentifierEnabled": {
"description": "Indicate if Configure PLMN identifier is enabled",
"type": "boolean"
},
"includeUsers": {
"description": "Should also retrieve users or not",
"type": "boolean"
}
}
},
"extraTimeRange": {
"description": "Specified data time range of selection",
"type": "object",
"additionalProperties": false,
"properties": {
"start": {
"description": "start time for collecting data",
"type": "number"
},
"end": {
"description": "end time for collecting data",
"type": "number"
},
"interval": {
"description": "time interval in second",
"type": "number"
},
"field": {
"description": "time field for collecting data",
"enum": [
"insertionTime",
"startTime",
"endTime"
],
"type": "string"
}
}
},
"fullTextSearch": {
"description": "Specified search string",
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Search logic operator",
"enum": [
"AND",
"OR"
],
"type": "string"
},
"value": {
"description": "Text or number to search",
"type": "string"
},
"fields": {
"description": "Specific fields to search",
"type": "array",
"items": {
"type": "string"
}
}
}
},
"sortInfo": {
"description": "About sorting",
"type": "object",
"additionalProperties": false,
"properties": {
"sortColumn": {
"type": "string"
},
"dir": {
"enum": [
"ASC",
"DESC"
],
"type": "string"
}
}
},
"page": {
"description": "Page number to get",
"type": "integer",
"minimum": 1
},
"limit": {
"description": "Size of one page",
"type": "integer",
"minimum": 1
},
"expandDomains": {
"description": "Whether to expand domains into sub domains/ zones or not",
"type": "boolean"
},
"criteria": {
"description": "Add backward compatibility for UI framework",
"type": "string"
},
"query": {
"description": "Add backward compatibility for UI framework",
"type": "string"
}
}
}
200
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"onlineCount": {
"description": "Online status count",
"type": "integer"
},
"flaggedCount": {
"description": "Flagged status count",
"type": "integer"
},
"offlineCount": {
"description": "Offline status count",
"type": "integer"
},
"powerSupply": {
"description": "Powersupply",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"serialNumber": {
"type": "string"
},
"slotNumber": {
"description": "Power supply slot number",
"type": "integer"
},
"type": {
"description": "Power supply type",
"type": "string"
},
"status": {
"description": "Power supply status",
"type": "string"
}
}
}
},
"temperature": {
"description": "Temperature",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"slotNumber": {
"description": "Solt number",
"type": "integer"
},
"temperatureValue": {
"description": "Slot temperature",
"type": "number"
},
"serialNumber": {
"type": "string"
}
}
}
},
"fan": {
"description": "Fan",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"serialNumber": {
"type": "string"
},
"slotNumber": {
"description": "Fan slot number",
"type": "integer"
},
"type": {
"description": "Fan type",
"type": "string"
},
"status": {
"description": "Fan status",
"type": "string"
}
}
}
},
"powerHealthStatus": {
"description": "Health status for ICX/Stack that contains power supply, temperature and fan",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"serialNumber": {
"type": "string"
},
"fan": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"serialNumber": {
"type": "string"
},
"slotNumber": {
"description": "Fan slot number",
"type": "integer"
},
"type": {
"description": "Fan type",
"type": "string"
},
"status": {
"description": "Fan status",
"type": "string"
}
}
}
},
"temperature": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"slotNumber": {
"description": "Solt number",
"type": "integer"
},
"temperatureValue": {
"description": "Slot temperature",
"type": "number"
},
"serialNumber": {
"type": "string"
}
}
}
},
"powerSupply": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"serialNumber": {
"type": "string"
},
"slotNumber": {
"description": "Power supply slot number",
"type": "integer"
},
"type": {
"description": "Power supply type",
"type": "string"
},
"status": {
"description": "Power supply status",
"type": "string"
}
}
}
}
}
}
}
}
}
CPU Trend ¶
POST/v11_1/health/cpu/line
Use this API command to retrieve CPU trend data based on the time duration.
Body
{
"filters": [
{
"type": "DOMAIN",
"value": "8b2081d5-9662-40d9-a3db-2a3cf4dde3f7"
}
],
"extraFilters": [
{
"type": "SWITCH",
"value": "60:9C:9F:DA:63:80"
}
],
"extraTimeRange": {
"start": 1547012879222,
"end": 1547016479222,
"interval": 300000
}
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"filters": {
"description": "Filters used to select specific resource scope",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Group type",
"enum": [
"SYSTEM",
"CATEGORY",
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"BLADE",
"SYNCEDSTATUS",
"REGISTRATIONSTATE",
"STATUS",
"SWITCH_GROUP",
"FAMILY_ID",
"PORT",
"SWITCH_ID_PORT_IDENTIFIER",
"transactionId",
"dispatchStatus",
"configType",
"yang",
"removeYang"
],
"type": "string"
},
"value": {
"description": "Group ID",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraFilters": {
"description": "\"AND\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"SWITCH_GROUP",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"transactionId",
"hasLayerThreeConfig",
"clientAuthType",
"clientIpv4Addr",
"clientIpv6Addr",
"clientMac",
"clientUserName",
"switchName",
"ADMIN_STATUS",
"PORT_STATUS",
"POE_ENABLED",
"cliType",
"dispatchStatus",
"configType",
"yang",
"removeYang",
"reservedField1",
"FIRMWARE",
"dot1XIpv4Addr",
"dot1XIpv6Addr"
],
"type": "string"
},
"value": {
"description": "Value to search",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraNotFilters": {
"description": "\"NOT\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"switchStatus.alerts",
"switchStatus.status",
"transactionId",
"hasLayerThreeConfig",
"reservedField1",
"dispatchStatus",
"configType",
"clis",
"yang",
"removeYang",
"clientType"
],
"type": "string"
},
"value": {
"description": "Value not to search",
"type": "string"
}
}
}
},
"options": {
"description": "Specified feature required informaion",
"type": "object",
"additionalProperties": false,
"properties": {
"auth_includeNa": {
"description": "Include Not Available auth service option while returning result",
"type": "boolean"
},
"auth_includeLocalDb": {
"description": "Include LocalDB auth service while returning result",
"type": "boolean"
},
"auth_includeGuest": {
"description": "Include Guest auth service while returning result",
"type": "boolean"
},
"auth_includeAdGlobal": {
"description": "If AD is in list, include only AD with Global Catalog configured",
"type": "boolean"
},
"auth_type": {
"description": "Authentication service types to get, use comma to separate, Ex: RADIUS,AD",
"type": "string"
},
"auth_realmType": {
"description": "To get specific authentication service information for configuring realm based authentication profile",
"enum": [
"ALL",
"RADIUS"
],
"type": "string"
},
"acct_type": {
"description": "Accounting service types to get, use comma to separate, Ex: RADIUS,CGF",
"type": "string"
},
"auth_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_includeNa": {
"description": "Include Not Available acct service option while returning result",
"type": "boolean"
},
"forwarding_type": {
"description": "Forwarding service types to get, use comma to separate, Ex: L2oGRE,TTGPDG,Bridge,Advanced",
"type": "string"
},
"includeSharedResources": {
"description": "Whether to include the resources of parent domain or not",
"type": "boolean"
},
"INCLUDE_RBAC_METADATA": {
"description": "Whether to include RBAC metadata or not",
"type": "boolean"
},
"TENANT_ID": {
"description": "Specify Tenant ID for query",
"type": "string"
},
"inMap": {
"description": "Specify inMap status for query",
"type": "boolean"
},
"globalFilterId": {
"description": "Specify GlobalFilter ID for query",
"type": "string"
},
"auth_hostedAaaSupportedEnabled": {
"description": "Indicate if Hosted AAA Support is enabled",
"type": "boolean"
},
"auth_plmnIdentifierEnabled": {
"description": "Indicate if Configure PLMN identifier is enabled",
"type": "boolean"
},
"includeUsers": {
"description": "Should also retrieve users or not",
"type": "boolean"
}
}
},
"extraTimeRange": {
"description": "Specified data time range of selection",
"type": "object",
"additionalProperties": false,
"properties": {
"start": {
"description": "start time for collecting data",
"type": "number"
},
"end": {
"description": "end time for collecting data",
"type": "number"
},
"interval": {
"description": "time interval in second",
"type": "number"
},
"field": {
"description": "time field for collecting data",
"enum": [
"insertionTime",
"startTime",
"endTime"
],
"type": "string"
}
}
},
"fullTextSearch": {
"description": "Specified search string",
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Search logic operator",
"enum": [
"AND",
"OR"
],
"type": "string"
},
"value": {
"description": "Text or number to search",
"type": "string"
},
"fields": {
"description": "Specific fields to search",
"type": "array",
"items": {
"type": "string"
}
}
}
},
"sortInfo": {
"description": "About sorting",
"type": "object",
"additionalProperties": false,
"properties": {
"sortColumn": {
"type": "string"
},
"dir": {
"enum": [
"ASC",
"DESC"
],
"type": "string"
}
}
},
"page": {
"description": "Page number to get",
"type": "integer",
"minimum": 1
},
"limit": {
"description": "Size of one page",
"type": "integer",
"minimum": 1
},
"expandDomains": {
"description": "Whether to expand domains into sub domains/ zones or not",
"type": "boolean"
},
"criteria": {
"description": "Add backward compatibility for UI framework",
"type": "string"
},
"query": {
"description": "Add backward compatibility for UI framework",
"type": "string"
}
}
}
200
Body
{
"rawDataTotalCount": 0,
"totalCount": 6,
"hasMore": false,
"firstIndex": 0,
"list": [
{
"timestamp": "2018-06-15 07:33:50",
"max": 30,
"avg": 30,
"min": 30
},
{
"timestamp": "2018-06-15 07:38:50",
"max": 1,
"avg": 1,
"min": 1
},
{
"timestamp": "2018-06-15 07:43:50",
"max": 1,
"avg": 1,
"min": 1
},
{
"timestamp": "2018-06-15 07:48:50",
"max": 1,
"avg": 1,
"min": 1
},
{
"timestamp": "2018-06-15 07:53:50",
"max": 1,
"avg": 1,
"min": 1
},
{
"timestamp": "2018-06-15 07:58:50",
"max": 1,
"avg": 1,
"min": 1
}
],
"extra": null
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"rawDataTotalCount": {
"description": "ICX Metrics count",
"type": "integer"
},
"totalCount": {
"description": "Total of ICX Metrics count",
"type": "integer"
},
"hasMore": {
"description": "Indicates if there are more ICX Metrics after the currently displayed list",
"type": "boolean"
},
"firstIndex": {
"description": "Index of the first ICX Metrics returned out of the complete ICX Metrics list",
"type": "integer"
},
"extra": {
"description": "Extra information for ICX Metrics",
"type": "object"
},
"list": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"timestamp": {
"description": "Timestamp",
"type": "string"
},
"max": {
"description": "Max metrics",
"type": "number"
},
"min": {
"description": "Min metrics",
"type": "number"
},
"avg": {
"description": "Average metrics",
"type": "number"
}
}
}
}
}
}
Memory Trend ¶
POST/v11_1/health/mem/line
Use this API command to retrieve switch memory trend data based on the time duration.
Body
{
"filters": [
{
"type": "DOMAIN",
"value": "8b2081d5-9662-40d9-a3db-2a3cf4dde3f7"
}
],
"extraFilters": [
{
"type": "SWITCH",
"value": "60:9C:9F:DA:63:80"
}
],
"extraTimeRange": {
"start": 1547012879222,
"end": 1547016479222,
"interval": 300000
}
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"filters": {
"description": "Filters used to select specific resource scope",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Group type",
"enum": [
"SYSTEM",
"CATEGORY",
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"BLADE",
"SYNCEDSTATUS",
"REGISTRATIONSTATE",
"STATUS",
"SWITCH_GROUP",
"FAMILY_ID",
"PORT",
"SWITCH_ID_PORT_IDENTIFIER",
"transactionId",
"dispatchStatus",
"configType",
"yang",
"removeYang"
],
"type": "string"
},
"value": {
"description": "Group ID",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraFilters": {
"description": "\"AND\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"SWITCH_GROUP",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"transactionId",
"hasLayerThreeConfig",
"clientAuthType",
"clientIpv4Addr",
"clientIpv6Addr",
"clientMac",
"clientUserName",
"switchName",
"ADMIN_STATUS",
"PORT_STATUS",
"POE_ENABLED",
"cliType",
"dispatchStatus",
"configType",
"yang",
"removeYang",
"reservedField1",
"FIRMWARE",
"dot1XIpv4Addr",
"dot1XIpv6Addr"
],
"type": "string"
},
"value": {
"description": "Value to search",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraNotFilters": {
"description": "\"NOT\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"switchStatus.alerts",
"switchStatus.status",
"transactionId",
"hasLayerThreeConfig",
"reservedField1",
"dispatchStatus",
"configType",
"clis",
"yang",
"removeYang",
"clientType"
],
"type": "string"
},
"value": {
"description": "Value not to search",
"type": "string"
}
}
}
},
"options": {
"description": "Specified feature required informaion",
"type": "object",
"additionalProperties": false,
"properties": {
"auth_includeNa": {
"description": "Include Not Available auth service option while returning result",
"type": "boolean"
},
"auth_includeLocalDb": {
"description": "Include LocalDB auth service while returning result",
"type": "boolean"
},
"auth_includeGuest": {
"description": "Include Guest auth service while returning result",
"type": "boolean"
},
"auth_includeAdGlobal": {
"description": "If AD is in list, include only AD with Global Catalog configured",
"type": "boolean"
},
"auth_type": {
"description": "Authentication service types to get, use comma to separate, Ex: RADIUS,AD",
"type": "string"
},
"auth_realmType": {
"description": "To get specific authentication service information for configuring realm based authentication profile",
"enum": [
"ALL",
"RADIUS"
],
"type": "string"
},
"acct_type": {
"description": "Accounting service types to get, use comma to separate, Ex: RADIUS,CGF",
"type": "string"
},
"auth_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_includeNa": {
"description": "Include Not Available acct service option while returning result",
"type": "boolean"
},
"forwarding_type": {
"description": "Forwarding service types to get, use comma to separate, Ex: L2oGRE,TTGPDG,Bridge,Advanced",
"type": "string"
},
"includeSharedResources": {
"description": "Whether to include the resources of parent domain or not",
"type": "boolean"
},
"INCLUDE_RBAC_METADATA": {
"description": "Whether to include RBAC metadata or not",
"type": "boolean"
},
"TENANT_ID": {
"description": "Specify Tenant ID for query",
"type": "string"
},
"inMap": {
"description": "Specify inMap status for query",
"type": "boolean"
},
"globalFilterId": {
"description": "Specify GlobalFilter ID for query",
"type": "string"
},
"auth_hostedAaaSupportedEnabled": {
"description": "Indicate if Hosted AAA Support is enabled",
"type": "boolean"
},
"auth_plmnIdentifierEnabled": {
"description": "Indicate if Configure PLMN identifier is enabled",
"type": "boolean"
},
"includeUsers": {
"description": "Should also retrieve users or not",
"type": "boolean"
}
}
},
"extraTimeRange": {
"description": "Specified data time range of selection",
"type": "object",
"additionalProperties": false,
"properties": {
"start": {
"description": "start time for collecting data",
"type": "number"
},
"end": {
"description": "end time for collecting data",
"type": "number"
},
"interval": {
"description": "time interval in second",
"type": "number"
},
"field": {
"description": "time field for collecting data",
"enum": [
"insertionTime",
"startTime",
"endTime"
],
"type": "string"
}
}
},
"fullTextSearch": {
"description": "Specified search string",
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Search logic operator",
"enum": [
"AND",
"OR"
],
"type": "string"
},
"value": {
"description": "Text or number to search",
"type": "string"
},
"fields": {
"description": "Specific fields to search",
"type": "array",
"items": {
"type": "string"
}
}
}
},
"sortInfo": {
"description": "About sorting",
"type": "object",
"additionalProperties": false,
"properties": {
"sortColumn": {
"type": "string"
},
"dir": {
"enum": [
"ASC",
"DESC"
],
"type": "string"
}
}
},
"page": {
"description": "Page number to get",
"type": "integer",
"minimum": 1
},
"limit": {
"description": "Size of one page",
"type": "integer",
"minimum": 1
},
"expandDomains": {
"description": "Whether to expand domains into sub domains/ zones or not",
"type": "boolean"
},
"criteria": {
"description": "Add backward compatibility for UI framework",
"type": "string"
},
"query": {
"description": "Add backward compatibility for UI framework",
"type": "string"
}
}
}
200
Body
{
"rawDataTotalCount": 0,
"totalCount": 6,
"hasMore": false,
"firstIndex": 0,
"list": [
{
"timestamp": "2018-06-15 07:33:50",
"max": 30,
"avg": 30,
"min": 30
},
{
"timestamp": "2018-06-15 07:38:50",
"max": 1,
"avg": 1,
"min": 1
},
{
"timestamp": "2018-06-15 07:43:50",
"max": 1,
"avg": 1,
"min": 1
},
{
"timestamp": "2018-06-15 07:48:50",
"max": 1,
"avg": 1,
"min": 1
},
{
"timestamp": "2018-06-15 07:53:50",
"max": 1,
"avg": 1,
"min": 1
},
{
"timestamp": "2018-06-15 07:58:50",
"max": 1,
"avg": 1,
"min": 1
}
],
"extra": null
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"rawDataTotalCount": {
"description": "ICX Metrics count",
"type": "integer"
},
"totalCount": {
"description": "Total of ICX Metrics count",
"type": "integer"
},
"hasMore": {
"description": "Indicates if there are more ICX Metrics after the currently displayed list",
"type": "boolean"
},
"firstIndex": {
"description": "Index of the first ICX Metrics returned out of the complete ICX Metrics list",
"type": "integer"
},
"extra": {
"description": "Extra information for ICX Metrics",
"type": "object"
},
"list": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"timestamp": {
"description": "Timestamp",
"type": "string"
},
"max": {
"description": "Max metrics",
"type": "number"
},
"min": {
"description": "Min metrics",
"type": "number"
},
"avg": {
"description": "Average metrics",
"type": "number"
}
}
}
}
}
}
Switch Stack ¶
Get Stack Configuration ¶
GET/v11_1/stack/{switchId}
Use this API command to retrieve a stack configuration configured via SZ.
200
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"switchId": {
"description": "Switch Id",
"type": "string"
},
"activeSwitchId": {
"description": "Switch Id of Active Unit",
"type": "string"
},
"isActiveRole": {
"description": "Switch role is Active, True (Active) or False (Standby or Member)",
"type": "boolean"
},
"suggestedId": {
"description": "Suggested switch unit Id in stack, 1 ~ 12",
"type": "integer"
}
}
}
Get Stack Members ¶
GET/v11_1/stack/member/{switchId}
Use this API command to retrieve the member of switches in a stack.
200
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"rawDataTotalCount": {
"description": "Stack count",
"type": "integer"
},
"totalCount": {
"description": "Total Stack count",
"type": "integer"
},
"hasMore": {
"description": "Indicator of whether there are more stack after the current displayed list",
"type": "boolean"
},
"firstIndex": {
"description": "Index of the first stack returned out of the complete stack list",
"type": "integer"
},
"list": {
"description": "List of stack",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"switchName": {
"description": "Switch name of stack",
"type": "string"
},
"model": {
"description": "Switch model of stack",
"type": "string"
},
"ports": {
"description": "Port count of stack",
"type": "integer"
},
"portStatus": {
"description": "Port status Information",
"type": "object",
"additionalProperties": false,
"properties": {
"speed": {
"description": "Port speed of stack",
"type": "string"
},
"up": {
"description": "Count for port status is up of stack",
"type": "integer"
},
"warning": {
"description": "Count for port status is warring of stack",
"type": "integer"
},
"down": {
"description": "Count for port status is down of stack",
"type": "integer"
},
"total": {
"description": "Total port count of stack",
"type": "integer"
},
"adminDown": {
"description": "Count for port status is admin down of stack",
"type": "integer"
}
}
},
"serialNumber": {
"description": "Serial number of stack",
"type": "string"
},
"activeMode": {
"description": "Role of stack",
"type": "string"
},
"switchUnit": {
"description": "Switch unit of stack",
"type": "string"
},
"switchUnitState": {
"description": "Switch unit state of stack",
"type": "string"
},
"switchModule": {
"description": "Switch module of stack",
"type": "string"
},
"poe": {
"description": "Information of PoE",
"type": "object",
"additionalProperties": false,
"properties": {
"total": {
"description": "Total power capacity of a switch unit in stack",
"type": "integer"
},
"free": {
"description": "Free power capacity of a switch unit in stack",
"type": "integer"
},
"percent": {
"description": "Percentage of power usage for a switch unit in stack",
"type": "number"
}
}
},
"switchPorts": {
"description": "Switch port information of stack",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"description": "Identifier of switch port",
"type": "string"
},
"sampledInstant": {
"description": "Sampled instant of switch port",
"type": "string"
},
"name": {
"description": "Name of switch port",
"type": "string"
},
"switchName": {
"description": "Switch name of stack",
"type": "string"
},
"switchGroup": {
"description": "Switch group of switch port",
"type": "string"
},
"mac": {
"description": "Mac address of switch port",
"type": "string"
},
"type": {
"description": "Type of switch port",
"type": "string"
},
"status": {
"description": "Status of switch port",
"type": "string"
},
"adminStatus": {
"description": "Admin Status of switch port",
"type": "string"
},
"vlans": {
"description": "Switch port include vlans",
"type": "string"
},
"poe": {
"description": "PoE information of switch port",
"type": "object",
"additionalProperties": false,
"properties": {
"total": {
"description": "Total power capacity of switch port",
"type": "integer"
},
"free": {
"description": "Free power capacity of switch port",
"type": "integer"
},
"percent": {
"description": "Power used percentage of switch port",
"type": "number"
}
}
},
"neighborName": {
"description": "Neighbor name of switch port",
"type": "string"
},
"portSpeed": {
"description": "Port speed of switch port",
"type": "string"
},
"stpState": {
"description": "STP state of switch port",
"type": "integer"
},
"inUtilization": {
"description": "In utilization of switch port",
"type": "number"
},
"outUtilization": {
"description": "Out utilization of switch port",
"type": "number"
},
"opticsType": {
"description": "Optics type of switch port",
"type": "string"
},
"connectedDevice": {
"description": "Connected device information",
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"description": "Identifier of switch port connected device",
"type": "string"
},
"localPortMac": {
"description": "Local port mac address of connected device",
"type": "string"
},
"remotePortMac": {
"description": "Remote port mac address of connected device",
"type": "string"
},
"remoteDeviceName": {
"description": "Remote device name of connected device",
"type": "string"
},
"remotePortType": {
"description": "Remote port type of connected device",
"type": "string"
},
"remotePortDesc": {
"description": "Remote port description of connected device",
"type": "string"
},
"localPort": {
"description": "Local port description of connected device",
"type": "string"
},
"remotePort": {
"description": "Remote port number of connected device",
"type": "string"
},
"isRuckusAP": {
"description": "Connected devices is RuckusAP,True or False",
"type": "string"
},
"domainId": {
"description": "Identifier of the management domain to which the connected device belong",
"type": "string"
},
"tenantId": {
"description": "Tenant Id of stack",
"type": "string"
},
"switchGroupLevelOneId": {
"description": "Switch group level one Id",
"type": "string"
},
"switchGroupLevelTwoId": {
"description": "Switch group level two Id",
"type": "string"
},
"switchId": {
"description": "Switch Id",
"type": "string"
},
"unitId": {
"description": "Unit Id",
"type": "string"
},
"localPortIfaceName": {
"description": "Local port interface name",
"type": "string"
},
"switchName": {
"description": "Switch name",
"type": "string"
},
"switchGroup": {
"description": "Switch group",
"type": "string"
}
}
},
"trafficUsage": {
"description": "Traffic usage information",
"type": "object",
"additionalProperties": false,
"properties": {
"tx": {
"description": "Tx traffic usage of switch port",
"type": "integer"
},
"rx": {
"description": "Rx traffic usage of switch port",
"type": "integer"
}
}
},
"poeEnabled": {
"description": "PoE Enabled, True or False",
"type": "boolean"
},
"usedInFormingStack": {
"description": "Used in forming stack, True or False",
"type": "boolean"
},
"lagName": {
"description": "LAG name of switch port",
"type": "string"
},
"unTaggedVlan": {
"description": "Untagged vlan of switch port",
"type": "string"
},
"portIdentifier": {
"description": "Port Identifier of switch port",
"type": "string"
}
}
}
}
}
}
}
}
}
Create Stack Configuration ¶
POST/v11_1/stack
Use this API command to create a stack configuration.
Body
[
{
"switchId": "18:A0:12:32:00:00",
"isActiveRole": true
},
{
"switchId": "18:A0:12:32:00:01",
"isActiveRole": false,
"suggestedId": 3
}
]
Schema
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"switchId": {
"description": "Switch Id",
"type": "string"
},
"activeSwitchId": {
"description": "Switch Id of Active Unit",
"type": "string"
},
"isActiveRole": {
"description": "Switch role is Active, True (Active) or False (Standby or Member)",
"type": "boolean"
},
"suggestedId": {
"description": "Suggested switch unit Id in stack, 1 ~ 12",
"type": "integer"
}
}
}
}
200
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"rawDataTotalCount": {
"type": "integer"
},
"totalCount": {
"type": "integer"
},
"hasMore": {
"type": "boolean"
},
"firstIndex": {
"type": "integer"
},
"extra": {
"type": "object"
},
"list": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"description": "Audit Id",
"type": "string"
},
"name": {
"description": "Audit name",
"type": "string"
}
}
}
}
}
}
Switch ¶
Get Switch ¶
GET/v11_1/switch/{id}
Use this API command to retrieve a switch status.
200
Body
{
"id": "60:9C:9F:DA:63:80",
"switchName": "ICX7750-1",
"macAddress": "60:9C:9F:DA:63:80",
"model": "ICX7750-48XGC",
"ipAddress": "192.168.240.31",
"registrationStatus": "APPROVED",
"ports": 54,
"portStatus": null,
"numOfUnits": 1,
"alarm": 0,
"upTime": "1:54:34.00",
"firmwareVersion": "SWS08080b254",
"modules": "switch",
"serialNumber": "CRJ3333N00K",
"ipAddressType": null,
"defaultGateway": "192.168.253.253",
"groupName": "21ed3a40-34a7-4d13-844c-783c66074d7a",
"groupId": "21ed3a40-34a7-4d13-844c-783c66074d7a",
"groupConfigMode": "CLI",
"groupFirmware": "FI08090",
"parentGroupId": null,
"stackId": null,
"domainId": "8b2081d5-9662-40d9-a3db-2a3cf4dde3f7",
"status": "ONLINE",
"lastBackupTime": 1529337901991,
"lastRestoreTime": null,
"lastBackupStatus": "SUCCESS",
"lastRestoreStatus": null,
"firmwareUpdate": null,
"localsyncStatus": "LOCAL_SYNC_NONE"
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"description": "Identifier of switch",
"type": "string"
},
"switchName": {
"description": "Switch name",
"type": "string"
},
"macAddress": {
"description": "Switch mac address",
"type": "string"
},
"model": {
"description": "Switch model",
"type": "string"
},
"family": {
"description": "Switch Model Family",
"type": "string"
},
"ipAddress": {
"description": "switch IP address",
"type": "string"
},
"registrationStatus": {
"description": "Status for switch registater to ICX-M",
"type": "string"
},
"ports": {
"description": "Total port count",
"type": "integer"
},
"portStatus": {
"description": "Information of port status",
"type": "object",
"additionalProperties": false,
"properties": {
"speed": {
"description": "Port speed of switch",
"type": "string"
},
"up": {
"description": "Count for port status is up of switch",
"type": "integer"
},
"warning": {
"description": "Count for port status is warring of switch",
"type": "integer"
},
"down": {
"description": "Count for port status is down of switch",
"type": "integer"
},
"total": {
"description": "Total count for port status of switch",
"type": "integer"
},
"adminDown": {
"description": "Count for port status is admin down of switch",
"type": "integer"
},
"speedInt": {
"description": "Switch port fully speed",
"type": "integer"
}
}
},
"numOfUnits": {
"description": "Count of switch unit",
"type": "integer"
},
"poe": {
"description": "Information of PoE",
"type": "object",
"additionalProperties": false,
"properties": {
"total": {
"description": "Total power capacity of a switch",
"type": "integer"
},
"free": {
"description": "Free power capacity of a switch",
"type": "integer"
},
"percent": {
"description": "Percentage of power usage for a switch",
"type": "number"
}
}
},
"alarm": {
"description": "Count of switch alarm",
"type": "integer"
},
"upTime": {
"description": "SWitch uptime",
"type": "string"
},
"firmwareVersion": {
"description": "Switch firmware version",
"type": "string"
},
"modules": {
"description": "Stack or Switch",
"type": "string"
},
"serialNumber": {
"description": "Switch serial number",
"type": "string"
},
"ipAddressType": {
"description": "IP address type",
"type": "string"
},
"defaultGateway": {
"description": "Default gateway of switch",
"type": "string"
},
"groupName": {
"description": "Name of switch group",
"type": "string"
},
"groupId": {
"description": "Identifier of switch group",
"type": "string"
},
"groupConfigMode": {
"description": "Config mode of switch group",
"type": "string"
},
"groupFirmware": {
"description": "Firmware of switch group",
"type": "string"
},
"parentGroupId": {
"description": "Identifier of parent switch group",
"type": "string"
},
"stackId": {
"description": "Stack Id",
"type": "string"
},
"domainId": {
"description": "Identifier of the management domain to which the switch belong",
"type": "string"
},
"status": {
"description": "Status of switch, Ex: ONLINE, OFFLINE",
"type": "string"
},
"lastBackupTime": {
"description": "Last config backup time of switch",
"type": "integer",
"format": "int64"
},
"lastRestoreTime": {
"description": "Last config restore time of switch",
"type": "integer",
"format": "int64"
},
"lastBackupStatus": {
"description": "Last config backup status of switch",
"type": "string",
"enum": [
"STARTED",
"SUCCESS",
"FAILED"
]
},
"lastRestoreStatus": {
"description": "Last config restore status of switch",
"type": "string",
"enum": [
"STARTED",
"SUCCESS",
"FAILED"
]
},
"firmwareUpdate": {
"description": "Information of firmware update",
"type": "object",
"additionalProperties": false,
"properties": {
"scheduleId": {
"description": "Schedule Id of firmware update",
"type": "string"
},
"scheduledTime": {
"description": "Scheduled time of firmware update",
"type": "string"
},
"modifiedTime": {
"description": "Modified time of the firmware update scheduled",
"type": "string"
},
"status": {
"description": "Status of firmware update",
"type": "string"
},
"toVersion": {
"description": "Update to which firmware version",
"type": "string"
}
}
},
"supportedCsl": {
"description": "Supported CSL of switch",
"type": "integer",
"format": "int32"
},
"backupDiffWithMaster": {
"description": "Indicate there is a config backup different from the master backup",
"type": "boolean"
},
"siteActive": {
"description": "Data Plane Ip, for Network Segmentation",
"type": "string"
},
"siteConnection": {
"description": "Data Plane Connection status, for Network Segmentation",
"type": "string"
},
"localsyncStatus": {
"description": "Status of LocalSync",
"type": "string",
"enum": [
"LOCAL_SYNC_NONE",
"LOCAL_SYNCING"
]
}
}
}
Get Switch Firmware Update History ¶
GET/v11_1/switch/{switchId}/firmware
Use this API command to get a list of firmware update history.
200
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"rawDataTotalCount": {
"description": "Firmware history list count",
"type": "integer"
},
"totalCount": {
"description": "Total firmware history list count",
"type": "integer"
},
"hasMore": {
"description": "Indicator of whether there are more firmware history after the current displayed list",
"type": "boolean"
},
"firstIndex": {
"description": "Index of the first firmware history returned out of the complete query list",
"type": "integer"
},
"extra": {
"description": "Any additional response data",
"type": "object"
},
"list": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"timestamp": {
"description": "Timestamp of fireware update",
"type": "number"
},
"fromVersion": {
"description": "Original fireware version before firmware update",
"type": "string"
},
"toVersion": {
"description": "Firmware version after firmware update",
"type": "string"
}
}
}
}
}
}
Retrieve Switch Model List ¶
GET/v11_1/switchModel/list
Use this API command to Retrieve Switch Model List.
200
Body
{
"rawDataTotalCount": 0,
"totalCount": 8,
"hasMore": false,
"firstIndex": 0,
"list": [
{
"model": "ICX7150-C08P"
},
{
"model": "ICX7150-C10ZP"
},
{
"model": "ICX7150-C12P"
},
{
"model": "ICX7150-24"
},
{
"model": "ICX7150-48"
},
{
"model": "ICX7250-24"
},
{
"model": "ICX7450-24"
},
{
"model": "ICX7650-48ZP"
}
],
"extra": null
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"rawDataTotalCount": {
"description": "Total Data Count",
"type": "integer"
},
"totalCount": {
"description": "Total Data Count",
"type": "integer"
},
"hasMore": {
"description": "Indicator of remaining data",
"type": "boolean"
},
"firstIndex": {
"description": "The first data index for current reulst",
"type": "integer"
},
"extra": {
"description": "Extra field",
"type": "object"
},
"list": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"model": {
"description": "Switch Model",
"type": "string"
}
}
}
}
}
}
List Switches ¶
POST/v11_1/switch
Use this API command to retrieve all the switches currently managed by SmartZone.
Body
{
"filters": [
{
"type": "DOMAIN",
"value": "8b2081d5-9662-40d9-a3db-2a3cf4dde3f7"
}
],
"fullTextSearch": {
"type": "AND",
"value": ""
},
"sortInfo": {
"sortColumn": "serialNumber",
"dir": "ASC"
},
"page": 1,
"limit": 8
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"filters": {
"description": "Filters used to select specific resource scope",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Group type",
"enum": [
"SYSTEM",
"CATEGORY",
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"BLADE",
"SYNCEDSTATUS",
"REGISTRATIONSTATE",
"STATUS",
"SWITCH_GROUP",
"FAMILY_ID",
"PORT",
"SWITCH_ID_PORT_IDENTIFIER",
"transactionId",
"dispatchStatus",
"configType",
"yang",
"removeYang"
],
"type": "string"
},
"value": {
"description": "Group ID",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraFilters": {
"description": "\"AND\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"SWITCH_GROUP",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"transactionId",
"hasLayerThreeConfig",
"clientAuthType",
"clientIpv4Addr",
"clientIpv6Addr",
"clientMac",
"clientUserName",
"switchName",
"ADMIN_STATUS",
"PORT_STATUS",
"POE_ENABLED",
"cliType",
"dispatchStatus",
"configType",
"yang",
"removeYang",
"reservedField1",
"FIRMWARE",
"dot1XIpv4Addr",
"dot1XIpv6Addr"
],
"type": "string"
},
"value": {
"description": "Value to search",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraNotFilters": {
"description": "\"NOT\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"switchStatus.alerts",
"switchStatus.status",
"transactionId",
"hasLayerThreeConfig",
"reservedField1",
"dispatchStatus",
"configType",
"clis",
"yang",
"removeYang",
"clientType"
],
"type": "string"
},
"value": {
"description": "Value not to search",
"type": "string"
}
}
}
},
"options": {
"description": "Specified feature required informaion",
"type": "object",
"additionalProperties": false,
"properties": {
"auth_includeNa": {
"description": "Include Not Available auth service option while returning result",
"type": "boolean"
},
"auth_includeLocalDb": {
"description": "Include LocalDB auth service while returning result",
"type": "boolean"
},
"auth_includeGuest": {
"description": "Include Guest auth service while returning result",
"type": "boolean"
},
"auth_includeAdGlobal": {
"description": "If AD is in list, include only AD with Global Catalog configured",
"type": "boolean"
},
"auth_type": {
"description": "Authentication service types to get, use comma to separate, Ex: RADIUS,AD",
"type": "string"
},
"auth_realmType": {
"description": "To get specific authentication service information for configuring realm based authentication profile",
"enum": [
"ALL",
"RADIUS"
],
"type": "string"
},
"acct_type": {
"description": "Accounting service types to get, use comma to separate, Ex: RADIUS,CGF",
"type": "string"
},
"auth_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_includeNa": {
"description": "Include Not Available acct service option while returning result",
"type": "boolean"
},
"forwarding_type": {
"description": "Forwarding service types to get, use comma to separate, Ex: L2oGRE,TTGPDG,Bridge,Advanced",
"type": "string"
},
"includeSharedResources": {
"description": "Whether to include the resources of parent domain or not",
"type": "boolean"
},
"INCLUDE_RBAC_METADATA": {
"description": "Whether to include RBAC metadata or not",
"type": "boolean"
},
"TENANT_ID": {
"description": "Specify Tenant ID for query",
"type": "string"
},
"inMap": {
"description": "Specify inMap status for query",
"type": "boolean"
},
"globalFilterId": {
"description": "Specify GlobalFilter ID for query",
"type": "string"
},
"auth_hostedAaaSupportedEnabled": {
"description": "Indicate if Hosted AAA Support is enabled",
"type": "boolean"
},
"auth_plmnIdentifierEnabled": {
"description": "Indicate if Configure PLMN identifier is enabled",
"type": "boolean"
},
"includeUsers": {
"description": "Should also retrieve users or not",
"type": "boolean"
}
}
},
"extraTimeRange": {
"description": "Specified data time range of selection",
"type": "object",
"additionalProperties": false,
"properties": {
"start": {
"description": "start time for collecting data",
"type": "number"
},
"end": {
"description": "end time for collecting data",
"type": "number"
},
"interval": {
"description": "time interval in second",
"type": "number"
},
"field": {
"description": "time field for collecting data",
"enum": [
"insertionTime",
"startTime",
"endTime"
],
"type": "string"
}
}
},
"fullTextSearch": {
"description": "Specified search string",
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Search logic operator",
"enum": [
"AND",
"OR"
],
"type": "string"
},
"value": {
"description": "Text or number to search",
"type": "string"
},
"fields": {
"description": "Specific fields to search",
"type": "array",
"items": {
"type": "string"
}
}
}
},
"sortInfo": {
"description": "About sorting",
"type": "object",
"additionalProperties": false,
"properties": {
"sortColumn": {
"type": "string"
},
"dir": {
"enum": [
"ASC",
"DESC"
],
"type": "string"
}
}
},
"page": {
"description": "Page number to get",
"type": "integer",
"minimum": 1
},
"limit": {
"description": "Size of one page",
"type": "integer",
"minimum": 1
},
"expandDomains": {
"description": "Whether to expand domains into sub domains/ zones or not",
"type": "boolean"
},
"criteria": {
"description": "Add backward compatibility for UI framework",
"type": "string"
},
"query": {
"description": "Add backward compatibility for UI framework",
"type": "string"
}
}
}
200
Body
{
"rawDataTotalCount": 0,
"totalCount": 3,
"hasMore": false,
"firstIndex": 8,
"list": [
{
"id": "18:A0:12:32:00:00",
"switchName": "icx_jemery0",
"macAddress": "18:A0:12:32:00:00",
"model": "ICX7450-48P",
"family": "ICX7450",
"ipAddress": "192.168.239.150",
"registrationStatus": "APPROVED",
"ports": 24,
"portStatus": {
"speed": null,
"up": 13,
"warning": 24,
"down": 0,
"total": null,
"adminDown": null,
"speedInt": 0
},
"numOfUnits": 1,
"poe": {
"total": 0,
"free": 0,
"percent": 0
},
"alarm": 13,
"upTime": "0:00:09.37",
"firmwareVersion": "1.0.0",
"modules": "switch",
"serialNumber": "567866JE0",
"ipAddressType": null,
"defaultGateway": "10.1.200.254",
"groupName": "MyGroup1",
"groupId": "a7058e17-0ce9-41db-b59f-d6222148c43b",
"groupConfigMode": "CLI",
"groupFirmware": "FI08090",
"parentGroupId": "e299823b-dc14-4c1f-985e-f5002bfccb0f",
"stackId": null,
"domainId": "8b2081d5-9662-40d9-a3db-2a3cf4dde3f7",
"status": "OFFLINE",
"lastBackupTime": 1531290000325,
"lastRestoreTime": null,
"lastBackupStatus": "FAILED",
"lastRestoreStatus": null,
"firmwareUpdate": null,
"siteActive": "",
"siteConnection": ""
},
{
"id": "60:9C:9F:DA:63:80",
"switchName": "ICX7750-1",
"macAddress": "60:9C:9F:DA:63:80",
"model": "ICX7750-48XGC",
"ipAddress": "192.168.240.31",
"registrationStatus": "APPROVED",
"ports": 54,
"portStatus": {
"speed": null,
"up": 1,
"warning": 0,
"down": 53,
"total": null,
"adminDown": null,
"speedInt": 0
},
"numOfUnits": 1,
"poe": {
"total": 0,
"free": 0,
"percent": 0
},
"alarm": 2,
"upTime": "6 days, 1:12:22.00",
"firmwareVersion": "SWS08080b254",
"modules": "switch",
"serialNumber": "CRJ3333N00K",
"ipAddressType": null,
"defaultGateway": "192.168.253.253",
"groupName": "RealSwitchGroup1",
"groupId": "e299823b-dc14-4c1f-985e-f5002bfccb0f",
"groupConfigMode": "CLI",
"groupFirmware": "FI08090",
"parentGroupId": null,
"stackId": null,
"domainId": "8b2081d5-9662-40d9-a3db-2a3cf4dde3f7",
"status": "ONLINE",
"lastBackupTime": 1531353601306,
"lastRestoreTime": 1530521401053,
"lastBackupStatus": "SUCCESS",
"lastRestoreStatus": "SUCCESS",
"firmwareUpdate": {
"scheduleId": "firmware-update-ONE_TIME-1530510555674",
"scheduledTime": "",
"modifiedTime": "1530511156376",
"status": "succeeded",
"toVersion": "SWS08080b254"
},
"siteActive": "",
"siteConnection": ""
},
{
"id": "60:9C:9F:E5:C7:00",
"switchName": "ICX7150-1",
"macAddress": "60:9C:9F:E5:C7:00",
"model": "ICX7150-24P",
"ipAddress": "192.168.240.1",
"registrationStatus": "APPROVED",
"ports": 90,
"portStatus": {
"speed": null,
"up": 11,
"warning": 1,
"down": 78,
"total": null,
"adminDown": null,
"speedInt": 0
},
"numOfUnits": 3,
"poe": {
"total": 1110000,
"free": 1079200,
"percent": 0
},
"alarm": 2,
"upTime": "6 days, 1:14:45.00",
"firmwareVersion": "SPS08080b207",
"modules": "stack",
"serialNumber": "FEA3234N0B0",
"ipAddressType": null,
"defaultGateway": "192.168.253.253",
"groupName": "RealSwitchGroup1",
"groupId": "e299823b-dc14-4c1f-985e-f5002bfccb0f",
"groupConfigMode": "CLI",
"parentGroupId": null,
"stackId": null,
"domainId": "8b2081d5-9662-40d9-a3db-2a3cf4dde3f7",
"status": "ONLINE",
"lastBackupTime": 1531353601865,
"lastRestoreTime": null,
"lastBackupStatus": "SUCCESS",
"lastRestoreStatus": null,
"firmwareUpdate": null,
"siteActive": "",
"siteConnection": ""
}
],
"extra": {
"rbacMetadata": [
{
"ICX_CATEGORY": "FULL_ACCESS"
},
{
"ICX_CATEGORY": "FULL_ACCESS"
},
{
"ICX_CATEGORY": "FULL_ACCESS"
}
]
}
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"rawDataTotalCount": {
"description": "Switch query result list count",
"type": "integer"
},
"totalCount": {
"description": "Total switch query result list count",
"type": "integer"
},
"hasMore": {
"description": "Indicator of whether there are more after the current displayed list",
"type": "boolean"
},
"firstIndex": {
"description": "Index of the first registration rule returned out of the complete registration rule list",
"type": "integer"
},
"extra": {
"description": "Any additional response data",
"type": "object",
"properties": {
"rbacMetadata": {
"type": "array",
"items": {
"additionalProperties": {
"type": "string"
},
"properties": {}
}
}
}
},
"list": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"description": "Identifier of switch",
"type": "string"
},
"switchName": {
"description": "Switch name",
"type": "string"
},
"macAddress": {
"description": "Switch mac address",
"type": "string"
},
"model": {
"description": "Switch model",
"type": "string"
},
"family": {
"description": "Switch Model Family",
"type": "string"
},
"ipAddress": {
"description": "switch IP address",
"type": "string"
},
"registrationStatus": {
"description": "Status for switch registater to ICX-M",
"type": "string"
},
"ports": {
"description": "Total port count",
"type": "integer"
},
"portStatus": {
"description": "Information of port status",
"type": "object",
"additionalProperties": false,
"properties": {
"speed": {
"description": "Port speed of switch",
"type": "string"
},
"up": {
"description": "Count for port status is up of switch",
"type": "integer"
},
"warning": {
"description": "Count for port status is warring of switch",
"type": "integer"
},
"down": {
"description": "Count for port status is down of switch",
"type": "integer"
},
"total": {
"description": "Total count for port status of switch",
"type": "integer"
},
"adminDown": {
"description": "Count for port status is admin down of switch",
"type": "integer"
},
"speedInt": {
"description": "Switch port fully speed",
"type": "integer"
}
}
},
"numOfUnits": {
"description": "Count of switch unit",
"type": "integer"
},
"poe": {
"description": "Information of PoE",
"type": "object",
"additionalProperties": false,
"properties": {
"total": {
"description": "Total power capacity of a switch",
"type": "integer"
},
"free": {
"description": "Free power capacity of a switch",
"type": "integer"
},
"percent": {
"description": "Percentage of power usage for a switch",
"type": "number"
}
}
},
"alarm": {
"description": "Count of switch alarm",
"type": "integer"
},
"upTime": {
"description": "SWitch uptime",
"type": "string"
},
"firmwareVersion": {
"description": "Switch firmware version",
"type": "string"
},
"modules": {
"description": "Stack or Switch",
"type": "string"
},
"serialNumber": {
"description": "Switch serial number",
"type": "string"
},
"ipAddressType": {
"description": "IP address type",
"type": "string"
},
"defaultGateway": {
"description": "Default gateway of switch",
"type": "string"
},
"groupName": {
"description": "Name of switch group",
"type": "string"
},
"groupId": {
"description": "Identifier of switch group",
"type": "string"
},
"groupConfigMode": {
"description": "Config mode of switch group",
"type": "string"
},
"groupFirmware": {
"description": "Firmware of switch group",
"type": "string"
},
"parentGroupId": {
"description": "Identifier of parent switch group",
"type": "string"
},
"stackId": {
"description": "Stack Id",
"type": "string"
},
"domainId": {
"description": "Identifier of the management domain to which the switch belong",
"type": "string"
},
"status": {
"description": "Status of switch, Ex: ONLINE, OFFLINE",
"type": "string"
},
"lastBackupTime": {
"description": "Last config backup time of switch",
"type": "integer",
"format": "int64"
},
"lastRestoreTime": {
"description": "Last config restore time of switch",
"type": "integer",
"format": "int64"
},
"lastBackupStatus": {
"description": "Last config backup status of switch",
"type": "string",
"enum": [
"STARTED",
"SUCCESS",
"FAILED"
]
},
"lastRestoreStatus": {
"description": "Last config restore status of switch",
"type": "string",
"enum": [
"STARTED",
"SUCCESS",
"FAILED"
]
},
"firmwareUpdate": {
"description": "Information of firmware update",
"type": "object",
"additionalProperties": false,
"properties": {
"scheduleId": {
"description": "Schedule Id of firmware update",
"type": "string"
},
"scheduledTime": {
"description": "Scheduled time of firmware update",
"type": "string"
},
"modifiedTime": {
"description": "Modified time of the firmware update scheduled",
"type": "string"
},
"status": {
"description": "Status of firmware update",
"type": "string"
},
"toVersion": {
"description": "Update to which firmware version",
"type": "string"
}
}
},
"supportedCsl": {
"description": "Supported CSL of switch",
"type": "integer",
"format": "int32"
},
"backupDiffWithMaster": {
"description": "Indicate there is a config backup different from the master backup",
"type": "boolean"
},
"siteActive": {
"description": "Data Plane Ip, for Network Segmentation",
"type": "string"
},
"siteConnection": {
"description": "Data Plane Connection status, for Network Segmentation",
"type": "string"
},
"localsyncStatus": {
"description": "Status of LocalSync",
"type": "string",
"enum": [
"LOCAL_SYNC_NONE",
"LOCAL_SYNCING"
]
}
}
}
}
}
}
List SNMP Synced Switches ¶
POST/v11_1/switch/snmpSyncedSwitch
Use this API command to retrieve all the switches currently managed by SmartZone and SNMP synced.
Body
{
"filters": [
{
"type": "DOMAIN",
"value": "8b2081d5-9662-40d9-a3db-2a3cf4dde3f7"
}
],
"fullTextSearch": {
"type": "AND",
"value": ""
},
"sortInfo": {
"sortColumn": "serialNumber",
"dir": "ASC"
},
"page": 1,
"limit": 8
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"filters": {
"description": "Filters used to select specific resource scope",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Group type",
"enum": [
"SYSTEM",
"CATEGORY",
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"BLADE",
"SYNCEDSTATUS",
"REGISTRATIONSTATE",
"STATUS",
"SWITCH_GROUP",
"FAMILY_ID",
"PORT",
"SWITCH_ID_PORT_IDENTIFIER",
"transactionId",
"dispatchStatus",
"configType",
"yang",
"removeYang"
],
"type": "string"
},
"value": {
"description": "Group ID",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraFilters": {
"description": "\"AND\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"SWITCH_GROUP",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"transactionId",
"hasLayerThreeConfig",
"clientAuthType",
"clientIpv4Addr",
"clientIpv6Addr",
"clientMac",
"clientUserName",
"switchName",
"ADMIN_STATUS",
"PORT_STATUS",
"POE_ENABLED",
"cliType",
"dispatchStatus",
"configType",
"yang",
"removeYang",
"reservedField1",
"FIRMWARE",
"dot1XIpv4Addr",
"dot1XIpv6Addr"
],
"type": "string"
},
"value": {
"description": "Value to search",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraNotFilters": {
"description": "\"NOT\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"switchStatus.alerts",
"switchStatus.status",
"transactionId",
"hasLayerThreeConfig",
"reservedField1",
"dispatchStatus",
"configType",
"clis",
"yang",
"removeYang",
"clientType"
],
"type": "string"
},
"value": {
"description": "Value not to search",
"type": "string"
}
}
}
},
"options": {
"description": "Specified feature required informaion",
"type": "object",
"additionalProperties": false,
"properties": {
"auth_includeNa": {
"description": "Include Not Available auth service option while returning result",
"type": "boolean"
},
"auth_includeLocalDb": {
"description": "Include LocalDB auth service while returning result",
"type": "boolean"
},
"auth_includeGuest": {
"description": "Include Guest auth service while returning result",
"type": "boolean"
},
"auth_includeAdGlobal": {
"description": "If AD is in list, include only AD with Global Catalog configured",
"type": "boolean"
},
"auth_type": {
"description": "Authentication service types to get, use comma to separate, Ex: RADIUS,AD",
"type": "string"
},
"auth_realmType": {
"description": "To get specific authentication service information for configuring realm based authentication profile",
"enum": [
"ALL",
"RADIUS"
],
"type": "string"
},
"acct_type": {
"description": "Accounting service types to get, use comma to separate, Ex: RADIUS,CGF",
"type": "string"
},
"auth_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_includeNa": {
"description": "Include Not Available acct service option while returning result",
"type": "boolean"
},
"forwarding_type": {
"description": "Forwarding service types to get, use comma to separate, Ex: L2oGRE,TTGPDG,Bridge,Advanced",
"type": "string"
},
"includeSharedResources": {
"description": "Whether to include the resources of parent domain or not",
"type": "boolean"
},
"INCLUDE_RBAC_METADATA": {
"description": "Whether to include RBAC metadata or not",
"type": "boolean"
},
"TENANT_ID": {
"description": "Specify Tenant ID for query",
"type": "string"
},
"inMap": {
"description": "Specify inMap status for query",
"type": "boolean"
},
"globalFilterId": {
"description": "Specify GlobalFilter ID for query",
"type": "string"
},
"auth_hostedAaaSupportedEnabled": {
"description": "Indicate if Hosted AAA Support is enabled",
"type": "boolean"
},
"auth_plmnIdentifierEnabled": {
"description": "Indicate if Configure PLMN identifier is enabled",
"type": "boolean"
},
"includeUsers": {
"description": "Should also retrieve users or not",
"type": "boolean"
}
}
},
"extraTimeRange": {
"description": "Specified data time range of selection",
"type": "object",
"additionalProperties": false,
"properties": {
"start": {
"description": "start time for collecting data",
"type": "number"
},
"end": {
"description": "end time for collecting data",
"type": "number"
},
"interval": {
"description": "time interval in second",
"type": "number"
},
"field": {
"description": "time field for collecting data",
"enum": [
"insertionTime",
"startTime",
"endTime"
],
"type": "string"
}
}
},
"fullTextSearch": {
"description": "Specified search string",
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Search logic operator",
"enum": [
"AND",
"OR"
],
"type": "string"
},
"value": {
"description": "Text or number to search",
"type": "string"
},
"fields": {
"description": "Specific fields to search",
"type": "array",
"items": {
"type": "string"
}
}
}
},
"sortInfo": {
"description": "About sorting",
"type": "object",
"additionalProperties": false,
"properties": {
"sortColumn": {
"type": "string"
},
"dir": {
"enum": [
"ASC",
"DESC"
],
"type": "string"
}
}
},
"page": {
"description": "Page number to get",
"type": "integer",
"minimum": 1
},
"limit": {
"description": "Size of one page",
"type": "integer",
"minimum": 1
},
"expandDomains": {
"description": "Whether to expand domains into sub domains/ zones or not",
"type": "boolean"
},
"criteria": {
"description": "Add backward compatibility for UI framework",
"type": "string"
},
"query": {
"description": "Add backward compatibility for UI framework",
"type": "string"
}
}
}
200
Body
{
"rawDataTotalCount": 0,
"totalCount": 3,
"hasMore": false,
"firstIndex": 8,
"list": [
{
"id": "18:A0:12:32:00:00",
"switchName": "icx_jemery0",
"macAddress": "18:A0:12:32:00:00",
"model": "ICX7450-48P",
"family": "ICX7450",
"ipAddress": "192.168.239.150",
"registrationStatus": "APPROVED",
"ports": 24,
"portStatus": {
"speed": null,
"up": 13,
"warning": 24,
"down": 0,
"total": null,
"adminDown": null,
"speedInt": 0
},
"numOfUnits": 1,
"poe": {
"total": 0,
"free": 0,
"percent": 0
},
"alarm": 13,
"upTime": "0:00:09.37",
"firmwareVersion": "1.0.0",
"modules": "switch",
"serialNumber": "567866JE0",
"ipAddressType": null,
"defaultGateway": "10.1.200.254",
"groupName": "MyGroup1",
"groupId": "a7058e17-0ce9-41db-b59f-d6222148c43b",
"groupConfigMode": "CLI",
"groupFirmware": "FI08090",
"parentGroupId": "e299823b-dc14-4c1f-985e-f5002bfccb0f",
"stackId": null,
"domainId": "8b2081d5-9662-40d9-a3db-2a3cf4dde3f7",
"status": "OFFLINE",
"lastBackupTime": 1531290000325,
"lastRestoreTime": null,
"lastBackupStatus": "FAILED",
"lastRestoreStatus": null,
"firmwareUpdate": null,
"siteActive": "",
"siteConnection": ""
},
{
"id": "60:9C:9F:DA:63:80",
"switchName": "ICX7750-1",
"macAddress": "60:9C:9F:DA:63:80",
"model": "ICX7750-48XGC",
"ipAddress": "192.168.240.31",
"registrationStatus": "APPROVED",
"ports": 54,
"portStatus": {
"speed": null,
"up": 1,
"warning": 0,
"down": 53,
"total": null,
"adminDown": null,
"speedInt": 0
},
"numOfUnits": 1,
"poe": {
"total": 0,
"free": 0,
"percent": 0
},
"alarm": 2,
"upTime": "6 days, 1:12:22.00",
"firmwareVersion": "SWS08080b254",
"modules": "switch",
"serialNumber": "CRJ3333N00K",
"ipAddressType": null,
"defaultGateway": "192.168.253.253",
"groupName": "RealSwitchGroup1",
"groupId": "e299823b-dc14-4c1f-985e-f5002bfccb0f",
"groupConfigMode": "CLI",
"groupFirmware": "FI08090",
"parentGroupId": null,
"stackId": null,
"domainId": "8b2081d5-9662-40d9-a3db-2a3cf4dde3f7",
"status": "ONLINE",
"lastBackupTime": 1531353601306,
"lastRestoreTime": 1530521401053,
"lastBackupStatus": "SUCCESS",
"lastRestoreStatus": "SUCCESS",
"firmwareUpdate": {
"scheduleId": "firmware-update-ONE_TIME-1530510555674",
"scheduledTime": "",
"modifiedTime": "1530511156376",
"status": "succeeded",
"toVersion": "SWS08080b254"
},
"siteActive": "",
"siteConnection": ""
},
{
"id": "60:9C:9F:E5:C7:00",
"switchName": "ICX7150-1",
"macAddress": "60:9C:9F:E5:C7:00",
"model": "ICX7150-24P",
"ipAddress": "192.168.240.1",
"registrationStatus": "APPROVED",
"ports": 90,
"portStatus": {
"speed": null,
"up": 11,
"warning": 1,
"down": 78,
"total": null,
"adminDown": null,
"speedInt": 0
},
"numOfUnits": 3,
"poe": {
"total": 1110000,
"free": 1079200,
"percent": 0
},
"alarm": 2,
"upTime": "6 days, 1:14:45.00",
"firmwareVersion": "SPS08080b207",
"modules": "stack",
"serialNumber": "FEA3234N0B0",
"ipAddressType": null,
"defaultGateway": "192.168.253.253",
"groupName": "RealSwitchGroup1",
"groupId": "e299823b-dc14-4c1f-985e-f5002bfccb0f",
"groupConfigMode": "CLI",
"parentGroupId": null,
"stackId": null,
"domainId": "8b2081d5-9662-40d9-a3db-2a3cf4dde3f7",
"status": "ONLINE",
"lastBackupTime": 1531353601865,
"lastRestoreTime": null,
"lastBackupStatus": "SUCCESS",
"lastRestoreStatus": null,
"firmwareUpdate": null,
"siteActive": "",
"siteConnection": ""
}
],
"extra": {
"rbacMetadata": [
{
"ICX_CATEGORY": "FULL_ACCESS"
},
{
"ICX_CATEGORY": "FULL_ACCESS"
},
{
"ICX_CATEGORY": "FULL_ACCESS"
}
]
}
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"rawDataTotalCount": {
"description": "Switch query result list count",
"type": "integer"
},
"totalCount": {
"description": "Total switch query result list count",
"type": "integer"
},
"hasMore": {
"description": "Indicator of whether there are more after the current displayed list",
"type": "boolean"
},
"firstIndex": {
"description": "Index of the first registration rule returned out of the complete registration rule list",
"type": "integer"
},
"extra": {
"description": "Any additional response data",
"type": "object",
"properties": {
"rbacMetadata": {
"type": "array",
"items": {
"additionalProperties": {
"type": "string"
},
"properties": {}
}
}
}
},
"list": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"description": "Identifier of switch",
"type": "string"
},
"switchName": {
"description": "Switch name",
"type": "string"
},
"macAddress": {
"description": "Switch mac address",
"type": "string"
},
"model": {
"description": "Switch model",
"type": "string"
},
"family": {
"description": "Switch Model Family",
"type": "string"
},
"ipAddress": {
"description": "switch IP address",
"type": "string"
},
"registrationStatus": {
"description": "Status for switch registater to ICX-M",
"type": "string"
},
"ports": {
"description": "Total port count",
"type": "integer"
},
"portStatus": {
"description": "Information of port status",
"type": "object",
"additionalProperties": false,
"properties": {
"speed": {
"description": "Port speed of switch",
"type": "string"
},
"up": {
"description": "Count for port status is up of switch",
"type": "integer"
},
"warning": {
"description": "Count for port status is warring of switch",
"type": "integer"
},
"down": {
"description": "Count for port status is down of switch",
"type": "integer"
},
"total": {
"description": "Total count for port status of switch",
"type": "integer"
},
"adminDown": {
"description": "Count for port status is admin down of switch",
"type": "integer"
},
"speedInt": {
"description": "Switch port fully speed",
"type": "integer"
}
}
},
"numOfUnits": {
"description": "Count of switch unit",
"type": "integer"
},
"poe": {
"description": "Information of PoE",
"type": "object",
"additionalProperties": false,
"properties": {
"total": {
"description": "Total power capacity of a switch",
"type": "integer"
},
"free": {
"description": "Free power capacity of a switch",
"type": "integer"
},
"percent": {
"description": "Percentage of power usage for a switch",
"type": "number"
}
}
},
"alarm": {
"description": "Count of switch alarm",
"type": "integer"
},
"upTime": {
"description": "SWitch uptime",
"type": "string"
},
"firmwareVersion": {
"description": "Switch firmware version",
"type": "string"
},
"modules": {
"description": "Stack or Switch",
"type": "string"
},
"serialNumber": {
"description": "Switch serial number",
"type": "string"
},
"ipAddressType": {
"description": "IP address type",
"type": "string"
},
"defaultGateway": {
"description": "Default gateway of switch",
"type": "string"
},
"groupName": {
"description": "Name of switch group",
"type": "string"
},
"groupId": {
"description": "Identifier of switch group",
"type": "string"
},
"groupConfigMode": {
"description": "Config mode of switch group",
"type": "string"
},
"groupFirmware": {
"description": "Firmware of switch group",
"type": "string"
},
"parentGroupId": {
"description": "Identifier of parent switch group",
"type": "string"
},
"stackId": {
"description": "Stack Id",
"type": "string"
},
"domainId": {
"description": "Identifier of the management domain to which the switch belong",
"type": "string"
},
"status": {
"description": "Status of switch, Ex: ONLINE, OFFLINE",
"type": "string"
},
"lastBackupTime": {
"description": "Last config backup time of switch",
"type": "integer",
"format": "int64"
},
"lastRestoreTime": {
"description": "Last config restore time of switch",
"type": "integer",
"format": "int64"
},
"lastBackupStatus": {
"description": "Last config backup status of switch",
"type": "string",
"enum": [
"STARTED",
"SUCCESS",
"FAILED"
]
},
"lastRestoreStatus": {
"description": "Last config restore status of switch",
"type": "string",
"enum": [
"STARTED",
"SUCCESS",
"FAILED"
]
},
"firmwareUpdate": {
"description": "Information of firmware update",
"type": "object",
"additionalProperties": false,
"properties": {
"scheduleId": {
"description": "Schedule Id of firmware update",
"type": "string"
},
"scheduledTime": {
"description": "Scheduled time of firmware update",
"type": "string"
},
"modifiedTime": {
"description": "Modified time of the firmware update scheduled",
"type": "string"
},
"status": {
"description": "Status of firmware update",
"type": "string"
},
"toVersion": {
"description": "Update to which firmware version",
"type": "string"
}
}
},
"supportedCsl": {
"description": "Supported CSL of switch",
"type": "integer",
"format": "int32"
},
"backupDiffWithMaster": {
"description": "Indicate there is a config backup different from the master backup",
"type": "boolean"
},
"siteActive": {
"description": "Data Plane Ip, for Network Segmentation",
"type": "string"
},
"siteConnection": {
"description": "Data Plane Connection status, for Network Segmentation",
"type": "string"
},
"localsyncStatus": {
"description": "Status of LocalSync",
"type": "string",
"enum": [
"LOCAL_SYNC_NONE",
"LOCAL_SYNCING"
]
}
}
}
}
}
}
Retrieve Switch & Port Details ¶
POST/v11_1/switch/view/details
Use this API command to retrieve switch and port details for the selected Switch/SwitchGroup/Domain.
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"filters": {
"description": "Filters used to select specific resource scope",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Group type",
"enum": [
"SYSTEM",
"CATEGORY",
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"BLADE",
"SYNCEDSTATUS",
"REGISTRATIONSTATE",
"STATUS",
"SWITCH_GROUP",
"FAMILY_ID",
"PORT",
"SWITCH_ID_PORT_IDENTIFIER",
"transactionId",
"dispatchStatus",
"configType",
"yang",
"removeYang"
],
"type": "string"
},
"value": {
"description": "Group ID",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraFilters": {
"description": "\"AND\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"SWITCH_GROUP",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"transactionId",
"hasLayerThreeConfig",
"clientAuthType",
"clientIpv4Addr",
"clientIpv6Addr",
"clientMac",
"clientUserName",
"switchName",
"ADMIN_STATUS",
"PORT_STATUS",
"POE_ENABLED",
"cliType",
"dispatchStatus",
"configType",
"yang",
"removeYang",
"reservedField1",
"FIRMWARE",
"dot1XIpv4Addr",
"dot1XIpv6Addr"
],
"type": "string"
},
"value": {
"description": "Value to search",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraNotFilters": {
"description": "\"NOT\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"switchStatus.alerts",
"switchStatus.status",
"transactionId",
"hasLayerThreeConfig",
"reservedField1",
"dispatchStatus",
"configType",
"clis",
"yang",
"removeYang",
"clientType"
],
"type": "string"
},
"value": {
"description": "Value not to search",
"type": "string"
}
}
}
},
"options": {
"description": "Specified feature required informaion",
"type": "object",
"additionalProperties": false,
"properties": {
"auth_includeNa": {
"description": "Include Not Available auth service option while returning result",
"type": "boolean"
},
"auth_includeLocalDb": {
"description": "Include LocalDB auth service while returning result",
"type": "boolean"
},
"auth_includeGuest": {
"description": "Include Guest auth service while returning result",
"type": "boolean"
},
"auth_includeAdGlobal": {
"description": "If AD is in list, include only AD with Global Catalog configured",
"type": "boolean"
},
"auth_type": {
"description": "Authentication service types to get, use comma to separate, Ex: RADIUS,AD",
"type": "string"
},
"auth_realmType": {
"description": "To get specific authentication service information for configuring realm based authentication profile",
"enum": [
"ALL",
"RADIUS"
],
"type": "string"
},
"acct_type": {
"description": "Accounting service types to get, use comma to separate, Ex: RADIUS,CGF",
"type": "string"
},
"auth_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_includeNa": {
"description": "Include Not Available acct service option while returning result",
"type": "boolean"
},
"forwarding_type": {
"description": "Forwarding service types to get, use comma to separate, Ex: L2oGRE,TTGPDG,Bridge,Advanced",
"type": "string"
},
"includeSharedResources": {
"description": "Whether to include the resources of parent domain or not",
"type": "boolean"
},
"INCLUDE_RBAC_METADATA": {
"description": "Whether to include RBAC metadata or not",
"type": "boolean"
},
"TENANT_ID": {
"description": "Specify Tenant ID for query",
"type": "string"
},
"inMap": {
"description": "Specify inMap status for query",
"type": "boolean"
},
"globalFilterId": {
"description": "Specify GlobalFilter ID for query",
"type": "string"
},
"auth_hostedAaaSupportedEnabled": {
"description": "Indicate if Hosted AAA Support is enabled",
"type": "boolean"
},
"auth_plmnIdentifierEnabled": {
"description": "Indicate if Configure PLMN identifier is enabled",
"type": "boolean"
},
"includeUsers": {
"description": "Should also retrieve users or not",
"type": "boolean"
}
}
},
"extraTimeRange": {
"description": "Specified data time range of selection",
"type": "object",
"additionalProperties": false,
"properties": {
"start": {
"description": "start time for collecting data",
"type": "number"
},
"end": {
"description": "end time for collecting data",
"type": "number"
},
"interval": {
"description": "time interval in second",
"type": "number"
},
"field": {
"description": "time field for collecting data",
"enum": [
"insertionTime",
"startTime",
"endTime"
],
"type": "string"
}
}
},
"fullTextSearch": {
"description": "Specified search string",
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Search logic operator",
"enum": [
"AND",
"OR"
],
"type": "string"
},
"value": {
"description": "Text or number to search",
"type": "string"
},
"fields": {
"description": "Specific fields to search",
"type": "array",
"items": {
"type": "string"
}
}
}
},
"sortInfo": {
"description": "About sorting",
"type": "object",
"additionalProperties": false,
"properties": {
"sortColumn": {
"type": "string"
},
"dir": {
"enum": [
"ASC",
"DESC"
],
"type": "string"
}
}
},
"page": {
"description": "Page number to get",
"type": "integer",
"minimum": 1
},
"limit": {
"description": "Size of one page",
"type": "integer",
"minimum": 1
},
"expandDomains": {
"description": "Whether to expand domains into sub domains/ zones or not",
"type": "boolean"
},
"criteria": {
"description": "Add backward compatibility for UI framework",
"type": "string"
},
"query": {
"description": "Add backward compatibility for UI framework",
"type": "string"
}
}
}
200
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"rawDataTotalCount": {
"description": "Total stack member count",
"type": "integer"
},
"totalCount": {
"description": "Current stack member count",
"type": "integer"
},
"hasMore": {
"description": "Indicator of whether there are more stack member after the current displayed list",
"type": "boolean"
},
"firstIndex": {
"description": "Index of the first stack member returned out of the complete stack member list",
"type": "integer"
},
"extra": {
"description": "Extra information for stack member list",
"type": "object"
},
"list": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"switchName": {
"description": "Switch name of stack",
"type": "string"
},
"model": {
"description": "Switch model of stack",
"type": "string"
},
"ports": {
"description": "Port count of stack",
"type": "integer"
},
"portStatus": {
"description": "$",
"type": "object",
"additionalProperties": false,
"properties": {
"speed": {
"description": "Switch port speed",
"type": "string"
},
"up": {
"description": "Up port count",
"type": "integer"
},
"warning": {
"description": "Warring port count",
"type": "integer"
},
"down": {
"description": "Down port count",
"type": "integer"
},
"total": {
"description": "Total port count",
"type": "integer"
},
"adminDown": {
"description": "Admin down port count",
"type": "integer"
},
"speedInt": {
"description": "Switch port fully speed",
"type": "integer"
}
}
},
"serialNumber": {
"description": "Serial number of stack",
"type": "string"
},
"activeMode": {
"description": "Role of stack",
"type": "string"
},
"switchUnit": {
"description": "Switch unit of stack",
"type": "string"
},
"switchModule": {
"description": "Switch module of stack",
"type": "string"
},
"switchPorts": {
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"description": "Identifier of switch port",
"type": "string"
},
"sampledInstant": {
"description": "Sampled instant of switch port",
"type": "string"
},
"name": {
"description": "Name of switch port",
"type": "string"
},
"switchId": {
"description": "Switch id of switch port",
"type": "string"
},
"switchFamily": {
"description": "Switch family of switch port",
"type": "string"
},
"switchModel": {
"description": "Switch model of switch port",
"type": "string"
},
"switchName": {
"description": "Switch Name of switch port",
"type": "string"
},
"switchGroup": {
"description": "Switch group of switch port",
"type": "string"
},
"switchFirmwareVersion": {
"description": "Switch firmware of switch port",
"type": "string"
},
"mac": {
"description": "Mac address of switch port",
"type": "string"
},
"type": {
"description": "Type of switch port",
"type": "string"
},
"status": {
"description": "Status of switch port, UP or DOWN",
"type": "string"
},
"adminStatus": {
"description": "Admin status of switch port, UP or DOWN",
"type": "string"
},
"vlans": {
"description": "Switch port include vlans",
"type": "string"
},
"poe": {
"description": "PoE information of switch port",
"type": "object",
"additionalProperties": false,
"properties": {
"total": {
"description": "Total power capacity of switch port",
"type": "integer"
},
"free": {
"description": "Free power capacity of switch port",
"type": "integer"
},
"percent": {
"description": "Power used percentage of switch port",
"type": "number"
}
}
},
"portError": {
"description": "Port error Information",
"type": "object",
"additionalProperties": false,
"properties": {
"inError": {
"description": "Switch port traffic in error count",
"type": "integer"
},
"outError": {
"description": "Switch port traffic out error count",
"type": "integer"
},
"crcError": {
"description": "Switch port CRC error count",
"type": "integer"
},
"inDiscard": {
"description": "Switch port traffic in discard count",
"type": "integer"
}
}
},
"packets": {
"description": "Port packet transmit information",
"type": "object",
"additionalProperties": false,
"properties": {
"broadcastIn": {
"description": "Switch port broadcast in packet count",
"type": "integer"
},
"broadcastOut": {
"description": "Switch port broadcast out packet count",
"type": "integer"
},
"multicastIn": {
"description": "Switch port multicast in packet count",
"type": "integer"
},
"multicastOut": {
"description": "Switch port multicast out packet count",
"type": "integer"
}
}
},
"neighborName": {
"description": "Switch port connected neighbor name",
"type": "string"
},
"portSpeed": {
"description": "Switch port speed",
"type": "string"
},
"stpState": {
"description": "Switch port STP state",
"type": "integer"
},
"inUtilization": {
"description": "Switch port traffic in utilization",
"type": "number"
},
"outUtilization": {
"description": "Switch port traffic out utilization",
"type": "number"
},
"opticsType": {
"description": "Switch port optics type",
"type": "string"
},
"connectedDevice": {
"description": "Connected device information",
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"description": "Identifier of connected device",
"type": "string"
},
"localPortMac": {
"description": "Local port mac address to connected device",
"type": "string"
},
"remotePortMac": {
"description": "Remote port mac address of local device",
"type": "string"
},
"remoteDeviceName": {
"description": "Remote connected device name",
"type": "string"
},
"remoteDeviceMac": {
"type": "string"
},
"remotePortType": {
"description": "Remote port type of connected device",
"type": "string"
},
"remotePortDesc": {
"description": "Remote port description of connected device",
"type": "string"
},
"localPort": {
"description": "Local port description to connected device",
"type": "string"
},
"remotePort": {
"description": "Remote port number of connected device",
"type": "string"
},
"isRuckusAP": {
"description": "Connected devices is RuckusAP,True or False",
"type": "string"
},
"domainId": {
"description": "Identifier of the management domain to which the connected device belong",
"type": "string"
},
"tenantId": {
"description": "Tenant Id",
"type": "string"
},
"switchGroupLevelOneId": {
"description": "Switch group level one Id",
"type": "string"
},
"switchGroupLevelTwoId": {
"description": "Switch group level two Id",
"type": "string"
},
"switchId": {
"description": "Switch Id",
"type": "string"
},
"unitId": {
"description": "Unit Id",
"type": "string"
},
"localPortIfaceName": {
"description": "Local port interface name",
"type": "string"
},
"switchName": {
"description": "Switch name",
"type": "string"
},
"switchGroup": {
"description": "Switch group",
"type": "string"
}
}
},
"trafficUsage": {
"description": "Traffic usage information",
"type": "object",
"additionalProperties": false,
"properties": {
"tx": {
"description": "Tx traffic usage of switch port",
"type": "integer"
},
"rx": {
"description": "Rx traffic usage of switch port",
"type": "integer"
}
}
},
"poeEnabled": {
"description": "PoE Enabled, True or False",
"type": "boolean"
},
"poeType": {
"description": "PoE type",
"type": "string"
},
"usedInFormingStack": {
"description": "Used in forming stack, True or False",
"type": "boolean"
},
"unTaggedVlan": {
"description": "Untagged vlan of switch port",
"type": "string"
},
"portIdentifier": {
"description": "Port Identifier of switch port",
"type": "string"
},
"lagConfig": {
"description": "Lag config of switch port",
"type": "object",
"additionalProperties": false,
"properties": {
"lagName": {
"description": "Lag name of switch port",
"type": "string"
},
"lagId": {
"description": "Lag id of switch port",
"type": "integer"
},
"lagStatus": {
"description": "Lag status of switch port",
"type": "string"
},
"lagAdminStatus": {
"description": "Lag admin status of switch port",
"type": "string"
}
}
},
"defaultVlanId": {
"description": "Default VLAN ID",
"type": "integer"
}
}
}
}
}
}
}
}
Move to Switch Group ¶
PUT/v11_1/switch/move/{destinationSwitchGroupId}
Use this API command to move a list of switches to a switch group.
Body
[
"18:A0:12:32:00:01",
"18:A0:12:32:00:00"
]
Schema
{
"description": "$",
"type": "array",
"items": {
"type": "string"
}
}
200
Delete Switch ¶
DELETE/v11_1/switch/{id}
Use this API command to delete a switch managed by SmartZone.
200
Body
{
"id": "19:23:12:11:00:00",
"name": null
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"description": "Audit Id",
"type": "string"
},
"name": {
"description": "Audit name",
"type": "string"
}
}
}
Delete Multiple Switches ¶
DELETE/v11_1/switch
Use this API command to delete multiple switches managed by SmartZone
Body
[
"18:A0:12:32:00:01",
"18:A0:12:32:00:00"
]
Schema
{
"description": "$",
"type": "array",
"items": {
"type": "string"
}
}
200
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"rawDataTotalCount": {
"description": "Delete switches list count",
"type": "integer"
},
"totalCount": {
"description": "Total delete switches list count",
"type": "integer"
},
"hasMore": {
"description": "Indicator of whether there are more delete switches after the current displayed list",
"type": "boolean"
},
"firstIndex": {
"description": "Index of the first delete switches returned out of the complete list",
"type": "integer"
},
"extra": {
"description": "Any additional response data",
"type": "object"
},
"list": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"description": "Audit Id",
"type": "string"
},
"name": {
"description": "Audit name",
"type": "string"
}
}
}
}
}
}
Switch Group ¶
Get Switch Group ¶
GET/v11_1/group/{switchGroupId}
Use this API command to retrieve switch group detail.
Headers
Content-Type: text/plain,*/*
200
Body
{
"name": "SwitchGroup3",
"description": "Switch Group 3 Description",
"firmware": "Switch Group 3 Firmware Version",
"domainId": "8b2081d5-9662-40d9-a3db-2a3cf4dde3f7",
"schedule": {
"interval": "DAILY",
"dateOfMonth": 1,
"dayOfWeek": "SUNDAY",
"hour": 3,
"minute": 30
}
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"description": "Identifier of the switch group",
"type": "string"
},
"domainId": {
"description": "Identifier of the management domain to which the switch group belong",
"type": "string"
},
"creatorId": {
"description": "Creator Id of the switch group",
"type": "string"
},
"tenantId": {
"description": "Tenant Id of the switch group",
"type": "string"
},
"switchGroupLevelOneId": {
"description": "Level one Id of the switch group",
"type": "string"
},
"switchGroupLevelTwoId": {
"description": "Level two Id of the switch group",
"type": "string"
},
"createDatetime": {
"description": "Create datetime of the switch group",
"type": "integer",
"format": "int64"
},
"name": {
"description": "Name of the switch group",
"type": "string"
},
"description": {
"description": "Description of the switch group",
"type": "string"
},
"firmware": {
"description": "Firmware of the switch group",
"type": "string"
},
"sampledInstant": {
"description": "Sampled instant of the switch group",
"type": "object"
},
"levelOne": {
"description": "Level one of the switch group",
"type": "boolean"
},
"levelTwo": {
"description": "Level two of the switch group",
"type": "boolean"
},
"enableTwoFactor": {
"description": "Enable two factor authentication. Only support FIPS mode",
"type": "boolean"
},
"schedule": {
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"description": "Identifier of the switch group backup schedule",
"type": "string"
},
"interval": {
"description": "Interval of the switch group backup schedule",
"type": "string",
"enum": [
"MONTHLY",
"WEEKLY",
"DAILY"
]
},
"dateOfMonth": {
"description": "The date of the switch group backup schedule",
"type": "integer"
},
"dayOfWeek": {
"description": "The day of week of the switch group backup schedule",
"type": "string",
"enum": [
"SUNDAY",
"MONDAY",
"TUESDAY",
"WEDNESDAY",
"THURSDAY",
"FRIDAY",
"SATURDAY"
]
},
"hour": {
"description": "The hour of the switch group backup schedule",
"type": "integer"
},
"minute": {
"description": "The minute of the switch group backup schedule",
"type": "integer"
}
}
}
}
}
Retrieve Switch Groups ¶
GET/v11_1/group/ids/byDomain/{domainId}
Use this API command to retrieve the switch groups by domain ID.
- showStagingGroup
string
(optional)
Headers
Content-Type: text/plain,*/*
200
Body
{
"success": true,
"error": null,
"data": {
"rawDataTotalCount": 0,
"totalCount": 3,
"hasMore": false,
"firstIndex": 0,
"list": [
{
"id": "21ed3a40-34a7-4d13-844c-783c66074d7a",
"label": "RealSwitchGroup1",
"extraValues": {},
"type": "Ruckus"
},
{
"id": "8a098bb7-d80f-4604-a0ff-692ed56dcfd3",
"label": "MyGroup1",
"extraValues": {},
"type": "Ruckus"
},
{
"id": "d8050f24-7cfa-498f-b4fc-971eafe4c766",
"label": "MyGroup2",
"extraValues": {},
"type": "Ruckus"
}
],
"extra": null
},
"extra": {},
"metaData": {}
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"success": {
"description": "Query result success or not",
"type": "boolean"
},
"error": {
"additionalProperties": false,
"type": "object",
"properties": {
"message": {
"type": "string"
},
"msgKey": {
"type": "string"
},
"list": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"data": {
"type": "object",
"additionalProperties": false,
"properties": {
"rawDataTotalCount": {
"description": "Query result count",
"type": "integer"
},
"totalCount": {
"description": "Total query result count",
"type": "integer"
},
"hasMore": {
"description": "Indicates if there are more query result after the currently displayed list",
"type": "boolean"
},
"firstIndex": {
"description": "Index of the first query result returned out of the complete query result list",
"type": "integer"
},
"extra": {
"description": "Extra information for query result list",
"type": "object"
},
"list": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"description": "Identifier of the client",
"type": "string"
},
"label": {
"description": "Label of the client",
"type": "string"
},
"extraValues": {
"description": "Extra values of the client",
"type": "object"
},
"type": {
"description": "Type of the client",
"type": "string"
}
}
}
}
}
},
"extra": {
"description": "Any additional response",
"type": "object"
},
"metaData": {
"description": "Metadata of query result list",
"type": "object"
}
}
}
Create Switch Group ¶
POST/v11_1/group
Use this API command to create a new switch group under an existing domain or switch group.
Headers
Content-Type: text/plain,*/*
Body
{
"name": "SwitchGroup3",
"description": "Switch Group 3 Description",
"firmware": "Switch Group 3 Firmware Version",
"domainId": "8b2081d5-9662-40d9-a3db-2a3cf4dde3f7",
"schedule": {
"interval": "DAILY",
"dateOfMonth": 1,
"dayOfWeek": "SUNDAY",
"hour": 3,
"minute": 30
}
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"description": "Identifier of the switch group",
"type": "string"
},
"domainId": {
"description": "Identifier of the management domain to which the switch group belong",
"type": "string"
},
"creatorId": {
"description": "Creator Id of the switch group",
"type": "string"
},
"tenantId": {
"description": "Tenant Id of the switch group",
"type": "string"
},
"switchGroupLevelOneId": {
"description": "Level one Id of the switch group",
"type": "string"
},
"switchGroupLevelTwoId": {
"description": "Level two Id of the switch group",
"type": "string"
},
"createDatetime": {
"description": "Create datetime of the switch group",
"type": "integer",
"format": "int64"
},
"name": {
"description": "Name of the switch group",
"type": "string"
},
"description": {
"description": "Description of the switch group",
"type": "string"
},
"firmware": {
"description": "Firmware of the switch group",
"type": "string"
},
"sampledInstant": {
"description": "Sampled instant of the switch group",
"type": "object"
},
"levelOne": {
"description": "Level one of the switch group",
"type": "boolean"
},
"levelTwo": {
"description": "Level two of the switch group",
"type": "boolean"
},
"enableTwoFactor": {
"description": "Enable two factor authentication. Only support FIPS mode",
"type": "boolean"
},
"schedule": {
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"description": "Identifier of the switch group backup schedule",
"type": "string"
},
"interval": {
"description": "Interval of the switch group backup schedule",
"type": "string",
"enum": [
"MONTHLY",
"WEEKLY",
"DAILY"
]
},
"dateOfMonth": {
"description": "The date of the switch group backup schedule",
"type": "integer"
},
"dayOfWeek": {
"description": "The day of week of the switch group backup schedule",
"type": "string",
"enum": [
"SUNDAY",
"MONDAY",
"TUESDAY",
"WEDNESDAY",
"THURSDAY",
"FRIDAY",
"SATURDAY"
]
},
"hour": {
"description": "The hour of the switch group backup schedule",
"type": "integer"
},
"minute": {
"description": "The minute of the switch group backup schedule",
"type": "integer"
}
}
}
}
}
201
Body
{
"id": "0e4ac34b-9472-44bd-9d3b-9ea621adee4b",
"name": "SwitchGroup3"
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"description": "Audit Id",
"type": "string"
},
"name": {
"description": "Audit name",
"type": "string"
}
}
}
Retrieve Switch Client list. ¶
POST/v11_1/switchClientVisibility/query
Use this API command to Retrieve the switch client list.
Headers
Content-Type: text/plain,*/*,application/x-www-form-urlencoded
Body
{
"filters": [
{
"type": "DOMAIN",
"value": "8b2081d5-9662-40d9-a3db-2a3cf4dde3f7"
}
],
"fullTextSearch": {
"type": "AND",
"value": ""
},
"page": 1,
"limit": 8
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"filters": {
"description": "Filters used to select specific resource scope",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Group type",
"enum": [
"SYSTEM",
"CATEGORY",
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"BLADE",
"SYNCEDSTATUS",
"REGISTRATIONSTATE",
"STATUS",
"SWITCH_GROUP",
"FAMILY_ID",
"PORT",
"SWITCH_ID_PORT_IDENTIFIER",
"transactionId",
"dispatchStatus",
"configType",
"yang",
"removeYang"
],
"type": "string"
},
"value": {
"description": "Group ID",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraFilters": {
"description": "\"AND\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"SWITCH_GROUP",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"transactionId",
"hasLayerThreeConfig",
"clientAuthType",
"clientIpv4Addr",
"clientIpv6Addr",
"clientMac",
"clientUserName",
"switchName",
"ADMIN_STATUS",
"PORT_STATUS",
"POE_ENABLED",
"cliType",
"dispatchStatus",
"configType",
"yang",
"removeYang",
"reservedField1",
"FIRMWARE",
"dot1XIpv4Addr",
"dot1XIpv6Addr"
],
"type": "string"
},
"value": {
"description": "Value to search",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraNotFilters": {
"description": "\"NOT\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"switchStatus.alerts",
"switchStatus.status",
"transactionId",
"hasLayerThreeConfig",
"reservedField1",
"dispatchStatus",
"configType",
"clis",
"yang",
"removeYang",
"clientType"
],
"type": "string"
},
"value": {
"description": "Value not to search",
"type": "string"
}
}
}
},
"options": {
"description": "Specified feature required informaion",
"type": "object",
"additionalProperties": false,
"properties": {
"auth_includeNa": {
"description": "Include Not Available auth service option while returning result",
"type": "boolean"
},
"auth_includeLocalDb": {
"description": "Include LocalDB auth service while returning result",
"type": "boolean"
},
"auth_includeGuest": {
"description": "Include Guest auth service while returning result",
"type": "boolean"
},
"auth_includeAdGlobal": {
"description": "If AD is in list, include only AD with Global Catalog configured",
"type": "boolean"
},
"auth_type": {
"description": "Authentication service types to get, use comma to separate, Ex: RADIUS,AD",
"type": "string"
},
"auth_realmType": {
"description": "To get specific authentication service information for configuring realm based authentication profile",
"enum": [
"ALL",
"RADIUS"
],
"type": "string"
},
"acct_type": {
"description": "Accounting service types to get, use comma to separate, Ex: RADIUS,CGF",
"type": "string"
},
"auth_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_includeNa": {
"description": "Include Not Available acct service option while returning result",
"type": "boolean"
},
"forwarding_type": {
"description": "Forwarding service types to get, use comma to separate, Ex: L2oGRE,TTGPDG,Bridge,Advanced",
"type": "string"
},
"includeSharedResources": {
"description": "Whether to include the resources of parent domain or not",
"type": "boolean"
},
"INCLUDE_RBAC_METADATA": {
"description": "Whether to include RBAC metadata or not",
"type": "boolean"
},
"TENANT_ID": {
"description": "Specify Tenant ID for query",
"type": "string"
},
"inMap": {
"description": "Specify inMap status for query",
"type": "boolean"
},
"globalFilterId": {
"description": "Specify GlobalFilter ID for query",
"type": "string"
},
"auth_hostedAaaSupportedEnabled": {
"description": "Indicate if Hosted AAA Support is enabled",
"type": "boolean"
},
"auth_plmnIdentifierEnabled": {
"description": "Indicate if Configure PLMN identifier is enabled",
"type": "boolean"
},
"includeUsers": {
"description": "Should also retrieve users or not",
"type": "boolean"
}
}
},
"extraTimeRange": {
"description": "Specified data time range of selection",
"type": "object",
"additionalProperties": false,
"properties": {
"start": {
"description": "start time for collecting data",
"type": "number"
},
"end": {
"description": "end time for collecting data",
"type": "number"
},
"interval": {
"description": "time interval in second",
"type": "number"
},
"field": {
"description": "time field for collecting data",
"enum": [
"insertionTime",
"startTime",
"endTime"
],
"type": "string"
}
}
},
"fullTextSearch": {
"description": "Specified search string",
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Search logic operator",
"enum": [
"AND",
"OR"
],
"type": "string"
},
"value": {
"description": "Text or number to search",
"type": "string"
},
"fields": {
"description": "Specific fields to search",
"type": "array",
"items": {
"type": "string"
}
}
}
},
"sortInfo": {
"description": "About sorting",
"type": "object",
"additionalProperties": false,
"properties": {
"sortColumn": {
"type": "string"
},
"dir": {
"enum": [
"ASC",
"DESC"
],
"type": "string"
}
}
},
"page": {
"description": "Page number to get",
"type": "integer",
"minimum": 1
},
"limit": {
"description": "Size of one page",
"type": "integer",
"minimum": 1
},
"expandDomains": {
"description": "Whether to expand domains into sub domains/ zones or not",
"type": "boolean"
},
"criteria": {
"description": "Add backward compatibility for UI framework",
"type": "string"
},
"query": {
"description": "Add backward compatibility for UI framework",
"type": "string"
}
}
}
200
Headers
Content-Type: application/octet-stream
Body
{
"rawDataTotalCount": 0,
"totalCount": 0,
"hasMore": false,
"firstIndex": 8,
"list": []
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"rawDataTotalCount": {
"type": "integer"
},
"totalCount": {
"type": "integer"
},
"hasMore": {
"type": "boolean"
},
"firstIndex": {
"type": "integer"
},
"list": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"switchName": {
"type": "string"
},
"switchPort": {
"type": "integer"
},
"clientIpv4Addr": {
"type": "string"
},
"dot1XIpv4Addr": {
"type": "string"
},
"clientIpv6Addr": {
"type": "string"
},
"dot1XIpv6Addr": {
"type": "string"
},
"clientVlan": {
"type": "string"
},
"clientMac": {
"type": "string"
},
"clientAuthType": {
"type": "string"
},
"clientUserName": {
"type": "string"
},
"clientStatus": {
"type": "string"
},
"clientType": {
"type": "string"
},
"pastAuthHistory": {
"type": "string"
},
"clientDesc": {
"type": "string"
},
"updatedTime": {
"type": "string"
},
"clientVni": {
"type": "string"
}
}
}
}
}
}
Retrieve Switch Client online/offline count. ¶
POST/v11_1/switchClientVisibility/status
Use this API command to Retrieve the switch client online/offline count.
Headers
Content-Type: text/plain,*/*,application/x-www-form-urlencoded
Body
{
"filters": [
{
"type": "DOMAIN",
"value": "8b2081d5-9662-40d9-a3db-2a3cf4dde3f7"
}
],
"fullTextSearch": {
"type": "AND",
"value": ""
},
"page": 1,
"limit": 8
}
Schema
{
"type": "object",
"additionalProperties": false,
"properties": {
"filters": {
"description": "Filters used to select specific resource scope",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Group type",
"enum": [
"SYSTEM",
"CATEGORY",
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"BLADE",
"SYNCEDSTATUS",
"REGISTRATIONSTATE",
"STATUS",
"SWITCH_GROUP",
"FAMILY_ID",
"PORT",
"SWITCH_ID_PORT_IDENTIFIER",
"transactionId",
"dispatchStatus",
"configType",
"yang",
"removeYang"
],
"type": "string"
},
"value": {
"description": "Group ID",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraFilters": {
"description": "\"AND\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"SWITCH_GROUP",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"transactionId",
"hasLayerThreeConfig",
"clientAuthType",
"clientIpv4Addr",
"clientIpv6Addr",
"clientMac",
"clientUserName",
"switchName",
"ADMIN_STATUS",
"PORT_STATUS",
"POE_ENABLED",
"cliType",
"dispatchStatus",
"configType",
"yang",
"removeYang",
"reservedField1",
"FIRMWARE",
"dot1XIpv4Addr",
"dot1XIpv6Addr"
],
"type": "string"
},
"value": {
"description": "Value to search",
"type": "string"
},
"operator": {
"description": "Operator",
"type": "string",
"enum": [
"eq",
"gt",
"lt",
"gte",
"lte"
]
}
}
}
},
"extraNotFilters": {
"description": "\"NOT\" condition for multiple filters",
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Filters for specific attribute",
"enum": [
"CONTROLBLADE",
"DATABLADE",
"DOMAIN",
"ZONE",
"THIRD_PARTY_ZONE",
"APGROUP",
"WLANGROUP",
"INDOORMAP",
"AP",
"WLAN",
"ProtocolType",
"TIMERANGE",
"RADIOID",
"WLANID",
"CATEGORY",
"CLIENT",
"CP",
"DP",
"CLUSTER",
"NODE",
"BLADE",
"SYNCEDSTATUS",
"OSTYPE",
"APP",
"PORT",
"STATUS",
"REGISTRATIONSTATE",
"GATEWAY",
"APIPADDRESS",
"CLIENTIPADDRESS",
"SEVERITY",
"ACKNOWLEDGED",
"MVNOID",
"USER",
"USERID",
"WLANNAME",
"AUDITIPADDRESS",
"AUDITUSERUUID",
"AUDITOBJECT",
"AUDITACTION",
"AUDITTENANTUUID",
"AUDITOBJECTUUID",
"AUTHTYPE",
"AUDITTYPE",
"H20SuppportEnabled",
"AaaSuppportEnabled",
"GppSuppportEnabled",
"Type",
"RogueMac",
"SSID",
"ALARMSTATE",
"DEVICENAME",
"SWITCH",
"ZoneAffinityProfileId",
"FIRMWARE_TYPE",
"SCHEDULED_TIME",
"VLAN",
"FAMILY_ID",
"SWITCH_ID",
"switchStatus.alerts",
"switchStatus.status",
"transactionId",
"hasLayerThreeConfig",
"reservedField1",
"dispatchStatus",
"configType",
"clis",
"yang",
"removeYang",
"clientType"
],
"type": "string"
},
"value": {
"description": "Value not to search",
"type": "string"
}
}
}
},
"options": {
"description": "Specified feature required informaion",
"type": "object",
"additionalProperties": false,
"properties": {
"auth_includeNa": {
"description": "Include Not Available auth service option while returning result",
"type": "boolean"
},
"auth_includeLocalDb": {
"description": "Include LocalDB auth service while returning result",
"type": "boolean"
},
"auth_includeGuest": {
"description": "Include Guest auth service while returning result",
"type": "boolean"
},
"auth_includeAdGlobal": {
"description": "If AD is in list, include only AD with Global Catalog configured",
"type": "boolean"
},
"auth_type": {
"description": "Authentication service types to get, use comma to separate, Ex: RADIUS,AD",
"type": "string"
},
"auth_realmType": {
"description": "To get specific authentication service information for configuring realm based authentication profile",
"enum": [
"ALL",
"RADIUS"
],
"type": "string"
},
"acct_type": {
"description": "Accounting service types to get, use comma to separate, Ex: RADIUS,CGF",
"type": "string"
},
"auth_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_testableOnly": {
"description": "Only get testable service type",
"type": "boolean"
},
"acct_includeNa": {
"description": "Include Not Available acct service option while returning result",
"type": "boolean"
},
"forwarding_type": {
"description": "Forwarding service types to get, use comma to separate, Ex: L2oGRE,TTGPDG,Bridge,Advanced",
"type": "string"
},
"includeSharedResources": {
"description": "Whether to include the resources of parent domain or not",
"type": "boolean"
},
"INCLUDE_RBAC_METADATA": {
"description": "Whether to include RBAC metadata or not",
"type": "boolean"
},
"TENANT_ID": {
"description": "Specify Tenant ID for query",
"type": "string"
},
"inMap": {
"description": "Specify inMap status for query",
"type": "boolean"
},
"globalFilterId": {
"description": "Specify GlobalFilter ID for query",
"type": "string"
},
"auth_hostedAaaSupportedEnabled": {
"description": "Indicate if Hosted AAA Support is enabled",
"type": "boolean"
},
"auth_plmnIdentifierEnabled": {
"description": "Indicate if Configure PLMN identifier is enabled",
"type": "boolean"
},
"includeUsers": {
"description": "Should also retrieve users or not",
"type": "boolean"
}
}
},
"extraTimeRange": {
"description": "Specified data time range of selection",
"type": "object",
"additionalProperties": false,
"properties": {
"start": {
"description": "start time for collecting data",
"type": "number"
},
"end": {
"description": "end time for collecting data",
"type": "number"
},
"interval": {
"description": "time interval in second",
"type": "number"
},
"field": {
"description": "time field for collecting data",
"enum": [
"insertionTime",
"startTime",
"endTime"
],
"type": "string"
}
}
},
"fullTextSearch": {
"description": "Specified search string",
"type": "object",
"additionalProperties": false,
"properties": {
"type": {
"description": "Search logic operator",
"enum": [
"AND",
"OR"
],
"type": "string"
},
"value": {
"description": "Text or number to search",
"type": "string"
},
"fields": {
"description": "Specific fields to search",
"type": "array",
"items": {
"type": "string"
}
}
}
},
"sortInfo": {
"description": "About sorting",
"type": "object",
"additionalProperties": false,
"properties": {
"sortColumn": {
"type": "string"
},
"dir": {
"enum": [
"ASC",
"DESC"
],
"type": "string"
}
}
},
"page": {
"description": "Page number to get",
"type": "integer",
"minimum": 1
},
"limit": {
"description":