Back to top

Overview

This reference guide describes the public APIs supported by the SmartZone 100. Use the RESTful API commands described in this guide as an alternative way to manage the controller and its managed APs (in addition to the web and command line interfaces).

All API URIs in this guide use the common prefix "https://{host}:7443/api/public", where {host} is the IP address of the management interface of the controller.

Common Request Header

The following parameters are required in the HTTP headers of all API requests (except for the logon API).

ParameterValue
Content-Type“application/json;charset=UTF-8”
Cookie“JSESSIONID={JSESSIONID}”

JSESSIONID is returned as the following parameter in the response header of the logon API.

ParameterValue
Set-cookie“JSESSIONID={JSESSIONID}; Path=/wsg; Secure”

HTTP Responses

Successful Requests

CodeResponseDescription
200OKThe request was completed successfully. Some API calls may return a 201 response instead.
201CreatedThe request was completed successfully and a resource was created.
204No ContentThe request was completed successfully, but there was no representation to return (that is, the response was empty).

Failed Requests

CodeResponseDescription
400Bad requestThe request could not be understood or was missing at least one required parameter.
401UnauthorizedAuthentication failed or you do not have the permission to perform the requested operation.
403ForbiddenAccess denied.
404Not foundThe resource could not be found.
405Method not allowedThe requested method is unsupported for the resource.
406Not acceptableThe controller is unable to send data in the format specified in the Accept header of the request.
422Unprocessable entityThe request was well-formed but it could not be completed because of semantic errors.

Errors

CodeResponseDescription
500Internal server errorThe request is valid, but the controller is unable to process the request.
503Service unavailableThe service is temporary unavailable (for example, a scheduled maintenance). Please try again later.

Ruckus Wireless Error Codes

When the server is unable to process a request, Ruckus Wireless-specific error code and message are returned in the response body. The following table describes the list of Ruckus Wireless specific error codes.

CodeResponse
0Internal server error
101Bad HTTP request
102Bad HTTP response
103Invalid HTTP request body
104HTTP response body cannot be generated
105Unsupported API version
150Cluster not in service
151Controller node not in service
201No active session
202Login denied
211Insufficient administrative privileges
212Resource access denied
301Resource cannot be found
302Business rule violation

Change Logs

  • What’s New

    • Ruckus Wireless AP Zone
      • Modify Altitude
      • Disable Altitude
      • Retrieve AP Firmware List
      • Change AP Firmware
    • AP Group
      • Modify Altitude of ApGroup
      • Disable Altitude of ApGroup
    • WLAN
      • Modify DPSK Setting
    • Access Point Configuration
      • Modify Altitude Override
      • Diable Altitude Override
      • Modify Mesh Options
      • Disable Mesh Options
    • Certificate
      • Retrieve Certificate Setting
      • Modify serviceCertificates
    • SNMP Agent
      • Retrieve SNMP Agent
      • Modify SNMP Agent
    • DPSK
      • Retrieve DPSK info By Zone
      • Retrieve DPSK info By WLAN
      • Retrieve DPSK info By Id
      • Upload DPSK file
      • Batch Generate DPSKs
      • Retrieve interval of delete expired DPSK
      • Modify interval of delete expired DPSK
      • Delete DPSK
    • Bridge
      • Retrieve List
  • What’s Remove

    • WLAN
      • Modify Online Signup Service
      • Disable Zero-IT Onboarding
    • Online Signup Profile
      • Retrieve List
      • Retrieve
      • Create
      • Modify Basic
      • Modify Portal Customization
      • Delete
    • Identity User Role
      • Modify allowed wlans
  • What’s Deprecated

  • Changes

    • AP Group
      • Retrieve
        • attributes added [altitude]
      • Modify
        • attributes added [altitude]
      • Retrieve AP Model
        • attributes added [poeTxChain]
    • Ruckus Wireless AP Zone
      • Modify
        • attributes added [altitude,ipv6TrafficFilterEnabled]
        • attributes remove [version]
      • Retrieve AP Model
        • attributes added [poeTxChain]
      • Retrieve
        • attributes added [altitude,ipv6TrafficFilterEnabled]
    • Access Point Configuration
      • Modify
        • attributes added [altitude,meshOptions]
      • Retrieve
        • attributes added [altitude,meshOptions]
    • WLAN
      • Retrieve
        • attributes added [dpsk]
        • attributes remove [onlineSignupService]
      • Modify
        • attributes added [dpsk]
        • attributes remove [onlineSignupService]
  • Backward Compatible Notice

Login Session 

The APIs are used to acquire/retrieve/release login session.

Logon 

/v4_0/session

Use this API command to log on to the controller and acquire a valid logon session.

  • Request
  • Body
    {
        "username" : "admin",
        "password" : "admin!234",
        "apiVersions" : [ "1", "2" ],
        "timeZoneUtcOffset" : "+08:00"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "username" : {
                "description" : "Logon user name",
                "type" : "string"
            },
            "password" : {
                "description" : "Logon password",
                "type" : "string"
            },
            "domainName" : {
                "description" : "Logon domain name",
                "type" : "string"
            },
            "apiVersions" : {
                "description" : "API version supported by the client",
                "type" : "array",
                "items" : {
                    "type" : "string"
                },
                "minItems" : 1,
                "uniqueItems" : true
            },
            "timeZoneUtcOffset" : {
                "description" : "Local timezone of the client, offset to UTC",
                "enum" : [ "-12:00", "-11:00", "-10:00", "-09:30", "-09:00", "-08:00", "-07:00", "-06:00", "-05:00", "-04:30", "-04:00", "-03:30", "-03:00", "-02:00", "-01:00", "+00:00", "-00:00", "±00:00", "+01:00", "+02:00", "+03:00", "+03:30", "+04:00", "+04:30", "+05:00", "+05:30", "+05:45", "+06:00", "+06:30", "+07:00", "+08:00", "+08:45", "+09:00", "+09:30", "+10:00", "+10:30", "+11:00", "+11:30", "+12:00", "+12:45", "+13:00", "+14:00" ]
            }
        },
        "required" : [ "username", "password" ]
    }
    
    
  • Response  200
  • Body
    {
        "apiVersion" : "1"
    }
    
    
    Schema
    {
        "type" : "object",
        "properties" : {
            "controllerVersion" : {
                "type" : "string"
            }
        }
    }
    
    

Logoff 

/v4_0/session

Use this API command to log off of the controller.

  • Response  200

Retrieve 

/v4_0/session

Use this API command to retrieve information about the current logon session.

  • Response  200
  • Body
    {
        "cpId" : "DEV_BLADE_UUID",
        "domainId" : "8b2081d5-9662-40d9-a3db-2a3cf4dde3f7",
        "adminRoleId" : "69962d35-9447-41a1-aff5-facf1e85c674",
        "mvnoId" : "839f87c6-d116-497e-afce-aa8157abd30c",
        "adminId" : "92cc1b65-c3cd-4f26-8c9b-3e7b055c7c25",
        "clientIp" : "172.18.193.1",
        "apiVersions" : [ "1_0" ],
        "timeZoneUtcOffset" : 0
    }
    
    
    Schema
    {
        "type" : "object",
        "properties" : {
            "cpId" : {
                "type" : "string"
            },
            "domainId" : {
                "type" : "string"
            },
            "adminRoleId" : {
                "type" : "string"
            },
            "mvnoId" : {
                "type" : "string"
            },
            "adminId" : {
                "type" : "string"
            },
            "clientIp" : {
                "type" : "string"
            },
            "apiVersions" : {
                "description" : "API version supported by the client",
                "type" : "array",
                "items" : {
                    "type" : "string"
                }
            },
            "timeZoneUtcOffset" : {
                "type" : "integer"
            }
        }
    }
    
    

Ruckus Wireless AP Zone 

Retrieve List 

/v4_0/rkszones

Use this API command to retrieve the list of Ruckus Wireless AP zones that belong to a domain.

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

    domainId
    string (optional) 

    The domain ID. Default: current logon domain ID

  • Response  200
  • Body
    {
        "totalCount" : 2,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "zoneUUID",
            "name" : "zoneName"
        }, {
            "id" : "zoneUUID2",
            "name" : "zoneName2"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the zone",
                            "type" : "string"
                        },
                        "name" : {
                            "description" : "Name of the zone",
                            "type" : "string"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve 

/v4_0/rkszones/{id}

Use this API command to retrieve Ruckus Wireless AP zones configuration.

  • Response  200
  • Body
    {
        "id" : "ad5ffab1-b3ed-4b36-b054-bc723a977dbb",
        "domainId" : "8b2081d5-9662-40d9-a3db-2a3cf4dde3f7",
        "name" : "public-api-zone-ipv6",
        "description" : null,
        "countryCode" : "US",
        "version" : "3.1.0.0.55",
        "timezone" : {
            "systemTimezone" : "UTC",
            "customizedTimezone" : null
        },
        "ipMode" : "IPV6",
        "login" : {
            "apLoginName" : "admin",
            "apLoginPassword" : "admin!234"
        },
        "mesh" : null,
        "dfsChannelEnabled" : false,
        "wifi24" : {
            "txPower" : "Full",
            "channelWidth" : 20,
            "channel" : 0,
            "channelRange" : [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11 ],
            "availableChannelRange" : [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11 ]
        },
        "wifi50" : {
            "txPower" : "-1dB",
            "channelWidth" : 40,
            "indoorChannel" : 0,
            "outdoorChannel" : 0,
            "indoorChannelRange" : [ 36, 40, 44, 48, 149, 153, 157, 161 ],
            "outdoorChannelRange" : [ 149, 153, 157, 161 ],
            "availableIndoorChannelRange" : [ 36, 40, 44, 48, 149, 153, 157, 161 ],
            "availableOutdoorChannelRange" : [ 149, 153, 157, 161 ]
        },
        "syslog" : null,
        "smartMonitor" : null,
        "clientAdmissionControl24" : null,
        "clientAdmissionControl50" : null,
        "channelModeEnabled" : false,
        "tunnelType" : "SoftGREIpsec",
        "tunnelProfile" : {
            "id" : "tunnelProfileId",
            "name" : "tunnelProfileName"
        },
        "enterpriseZoneTunnelConfig" : {
            "primaryGateway" : "172.17.26.87",
            "tunnelMtuAutoEnabled" : true,
            "tunnelKeepAliveInterval" : 10,
            "tunnelKeepAliveRetryLimit" : 5,
            "forceDisassociateClientEnabled" : false
        },
        "backgroundScanning24" : null,
        "backgroundScanning50" : null,
        "clientLoadBalancing24" : null,
        "clientLoadBalancing50" : null,
        "bandBalancing" : null,
        "rogue" : null,
        "locationBasedService" : null,
        "apRebootTimeout" : {
            "gatewayLossTimeoutInSec" : 1800,
            "serverLossTimeoutInSec" : 7200
        },
        "location" : null,
        "locationAdditionalInfo" : null,
        "latitude" : null,
        "longitude" : null,
        "vlanOverlappingEnabled" : false,
        "nodeAffinityProfile" : null,
        "venueProfile" : null,
        "autoChannelSelection24" : {
            "channelSelectMode" : "ChannelFly",
            "channelFlyMtbc" : 480
        },
        "autoChannelSelection50" : {
            "channelSelectMode" : "BackgroundScanning",
            "channelFlyMtbc" : 480
        },
        "channelEvaluationInterval" : 777,
        "apMgmtVlan" : {
            "id" : 1,
            "mode" : "KEEP"
        },
        "ipsecProfile" : {
            "id" : "ipsecProfileId",
            "name" : "ipsecProfileName"
        },
        "autoPurgeExpiredDpsk" : "OneDay",
        "altitude" : {
            "altitudeUnit" : "meters",
            "altitudeValue" : 1
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the zone",
                "type" : "string"
            },
            "domainId" : {
                "description" : "Identifier of the management domain to which the zone belongs",
                "type" : "string"
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the zone"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the zone"
            },
            "version" : {
                "type" : "string",
                "pattern" : "^\d+\.\d+\.\d+\.\d+\.\d+$",
                "description" : "AP firmware version of the zone"
            },
            "countryCode" : {
                "description" : "Country code of the zone",
                "type" : "string"
            },
            "timezone" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "customizedTimezone" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "properties" : {
                            "abbreviation" : {
                                "description" : "Time zone abbreviation",
                                "type" : "string",
                                "pattern" : "^[a-zA-Z]{3,4}$"
                            },
                            "gmtOffset" : {
                                "description" : "GMT offset ",
                                "type" : "integer",
                                "minimum" : -11,
                                "maximum" : 14
                            },
                            "gmtOffsetMinute" : {
                                "description" : "GMT offset minute",
                                "type" : "integer",
                                "minimum" : 0,
                                "maximum" : 59
                            },
                            "start" : {
                                "type" : "object",
                                "additionalProperties" : false,
                                "properties" : {
                                    "month" : {
                                        "description" : "Month when daylight saving time begins",
                                        "enum" : [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 ]
                                    },
                                    "week" : {
                                        "description" : "Week of the month (1 for the first week, 2 for the second week, and so on)",
                                        "enum" : [ 1, 2, 3, 4, 5 ]
                                    },
                                    "day" : {
                                        "description" : "Day of the week (0 for Sunday, 1 for Monday, 2 for Tuesday, and so on)",
                                        "enum" : [ 0, 1, 2, 3, 4, 5, 6 ]
                                    },
                                    "hour" : {
                                        "description" : "Hour of the day",
                                        "type" : "integer",
                                        "minimum" : 0,
                                        "maximum" : 23
                                    }
                                },
                                "required" : [ "month", "week", "day", "hour" ],
                                "description" : "Daylight saving time start"
                            },
                            "end" : {
                                "type" : "object",
                                "additionalProperties" : false,
                                "properties" : {
                                    "month" : {
                                        "description" : "Month when daylight saving time begins",
                                        "enum" : [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 ]
                                    },
                                    "week" : {
                                        "description" : "Week of the month (1 for the first week, 2 for the second week, and so on)",
                                        "enum" : [ 1, 2, 3, 4, 5 ]
                                    },
                                    "day" : {
                                        "description" : "Day of the week (0 for Sunday, 1 for Monday, 2 for Tuesday, and so on)",
                                        "enum" : [ 0, 1, 2, 3, 4, 5, 6 ]
                                    },
                                    "hour" : {
                                        "description" : "Hour of the day",
                                        "type" : "integer",
                                        "minimum" : 0,
                                        "maximum" : 23
                                    }
                                },
                                "required" : [ "month", "week", "day", "hour" ],
                                "description" : "Daylight saving time end"
                            }
                        },
                        "required" : [ "abbreviation", "gmtOffset", "gmtOffsetMinute" ],
                        "description" : "User defined time zone"
                    }
                }
            },
            "login" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "apLoginName" : {
                        "type" : "string",
                        "maxLength" : 64,
                        "pattern" : "^((?!\$\()[!-_a-~]){1,64}$",
                        "description" : "User name of the AP administrator"
                    },
                    "apLoginPassword" : {
                        "type" : "string",
                        "maxLength" : 64,
                        "pattern" : ".*(?=.{8,})(?=.*[a-zA-Z])(?=.*[0-9])(?=.*[_`~!@#$%^&*\(\)\[\]\{\}|;:'\",.\<>\/?=+-]).*",
                        "description" : "Password of the AP administrator"
                    }
                },
                "required" : [ "apLoginName", "apLoginPassword" ],
                "description" : "AP administrator account"
            },
            "ipMode" : {
                "enum" : [ "IPV4", "IPV6", "IPV4_IPV6" ],
                "description" : "IP mode of the zone"
            },
            "mesh" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "ssid" : {
                        "description" : "SSID of the mesh network",
                        "type" : "string"
                    },
                    "passphrase" : {
                        "description" : "Passphrase for the mesh network",
                        "type" : "string"
                    }
                },
                "description" : "Mesh configuration of the zone."
            },
            "dfsChannelEnabled" : {
                "description" : "DFS Channel enabled configuration of the zone, only for the US country code .",
                "type" : "boolean"
            },
            "wifi24" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "txPower" : {
                        "enum" : [ "Full", "-1dB", "-2dB", "-3dB(1/2)", "-4dB", "-5dB", "-6dB(1/4)", "-7dB", "-8dB", "-9dB(1/8)", "-10dB", "Min" ],
                        "description" : "Transmission power"
                    },
                    "channelWidth" : {
                        "description" : "Channel width. Zero (0) means Auto.",
                        "enum" : [ 0, 20, 40 ]
                    },
                    "channel" : {
                        "description" : "Channel number",
                        "type" : "integer"
                    },
                    "channelRange" : {
                        "description" : "Channel range options",
                        "type" : "array",
                        "items" : {
                            "type" : "integer"
                        }
                    },
                    "availableChannelRange" : {
                        "description" : "Available channel range options",
                        "type" : "array",
                        "items" : {
                            "type" : "integer"
                        }
                    }
                },
                "description" : "AP 2.4GHz radio configuration of the zone."
            },
            "wifi50" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "txPower" : {
                        "enum" : [ "Full", "-1dB", "-2dB", "-3dB(1/2)", "-4dB", "-5dB", "-6dB(1/4)", "-7dB", "-8dB", "-9dB(1/8)", "-10dB", "Min" ],
                        "description" : "Transmission power"
                    },
                    "channelWidth" : {
                        "description" : "Channel width. Zero (0) means Auto.",
                        "enum" : [ 0, 20, 40, 80 ]
                    },
                    "indoorChannel" : {
                        "description" : "Indoor channel number",
                        "type" : "integer"
                    },
                    "outdoorChannel" : {
                        "description" : "Outdoor channel number",
                        "type" : "integer"
                    },
                    "indoorChannelRange" : {
                        "description" : "Channel range options",
                        "type" : "array",
                        "items" : {
                            "type" : "integer"
                        }
                    },
                    "outdoorChannelRange" : {
                        "description" : "Channel range options",
                        "type" : "array",
                        "items" : {
                            "type" : "integer"
                        }
                    },
                    "availableIndoorChannelRange" : {
                        "description" : "Available channel range options",
                        "type" : "array",
                        "items" : {
                            "type" : "integer"
                        }
                    },
                    "availableOutdoorChannelRange" : {
                        "description" : "Available channel range options",
                        "type" : "array",
                        "items" : {
                            "type" : "integer"
                        }
                    }
                },
                "description" : "AP 5GHz radio configuration of the zone."
            },
            "syslog" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "address" : {
                        "type" : "string",
                        "description" : "Address of the syslog server."
                    },
                    "port" : {
                        "description" : "Port number of the syslog server",
                        "type" : "integer",
                        "default" : 514,
                        "minimum" : 1,
                        "maximum" : 65535
                    },
                    "facility" : {
                        "description" : "Facility of the syslog server",
                        "enum" : [ "Keep_Original", "Local0", "Local1", "Local2", "Local3", "Local4", "Local5", "Local6", "Local7" ],
                        "default" : "keep_Original"
                    },
                    "priority" : {
                        "description" : "Priority of the log messages",
                        "enum" : [ "Emergency", "Alert", "Critical", "Error", "Warning", "Notice", "Info", "All" ],
                        "default" : "Error"
                    }
                },
                "description" : "Syslog configuration of the zone."
            },
            "smartMonitor" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "intervalInSec" : {
                        "description" : "Interval in seconds. This is required if smartMonitor is enabled",
                        "type" : "integer",
                        "default" : 10,
                        "minimum" : 5,
                        "maximum" : 60
                    },
                    "retryThreshold" : {
                        "description" : "Retry threshold. This is required if smartMonitor is enabled",
                        "type" : "integer",
                        "default" : 3,
                        "minimum" : 1,
                        "maximum" : 10
                    }
                },
                "description" : "Smart monitor configuration of the zone."
            },
            "clientAdmissionControl24" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "maxRadioLoadPercent" : {
                        "description" : "Maximum radio load percentage.",
                        "type" : "integer",
                        "default" : 75,
                        "minimum" : 50,
                        "maximum" : 100
                    },
                    "minClientCount" : {
                        "description" : "Minimum client count number.",
                        "type" : "integer",
                        "default" : 10,
                        "minimum" : 0,
                        "maximum" : 100
                    },
                    "minClientThroughputMbps" : {
                        "description" : "Minimum client throughput in Mbps.",
                        "type" : "number",
                        "default" : 0,
                        "minimum" : 0,
                        "maximum" : 100
                    }
                },
                "description" : "AP client admission control 2.4GHz radio configuration of the zone."
            },
            "clientAdmissionControl50" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "maxRadioLoadPercent" : {
                        "description" : "Maximum radio load percentage.",
                        "type" : "integer",
                        "default" : 75,
                        "minimum" : 50,
                        "maximum" : 100
                    },
                    "minClientCount" : {
                        "description" : "Minimum client count number.",
                        "type" : "integer",
                        "default" : 10,
                        "minimum" : 0,
                        "maximum" : 100
                    },
                    "minClientThroughputMbps" : {
                        "description" : "Minimum client throughput in Mbps.",
                        "type" : "number",
                        "default" : 0,
                        "minimum" : 0,
                        "maximum" : 100
                    }
                },
                "description" : "AP client admission control 5GHz radio configuration of the zone."
            },
            "channelModeEnabled" : {
                "description" : "Channel mode configuration of the zone.",
                "type" : "boolean"
            },
            "tunnelType" : {
                "description" : "Tunnel type configuration of the zone. No_Tunneled is for IPv6 mode",
                "enum" : [ "No_Tunneled", "RuckusGRE", "SoftGRE", "SoftGREIpsec" ]
            },
            "tunnelProfile" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Tunnel type configuration of the zone."
            },
            "enterpriseZoneTunnelConfig" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "tunnelMtuAutoEnabled" : {
                        "description" : "Enable mtu auto",
                        "type" : "boolean"
                    },
                    "tunnelMtuSize" : {
                        "description" : "Tunnel mtu size, IPV4:850-1500, IPV6:1384-1500.",
                        "type" : "integer",
                        "default" : 1500
                    },
                    "ruckusTunnelModel" : {
                        "description" : "Ruckus GRE, TunnelModel",
                        "enum" : [ "GRE", "GREUDP" ]
                    },
                    "natUDPPort" : {
                        "description" : "Ruckus GRE, Data plane UDP Port.",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 65535,
                        "default" : 23233
                    },
                    "tunnelEncryption" : {
                        "description" : "Ruckus GRE ,Enable tunnel encryption",
                        "type" : "boolean"
                    },
                    "primaryGateway" : {
                        "description" : "Soft GRE primary gateway",
                        "type" : "string"
                    },
                    "secondaryGateway" : {
                        "description" : "Soft GRE, secondary gateway",
                        "type" : "string"
                    },
                    "primaryGatewayV6" : {
                        "description" : "Soft GRE, primary gateway for IPV6",
                        "type" : "string"
                    },
                    "secondaryGatewayV6" : {
                        "description" : "Soft GRE, secondary gateway for IPV6",
                        "type" : "string"
                    },
                    "tunnelKeepAliveInterval" : {
                        "description" : "Soft GRE tunnel keep alive interval, 1-180. Default 10.",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 180,
                        "default" : 10
                    },
                    "tunnelKeepAliveRetryLimit" : {
                        "description" : "Soft GRE tunnel keep alive retry limit, 2-10. Default 5.",
                        "type" : "integer",
                        "minimum" : 2,
                        "maximum" : 10,
                        "default" : 5
                    },
                    "forceDisassociateClientEnabled" : {
                        "description" : "Enable forceDisassociateClient",
                        "type" : "boolean"
                    }
                },
                "description" : "Tunnel profile settings for Enterprise."
            },
            "backgroundScanning24" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "frequencyInSec" : {
                        "description" : "Frequency in second",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 65535
                    }
                },
                "description" : "Background scanning on 2.4GHz radio configuration of the zone."
            },
            "backgroundScanning50" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "frequencyInSec" : {
                        "description" : "Frequency in second",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 65535
                    }
                },
                "description" : "Background scanning on 5GHz radio configuration of the zone."
            },
            "clientLoadBalancing24" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "adjacentRadioThreshold" : {
                        "description" : "Adjacent radio threshold",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 100
                    }
                },
                "description" : "Client load balancing on 2.4GHz radio configuration of the zone."
            },
            "clientLoadBalancing50" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "adjacentRadioThreshold" : {
                        "description" : "Adjacent radio threshold",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 100
                    }
                },
                "description" : "Client load balancing on 5GHz radio configuration of the zone."
            },
            "bandBalancing" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "wifi24Percentage" : {
                        "description" : "Percentage of client load on 2.4GHz radio band",
                        "type" : "integer",
                        "minimum" : 0,
                        "maximum" : 100
                    }
                },
                "description" : "Band balancing configuration of the zone."
            },
            "rogue" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "reportType" : {
                        "description" : "Report type",
                        "enum" : [ "All", "Malicious" ]
                    },
                    "maliciousTypes" : {
                        "description" : "Malicious type when reportType is Malicious",
                        "type" : [ "array", "null" ],
                        "items" : {
                            "enum" : [ "SSIDSpoofing", "SameNetwork", "MACSpoofing" ]
                        }
                    },
                    "protectionEnabled" : {
                        "description" : "Protection enabled",
                        "type" : "boolean"
                    }
                },
                "description" : "Rogue AP detection configuration of the zone."
            },
            "locationBasedService" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Location based service configuration of the zone."
            },
            "apRebootTimeout" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "gatewayLossTimeoutInSec" : {
                        "description" : "Gateway loss timeout in second",
                        "enum" : [ 0, 1800, 3600, 5400, 7200, 9000, 10800, 12600, 14400, 16200, 18000, 19800, 23400, 25200, 27000, 28800, 30600, 32400, 34200, 36000, 37800, 39600, 41400, 43200, 45000, 46800, 48600, 50400, 52200, 54000, 55800, 57600, 59400, 61200, 63000, 64800, 66600, 68400, 70200, 72000, 73800, 75600, 77400, 79200, 81000, 82800, 84600, 86400 ]
                    },
                    "serverLossTimeoutInSec" : {
                        "description" : "Server loss timeout in second",
                        "enum" : [ 0, 7200, 14400, 21600, 28800, 36000, 43200, 50400, 57600, 64800, 72000, 79200, 86400 ]
                    }
                },
                "description" : "AP reboot timeout of the zone."
            },
            "location" : {
                "type" : "string",
                "pattern" : "^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Location of the Zone."
            },
            "locationAdditionalInfo" : {
                "type" : "string",
                "pattern" : "^([!-~]([ -~]){0,253}[!-~]|[!-~]{1,1})$",
                "description" : "Location additional info of the zone."
            },
            "altitude" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "altitudeUnit" : {
                        "description" : "altitude unit",
                        "enum" : [ "meters", "floor" ]
                    },
                    "altitudeValue" : {
                        "description" : "altitude value",
                        "type" : "integer"
                    }
                },
                "description" : "GPS Altitude"
            },
            "latitude" : {
                "type" : "number",
                "description" : "Latitude coordinate (in decimal format) of the zone"
            },
            "longitude" : {
                "type" : "number",
                "description" : "Longitude coordinate (in decimal format) of the zone"
            },
            "vlanOverlappingEnabled" : {
                "description" : "VLAN pooling overlapping of the zone",
                "type" : "boolean"
            },
            "nodeAffinityProfile" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Node affinity profile of the zone."
            },
            "venueProfile" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "venue profile configuration of the Zone."
            },
            "usbSoftwarePackage" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "usbSoftware" : {
                        "type" : [ "object", "null" ],
                        "additionalProperties" : false,
                        "properties" : {
                            "id" : {
                                "type" : "string"
                            },
                            "name" : {
                                "type" : "string"
                            }
                        },
                        "description" : "APUsbSoftwarePackage id or name"
                    },
                    "applyModel" : {
                        "description" : "List of apply models",
                        "type" : "array",
                        "items" : {
                            "type" : "string"
                        }
                    }
                },
                "description" : "APUsbSoftwarePackage of the zone"
            },
            "autoChannelSelection24" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "channelSelectMode" : {
                        "description" : "Channel Select Mode",
                        "enum" : [ "None", "BackgroundScanning", "ChannelFly" ]
                    },
                    "channelFlyMtbc" : {
                        "description" : "ChannelFly MTBC",
                        "type" : "integer",
                        "default" : 480,
                        "minimum" : 100,
                        "maximum" : 1440
                    }
                },
                "description" : "client load balancing on Radio 2.4G, auto channel selection mode"
            },
            "autoChannelSelection50" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "channelSelectMode" : {
                        "description" : "Channel Select Mode",
                        "enum" : [ "None", "BackgroundScanning", "ChannelFly" ]
                    },
                    "channelFlyMtbc" : {
                        "description" : "ChannelFly MTBC",
                        "type" : "integer",
                        "default" : 480,
                        "minimum" : 100,
                        "maximum" : 1440
                    }
                },
                "description" : "client load balancing on Radio 5G, auto channel selection mode"
            },
            "channelEvaluationInterval" : {
                "description" : "channel evaluation Interval of the zone",
                "type" : "integer",
                "default" : 600,
                "minimum" : 60,
                "maximum" : 3600
            },
            "apMgmtVlan" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "mode" : {
                        "description" : "Vlan Mode of the zone",
                        "enum" : [ "KEEP", "USER_DEFINED" ]
                    },
                    "id" : {
                        "description" : "Vlan id of the zone",
                        "type" : "integer"
                    }
                },
                "description" : "ap Management Vlan of the zone"
            },
            "ipsecProfile" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "ipsec profile configuration of the Zone."
            },
            "ipv6TrafficFilterEnabled" : {
                "description" : "IPv6 Traffic filtering on the AP",
                "type" : "integer"
            }
        }
    }
    
    

Retrieve Mesh Configuration 

/v4_0/rkszones/{id}/mesh

Use this API command to retrieve the mesh configuration of a zone.

  • Response  200
  • Body
    {
        "ssid" : "meshSSID",
        "passphrase" : "passphrase"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "ssid" : {
                "description" : "SSID of the mesh network",
                "type" : "string"
            },
            "passphrase" : {
                "description" : "Passphrase for the mesh network",
                "type" : "string"
            }
        }
    }
    
    

Modify Mesh Configuration 

/v4_0/rkszones/{id}/mesh

Use this API command to enable mesh networking or update the mesh configuration.

  • Request
  • Body
    {
        "ssid" : "meshSSID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "ssid" : {
                "description" : "SSID of the mesh network",
                "type" : "string"
            },
            "passphrase" : {
                "description" : "Passphrase for the mesh network",
                "type" : "string"
            }
        },
        "description" : "Mesh configuration of the zone."
    }
    
    
  • Response  204

Clear Mesh Configuration 

/v4_0/rkszones/{id}/mesh

Use this API command to disable mesh networking.

  • Response  204

Modify Basic 

/v4_0/rkszones/{id}

Use this API command to modify the basic information of a zone.

  • Request
  • Body
    {
        "domainId" : "domainUUIDToMove",
        "name" : "zoneModified",
        "description" : "description modified",
        "countryCode" : "US",
        "dfsChannelEnabled" : false,
        "channelModeEnabled" : false,
        "tunnelType" : "RuckusGRE",
        "location" : "location",
        "locationAdditionalInfo" : "locationAdditionalInfo",
        "latitude" : 23,
        "longitude" : 23,
        "vlanOverlappingEnabled" : false,
        "channelEvaluationInterval" : 777
    }
    
    
    Schema
    {
        "domainId" : {
            "description" : "Identifier of the management domain to which the zone belongs",
            "type" : "string"
        },
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Name of the zone"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Description of the zone"
        },
        "countryCode" : {
            "description" : "Country code of the zone",
            "type" : "string"
        },
        "dfsChannelEnabled" : {
            "description" : "DFS Channel enabled configuration of the zone, only for the US country code .",
            "type" : "boolean"
        },
        "channelModeEnabled" : {
            "description" : "Channel mode configuration of the zone.",
            "type" : "boolean"
        },
        "tunnelType" : {
            "description" : "Tunnel type configuration of the zone. No_Tunneled is for IPv6 mode",
            "enum" : [ "No_Tunneled", "RuckusGRE", "SoftGRE", "SoftGREIpsec" ]
        },
        "location" : {
            "type" : "string",
            "pattern" : "^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Location of the zone."
        },
        "locationAdditionalInfo" : {
            "type" : "string",
            "pattern" : "^([!-~]([ -~]){0,253}[!-~]|[!-~]{1,1})$",
            "description" : "Location additional info of the zone."
        },
        "latitude" : {
            "type" : "number",
            "description" : "Latitude coordinate (in decimal format) of the zone"
        },
        "longitude" : {
            "type" : "number",
            "description" : "Longitude coordinate (in decimal format) of the zone"
        },
        "vlanOverlappingEnabled" : {
            "description" : "VLAN pooling overlapping of the zone",
            "type" : "boolean"
        },
        "channelEvaluationInterval" : {
            "description" : "channel evaluation Interval of the zone",
            "type" : "integer",
            "default" : 600,
            "minimum" : 60,
            "maximum" : 3600
        },
        "ipv6TrafficFilterEnabled" : {
            "description" : "IPv6 Traffic filtering on the AP",
            "type" : "integer"
        }
    }
    
    
  • Response  204

Modify Time Zone 

/v4_0/rkszones/{id}/timezone

Use this API command to modify the time zone of a zone.

  • Request
  • Body
    {
        "customizedTimezone" : {
            "abbreviation" : "ABC",
            "gmtOffset" : 4,
            "gmtOffsetMinute" : 10
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "customizedTimezone" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "abbreviation" : {
                        "description" : "Time zone abbreviation",
                        "type" : "string",
                        "pattern" : "^[a-zA-Z]{3,4}$"
                    },
                    "gmtOffset" : {
                        "description" : "GMT offset ",
                        "type" : "integer",
                        "minimum" : -11,
                        "maximum" : 14
                    },
                    "gmtOffsetMinute" : {
                        "description" : "GMT offset minute",
                        "type" : "integer",
                        "minimum" : 0,
                        "maximum" : 59
                    },
                    "start" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "properties" : {
                            "month" : {
                                "description" : "Month when daylight saving time begins",
                                "enum" : [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 ]
                            },
                            "week" : {
                                "description" : "Week of the month (1 for the first week, 2 for the second week, and so on)",
                                "enum" : [ 1, 2, 3, 4, 5 ]
                            },
                            "day" : {
                                "description" : "Day of the week (0 for Sunday, 1 for Monday, 2 for Tuesday, and so on)",
                                "enum" : [ 0, 1, 2, 3, 4, 5, 6 ]
                            },
                            "hour" : {
                                "description" : "Hour of the day",
                                "type" : "integer",
                                "minimum" : 0,
                                "maximum" : 23
                            }
                        },
                        "required" : [ "month", "week", "day", "hour" ],
                        "description" : "Daylight saving time start"
                    },
                    "end" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "properties" : {
                            "month" : {
                                "description" : "Month when daylight saving time begins",
                                "enum" : [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 ]
                            },
                            "week" : {
                                "description" : "Week of the month (1 for the first week, 2 for the second week, and so on)",
                                "enum" : [ 1, 2, 3, 4, 5 ]
                            },
                            "day" : {
                                "description" : "Day of the week (0 for Sunday, 1 for Monday, 2 for Tuesday, and so on)",
                                "enum" : [ 0, 1, 2, 3, 4, 5, 6 ]
                            },
                            "hour" : {
                                "description" : "Hour of the day",
                                "type" : "integer",
                                "minimum" : 0,
                                "maximum" : 23
                            }
                        },
                        "required" : [ "month", "week", "day", "hour" ],
                        "description" : "Daylight saving time end"
                    }
                },
                "required" : [ "abbreviation", "gmtOffset", "gmtOffsetMinute" ],
                "description" : "User defined time zone"
            }
        },
        "description" : "Time zone"
    }
    
    
  • Response  204

Follow System Time Zone 

/v4_0/rkszones/{id}/timezone

Use this API command to reset the time zone with system time zone of a zone.

  • Response  204

Modify AP Logon 

/v4_0/rkszones/{id}/login

Use this API command to modify the AP logon information for APs that belong to a zone.

  • Request
  • Body
    {
        "apLoginName" : "apLoginName",
        "apLoginPassword" : "apLoginPassword"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "apLoginName" : {
                "type" : "string",
                "maxLength" : 64,
                "pattern" : "^((?!\$\()[!-_a-~]){1,64}$",
                "description" : "User name of the AP administrator"
            },
            "apLoginPassword" : {
                "type" : "string",
                "maxLength" : 64,
                "pattern" : ".*(?=.{8,})(?=.*[a-zA-Z])(?=.*[0-9])(?=.*[_`~!@#$%^&*\(\)\[\]\{\}|;:'\",.\<>\/?=+-]).*",
                "description" : "Password of the AP administrator"
            }
        },
        "required" : [ "apLoginName", "apLoginPassword" ],
        "description" : "AP administrator account"
    }
    
    
  • Response  204

Modify Radio 2.4G 

/v4_0/rkszones/{id}/wifi24

Use this API command to modify the 2.4GHz radio configuration for APs that belong to a zone.

  • Request
  • Body
    {
        "txPower" : "Full",
        "channelWidth" : 20,
        "channel" : 0,
        "channelRange" : [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11 ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "txPower" : {
                "enum" : [ "Full", "-1dB", "-2dB", "-3dB(1/2)", "-4dB", "-5dB", "-6dB(1/4)", "-7dB", "-8dB", "-9dB(1/8)", "-10dB", "Min" ],
                "description" : "Transmission power"
            },
            "channelWidth" : {
                "description" : "Channel width. Zero (0) means Auto.",
                "enum" : [ 0, 20, 40 ]
            },
            "channel" : {
                "description" : "Channel number",
                "type" : "integer"
            },
            "channelRange" : {
                "description" : "Channel range options",
                "type" : "array",
                "items" : {
                    "type" : "integer"
                }
            },
            "availableChannelRange" : {
                "description" : "Available channel range options",
                "type" : "array",
                "items" : {
                    "type" : "integer"
                }
            }
        },
        "description" : "AP 2.4GHz radio configuration of the zone."
    }
    
    
  • Response  204

Modify Radio 5G 

/v4_0/rkszones/{id}/wifi50

Use this API command to modify the 5GHz radio configuration for APs that belong to a zone.

  • Request
  • Body
    {
        "txPower" : "-1dB",
        "channelWidth" : 40,
        "indoorChannel" : 0,
        "outdoorChannel" : 0,
        "indoorChannelRange" : [ 36, 40, 44, 48, 149, 153, 157, 161 ],
        "outdoorChannelRange" : [ 149, 153, 157, 161 ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "txPower" : {
                "enum" : [ "Full", "-1dB", "-2dB", "-3dB(1/2)", "-4dB", "-5dB", "-6dB(1/4)", "-7dB", "-8dB", "-9dB(1/8)", "-10dB", "Min" ],
                "description" : "Transmission power"
            },
            "channelWidth" : {
                "description" : "Channel width. Zero (0) means Auto.",
                "enum" : [ 0, 20, 40, 80 ]
            },
            "indoorChannel" : {
                "description" : "Indoor channel number",
                "type" : "integer"
            },
            "outdoorChannel" : {
                "description" : "Outdoor channel number",
                "type" : "integer"
            },
            "indoorChannelRange" : {
                "description" : "Channel range options",
                "type" : "array",
                "items" : {
                    "type" : "integer"
                }
            },
            "outdoorChannelRange" : {
                "description" : "Channel range options",
                "type" : "array",
                "items" : {
                    "type" : "integer"
                }
            },
            "availableIndoorChannelRange" : {
                "description" : "Available channel range options",
                "type" : "array",
                "items" : {
                    "type" : "integer"
                }
            },
            "availableOutdoorChannelRange" : {
                "description" : "Available channel range options",
                "type" : "array",
                "items" : {
                    "type" : "integer"
                }
            }
        },
        "description" : "AP 5GHz radio configuration of the zone."
    }
    
    
  • Response  204

Modify Syslog 

/v4_0/rkszones/{id}/syslog

Use this API command to modify the syslog configuration for APs that belong to a zone.

  • Request
  • Body
    {
        "address" : "1.1.1.1",
        "port" : 514,
        "facility" : "keep_Original",
        "priority" : "Error"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "address" : {
                "type" : "string",
                "description" : "Address of the syslog server."
            },
            "port" : {
                "description" : "Port number of the syslog server",
                "type" : "integer",
                "default" : 514,
                "minimum" : 1,
                "maximum" : 65535
            },
            "facility" : {
                "description" : "Facility of the syslog server",
                "enum" : [ "Keep_Original", "Local0", "Local1", "Local2", "Local3", "Local4", "Local5", "Local6", "Local7" ],
                "default" : "keep_Original"
            },
            "priority" : {
                "description" : "Priority of the log messages",
                "enum" : [ "Emergency", "Alert", "Critical", "Error", "Warning", "Notice", "Info", "All" ],
                "default" : "Error"
            }
        },
        "description" : "Syslog configuration of the zone."
    }
    
    
  • Response  204

Disable Syslog 

/v4_0/rkszones/{id}/syslog

Use this API command to disable syslog configuration for APs that belong to a zone.

  • Response  204

Modify Smart Monitor 

/v4_0/rkszones/{id}/smartMonitor

Use this API command to modify the smart monitor for APs that belong to a zone.

  • Request
  • Body
    {
        "intervalInSec" : 10,
        "retryThreshold" : 3
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "intervalInSec" : {
                "description" : "Interval in seconds. This is required if smartMonitor is enabled",
                "type" : "integer",
                "default" : 10,
                "minimum" : 5,
                "maximum" : 60
            },
            "retryThreshold" : {
                "description" : "Retry threshold. This is required if smartMonitor is enabled",
                "type" : "integer",
                "default" : 3,
                "minimum" : 1,
                "maximum" : 10
            }
        },
        "description" : "Smart monitor configuration of the zone."
    }
    
    
  • Response  204

Disable Smart Monitor 

/v4_0/rkszones/{id}/smartMonitor

Use this API command to disable smart monitor for APs that belong to a zone.

  • Response  204

Modify Client Admission Control 2.4G 

/v4_0/rkszones/{id}/clientAdmissionControl24

Use this API command to modify the client admission control 2.4GHz radio configuration for APs that belong to a zone.

  • Request
  • Body
    {
        "maxRadioLoadPercent" : 75,
        "minClientCount" : "10",
        "minClientThroughputMbps" : 0
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "maxRadioLoadPercent" : {
                "description" : "Maximum radio load percentage.",
                "type" : "integer",
                "default" : 75,
                "minimum" : 50,
                "maximum" : 100
            },
            "minClientCount" : {
                "description" : "Minimum client count number.",
                "type" : "integer",
                "default" : 10,
                "minimum" : 0,
                "maximum" : 100
            },
            "minClientThroughputMbps" : {
                "description" : "Minimum client throughput in Mbps.",
                "type" : "number",
                "default" : 0,
                "minimum" : 0,
                "maximum" : 100
            }
        },
        "description" : "AP client admission control 2.4GHz radio configuration of the zone."
    }
    
    
  • Response  204

Disable Client Admission Control 2.4G 

/v4_0/rkszones/{id}/clientAdmissionControl24

Use this API command to disable client admission control 2.4GHz radio configuration for APs that belong to a zone.

  • Response  204

Modify Client Admission Control 5G 

/v4_0/rkszones/{id}/clientAdmissionControl50

Use this API command to modify the client admission control 5GHz radio configuration for APs that belong to a zone.

  • Request
  • Body
    {
        "maxRadioLoadPercent" : 75,
        "minClientCount" : "10",
        "minClientThroughputMbps" : 0
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "maxRadioLoadPercent" : {
                "description" : "Maximum radio load percentage.",
                "type" : "integer",
                "default" : 75,
                "minimum" : 50,
                "maximum" : 100
            },
            "minClientCount" : {
                "description" : "Minimum client count number.",
                "type" : "integer",
                "default" : 10,
                "minimum" : 0,
                "maximum" : 100
            },
            "minClientThroughputMbps" : {
                "description" : "Minimum client throughput in Mbps.",
                "type" : "number",
                "default" : 0,
                "minimum" : 0,
                "maximum" : 100
            }
        },
        "description" : "AP client admission control 5GHz radio configuration of the zone."
    }
    
    
  • Response  204

Disable Client Admission Control 5G 

/v4_0/rkszones/{id}/clientAdmissionControl50

Use this API command to disable client admission control 5GHz radio configuration for APs that belong to a zone.

  • Response  204

Modify Background Scanning 2.4G 

/v4_0/rkszones/{id}/backgroundScanning24

Use this API command to modify the background scanning 2.4GHz radio configuration for APs that belong to a zone.

  • Request
  • Body
    {
        "frequencyInSec" : 20
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "frequencyInSec" : {
                "description" : "Frequency in second",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 65535
            }
        },
        "description" : "Background scanning on 2.4GHz radio configuration of the zone."
    }
    
    
  • Response  204

Disable Background Scanning 2.4G 

/v4_0/rkszones/{id}/backgroundScanning24

Use this API command to disable background scanning 2.4GHz radio configuration for APs that belong to a zone.

  • Response  204

Modify Background Scanning 5G 

/v4_0/rkszones/{id}/backgroundScanning50

Use this API command to modify the background scanning 5GHz radio configuration for APs that belong to a zone.

  • Request
  • Body
    {
        "frequencyInSec" : 20
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "frequencyInSec" : {
                "description" : "Frequency in second",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 65535
            }
        },
        "description" : "Background scanning on 5GHz radio configuration of the zone."
    }
    
    
  • Response  204

Disable Background Scanning 5G 

/v4_0/rkszones/{id}/backgroundScanning50

Use this API command to disable background scanning 5GHz radio configuration for APs that belong to a zone.

  • Response  204

Modify Client Load Balancing 2.4G 

/v4_0/rkszones/{id}/clientLoadBalancing24

Use this API command to modify the client load balancing 2.4GHz radio configuration for APs that belong to a zone.

  • Request
  • Body
    {
        "adjacentRadioThreshold" : 12
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "adjacentRadioThreshold" : {
                "description" : "Adjacent radio threshold",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 100
            }
        },
        "description" : "Client load balancing on 2.4GHz radio configuration of the zone."
    }
    
    
  • Response  204

Disable Client Load Balancing 2.4G 

/v4_0/rkszones/{id}/clientLoadBalancing24

Use this API command to disable client load balancing 2.4GHz radio configuration for APs that belong to a zone.

  • Response  204

Modify Client Load Balancing 5G 

/v4_0/rkszones/{id}/clientLoadBalancing50

Use this API command to modify the client load balancing 5GHz radio configuration for APs that belong to a zone.

  • Request
  • Body
    {
        "adjacentRadioThreshold" : 12
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "adjacentRadioThreshold" : {
                "description" : "Adjacent radio threshold",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 100
            }
        },
        "description" : "Client load balancing on 5GHz radio configuration of the zone."
    }
    
    
  • Response  204

Disable Client Load Balancing 5G 

/v4_0/rkszones/{id}/clientLoadBalancing50

Use this API command to disable client load balancing 5GHz radio configuration for APs that belong to a zone.

  • Response  204

Modify Band Balancing 

/v4_0/rkszones/{id}/bandBalancing

Use this API command to modify band balancing for APs that belong to a zone.

  • Request
  • Body
    {
        "wifi24Percentage" : 10
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "wifi24Percentage" : {
                "description" : "Percentage of client load on 2.4GHz radio band",
                "type" : "integer",
                "minimum" : 0,
                "maximum" : 100
            }
        },
        "description" : "Band balancing configuration of the zone."
    }
    
    
  • Response  204

Disable Band Balancing 

/v4_0/rkszones/{id}/bandBalancing

Use this API command to disable band balancing for APs that belong to a zone.

  • Response  204

Modify AP Reboot Timeout 

/v4_0/rkszones/{id}/apRebootTimeout

Use this API command to modify AP reboot timeout for APs that belong to a zone.

  • Request
  • Body
    {
        "gatewayLossTimeoutInSec" : 1800,
        "serverLossTimeoutInSec" : 7200
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "gatewayLossTimeoutInSec" : {
                "description" : "Gateway loss timeout in second",
                "enum" : [ 0, 1800, 3600, 5400, 7200, 9000, 10800, 12600, 14400, 16200, 18000, 19800, 23400, 25200, 27000, 28800, 30600, 32400, 34200, 36000, 37800, 39600, 41400, 43200, 45000, 46800, 48600, 50400, 52200, 54000, 55800, 57600, 59400, 61200, 63000, 64800, 66600, 68400, 70200, 72000, 73800, 75600, 77400, 79200, 81000, 82800, 84600, 86400 ]
            },
            "serverLossTimeoutInSec" : {
                "description" : "Server loss timeout in second",
                "enum" : [ 0, 7200, 14400, 21600, 28800, 36000, 43200, 50400, 57600, 64800, 72000, 79200, 86400 ]
            }
        },
        "description" : "AP reboot timeout of the zone."
    }
    
    
  • Response  204

Modify Node Affinity Profile 

/v4_0/rkszones/{id}/nodeAffinityProfile

Use this API command to modify node affinity profile for APs that belong to a zone.

  • Request
  • Body
    {
        "id" : "nodeAffinityProfileId",
        "name" : "nodeAffinityProfileName"
    }
    
    
    Schema
    {
        "type" : [ "object", "null" ],
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            },
            "name" : {
                "type" : "string"
            }
        },
        "description" : "Node affinity profile of the zone."
    }
    
    
  • Response  204

Modify Hotspot2.0 Venue Profile 

/v4_0/rkszones/{id}/venueProfile

Use this API command to modify Hotspot 2.0 venue profile for APs that belong to a zone.

  • Request
  • Body
    {
        "id" : "venueProfileId",
        "name" : "venueProfileName"
    }
    
    
    Schema
    {
        "type" : [ "object", "null" ],
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            },
            "name" : {
                "type" : "string"
            }
        },
        "description" : "Venue profile configuration of the zone."
    }
    
    
  • Response  204

Clear Hotspot2.0 Venue Profile 

/v4_0/rkszones/{id}/venueProfile

Use this API command to clear Hotspot 2.0 venue profile for APs that belong to a zone.

  • Response  204

Modify Rogue 

/v4_0/rkszones/{id}/rogue

Use this API command to modify the rogue AP detection for APs that belong to a zone.

  • Request
  • Body
    {
        "reportType" : "All",
        "maliciousTypes" : null,
        "protectionEnabled" : true
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "reportType" : {
                "description" : "Report type",
                "enum" : [ "All", "Malicious" ]
            },
            "maliciousTypes" : {
                "description" : "Malicious type when reportType is Malicious",
                "type" : [ "array", "null" ],
                "items" : {
                    "enum" : [ "SSIDSpoofing", "SameNetwork", "MACSpoofing" ]
                }
            },
            "protectionEnabled" : {
                "description" : "Protection enabled",
                "type" : "boolean"
            }
        },
        "description" : "Rogue AP detection configuration of the zone."
    }
    
    
  • Response  204

Disable Rogue 

/v4_0/rkszones/{id}/rogue

Use this API command to disable rogue AP detection for APs that belong to a zone.

  • Response  204

Modify Location Based Service 

/v4_0/rkszones/{id}/locationBasedService

Use this API command to modify location based service for APs that belong to a zone.

  • Request
  • Body
    {
        "id" : "lbsId",
        "name" : "lbsName"
    }
    
    
    Schema
    {
        "type" : [ "object", "null" ],
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            },
            "name" : {
                "type" : "string"
            }
        },
        "description" : "Location based service configuration of the zone."
    }
    
    
  • Response  204

Disable Location Based Service 

/v4_0/rkszones/{id}/locationBasedService

Use this API command to disable location based service for APs that belong to a zone.

  • Response  204

Retrieve AP Model 

/v4_0/rkszones/{zoneId}/apmodel/{model}

Use this API command to retrieve AP model specific configuration that belong to a zone.

  • Response  200
  • Body
    {
        "ledStatusEnabled" : true,
        "lldp" : {
            "enabled" : true,
            "advertiseIntervalInSec" : 30,
            "holdTimeInSec" : 120,
            "managementIPTLVEnabled" : false
        },
        "ledMode" : null,
        "internalHeaterEnabled" : null,
        "poeOutPortEnabled" : null,
        "usbPowerEnable" : true,
        "poeModeSetting" : "Auto",
        "poeTxChain" : 2,
        "radioBand" : null,
        "externalAntenna24" : null,
        "externalAntenna50" : null,
        "lanPorts" : [ {
            "portName" : "LAN1",
            "enabled" : false,
            "ethPortProfile" : null
        }, {
            "portName" : "LAN2",
            "enabled" : true,
            "ethPortProfile" : {
                "id" : "0",
                "name" : "Default Trunk Port"
            }
        }, {
            "portName" : "LAN3",
            "enabled" : true,
            "ethPortProfile" : {
                "id" : "1",
                "name" : "Default Access Port"
            }
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "ledStatusEnabled" : {
                "type" : [ "boolean", "null" ]
            },
            "lldp" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "enabled" : {
                        "type" : "boolean"
                    },
                    "advertiseIntervalInSec" : {
                        "type" : [ "integer", "null" ],
                        "minimum" : 1,
                        "maximum" : 300
                    },
                    "holdTimeInSec" : {
                        "type" : [ "integer", "null" ],
                        "minimum" : 60,
                        "maximum" : 1200
                    },
                    "managementIPTLVEnabled" : {
                        "type" : [ "boolean", "null" ]
                    }
                },
                "required" : [ "enabled" ]
            },
            "ledMode" : {
                "enum" : [ null, "CableModem", "AccessPoint", "CableModem_AccessPoint", "CableModem_AccessPoint_DEFAULT", "ActiveSurgeProtector", "ActiveSurgeProtector_ModemOnline_DEFAULT", "Off" ]
            },
            "internalHeaterEnabled" : {
                "type" : [ "boolean", "null" ]
            },
            "poeOutPortEnabled" : {
                "type" : [ "boolean", "null" ]
            },
            "usbPowerEnable" : {
                "type" : [ "boolean", "null" ]
            },
            "poeModeSetting" : {
                "enum" : [ null, "Auto", "_802_3af", "_802_3at" ]
            },
            "poeTxChain" : {
                "type" : [ "integer", "null" ]
            },
            "radioBand" : {
                "enum" : [ null, "2.4GHz", "5GHz" ]
            },
            "externalAntenna24" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "enabled" : {
                        "type" : "boolean"
                    },
                    "dbi" : {
                        "type" : [ "integer", "null" ],
                        "minimum" : 0,
                        "maximum" : 90
                    },
                    "chainMask" : {
                        "enum" : [ null, "Two", "Three" ]
                    }
                },
                "required" : [ "enabled" ]
            },
            "externalAntenna50" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "enabled" : {
                        "type" : "boolean"
                    },
                    "dbi" : {
                        "type" : [ "integer", "null" ],
                        "minimum" : 0,
                        "maximum" : 90
                    },
                    "chainMask" : {
                        "enum" : [ null, "Two", "Three" ]
                    }
                },
                "required" : [ "enabled" ]
            },
            "lanPorts" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "portName" : {
                            "enum" : [ "LAN1", "LAN2", "LAN3", "LAN4", "LAN5" ]
                        },
                        "enabled" : {
                            "type" : "boolean"
                        },
                        "ethPortProfile" : {
                            "type" : [ "object", "null" ],
                            "additionalProperties" : false,
                            "properties" : {
                                "id" : {
                                    "type" : "string"
                                },
                                "name" : {
                                    "type" : "string"
                                }
                            }
                        }
                    },
                    "required" : [ "portName", "enabled" ]
                }
            }
        }
    }
    
    

Modify AP Model 

/v4_0/rkszones/{zoneId}/apmodel/{model}

Use this API command to modify the AP model specific configuration that belong to a zone.

  • Request
  • Body
    {
        "ledStatusEnabled" : true,
        "lldp" : {
            "enabled" : true,
            "advertiseIntervalInSec" : 30,
            "holdTimeInSec" : 120,
            "managementIPTLVEnabled" : false
        },
        "ledMode" : null,
        "internalHeaterEnabled" : null,
        "poeOutPortEnabled" : null,
        "usbPowerEnable" : true,
        "poeModeSetting" : "Auto",
        "poeTxChain" : 2,
        "radioBand" : null,
        "externalAntenna24" : null,
        "externalAntenna50" : null,
        "lanPorts" : [ {
            "portName" : "LAN1",
            "enabled" : false,
            "ethPortProfile" : null
        }, {
            "portName" : "LAN2",
            "enabled" : true,
            "ethPortProfile" : {
                "id" : "0",
                "name" : "Default Trunk Port"
            }
        }, {
            "portName" : "LAN3",
            "enabled" : true,
            "ethPortProfile" : {
                "id" : "1",
                "name" : "Default Access Port"
            }
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "ledStatusEnabled" : {
                "type" : [ "boolean", "null" ]
            },
            "lldp" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "enabled" : {
                        "type" : "boolean"
                    },
                    "advertiseIntervalInSec" : {
                        "type" : [ "integer", "null" ],
                        "minimum" : 1,
                        "maximum" : 300
                    },
                    "holdTimeInSec" : {
                        "type" : [ "integer", "null" ],
                        "minimum" : 60,
                        "maximum" : 1200
                    },
                    "managementIPTLVEnabled" : {
                        "type" : [ "boolean", "null" ]
                    }
                },
                "required" : [ "enabled" ]
            },
            "ledMode" : {
                "enum" : [ null, "CableModem", "AccessPoint", "CableModem_AccessPoint", "CableModem_AccessPoint_DEFAULT", "ActiveSurgeProtector", "ActiveSurgeProtector_ModemOnline_DEFAULT", "Off" ]
            },
            "internalHeaterEnabled" : {
                "type" : [ "boolean", "null" ]
            },
            "poeOutPortEnabled" : {
                "type" : [ "boolean", "null" ]
            },
            "usbPowerEnable" : {
                "type" : [ "boolean", "null" ]
            },
            "poeModeSetting" : {
                "enum" : [ null, "Auto", "_802_3af", "_802_3at" ]
            },
            "poeTxChain" : {
                "type" : [ "integer", "null" ]
            },
            "radioBand" : {
                "enum" : [ null, "2.4GHz", "5GHz" ]
            },
            "externalAntenna24" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "enabled" : {
                        "type" : "boolean"
                    },
                    "dbi" : {
                        "type" : [ "integer", "null" ],
                        "minimum" : 0,
                        "maximum" : 90
                    },
                    "chainMask" : {
                        "enum" : [ null, "Two", "Three" ]
                    }
                },
                "required" : [ "enabled" ]
            },
            "externalAntenna50" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "enabled" : {
                        "type" : "boolean"
                    },
                    "dbi" : {
                        "type" : [ "integer", "null" ],
                        "minimum" : 0,
                        "maximum" : 90
                    },
                    "chainMask" : {
                        "enum" : [ null, "Two", "Three" ]
                    }
                },
                "required" : [ "enabled" ]
            },
            "lanPorts" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "portName" : {
                            "enum" : [ "LAN1", "LAN2", "LAN3", "LAN4", "LAN5" ]
                        },
                        "enabled" : {
                            "type" : "boolean"
                        },
                        "ethPortProfile" : {
                            "type" : [ "object", "null" ],
                            "additionalProperties" : false,
                            "properties" : {
                                "id" : {
                                    "type" : "string"
                                },
                                "name" : {
                                    "type" : "string"
                                }
                            }
                        }
                    },
                    "required" : [ "portName", "enabled" ]
                }
            }
        }
    }
    
    
  • Response  204

Modify Radio 2.4G Auto ChannelSelectMode 

/v4_0/rkszones/{id}/autoChannelSelection24

Modify Radio 2.4G Auto ChannelSelectMode and ChannelFly MTBC of a zone

  • Request
  • Body
    {
        "channelSelectMode" : "ChannelFly",
        "channelFlyMtbc" : 480
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "channelSelectMode" : {
                "description" : "Channel Select Mode",
                "enum" : [ "None", "BackgroundScanning", "ChannelFly" ]
            },
            "channelFlyMtbc" : {
                "description" : "ChannelFly MTBC",
                "type" : "integer",
                "default" : 480,
                "minimum" : 100,
                "maximum" : 1440
            }
        },
        "description" : "client load balancing on Radio 2.4G, auto channel selection mode"
    }
    
    
  • Response  204

Modify Radio 5G Auto ChannelSelectMode 

/v4_0/rkszones/{id}/autoChannelSelection50

Modify Radio 5G Auto ChannelSelectMode and ChannelFly MTBC of a zone

  • Request
  • Body
    {
        "channelSelectMode" : "BackgroundScanning",
        "channelFlyMtbc" : 480
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "channelSelectMode" : {
                "description" : "Channel Select Mode",
                "enum" : [ "None", "BackgroundScanning", "ChannelFly" ]
            },
            "channelFlyMtbc" : {
                "description" : "ChannelFly MTBC",
                "type" : "integer",
                "default" : 480,
                "minimum" : 100,
                "maximum" : 1440
            }
        },
        "description" : "client load balancing on Radio 5G, auto channel selection mode"
    }
    
    
  • Response  204

Modify IPsec Profile 

/v4_0/rkszones/{id}/ipsecProfile

Modify IPsec Profile of a zone

  • Request
  • Body
    {
        "id" : "ipsecProfileId",
        "name" : "ipsecProfileName"
    }
    
    
    Schema
    {
        "type" : [ "object", "null" ],
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            },
            "name" : {
                "type" : "string"
            }
        },
        "description" : "ipsec profile configuration of the Zone."
    }
    
    
  • Response  204

Modify enterprise tunnel profile 

/v4_0/rkszones/{id}/enterpriseZoneTunnelConfig

Modify Tunnel profile of a zone for Enterprise

  • Request
  • Body
    {
        "tunnelMtuAutoEnabled" : true,
        "tunnelMtuSize" : 1500,
        "ruckusTunnelModel" : "GREUDP",
        "tunnelEncryption" : false,
        "natUDPPort" : 65535
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "tunnelMtuAutoEnabled" : {
                "description" : "Enable mtu auto",
                "type" : "boolean"
            },
            "tunnelMtuSize" : {
                "description" : "Tunnel mtu size, IPV4:850-1500, IPV6:1384-1500.",
                "type" : "integer",
                "default" : 1500
            },
            "ruckusTunnelModel" : {
                "description" : "Ruckus GRE, TunnelModel",
                "enum" : [ "GRE", "GREUDP" ]
            },
            "natUDPPort" : {
                "description" : "Ruckus GRE, Data plane UDP Port.",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 65535,
                "default" : 23233
            },
            "tunnelEncryption" : {
                "description" : "Ruckus GRE ,Enable tunnel encryption",
                "type" : "boolean"
            },
            "primaryGateway" : {
                "description" : "Soft GRE primary gateway",
                "type" : "string"
            },
            "secondaryGateway" : {
                "description" : "Soft GRE, secondary gateway",
                "type" : "string"
            },
            "primaryGatewayV6" : {
                "description" : "Soft GRE, primary gateway for IPV6",
                "type" : "string"
            },
            "secondaryGatewayV6" : {
                "description" : "Soft GRE, secondary gateway for IPV6",
                "type" : "string"
            },
            "tunnelKeepAliveInterval" : {
                "description" : "Soft GRE tunnel keep alive interval, 1-180. Default 10.",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 180,
                "default" : 10
            },
            "tunnelKeepAliveRetryLimit" : {
                "description" : "Soft GRE tunnel keep alive retry limit, 2-10. Default 5.",
                "type" : "integer",
                "minimum" : 2,
                "maximum" : 10,
                "default" : 5
            },
            "forceDisassociateClientEnabled" : {
                "description" : "Enable forceDisassociateClient",
                "type" : "boolean"
            }
        },
        "description" : "Tunnel profile settings for Enterprise."
    }
    
    
  • Response  204

Modify AP Usb Software Package 

/v4_0/rkszones/{id}/usbSoftwarePackage

Modify AP Usb Software Package of a zone

  • Request
  • Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "usbSoftware" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "APUsbSoftwarePackage id or name"
            },
            "applyModel" : {
                "description" : "List of apply models",
                "type" : "array",
                "items" : {
                    "type" : "string"
                }
            }
        },
        "description" : "APUsbSoftwarePackage of the zone"
    }
    
    
  • Response  204

Disable AP Usb Software Package 

/v4_0/rkszones/{id}/usbSoftwarePackage

Disable AP Usb Software Package of a zone

  • Parameters
  • applyModel
    string (optional) 

    Specify ap models. ex : applyModel=ZF7321U&applyModel=ZF7323

  • Response  204

Modify Altitude 

/v4_0/rkszones/{id}/altitude

Use this API command to modify the altitude configuration of zone.

  • Request
  • Body
    {
        "altitudeUnit" : "meters",
        "altitudeValue" : 1
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "altitudeUnit" : {
                "description" : "altitude unit",
                "enum" : [ "meters", "floor" ]
            },
            "altitudeValue" : {
                "description" : "altitude value",
                "type" : "integer"
            }
        },
        "description" : "GPS Altitude"
    }
    
    
  • Response  204

Disable Altitude 

/v4_0/rkszones/{id}/altitude

Use this API command to disable altitude configuration of zone.

  • Response  204

Retrieve AP Firmware List 

/v4_0/rkszones/{zoneId}/apFirmware

Use this API command to retrieve AP Firmware the list that belong to a zone.

  • Response  200
  • Body
    [ {
        "firmwareVersion" : "3.4.0.101.492",
        "unsupportedApModelSummary" : [ {
            "model" : "R300",
            "amount" : 1
        } ],
        "supported" : false
    }, {
        "firmwareVersion" : "3.4.0.101.505",
        "unsupportedApModelSummary" : [ ],
        "supported" : true
    } ]
    
    

Change AP Firmware 

/v4_0/rkszones/{zoneId}/apFirmware

Use this API command to change the AP Firmware that belong to a zone.

  • Request
  • Body
    {
        "firmwareVersion" : "3.4.0.101.25"
    }
    
    
  • Response  204

AP Group 

Retrieve List 

/v4_0/rkszones/{zoneId}/apgroups

Use this API command to retrieve the list of AP groups that belong to a zone.

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

  • Response  200
  • Body
    {
        "totalCount" : 2,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "apGroupUUID",
            "name" : "apGroupName"
        }, {
            "id" : "apGroupUUID2",
            "name" : "apGroupName2"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the AP group",
                            "type" : "string"
                        },
                        "name" : {
                            "description" : "Description of the AP group",
                            "type" : "string"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve 

/v4_0/rkszones/{zoneId}/apgroups/{id}

Use this API command to retrieve information about an AP group.

  • Response  200
  • Body
    {
        "id" : "apGroupUUID",
        "zoneId" : "zoneUUID",
        "name" : "apGroupName",
        "description" : "apGroupDescription",
        "location" : "test-ap1_modify",
        "locationAdditionalInfo" : "add",
        "latitude" : 34,
        "longitude" : 45,
        "wifi24" : {
            "txPower" : "Full",
            "channelWidth" : 20,
            "channel" : 9,
            "channelRange" : [ 1, 2, 3, 4, 9, 10, 11 ],
            "availableChannelRange" : [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11 ]
        },
        "wifi50" : {
            "txPower" : "Full",
            "channelWidth" : 40,
            "indoorChannel" : 0,
            "outdoorChannel" : 157,
            "indoorChannelRange" : [ 36, 40, 44, 48 ],
            "outdoorChannelRange" : [ 149, 153 ],
            "availableIndoorChannelRange" : [ 36, 40, 44, 48, 149, 153, 157, 161 ],
            "availableOutdoorChannelRange" : [ 149, 153, 157, 161 ]
        },
        "wlanGroup24" : {
            "id" : "19b10850-7eaa-11e4-a584-08002716c79f",
            "name" : "default"
        },
        "wlanGroup50" : null,
        "locationBasedService" : null,
        "clientAdmissionControl24" : {
            "maxRadioLoadPercent" : 70,
            "minClientCount" : 30,
            "minClientThroughputMbps" : 10.0,
            "enabled" : true
        },
        "clientAdmissionControl50" : null,
        "venueProfile" : null,
        "members" : [ {
            "apMac" : "00:11:22:33:44:55"
        }, {
            "apMac" : "11:22:33:44:55:66"
        } ],
        "autoChannelSelection24" : {
            "channelSelectMode" : "ChannelFly",
            "channelFlyMtbc" : 480
        },
        "autoChannelSelection50" : {
            "channelSelectMode" : "BackgroundScanning",
            "channelFlyMtbc" : 480
        },
        "channelEvaluationInterval" : 777,
        "apMgmtVlan" : {
            "id" : 1,
            "mode" : "KEEP"
        },
        "altitude" : {
            "altitudeUnit" : "meters",
            "altitudeValue" : 1
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the AP group",
                "type" : "string"
            },
            "zoneId" : {
                "description" : "Identifier of the zone to which the AP group belongs",
                "type" : "string"
            },
            "name" : {
                "description" : "Name of the AP group",
                "type" : "string"
            },
            "description" : {
                "description" : "Description of the AP group",
                "type" : "string"
            },
            "location" : {
                "type" : "string",
                "pattern" : "^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Location of the AP group."
            },
            "locationAdditionalInfo" : {
                "type" : "string",
                "pattern" : "^([!-~]([ -~]){0,253}[!-~]|[!-~]{1,1})$",
                "description" : "Location additional info of the AP group."
            },
            "altitude" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "altitudeUnit" : {
                        "description" : "altitude unit",
                        "enum" : [ "meters", "floor" ]
                    },
                    "altitudeValue" : {
                        "description" : "altitude value",
                        "type" : "integer"
                    }
                },
                "description" : "GPS Altitude"
            },
            "latitude" : {
                "type" : "number",
                "description" : "Latitude coordinate (in decimal format) of the AP group"
            },
            "longitude" : {
                "type" : "number",
                "description" : "Longitude coordinate (in decimal format) of the AP group"
            },
            "wifi24" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "txPower" : {
                        "enum" : [ "Full", "-1dB", "-2dB", "-3dB(1/2)", "-4dB", "-5dB", "-6dB(1/4)", "-7dB", "-8dB", "-9dB(1/8)", "-10dB", "Min" ],
                        "description" : "Transmission power"
                    },
                    "channelWidth" : {
                        "description" : "Channel width. Zero (0) means Auto.",
                        "enum" : [ 0, 20, 40 ]
                    },
                    "channel" : {
                        "description" : "Channel number",
                        "type" : "integer"
                    },
                    "channelRange" : {
                        "description" : "Channel range options",
                        "type" : "array",
                        "items" : {
                            "type" : "integer"
                        }
                    },
                    "availableChannelRange" : {
                        "description" : "Available channel range options",
                        "type" : "array",
                        "items" : {
                            "type" : "integer"
                        }
                    }
                },
                "description" : "AP 2.4GHz radio configuration of the AP group."
            },
            "wifi50" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "txPower" : {
                        "enum" : [ "Full", "-1dB", "-2dB", "-3dB(1/2)", "-4dB", "-5dB", "-6dB(1/4)", "-7dB", "-8dB", "-9dB(1/8)", "-10dB", "Min" ],
                        "description" : "Transmission power"
                    },
                    "channelWidth" : {
                        "description" : "Channel width. Zero (0) means Auto.",
                        "enum" : [ 0, 20, 40, 80 ]
                    },
                    "indoorChannel" : {
                        "description" : "Indoor channel number",
                        "type" : "integer"
                    },
                    "outdoorChannel" : {
                        "description" : "Outdoor channel number",
                        "type" : "integer"
                    },
                    "indoorChannelRange" : {
                        "description" : "Channel range options",
                        "type" : "array",
                        "items" : {
                            "type" : "integer"
                        }
                    },
                    "outdoorChannelRange" : {
                        "description" : "Channel range options",
                        "type" : "array",
                        "items" : {
                            "type" : "integer"
                        }
                    },
                    "availableIndoorChannelRange" : {
                        "description" : "Available channel range options",
                        "type" : "array",
                        "items" : {
                            "type" : "integer"
                        }
                    },
                    "availableOutdoorChannelRange" : {
                        "description" : "Available channel range options",
                        "type" : "array",
                        "items" : {
                            "type" : "integer"
                        }
                    }
                },
                "description" : "AP 5GHz radio configuration of the AP group."
            },
            "wlanGroup24" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "WLAN group of radio 2.4G. This configuraiton will override the WLAN group of radio 2.4G at the zone level."
            },
            "wlanGroup50" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "WLAN group of radio 5G. This configuration will override the WLAN group of radio 5G at the zone level."
            },
            "locationBasedService" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "enabled" : {
                        "type" : "boolean"
                    },
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Location based service configuration of the AP group."
            },
            "clientAdmissionControl24" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "enabled" : {
                        "type" : "boolean"
                    },
                    "maxRadioLoadPercent" : {
                        "description" : "Maximum radio load percentage.",
                        "type" : "integer",
                        "default" : 75,
                        "minimum" : 50,
                        "maximum" : 100
                    },
                    "minClientCount" : {
                        "description" : "Minimum client count number.",
                        "type" : "integer",
                        "default" : 10,
                        "minimum" : 0,
                        "maximum" : 100
                    },
                    "minClientThroughputMbps" : {
                        "description" : "Minimum client throughput in Mbps.",
                        "type" : "number",
                        "default" : 0,
                        "minimum" : 0,
                        "maximum" : 100
                    }
                },
                "description" : "WLAN group of 2.4GHz radio. This configuraiton will override the WLAN group of 2.4GHz radio at the zone level."
            },
            "clientAdmissionControl50" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "enabled" : {
                        "type" : "boolean"
                    },
                    "maxRadioLoadPercent" : {
                        "description" : "Maximum radio load percentage.",
                        "type" : "integer",
                        "default" : 75,
                        "minimum" : 50,
                        "maximum" : 100
                    },
                    "minClientCount" : {
                        "description" : "Minimum client count number.",
                        "type" : "integer",
                        "default" : 10,
                        "minimum" : 0,
                        "maximum" : 100
                    },
                    "minClientThroughputMbps" : {
                        "description" : "Minimum client throughput in Mbps.",
                        "type" : "number",
                        "default" : 0,
                        "minimum" : 0,
                        "maximum" : 100
                    }
                },
                "description" : "WLAN group of 5G radio. This configuration will override the WLAN group of 5G radio at the zone level."
            },
            "venueProfile" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Venue profile configuration of the AP group."
            },
            "members" : {
                "description" : "Members of the AP group",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "apMac" : {
                            "type" : "string",
                            "pattern" : "^([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F])$",
                            "description" : "MAC address of member AP"
                        }
                    }
                }
            },
            "autoChannelSelection24" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "channelSelectMode" : {
                        "description" : "Channel Select Mode",
                        "enum" : [ "None", "BackgroundScanning", "ChannelFly" ]
                    },
                    "channelFlyMtbc" : {
                        "description" : "ChannelFly MTBC",
                        "type" : "integer",
                        "default" : 480,
                        "minimum" : 100,
                        "maximum" : 1440
                    }
                },
                "description" : "client load balancing on Radio 2.4G, auto channel selection mode"
            },
            "autoChannelSelection50" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "channelSelectMode" : {
                        "description" : "Channel Select Mode",
                        "enum" : [ "None", "BackgroundScanning", "ChannelFly" ]
                    },
                    "channelFlyMtbc" : {
                        "description" : "ChannelFly MTBC",
                        "type" : "integer",
                        "default" : 480,
                        "minimum" : 100,
                        "maximum" : 1440
                    }
                },
                "description" : "client load balancing on Radio 5G, auto channel selection mode"
            },
            "channelEvaluationInterval" : {
                "description" : "channel evaluation Interval of the ap group",
                "type" : "integer",
                "default" : 600,
                "minimum" : 60,
                "maximum" : 3600
            },
            "apMgmtVlan" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "mode" : {
                        "description" : "Vlan Mode of the zone",
                        "enum" : [ "KEEP", "USER_DEFINED" ]
                    },
                    "id" : {
                        "description" : "Vlan id of the zone",
                        "type" : "integer"
                    }
                },
                "description" : "ap Management Vlan of the apgroup"
            }
        },
        "required" : [ "name" ]
    }
    
    

Create 

/v4_0/rkszones/{zoneId}/apgroups

Use this API command to create new AP group within a zone.

  • Request
  • Body
    {
        "name" : "apGroupName",
        "description" : "apGroupDescription"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the AP group"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the AP group"
            }
        },
        "required" : [ "name" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "apGroupUUID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the AP group",
                "type" : "string"
            }
        }
    }
    
    

Modify Basic 

/v4_0/rkszones/{zoneId}/apgroups/{id}

Use this API command to modify the basic information of an AP group.

  • Request
  • Body
    {
        "name" : "apGroupNameModified",
        "description" : "apGroupDescriptionModified",
        "location" : "test-ap1_modify",
        "locationAdditionalInfo" : "add",
        "latitude" : 34,
        "longitude" : 45,
        "channelEvaluationInterval" : 777
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Name of the AP group"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Description of the AP group"
        },
        "location" : {
            "type" : "string",
            "pattern" : "^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Location of the AP group."
        },
        "locationAdditionalInfo" : {
            "type" : "string",
            "pattern" : "^([!-~]([ -~]){0,253}[!-~]|[!-~]{1,1})$",
            "description" : "Location additional info of the AP group."
        },
        "latitude" : {
            "type" : "number",
            "description" : "Latitude coordinate (in decimal format) of the AP group"
        },
        "longitude" : {
            "type" : "number",
            "description" : "Longitude coordinate (in decimal format) of the AP group"
        },
        "channelEvaluationInterval" : {
            "description" : "channel evaluation Interval of the ap group",
            "type" : "integer",
            "default" : 600,
            "minimum" : 60,
            "maximum" : 3600
        }
    }
    
    
  • Response  204

Disable Location Override 

/v4_0/rkszones/{zoneId}/apgroups/{id}/location

Use this API command to disable location override for APs that belong to an AP group.

  • Response  204

Disable Location AdditionalInfo Override 

/v4_0/rkszones/{zoneId}/apgroups/{id}/locationAdditionalInfo

Use this API command to disable location additionalInfo override zone for APs that belong to an AP group.

  • Response  204

Modify Radio 2.4G Override 

/v4_0/rkszones/{zoneId}/apgroups/{id}/wifi24

Use this API command to modify the 2.4GHz radio configuration override zone for APs that belong to an AP group.

  • Request
  • Body
    {
        "txPower" : "Full",
        "channelWidth" : 20,
        "channel" : 10,
        "channelRange" : [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11 ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "txPower" : {
                "enum" : [ "Full", "-1dB", "-2dB", "-3dB(1/2)", "-4dB", "-5dB", "-6dB(1/4)", "-7dB", "-8dB", "-9dB(1/8)", "-10dB", "Min" ],
                "description" : "Transmission power"
            },
            "channelWidth" : {
                "description" : "Channel width. Zero (0) means Auto.",
                "enum" : [ 0, 20, 40 ]
            },
            "channel" : {
                "description" : "Channel number",
                "type" : "integer"
            },
            "channelRange" : {
                "description" : "Channel range options",
                "type" : "array",
                "items" : {
                    "type" : "integer"
                }
            },
            "availableChannelRange" : {
                "description" : "Available channel range options",
                "type" : "array",
                "items" : {
                    "type" : "integer"
                }
            }
        },
        "description" : "AP 2.4GHz radio configuration of the AP group."
    }
    
    
  • Response  204

Disable Radio 2.4G Override 

/v4_0/rkszones/{zoneId}/apgroups/{id}/wifi24

Use this API command to disable 2.4GHz radio configuration override zone for APs that belong to an AP group.

  • Response  204

Modify Radio 5G Override 

/v4_0/rkszones/{zoneId}/apgroups/{id}/wifi50

Use this API command to modify the 5GHz radio configuration override zone for APs that belong to an AP group.

  • Request
  • Body
    {
        "txPower" : "Full",
        "channelWidth" : 20,
        "indoorChannel" : 36,
        "outdoorChannel" : 149,
        "indoorChannelRange" : [ 36, 40, 44, 48, 149, 153, 157, 161 ],
        "outdoorChannelRange" : [ 149, 153, 157, 161 ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "txPower" : {
                "enum" : [ "Full", "-1dB", "-2dB", "-3dB(1/2)", "-4dB", "-5dB", "-6dB(1/4)", "-7dB", "-8dB", "-9dB(1/8)", "-10dB", "Min" ],
                "description" : "Transmission power"
            },
            "channelWidth" : {
                "description" : "Channel width. Zero (0) means Auto.",
                "enum" : [ 0, 20, 40, 80 ]
            },
            "indoorChannel" : {
                "description" : "Indoor channel number",
                "type" : "integer"
            },
            "outdoorChannel" : {
                "description" : "Outdoor channel number",
                "type" : "integer"
            },
            "indoorChannelRange" : {
                "description" : "Channel range options",
                "type" : "array",
                "items" : {
                    "type" : "integer"
                }
            },
            "outdoorChannelRange" : {
                "description" : "Channel range options",
                "type" : "array",
                "items" : {
                    "type" : "integer"
                }
            },
            "availableIndoorChannelRange" : {
                "description" : "Available channel range options",
                "type" : "array",
                "items" : {
                    "type" : "integer"
                }
            },
            "availableOutdoorChannelRange" : {
                "description" : "Available channel range options",
                "type" : "array",
                "items" : {
                    "type" : "integer"
                }
            }
        },
        "description" : "AP 5GHz radio configuration of the AP group."
    }
    
    
  • Response  204

Disable Radio 5G Override 

/v4_0/rkszones/{zoneId}/apgroups/{id}/wifi50

Use this API command to disable 5GHz radio configuration override zone for APs that belong to an AP group.

  • Response  204

Modify WLAN group 2.4G Override 

/v4_0/rkszones/{zoneId}/apgroups/{id}/wlanGroup24

Use this API command to modify the WLAN group on 2.4GHz radio override zone for APs that belong to an AP group.

  • Request
  • Body
    {
        "id" : "19b10850-7eaa-11e4-a584-08002716c79f",
        "name" : "default"
    }
    
    
    Schema
    {
        "type" : [ "object", "null" ],
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            },
            "name" : {
                "type" : "string"
            }
        },
        "description" : "WLAN group of 2.4GHz radio. This configuraiton will override the WLAN group of 2.4GHz radio at the zone level."
    }
    
    
  • Response  204

Disable WLAN group 2.4G Override 

/v4_0/rkszones/{zoneId}/apgroups/{id}/wlanGroup24

Use this API command to disable WLAN group on 2.4GHz radio override zone for APs that belong to an AP group.

  • Response  204

Modify WLAN group 5G Override 

/v4_0/rkszones/{zoneId}/apgroups/{id}/wlanGroup50

Use this API command to modify the WLAN group on 5GHz radio override zone for APs that belong to an AP group.

  • Request
  • Body
    {
        "id" : "19b10850-7eaa-11e4-a584-08002716c79f",
        "name" : "default"
    }
    
    
    Schema
    {
        "type" : [ "object", "null" ],
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            },
            "name" : {
                "type" : "string"
            }
        },
        "description" : "WLAN group of 5G radio. This configuration will override the WLAN group of 5G radio at the zone level."
    }
    
    
  • Response  204

Disable WLAN group 5G Override 

/v4_0/rkszones/{zoneId}/apgroups/{id}/wlanGroup50

Use this API command to disable WLAN group on 5GHz radio override zone for APs that belong to an AP group.

  • Response  204

Modify Location Based Service Override 

/v4_0/rkszones/{zoneId}/apgroups/{id}/locationBasedService

Use this API command to modify location based service override zone for APs that belong to an AP group.

  • Request
  • Body
    {
        "id" : "lbsServiceId",
        "name" : "lbsServiceName"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "enabled" : {
                "type" : "boolean"
            },
            "id" : {
                "type" : "string"
            },
            "name" : {
                "type" : "string"
            }
        },
        "description" : "Location based service configuration of the AP group."
    }
    
    
  • Response  204

Disable Location Based Service Override 

/v4_0/rkszones/{zoneId}/apgroups/{id}/locationBasedService

Use this API command to disable location based service override zone for APs that belong to an AP group.

  • Response  204

Modify Client Admission Control 2.4G Override 

/v4_0/rkszones/{zoneId}/apgroups/{id}/clientAdmissionControl24

Use this API command to modify client admission control 2.4GHz radio configuration override zone for APs that belong to an AP group.

  • Request
  • Body
    {
        "maxRadioLoadPercent" : 70,
        "minClientCount" : 30,
        "minClientThroughputMbps" : 10.0,
        "enabled" : true
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "enabled" : {
                "type" : "boolean"
            },
            "maxRadioLoadPercent" : {
                "description" : "Maximum radio load percentage.",
                "type" : "integer",
                "default" : 75,
                "minimum" : 50,
                "maximum" : 100
            },
            "minClientCount" : {
                "description" : "Minimum client count number.",
                "type" : "integer",
                "default" : 10,
                "minimum" : 0,
                "maximum" : 100
            },
            "minClientThroughputMbps" : {
                "description" : "Minimum client throughput in Mbps.",
                "type" : "number",
                "default" : 0,
                "minimum" : 0,
                "maximum" : 100
            }
        },
        "description" : "AP client admission control of 2.4GHz radio configuration of the AP group."
    }
    
    
  • Response  204

Disable Client Admission Control 2.4G Override 

/v4_0/rkszones/{zoneId}/apgroups/{id}/clientAdmissionControl24

Use this API command to disable client admission control 2.4GHz radio configuration override zone for APs that belong to an AP group.

  • Response  204

Modify Client Admission Control 5G Override 

/v4_0/rkszones/{zoneId}/apgroups/{id}/clientAdmissionControl50

Use this API command to modify client admission control 5GHz radio configuration override zone for APs that belong to an AP group.

  • Request
  • Body
    {
        "maxRadioLoadPercent" : 70,
        "minClientCount" : 30,
        "minClientThroughputMbps" : 10.0,
        "enabled" : true
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "enabled" : {
                "type" : "boolean"
            },
            "maxRadioLoadPercent" : {
                "description" : "Maximum radio load percentage.",
                "type" : "integer",
                "default" : 75,
                "minimum" : 50,
                "maximum" : 100
            },
            "minClientCount" : {
                "description" : "Minimum client count number.",
                "type" : "integer",
                "default" : 10,
                "minimum" : 0,
                "maximum" : 100
            },
            "minClientThroughputMbps" : {
                "description" : "Minimum client throughput in Mbps.",
                "type" : "number",
                "default" : 0,
                "minimum" : 0,
                "maximum" : 100
            }
        },
        "description" : "AP client admission control of 5GHz radio configuration of the AP group."
    }
    
    
  • Response  204

Disable Client Admission Control 5G Override 

/v4_0/rkszones/{zoneId}/apgroups/{id}/clientAdmissionControl50

Use this API command to disable client admission control 5GHz radio configuration override zone for APs that belong to an AP group.

  • Response  204

Modify Hotspot2.0 Venue Profile 

/v4_0/rkszones/{zoneId}/apgroups/{id}/venueProfile

Use this API command to modify Hotspot 2.0 venue profile for APs that belong to an AP group.

  • Request
  • Body
    {
        "id" : "venueProfileId",
        "name" : "venueProfileName"
    }
    
    
    Schema
    {
        "type" : [ "object", "null" ],
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            },
            "name" : {
                "type" : "string"
            }
        },
        "description" : "Venue profile configuration of the AP group."
    }
    
    
  • Response  204

Clear Hotspot2.0 Venue Profile 

/v4_0/rkszones/{zoneId}/apgroups/{id}/venueProfile

Use this API command to clear Hotspot 2.0 venue profile for APs that belong to an AP group.

  • Response  204

Add Member 

/v4_0/rkszones/{zoneId}/apgroups/{id}/members/{apMac}

Use this API command to add a member AP to an AP group.

  • Response  201

Add Member List 

/v4_0/rkszones/{zoneId}/apgroups/{id}/members

Add multiple members to an AP group

  • Request
  • Body
    {
        "memberList" : [ {
            "apMac" : "00:22:11:0C:BD:13"
        }, {
            "apMac" : "10:11:22:0C:0D:15"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "memberList" : {
                "description" : "List of apMac",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "apMac" : {
                            "type" : "string",
                            "pattern" : "^([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F])$",
                            "description" : "MAC address of member AP"
                        }
                    }
                }
            }
        }
    }
    
    
  • Response  201

Remove Member 

/v4_0/rkszones/{zoneId}/apgroups/{id}/members/{apMac}

Use this API command to remove a member AP from an AP group.

  • Response  204

Retrieve AP Model 

/v4_0/rkszones/{zoneId}/apgroups/{id}/apmodel/{model}

Use this API command to retrieve AP model specific configuration override zone that belong to an AP group, empty mean not override zone.

  • Response  200
  • Body
    {
        "ledStatusEnabled" : true,
        "lldp" : {
            "enabled" : true,
            "advertiseIntervalInSec" : 30,
            "holdTimeInSec" : 120,
            "managementIPTLVEnabled" : false
        },
        "ledMode" : null,
        "internalHeaterEnabled" : null,
        "poeOutPortEnabled" : null,
        "usbPowerEnable" : true,
        "poeModeSetting" : "Auto",
        "poeTxChain" : 2,
        "radioBand" : null,
        "externalAntenna24" : null,
        "externalAntenna50" : null,
        "lanPorts" : [ {
            "portName" : "LAN1",
            "enabled" : false,
            "ethPortProfile" : null
        }, {
            "portName" : "LAN2",
            "enabled" : true,
            "ethPortProfile" : {
                "id" : "0",
                "name" : "Default Trunk Port"
            }
        }, {
            "portName" : "LAN3",
            "enabled" : true,
            "ethPortProfile" : {
                "id" : "1",
                "name" : "Default Access Port"
            }
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "ledStatusEnabled" : {
                "type" : [ "boolean", "null" ]
            },
            "lldp" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "enabled" : {
                        "type" : "boolean"
                    },
                    "advertiseIntervalInSec" : {
                        "type" : [ "integer", "null" ],
                        "minimum" : 1,
                        "maximum" : 300
                    },
                    "holdTimeInSec" : {
                        "type" : [ "integer", "null" ],
                        "minimum" : 60,
                        "maximum" : 1200
                    },
                    "managementIPTLVEnabled" : {
                        "type" : [ "boolean", "null" ]
                    }
                },
                "required" : [ "enabled" ]
            },
            "ledMode" : {
                "enum" : [ null, "CableModem", "AccessPoint", "CableModem_AccessPoint", "CableModem_AccessPoint_DEFAULT", "ActiveSurgeProtector", "ActiveSurgeProtector_ModemOnline_DEFAULT", "Off" ]
            },
            "internalHeaterEnabled" : {
                "type" : [ "boolean", "null" ]
            },
            "poeOutPortEnabled" : {
                "type" : [ "boolean", "null" ]
            },
            "usbPowerEnable" : {
                "type" : [ "boolean", "null" ]
            },
            "poeModeSetting" : {
                "enum" : [ null, "Auto", "_802_3af", "_802_3at" ]
            },
            "poeTxChain" : {
                "type" : [ "integer", "null" ]
            },
            "radioBand" : {
                "enum" : [ null, "2.4GHz", "5GHz" ]
            },
            "externalAntenna24" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "enabled" : {
                        "type" : "boolean"
                    },
                    "dbi" : {
                        "type" : [ "integer", "null" ],
                        "minimum" : 0,
                        "maximum" : 90
                    },
                    "chainMask" : {
                        "enum" : [ null, "Two", "Three" ]
                    }
                },
                "required" : [ "enabled" ]
            },
            "externalAntenna50" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "enabled" : {
                        "type" : "boolean"
                    },
                    "dbi" : {
                        "type" : [ "integer", "null" ],
                        "minimum" : 0,
                        "maximum" : 90
                    },
                    "chainMask" : {
                        "enum" : [ null, "Two", "Three" ]
                    }
                },
                "required" : [ "enabled" ]
            },
            "lanPorts" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "portName" : {
                            "enum" : [ "LAN1", "LAN2", "LAN3", "LAN4", "LAN5" ]
                        },
                        "enabled" : {
                            "type" : "boolean"
                        },
                        "ethPortProfile" : {
                            "type" : [ "object", "null" ],
                            "additionalProperties" : false,
                            "properties" : {
                                "id" : {
                                    "type" : "string"
                                },
                                "name" : {
                                    "type" : "string"
                                }
                            }
                        }
                    },
                    "required" : [ "portName", "enabled" ]
                }
            }
        }
    }
    
    

Override AP Model 

/v4_0/rkszones/{zoneId}/apgroups/{id}/apmodel/{model}

Use this API command to modify AP model specific configuration override zone that belong to an AP group.

  • Request
  • Body
    {
        "ledStatusEnabled" : true,
        "lldp" : {
            "enabled" : true,
            "advertiseIntervalInSec" : 30,
            "holdTimeInSec" : 120,
            "managementIPTLVEnabled" : false
        },
        "ledMode" : null,
        "internalHeaterEnabled" : null,
        "poeOutPortEnabled" : null,
        "usbPowerEnable" : true,
        "poeModeSetting" : "Auto",
        "poeTxChain" : 2,
        "radioBand" : null,
        "externalAntenna24" : null,
        "externalAntenna50" : null,
        "lanPorts" : [ {
            "portName" : "LAN1",
            "enabled" : false,
            "ethPortProfile" : null
        }, {
            "portName" : "LAN2",
            "enabled" : true,
            "ethPortProfile" : {
                "id" : "0",
                "name" : "Default Trunk Port"
            }
        }, {
            "portName" : "LAN3",
            "enabled" : true,
            "ethPortProfile" : {
                "id" : "1",
                "name" : "Default Access Port"
            }
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "ledStatusEnabled" : {
                "type" : [ "boolean", "null" ]
            },
            "lldp" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "enabled" : {
                        "type" : "boolean"
                    },
                    "advertiseIntervalInSec" : {
                        "type" : [ "integer", "null" ],
                        "minimum" : 1,
                        "maximum" : 300
                    },
                    "holdTimeInSec" : {
                        "type" : [ "integer", "null" ],
                        "minimum" : 60,
                        "maximum" : 1200
                    },
                    "managementIPTLVEnabled" : {
                        "type" : [ "boolean", "null" ]
                    }
                },
                "required" : [ "enabled" ]
            },
            "ledMode" : {
                "enum" : [ null, "CableModem", "AccessPoint", "CableModem_AccessPoint", "CableModem_AccessPoint_DEFAULT", "ActiveSurgeProtector", "ActiveSurgeProtector_ModemOnline_DEFAULT", "Off" ]
            },
            "internalHeaterEnabled" : {
                "type" : [ "boolean", "null" ]
            },
            "poeOutPortEnabled" : {
                "type" : [ "boolean", "null" ]
            },
            "usbPowerEnable" : {
                "type" : [ "boolean", "null" ]
            },
            "poeModeSetting" : {
                "enum" : [ null, "Auto", "_802_3af", "_802_3at" ]
            },
            "poeTxChain" : {
                "type" : [ "integer", "null" ]
            },
            "radioBand" : {
                "enum" : [ null, "2.4GHz", "5GHz" ]
            },
            "externalAntenna24" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "enabled" : {
                        "type" : "boolean"
                    },
                    "dbi" : {
                        "type" : [ "integer", "null" ],
                        "minimum" : 0,
                        "maximum" : 90
                    },
                    "chainMask" : {
                        "enum" : [ null, "Two", "Three" ]
                    }
                },
                "required" : [ "enabled" ]
            },
            "externalAntenna50" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "enabled" : {
                        "type" : "boolean"
                    },
                    "dbi" : {
                        "type" : [ "integer", "null" ],
                        "minimum" : 0,
                        "maximum" : 90
                    },
                    "chainMask" : {
                        "enum" : [ null, "Two", "Three" ]
                    }
                },
                "required" : [ "enabled" ]
            },
            "lanPorts" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "portName" : {
                            "enum" : [ "LAN1", "LAN2", "LAN3", "LAN4", "LAN5" ]
                        },
                        "enabled" : {
                            "type" : "boolean"
                        },
                        "ethPortProfile" : {
                            "type" : [ "object", "null" ],
                            "additionalProperties" : false,
                            "properties" : {
                                "id" : {
                                    "type" : "string"
                                },
                                "name" : {
                                    "type" : "string"
                                }
                            }
                        }
                    },
                    "required" : [ "portName", "enabled" ]
                }
            }
        }
    }
    
    
  • Response  204

Disable Override AP Model 

/v4_0/rkszones/{zoneId}/apgroups/{id}/apmodel/{model}

Use this API command to disable AP model specific configuration override zone that belong to an AP group.

  • Response  204

Modify Radio 2.4G Auto ChannelSelectMode Override 

/v4_0/rkszones/{zoneId}/apgroups/{id}/autoChannelSelection24

Override Radio 2.4G Auto ChannelSelectMode and ChannelFly MTBC of an AP group

  • Request
  • Body
    {
        "channelSelectMode" : "ChannelFly",
        "channelFlyMtbc" : 480
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "channelSelectMode" : {
                "description" : "Channel Select Mode",
                "enum" : [ "None", "BackgroundScanning", "ChannelFly" ]
            },
            "channelFlyMtbc" : {
                "description" : "ChannelFly MTBC",
                "type" : "integer",
                "default" : 480,
                "minimum" : 100,
                "maximum" : 1440
            }
        },
        "description" : "client load balancing on Radio 2.4G, auto channel selection mode"
    }
    
    
  • Response  204

Modify Radio 5G Auto ChannelSelectMode Override 

/v4_0/rkszones/{zoneId}/apgroups/{id}/autoChannelSelection50

Override Radio 5G Auto ChannelSelectMode and ChannelFly MTBC of an AP group

  • Request
  • Body
    {
        "channelSelectMode" : "BackgroundScanning",
        "channelFlyMtbc" : 480
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "channelSelectMode" : {
                "description" : "Channel Select Mode",
                "enum" : [ "None", "BackgroundScanning", "ChannelFly" ]
            },
            "channelFlyMtbc" : {
                "description" : "ChannelFly MTBC",
                "type" : "integer",
                "default" : 480,
                "minimum" : 100,
                "maximum" : 1440
            }
        },
        "description" : "client load balancing on Radio 5G, auto channel selection mode"
    }
    
    
  • Response  204

Disable Radio 2.4G Auto ChannelSelectMode Override 

/v4_0/rkszones/{zoneId}/apgroups/{id}/autoChannelSelection24

Disable Radio 2.4G Auto ChannelSelectMode and ChannelFly MTBC Override of an AP group

  • Response  204

Disable Radio 5G Auto ChannelSelectMode Override 

/v4_0/rkszones/{zoneId}/apgroups/{id}/autoChannelSelection50

Disable Radio 5G Auto ChannelSelectMode and ChannelFly MTBC Override of an AP group

  • Response  204

Disable Channel Evaluation Interval Override 

/v4_0/rkszones/{zoneId}/apgroups/{id}/channelEvaluationInterval

Disable Channel Evaluation Interval Override of an AP group

  • Response  204

Modify AP Usb Software Package 

/v4_0/rkszones/{zoneId}/apgroups/{id}/usbSoftwarePackage

Modify AP Usb Software Package of an AP group

  • Request
  • Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "usbSoftware" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "APUsbSoftwarePackage id or name"
            },
            "applyModel" : {
                "description" : "List of apply models",
                "type" : "array",
                "items" : {
                    "type" : "string"
                }
            }
        },
        "description" : "APUsbSoftwarePackage of the AP group"
    }
    
    
  • Response  204

Disable AP Usb Software Package 

/v4_0/rkszones/{zoneId}/apgroups/{id}/usbSoftwarePackage

Disable AP Usb Software Package of an AP group

  • Parameters
  • applyModel
    string (optional) 

    Specify ap models. ex : applyModel=ZF7321U&applyModel=ZF7323

  • Response  204

Modify Altitude of ApGroup 

/v4_0/rkszones/{zoneId}/apgroups/{id}/altitude

Use this API command to modify the altitude of AP group.

  • Request
  • Body
    {
        "altitudeUnit" : "meters",
        "altitudeValue" : 1
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "altitudeUnit" : {
                "description" : "altitude unit",
                "enum" : [ "meters", "floor" ]
            },
            "altitudeValue" : {
                "description" : "altitude value",
                "type" : "integer"
            }
        },
        "description" : "GPS Altitude"
    }
    
    
  • Response  204

Disable Altitude of ApGroup 

/v4_0/rkszones/{zoneId}/apgroups/{id}/altitude

Use this API command to clear the altitude of AP group.

  • Response  204

Delete 

/v4_0/rkszones/{zoneId}/apgroups/{id}

Use this API command to delete an AP group.

  • Response  204

Access Point Configuration 

Retrieve List 

/v4_0/aps

Use this API command to retrieve the list of APs that belong to a zone or a domain.

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

    zoneId
    string (optional) 

    filter AP list by zone

    domainId
    string (optional) 

    filter AP list by domain. Default: current logon domain

  • Response  200
  • Body
    {
        "totalCount" : 2,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "mac" : "00:11:22:33:44:55",
            "zoneId" : "zoneUUID",
            "apGroupId" : "apGroupUUID",
            "name" : "apName"
        }, {
            "mac" : "11:22:33:44:55:66",
            "zoneId" : "zoneUUID2",
            "apGroupId" : "apGroupUUID2",
            "name" : "apName2"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "description" : "Total AP count",
                "type" : "integer"
            },
            "hasMore" : {
                "description" : "Indicates whether there are more APs after the list that is currently displayed",
                "type" : "boolean"
            },
            "firstIndex" : {
                "description" : "Index of the first AP returned out of the complete AP list",
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "mac" : {
                            "type" : "string",
                            "pattern" : "^([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F])$",
                            "description" : "MAC address of the AP"
                        },
                        "zoneId" : {
                            "description" : "Identifier of the zone to which the AP belongs",
                            "type" : "string"
                        },
                        "apGroupId" : {
                            "description" : "Identifier of the AP group to which the AP belongs",
                            "type" : "string"
                        },
                        "name" : {
                            "description" : "Name of the AP",
                            "type" : "string"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve 

/v4_0/aps/{apMac}

Use this API command to retrieve the configuration of an AP.

  • Response  200
  • Body
    {
        "zoneId" : "zoneUUID",
        "apGroupId" : "apGroupUUID",
        "serial" : "00000096",
        "model" : "ZF7343",
        "name" : "apName",
        "latitude" : 22.3,
        "longitude" : 114,
        "location" : "location",
        "description" : "apDescription",
        "administrativeState" : "Unlocked",
        "provisionChecklist" : "provisionChecklist",
        "login" : {
            "apLoginName" : "apLoginName",
            "apLoginPassword" : "apLoginPassword"
        },
        "wifi24" : {
            "txPower" : "Full",
            "channelWidth" : 20,
            "channel" : 1,
            "channelRange" : [ 1, 2, 3 ],
            "availableChannelRange" : [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11 ]
        },
        "wifi50" : {
            "txPower" : "Full",
            "channelWidth" : 20,
            "channel" : 52,
            "channelRange" : [ 52, 56, 60 ],
            "availableChannelRange" : [ 36, 40, 44, 48, 52, 56, 60, 64, 100, 104, 108, 112, 116, 132, 136, 149, 153, 157, 161 ]
        },
        "wlanGroup24" : {
            "id" : "wlanGroupUUID",
            "name" : "wlanGroupName"
        },
        "wlanGroup50" : {
            "id" : "wlanGroupUUID",
            "name" : "wlanGroupName"
        },
        "network" : {
            "ipType" : "Static",
            "ip" : "1.1.1.1",
            "netmask" : "255.255.255.0",
            "gateway" : "1.1.1.0",
            "primaryDns" : "8.8.8.8",
            "secondaryDns" : "8.8.8.9"
        },
        "smartMonitor" : {
            "enabled" : true,
            "intervalInSec" : 10,
            "retryThreshold" : 10
        },
        "bonjourGateway" : {
            "id" : "bonjourGatewayUUID",
            "name" : "bonjourGatewayName"
        },
        "specific" : {
            "ledStatusEnabled" : false,
            "lldp" : {
                "enabled" : true,
                "advertiseIntervalInSec" : 100,
                "holdTimeInSec" : 1000,
                "managementIPTLVEnabled" : false
            },
            "ledMode" : null,
            "internalHeaterEnabled" : null,
            "poeOutPortEnabled" : null,
            "usbPowerEnable" : true,
            "poeModeSetting" : "Auto",
            "poeTxChain" : 2,
            "radioBand" : null,
            "externalAntenna24" : null,
            "externalAntenna50" : null,
            "lanPorts" : [ {
                "portName" : "LAN1",
                "enabled" : true,
                "type" : "Trunk",
                "vlanUntagId" : 13,
                "members" : "1-4094",
                "_8021X" : {
                    "type" : "Disable",
                    "authenticator" : null,
                    "supplicant" : null
                }
            }, {
                "portName" : "LAN2",
                "enabled" : true,
                "type" : "Access",
                "vlanUntagId" : 15,
                "members" : "15",
                "_8021X" : {
                    "type" : "MACBasedAuthenticator",
                    "authenticator" : {
                        "authentication" : {
                            "id" : "5f66275c-b1fd-4e25-a4db-b64115740fb9",
                            "name" : "zoneRadius"
                        },
                        "accounting" : {
                            "id" : "b86db5e8-884b-4c90-9315-dcd72acaf743",
                            "name" : "zoneRadiusAcct"
                        },
                        "macAuthByPassEnabled" : true
                    },
                    "supplicant" : null
                }
            }, {
                "portName" : "LAN3",
                "enabled" : true,
                "type" : "Trunk",
                "vlanUntagId" : 1,
                "members" : "1-4094",
                "_8021X" : {
                    "type" : "Supplicant",
                    "authenticator" : null,
                    "supplicant" : {
                        "type" : "Custom",
                        "userName" : "a",
                        "password" : "a"
                    }
                }
            } ]
        },
        "autoChannelSelection24" : {
            "channelSelectMode" : "ChannelFly",
            "channelFlyMtbc" : 480
        },
        "autoChannelSelection50" : {
            "channelSelectMode" : "BackgroundScanning",
            "channelFlyMtbc" : 480
        },
        "channelEvaluationInterval" : 777,
        "apMgmtVlan" : {
            "id" : 1,
            "mode" : "KEEP"
        },
        "altitude" : {
            "altitudeUnit" : "meters",
            "altitudeValue" : 1
        },
        "meshOptions" : {
            "meshMode" : "MESH_AP",
            "uplinkSelection" : "MANUAL",
            "meshUplinkEntryList" : [ "6C:AA:B3:26:6C:30" ]
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "mac" : {
                "type" : "string",
                "pattern" : "^([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F])$",
                "description" : "MAC address of the AP"
            },
            "zoneId" : {
                "description" : "Identifier of the AP group to which the AP belongs",
                "type" : "string"
            },
            "apGroupId" : {
                "type" : "string"
            },
            "serial" : {
                "description" : "Serial number of the AP",
                "type" : "string"
            },
            "model" : {
                "description" : "Model name of the AP",
                "type" : "string"
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 64,
                "pattern" : "^[!-~]((?!\$\()[ -_a-~]){0,62}[!-~]$",
                "description" : "Name of the AP"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the AP"
            },
            "latitude" : {
                "type" : "number",
                "description" : "Latitude coordinate (in decimal format) of the AP"
            },
            "longitude" : {
                "type" : "number",
                "description" : "Longitude coordinate (in decimal format) of the AP"
            },
            "location" : {
                "type" : "string",
                "pattern" : "^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Location of the AP. It is a text description to indicate the location of the AP."
            },
            "locationAdditionalInfo" : {
                "type" : "string",
                "pattern" : "^([!-~]([ -~]){0,253}[!-~]|[!-~]{1,1})$",
                "description" : "Location additional info of the AP. This is a text description that indicates the location additional info of the AP."
            },
            "altitude" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "altitudeUnit" : {
                        "description" : "altitude unit",
                        "enum" : [ "meters", "floor" ]
                    },
                    "altitudeValue" : {
                        "description" : "altitude value",
                        "type" : "integer"
                    }
                },
                "description" : "GPS Altitude"
            },
            "provisionChecklist" : {
                "description" : "Provision checklist of the AP. This field indicates the steps that have been completed in the AP provisioning process.",
                "type" : "string"
            },
            "administrativeState" : {
                "description" : "Administrative state of the AP. A locked AP will not provide any WLAN services.",
                "enum" : [ "Locked", "Unlocked" ],
                "default" : "Unlocked"
            },
            "wlanService24Enabled" : {
                "description" : "WLAN service enabled or disabled on 2.4GHz radio",
                "type" : "boolean"
            },
            "wlanService50Enabled" : {
                "description" : "WLAN service enabled or disabled on 5GHz radio",
                "type" : "boolean"
            },
            "login" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "apLoginName" : {
                        "type" : "string",
                        "maxLength" : 64,
                        "pattern" : "^((?!\$\()[!-_a-~]){1,64}$",
                        "description" : "User name of the AP administrator"
                    },
                    "apLoginPassword" : {
                        "type" : "string",
                        "maxLength" : 64,
                        "pattern" : ".*(?=.{8,})(?=.*[a-zA-Z])(?=.*[0-9])(?=.*[_`~!@#$%^&*\(\)\[\]\{\}|;:'\",.\<>\/?=+-]).*",
                        "description" : "Password of the AP administrator"
                    }
                },
                "required" : [ "apLoginName", "apLoginPassword" ],
                "description" : "Logon credentials for the AP. These logon credentials will override the logon credentials specified at the zone level or AP group level."
            },
            "syslog" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "enabled" : {
                        "description" : "Indicates whether syslog is enabled or disabled",
                        "type" : "boolean"
                    },
                    "address" : {
                        "type" : "string",
                        "description" : "Address of the syslog server. If syslog is enabled, this attribute is required."
                    },
                    "port" : {
                        "description" : "Port number of the syslog server",
                        "type" : "integer",
                        "default" : "514",
                        "minimum" : 1,
                        "maximum" : 65535
                    },
                    "facility" : {
                        "description" : "Facility of the syslog server",
                        "enum" : [ "Keep_Original", "Local0", "Local1", "Local2", "Local3", "Local4", "Local5", "Local6", "Local7" ]
                    },
                    "priority" : {
                        "description" : "Priority of the log messages",
                        "enum" : [ "Emergency", "Alert", "Critical", "Error", "Warning", "Notice", "Info", "All" ]
                    }
                },
                "required" : [ "enabled" ],
                "description" : "Syslog configuration of the AP. This configuration will override the syslog configuration at the zone level or AP group level."
            },
            "wifi24" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "txPower" : {
                        "enum" : [ "Full", "-1dB", "-2dB", "-3dB(1/2)", "-4dB", "-5dB", "-6dB(1/4)", "-7dB", "-8dB", "-9dB(1/8)", "-10dB", "Min" ],
                        "description" : "Transmission power"
                    },
                    "channelWidth" : {
                        "description" : "Channel width. Zero (0) means Auto.",
                        "enum" : [ 0, 20, 40 ]
                    },
                    "channel" : {
                        "description" : "Channel number",
                        "type" : "integer"
                    },
                    "channelRange" : {
                        "description" : "Channel range options",
                        "type" : "array",
                        "items" : {
                            "type" : "integer"
                        }
                    },
                    "availableChannelRange" : {
                        "description" : "Available channel range options",
                        "type" : "array",
                        "items" : {
                            "type" : "integer"
                        }
                    }
                },
                "description" : "2.4GHz radio configuration of the AP. This configuration will override the radio 2.4GHz configuration at the zone level or AP group level."
            },
            "wifi50" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "txPower" : {
                        "enum" : [ "Full", "-1dB", "-2dB", "-3dB(1/2)", "-4dB", "-5dB", "-6dB(1/4)", "-7dB", "-8dB", "-9dB(1/8)", "-10dB", "Min" ],
                        "description" : "transmission power"
                    },
                    "channelWidth" : {
                        "description" : "channel width, 0 mean Auto",
                        "enum" : [ 0, 20, 40, 80 ]
                    },
                    "channel" : {
                        "description" : "channel number",
                        "type" : "integer"
                    },
                    "channelRange" : {
                        "description" : "channel range options",
                        "type" : "array",
                        "items" : {
                            "type" : "integer"
                        }
                    },
                    "availableChannelRange" : {
                        "description" : "available channel range options",
                        "type" : "array",
                        "items" : {
                            "type" : "integer"
                        }
                    }
                },
                "description" : "5GHz radio configuration. This configuration will override the 5GHz radio configuration at the zone level or AP group level."
            },
            "wlanGroup24" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "description" : "Identifier of the WLAN group",
                        "type" : "string"
                    },
                    "name" : {
                        "description" : "Name of the WLAN group",
                        "type" : "string"
                    }
                },
                "description" : "WLAN group of 2.4GHz radio. This configuration will override the WLAN group of the 2.4GHz radio at the zone level or AP group level."
            },
            "wlanGroup50" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "description" : "Identifier of the WLAN group",
                        "type" : "string"
                    },
                    "name" : {
                        "description" : "Name of the WLAN group",
                        "type" : "string"
                    }
                },
                "description" : "WLAN group of 5GHz radio. This configuration will override the WLAN group of the 5GHz radio at the zone level or AP group level."
            },
            "network" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "ipType" : {
                        "description" : "Indicates how the AP's IP address was obtained. An AP's IP address can be statically or dynamically assigned or kept unchanged.",
                        "enum" : [ "Static", "Dynamic", "Keep" ]
                    },
                    "ip" : {
                        "type" : "string",
                        "description" : "IP address of the AP"
                    },
                    "netmask" : {
                        "type" : "string",
                        "pattern" : "^$|(^(128|192|224|24[08]|25[245]).0.0.0$)|(^255.(0|128|192|224|24[08]|25[245]).0.0$)|(^255.255.(0|128|192|224|24[08]|25[245]).0$)|(^255.255.255.(0|128|192|224|24[08]|252|255)$)",
                        "description" : "Netmask of the AP's subnet"
                    },
                    "gateway" : {
                        "type" : "string",
                        "description" : "Gateway of the AP"
                    },
                    "primaryDns" : {
                        "type" : "string",
                        "description" : "Primary DNS server address of the AP"
                    },
                    "secondaryDns" : {
                        "type" : "string",
                        "description" : "Secondary DNS server address of the AP"
                    }
                },
                "description" : "Network settings of the AP."
            },
            "smartMonitor" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "enabled" : {
                        "type" : "boolean"
                    },
                    "intervalInSec" : {
                        "description" : "Interval in seconds. This is required if smartMonitor is enabled",
                        "type" : "integer",
                        "default" : 10,
                        "minimum" : 5,
                        "maximum" : 60
                    },
                    "retryThreshold" : {
                        "description" : "Retry threshold. This is required if smartMonitor is enabled",
                        "type" : "integer",
                        "default" : 3,
                        "minimum" : 1,
                        "maximum" : 10
                    }
                },
                "description" : "Smart monitor of the AP."
            },
            "bonjourGateway" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Bonjour gateway of the AP."
            },
            "clientAdmissionControl24" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "enabled" : {
                        "type" : "boolean"
                    },
                    "maxRadioLoadPercent" : {
                        "description" : "Maximum radio load percentage.",
                        "type" : "integer",
                        "default" : 75,
                        "minimum" : 50,
                        "maximum" : 100
                    },
                    "minClientCount" : {
                        "description" : "Minimum client count number.",
                        "type" : "integer",
                        "default" : 10,
                        "minimum" : 0,
                        "maximum" : 100
                    },
                    "minClientThroughputMbps" : {
                        "description" : "Minimum client throughput in Mbps.",
                        "type" : "number",
                        "default" : 0,
                        "minimum" : 0,
                        "maximum" : 100
                    }
                },
                "description" : "Client admission control configuration of 2.4GHz radio of the AP."
            },
            "clientAdmissionControl50" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "enabled" : {
                        "type" : "boolean"
                    },
                    "maxRadioLoadPercent" : {
                        "description" : "Maximum radio load percentage.",
                        "type" : "integer",
                        "default" : 75,
                        "minimum" : 50,
                        "maximum" : 100
                    },
                    "minClientCount" : {
                        "description" : "Minimum client count number.",
                        "type" : "integer",
                        "default" : 10,
                        "minimum" : 0,
                        "maximum" : 100
                    },
                    "minClientThroughputMbps" : {
                        "description" : "Minimum client throughput in Mbps.",
                        "type" : "number",
                        "default" : 0,
                        "minimum" : 0,
                        "maximum" : 100
                    }
                },
                "description" : "Client admission control configuration of 5GHz radio of the AP."
            },
            "venueProfile" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Venue profile configuration of the AP."
            },
            "specific" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "ledStatusEnabled" : {
                        "type" : [ "boolean", "null" ]
                    },
                    "lldp" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "properties" : {
                            "enabled" : {
                                "type" : "boolean"
                            },
                            "advertiseIntervalInSec" : {
                                "type" : [ "integer", "null" ],
                                "minimum" : 1,
                                "maximum" : 300
                            },
                            "holdTimeInSec" : {
                                "type" : [ "integer", "null" ],
                                "minimum" : 60,
                                "maximum" : 1200
                            },
                            "managementIPTLVEnabled" : {
                                "type" : [ "boolean", "null" ]
                            }
                        },
                        "required" : [ "enabled" ]
                    },
                    "ledMode" : {
                        "enum" : [ null, "CableModem", "AccessPoint", "CableModem_AccessPoint", "CableModem_AccessPoint_DEFAULT", "ActiveSurgeProtector", "ActiveSurgeProtector_ModemOnline_DEFAULT", "Off" ]
                    },
                    "internalHeaterEnabled" : {
                        "type" : [ "boolean", "null" ]
                    },
                    "poeOutPortEnabled" : {
                        "type" : [ "boolean", "null" ]
                    },
                    "usbPowerEnable" : {
                        "type" : [ "boolean", "null" ]
                    },
                    "poeModeSetting" : {
                        "enum" : [ "Auto", "_802_3af", "_802_3at", null ]
                    },
                    "poeTxChain" : {
                        "type" : [ "integer", "null" ]
                    },
                    "radioBand" : {
                        "enum" : [ null, "2.4GHz", "5GHz" ]
                    },
                    "externalAntenna24" : {
                        "type" : [ "object", "null" ],
                        "additionalProperties" : false,
                        "properties" : {
                            "enabled" : {
                                "type" : "boolean"
                            },
                            "dbi" : {
                                "type" : [ "integer", "null" ],
                                "minimum" : 0,
                                "maximum" : 90
                            },
                            "chainMask" : {
                                "enum" : [ null, "Two", "Three" ]
                            }
                        },
                        "required" : [ "enabled" ]
                    },
                    "externalAntenna50" : {
                        "type" : [ "object", "null" ],
                        "additionalProperties" : false,
                        "properties" : {
                            "enabled" : {
                                "type" : "boolean"
                            },
                            "dbi" : {
                                "type" : [ "integer", "null" ],
                                "minimum" : 0,
                                "maximum" : 90
                            },
                            "chainMask" : {
                                "enum" : [ null, "Two", "Three" ]
                            }
                        },
                        "required" : [ "enabled" ]
                    },
                    "lanPorts" : {
                        "type" : "array",
                        "items" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                                "portName" : {
                                    "enum" : [ "LAN1", "LAN2", "LAN3", "LAN4", "LAN5" ]
                                },
                                "enabled" : {
                                    "type" : "boolean"
                                },
                                "overwriteVlanEnabled" : {
                                    "type" : "boolean"
                                },
                                "vlanUntagId" : {
                                    "type" : [ "integer", "null" ],
                                    "minimum" : 0,
                                    "maximum" : 4094
                                },
                                "members" : {
                                    "type" : [ "string", "null" ]
                                },
                                "ethPortProfile" : {
                                    "type" : [ "object", "null" ],
                                    "additionalProperties" : false,
                                    "properties" : {
                                        "id" : {
                                            "type" : "string"
                                        },
                                        "name" : {
                                            "type" : "string"
                                        }
                                    }
                                }
                            },
                            "required" : [ "portName", "enabled" ]
                        }
                    }
                },
                "description" : "Model specific configuration of the AP"
            },
            "autoChannelSelection24" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "channelSelectMode" : {
                        "description" : "Channel Select Mode",
                        "enum" : [ "None", "BackgroundScanning", "ChannelFly" ]
                    },
                    "channelFlyMtbc" : {
                        "description" : "ChannelFly MTBC",
                        "type" : "integer",
                        "default" : 480,
                        "minimum" : 100,
                        "maximum" : 1440
                    }
                },
                "description" : "client load balancing on Radio 2.4G, auto channel selection mode"
            },
            "autoChannelSelection50" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "channelSelectMode" : {
                        "description" : "Channel Select Mode",
                        "enum" : [ "None", "BackgroundScanning", "ChannelFly" ]
                    },
                    "channelFlyMtbc" : {
                        "description" : "ChannelFly MTBC",
                        "type" : "integer",
                        "default" : 480,
                        "minimum" : 100,
                        "maximum" : 1440
                    }
                },
                "description" : "client load balancing on Radio 5G, auto channel selection mode"
            },
            "channelEvaluationInterval" : {
                "description" : "channel evaluation Interval of the AP",
                "type" : "integer",
                "default" : 600,
                "minimum" : 60,
                "maximum" : 3600
            },
            "apMgmtVlan" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "mode" : {
                        "description" : "Vlan Mode of the zone",
                        "enum" : [ "KEEP", "USER_DEFINED" ]
                    },
                    "id" : {
                        "description" : "Vlan id of the zone",
                        "type" : "integer"
                    }
                },
                "description" : "ap Management Vlan of the zone"
            },
            "meshOptions" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "meshMode" : {
                        "description" : "mesh mode",
                        "enum" : [ "AUTO", "ROOT_AP", "MESH_AP", "DISABLE" ]
                    },
                    "uplinkSelection" : {
                        "description" : "Uplink selection",
                        "enum" : [ "SMART", "MANUAL" ]
                    },
                    "meshUplinkEntryList" : {
                        "description" : "MAC address of the neighbor AP",
                        "type" : "array",
                        "items" : {
                            "type" : "string",
                            "pattern" : "^([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F])$"
                        }
                    }
                },
                "description" : "mesh options"
            }
        }
    }
    
    

Retrieve AP Picture 

/v4_0/aps/{apMac}/picture

Use this API command to retrieve the current AP picture.

  • Response  200
  • Body
    Binary data for the picture
    
    

Create 

/v4_0/aps

Use this API command to create a new access point.

  • Request
  • Body
    {
        "mac" : "00:11:22:33:44:55",
        "zoneId" : "zoneUUID",
        "apGroupId" : "apGroupUUID",
        "serial" : "00000096",
        "model" : "ZF7962",
        "name" : "apName",
        "latitude" : 22.3,
        "longitude" : 114,
        "location" : "shenzhen",
        "description" : "apDescription",
        "administrativeState" : "Unlocked",
        "provisionChecklist" : "test"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "mac" : {
                "type" : "string",
                "pattern" : "^([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F])$",
                "description" : "MAC address of the AP"
            },
            "zoneId" : {
                "description" : "Identifier of the zone to which the AP belongs",
                "type" : "string"
            },
            "apGroupId" : {
                "description" : "Identifier of the AP group to which the AP belongs. If the AP belongs to the default AP group, this property is not needed.",
                "type" : "string"
            },
            "serial" : {
                "description" : "Serial number of the AP",
                "type" : "string"
            },
            "model" : {
                "description" : "Model name of the AP",
                "type" : "string"
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 64,
                "pattern" : "^[!-~]((?!\$\()[ -_a-~]){0,62}[!-~]$",
                "description" : "Name of the AP"
            },
            "latitude" : {
                "type" : "number",
                "description" : "Latitude coordinate (in decimal format) of the AP"
            },
            "longitude" : {
                "type" : "number",
                "description" : "Longitude coordinate (in decimal format) of the AP"
            },
            "location" : {
                "type" : "string",
                "pattern" : "^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Location of the AP. This is a free format text description that indicates the location of the AP."
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the AP"
            },
            "administrativeState" : {
                "description" : "Administrative state of the AP. A locked AP will not provide any WLAN services.",
                "enum" : [ "Locked", "Unlocked" ],
                "default" : "Unlocked"
            },
            "provisionChecklist" : {
                "description" : "Provision checklist of the AP. This field indicates the steps that have been completed in the AP provisioning process.",
                "type" : "string"
            }
        },
        "required" : [ "mac", "zoneId" ]
    }
    
    
  • Response  201

Modify Basic 

/v4_0/aps/{apMac}

Use this API command to modify the basic information of an AP.

  • Request
  • Body
    {
        "zoneId" : "zoneUUID",
        "apGroupId" : "apGroupUUID",
        "serial" : "00000096",
        "model" : "ZF7343",
        "name" : "apName",
        "latitude" : 22.3,
        "longitude" : 114,
        "location" : "location",
        "locationAdditionalInfo" : "locationAdditionalInfo",
        "description" : "apDescription",
        "administrativeState" : "Unlocked",
        "provisionChecklist" : "provisionChecklist",
        "wlanService24Enabled" : true,
        "wlanService50Enabled" : null,
        "channelEvaluationInterval" : 777
    }
    
    
    Schema
    {
        "zoneId" : {
            "description" : "Identifier of the zone to which the AP belongs",
            "type" : "string"
        },
        "apGroupId" : {
            "description" : "Identifier of the AP group to which the AP belongs",
            "type" : "string"
        },
        "serial" : {
            "description" : "Serial number of the AP",
            "type" : "string"
        },
        "model" : {
            "description" : "Model name of the AP",
            "type" : "string"
        },
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 64,
            "pattern" : "^[!-~]((?!\$\()[ -_a-~]){0,62}[!-~]$",
            "description" : "Name of the AP"
        },
        "latitude" : {
            "type" : "number",
            "description" : "Latitude coordinate (in decimal format) of the AP"
        },
        "longitude" : {
            "type" : "number",
            "description" : "Longitude coordinate (in decimal format) of the AP"
        },
        "location" : {
            "type" : "string",
            "pattern" : "^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Location of the AP. This is a text description that indicates the location of the AP."
        },
        "locationAdditionalInfo" : {
            "type" : "string",
            "pattern" : "^([!-~]([ -~]){0,253}[!-~]|[!-~]{1,1})$",
            "description" : "Location additional info of the AP. This is a text description that indicates the location additional info of the AP."
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Description of the AP"
        },
        "administrativeState" : {
            "description" : "Administrative state of the AP. A locked AP will not provide any WLAN services.",
            "enum" : [ "Locked", "Unlocked" ]
        },
        "provisionChecklist" : {
            "description" : "Provision checklist of the AP. This field indicates the steps that have been completed in the AP provisioning process.",
            "type" : "string"
        },
        "wlanService24Enabled" : {
            "description" : "WLAN service enabled or disabled on 2.4GHz radio",
            "type" : "boolean"
        },
        "wlanService50Enabled" : {
            "description" : "WLAN service enabled or disabled on 5GHz radio",
            "type" : "boolean"
        },
        "channelEvaluationInterval" : {
            "description" : "channel evaluation Interval of the AP",
            "type" : "integer",
            "default" : 600,
            "minimum" : 60,
            "maximum" : 3600
        }
    }
    
    
  • Response  204

Diable Location Override 

/v4_0/aps/{apMac}/location

Use this API command to disable AP level override of location. The access point will take its group’s configuration or zone’s configuration.

  • Response  204

Diable Location AdditionalInfo Override 

/v4_0/aps/{apMac}/locationAdditionalInfo

Use this API command to disable AP level override of location additionalInfo. The access point will take its group’s configuration or zone’s configuration.

  • Response  204

Modify Login Override 

/v4_0/aps/{apMac}/login

Use this API command to enable or modify the AP-level logon override settings.

  • Request
  • Body
    {
        "apLoginName" : "apLoginName",
        "apLoginPassword" : "apLoginPassword"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "apLoginName" : {
                "type" : "string",
                "maxLength" : 64,
                "pattern" : "^((?!\$\()[!-_a-~]){1,64}$",
                "description" : "User name of the AP administrator"
            },
            "apLoginPassword" : {
                "type" : "string",
                "maxLength" : 64,
                "pattern" : ".*(?=.{8,})(?=.*[a-zA-Z])(?=.*[0-9])(?=.*[_`~!@#$%^&*\(\)\[\]\{\}|;:'\",.\<>\/?=+-]).*",
                "description" : "Password of the AP administrator"
            }
        },
        "required" : [ "apLoginName", "apLoginPassword" ],
        "description" : "Logon credentials for the AP. These logon credentials will override the logon credentials specified at the zone level or AP group level."
    }
    
    
  • Response  204

Diable Login Override 

/v4_0/aps/{apMac}/login

Use this API command to disable the AP-level logon override. The AP will apply its group’s or zone’s configuration.

  • Response  204

Modify Syslog Override 

/v4_0/aps/{apMac}/syslog

Use this API command to enable or modify the AP-level syslog override settings.

  • Request
  • Body
    {
        "enabled" : true,
        "address" : "1.1.1.1",
        "port" : 514,
        "facility" : "keep_Original",
        "priority" : "Error"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "enabled" : {
                "description" : "Indicates whether syslog is enabled or disabled",
                "type" : "boolean"
            },
            "address" : {
                "type" : "string",
                "description" : "Address of the syslog server. If syslog is enabled, this attribute is required."
            },
            "port" : {
                "description" : "Port number of the syslog server",
                "type" : "integer",
                "default" : "514",
                "minimum" : 1,
                "maximum" : 65535
            },
            "facility" : {
                "description" : "Facility of the syslog server",
                "enum" : [ "Keep_Original", "Local0", "Local1", "Local2", "Local3", "Local4", "Local5", "Local6", "Local7" ]
            },
            "priority" : {
                "description" : "Priority of the log messages",
                "enum" : [ "Emergency", "Alert", "Critical", "Error", "Warning", "Notice", "Info", "All" ]
            }
        },
        "required" : [ "enabled" ],
        "description" : "Syslog configuration of the AP. This configuration will override the syslog configuration at the zone level or AP group level."
    }
    
    
  • Response  204

Diable Syslog Override 

/v4_0/aps/{apMac}/syslog

Use this API command to disable the AP level syslog override. The access point will take its group’s or zone’s configuration.

  • Response  204

Modify Radio 2.4G Override 

/v4_0/aps/{apMac}/wifi24

Use this API command to modify the AP level override of the 2.4GHz radio configuration.

  • Request
  • Body
    {
        "txPower" : "Full",
        "channelWidth" : 20,
        "channel" : 1,
        "channelRange" : [ 1, 2, 3 ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "txPower" : {
                "enum" : [ "Full", "-1dB", "-2dB", "-3dB(1/2)", "-4dB", "-5dB", "-6dB(1/4)", "-7dB", "-8dB", "-9dB(1/8)", "-10dB", "Min" ],
                "description" : "Transmission power"
            },
            "channelWidth" : {
                "description" : "Channel width. Zero (0) means Auto.",
                "enum" : [ 0, 20, 40 ]
            },
            "channel" : {
                "description" : "Channel number",
                "type" : "integer"
            },
            "channelRange" : {
                "description" : "Channel range options",
                "type" : "array",
                "items" : {
                    "type" : "integer"
                }
            },
            "availableChannelRange" : {
                "description" : "Available channel range options",
                "type" : "array",
                "items" : {
                    "type" : "integer"
                }
            }
        },
        "description" : "2.4GHz radio configuration of the AP. This configuration will override the radio 2.4GHz configuration at the zone level or AP group level."
    }
    
    
  • Response  204

Disable Radio 2.4G Override 

/v4_0/aps/{apMac}/wifi24

Use this API command to disable the AP level override of the 2.4GHz radio configuration. The access point will take its group’s configuration or zone’s configuration.

  • Response  204

Modify Radio 5G Override 

/v4_0/aps/{apMac}/wifi50

Use this API command to Modify the AP level override of the 5GHz radio configuration.

  • Request
  • Body
    {
        "txPower" : "Full",
        "channelWidth" : 20,
        "channel" : 52,
        "channelRange" : [ 52, 56, 60 ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "txPower" : {
                "enum" : [ "Full", "-1dB", "-2dB", "-3dB(1/2)", "-4dB", "-5dB", "-6dB(1/4)", "-7dB", "-8dB", "-9dB(1/8)", "-10dB", "Min" ],
                "description" : "transmission power"
            },
            "channelWidth" : {
                "description" : "channel width, 0 mean Auto",
                "enum" : [ 0, 20, 40, 80 ]
            },
            "channel" : {
                "description" : "channel number",
                "type" : "integer"
            },
            "channelRange" : {
                "description" : "channel range options",
                "type" : "array",
                "items" : {
                    "type" : "integer"
                }
            },
            "availableChannelRange" : {
                "description" : "available channel range options",
                "type" : "array",
                "items" : {
                    "type" : "integer"
                }
            }
        },
        "description" : "5GHz radio configuration. This configuration will override the 5GHz radio configuration at the zone level or AP group level."
    }
    
    
  • Response  204

Disable Radio 5G Override 

/v4_0/aps/{apMac}/wifi50

Use this API command to disable the AP level override of 5GHz radio configuration. The access point will take its group’s or zone’s configuration.

  • Response  204

Modify WLAN Group 2.4G Override 

/v4_0/aps/{apMac}/wlanGroup24

Use this API command to enable or modify the AP level override of the WLAN group configuration on the 2.4GHz radio.

  • Request
  • Body
    {
        "id" : "wlanGroupUUID",
        "name" : "wlanGroupName"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the WLAN group",
                "type" : "string"
            },
            "name" : {
                "description" : "Name of the WLAN group",
                "type" : "string"
            }
        },
        "description" : "WLAN group of 2.4GHz radio. This configuration will override the WLAN group of the 2.4GHz radio at the zone level or AP group level."
    }
    
    
  • Response  204

Disable WLAN Group 2.4G Override 

/v4_0/aps/{apMac}/wlanGroup24

Use this API command to disable the AP level override of WLAN group configuration on 2.4GHz radio. The access point will take its group’s or zone’s configuration.

  • Response  204

Modify WLAN Group 5G Override 

/v4_0/aps/{apMac}/wlanGroup50

Use this API command to enable or modify the AP level override of the WLAN group configuration on the 5GHz radio.

  • Request
  • Body
    {
        "id" : "wlanGroupUUID",
        "name" : "wlanGroupName"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the WLAN group",
                "type" : "string"
            },
            "name" : {
                "description" : "Name of the WLAN group",
                "type" : "string"
            }
        },
        "description" : "WLAN group of 5GHz radio. This configuration will override the WLAN group of the 5GHz radio at the zone level or AP group level."
    }
    
    
  • Response  204

Disable WLAN group 5G Override 

/v4_0/aps/{apMac}/wlanGroup50

Use this API command to disable the AP level override of WLAN group on the 5GHz radio. The access point will take its group’s or zone’s configuration.

  • Response  204

Modify Network Settings 

/v4_0/aps/{apMac}/network

Use this API command to modify the network settings of an AP.

  • Request
  • Body
    {
        "ipType" : "Static",
        "ip" : "1.1.1.1",
        "netmask" : "255.255.255.0",
        "gateway" : "1.1.1.0",
        "primaryDns" : "8.8.8.8",
        "secondaryDns" : "8.8.8.9"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "ipType" : {
                "description" : "Indicates how the AP's IP address was obtained. An AP's IP address can be statically or dynamically assigned or kept unchanged.",
                "enum" : [ "Static", "Dynamic", "Keep" ]
            },
            "ip" : {
                "type" : "string",
                "description" : "IP address of the AP"
            },
            "netmask" : {
                "type" : "string",
                "pattern" : "^$|(^(128|192|224|24[08]|25[245]).0.0.0$)|(^255.(0|128|192|224|24[08]|25[245]).0.0$)|(^255.255.(0|128|192|224|24[08]|25[245]).0$)|(^255.255.255.(0|128|192|224|24[08]|252|255)$)",
                "description" : "Netmask of the AP's subnet"
            },
            "gateway" : {
                "type" : "string",
                "description" : "Gateway of the AP"
            },
            "primaryDns" : {
                "type" : "string",
                "description" : "Primary DNS server address of the AP"
            },
            "secondaryDns" : {
                "type" : "string",
                "description" : "Secondary DNS server address of the AP"
            }
        },
        "description" : "Network settings of the AP."
    }
    
    
  • Response  204

Modify Smart Monitor 

/v4_0/aps/{apMac}/smartMonitor

Use this API command to modify smart monitor of an AP.

  • Request
  • Body
    {
        "enabled" : true,
        "intervalInSec" : 10,
        "retryThreshold" : 10
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "enabled" : {
                "type" : "boolean"
            },
            "intervalInSec" : {
                "description" : "Interval in seconds. This is required if smartMonitor is enabled",
                "type" : "integer",
                "default" : 10,
                "minimum" : 5,
                "maximum" : 60
            },
            "retryThreshold" : {
                "description" : "Retry threshold. This is required if smartMonitor is enabled",
                "type" : "integer",
                "default" : 3,
                "minimum" : 1,
                "maximum" : 10
            }
        },
        "description" : "Smart monitor of the AP."
    }
    
    
  • Response  204

Disable Smart Monitor Override 

/v4_0/aps/{apMac}/smartMonitor

Use this API command to disable AP level override of smart monitor. The access point will take its group’s configuration or zone’s configuration.

  • Response  204

Modify Bonjour Gateway 

/v4_0/aps/{apMac}/bonjourGateway

Use this API command to modify bonjour gateway of an AP.

  • Request
  • Body
    {
        "id" : "bonjourGatewayUUID",
        "name" : "bonjourGatewayName"
    }
    
    
    Schema
    {
        "type" : [ "object", "null" ],
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            },
            "name" : {
                "type" : "string"
            }
        },
        "description" : "Bonjour gateway of the AP."
    }
    
    
  • Response  204

Disable Bonjour Gateway Override 

/v4_0/aps/{apMac}/bonjourGateway

Use this API command to disable AP level override of bonjour gateway. The access point will take its group’s configuration or zone’s configuration.

  • Response  204

Modify Client Admission Control 2.4G 

/v4_0/aps/{apMac}/clientAdmissionControl24

Use this API command to modify client admission control 2.4GHz radio configuration of an AP.

  • Request
  • Body
    {
        "maxRadioLoadPercent" : 70,
        "minClientCount" : 30,
        "minClientThroughputMbps" : 10.0,
        "enabled" : true
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "enabled" : {
                "type" : "boolean"
            },
            "maxRadioLoadPercent" : {
                "description" : "Maximum radio load percentage.",
                "type" : "integer",
                "default" : 75,
                "minimum" : 50,
                "maximum" : 100
            },
            "minClientCount" : {
                "description" : "Minimum client count number.",
                "type" : "integer",
                "default" : 10,
                "minimum" : 0,
                "maximum" : 100
            },
            "minClientThroughputMbps" : {
                "description" : "Minimum client throughput in Mbps.",
                "type" : "number",
                "default" : 0,
                "minimum" : 0,
                "maximum" : 100
            }
        },
        "description" : "Client admission control configuration of 2.4GHz radio of the AP."
    }
    
    
  • Response  204

Disable Client Admission Control 2.4G Override 

/v4_0/aps/{apMac}/clientAdmissionControl24

Use this API command to disable AP level override of client admission control 2.4GHz radio configuration. The access point will take its group’s configuration or zone’s configuration.

  • Response  204

Modify Client Admission Control 5G 

/v4_0/aps/{apMac}/clientAdmissionControl50

Use this API command to modify client admission control 5GHz radio configuration of an AP.

  • Request
  • Body
    {
        "maxRadioLoadPercent" : 70,
        "minClientCount" : 30,
        "minClientThroughputMbps" : 10.0,
        "enabled" : true
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "enabled" : {
                "type" : "boolean"
            },
            "maxRadioLoadPercent" : {
                "description" : "Maximum radio load percentage.",
                "type" : "integer",
                "default" : 75,
                "minimum" : 50,
                "maximum" : 100
            },
            "minClientCount" : {
                "description" : "Minimum client count number.",
                "type" : "integer",
                "default" : 10,
                "minimum" : 0,
                "maximum" : 100
            },
            "minClientThroughputMbps" : {
                "description" : "Minimum client throughput in Mbps.",
                "type" : "number",
                "default" : 0,
                "minimum" : 0,
                "maximum" : 100
            }
        },
        "description" : "Client admission control configuration of 5GHz radio of the AP."
    }
    
    
  • Response  204

Disable Client Admission Control 5G Override 

/v4_0/aps/{apMac}/clientAdmissionControl50

Use this API command to disable AP level override of client admission control 5GHz radio configuration. The access point will take its group’s configuration or zone’s configuration.

  • Response  204

Modify Venue Profile 

/v4_0/aps/{apMac}/venueProfile

Use this API command to modify venue profile of an AP.

  • Request
  • Body
    {
        "id" : "venueProfileId",
        "name" : "venueProfileName"
    }
    
    
    Schema
    {
        "type" : [ "object", "null" ],
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            },
            "name" : {
                "type" : "string"
            }
        },
        "description" : "Venue profile configuration of the AP."
    }
    
    
  • Response  204

Disable Venue Profile Override 

/v4_0/aps/{apMac}/venueProfile

Use this API command to disable AP level override of venue profile. The access point will take its group’s configuration or zone’s configuration.

  • Response  204

Modify Model Specific 

/v4_0/aps/{apMac}/specific

Use this API command to modify model specific configuration.

  • Request
  • Body
    {
        "ledStatusEnabled" : false,
        "lldp" : {
            "enabled" : true,
            "advertiseIntervalInSec" : 100,
            "holdTimeInSec" : 1000,
            "managementIPTLVEnabled" : false
        },
        "ledMode" : null,
        "internalHeaterEnabled" : null,
        "poeOutPortEnabled" : null,
        "usbPowerEnable" : true,
        "poeModeSetting" : "Auto",
        "poeTxChain" : 2,
        "radioBand" : null,
        "externalAntenna24" : null,
        "externalAntenna50" : null,
        "lanPorts" : [ {
            "portName" : "LAN1",
            "enabled" : false
        }, {
            "portName" : "LAN2",
            "enabled" : true,
            "ethPortProfile" : {
                "id" : "0"
            }
        }, {
            "portName" : "LAN3",
            "enabled" : true,
            "ethPortProfile" : {
                "id" : "1"
            },
            "overwriteVlanEnabled" : true,
            "vlanUntagId" : 1,
            "members" : "1"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "ledStatusEnabled" : {
                "type" : [ "boolean", "null" ]
            },
            "lldp" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "enabled" : {
                        "type" : "boolean"
                    },
                    "advertiseIntervalInSec" : {
                        "type" : [ "integer", "null" ],
                        "minimum" : 1,
                        "maximum" : 300
                    },
                    "holdTimeInSec" : {
                        "type" : [ "integer", "null" ],
                        "minimum" : 60,
                        "maximum" : 1200
                    },
                    "managementIPTLVEnabled" : {
                        "type" : [ "boolean", "null" ]
                    }
                },
                "required" : [ "enabled" ]
            },
            "ledMode" : {
                "enum" : [ null, "CableModem", "AccessPoint", "CableModem_AccessPoint", "CableModem_AccessPoint_DEFAULT", "ActiveSurgeProtector", "ActiveSurgeProtector_ModemOnline_DEFAULT", "Off" ]
            },
            "internalHeaterEnabled" : {
                "type" : [ "boolean", "null" ]
            },
            "poeOutPortEnabled" : {
                "type" : [ "boolean", "null" ]
            },
            "usbPowerEnable" : {
                "type" : [ "boolean", "null" ]
            },
            "poeModeSetting" : {
                "enum" : [ "Auto", "_802_3af", "_802_3at", null ]
            },
            "poeTxChain" : {
                "type" : [ "integer", "null" ]
            },
            "radioBand" : {
                "enum" : [ null, "2.4GHz", "5GHz" ]
            },
            "externalAntenna24" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "enabled" : {
                        "type" : "boolean"
                    },
                    "dbi" : {
                        "type" : [ "integer", "null" ],
                        "minimum" : 0,
                        "maximum" : 90
                    },
                    "chainMask" : {
                        "enum" : [ null, "Two", "Three" ]
                    }
                },
                "required" : [ "enabled" ]
            },
            "externalAntenna50" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "enabled" : {
                        "type" : "boolean"
                    },
                    "dbi" : {
                        "type" : [ "integer", "null" ],
                        "minimum" : 0,
                        "maximum" : 90
                    },
                    "chainMask" : {
                        "enum" : [ null, "Two", "Three" ]
                    }
                },
                "required" : [ "enabled" ]
            },
            "lanPorts" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "portName" : {
                            "enum" : [ "LAN1", "LAN2", "LAN3", "LAN4", "LAN5" ]
                        },
                        "enabled" : {
                            "type" : "boolean"
                        },
                        "overwriteVlanEnabled" : {
                            "type" : "boolean"
                        },
                        "vlanUntagId" : {
                            "type" : [ "integer", "null" ],
                            "minimum" : 0,
                            "maximum" : 4094
                        },
                        "members" : {
                            "type" : [ "string", "null" ]
                        },
                        "ethPortProfile" : {
                            "type" : [ "object", "null" ],
                            "additionalProperties" : false,
                            "properties" : {
                                "id" : {
                                    "type" : "string"
                                },
                                "name" : {
                                    "type" : "string"
                                }
                            }
                        }
                    },
                    "required" : [ "portName", "enabled" ]
                }
            }
        }
    }
    
    
  • Response  204

Disable Model Specific Override 

/v4_0/aps/{apMac}/specific

Use this API command to disable model specific configuration override from AP group or zone.

  • Response  204

Upload AP Picture 

/v4_0/aps/{apMac}/picture

Use this API command to upload a new AP picture.

  • Request
  • Body
    Binary data for the picture
    
    
  • Response  204

Modify AP Picture 

/v4_0/aps/{apMac}/picture

Use this API command to modify an AP picture

  • Request
  • Body
    Binary data for the picture
    
    
  • Response  204

Delete AP Picture 

/v4_0/aps/{apMac}/picture

Use this API command to delete an AP picture.

  • Response  204

Modify AP Usb Software Package 

/v4_0/aps/{apMac}/usbSoftwarePackage

Modify AP Usb Software Package of an access point

  • Request
  • Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "usbSoftware" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "APUsbSoftwarePackage id or name"
            },
            "applyModel" : {
                "description" : "List of apply models",
                "type" : "array",
                "items" : {
                    "type" : "string"
                }
            }
        },
        "description" : "APUsbSoftwarePackage of the zone"
    }
    
    
  • Response  204

Disable AP Usb Software Package 

/v4_0/aps/{apMac}/usbSoftwarePackage

Disable AP level Usb Software Package. The access point will take its group’s configuration or zone’s configuration.

  • Response  204

Disable AP Channel Evaluation Interval 

/v4_0/aps/{apMac}/channelEvaluationInterval

Disable AP lChannel Evaluation Interval. The access point will take its group’s configuration or zone’s configuration.

  • Response  204

Modify Radio 2.4G Auto ChannelSelectMode Override 

/v4_0/aps/{apMac}/autoChannelSelection24

Override Radio 2.4G Auto ChannelSelectMode and ChannelFly MTBC of an AP

  • Request
  • Body
    {
        "channelSelectMode" : "ChannelFly",
        "channelFlyMtbc" : 480
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "channelSelectMode" : {
                "description" : "Channel Select Mode",
                "enum" : [ "None", "BackgroundScanning", "ChannelFly" ]
            },
            "channelFlyMtbc" : {
                "description" : "ChannelFly MTBC",
                "type" : "integer",
                "default" : 480,
                "minimum" : 100,
                "maximum" : 1440
            }
        },
        "description" : "client load balancing on Radio 2.4G, auto channel selection mode"
    }
    
    
  • Response  204

Disable Radio 2.4G Auto channel selection 

/v4_0/aps/{apMac}/autoChannelSelection24

Use this API command to disable the AP level override of auto channel selection on the 2.4GHz radio. The access point will take its group’s or zone’s configuration.

  • Response  204

Modify Radio 5G Auto ChannelSelectMode Override 

/v4_0/aps/{apMac}/autoChannelSelection50

Override Radio 5G Auto ChannelSelectMode and ChannelFly MTBC of an AP

  • Request
  • Body
    {
        "channelSelectMode" : "BackgroundScanning",
        "channelFlyMtbc" : 480
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "channelSelectMode" : {
                "description" : "Channel Select Mode",
                "enum" : [ "None", "BackgroundScanning", "ChannelFly" ]
            },
            "channelFlyMtbc" : {
                "description" : "ChannelFly MTBC",
                "type" : "integer",
                "default" : 480,
                "minimum" : 100,
                "maximum" : 1440
            }
        },
        "description" : "client load balancing on Radio 5G, auto channel selection mode"
    }
    
    
  • Response  204

Disable Radio 5G Auto channel selection 

/v4_0/aps/{apMac}/autoChannelSelection50

Use this API command to disable the AP level override of auto channel selection on the 5GHz radio. The access point will take its group’s or zone’s configuration.

  • Response  204

Modify Altitude Override 

/v4_0/aps/{apMac}/altitude

Use this API command to modify the altitude of an AP.

  • Request
  • Body
    {
        "altitudeUnit" : "meters",
        "altitudeValue" : 1
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "altitudeUnit" : {
                "description" : "altitude unit",
                "enum" : [ "meters", "floor" ]
            },
            "altitudeValue" : {
                "description" : "altitude value",
                "type" : "integer"
            }
        },
        "description" : "GPS Altitude"
    }
    
    
  • Response  204

Diable Altitude Override 

/v4_0/aps/{apMac}/altitude

Use this API command to disable AP level override of altitude. The access point will take its group’s configuration or zone’s configuration.

  • Response  204

Modify Mesh Options 

/v4_0/aps/{apMac}/meshOptions

Use this API command to modify mesh options of an AP.

  • Request
  • Body
    {
        "meshMode" : "MESH_AP",
        "uplinkSelection" : "MANUAL",
        "meshUplinkEntryList" : [ "6C:AA:B3:26:6C:30" ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "meshMode" : {
                "description" : "mesh mode",
                "enum" : [ "AUTO", "ROOT_AP", "MESH_AP", "DISABLE" ]
            },
            "uplinkSelection" : {
                "description" : "Uplink selection",
                "enum" : [ "SMART", "MANUAL" ]
            },
            "meshUplinkEntryList" : {
                "description" : "MAC address of the neighbor AP",
                "type" : "array",
                "items" : {
                    "type" : "string",
                    "pattern" : "^([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F])$"
                }
            }
        },
        "description" : "mesh options"
    }
    
    
  • Response  204

Disable Mesh Options 

/v4_0/aps/{apMac}/meshOptions

Use this API command to disable mesh options.

  • Response  204

Delete 

/v4_0/aps/{apMac}

Use this API command to delete an access point.

  • Response  204

Reboot 

/v4_0/aps/{apMac}/reboot

reboot an access point

  • Response  204

Access Point Operational 

Retrieve Operational Information 

/v4_0/aps/{apMac}/operational/summary

Use this API command to retrieve the operational information of an AP.

  • Response  200
  • Body
    {
        "mac" : "00:11:22:33:44:55",
        "zoneId" : "zoneUUID",
        "apGroupId" : "apGroupUUID",
        "serial" : "00000096",
        "model" : "ZF7962",
        "name" : "apName",
        "version" : "3.0.0.385",
        "description" : "apDescription",
        "countryCode" : "US",
        "latitude" : 22.3,
        "longitude" : 114,
        "location" : "location",
        "cpId" : "controlPlaneUUID",
        "dpId" : "dataPlaneUUID",
        "wifi24Channel" : "2",
        "wifi50Channel" : "6",
        "meshRole" : "Map",
        "meshHop" : 2,
        "ipType" : "Static",
        "ip" : "1.1.1.1",
        "ipv6Type" : null,
        "ipv6" : null,
        "externalIp" : "172.18.11.11",
        "externalPort" : 675,
        "configState" : "newConfig",
        "connectionState" : "Connected",
        "registrationState" : "Approved",
        "administrativeState" : "Unlocked",
        "provisionMethod" : "Discovered",
        "provisionStage" : "Waiting for Registration",
        "isCriticalAP" : true,
        "approvedTime" : 111111,
        "lastSeenTime" : 111111,
        "uptime" : 111111,
        "clientCount" : 2
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "mac" : {
                "type" : "string",
                "pattern" : "^([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F])$",
                "description" : "MAC address of the AP"
            },
            "zoneId" : {
                "description" : "Identifier of the zone to which the AP belongs",
                "type" : "string"
            },
            "apGroupId" : {
                "description" : "Identifier of the AP group to which the AP belongs",
                "type" : "string"
            },
            "serial" : {
                "description" : "Serial number of the AP",
                "type" : "string"
            },
            "model" : {
                "description" : "Model name of the AP",
                "type" : "string"
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 64,
                "pattern" : "^[!-~]((?!\$\()[ -_a-~]){0,62}[!-~]$",
                "description" : "Name of the AP"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the AP"
            },
            "version" : {
                "type" : "string",
                "pattern" : "^\d+\.\d+\.\d+\.\d+\.\d+$",
                "description" : "Firmware version of the AP"
            },
            "countryCode" : {
                "description" : "Country code of the AP",
                "type" : "string"
            },
            "latitude" : {
                "type" : "number",
                "description" : "Latitude coordinate (in decimal format) of the AP"
            },
            "longitude" : {
                "type" : "number",
                "description" : "Longitude coordinate (in decimal format) of the AP"
            },
            "location" : {
                "type" : "string",
                "pattern" : "^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Location of the AP. This is a text description that indicates the location of the AP."
            },
            "cpId" : {
                "description" : "Identifier of the control plane to which the AP is currently connected",
                "type" : "string"
            },
            "dpId" : {
                "description" : "Identifier of the data plane to which the AP is currently connected",
                "type" : "string"
            },
            "wifi24Channel" : {
                "description" : "2.4GHz radio channel number that the AP is currently using",
                "type" : "string"
            },
            "wifi50Channel" : {
                "description" : "5GHZ radio channel number that the AP is currently using",
                "type" : "string"
            },
            "meshRole" : {
                "description" : "Mesh role of the AP",
                "enum" : [ "Disabled", "Root", "Map", "eMap", "Down", "Undefined" ]
            },
            "meshHop" : {
                "description" : "Number of mesh hops of the AP. This is only applicable to mesh APs.",
                "type" : "integer"
            },
            "ipType" : {
                "description" : "Indicates how the AP's IP address was obtained. The AP's IP address can be statically or dynamically assigned or kept unchanged.",
                "enum" : [ "Static", "Dynamic", "Keep" ]
            },
            "ip" : {
                "description" : "IP address of the AP",
                "type" : "string"
            },
            "externalIp" : {
                "description" : "External IP address of the AP. This is only applicable when the AP is behind a NAT server.",
                "type" : "string"
            },
            "externalPort" : {
                "description" : "External port number of the AP. This is only applicable when the AP is behind a NAT server.",
                "type" : "integer"
            },
            "configState" : {
                "description" : "State of the AP configuration.",
                "enum" : [ "newConfig", "fwApplied", "fwDownloaded", "fwFailed", "configApplied", "completed", "configFailed" ]
            },
            "connectionState" : {
                "description" : "Connection state of the AP",
                "type" : "string"
            },
            "registrationState" : {
                "description" : "Registration state of the AP",
                "type" : "string"
            },
            "administrativeState" : {
                "description" : "Administrative state of the AP. A locked AP will not provide any WLAN services.",
                "enum" : [ "Locked", "Unlocked" ]
            },
            "provisionMethod" : {
                "description" : "Provisioning method of the AP. Discovered indicates that the AP contacted the controller using discovery and the AP did not have pre-existing record on the controller. Preprovision indicates that the AP was provisioned to the controller before AP made the first contact. Swap indicates that the AP was provisioned to be a replacement of an existing AP.",
                "enum" : [ "Discovered", "Preprovision", "Swap" ]
            },
            "provisionStage" : {
                "description" : "Provisioning stage of the AP. This indicates the stage at which the AP is at in the provisioning process.",
                "type" : "string"
            },
            "isCriticalAP" : {
                "description" : "Indicates critical APs. Critical AP are APs that were tagged by the controller based on predefined rules.",
                "type" : "boolean"
            },
            "approvedTime" : {
                "description" : "Timestamp when the AP was approved by the controller",
                "type" : "integer"
            },
            "lastSeenTime" : {
                "description" : "Timestamp of the last successful communication with the AP",
                "type" : "integer"
            },
            "uptime" : {
                "description" : "Uptime of the AP since it was last rebooted",
                "type" : "integer"
            },
            "clientCount" : {
                "description" : "Number of clients on the AP",
                "type" : "integer"
            },
            "managementVlan" : {
                "description" : "Management vlan on the AP",
                "type" : "integer"
            }
        }
    }
    
    

Retrieve Alarm Summary 

/v4_0/aps/{apMac}/operational/alarmSummary

Use this API command to retrieve the alarm summary of an AP.

  • Response  200
  • Body
    {
        "criticalCount" : 3,
        "majorCount" : 3,
        "minorCount" : 4,
        "warningCount" : 0
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "criticalCount" : {
                "description" : "Critical alarm count",
                "type" : "integer"
            },
            "majorCount" : {
                "description" : "Major alarm count",
                "type" : "integer"
            },
            "minorCount" : {
                "description" : "Minor alarm count",
                "type" : "integer"
            },
            "warningCount" : {
                "description" : "Warning alarm count",
                "type" : "integer"
            }
        }
    }
    
    

Retrieve Event Summary 

/v4_0/aps/{apMac}/operational/eventSummary

Use this API command to retrieve the event summary of an AP.

  • Response  200
  • Body
    {
        "criticalCount" : 4,
        "majorCount" : 2,
        "minorCount" : 5,
        "warningCount" : 5,
        "informationalCount" : 2,
        "debugCount" : 5
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "criticalCount" : {
                "description" : "Critical event count",
                "type" : "integer"
            },
            "majorCount" : {
                "description" : "Major event count",
                "type" : "integer"
            },
            "minorCount" : {
                "description" : "Minor event count",
                "type" : "integer"
            },
            "warningCount" : {
                "description" : "Warning event count",
                "type" : "integer"
            },
            "informationalCount" : {
                "description" : "Informational event count",
                "type" : "integer"
            },
            "debugCount" : {
                "description" : "Debug event count",
                "type" : "integer"
            }
        }
    }
    
    

Retrieve Alarm List 

/v4_0/aps/{apMac}/operational/alarms

Use this API command to retrieve the list of alarms on an AP.

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

    type
    string (optional) 

    Query type, valid value is AND or OR. Default: AND

    value
    string (optional) 

    Vague value to search. Could be a list of value, like value=ABC&value=CD in the parameter.

    order
    string (optional) 

    Value of order parameter.

    direction
    string (optional) 

    Direction of order parameter, valid value id ASC or DESC. Default: DESC

    fixSearch
    string (optional) Example: key1=value1&key2=value2

    fixSearch is not mean real query key. It is for other fix search parameters to search, like key1=value1&key2=value2

  • Response  200
  • Body
    {
        "totalCount" : 2,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "538324f5-f085-4567-ae3f-6b40244d38d6",
            "time" : 1408715298000,
            "code" : 302,
            "category" : "AP Communication",
            "type" : "AP rebooted by system",
            "severity" : "Major",
            "description" : "AP [abcpeng@24:C9:A1:1D:55:A0] rebooted because of [application, wsgclient, reboot due to switch radio band].",
            "status" : "Outstanding",
            "clearedTime" : null,
            "acknowledgedTime" : null
        }, {
            "id" : "5cc35da9-4d3c-4c9a-97e0-303d9b2b1776",
            "time" : 1408715248732,
            "code" : 307,
            "category" : "AP Communication",
            "type" : "AP heartbeat lost",
            "severity" : "Informational",
            "description" : "AP [abcpeng@24:C9:A1:1D:55:A0] heartbeat lost.",
            "status" : "Cleared",
            "clearedTime" : 1408715299243,
            "acknowledgedTime" : null
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "description" : "Total alarm count",
                "type" : "integer"
            },
            "hasMore" : {
                "description" : "Indicates whether there are more alarms after the currently displayed list",
                "type" : "boolean"
            },
            "firstIndex" : {
                "description" : "Index of the first alarm returned from the complete alarm list",
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "type" : "string",
                            "pattern" : "^([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F])$",
                            "description" : "Identifier of the alarm"
                        },
                        "time" : {
                            "description" : "Time of the alarm",
                            "type" : "string"
                        },
                        "code" : {
                            "description" : "Alarm code",
                            "type" : "string"
                        },
                        "category" : {
                            "description" : "Alarm category",
                            "type" : "string"
                        },
                        "type" : {
                            "description" : "Alarm type",
                            "type" : "string"
                        },
                        "severity" : {
                            "description" : "Alarm severity",
                            "enum" : [ "Critical", "Major", "Minor", "Warning", "Informational" ]
                        },
                        "description" : {
                            "description" : "Alarm description",
                            "type" : "string"
                        },
                        "status" : {
                            "description" : "Alarm status",
                            "enum" : [ "Outstanding", "Acknowledged", "Cleared" ]
                        },
                        "clearedTime" : {
                            "description" : "Time that alarm was cleared",
                            "type" : "integer"
                        },
                        "acknowledgedTime" : {
                            "description" : "Time the alarm was acknowledged",
                            "type" : "integer"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve Event List 

/v4_0/aps/{apMac}/operational/events

Use this API command to retrieve the list of events from an AP.

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

    type
    string (optional) 

    Query type, valid value is AND or OR. Default: AND

    value
    string (optional) 

    Vague value to search. Could be a list of value, like value=ABC&value=CD in the parameter.

    order
    string (optional) 

    Value of order parameter.

    direction
    string (optional) 

    Direction of order parameter, valid value id ASC or DESC. Default: DESC

    fixSearch
    string (optional) Example: key1=value1&key2=value2

    fixSearch is not mean real query key. It is for other fix search parameters to search, like key1=value1&key2=value2

  • Response  200
  • Body
    {
        "totalCount" : 2,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "7a06627a-f739-4aac-b2a1-5fc6d7bb2767",
            "time" : 1408648612000,
            "code" : 110,
            "category" : "AP Communication",
            "type" : "AP configuration updated",
            "severity" : "Informational",
            "description" : "AP [abcpeng@24:C9:A1:1D:55:A0] updated to configuration [af8d97a0-2967-11e4-91cf-000c29b1347d]."
        }, {
            "id" : "8c5796c1-746c-460b-81f0-f97b8ab2b74f",
            "time" : 1408648603000,
            "code" : 109,
            "category" : "AP Communication",
            "type" : "Updating AP configuration...",
            "severity" : "Informational",
            "description" : "AP [abcpeng@24:C9:A1:1D:55:A0] is being updated to new configuration ID [af8d97a0-2967-11e4-91cf-000c29b1347d]."
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "description" : "Total event count",
                "type" : "integer"
            },
            "hasMore" : {
                "description" : "Indicates whether there are more events after the currently displayed list",
                "type" : "boolean"
            },
            "firstIndex" : {
                "description" : "Index of the first event returned from the complete event list",
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "type" : "string",
                            "pattern" : "^([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F])$",
                            "description" : "Identifier of the event"
                        },
                        "time" : {
                            "description" : "Time of the event",
                            "type" : "string"
                        },
                        "code" : {
                            "description" : "Event code",
                            "type" : "string"
                        },
                        "category" : {
                            "description" : "Event category",
                            "type" : "string"
                        },
                        "type" : {
                            "description" : "Event type",
                            "type" : "string"
                        },
                        "severity" : {
                            "description" : "Event severity",
                            "enum" : [ "Critical", "Major", "Minor", "Warning", "Informational", "Debug" ]
                        },
                        "description" : {
                            "description" : "Event description",
                            "type" : "string"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve Mesh Neighbor AP List 

/v4_0/aps/{apMac}/operational/neighbor

Use this API command to retrieve a list of neighbor access points on mesh AP.

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

  • Response  200
  • Body
    {
        "totalCount" : 1,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "mac" : "8C:0C:90:2B:8B:90",
            "model" : "ZF7372",
            "name" : "RuckusAP",
            "version" : "3.1.0.0.157",
            "ip" : "10.2.6.239",
            "externalIp" : "10.2.6.239",
            "externalPort" : "58788",
            "connectionState" : "Connect",
            "channel" : "40 (11a/n)",
            "signal" : "119%",
            "zoneName" : "neilMeshZone"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "description" : "Total mesh neighbor APs count",
                "type" : "integer"
            },
            "hasMore" : {
                "description" : "Indicator of whether there are more Mesh Neighbor APs after the current displayed list",
                "type" : "boolean"
            },
            "firstIndex" : {
                "description" : "Index of the first Mesh Neighbor AP returned out of the complete Mesh Neighbor AP list",
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "mac" : {
                            "type" : "string",
                            "pattern" : "^([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F])$",
                            "description" : "MAC address of the mesh neighbor AP"
                        },
                        "name" : {
                            "description" : "Name of the mesh neighbor AP",
                            "type" : "string"
                        },
                        "zoneName" : {
                            "description" : "Name of the zone which the mesh neighbor AP belongs to",
                            "type" : "string"
                        },
                        "ip" : {
                            "description" : "IP address of the mesh neighbor AP",
                            "type" : "string"
                        },
                        "externalIp" : {
                            "description" : "External IP of the mesh neighbor AP ",
                            "type" : "string"
                        },
                        "externalPort" : {
                            "description" : "External port of the mesh neighbor AP ",
                            "type" : "string"
                        },
                        "model" : {
                            "description" : "Model of the mesh neighbor AP ",
                            "type" : "string"
                        },
                        "version" : {
                            "description" : "Firmware version of the mesh neighbor AP ",
                            "type" : "string"
                        },
                        "channel" : {
                            "description" : "Channel of the mesh neighbor AP ",
                            "type" : "string"
                        },
                        "signal" : {
                            "description" : "Signal of the mesh neighbor AP ",
                            "type" : "string"
                        },
                        "connectionState" : {
                            "description" : "Connection state of the mesh neighbor AP ",
                            "type" : "string"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve Rogue AP List 

/v4_0/rogueaps

Use this API command to retrieve a list of rogue access points.

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

    type
    string (optional) 

    Filter rogue ap list by type. Valid values are: (ROGUE, MALICIOUS_AP_SSID_SPOOF, MALICIOUS_AP_MAC_SPOOF, MALICIOUS_AP_SAME_NETWORK, AD_HOC).

    rogueMac
    string (optional) 

    Filter rogue ap list by Rogue MAC.

  • Response  200
  • Body
    {
        "totalCount" : 1,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "apMac" : "C4:10:8A:1F:D3:99",
            "apName" : "apName",
            "rogueMac" : "8C:0C:90:05:87:B8",
            "rogueAPMac" : "01:01:03:04:05:10",
            "rssi" : "10DB",
            "encryption" : "0",
            "radio" : "2.4G",
            "type" : "ROGUE",
            "channel" : "11",
            "ssid" : "test",
            "timestamp" : null,
            "id" : "C4:10:8A:1F:D3:99_8C:0C:90:05:87:B8"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "description" : "Total Rogue APs count",
                "type" : "integer"
            },
            "hasMore" : {
                "description" : "Indicator of whether there are more Rogue AP after the current displayed list",
                "type" : "boolean"
            },
            "firstIndex" : {
                "description" : "Index of the first Rogue AP returned out of the complete Rogue AP list",
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the rogue AP",
                            "type" : "string"
                        },
                        "apMac" : {
                            "type" : "string",
                            "pattern" : "^([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F])$",
                            "description" : "AP MAC of the rogue AP"
                        },
                        "apName" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 64,
                            "pattern" : "^[!-~]((?!\$\()[ -_a-~]){0,62}[!-~]$",
                            "description" : "Name of the rogue AP"
                        },
                        "rogueMac" : {
                            "type" : "string",
                            "pattern" : "^([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F])$",
                            "description" : "Rogue MAC of the rogue AP"
                        },
                        "rogueAPMac" : {
                            "type" : "string",
                            "pattern" : "^([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F])$",
                            "description" : "Rogue AP MAC of the rogue AP"
                        },
                        "rssi" : {
                            "description" : "RSSI of the rogue AP",
                            "type" : "string"
                        },
                        "encryption" : {
                            "description" : "Encryption of the rogue AP",
                            "type" : "string"
                        },
                        "radio" : {
                            "description" : "Radio of the rogue AP",
                            "type" : "string"
                        },
                        "type" : {
                            "description" : "Type of the rogue AP",
                            "type" : "string"
                        },
                        "channel" : {
                            "description" : "Channel of the rogue AP",
                            "type" : "string"
                        },
                        "ssid" : {
                            "description" : "SSID of the rogue AP",
                            "type" : "string"
                        },
                        "timestamp" : {
                            "description" : "Timestamp of the rogue AP",
                            "type" : "string"
                        }
                    }
                }
            }
        }
    }
    
    

WLAN Group 

Retrieve List 

/v4_0/rkszones/{zoneId}/wlangroups

Use this API command to retrieve the list of WLAN groups within a zone.

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

  • Response  200
  • Body
    {
        "totalCount" : 2,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "wlanGroupUUID",
            "name" : "wlanGroupName",
            "description" : "wlanGroupDescription",
            "members" : [ {
                "id" : "wlanUUID",
                "accessVlan" : 1,
                "nasId" : "nasId",
                "vlanPooling" : null
            } ]
        }, {
            "id" : "wlanGroupUUID2",
            "zoneId" : "zoneUUID",
            "name" : "wlanGroupName2",
            "description" : "wlanGroupDescription2",
            "members" : [ {
                "id" : "wlanUUID2",
                "accessVlan" : 1,
                "nasId" : "nasId",
                "vlanPooling" : null
            } ]
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the WLAN group",
                            "type" : "string"
                        },
                        "zoneId" : {
                            "description" : "Identifier of the zone to which the WLAN group belongs",
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the WLAN group"
                        },
                        "description" : {
                            "type" : [ "string", "null" ],
                            "maxLength" : 64,
                            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                            "description" : "Description of the WLAN group"
                        },
                        "members" : {
                            "description" : "Members of the WLAN group",
                            "type" : "array",
                            "items" : {
                                "type" : "object",
                                "additionalProperties" : false,
                                "properties" : {
                                    "id" : {
                                        "description" : "Identifier of the WLAN",
                                        "type" : "string"
                                    },
                                    "accessVlan" : {
                                        "description" : "Access VLAN",
                                        "type" : "integer",
                                        "minimum" : 1,
                                        "maximum" : 4094
                                    },
                                    "vlanPooling" : {
                                        "type" : [ "object", "null" ],
                                        "additionalProperties" : false,
                                        "properties" : {
                                            "id" : {
                                                "type" : "string"
                                            },
                                            "name" : {
                                                "type" : "string"
                                            }
                                        },
                                        "description" : "Vlan pooling"
                                    },
                                    "nasId" : {
                                        "description" : "NAS-ID",
                                        "type" : "string",
                                        "maxLength" : 63,
                                        "pattern" : "^([!-~]([ -~]){0,61}[!-~]|[!-~]{1,1})$"
                                    }
                                },
                                "required" : [ "id" ]
                            }
                        }
                    },
                    "required" : [ "name" ]
                }
            }
        }
    }
    
    

Retrieve 

/v4_0/rkszones/{zoneId}/wlangroups/{id}

Use this API command to retrieve the WLAN group.

  • Response  200
  • Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the WLAN group",
                "type" : "string"
            },
            "zoneId" : {
                "description" : "Identifier of the zone to which the WLAN group belongs",
                "type" : "string"
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the WLAN group"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the WLAN group"
            },
            "members" : {
                "description" : "Members of the WLAN group",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the WLAN",
                            "type" : "string"
                        },
                        "accessVlan" : {
                            "description" : "Access VLAN",
                            "type" : "integer",
                            "minimum" : 1,
                            "maximum" : 4094
                        },
                        "vlanPooling" : {
                            "type" : [ "object", "null" ],
                            "additionalProperties" : false,
                            "properties" : {
                                "id" : {
                                    "type" : "string"
                                },
                                "name" : {
                                    "type" : "string"
                                }
                            },
                            "description" : "Vlan pooling"
                        },
                        "nasId" : {
                            "description" : "NAS-ID",
                            "type" : "string",
                            "maxLength" : 63,
                            "pattern" : "^([!-~]([ -~]){0,61}[!-~]|[!-~]{1,1})$"
                        }
                    },
                    "required" : [ "id" ]
                }
            }
        },
        "required" : [ "name" ]
    }
    
    

Create 

/v4_0/rkszones/{zoneId}/wlangroups

Use this API command to create a new WLAN group.

  • Request
  • Body
    {
        "name" : "wlanGroupName",
        "description" : "wlanGroupDescription"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the WLAN group"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the WLAN group"
            }
        },
        "required" : [ "name" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "wlanGroupUUID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the WLAN group",
                "type" : "string"
            }
        }
    }
    
    

Modify Basic 

/v4_0/rkszones/{zoneId}/wlangroups/{id}

Use this API command to modify the basic information of a WLAN group.

  • Request
  • Body
    {
        "name" : "wlanGroupNameModified",
        "description" : "wlanGroupDescriptionModified"
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Name of the WLAN group"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Description of the WLAN group"
        }
    }
    
    
  • Response  204

Add Member 

/v4_0/rkszones/{zoneId}/wlangroups/{id}/members

Use this API command to add a member to a WLAN group.

  • Request
  • Body
    {
        "id" : "wlanUUID",
        "accessVlan" : 1
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the WLAN",
                "type" : "string"
            },
            "accessVlan" : {
                "description" : "Access VLAN",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 4094
            },
            "vlanPooling" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Vlan pooling"
            },
            "nasId" : {
                "description" : "NAS-ID",
                "type" : "string",
                "maxLength" : 63,
                "pattern" : "^([!-~]([ -~]){0,61}[!-~]|[!-~]{1,1})$"
            }
        },
        "required" : [ "id" ]
    }
    
    
  • Response  201

Modify Member 

/v4_0/rkszones/{zoneId}/wlangroups/{id}/members/{memberId}

Use this API command to modify a member of a WLAN group.

  • Request
  • Body
    {
        "accessVlan" : 23,
        "nasId" : "nasId"
    }
    
    
    Schema
    {
        "accessVlan" : {
            "description" : "Access VLAN",
            "type" : "integer",
            "minimum" : 1,
            "maximum" : 4094
        },
        "nasId" : {
            "description" : "NAS-ID",
            "type" : "string",
            "maxLength" : 63,
            "pattern" : "^([!-~]([ -~]){0,61}[!-~]|[!-~]{1,1})$"
        }
    }
    
    
  • Response  204

Modify Member VLAN Pooling 

/v4_0/rkszones/{zoneId}/wlangroups/{id}/members/{memberId}/vlanPooling

Use this API command to modify a member’s VLAN pooling of a WLAN group.

  • Request
  • Body
    {
        "id" : "a61997e0-699b-11e4-b9bb-08002716c79f",
        "name" : "zoneVlanPooling"
    }
    
    
    Schema
    {
        "type" : [ "object", "null" ],
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            },
            "name" : {
                "type" : "string"
            }
        },
        "description" : "Vlan pooling"
    }
    
    
  • Response  204

Disable Member VLAN Override 

/v4_0/rkszones/{zoneId}/wlangroups/{id}/members/{memberId}/vlanOverride

Use this API command to disable a member VLAN override of a WLAN group.

  • Response  204

Disable Member NAS Override 

/v4_0/rkszones/{zoneId}/wlangroups/{id}/members/{memberId}/nasId

Use this API command to disable a member NAS-ID override of a WLAN group.

  • Response  204

Remove Member 

/v4_0/rkszones/{zoneId}/wlangroups/{id}/members/{memberId}

Use this API command to remove a member from a WLAN group.

  • Response  204

Delete 

/v4_0/rkszones/{zoneId}/wlangroups/{id}

Use this API command to delete a WLAN group.

  • Response  204

WLAN 

Retrieve List 

/v4_0/rkszones/{zoneId}/wlans

Use this API command to retrieve a list of WLANs within a zone.

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

  • Response  200
  • Body
    {
        "totalCount" : 2,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "1028",
            "name" : "wlan2",
            "ssid" : "wlan2"
        }, {
            "id" : "1027",
            "zoneId" : "21a18b1c-e260-48c8-866c-69e66c81368e",
            "name" : "wlan1",
            "ssid" : "wlan1"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the WLAN",
                            "type" : "string"
                        },
                        "mvnoId" : {
                            "description" : "Tenant UUID",
                            "type" : "string"
                        },
                        "name" : {
                            "description" : "Name of the WLAN",
                            "type" : "string"
                        },
                        "ssid" : {
                            "description" : "SSID of the WLAN",
                            "type" : "string"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve 

/v4_0/rkszones/{zoneId}/wlans/{id}

Use this API command to retrieve a WLAN.

  • Response  200
  • Body
    {
        "id" : "1027",
        "zoneId" : "21a18b1c-e260-48c8-866c-69e66c81368e",
        "name" : "wlan1",
        "ssid" : "wlan1",
        "description" : "",
        "type" : "Standard_Open",
        "encryption" : {
            "method" : "None"
        },
        "macAuth" : null,
        "authServiceOrProfile" : null,
        "operatorRealm" : null,
        "accountingServiceOrProfile" : {
            "id" : "",
            "name" : null,
            "throughController" : false,
            "interimUpdateMin" : null,
            "accountingTTGSessionEnabled" : false,
            "accountingDelayEnabled" : null
        },
        "accessTunnelType" : "APLBO",
        "coreTunnelProfile" : null,
        "portalServiceProfile" : null,
        "hotspot20Profile" : null,
        "defaultUserTrafficProfile" : {
            "id" : "24f24c00-0b47-11e4-a9b5-000c29b1347d",
            "name" : "Factory Default"
        },
        "l2ACL" : null,
        "devicePolicy" : null,
        "vlan" : {
            "accessVlan" : 1,
            "aaaVlanOverride" : false
        },
        "schedule" : {
            "id" : null,
            "name" : null,
            "type" : "AlwaysOn"
        },
        "radiusOptions" : {
            "nasIdType" : "WLAN_BSSID",
            "customizedNasId" : null,
            "nasRequestTimeoutSec" : 3,
            "nasMaxRetry" : 2,
            "nasReconnectPrimaryMin" : 5,
            "calledStaIdType" : "WLAN_BSSID"
        },
        "advancedOptions" : {
            "uplinkRateLimiting" : "Disable",
            "downlinkRateLimiting" : "Disable",
            "clientIsolcationEnabled" : false,
            "priority" : "High",
            "hideSsidEnabled" : true,
            "clientLoadBalancingEnabled" : true,
            "proxyARPEnabled" : false,
            "dgafEnabled" : null,
            "maxClientsPerRadio" : 100,
            "support80211dEnabled" : false,
            "support80211kEnabled" : true,
            "forceDHCPEnabled" : false,
            "forceClientDHCPTimeout" : 10,
            "dhcpOption82Enabled" : false,
            "dhcp82Format" : "RUCKUS_DEFAULT",
            "unauthClientStatsEnabled" : false,
            "clientIdleTimeoutSec" : 120,
            "clientFingerprintingEnabled" : false,
            "ofdmOnlyEnabled" : false,
            "bssMinRateMbps" : "Disable",
            "mgmtTxRateMbps" : "2 mbps",
            "avcEnabled" : true,
            "avcDenialPolicyDisabled" : false,
            "avcDenialPolicy" : {
                "id" : "ba7b3fb0-f2fb-11e4-b680-80fa5b024259"
            },
            "bandBalancing" : "UseZoneSetting"
        },
        "qosMaps" : [ {
            "enable" : true,
            "priority" : 0,
            "low" : 0,
            "high" : 7,
            "excepts" : null
        }, {
            "enable" : true,
            "priority" : 1,
            "low" : 8,
            "high" : 15,
            "excepts" : null
        }, {
            "enable" : true,
            "priority" : 2,
            "low" : 16,
            "high" : 23,
            "excepts" : null
        }, {
            "enable" : true,
            "priority" : 3,
            "low" : 0,
            "high" : 32,
            "excepts" : [ 43, 45, 60 ]
        }, {
            "enable" : true,
            "priority" : 4,
            "low" : 32,
            "high" : 39,
            "excepts" : null
        }, {
            "enable" : true,
            "priority" : 5,
            "low" : 40,
            "high" : 47,
            "excepts" : null
        }, {
            "enable" : true,
            "priority" : 6,
            "low" : 48,
            "high" : 55,
            "excepts" : [ 46 ]
        }, {
            "enable" : true,
            "priority" : 7,
            "low" : 56,
            "high" : 63,
            "excepts" : null
        } ],
        "dpsk" : {
            "dpskEnabled" : true,
            "length" : 8,
            "dpskType" : "Secure",
            "expiration" : "OneDay",
            "dpskFromType" : "FirstUse"
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the WLAN",
                "type" : "string"
            },
            "zoneId" : {
                "description" : "Identifier of the zone to which the WLAN belongs",
                "type" : "string"
            },
            "name" : {
                "description" : "Name of the WLAN",
                "type" : "string"
            },
            "ssid" : {
                "description" : "SSID of the WLAN",
                "type" : "string"
            },
            "hessid" : {
                "type" : "string",
                "pattern" : "^(bssid|BSSID|([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F]))$",
                "description" : "HESSID of the WLAN"
            },
            "description" : {
                "description" : "Description of the WLAN",
                "type" : "string"
            },
            "type" : {
                "description" : "Type of the WLAN",
                "enum" : [ "Standard_Open", "Standard_80211", "Standard_Mac", "Hotspot", "Hotspot_MacByPass", "Guest", "WebAuth", "Hotspot20", "Hotspot20_OSEN" ]
            },
            "bypassCNA" : {
                "description" : "By pass Capitive Network Assitance",
                "type" : [ "boolean", "null" ]
            },
            "encryption" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "method" : {
                        "description" : "Encryption method",
                        "enum" : [ "WPA2", "WPA_Mixed", "WEP_64", "WEP_128", "None" ]
                    },
                    "algorithm" : {
                        "description" : "Encryption algorithm. This only applies to WPA2 and WPA mixed mode.",
                        "enum" : [ "AES", "TKIP_AES" ]
                    },
                    "passphrase" : {
                        "description" : "Passphrase. This only applies to WPA2 and WPA mixed mode.",
                        "type" : "string"
                    },
                    "mfp" : {
                        "description" : "Management frame protection. This only applies to WPA2 + AES",
                        "enum" : [ "disabled", "capable", "required" ]
                    },
                    "keyIndex" : {
                        "description" : "Key index. This only applies to WEP64 and WEP128.",
                        "type" : "integer"
                    },
                    "keyInHex" : {
                        "description" : "Key in hex format. This only applies to WEP64 and WEP128.",
                        "type" : "string"
                    },
                    "support80211rEnabled" : {
                        "description" : "Enable 802.11r Fast BSS Transition, fast Romaing.",
                        "type" : "boolean"
                    },
                    "mobilityDomainId" : {
                        "description" : "mobility Domain Id.",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 65535
                    }
                },
                "required" : [ "method" ],
                "description" : "Encryption of the WLAN"
            },
            "authServiceOrProfile" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "throughController" : {
                        "description" : "Indicates whether authentication messages were sent through the controller or not",
                        "type" : "boolean"
                    },
                    "id" : {
                        "description" : "Identifier of the authentication service or profile. At least one ID or name is required in the request.",
                        "type" : "string"
                    },
                    "name" : {
                        "description" : "Name of the authentication service or profile. At least one ID or name is required in the request.",
                        "type" : "string"
                    },
                    "locationDeliveryEnabled" : {
                        "description" : "RFC5580 location delivery support",
                        "type" : "boolean"
                    }
                },
                "description" : "Autentication of the WLAN"
            },
            "operatorRealm" : {
                "type" : "string",
                "maxLength" : 255,
                "pattern" : "^$|^([!-~]([ -~]){0,253}[!-~]|[!-~]{1,1})$",
                "description" : "Operator realm, operatorRealm only supports coreTunnelProfile type is PMIP or authServiceOrProfile.locationDeliveryEnabled is true "
            },
            "macAuth" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "macAuthMacFormat" : {
                        "description" : "MAC address format. The default format is 0010a42319c0 and the 802.1X format is 00-10-A4-23-19-C0.",
                        "enum" : [ "Default", "802.1X", "UpperColon", "Upper", "LowerDash", "LowerColon" ]
                    },
                    "customizedPassword" : {
                        "description" : "User defined password. When this field is set to an empty string, the MAC address is used as password.",
                        "type" : "string",
                        "maxLength" : 64,
                        "pattern" : "^([!-;=?-~]([ -;=?-~]){0,62}[!-;=?-~]|[!-;=?-~]{1,1}|\s{0,0})$"
                    }
                },
                "description" : "MAC authentication of the WLAN"
            },
            "accountingServiceOrProfile" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "throughController" : {
                        "description" : "Indicates whether accounting messages were sent through the controller",
                        "type" : "boolean"
                    },
                    "id" : {
                        "description" : "Accounting service or profile ID. At least one ID or name is required in the request.",
                        "type" : "string"
                    },
                    "name" : {
                        "description" : "Accounting service or profile name. At least one ID or name is required in the request.",
                        "type" : "string"
                    },
                    "interimUpdateMin" : {
                        "description" : "Interval (in minutes) for sending interim updates",
                        "type" : "integer",
                        "minimum" : 0,
                        "maximum" : 1440
                    },
                    "accountingDelayEnabled" : {
                        "description" : "Indicates whether accounting delay time is enabled",
                        "type" : "boolean"
                    },
                    "accountingTTGSessionEnabled" : {
                        "description" : "Indicates whether accounting for TTG sessions is to enabled",
                        "type" : "boolean"
                    }
                },
                "description" : "Accounting of the WLAN"
            },
            "accessTunnelType" : {
                "description" : "Access tunnel type of the WLAN. APLBO means AP local breakout, RuckusGRE means RuckusGRE tunnel to data plane, SoftGRE means AP direct SoftGRE tunnel",
                "enum" : [ "APLBO", "RuckusGRE", "SoftGRE" ]
            },
            "portalServiceProfile" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Portal service of the WLAN. This only applies to hotspot, hotspot MAC bypass, guest and web auth WLANs."
            },
            "hotspot20Profile" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Hotspot 2.0 operator profile of the WLAN. id or name of the hotspot 2.0 operator profiles within the zone is required."
            },
            "defaultUserTrafficProfile" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "User traffic profile of the WLAN"
            },
            "coreTunnelProfile" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "type" : {
                        "description" : "Tunnel type",
                        "enum" : [ "Bridge" ]
                    },
                    "id" : {
                        "description" : "Identifier of the forwarding profile. At least one ID or name is required in the request.",
                        "type" : "string"
                    },
                    "name" : {
                        "description" : "Name of the forwarding profile. At least one ID or name is required in the request.",
                        "type" : "string"
                    }
                },
                "required" : [ "type" ],
                "description" : "Core tunnel of the WLAN. This only applies when the access tunnel type is set to RuckusGRE."
            },
            "vlan" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "accessVlan" : {
                        "description" : "Access VLAN ID",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 4094
                    },
                    "aaaVlanOverride" : {
                        "description" : "Indicates whether the AAA VLAN settings can be overriden or not",
                        "type" : "boolean"
                    },
                    "vlanPooling" : {
                        "type" : [ "object", "null" ],
                        "additionalProperties" : false,
                        "properties" : {
                            "id" : {
                                "type" : "string"
                            },
                            "name" : {
                                "type" : "string"
                            }
                        },
                        "description" : "Vlan pooling"
                    }
                },
                "description" : "VLAN (access and/or core) of the WLAN."
            },
            "l2ACL" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Layer 2 ACL of the WLAN"
            },
            "devicePolicy" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Device policy of the WLAN"
            },
            "radiusOptions" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "nasIdType" : {
                        "description" : "NAS ID type",
                        "enum" : [ "WLAN_BSSID", "AP_MAC", "Customized" ],
                        "default" : "WLAN_BSSID"
                    },
                    "customizedNasId" : {
                        "description" : "User defined NAS ID",
                        "type" : "string",
                        "maxLength" : 63,
                        "pattern" : "^([!-~]([ -~]){0,61}[!-~]|[!-~]{1,1})$"
                    },
                    "nasRequestTimeoutSec" : {
                        "description" : "NAS request timeout in seconds",
                        "type" : "integer",
                        "default" : 3,
                        "minimum" : 2,
                        "maximum" : 20
                    },
                    "nasMaxRetry" : {
                        "description" : "NAS request maximum retry",
                        "type" : "integer",
                        "default" : 2,
                        "minimum" : 2,
                        "maximum" : 10
                    },
                    "nasReconnectPrimaryMin" : {
                        "description" : "NAS reconnect primary time in minutes",
                        "type" : "integer",
                        "default" : 5,
                        "minimum" : 1,
                        "maximum" : 60
                    },
                    "calledStaIdType" : {
                        "description" : "Called station ID type",
                        "enum" : [ "WLAN_BSSID", "AP_MAC" ],
                        "default" : "WLAN_BSSID"
                    }
                },
                "description" : "RADIUS options of the WLAN."
            },
            "schedule" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "type" : {
                        "description" : "Type of WLAN schedule",
                        "enum" : [ "AlwaysOn", "AlwaysOff", "Customized" ]
                    },
                    "id" : {
                        "description" : "Identifier of the schedule profile. At least one ID or name is required in the request.",
                        "type" : "string"
                    },
                    "name" : {
                        "description" : "Name of the schedule profile. At least one ID or name is required in the request.",
                        "type" : "string"
                    }
                },
                "required" : [ "type" ],
                "description" : "Schedule of the WLAN."
            },
            "advancedOptions" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "clientIsolationEnabled" : {
                        "description" : "Indicates whether wireless client isolation is enabled or disabled",
                        "type" : "boolean",
                        "default" : true
                    },
                    "priority" : {
                        "description" : "Priority of the WLAN",
                        "enum" : [ "High", "Low" ],
                        "default" : "High"
                    },
                    "hideSsidEnabled" : {
                        "description" : "Indicates whether the SSID is hidden or broadcast",
                        "type" : "boolean",
                        "default" : false
                    },
                    "maxClientsPerRadio" : {
                        "description" : "Maximum number of clients per radio",
                        "type" : "integer",
                        "default" : 100,
                        "minimum" : 1,
                        "maximum" : 512
                    },
                    "clientIdleTimeoutSec" : {
                        "description" : "Client idle timeout in seconds",
                        "type" : "integer",
                        "minimum" : 60,
                        "maximum" : 1000,
                        "default" : 120
                    },
                    "dgafEnabled" : {
                        "description" : "Indicates whether dgaf is enabled or disabled",
                        "type" : "boolean"
                    },
                    "clientLoadBalancingEnabled" : {
                        "description" : "Indicates whether Client Load Balancing is enabled or disabled",
                        "type" : "boolean"
                    },
                    "proxyARPEnabled" : {
                        "description" : "Indicates whether proxy ARP is enabled or disabled",
                        "type" : "boolean",
                        "default" : false
                    },
                    "support80211dEnabled" : {
                        "description" : "Indicates whether support for 802.11d is enabled or disabled",
                        "type" : "boolean",
                        "default" : false
                    },
                    "support80211kEnabled" : {
                        "description" : "Indicates whether support for 802.11k is enabled or disabled",
                        "type" : "boolean",
                        "default" : true
                    },
                    "forceClientDHCPTimeoutSec" : {
                        "description" : "Force DHCP disconnects the client if the client does not obtain a valid IP address within the timeout peroid. To disable force DHCP, set this value to zero (0).",
                        "enum" : [ 0, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ],
                        "default" : 0
                    },
                    "dhcpOption82Enabled" : {
                        "description" : "Indicates whether DCHP Option 82 is enabled or disabled",
                        "type" : "boolean",
                        "default" : false
                    },
                    "dhcp82Format" : {
                        "description" : "DHCP Option 82 format",
                        "enum" : [ "RUCKUS_DEFAULT", "SOFTGRE_CUSTOMIZED" ]
                    },
                    "unauthClientStatsEnabled" : {
                        "description" : "Indicates whether to send statistics of unauthorized clients or not",
                        "type" : "boolean",
                        "default" : true
                    },
                    "clientFingerprintingEnabled" : {
                        "description" : "Indicates whether client fingerprinting is enabled or disabled",
                        "type" : "boolean",
                        "default" : false
                    },
                    "ofdmOnlyEnabled" : {
                        "description" : "Indicates whether OFDM only is enabled or disabled",
                        "type" : "boolean",
                        "default" : false
                    },
                    "bandBalancing" : {
                        "description" : "Indicates whether band balancing is enabled or disabled",
                        "enum" : [ "Disabled", "UseZoneSetting" ],
                        "default" : "UseZoneSetting"
                    },
                    "bssMinRateMbps" : {
                        "enum" : [ "Disable", "1 mbps", "2 mbps", "5.5 mbps", "12 mbps", "24 mbps" ],
                        "description" : "BSS minimum rate (mbps)"
                    },
                    "mgmtTxRateMbps" : {
                        "enum" : [ "1 mbps", "2 mbps", "5.5 mbps", "6 mbps", "9 mbps", "11 mbps", "12 mbps", "18 mbps", "24 mbps", "36 mbps", "48 mbps", "54 mbps" ],
                        "description" : "Management TX rate (mbps)"
                    },
                    "pmkCachingEnabled" : {
                        "description" : "Indicator of whether PKM caching support is enabled or disabled",
                        "type" : "boolean",
                        "default" : false
                    },
                    "okcEnabled" : {
                        "description" : "Indicator of whether OKC support is enabled or disabled",
                        "type" : "boolean",
                        "default" : false
                    },
                    "avcEnabled" : {
                        "description" : "Indicator of whether AVC support is enabled or disabled",
                        "type" : "boolean",
                        "default" : false
                    },
                    "avcDenialPolicyDisabled" : {
                        "description" : "Indicator of whether AVC Denial Policy Profile is enabled or disabled",
                        "type" : "boolean",
                        "default" : true
                    },
                    "avcDenialPolicy" : {
                        "type" : [ "object", "null" ],
                        "additionalProperties" : false,
                        "properties" : {
                            "id" : {
                                "type" : "string"
                            },
                            "name" : {
                                "type" : "string"
                            }
                        },
                        "description" : "AVC Denial Policy Profile"
                    },
                    "uplinkEnabled" : {
                        "description" : "SSID Rate Limiting uplink enabled.",
                        "type" : "boolean",
                        "default" : false
                    },
                    "uplinkRate" : {
                        "description" : "SSID Rate Limiting uplink.",
                        "type" : "number"
                    },
                    "downlinkEnabled" : {
                        "description" : "SSID Rate Limiting downlink enabled.",
                        "type" : "boolean",
                        "default" : false
                    },
                    "downlinkRate" : {
                        "description" : "SSID Rate Limiting downlink.",
                        "type" : "number"
                    }
                },
                "description" : "Advanced settings for the WLAN."
            },
            "diffServProfile" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "DiffServ profile of the WLAN"
            },
            "qosMaps" : {
                "description" : "Qos map set of the WLAN.",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "enable" : {
                            "description" : "Enabled or disabled",
                            "type" : "boolean"
                        },
                        "priority" : {
                            "description" : "Priority",
                            "type" : "integer"
                        },
                        "low" : {
                            "description" : "DSCP range - low",
                            "type" : [ "integer", "null" ],
                            "minimum" : 0,
                            "maximum" : 255
                        },
                        "high" : {
                            "description" : "DSCP range - high",
                            "type" : [ "integer", "null" ],
                            "minimum" : 0,
                            "maximum" : 255
                        },
                        "excepts" : {
                            "type" : [ "array", "null" ],
                            "items" : {
                                "type" : "integer",
                                "minimum" : 0,
                                "maximum" : 63
                            }
                        }
                    },
                    "required" : [ "enable", "priority" ]
                }
            },
            "dpsk" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "dpskEnabled" : {
                        "description" : "DPSK enabled",
                        "type" : "boolean",
                        "default" : false
                    },
                    "length" : {
                        "description" : "Length of DPSK key",
                        "type" : "integer"
                    },
                    "dpskType" : {
                        "description" : "Type of DPSK key",
                        "enum" : [ "Secure", "KeyboardFriendly" ]
                    },
                    "expiration" : {
                        "description" : "Expiration of DPSK key",
                        "enum" : [ "Unlimited", "OneDay", "TwoDays", "OneWeek", "TwoWeeks", "OneMonth", "SixMonths", "OneYear", "TwoYears" ]
                    },
                    "dpskFromType" : {
                        "description" : "Type of expiration start from",
                        "enum" : [ "CreateTime", "FirstUse" ]
                    }
                },
                "description" : "DPSK Setting"
            },
            "dnsServerProfile" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "DNS server profile of the WLAN"
            }
        }
    }
    
    

Create - Standard Open 

/v4_0/rkszones/{zoneId}/wlans

Use this API command to create a new standard, open and non-tunneled basic WLAN.

  • Request
  • Body
    {
        "name" : "wlanName",
        "ssid" : "wlanSSID",
        "description" : "wlanDescription"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "description" : "Name of the WLAN"
            },
            "ssid" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "description" : "SSID of the WLAN"
            },
            "hessid" : {
                "type" : "string",
                "pattern" : "^(bssid|BSSID|([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F]))$",
                "description" : "HESSID of the WLAN"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the WLAN"
            }
        },
        "required" : [ "name", "ssid" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "wlanUUID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            }
        }
    }
    
    

Create - 802.1X 

/v4_0/rkszones/{zoneId}/wlans/standard80211

Use this API command to create a new standard, 802.1X and non-tunneled WLAN.

  • Request
  • Body
    {
        "name" : "wlanName",
        "ssid" : "wlanSSID",
        "description" : "wlanDescription",
        "authServiceOrProfile" : {
            "throughController" : false,
            "id" : "authServiceUUID",
            "name" : "authServiceName"
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "description" : "Name of the WLAN"
            },
            "ssid" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "description" : "SSID of the WLAN"
            },
            "hessid" : {
                "type" : "string",
                "pattern" : "^(bssid|BSSID|([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F]))$",
                "description" : "HESSID of the WLAN"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the WLAN"
            },
            "authServiceOrProfile" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "throughController" : {
                        "description" : "Indicates whether authentication messages were sent through the controller or not",
                        "type" : "boolean"
                    },
                    "id" : {
                        "description" : "Identifier of the authentication service or profile. At least one ID or name is required in the request.",
                        "type" : "string"
                    },
                    "name" : {
                        "description" : "Name of the authentication service or profile. At least one ID or name is required in the request.",
                        "type" : "string"
                    },
                    "locationDeliveryEnabled" : {
                        "description" : "RFC5580 location delivery support",
                        "type" : "boolean"
                    }
                },
                "description" : "Authentication of the WLAN. If authentication messages are sent through the controller, the ID or name of the global authentication profiles is required. If authentication messages are not sent through the controller, the ID or name of the authentication services configured within the zone is required."
            }
        },
        "required" : [ "name", "ssid", "authServiceOrProfile" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "wlanUUID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            }
        }
    }
    
    

Create - MAC Auth 

/v4_0/rkszones/{zoneId}/wlans/standardmac

Use this API command to create a new standard, MAC auth and non-tunneled WLAN.

  • Request
  • Body
    {
        "name" : "wlanName",
        "ssid" : "wlanSSID",
        "description" : "wlanDescription",
        "authServiceOrProfile" : {
            "throughController" : false,
            "id" : "authServiceUUID",
            "name" : "authServiceName"
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "description" : "Name of the WLAN"
            },
            "ssid" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "description" : "SSID of the WLAN"
            },
            "hessid" : {
                "type" : "string",
                "pattern" : "^(bssid|BSSID|([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F]))$",
                "description" : "HESSID of the WLAN"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the WLAN"
            },
            "authServiceOrProfile" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "throughController" : {
                        "description" : "Indicates whether authentication messages were sent through the controller or not",
                        "type" : "boolean"
                    },
                    "id" : {
                        "description" : "Identifier of the authentication service or profile. At least one ID or name is required in the request.",
                        "type" : "string"
                    },
                    "name" : {
                        "description" : "Name of the authentication service or profile. At least one ID or name is required in the request.",
                        "type" : "string"
                    },
                    "locationDeliveryEnabled" : {
                        "description" : "RFC5580 location delivery support",
                        "type" : "boolean"
                    }
                },
                "description" : "Authentication of the WLAN. If authentication messages are sent through the controller, the ID or name of the global authentication profiles is required. If authentication messages are not sent through the controller, the ID or name of the authentication services configured within the zone is required."
            }
        },
        "required" : [ "name", "ssid", "authServiceOrProfile" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "wlanUUID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            }
        }
    }
    
    

Create - Hotspot 

/v4_0/rkszones/{zoneId}/wlans/wispr

Use this API command to create new hotspot (WISPr) WLAN.

  • Request
  • Body
    {
        "name" : "wlanName",
        "ssid" : "wlanSSID",
        "description" : "wlanDescription",
        "authServiceOrProfile" : {
            "throughController" : false,
            "id" : "authServiceUUID",
            "name" : "authServiceName"
        },
        "portalServiceProfile" : {
            "id" : "portalServiceUUID",
            "name" : "portalServiceName"
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "description" : "Name of the WLAN"
            },
            "ssid" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "description" : "SSID of the WLAN"
            },
            "hessid" : {
                "type" : "string",
                "pattern" : "^(bssid|BSSID|([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F]))$",
                "description" : "HESSID of the WLAN"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the WLAN"
            },
            "authServiceOrProfile" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "throughController" : {
                        "description" : "Indicates whether authentication messages were sent through the controller or not",
                        "type" : "boolean"
                    },
                    "id" : {
                        "description" : "Identifier of the authentication service or profile. At least one ID or name is required in the request.",
                        "type" : "string"
                    },
                    "name" : {
                        "description" : "Name of the authentication service or profile. At least one ID or name is required in the request.",
                        "type" : "string"
                    },
                    "locationDeliveryEnabled" : {
                        "description" : "RFC5580 location delivery support",
                        "type" : "boolean"
                    }
                },
                "description" : "Authentication of the WLAN. The hotspot WLAN requires authentication messages to be sent through the controller. The ID or name of the authentication services configured globally is required."
            },
            "portalServiceProfile" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Hotspot portal service of the WLAN. The ID or name of the hotspot portal services within the zone is required."
            }
        },
        "required" : [ "name", "ssid", "authServiceOrProfile", "portalServiceProfile" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "wlanUUID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            }
        }
    }
    
    

Create - Hotspot + MAC bypass 

/v4_0/rkszones/{zoneId}/wlans/wisprmac

Use this API command to create a new hotspot (WISPr) with MAC bypass WLAN.

  • Request
  • Body
    {
        "name" : "wlanName",
        "ssid" : "wlanSSID",
        "description" : "wlanDescription",
        "authServiceOrProfile" : {
            "throughController" : false,
            "id" : "authServiceUUID",
            "name" : "authServiceName"
        },
        "portalServiceProfile" : {
            "id" : "portalServiceUUID",
            "name" : "portalServiceName"
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "description" : "Name of the WLAN"
            },
            "ssid" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "description" : "SSID of the WLAN"
            },
            "hessid" : {
                "type" : "string",
                "pattern" : "^(bssid|BSSID|([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F]))$",
                "description" : "HESSID of the WLAN"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the WLAN"
            },
            "authServiceOrProfile" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "throughController" : {
                        "description" : "Indicates whether authentication messages were sent through the controller or not",
                        "type" : "boolean"
                    },
                    "id" : {
                        "description" : "Identifier of the authentication service or profile. At least one ID or name is required in the request.",
                        "type" : "string"
                    },
                    "name" : {
                        "description" : "Name of the authentication service or profile. At least one ID or name is required in the request.",
                        "type" : "string"
                    },
                    "locationDeliveryEnabled" : {
                        "description" : "RFC5580 location delivery support",
                        "type" : "boolean"
                    }
                },
                "description" : "Authentication of the WLAN. The hotspot WLAN requires authentication messages to be sent through the controller. The ID or name of the authentication services configured globally is required."
            },
            "portalServiceProfile" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Hotspot portal service of the WLAN. The ID or name of the hotspot portal services within the zone is required."
            }
        },
        "required" : [ "name", "ssid", "authServiceOrProfile", "portalServiceProfile" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "wlanUUID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            }
        }
    }
    
    

Create - Guest Access 

/v4_0/rkszones/{zoneId}/wlans/guest

Use this API command to create a new guest access WLAN.

  • Request
  • Body
    {
        "name" : "wlanName",
        "ssid" : "wlanSSID",
        "description" : "wlanDescription",
        "authServiceOrProfile" : {
            "throughController" : false,
            "id" : "authServiceUUID",
            "name" : "authServiceName"
        },
        "portalServiceProfile" : {
            "id" : "portalServiceUUID",
            "name" : "portalServiceName"
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "description" : "Name of the WLAN"
            },
            "ssid" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "description" : "SSID of the WLAN"
            },
            "hessid" : {
                "type" : "string",
                "pattern" : "^(bssid|BSSID|([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F]))$",
                "description" : "HESSID of the WLAN"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the WLAN"
            },
            "authServiceOrProfile" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "throughController" : {
                        "description" : "Indicates whether authentication messages were sent through the controller or not",
                        "type" : "boolean"
                    },
                    "id" : {
                        "description" : "Identifier of the authentication service or profile. At least one ID or name is required in the request.",
                        "type" : "string"
                    },
                    "name" : {
                        "description" : "Name of the authentication service or profile. At least one ID or name is required in the request.",
                        "type" : "string"
                    },
                    "locationDeliveryEnabled" : {
                        "description" : "RFC5580 location delivery support",
                        "type" : "boolean"
                    }
                },
                "description" : "Authentication of the WLAN. Guest WLANs only accept two names: Local DB and Always Accept."
            },
            "portalServiceProfile" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Guest portal service of the WLAN. The ID or name of the guest portal services within the zone is required."
            }
        },
        "required" : [ "name", "ssid", "authServiceOrProfile", "portalServiceProfile" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "wlanUUID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            }
        }
    }
    
    

Create - Web Auth 

/v4_0/rkszones/{zoneId}/wlans/webauth

Use this API command to creates new web authentication WLAN.

  • Request
  • Body
    {
        "name" : "wlanName",
        "ssid" : "wlanSSID",
        "description" : "wlanDescription",
        "authServiceOrProfile" : {
            "throughController" : false,
            "id" : "authServiceUUID",
            "name" : "authServiceName"
        },
        "portalServiceProfile" : {
            "id" : "portalServiceUUID",
            "name" : "portalServiceName"
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "description" : "Name of the WLAN"
            },
            "ssid" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "description" : "SSID of the WLAN"
            },
            "hessid" : {
                "type" : "string",
                "pattern" : "^(bssid|BSSID|([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F]))$",
                "description" : "HESSID of the WLAN"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the WLAN"
            },
            "authServiceOrProfile" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "throughController" : {
                        "description" : "Indicates whether authentication messages were sent through the controller or not",
                        "type" : "boolean"
                    },
                    "id" : {
                        "description" : "Identifier of the authentication service or profile. At least one ID or name is required in the request.",
                        "type" : "string"
                    },
                    "name" : {
                        "description" : "Name of the authentication service or profile. At least one ID or name is required in the request.",
                        "type" : "string"
                    },
                    "locationDeliveryEnabled" : {
                        "description" : "RFC5580 location delivery support",
                        "type" : "boolean"
                    }
                },
                "description" : "Authentication of the WLAN. If authentication messages are sent through the controller, the ID or name of the global authentication profiles is required. If authentication messages are not sent through the controller, the ID or name of the authentication services configured within the zone is required."
            },
            "portalServiceProfile" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Web authorizationn portal service of the WLAN. The ID or name of the guest portal services within the zone is required."
            }
        },
        "required" : [ "name", "ssid", "authServiceOrProfile", "portalServiceProfile" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "wlanUUID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            }
        }
    }
    
    

Create - Hotspot 2.0 

/v4_0/rkszones/{zoneId}/wlans/hotspot20

Use this API command to create a new Hotspot 2.0 access WLAN.

  • Request
  • Body
    {
        "name" : "wlanName",
        "ssid" : "wlanSSID",
        "description" : "wlanDescription",
        "hotspot20Profile" : {
            "id" : "hotspot20ServiceUUID",
            "name" : "hotspot20ServiceName"
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "description" : "Name of the WLAN"
            },
            "ssid" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "description" : "SSID of the WLAN"
            },
            "hessid" : {
                "type" : "string",
                "pattern" : "^(bssid|BSSID|([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F]))$",
                "description" : "HESSID of the WLAN"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the WLAN"
            },
            "hotspot20Profile" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Hotspot 2.0 operator profile of the WLAN. The ID or name of the Hotspot 2.0 operator profiles within the zone is required."
            }
        },
        "required" : [ "name", "ssid", "hotspot20Profile" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "wlanUUID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            }
        }
    }
    
    

Create - Hotspot 2.0 OSEN 

/v4_0/rkszones/{zoneId}/wlans/hotspot20osen

Use this API command to create a new Hotspot 2.0 Secure Online Signup WLAN.

  • Request
  • Body
    {
        "name" : "api-test-wlanhs20osen",
        "ssid" : "api-test-wlanhs20osen",
        "description" : "wlanDescription"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "description" : "Name of the WLAN"
            },
            "ssid" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "description" : "SSID of the WLAN"
            },
            "hessid" : {
                "type" : "string",
                "pattern" : "^(bssid|BSSID|([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F]))$",
                "description" : "HESSID of the WLAN"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the WLAN"
            }
        },
        "required" : [ "name", "ssid" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "wlanUUID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            }
        }
    }
    
    

Create - Wechat 

/v4_0/rkszones/{zoneId}/wlans/wechat

Use this API command to create a new wechat WLAN.

  • Request
  • Body
    {
        "name" : "wlanName",
        "ssid" : "wlanSSID",
        "description" : "wlanDescription",
        "portalServiceProfile" : {
            "id" : "portalServiceUUID",
            "name" : "portalServiceName"
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "description" : "Name of the WLAN"
            },
            "ssid" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "description" : "SSID of the WLAN"
            },
            "hessid" : {
                "type" : "string",
                "pattern" : "^(bssid|BSSID|([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F]))$",
                "description" : "HESSID of the WLAN"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the WLAN"
            },
            "portalServiceProfile" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Wechat portal service of the WLAN. The ID or name of the wechat portal services within the zone is required."
            }
        },
        "required" : [ "name", "ssid", "portalServiceProfile" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "wlanUUID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            }
        }
    }
    
    

Modify Basic 

/v4_0/rkszones/{zoneId}/wlans/{id}

Use this API command to modify the basic information of a WLAN.

  • Request
  • Body
    {
        "name" : "wlanName",
        "ssid" : "wlanSSID",
        "description" : "wlanDescription",
        "accessTunnelType" : "RuckusGRE",
        "operatorRealm" : "operator realm"
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "description" : "Name of the WLAN"
        },
        "ssid" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "description" : "SSID of the WLAN"
        },
        "hessid" : {
            "type" : "string",
            "pattern" : "^(bssid|BSSID|([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F]))$",
            "description" : "HESSID of the WLAN"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Description of the WLAN"
        },
        "bypassCNA" : {
            "description" : "By pass Capitive Network Assitance",
            "type" : [ "boolean", "null" ]
        },
        "accessTunnelType" : {
            "description" : "Access tunnel type of the WLAN. APLBO means AP local breakout, RuckusGRE means RuckusGRE tunnel to the data plane, and SoftGRE means AP direct SoftGRE tunnel",
            "enum" : [ "APLBO", "RuckusGRE", "SoftGRE" ]
        },
        "operatorRealm" : {
            "type" : "string",
            "maxLength" : 255,
            "pattern" : "^$|^([!-~]([ -~]){0,253}[!-~]|[!-~]{1,1})$",
            "description" : "Operator realm, operatorRealm only supports coreTunnelProfile type is PMIP or authServiceOrProfile.locationDeliveryEnabled is true "
        }
    }
    
    
  • Response  204

Modify Authentication 

/v4_0/rkszones/{zoneId}/wlans/{id}/authServiceOrProfile

Use this API command to modify the authentication method of a WLAN.

  • Request
  • Body
    {
        "throughController" : true,
        "id" : "authServiceUUID",
        "locationDeliveryEnabled" : true
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "throughController" : {
                "description" : "Indicates whether authentication messages were sent through the controller or not",
                "type" : "boolean"
            },
            "id" : {
                "description" : "Identifier of the authentication service or profile. At least one ID or name is required in the request.",
                "type" : "string"
            },
            "name" : {
                "description" : "Name of the authentication service or profile. At least one ID or name is required in the request.",
                "type" : "string"
            },
            "locationDeliveryEnabled" : {
                "description" : "RFC5580 location delivery support",
                "type" : "boolean"
            }
        },
        "description" : "Authentication of the WLAN"
    }
    
    
  • Response  204

Modify MAC Auth 

/v4_0/rkszones/{zoneId}/wlans/{id}/macAuth

Use this API command to modify the MAC authentication settings of a WLAN.macAuthMacFormat : Open(aabbccddeeff), 802.1X(AA-BB-CC-DD-EE-FF), UpperColon (AA:BB:CC:DD:EE:FF), Upper (AABBCCDDEEFF), LowerDash (aa-bb-cc-dd-ee-ff) and LowerColon (aa:bb:cc:dd:ee:ff)

  • Request
  • Body
    {
        "macAuthMacFormat" : "802.1X",
        "customizedPassword" : "password"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "macAuthMacFormat" : {
                "description" : "MAC address format. The default format is 0010a42319c0 and the 802.1X format is 00-10-A4-23-19-C0.",
                "enum" : [ "Default", "802.1X", "UpperColon", "Upper", "LowerDash", "LowerColon" ]
            },
            "customizedPassword" : {
                "description" : "User defined password. When this field is set to an empty string, the MAC address is used as password.",
                "type" : "string",
                "maxLength" : 64,
                "pattern" : "^([!-;=?-~]([ -;=?-~]){0,62}[!-;=?-~]|[!-;=?-~]{1,1}|\s{0,0})$"
            }
        },
        "description" : "MAC address authentication settings of the WLAN. This only applies to standard MAC and Hotspot MAC bypass WLAN."
    }
    
    
  • Response  204

Modify Accounting 

/v4_0/rkszones/{zoneId}/wlans/{id}/accountingServiceOrProfile

Use this API command to modify the accounting settings of a WLAN.

  • Request
  • Body
    {
        "throughController" : false,
        "id" : "accountingServiceUUID",
        "name" : "accountingServiceName",
        "interimUpdateMin" : 10,
        "accountingDelayEnabled" : false,
        "accountingTTGSessionEnabled" : false
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "throughController" : {
                "description" : "Indicates whether accounting messages were sent through the controller",
                "type" : "boolean"
            },
            "id" : {
                "description" : "Accounting service or profile ID. At least one ID or name is required in the request.",
                "type" : "string"
            },
            "name" : {
                "description" : "Accounting service or profile name. At least one ID or name is required in the request.",
                "type" : "string"
            },
            "interimUpdateMin" : {
                "description" : "Interval (in minutes) for sending interim updates",
                "type" : "integer",
                "minimum" : 0,
                "maximum" : 1440
            },
            "accountingDelayEnabled" : {
                "description" : "Indicates whether accounting delay time is enabled",
                "type" : "boolean"
            },
            "accountingTTGSessionEnabled" : {
                "description" : "Indicates whether accounting for TTG sessions is to enabled",
                "type" : "boolean"
            }
        },
        "description" : "Accounting of the WLAN"
    }
    
    
  • Response  204

Disable Accounting 

/v4_0/rkszones/{zoneId}/wlans/{id}/accountingServiceOrProfile

Use this API command to disable the accounting of a WLAN.

  • Response  204

Modify Encryption 

/v4_0/rkszones/{zoneId}/wlans/{id}/encryption

Use this API command to modify the encryption settings of a WLAN.

  • Request
  • Body
    {
        "method" : "WPA2",
        "algorithm" : "AES",
        "passphrase" : "password",
        "mfp" : "disabled",
        "support80211rEnabled" : true,
        "mobilityDomainId" : 3
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "method" : {
                "description" : "Encryption method",
                "enum" : [ "WPA2", "WPA_Mixed", "WEP_64", "WEP_128", "None" ]
            },
            "algorithm" : {
                "description" : "Encryption algorithm. This only applies to WPA2 and WPA mixed mode.",
                "enum" : [ "AES", "TKIP_AES" ]
            },
            "passphrase" : {
                "description" : "Passphrase. This only applies to WPA2 and WPA mixed mode.",
                "type" : "string"
            },
            "mfp" : {
                "description" : "Management frame protection. This only applies to WPA2 + AES",
                "enum" : [ "disabled", "capable", "required" ]
            },
            "keyIndex" : {
                "description" : "Key index. This only applies to WEP64 and WEP128.",
                "type" : "integer"
            },
            "keyInHex" : {
                "description" : "Key in hex format. This only applies to WEP64 and WEP128.",
                "type" : "string"
            },
            "support80211rEnabled" : {
                "description" : "Enable 802.11r Fast BSS Transition, fast Romaing.",
                "type" : "boolean"
            },
            "mobilityDomainId" : {
                "description" : "mobility Domain Id.",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 65535
            }
        },
        "required" : [ "method" ],
        "description" : "Encryption of the WLAN"
    }
    
    
  • Response  204

Modify Core Tunnel 

/v4_0/rkszones/{zoneId}/wlans/{id}/coreTunnelProfile

Use this API command to modify the core tunnel configuration of a WLAN.

  • Request
  • Body
    {
        "type" : "Bridge",
        "id" : "forwardingUUID",
        "name" : "forwardingName"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "type" : {
                "description" : "Tunnel type",
                "enum" : [ "Bridge" ]
            },
            "id" : {
                "description" : "Identifier of the forwarding profile. At least one ID or name is required in the request.",
                "type" : "string"
            },
            "name" : {
                "description" : "Name of the forwarding profile. At least one ID or name is required in the request.",
                "type" : "string"
            }
        },
        "required" : [ "type" ],
        "description" : "Core tunnel of the WLAN. This only applies when the access tunnel type is set to RuckusGRE."
    }
    
    
  • Response  204

Modify Portal Profile 

/v4_0/rkszones/{zoneId}/wlans/{id}/portalServiceProfile

Use this API command to modify the portal configuration of a WLAN.

  • Request
  • Body
    {
        "id" : "portalServiceUUID",
        "name" : "portalServiceName"
    }
    
    
    Schema
    {
        "type" : [ "object", "null" ],
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            },
            "name" : {
                "type" : "string"
            }
        },
        "description" : "Portal service of the WLAN. This only applies to hotspot, hotspot MAC bypass, guest and web auth WLANs."
    }
    
    
  • Response  204

Modify Hotspot20 Profile 

/v4_0/rkszones/{zoneId}/wlans/{id}/hotspot20Profile

Use this API command to modify the Hotspot 2.0 profile configuration of a WLAN.

  • Request
  • Body
    {
        "id" : "hotspot20ServiceUUID",
        "name" : "hotspot20ServiceName"
    }
    
    
    Schema
    {
        "type" : [ "object", "null" ],
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            },
            "name" : {
                "type" : "string"
            }
        },
        "description" : "Hotspot 2.0 operator profile of the WLAN. id or name of the hotspot 2.0 operator profiles within the zone is required."
    }
    
    
  • Response  204

Modify User Traffic Profile 

/v4_0/rkszones/{zoneId}/wlans/{id}/defaultUserTrafficProfile

Use this API command to modify the user traffic profile configuration of a WLAN.

  • Request
  • Body
    {
        "id" : "userTrafficUUID",
        "name" : "userTrafficName"
    }
    
    
    Schema
    {
        "type" : [ "object", "null" ],
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            },
            "name" : {
                "type" : "string"
            }
        },
        "description" : "User traffic profile of the WLAN"
    }
    
    
  • Response  204

Modify Schedule 

/v4_0/rkszones/{zoneId}/wlans/{id}/schedule

Use this API command to modify the schedule configuration of a WLAN.

  • Request
  • Body
    {
        "type" : "Customized",
        "id" : "ServiceUUID",
        "name" : "ServiceName"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "type" : {
                "description" : "Type of WLAN schedule",
                "enum" : [ "AlwaysOn", "AlwaysOff", "Customized" ]
            },
            "id" : {
                "description" : "Identifier of the schedule profile. At least one ID or name is required in the request.",
                "type" : "string"
            },
            "name" : {
                "description" : "Name of the schedule profile. At least one ID or name is required in the request.",
                "type" : "string"
            }
        },
        "required" : [ "type" ],
        "description" : "Schedule of the WLAN"
    }
    
    
  • Response  204

Modify VLAN 

/v4_0/rkszones/{zoneId}/wlans/{id}/vlan

Use this API command to modify the VLAN configuration of a WLAN.

  • Request
  • Body
    {
        "accessVlan" : 23,
        "aaaVlanOverride" : true
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "accessVlan" : {
                "description" : "Access VLAN ID",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 4094
            },
            "aaaVlanOverride" : {
                "description" : "Indicates whether the AAA VLAN settings can be overriden or not",
                "type" : "boolean"
            },
            "vlanPooling" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Vlan pooling"
            }
        },
        "description" : "VLAN (access and/or core) of the WLAN."
    }
    
    
  • Response  204

Modify Layer 2 ACL 

/v4_0/rkszones/{zoneId}/wlans/{id}/l2ACL

Use this API command to modify the layer 2 access control list (ACL) configuration of a WLAN.

  • Request
  • Body
    {
        "id" : "l2ACLUUID",
        "name" : "l2ACLName"
    }
    
    
    Schema
    {
        "type" : [ "object", "null" ],
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            },
            "name" : {
                "type" : "string"
            }
        },
        "description" : "Layer 2 ACL of the WLAN"
    }
    
    
  • Response  204

Disable Layer 2 ACL 

/v4_0/rkszones/{zoneId}/wlans/{id}/l2ACL

Use this API command to disable the layer 2 access control list (ACL) configuration of a WLAN.

  • Response  204

Modify Device Policy 

/v4_0/rkszones/{zoneId}/wlans/{id}/devicePolicy

Use this API command to modify the device policy of a WLAN.

  • Request
  • Body
    {
        "id" : "devicePolicyUUID",
        "name" : "devicePolicyName"
    }
    
    
    Schema
    {
        "type" : [ "object", "null" ],
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            },
            "name" : {
                "type" : "string"
            }
        },
        "description" : "Device policy of the WLAN"
    }
    
    
  • Response  204

Disable Device Policy 

/v4_0/rkszones/{zoneId}/wlans/{id}/devicePolicy

Use this API command to disable the device policy of a WLAN.

  • Response  204

Modify RADIUS Options 

/v4_0/rkszones/{zoneId}/wlans/{id}/radiusOptions

Use this API command to modify the RADIUS settings of a WLAN.

  • Request
  • Body
    {
        "nasIdType" : "Customized",
        "customizedNasId" : "nasId",
        "nasRequestTimeoutSec" : 12,
        "nasMaxRetry" : 3,
        "nasReconnectPrimaryMin" : 30,
        "calledStaIdType" : "WLAN_BSSID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "nasIdType" : {
                "description" : "NAS ID type",
                "enum" : [ "WLAN_BSSID", "AP_MAC", "Customized" ],
                "default" : "WLAN_BSSID"
            },
            "customizedNasId" : {
                "description" : "User defined NAS ID",
                "type" : "string",
                "maxLength" : 63,
                "pattern" : "^([!-~]([ -~]){0,61}[!-~]|[!-~]{1,1})$"
            },
            "nasRequestTimeoutSec" : {
                "description" : "NAS request timeout in seconds",
                "type" : "integer",
                "default" : 3,
                "minimum" : 2,
                "maximum" : 20
            },
            "nasMaxRetry" : {
                "description" : "NAS request maximum retry",
                "type" : "integer",
                "default" : 2,
                "minimum" : 2,
                "maximum" : 10
            },
            "nasReconnectPrimaryMin" : {
                "description" : "NAS reconnect primary time in minutes",
                "type" : "integer",
                "default" : 5,
                "minimum" : 1,
                "maximum" : 60
            },
            "calledStaIdType" : {
                "description" : "Called station ID type",
                "enum" : [ "WLAN_BSSID", "AP_MAC" ],
                "default" : "WLAN_BSSID"
            }
        },
        "description" : "RADIUS options of the WLAN"
    }
    
    
  • Response  204

Modify Advanced Options 

/v4_0/rkszones/{zoneId}/wlans/{id}/advancedOptions

Use this API command to modify the advanced settings of a WLAN.

  • Request
  • Body
    {
        "clientIsolationEnabled" : false,
        "priority" : "High",
        "hideSsidEnabled" : true,
        "maxClientsPerRadio" : 12,
        "clientIdleTimeoutSec" : 12,
        "clientLoadBalancingEnabled" : true,
        "proxyARPEnabled" : true,
        "support80211dEnabled" : false,
        "support80211kEnabled" : true,
        "forceDHCPEnabled" : false,
        "forceClientDHCPTimeout" : 21,
        "dhcpOption82Enabled" : true,
        "dhcp82Format" : "RUCKUS_DEFAULT",
        "unauthClientStatsEnabled" : false,
        "clientFingerprintingEnabled" : true,
        "ofdmOnlyEnabled" : false,
        "bandBalancing" : "UseZoneSetting",
        "bssMinRateMbps" : "Disable",
        "mgmtTxRateMbps" : "2 mbps",
        "uplinkRateLimiting" : "Disable",
        "downlinkRateLimiting" : "Disable",
        "avcEnabled" : true,
        "avcDenialPolicyDisabled" : false,
        "avcDenialPolicy" : {
            "id" : "ba7b3fb0-f2fb-11e4-b680-80fa5b024259"
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "clientIsolationEnabled" : {
                "description" : "Indicates whether wireless client isolation is enabled or disabled",
                "type" : "boolean",
                "default" : true
            },
            "priority" : {
                "description" : "Priority of the WLAN",
                "enum" : [ "High", "Low" ],
                "default" : "High"
            },
            "hideSsidEnabled" : {
                "description" : "Indicates whether the SSID is hidden or broadcast",
                "type" : "boolean",
                "default" : false
            },
            "maxClientsPerRadio" : {
                "description" : "Maximum number of clients per radio",
                "type" : "integer",
                "default" : 100,
                "minimum" : 1,
                "maximum" : 512
            },
            "clientIdleTimeoutSec" : {
                "description" : "Client idle timeout in seconds",
                "type" : "integer",
                "minimum" : 60,
                "maximum" : 1000,
                "default" : 120
            },
            "dgafEnabled" : {
                "description" : "Indicates whether dgaf is enabled or disabled",
                "type" : "boolean"
            },
            "clientLoadBalancingEnabled" : {
                "description" : "Indicates whether Client Load Balancing is enabled or disabled",
                "type" : "boolean"
            },
            "proxyARPEnabled" : {
                "description" : "Indicates whether proxy ARP is enabled or disabled",
                "type" : "boolean",
                "default" : false
            },
            "support80211dEnabled" : {
                "description" : "Indicates whether support for 802.11d is enabled or disabled",
                "type" : "boolean",
                "default" : false
            },
            "support80211kEnabled" : {
                "description" : "Indicates whether support for 802.11k is enabled or disabled",
                "type" : "boolean",
                "default" : true
            },
            "forceClientDHCPTimeoutSec" : {
                "description" : "Force DHCP disconnects the client if the client does not obtain a valid IP address within the timeout peroid. To disable force DHCP, set this value to zero (0).",
                "enum" : [ 0, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 ],
                "default" : 0
            },
            "dhcpOption82Enabled" : {
                "description" : "Indicates whether DCHP Option 82 is enabled or disabled",
                "type" : "boolean",
                "default" : false
            },
            "dhcp82Format" : {
                "description" : "DHCP Option 82 format",
                "enum" : [ "RUCKUS_DEFAULT", "SOFTGRE_CUSTOMIZED" ]
            },
            "unauthClientStatsEnabled" : {
                "description" : "Indicates whether to send statistics of unauthorized clients or not",
                "type" : "boolean",
                "default" : true
            },
            "clientFingerprintingEnabled" : {
                "description" : "Indicates whether client fingerprinting is enabled or disabled",
                "type" : "boolean",
                "default" : false
            },
            "ofdmOnlyEnabled" : {
                "description" : "Indicates whether OFDM only is enabled or disabled",
                "type" : "boolean",
                "default" : false
            },
            "bandBalancing" : {
                "description" : "Indicates whether band balancing is enabled or disabled",
                "enum" : [ "Disabled", "UseZoneSetting" ],
                "default" : "UseZoneSetting"
            },
            "bssMinRateMbps" : {
                "enum" : [ "Disable", "1 mbps", "2 mbps", "5.5 mbps", "12 mbps", "24 mbps" ],
                "description" : "BSS minimum rate (mbps)"
            },
            "mgmtTxRateMbps" : {
                "enum" : [ "1 mbps", "2 mbps", "5.5 mbps", "6 mbps", "9 mbps", "11 mbps", "12 mbps", "18 mbps", "24 mbps", "36 mbps", "48 mbps", "54 mbps" ],
                "description" : "Management TX rate (mbps)"
            },
            "pmkCachingEnabled" : {
                "description" : "Indicator of whether PKM caching support is enabled or disabled",
                "type" : "boolean",
                "default" : false
            },
            "okcEnabled" : {
                "description" : "Indicator of whether OKC support is enabled or disabled",
                "type" : "boolean",
                "default" : false
            },
            "avcEnabled" : {
                "description" : "Indicator of whether AVC support is enabled or disabled",
                "type" : "boolean",
                "default" : false
            },
            "avcDenialPolicyDisabled" : {
                "description" : "Indicator of whether AVC Denial Policy Profile is enabled or disabled",
                "type" : "boolean",
                "default" : true
            },
            "avcDenialPolicy" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "AVC Denial Policy Profile"
            },
            "uplinkEnabled" : {
                "description" : "SSID Rate Limiting uplink enabled.",
                "type" : "boolean",
                "default" : false
            },
            "uplinkRate" : {
                "description" : "SSID Rate Limiting uplink.",
                "type" : "number"
            },
            "downlinkEnabled" : {
                "description" : "SSID Rate Limiting downlink enabled.",
                "type" : "boolean",
                "default" : false
            },
            "downlinkRate" : {
                "description" : "SSID Rate Limiting downlink.",
                "type" : "number"
            }
        },
        "description" : "Advanced settings for the WLAN."
    }
    
    
  • Response  204

Modify DiffServ Profile 

/v4_0/rkszones/{zoneId}/wlans/{id}/diffServProfile

Use this API command to modify the DiffServ profile of a WLAN.

  • Request
  • Body
    {
        "id" : "diffServId",
        "name" : "diffServName"
    }
    
    
    Schema
    {
        "type" : [ "object", "null" ],
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            },
            "name" : {
                "type" : "string"
            }
        },
        "description" : "DiffServ profile of the WLAN"
    }
    
    
  • Response  204

Disable DiffServ Profile 

/v4_0/rkszones/{zoneId}/wlans/{id}/diffServProfile

Use this API command to disable the DiffServ profile of a WLAN.

  • Response  204

Enable Qos Map Set 

/v4_0/rkszones/{zoneId}/wlans/{id}/qosMaps

Use this API command to enable Qos Map Set of a WLAN.

  • Response  201

Modify Qos Map Set 

/v4_0/rkszones/{zoneId}/wlans/{id}/qosMaps

Use this API command to modify Qos Map Set of a WLAN.

  • Request
  • Body
    [ {
        "enable" : true,
        "priority" : 0,
        "low" : 0,
        "high" : 7,
        "excepts" : null
    }, {
        "enable" : true,
        "priority" : 1,
        "low" : 8,
        "high" : 15,
        "excepts" : null
    }, {
        "enable" : true,
        "priority" : 2,
        "low" : 16,
        "high" : 23,
        "excepts" : null
    }, {
        "enable" : true,
        "priority" : 3,
        "low" : 0,
        "high" : 32,
        "excepts" : [ 43, 45, 60 ]
    }, {
        "enable" : true,
        "priority" : 4,
        "low" : 32,
        "high" : 39,
        "excepts" : null
    }, {
        "enable" : true,
        "priority" : 5,
        "low" : 40,
        "high" : 47,
        "excepts" : null
    }, {
        "enable" : true,
        "priority" : 6,
        "low" : 48,
        "high" : 55,
        "excepts" : [ 46 ]
    }, {
        "enable" : true,
        "priority" : 7,
        "low" : 56,
        "high" : 63,
        "excepts" : null
    } ]
    
    
    Schema
    {
        "description" : "Qos map set of the WLAN.",
        "type" : "array",
        "items" : {
            "type" : "object",
            "additionalProperties" : false,
            "properties" : {
                "enable" : {
                    "description" : "Enabled or disabled",
                    "type" : "boolean"
                },
                "priority" : {
                    "description" : "Priority",
                    "type" : "integer"
                },
                "low" : {
                    "description" : "DSCP range - low",
                    "type" : [ "integer", "null" ],
                    "minimum" : 0,
                    "maximum" : 255
                },
                "high" : {
                    "description" : "DSCP range - high",
                    "type" : [ "integer", "null" ],
                    "minimum" : 0,
                    "maximum" : 255
                },
                "excepts" : {
                    "type" : [ "array", "null" ],
                    "items" : {
                        "type" : "integer",
                        "minimum" : 0,
                        "maximum" : 63
                    }
                }
            },
            "required" : [ "enable", "priority" ]
        }
    }
    
    
  • Response  204

Disable Qos Map Set 

/v4_0/rkszones/{zoneId}/wlans/{id}/qosMaps

Use this API command to disable Qos Map Set of a WLAN.

  • Response  204

Delete 

/v4_0/rkszones/{zoneId}/wlans/{id}

Use this API command to delete a WLAN.

  • Response  204

Modify DNS server profile 

/v4_0/rkszones/{zoneId}/wlans/{id}/dnsServerProfile

Use this API command to modify DNS server profile of a WLAN.

  • Request
  • Schema
    {
        "type" : [ "object", "null" ],
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            },
            "name" : {
                "type" : "string"
            }
        },
        "description" : "DNS server profile of the WLAN"
    }
    
    
  • Response  204

Disable DNS server profile 

/v4_0/rkszones/{zoneId}/wlans/{id}/dnsServerProfile

Use this API command to disable DNS server profile of a WLAN.

  • Response  204

Modify DPSK Setting 

/v4_0/rkszones/{zoneId}/wlans/{id}/dpsk

Use this API command to modify DPSK setting of a WLAN.

  • Request
  • Body
    {
        "dpskEnabled" : true,
        "length" : 8,
        "dpskType" : "Secure",
        "expiration" : "OneDay",
        "dpskFromType" : "FirstUse"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "dpskEnabled" : {
                "description" : "DPSK enabled",
                "type" : "boolean",
                "default" : false
            },
            "length" : {
                "description" : "Length of DPSK key",
                "type" : "integer"
            },
            "dpskType" : {
                "description" : "Type of DPSK key",
                "enum" : [ "Secure", "KeyboardFriendly" ]
            },
            "expiration" : {
                "description" : "Expiration of DPSK key",
                "enum" : [ "Unlimited", "OneDay", "TwoDays", "OneWeek", "TwoWeeks", "OneMonth", "SixMonths", "OneYear", "TwoYears" ]
            },
            "dpskFromType" : {
                "description" : "Type of expiration start from",
                "enum" : [ "CreateTime", "FirstUse" ]
            }
        },
        "description" : "DPSK Setting"
    }
    
    
  • Response  204

WLAN Scheduler 

Retrieve List 

/v4_0/rkszones/{zoneId}/wlanSchedulers

Use this API command to retrieve the list of WLAN schedule from a zone.

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

  • Response  200
  • Body
    {
        "totalCount" : 2,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "wlanSchedulerUUID",
            "name" : "wlanSchedulerName",
            "description" : "wlanSchedulerDescription",
            "sun" : [ "00:15-01:15", "07:00-08:30", "10:45-12:00" ],
            "mon" : [ "00:15-01:15" ],
            "tue" : [ "00:15-01:15" ],
            "wed" : [ "00:15-01:15" ],
            "thu" : [ "00:15-01:15" ],
            "fri" : [ "00:15-01:15" ],
            "sat" : [ "00:15-01:15" ]
        }, {
            "id" : "wlanSchedulerUUID2",
            "name" : "wlanSchedulerName2",
            "description" : "wlanSchedulerDescription2",
            "sun" : [ "00:15-01:15" ],
            "mon" : [ "00:15-01:15" ],
            "tue" : [ "00:15-01:15" ],
            "wed" : [ "00:15-01:15", "07:00-08:30", "10:45-12:00" ],
            "thu" : [ "00:15-01:15" ],
            "fri" : [ "00:15-01:15" ],
            "sat" : [ "00:15-01:15" ]
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the WLAN schedule",
                            "type" : "string"
                        },
                        "zoneId" : {
                            "description" : "Identifier of the zone to which the WLAN schedule belongs",
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the WLAN schedule"
                        },
                        "description" : {
                            "type" : [ "string", "null" ],
                            "maxLength" : 64,
                            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                            "description" : "Description of the WLAN schedule"
                        },
                        "sun" : {
                            "description" : "Schedules on Sunday",
                            "type" : "array",
                            "items" : {
                                "type" : "string"
                            }
                        },
                        "mon" : {
                            "description" : "Schedules on Monday",
                            "type" : "array",
                            "items" : {
                                "type" : "string"
                            }
                        },
                        "tue" : {
                            "description" : "Schedules on Tuesday",
                            "type" : "array",
                            "items" : {
                                "type" : "string"
                            }
                        },
                        "wed" : {
                            "description" : "Schedules on Wednesday",
                            "type" : "array",
                            "items" : {
                                "type" : "string"
                            }
                        },
                        "thu" : {
                            "description" : "Schedules on Thursday",
                            "type" : "array",
                            "items" : {
                                "type" : "string"
                            }
                        },
                        "fri" : {
                            "description" : "Schedules on Friday",
                            "type" : "array",
                            "items" : {
                                "type" : "string"
                            }
                        },
                        "sat" : {
                            "description" : "Schedules on Saturday",
                            "type" : "array",
                            "items" : {
                                "type" : "string"
                            }
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve 

/v4_0/rkszones/{zoneId}/wlanSchedulers/{id}

Use this API command to retrieve a WLAN schedule.

  • Response  200
  • Body
    {
        "id" : "wlanSchedulerUUID",
        "zoneId" : "zoneUUID",
        "name" : "wlanSchedulerName",
        "description" : "wlanSchedulerDescription",
        "sun" : [ "00:15-01:15", "07:00-08:30", "10:45-12:00" ],
        "mon" : [ "00:15-01:15" ],
        "tue" : [ "00:15-01:15" ],
        "wed" : [ "00:15-01:15" ],
        "thu" : [ "00:15-01:15" ],
        "fri" : [ "00:15-01:15" ],
        "sat" : [ "00:15-01:15" ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the WLAN schedule",
                "type" : "string"
            },
            "zoneId" : {
                "description" : "Identifier of the zone to which the WLAN schedule belongs",
                "type" : "string"
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the WLAN schedule"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the WLAN schedule"
            },
            "sun" : {
                "description" : "Schedules on Sunday",
                "type" : "array",
                "items" : {
                    "type" : "string"
                }
            },
            "mon" : {
                "description" : "Schedules on Monday",
                "type" : "array",
                "items" : {
                    "type" : "string"
                }
            },
            "tue" : {
                "description" : "Schedules on Tuesday",
                "type" : "array",
                "items" : {
                    "type" : "string"
                }
            },
            "wed" : {
                "description" : "Schedules on Wednesday",
                "type" : "array",
                "items" : {
                    "type" : "string"
                }
            },
            "thu" : {
                "description" : "Schedules on Thursday",
                "type" : "array",
                "items" : {
                    "type" : "string"
                }
            },
            "fri" : {
                "description" : "Schedules on Friday",
                "type" : "array",
                "items" : {
                    "type" : "string"
                }
            },
            "sat" : {
                "description" : "Schedules on Saturday",
                "type" : "array",
                "items" : {
                    "type" : "string"
                }
            }
        }
    }
    
    

Create 

/v4_0/rkszones/{zoneId}/wlanSchedulers

Use this API command to create a new WLAN schedule.

  • Request
  • Body
    {
        "name" : "wlanSchedulerName",
        "description" : "wlanSchedulerDescription",
        "sun" : [ "00:15-01:15", "07:00-08:30", "10:45-12:00" ],
        "mon" : [ "00:15-01:15" ],
        "tue" : [ "00:15-01:15" ],
        "wed" : [ "00:15-01:15" ],
        "thu" : [ "00:15-01:15" ],
        "fri" : [ "00:15-01:15" ],
        "sat" : [ "00:15-01:15" ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the WLAN schedule"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the WLAN schedule"
            },
            "sun" : {
                "description" : "Schedules on Sunday",
                "type" : "array",
                "items" : {
                    "type" : "string"
                }
            },
            "mon" : {
                "description" : "Schedules on Monday",
                "type" : "array",
                "items" : {
                    "type" : "string"
                }
            },
            "tue" : {
                "description" : "Schedules on Tuesday",
                "type" : "array",
                "items" : {
                    "type" : "string"
                }
            },
            "wed" : {
                "description" : "Schedules on Wednesday",
                "type" : "array",
                "items" : {
                    "type" : "string"
                }
            },
            "thu" : {
                "description" : "Schedules on Thursday",
                "type" : "array",
                "items" : {
                    "type" : "string"
                }
            },
            "fri" : {
                "description" : "Schedules on Friday",
                "type" : "array",
                "items" : {
                    "type" : "string"
                }
            },
            "sat" : {
                "description" : "Schedules on Saturday",
                "type" : "array",
                "items" : {
                    "type" : "string"
                }
            }
        },
        "required" : [ "name" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "wlanSchedulerUUID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the WLAN schedule",
                "type" : "string"
            }
        }
    }
    
    

Modify 

/v4_0/rkszones/{zoneId}/wlanSchedulers/{id}

Use this API command to modify a WLAN schedule.

  • Request
  • Body
    {
        "name" : "wlanSchedulerName",
        "description" : "wlanSchedulerDescription"
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Name of the WLAN schedule"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Description of the WLAN schedule"
        }
    }
    
    
  • Response  204

Delete 

/v4_0/rkszones/{zoneId}/wlanSchedulers/{id}

Use this API command to delete a WLAN schedule.

  • Response  204

Zone AAA 

Retrieve List - RADIUS 

/v4_0/rkszones/{zoneId}/aaa/radius

Use this API command to retrieve a list of radius servers of a zone.

  • Response  200
  • Body
    {
        "totalCount" : 1,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "authenticationServerUUID",
            "mvnoId" : "userMVNOId",
            "zoneId" : "zoneUUID",
            "name" : "authenticationServerName",
            "description" : "authenticationServerDescription",
            "primary" : {
                "ip" : "192.168.1.1",
                "port" : 1812,
                "sharedSecret" : "sharedSecret"
            },
            "secondary" : {
                "ip" : "192.168.1.2",
                "port" : 1812,
                "sharedSecret" : "sharedSecret"
            }
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the authentication server",
                            "type" : "string"
                        },
                        "zoneId" : {
                            "description" : "Identifier of the zone which the authentication server belongs to",
                            "type" : "string"
                        },
                        "mvnoId" : {
                            "description" : "Tenant UUID",
                            "type" : "string"
                        },
                        "name" : {
                            "description" : "Name of the authentication server",
                            "type" : "string"
                        },
                        "description" : {
                            "description" : "Description of the authentication server",
                            "type" : "string"
                        },
                        "primary" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                                "ip" : {
                                    "type" : "string",
                                    "description" : "Server IP"
                                },
                                "port" : {
                                    "description" : "Server port",
                                    "type" : "integer",
                                    "minimum" : 1,
                                    "maximum" : 65535
                                },
                                "sharedSecret" : {
                                    "description" : "Server shared secrect",
                                    "type" : "string"
                                }
                            },
                            "required" : [ "ip", "port", "sharedSecret" ],
                            "description" : "Primary RADIUS server"
                        },
                        "secondary" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                                "ip" : {
                                    "type" : "string",
                                    "description" : "Server IP"
                                },
                                "port" : {
                                    "description" : "Server port",
                                    "type" : "integer",
                                    "minimum" : 1,
                                    "maximum" : 65535
                                },
                                "sharedSecret" : {
                                    "description" : "Server shared secrect",
                                    "type" : "string"
                                }
                            },
                            "required" : [ "ip", "port", "sharedSecret" ],
                            "description" : "Secondary RADIUS server"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve - RADIUS 

/v4_0/rkszones/{zoneId}/aaa/radius/{id}

Use this API command to retrieve a radius server of a zone.

  • Response  200
  • Body
    {
        "id" : "authenticationServerUUID",
        "mvnoId" : "userMVNOId",
        "zoneId" : "zoneUUID",
        "name" : "authenticationServerName",
        "description" : "authenticationServerDescription",
        "primary" : {
            "ip" : "192.168.1.1",
            "port" : 1812,
            "sharedSecret" : "sharedSecret"
        },
        "secondary" : {
            "ip" : "192.168.1.2",
            "port" : 1812,
            "sharedSecret" : "sharedSecret"
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the authentication server",
                "type" : "string"
            },
            "zoneId" : {
                "description" : "Identifier of the zone which the authentication server belongs to",
                "type" : "string"
            },
            "mvnoId" : {
                "description" : "Tenant UUID",
                "type" : "string"
            },
            "name" : {
                "description" : "Name of the authentication server",
                "type" : "string"
            },
            "description" : {
                "description" : "Description of the authentication server",
                "type" : "string"
            },
            "primary" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "ip" : {
                        "type" : "string",
                        "description" : "Server IP"
                    },
                    "port" : {
                        "description" : "Server port",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 65535
                    },
                    "sharedSecret" : {
                        "description" : "Server shared secrect",
                        "type" : "string"
                    }
                },
                "required" : [ "ip", "port", "sharedSecret" ],
                "description" : "Primary RADIUS server"
            },
            "secondary" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "ip" : {
                        "type" : "string",
                        "description" : "Server IP"
                    },
                    "port" : {
                        "description" : "Server port",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 65535
                    },
                    "sharedSecret" : {
                        "description" : "Server shared secrect",
                        "type" : "string"
                    }
                },
                "required" : [ "ip", "port", "sharedSecret" ],
                "description" : "Secondary RADIUS server"
            }
        }
    }
    
    

Create - RADIUS 

/v4_0/rkszones/{zoneId}/aaa/radius

Use this API command to create a new radius server of a zone.

  • Request
  • Body
    {
        "name" : "authenticationServerName",
        "primary" : {
            "ip" : "192.168.1.1",
            "port" : 1812,
            "sharedSecret" : "sharedSecret"
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the authentication server"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the authentication server"
            },
            "primary" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "ip" : {
                        "type" : "string",
                        "description" : "Server IP"
                    },
                    "port" : {
                        "description" : "Server port",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 65535
                    },
                    "sharedSecret" : {
                        "description" : "Server shared secrect",
                        "type" : "string"
                    }
                },
                "required" : [ "ip", "port", "sharedSecret" ],
                "description" : "Primary RADIUS server"
            },
            "secondary" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "ip" : {
                        "type" : "string",
                        "description" : "Server IP"
                    },
                    "port" : {
                        "description" : "Server port",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 65535
                    },
                    "sharedSecret" : {
                        "description" : "Server shared secrect",
                        "type" : "string"
                    }
                },
                "required" : [ "ip", "port", "sharedSecret" ],
                "description" : "Secondary RADIUS server"
            }
        },
        "required" : [ "name", "primary" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "AAAServerUUID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            }
        }
    }
    
    

Modify - RADIUS 

/v4_0/rkszones/{zoneId}/aaa/radius/{id}

Use this API command to modify the basic information on radius server of a zone.

  • Request
  • Body
    {
        "name" : "authenticationServerName",
        "description" : "authenticationServerDescription"
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Name of the authentication server"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Description of the authentication server"
        }
    }
    
    
  • Response  204

Modify - Primary Server of RADIUS 

/v4_0/rkszones/{zoneId}/aaa/radius/{id}/primary

Use this API command to modify primary server on radius server of a zone.

  • Request
  • Body
    {
        "ip" : "192.168.1.1",
        "port" : 1812,
        "sharedSecret" : "abc"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "ip" : {
                "type" : "string",
                "description" : "Server IP"
            },
            "port" : {
                "description" : "Server port",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 65535
            },
            "sharedSecret" : {
                "description" : "Server shared secrect",
                "type" : "string"
            }
        },
        "required" : [ "ip", "port", "sharedSecret" ],
        "description" : "Primary RADIUS server"
    }
    
    
  • Response  204

Modify - Secondary Server of RADIUS 

/v4_0/rkszones/{zoneId}/aaa/radius/{id}/secondary

Use this API command to modify secondary server on radius server of a zone.

  • Request
  • Body
    {
        "ip" : "192.168.1.2",
        "port" : 1812,
        "sharedSecret" : "sharedSecret"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "ip" : {
                "type" : "string",
                "description" : "Server IP"
            },
            "port" : {
                "description" : "Server port",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 65535
            },
            "sharedSecret" : {
                "description" : "Server shared secrect",
                "type" : "string"
            }
        },
        "required" : [ "ip", "port", "sharedSecret" ],
        "description" : "Secondary RADIUS server"
    }
    
    
  • Response  204

Disable Secondary Server - RADIUS 

/v4_0/rkszones/{zoneId}/aaa/radius/{id}/secondary

Use this API command to disable secondary server on radius server of a zone.

  • Response  204

Delete - RADIUS 

/v4_0/rkszones/{zoneId}/aaa/radius/{id}

Use this API command to delete a radius server of a zone.

  • Response  204

Retrieve List - RADIUS Accounting 

/v4_0/rkszones/{zoneId}/aaa/accounting

Use this API command to retrieve a list of radius accounting servers of a zone.

  • Response  200
  • Body
    {
        "totalCount" : 1,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "accountingServerUUID",
            "mvnoId" : "userMVNOId",
            "zoneId" : "zoneUUID",
            "name" : "accountingServerName",
            "description" : "accountingServerDescription",
            "primary" : {
                "ip" : "192.168.1.1",
                "port" : 1813,
                "sharedSecret" : "sharedSecret"
            },
            "secondary" : {
                "ip" : "192.168.1.2",
                "port" : 1813,
                "sharedSecret" : "sharedSecret"
            }
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the accounting server",
                            "type" : "string"
                        },
                        "zoneId" : {
                            "description" : "Identifier of the zone which the accounting server belongs to",
                            "type" : "string"
                        },
                        "mvnoId" : {
                            "description" : "Tenant UUID",
                            "type" : "string"
                        },
                        "name" : {
                            "description" : "Name of the accounting server",
                            "type" : "string"
                        },
                        "description" : {
                            "description" : "Description of the accounting server",
                            "type" : "string"
                        },
                        "primary" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                                "ip" : {
                                    "type" : "string",
                                    "description" : "Server IP"
                                },
                                "port" : {
                                    "description" : "Server port",
                                    "type" : "integer",
                                    "minimum" : 1,
                                    "maximum" : 65535
                                },
                                "sharedSecret" : {
                                    "description" : "Server shared secrect",
                                    "type" : "string"
                                }
                            },
                            "required" : [ "ip", "port", "sharedSecret" ],
                            "description" : "Primary RADIUS server"
                        },
                        "secondary" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                                "ip" : {
                                    "type" : "string",
                                    "description" : "Server IP"
                                },
                                "port" : {
                                    "description" : "Server port",
                                    "type" : "integer",
                                    "minimum" : 1,
                                    "maximum" : 65535
                                },
                                "sharedSecret" : {
                                    "description" : "Server shared secrect",
                                    "type" : "string"
                                }
                            },
                            "required" : [ "ip", "port", "sharedSecret" ],
                            "description" : "Secondary RADIUS server"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve - RADIUS Accounting 

/v4_0/rkszones/{zoneId}/aaa/accounting/{id}

Use this API command to retrieve a radius accounting server of a zone.

  • Response  200
  • Body
    {
        "id" : "accountingServerUUID",
        "mvnoId" : "userMVNOId",
        "zoneId" : "zoneUUID",
        "name" : "accountingServerName",
        "description" : "accountingServerDescription",
        "primary" : {
            "ip" : "192.168.1.1",
            "port" : 1813,
            "sharedSecret" : "sharedSecret"
        },
        "secondary" : {
            "ip" : "192.168.1.2",
            "port" : 1813,
            "sharedSecret" : "sharedSecret"
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the accounting server",
                "type" : "string"
            },
            "zoneId" : {
                "description" : "Identifier of the zone which the accounting server belongs to",
                "type" : "string"
            },
            "mvnoId" : {
                "description" : "Tenant UUID",
                "type" : "string"
            },
            "name" : {
                "description" : "Name of the accounting server",
                "type" : "string"
            },
            "description" : {
                "description" : "Description of the accounting server",
                "type" : "string"
            },
            "primary" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "ip" : {
                        "type" : "string",
                        "description" : "Server IP"
                    },
                    "port" : {
                        "description" : "Server port",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 65535
                    },
                    "sharedSecret" : {
                        "description" : "Server shared secrect",
                        "type" : "string"
                    }
                },
                "required" : [ "ip", "port", "sharedSecret" ],
                "description" : "Primary RADIUS server"
            },
            "secondary" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "ip" : {
                        "type" : "string",
                        "description" : "Server IP"
                    },
                    "port" : {
                        "description" : "Server port",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 65535
                    },
                    "sharedSecret" : {
                        "description" : "Server shared secrect",
                        "type" : "string"
                    }
                },
                "required" : [ "ip", "port", "sharedSecret" ],
                "description" : "Secondary RADIUS server"
            }
        }
    }
    
    

Create - RADIUS Accounting 

/v4_0/rkszones/{zoneId}/aaa/accounting

Use this API command to create a new radius accounting server of a zone.

  • Request
  • Body
    {
        "name" : "accountingServerName",
        "primary" : {
            "ip" : "192.168.1.1",
            "port" : 1813,
            "sharedSecret" : "sharedSecret"
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the accounting server"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the accounting server"
            },
            "primary" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "ip" : {
                        "type" : "string",
                        "description" : "Server IP"
                    },
                    "port" : {
                        "description" : "Server port",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 65535
                    },
                    "sharedSecret" : {
                        "description" : "Server shared secrect",
                        "type" : "string"
                    }
                },
                "required" : [ "ip", "port", "sharedSecret" ],
                "description" : "Primary RADIUS server"
            },
            "secondary" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "ip" : {
                        "type" : "string",
                        "description" : "Server IP"
                    },
                    "port" : {
                        "description" : "Server port",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 65535
                    },
                    "sharedSecret" : {
                        "description" : "Server shared secrect",
                        "type" : "string"
                    }
                },
                "required" : [ "ip", "port", "sharedSecret" ],
                "description" : "Secondary RADIUS server"
            }
        },
        "required" : [ "name", "primary" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "AAAServerUUID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            }
        }
    }
    
    

Modify - RADIUS Accounting 

/v4_0/rkszones/{zoneId}/aaa/accounting/{id}

Use this API command to modify the basic information on radius accounting server of a zone.

  • Request
  • Body
    {
        "name" : "accountingServerName",
        "description" : "accountingServerDescription"
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Name of the accounting server"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Description of the accounting server"
        }
    }
    
    
  • Response  204

Modify - Primary Server of RADIUS Accounting 

/v4_0/rkszones/{zoneId}/aaa/accounting/{id}/primary

Use this API command to modify primary server on radius accounting server of a zone.

  • Request
  • Body
    {
        "ip" : "1.1.1.1",
        "port" : 1813,
        "sharedSecret" : "abc"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "ip" : {
                "type" : "string",
                "description" : "Server IP"
            },
            "port" : {
                "description" : "Server port",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 65535
            },
            "sharedSecret" : {
                "description" : "Server shared secrect",
                "type" : "string"
            }
        },
        "required" : [ "ip", "port", "sharedSecret" ],
        "description" : "Primary RADIUS server"
    }
    
    
  • Response  204

Modify - Secondary Server of RADIUS Accounting 

/v4_0/rkszones/{zoneId}/aaa/accounting/{id}/secondary

Use this API command to modify secondary server on radius accounting server of a zone.

  • Request
  • Body
    {
        "ip" : "192.168.1.2",
        "port" : 1813,
        "sharedSecret" : "sharedSecret"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "ip" : {
                "type" : "string",
                "description" : "Server IP"
            },
            "port" : {
                "description" : "Server port",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 65535
            },
            "sharedSecret" : {
                "description" : "Server shared secrect",
                "type" : "string"
            }
        },
        "required" : [ "ip", "port", "sharedSecret" ],
        "description" : "Secondary RADIUS server"
    }
    
    
  • Response  204

Disable Secondary Server - RADIUS Accounting 

/v4_0/rkszones/{zoneId}/aaa/accounting/{id}/secondary

Use this API command to disable secondary server on radius accounting server of a zone.

  • Response  204

Delete - RADIUS Accounting 

/v4_0/rkszones/{zoneId}/aaa/accounting/{id}

Use this API command to delete a radius accounting server of a zone.

  • Response  204

Retrieve List - ActiveDirectory 

/v4_0/rkszones/{zoneId}/aaa/ad

Use this API command to retrieve a list of active directory servers of a zone.

  • Response  200
  • Body
    {
        "totalCount" : 1,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "a49bf7dd-be4a-45fb-abd6-bc15dcd697c2",
            "mvnoId" : "839f87c6-d116-497e-afce-aa8157abd30c",
            "zoneId" : "3c7fd7f4-68bd-4957-a698-a1a810888959",
            "name" : "activeDirectoryServerName",
            "description" : null,
            "ip" : "192.168.1.1",
            "port" : 389,
            "windowsDomainName" : null,
            "adminDomainName" : null,
            "password" : "",
            "globalCatalogEnabled" : false
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the active directory server",
                            "type" : "string"
                        },
                        "zoneId" : {
                            "description" : "Identifier of the zone which the active directory server belongs to",
                            "type" : "string"
                        },
                        "mvnoId" : {
                            "description" : "Tenant UUID",
                            "type" : "string"
                        },
                        "name" : {
                            "description" : "Name of the active directory server",
                            "type" : "string"
                        },
                        "description" : {
                            "description" : "Description of the active directory server",
                            "type" : "string"
                        },
                        "ip" : {
                            "description" : "IP address",
                            "type" : "string"
                        },
                        "port" : {
                            "description" : "Port",
                            "type" : "integer"
                        },
                        "windowsDomainName" : {
                            "description" : "Windows domain name",
                            "type" : "string"
                        },
                        "adminDomainName" : {
                            "description" : "Admin domain name",
                            "type" : "string"
                        },
                        "password" : {
                            "description" : "Admin password",
                            "type" : "string"
                        },
                        "globalCatalogEnabled" : {
                            "description" : "Enable global catalog support",
                            "type" : "boolean"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve - ActiveDirectory 

/v4_0/rkszones/{zoneId}/aaa/ad/{id}

Use this API command to retrieve an active directory server of a zone.

  • Response  200
  • Body
    {
        "id" : "a49bf7dd-be4a-45fb-abd6-bc15dcd697c2",
        "mvnoId" : "839f87c6-d116-497e-afce-aa8157abd30c",
        "zoneId" : "3c7fd7f4-68bd-4957-a698-a1a810888959",
        "name" : "activeDirectoryServerName",
        "description" : null,
        "ip" : "192.168.1.1",
        "port" : 389,
        "windowsDomainName" : null,
        "adminDomainName" : null,
        "password" : "",
        "globalCatalogEnabled" : false
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the active directory server",
                "type" : "string"
            },
            "zoneId" : {
                "description" : "Identifier of the zone which the active directory server belongs to",
                "type" : "string"
            },
            "mvnoId" : {
                "description" : "Tenant UUID",
                "type" : "string"
            },
            "name" : {
                "description" : "Name of the active directory server",
                "type" : "string"
            },
            "description" : {
                "description" : "Description of the active directory server",
                "type" : "string"
            },
            "ip" : {
                "description" : "IP address",
                "type" : "string"
            },
            "port" : {
                "description" : "Port",
                "type" : "integer"
            },
            "windowsDomainName" : {
                "description" : "Windows domain name",
                "type" : "string"
            },
            "adminDomainName" : {
                "description" : "Admin domain name",
                "type" : "string"
            },
            "password" : {
                "description" : "Admin password",
                "type" : "string"
            },
            "globalCatalogEnabled" : {
                "description" : "Enable global catalog support",
                "type" : "boolean"
            }
        }
    }
    
    

Create - ActiveDirectory 

/v4_0/rkszones/{zoneId}/aaa/ad

Use this API command to create a new active directory server of a zone.

  • Request
  • Body
    {
        "name" : "activeDirectoryServerName",
        "ip" : "192.168.1.1",
        "port" : 389,
        "globalCatalogEnabled" : false
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the active directory server"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the active directory server"
            },
            "ip" : {
                "type" : "string",
                "description" : "IP address"
            },
            "port" : {
                "description" : "Port",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 65535,
                "default" : 389
            },
            "windowsDomainName" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 64,
                "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
                "description" : "Windows domain name"
            },
            "adminDomainName" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 64,
                "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
                "description" : "Admin domain name"
            },
            "password" : {
                "description" : "Admin password",
                "type" : "string"
            },
            "globalCatalogEnabled" : {
                "description" : "Enable global catalog support",
                "type" : "boolean"
            }
        },
        "required" : [ "name", "ip", "port", "globalCatalogEnabled" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "AAAServerUUID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            }
        }
    }
    
    

Modify - ActiveDirectory 

/v4_0/rkszones/{zoneId}/aaa/ad/{id}

Use this API command to modify the basic information on active directory server of a zone.

  • Request
  • Body
    {
        "name" : "new name",
        "ip" : "192.168.1.2",
        "port" : 3268,
        "adminDomainName" : "[email protected]",
        "password" : "admin",
        "globalCatalogEnabled" : true
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Name of the active directory server"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Description of the active directory server"
        },
        "ip" : {
            "type" : "string",
            "description" : "IP address"
        },
        "port" : {
            "description" : "Port",
            "type" : "integer",
            "minimum" : 1,
            "maximum" : 65535,
            "default" : 389
        },
        "windowsDomainName" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 64,
            "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
            "description" : "Windows domain name"
        },
        "adminDomainName" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 64,
            "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
            "description" : "Admin domain name"
        },
        "password" : {
            "description" : "Admin password",
            "type" : "string"
        },
        "globalCatalogEnabled" : {
            "description" : "Enable global catalog support",
            "type" : "boolean"
        }
    }
    
    
  • Response  204

Delete - ActiveDirectory 

/v4_0/rkszones/{zoneId}/aaa/ad/{id}

Use this API command to delete an active directory server of a zone.

  • Response  204

Retrieve List - LDAP 

/v4_0/rkszones/{zoneId}/aaa/ldap

Use this API command to retrieve a list of LDAP servers of a zone.

  • Response  200
  • Body
    {
        "totalCount" : 1,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "32fb8816-60e7-46df-876b-038c655278d4",
            "mvnoId" : "839f87c6-d116-497e-afce-aa8157abd30c",
            "zoneId" : "3c7fd7f4-68bd-4957-a698-a1a810888959",
            "name" : "rapheal-ldap",
            "description" : "",
            "ip" : "1.1.1.1",
            "port" : 389,
            "baseDomainName" : "dc=ldap",
            "adminDomainName" : "ibm",
            "password" : "admin",
            "keyAttribute" : "uid",
            "searchFilter" : "objectClass=*"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the LDAP server",
                            "type" : "string"
                        },
                        "zoneId" : {
                            "description" : "Identifier of the zone which the LDAP server belongs to",
                            "type" : "string"
                        },
                        "mvnoId" : {
                            "description" : "Tenant UUID",
                            "type" : "string"
                        },
                        "name" : {
                            "description" : "Name of the LDAP server",
                            "type" : "string"
                        },
                        "description" : {
                            "description" : "Description of the LDAP server",
                            "type" : "string"
                        },
                        "ip" : {
                            "description" : "IP address",
                            "type" : "string"
                        },
                        "port" : {
                            "description" : "Port",
                            "type" : "integer"
                        },
                        "baseDomainName" : {
                            "description" : "Base domain name",
                            "type" : "string"
                        },
                        "adminDomainName" : {
                            "description" : "Admin domain name",
                            "type" : "string"
                        },
                        "password" : {
                            "description" : "Admin password",
                            "type" : "string"
                        },
                        "keyAttribute" : {
                            "description" : "Key attribute",
                            "type" : "string"
                        },
                        "searchFilter" : {
                            "description" : "Search filter",
                            "type" : "string"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve - LDAP 

/v4_0/rkszones/{zoneId}/aaa/ldap/{id}

Use this API command to retrieve a LDAP server of a zone.

  • Response  200
  • Body
    {
        "id" : "32fb8816-60e7-46df-876b-038c655278d4",
        "mvnoId" : "839f87c6-d116-497e-afce-aa8157abd30c",
        "zoneId" : "3c7fd7f4-68bd-4957-a698-a1a810888959",
        "name" : "rapheal-ldap",
        "description" : "",
        "ip" : "1.1.1.1",
        "port" : 389,
        "baseDomainName" : "dc=ldap",
        "adminDomainName" : "ibm",
        "password" : "admin",
        "keyAttribute" : "uid",
        "searchFilter" : "objectClass=*"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the LDAP server",
                "type" : "string"
            },
            "zoneId" : {
                "description" : "Identifier of the zone which the LDAP server belongs to",
                "type" : "string"
            },
            "mvnoId" : {
                "description" : "Tenant UUID",
                "type" : "string"
            },
            "name" : {
                "description" : "Name of the LDAP server",
                "type" : "string"
            },
            "description" : {
                "description" : "Description of the LDAP server",
                "type" : "string"
            },
            "ip" : {
                "description" : "IP address",
                "type" : "string"
            },
            "port" : {
                "description" : "Port",
                "type" : "integer"
            },
            "baseDomainName" : {
                "description" : "Base domain name",
                "type" : "string"
            },
            "adminDomainName" : {
                "description" : "Admin domain name",
                "type" : "string"
            },
            "password" : {
                "description" : "Admin password",
                "type" : "string"
            },
            "keyAttribute" : {
                "description" : "Key attribute",
                "type" : "string"
            },
            "searchFilter" : {
                "description" : "Search filter",
                "type" : "string"
            }
        }
    }
    
    

Create - LDAP 

/v4_0/rkszones/{zoneId}/aaa/ldap

Use this API command to create a new LDAP server of a zone.

  • Request
  • Body
    {
        "name" : "rapheal-ldap",
        "ip" : "1.1.1.2",
        "port" : 389,
        "baseDomainName" : "dc=ldap",
        "adminDomainName" : "ibm",
        "password" : "admin",
        "keyAttribute" : "uid",
        "searchFilter" : "objectClass=*"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the LDAP server"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the LDAP server"
            },
            "ip" : {
                "type" : "string",
                "description" : "IP address"
            },
            "port" : {
                "description" : "Port",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 65535,
                "default" : 389
            },
            "baseDomainName" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 64,
                "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
                "description" : "Base domain name"
            },
            "adminDomainName" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 64,
                "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
                "description" : "Admin domain name"
            },
            "password" : {
                "description" : "Admin password",
                "type" : "string"
            },
            "keyAttribute" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 64,
                "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
                "description" : "Key attribute"
            },
            "searchFilter" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 64,
                "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
                "description" : "Search filter"
            }
        },
        "required" : [ "name", "ip", "port", "baseDomainName", "adminDomainName", "password", "keyAttribute", "searchFilter" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "AAAServerUUID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            }
        }
    }
    
    

Modify - LDAP 

/v4_0/rkszones/{zoneId}/aaa/ldap/{id}

Use this API command to modify the basic information on LDAP server of a zone.

  • Request
  • Body
    {
        "name" : "rapheal-ldap2",
        "ip" : "1.1.1.22",
        "port" : 389,
        "baseDomainName" : "dc=ldap",
        "adminDomainName" : "ibm",
        "password" : "admin",
        "keyAttribute" : "uid",
        "searchFilter" : "objectClass=*"
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Name of the LDAP server"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Description of the LDAP server"
        },
        "ip" : {
            "type" : "string",
            "description" : "IP address"
        },
        "port" : {
            "description" : "Port",
            "type" : "integer",
            "minimum" : 1,
            "maximum" : 65535,
            "default" : 389
        },
        "baseDomainName" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 64,
            "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
            "description" : "Base domain name"
        },
        "adminDomainName" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 64,
            "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
            "description" : "Admin domain name"
        },
        "password" : {
            "description" : "Admin password",
            "type" : "string"
        },
        "keyAttribute" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 64,
            "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
            "description" : "Key attribute"
        },
        "searchFilter" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 64,
            "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
            "description" : "Search filter"
        }
    }
    
    
  • Response  204

Delete - LDAP 

/v4_0/rkszones/{zoneId}/aaa/ldap/{id}

Use this API command to delete a LDAP server of a zone.

  • Response  204

Web Authentication 

Retrieve List 

/v4_0/rkszones/{zoneId}/portals/webauth

Use this API command to retrieve a list of web authentication of a zone.

  • Response  200
  • Body
    {
        "totalCount" : 9,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "c5dfc930-75dc-11e4-8d56-00606eb0c700",
            "name" : "protalName1"
        }, {
            "id" : "15efd160-7153-11e4-aa08-00606eb0c700",
            "name" : "protalName2"
        }, {
            "id" : "be0f0480-73a9-11e4-9d1d-f0def13d5845",
            "name" : "protalName3"
        }, {
            "id" : "7f0eef00-7423-11e4-bcef-000c299b4765",
            "name" : "protalName4"
        }, {
            "id" : "4f5c98a0-7123-11e4-bcef-000c299b4765",
            "name" : "protalName5"
        }, {
            "id" : "4a023ce0-73ab-11e4-b211-f0def13d5845",
            "name" : "protalName6"
        }, {
            "id" : "afebbc80-73be-11e4-bfde-f0def13d5845",
            "name" : "protalName7"
        }, {
            "id" : "76f4c020-7620-11e4-b8b9-00606eb0c700",
            "name" : "protalName8"
        }, {
            "id" : "96308310-752c-11e4-8276-00606eb0c700",
            "name" : "protalName9"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the service",
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the service"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve 

/v4_0/rkszones/{zoneId}/portals/webauth/{id}

Use this API command to retrieve a web authentication of a zone.

  • Response  200
  • Body
    {
        "name" : "Web Authentication Modify",
        "id" : "3e769bc0-7ead-11e4-9517-00606eb0c700",
        "description" : "Web Authentication Modify Description",
        "portalLanguage" : "en_US",
        "redirect" : {
            "url" : "https://www.ruckuswireless.com"
        },
        "userSession" : {
            "timeoutInMin" : 180,
            "gracePeriodInMin" : 120
        },
        "zoneId" : "b4187899-38ae-4ace-8e40-0bc444455156"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the web authentication profile",
                "type" : "string"
            },
            "zoneId" : {
                "description" : "Identifier of the zone which the web authentication profile belongs to",
                "type" : "string"
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the web authentication profile"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the web authentication profile"
            },
            "portalLanguage" : {
                "description" : "Portal language of the web authentication profile",
                "default" : "en_US",
                "enum" : [ "en_US", "zh_TW", "zh_CN", "nl_NL", "fr_FR", "de_DE", "ja_JP", "es_ES", "se_SE", "ar_SA", "cz_CZ", "da_DK", "tr_TR", "pt_BR" ]
            },
            "redirect" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "url" : {
                        "type" : "string",
                        "description" : "Portal redirect URL"
                    }
                },
                "description" : "Redirect configuration of the web authentication profile"
            },
            "userSession" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "timeoutInMin" : {
                        "description" : "Time out value in minutes",
                        "type" : "integer",
                        "default" : 1440,
                        "minimum" : 2,
                        "maximum" : 14400
                    },
                    "gracePeriodInMin" : {
                        "description" : "Grace period in minutes",
                        "type" : "integer",
                        "default" : 60,
                        "minimum" : 1,
                        "maximum" : 14399
                    }
                },
                "description" : "User session of the web authentication profile"
            }
        }
    }
    
    

Create 

/v4_0/rkszones/{zoneId}/portals/webauth

Use this API command to create a new web authentication of a zone.

  • Request
  • Body
    {
        "name" : "Web Authentication Create",
        "description" : "Web Authentication Create Description"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the web authentication profile"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the web authentication profile"
            }
        },
        "required" : [ "name" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "76f4c020-7620-11e4-b8b9-00606eb0c700"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the created portal profile",
                "type" : "string"
            }
        }
    }
    
    

Modify Basic 

/v4_0/rkszones/{zoneId}/portals/webauth/{id}

Use this API command to modify the basic information on web authentication of a zone.

  • Request
  • Body
    {
        "name" : "Web Authentication Modify",
        "description" : "Web Authentication Modify Description",
        "portalLanguage" : "en_US"
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Name of the web authentication profile"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Description of the web authentication profile"
        },
        "portalLanguage" : {
            "description" : "Portal language of the web authentication profile",
            "default" : "en_US",
            "enum" : [ "en_US", "zh_TW", "zh_CN", "nl_NL", "fr_FR", "de_DE", "ja_JP", "es_ES", "se_SE", "ar_SA", "cz_CZ", "da_DK", "tr_TR", "pt_BR" ]
        }
    }
    
    
  • Response  204

Modify Redirect 

/v4_0/rkszones/{zoneId}/portals/webauth/{id}/redirect

Use this API command to modify the redirect information on web authentication of a zone.

  • Request
  • Body
    {
        "url" : "https://www.ruckuswireless.com"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "url" : {
                "type" : "string",
                "description" : "Portal redirect URL"
            }
        },
        "description" : "Redirect configuration of the web authentication profile"
    }
    
    
  • Response  204

Redirect to URL user visit 

/v4_0/rkszones/{zoneId}/portals/webauth/{id}/redirect

Use this API command to set redirect to the URL that user intends to visit on web authentication of a zone.

  • Response  204

Modify UserSession 

/v4_0/rkszones/{zoneId}/portals/webauth/{id}/userSession

Use this API command to modify the user session on web authentication of a zone.

  • Request
  • Body
    {
        "timeoutInMin" : 180,
        "gracePeriodInMin" : 120
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "timeoutInMin" : {
                "description" : "Time out value in minutes",
                "type" : "integer",
                "default" : 1440,
                "minimum" : 2,
                "maximum" : 14400
            },
            "gracePeriodInMin" : {
                "description" : "Grace period in minutes",
                "type" : "integer",
                "default" : 60,
                "minimum" : 1,
                "maximum" : 14399
            }
        },
        "description" : "User session of the web authentication profile"
    }
    
    
  • Response  204

Delete 

/v4_0/rkszones/{zoneId}/portals/webauth/{id}

Use this API command to delete an web authentication of a zone.

  • Response  204

Guest Access 

Retrieve List 

/v4_0/rkszones/{zoneId}/portals/guest

Use this API command to retrieve a list of guest access of a zone.

  • Response  200
  • Body
    {
        "totalCount" : 9,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "c5dfc930-75dc-11e4-8d56-00606eb0c700",
            "name" : "protalName1"
        }, {
            "id" : "15efd160-7153-11e4-aa08-00606eb0c700",
            "name" : "protalName2"
        }, {
            "id" : "be0f0480-73a9-11e4-9d1d-f0def13d5845",
            "name" : "protalName3"
        }, {
            "id" : "7f0eef00-7423-11e4-bcef-000c299b4765",
            "name" : "protalName4"
        }, {
            "id" : "4f5c98a0-7123-11e4-bcef-000c299b4765",
            "name" : "protalName5"
        }, {
            "id" : "4a023ce0-73ab-11e4-b211-f0def13d5845",
            "name" : "protalName6"
        }, {
            "id" : "afebbc80-73be-11e4-bfde-f0def13d5845",
            "name" : "protalName7"
        }, {
            "id" : "76f4c020-7620-11e4-b8b9-00606eb0c700",
            "name" : "protalName8"
        }, {
            "id" : "96308310-752c-11e4-8276-00606eb0c700",
            "name" : "protalName9"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the service",
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the service"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve 

/v4_0/rkszones/{zoneId}/portals/guest/{id}

Use this API command to retrieve guest access of a zone.

  • Response  200
  • Body
    {
        "id" : "15efd160-7153-11e4-aa08-00606eb0c700",
        "zoneId" : "d664f517-cdc5-4997-8248-980a0b7a0542",
        "name" : "GuestAccessSmart",
        "description" : "basic configuration test",
        "portalCustomization" : {
            "language" : "en_US",
            "title" : "Welcome to the Guest Access login page.",
            "logo" : "logo description",
            "termsAndConditionsText" : "Terms of Use\n\nBy accepting this agreement and accessing the wireless network, you acknowledge that you are of legal age, you have read and understood, and agree to be bound by this agreement.\n(*) The wireless network service is provided by the property owners and is completely at their discretion. Your access to the network may be blocked, suspended, or terminated at any time for any reason.\n(*) You agree not to use the wireless network for any purpose that is unlawful or otherwise prohibited and you are fully responsible for your use.\n(*) The wireless network is provided \"as is\" without warranties of any kind, either expressed or implied.\n\nThis wireless network is powered by Ruckus Wireless.",
            "termsAndConditionsRequired" : true
        },
        "redirect" : {
            "url" : "http://www.google.com"
        },
        "smsGateway" : null,
        "userSession" : {
            "timeoutInMin" : 180,
            "gracePeriodInMin" : 120
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the guest access profile",
                "type" : "string"
            },
            "zoneId" : {
                "description" : "Identifier of the zone which the guest access profile belongs to",
                "type" : "string"
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the guest access profile"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the guest access profile"
            },
            "portalCustomization" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "language" : {
                        "description" : "Language",
                        "default" : "en_US",
                        "enum" : [ "en_US", "zh_TW", "zh_CN", "nl_NL", "fr_FR", "de_DE", "ja_JP", "es_ES", "se_SE", "ar_SA", "cz_CZ", "da_DK", "tr_TR", "pt_BR" ]
                    },
                    "title" : {
                        "description" : "Title",
                        "type" : "string",
                        "minLength" : 0,
                        "maxLength" : 63
                    },
                    "logo" : {
                        "description" : "logo",
                        "type" : "string"
                    },
                    "termsAndConditionsRequired" : {
                        "description" : "Terms and conditions is required or not",
                        "type" : "boolean",
                        "default" : "false"
                    },
                    "termsAndConditionsText" : {
                        "description" : "Terms and conditions text",
                        "type" : "string",
                        "default" : "Terms of Use\n\nBy accepting this agreement and accessing the wireless network, you acknowledge that you are of legal age, you have read and understood, and agree to be bound by this agreement.\n(*) The wireless network service is provided by the property owners and is completely at their discretion. Your access to the network may be blocked, suspended, or terminated at any time for any reason.\n(*) You agree not to use the wireless network for any purpose that is unlawful or otherwise prohibited and you are fully responsible for your use.\n(*) The wireless network is provided \"as is\" without warranties of any kind, either expressed or implied.\n\nThis wireless network is powered by Ruckus Wireless.",
                        "minLength" : 0,
                        "maxLength" : 3999
                    }
                },
                "required" : [ "language" ],
                "description" : "Portal customization of the guest access profile"
            },
            "redirect" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "url" : {
                        "type" : "string",
                        "description" : "Portal redirect URL"
                    }
                },
                "description" : "Redirect configuration of the guest access profile"
            },
            "smsGateway" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Portal SMS gateway of the guest access profile"
            },
            "userSession" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "timeoutInMin" : {
                        "description" : "Time out value in minutes",
                        "type" : "integer",
                        "default" : 1440,
                        "minimum" : 2,
                        "maximum" : 14400
                    },
                    "gracePeriodInMin" : {
                        "description" : "Grace period in minutes",
                        "type" : "integer",
                        "default" : 60,
                        "minimum" : 1,
                        "maximum" : 14399
                    }
                },
                "description" : "User session of the guest access profile"
            }
        }
    }
    
    

Create 

/v4_0/rkszones/{zoneId}/portals/guest

Use this API command to create new guest access of a zone.

  • Request
  • Body
    {
        "name" : "GuestAccess test",
        "description" : "guest access test description",
        "portalCustomization" : {
            "language" : "en_US",
            "title" : "Welcome to the Guest Access login page.",
            "logo" : "test",
            "termsAndConditionsRequired" : true,
            "termsAndConditionsText" : "test"
        },
        "redirect" : {
            "url" : "http://www.ruckuswireless.com"
        },
        "smsGateway" : {
            "name" : "defaultServer"
        },
        "userSession" : {
            "timeoutInMin" : 180,
            "gracePeriodInMin" : 120
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the guest access profile"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the guest access profile"
            },
            "portalCustomization" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "language" : {
                        "description" : "Language",
                        "default" : "en_US",
                        "enum" : [ "en_US", "zh_TW", "zh_CN", "nl_NL", "fr_FR", "de_DE", "ja_JP", "es_ES", "se_SE", "ar_SA", "cz_CZ", "da_DK", "tr_TR", "pt_BR" ]
                    },
                    "title" : {
                        "description" : "Title",
                        "type" : "string",
                        "minLength" : 0,
                        "maxLength" : 63
                    },
                    "logo" : {
                        "description" : "logo",
                        "type" : "string"
                    },
                    "termsAndConditionsRequired" : {
                        "description" : "Terms and conditions is required or not",
                        "type" : "boolean",
                        "default" : "false"
                    },
                    "termsAndConditionsText" : {
                        "description" : "Terms and conditions text",
                        "type" : "string",
                        "default" : "Terms of Use\n\nBy accepting this agreement and accessing the wireless network, you acknowledge that you are of legal age, you have read and understood, and agree to be bound by this agreement.\n(*) The wireless network service is provided by the property owners and is completely at their discretion. Your access to the network may be blocked, suspended, or terminated at any time for any reason.\n(*) You agree not to use the wireless network for any purpose that is unlawful or otherwise prohibited and you are fully responsible for your use.\n(*) The wireless network is provided \"as is\" without warranties of any kind, either expressed or implied.\n\nThis wireless network is powered by Ruckus Wireless.",
                        "minLength" : 0,
                        "maxLength" : 3999
                    }
                },
                "required" : [ "language" ],
                "description" : "Portal customization of the guest access profile"
            },
            "redirect" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "url" : {
                        "type" : "string",
                        "description" : "Portal redirect URL"
                    }
                },
                "description" : "Redirect configuration of the guest access profile"
            },
            "smsGateway" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Portal SMS gateway of the guest access profile"
            },
            "userSession" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "timeoutInMin" : {
                        "description" : "Time out value in minutes",
                        "type" : "integer",
                        "default" : 1440,
                        "minimum" : 2,
                        "maximum" : 14400
                    },
                    "gracePeriodInMin" : {
                        "description" : "Grace period in minutes",
                        "type" : "integer",
                        "default" : 60,
                        "minimum" : 1,
                        "maximum" : 14399
                    }
                },
                "description" : "Redirect configuration of the guest access profile"
            }
        },
        "required" : [ "name", "portalCustomization", "userSession" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "76f4c020-7620-11e4-b8b9-00606eb0c700"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the created portal profile",
                "type" : "string"
            }
        }
    }
    
    

Modify Basic 

/v4_0/rkszones/{zoneId}/portals/guest/{id}

Use this API command to modify the basic information on guest access of a zone.

  • Request
  • Body
    {
        "name" : "GuestAccessSmart",
        "description" : "basic configuration test"
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Name of the guest access profile"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Description of the guest access profile"
        }
    }
    
    
  • Response  204

Modify redirect 

/v4_0/rkszones/{zoneId}/portals/guest/{id}/redirect

Use this API command to modify the redirect information on guest access of a zone.

  • Request
  • Body
    {
        "url" : "http://www.google.com"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "url" : {
                "type" : "string",
                "description" : "Portal redirect URL"
            }
        },
        "description" : "Redirect configuration of the guest access profile"
    }
    
    
  • Response  204

Redirect to URL user visit 

/v4_0/rkszones/{zoneId}/portals/guest/{id}/redirect

Use this API command to set redirect to the URL that user intends to visit on guest access of a zone.

  • Response  204

Modify SMS Gateway 

/v4_0/rkszones/{zoneId}/portals/guest/{id}/smsGateway

Use this API command to modify SMS gateway on guest access of a zone.

  • Request
  • Body
    {
        "name" : "defaultServer"
    }
    
    
    Schema
    {
        "type" : [ "object", "null" ],
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            },
            "name" : {
                "type" : "string"
            }
        },
        "description" : "Portal SMS gateway of the guest access profile"
    }
    
    
  • Response  204

Disable SMS Gateway 

/v4_0/rkszones/{zoneId}/portals/guest/{id}/smsGateway

Use this API command to disable SMS gateway on guest access of a zone.

  • Response  204

Modify Portal Customization 

/v4_0/rkszones/{zoneId}/portals/guest/{id}/portalCustomization

Use this API command to modify the portal customization on guest access of a zone.

  • Request
  • Body
    {
        "language" : "zh_TW",
        "title" : "Welcome to the Guest Access login page.",
        "logo" : "logo description",
        "termsAndConditionsRequired" : true,
        "termsAndConditionsText" : "Terms of Use\n\nBy accepting this agreement and accessing the wireless network, you acknowledge that you are of legal age, you have read and understood, and agree to be bound by this agreement.\n(*) The wireless network service is provided by the property owners and is completely at their discretion. Your access to the network may be blocked, suspended, or terminated at any time for any reason.\n(*) You agree not to use the wireless network for any purpose that is unlawful or otherwise prohibited and you are fully responsible for your use.\n(*) The wireless network is provided \"as is\" without warranties of any kind, either expressed or implied.\n\nThis wireless network is powered by Ruckus Wireless."
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "language" : {
                "description" : "Language",
                "default" : "en_US",
                "enum" : [ "en_US", "zh_TW", "zh_CN", "nl_NL", "fr_FR", "de_DE", "ja_JP", "es_ES", "se_SE", "ar_SA", "cz_CZ", "da_DK", "tr_TR", "pt_BR" ]
            },
            "title" : {
                "description" : "Title",
                "type" : "string",
                "minLength" : 0,
                "maxLength" : 63
            },
            "logo" : {
                "description" : "logo",
                "type" : "string"
            },
            "termsAndConditionsRequired" : {
                "description" : "Terms and conditions is required or not",
                "type" : "boolean",
                "default" : "false"
            },
            "termsAndConditionsText" : {
                "description" : "Terms and conditions text",
                "type" : "string",
                "default" : "Terms of Use\n\nBy accepting this agreement and accessing the wireless network, you acknowledge that you are of legal age, you have read and understood, and agree to be bound by this agreement.\n(*) The wireless network service is provided by the property owners and is completely at their discretion. Your access to the network may be blocked, suspended, or terminated at any time for any reason.\n(*) You agree not to use the wireless network for any purpose that is unlawful or otherwise prohibited and you are fully responsible for your use.\n(*) The wireless network is provided \"as is\" without warranties of any kind, either expressed or implied.\n\nThis wireless network is powered by Ruckus Wireless.",
                "minLength" : 0,
                "maxLength" : 3999
            }
        },
        "required" : [ "language" ],
        "description" : "Portal customization of the guest access profile"
    }
    
    
  • Response  204

Modify User Session 

/v4_0/rkszones/{zoneId}/portals/guest/{id}/userSession

Use this API command to modify the user session on guest access of a zone.

  • Request
  • Body
    {
        "timeoutInMin" : 180,
        "gracePeriodInMin" : 60
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "timeoutInMin" : {
                "description" : "Time out value in minutes",
                "type" : "integer",
                "default" : 1440,
                "minimum" : 2,
                "maximum" : 14400
            },
            "gracePeriodInMin" : {
                "description" : "Grace period in minutes",
                "type" : "integer",
                "default" : 60,
                "minimum" : 1,
                "maximum" : 14399
            }
        },
        "description" : "User session of the guest access profile"
    }
    
    
  • Response  204

Delete 

/v4_0/rkszones/{zoneId}/portals/guest/{id}

Use this API command to delete guest access of a zone.

  • Response  204

User Traffic Profile 

Retrieve List - User Traffic Profile 

/v4_0/profiles/utp

Use this API command to retrieve a list of user traffic profile

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

  • Response  200
  • Body
    {
        "totalCount" : 1,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "267ef3a0-738b-11e4-96d5-0a7820524153",
            "name" : "new name"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the profile",
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the profile"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve - User Traffic Profile 

/v4_0/profiles/utp/{id}

Use this API command to retrieve an user traffic profile

  • Response  200
  • Body
    {
        "id" : "1869c000-9c5e-11e4-9d3a-00606eb0c700",
        "name" : "user-traffic-profile-name",
        "description" : "user traffic profile description",
        "defaultAction" : "ALLOW",
        "ipAclRules" : [ {
            "priority" : 1,
            "description" : "Allow DNS",
            "enableSourceIpSubnet" : true,
            "sourceIp" : "172.17.26.50",
            "sourceIpMask" : "255.255.0.0",
            "enableDestinationIpSubnet" : true,
            "destinationIp" : "172.17.29.31",
            "destinationIpMask" : "255.255.255.0",
            "enableSourcePortRange" : true,
            "sourceMinPort" : 10,
            "sourceMaxPort" : 65530,
            "enableDestinationPortRange" : false,
            "destinationMinPort" : 53,
            "destinationMaxPort" : null,
            "protocol" : null,
            "action" : "ALLOW",
            "direction" : "UPSTREAM"
        }, {
            "priority" : 2,
            "description" : "Allow DHCP",
            "enableSourceIpSubnet" : false,
            "sourceIp" : "172.17.51.99",
            "sourceIpMask" : "",
            "enableDestinationIpSubnet" : false,
            "destinationIp" : "172.17.53.99",
            "destinationIpMask" : "",
            "enableSourcePortRange" : true,
            "sourceMinPort" : null,
            "sourceMaxPort" : null,
            "enableDestinationPortRange" : false,
            "destinationMinPort" : 67,
            "destinationMaxPort" : null,
            "protocol" : null,
            "action" : "ALLOW",
            "direction" : "UPSTREAM"
        } ],
        "uplinkRateLimiting" : {
            "uplinkRateLimitingEnabled" : true,
            "uplinkRateLimitingBps" : "2.75 mbps"
        },
        "downlinkRateLimiting" : {
            "downlinkRateLimitingEnabled" : true,
            "downlinkRateLimitingBps" : "2.00 mbps"
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the user traffic profile",
                "type" : "string"
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the user traffic profile"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the user traffic profile"
            },
            "defaultAction" : {
                "description" : "Default action",
                "default" : "ALLOW",
                "enum" : [ "BLOCK", "ALLOW" ]
            },
            "uplinkRateLimiting" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "uplinkRateLimitingEnabled" : {
                        "description" : "Uplink rate limiting enabled or disabled",
                        "type" : "boolean",
                        "default" : false
                    },
                    "uplinkRateLimitingBps" : {
                        "description" : "Uplink rate limiting  bps, range 0.1 to 650",
                        "type" : "string"
                    }
                },
                "description" : "Uplink rate limiting"
            },
            "downlinkRateLimiting" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "downlinkRateLimitingEnabled" : {
                        "description" : "Downlink rate limiting enabled or disabled",
                        "type" : "boolean",
                        "default" : false
                    },
                    "downlinkRateLimitingBps" : {
                        "description" : "Downlink rate limiting bps, range 0.1 to 650",
                        "type" : "string"
                    }
                },
                "description" : "Downlink rate limiting"
            },
            "ipAclRules" : {
                "type" : "array",
                "description" : "Traffic access control list",
                "items" : {
                    "type" : "object",
                    "description" : "Traffic access control list",
                    "additionalProperties" : false,
                    "properties" : {
                        "priority" : {
                            "type" : "integer",
                            "description" : "Priority"
                        },
                        "description" : {
                            "type" : [ "string", "null" ],
                            "maxLength" : 64,
                            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                            "description" : "Description of the traffic access control rule"
                        },
                        "enableSourceIpSubnet" : {
                            "description" : "Source IP subnet enabled or disabled",
                            "type" : "boolean"
                        },
                        "sourceIp" : {
                            "type" : "string",
                            "description" : "Subnet network address or ip address of source IP."
                        },
                        "sourceIpMask" : {
                            "type" : "string",
                            "description" : "Subnet mask of source IP"
                        },
                        "enableDestinationIpSubnet" : {
                            "description" : "Destination IP subnet enabled or disabled",
                            "type" : "boolean"
                        },
                        "destinationIp" : {
                            "type" : "string",
                            "description" : "Subnet network address or ip address of destination IP."
                        },
                        "destinationIpMask" : {
                            "type" : "string",
                            "description" : "Subnet mask of destination IP"
                        },
                        "enableSourcePortRange" : {
                            "description" : "Source port range enabled or disabled",
                            "type" : "boolean"
                        },
                        "sourceMinPort" : {
                            "type" : "integer",
                            "description" : "The minunum port of source port range."
                        },
                        "sourceMaxPort" : {
                            "type" : "integer",
                            "description" : "The maxinum port of source port range."
                        },
                        "enableDestinationPortRange" : {
                            "description" : "Destincation port range enabled or disabled",
                            "type" : "boolean"
                        },
                        "destinationMinPort" : {
                            "type" : "integer",
                            "description" : "The mininum port of destination port range."
                        },
                        "destinationMaxPort" : {
                            "type" : "integer",
                            "description" : "The maxinum port of destination port range."
                        },
                        "protocol" : {
                            "description" : "The protocol of traffic access control.",
                            "enum" : [ "TCP", "UDP", "UDPLITE", "ICMP_ICMPV4", "ICMPV6", "IGMP", "ESP", "AH", "SCTP" ]
                        },
                        "action" : {
                            "description" : "The access of traffic access control.",
                            "default" : "ALLOW",
                            "enum" : [ "ALLOW", "BLOCK" ]
                        },
                        "direction" : {
                            "description" : "The direction of traffic access control.",
                            "default" : "UPSTREAM",
                            "enum" : [ "UPSTREAM" ]
                        }
                    }
                }
            }
        }
    }
    
    

Create - User Traffic Profile 

/v4_0/profiles/utp

Use this API command to create a new user traffic profile

  • Request
  • Body
    {
        "name" : "user-traffic-profile-name",
        "description" : "User traffic profile description",
        "defaultAction" : "ALLOW",
        "uplinkRateLimiting" : {
            "uplinkRateLimitingEnabled" : true,
            "uplinkRateLimitingBps" : "2.75 mbps"
        },
        "downlinkRateLimiting" : {
            "downlinkRateLimitingEnabled" : true,
            "downlinkRateLimitingBps" : "2.00 mbps"
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the user traffic profile"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the user traffic profile"
            },
            "defaultAction" : {
                "description" : "Default action",
                "default" : "ALLOW",
                "enum" : [ "BLOCK", "ALLOW" ]
            },
            "uplinkRateLimiting" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "uplinkRateLimitingEnabled" : {
                        "description" : "Uplink rate limiting enabled or disabled",
                        "type" : "boolean",
                        "default" : false
                    },
                    "uplinkRateLimitingBps" : {
                        "description" : "Uplink rate limiting  bps, range 0.1 to 650",
                        "type" : "string"
                    }
                },
                "description" : "Uplink rate limiting"
            },
            "downlinkRateLimiting" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "downlinkRateLimitingEnabled" : {
                        "description" : "Downlink rate limiting enabled or disabled",
                        "type" : "boolean",
                        "default" : false
                    },
                    "downlinkRateLimitingBps" : {
                        "description" : "Downlink rate limiting bps, range 0.1 to 650",
                        "type" : "string"
                    }
                },
                "description" : "Downlink rate limiting"
            }
        },
        "required" : [ "name", "defaultAction" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "profileUUID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            }
        }
    }
    
    

Modify - User Traffic Profile 

/v4_0/profiles/utp/{id}

Use this API command to modify the basic information of user traffic profile

  • Request
  • Body
    {
        "name" : "new-user-traffic-profile-name",
        "description" : "user traffic profile description",
        "defaultAction" : "ALLOW"
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Name of the user traffic profile"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Description of the user traffic profile"
        },
        "defaultAction" : {
            "description" : "Default action",
            "default" : "ALLOW",
            "enum" : [ "BLOCK", "ALLOW" ]
        }
    }
    
    
  • Response  204

Modify - IpAclRules 

/v4_0/profiles/utp/{id}/ipAclRules

Use this API command to modify IP ACL rules of user traffic profile

  • Request
  • Body
    [ {
        "description" : "acl rule description",
        "enableSourceIpSubnet" : true,
        "sourceIp" : "172.17.26.55",
        "sourceIpMask" : "255.255.255.0",
        "enableSourcePortRange" : false,
        "sourceMinPort" : 101,
        "enableDestinationPortRange" : false,
        "destinationIp" : "172.17.26.60",
        "destinationIpMask" : "255.255.0.0",
        "protocol" : "TCP",
        "action" : "ALLOW",
        "direction" : "UPSTREAM"
    }, {
        "description" : "acl rule description",
        "enableSourceIpSubnet" : true,
        "sourceIp" : "255.17.26.87",
        "sourceIpMask" : "255.255.255.0",
        "destinationIp" : "172.17.26.69",
        "destinationIpMask" : "255.255.0.0",
        "protocol" : "UDP",
        "action" : "BLOCK",
        "direction" : "UPSTREAM"
    } ]
    
    
    Schema
    {
        "type" : "array",
        "description" : "Traffic access control list",
        "items" : {
            "type" : "object",
            "description" : "Traffic access control list",
            "additionalProperties" : false,
            "properties" : {
                "description" : {
                    "type" : [ "string", "null" ],
                    "maxLength" : 64,
                    "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                    "description" : "Description of the traffic access control rule"
                },
                "enableSourceIpSubnet" : {
                    "description" : "Source IP subnet enabled or disabled",
                    "type" : "boolean"
                },
                "sourceIp" : {
                    "type" : "string",
                    "description" : "Subnet network address or ip address of source IP."
                },
                "sourceIpMask" : {
                    "type" : "string",
                    "description" : "Subnet mask of source IP"
                },
                "enableDestinationIpSubnet" : {
                    "description" : "Destination IP subnet enabled or disabled",
                    "type" : "boolean"
                },
                "destinationIp" : {
                    "type" : "string",
                    "description" : "Subnet network address or ip address of destination IP."
                },
                "destinationIpMask" : {
                    "type" : "string",
                    "description" : "Subnet mask of destination IP"
                },
                "enableSourcePortRange" : {
                    "description" : "Source port range enabled or disabled",
                    "type" : "boolean"
                },
                "sourceMinPort" : {
                    "type" : "integer",
                    "description" : "The minunum port of source port range."
                },
                "sourceMaxPort" : {
                    "type" : "integer",
                    "description" : "The maxinum port of source port range."
                },
                "enableDestinationPortRange" : {
                    "description" : "Destincation port range enabled or disabled",
                    "type" : "boolean"
                },
                "destinationMinPort" : {
                    "type" : "integer",
                    "description" : "The mininum port of destination port range."
                },
                "destinationMaxPort" : {
                    "type" : "integer",
                    "description" : "The maxinum port of destination port range."
                },
                "protocol" : {
                    "description" : "The protocol of traffic access control.",
                    "enum" : [ "TCP", "UDP", "UDPLITE", "ICMP_ICMPV4", "ICMPV6", "IGMP", "ESP", "AH", "SCTP" ]
                },
                "action" : {
                    "description" : "The access of traffic access control.",
                    "default" : "ALLOW",
                    "enum" : [ "ALLOW", "BLOCK" ]
                },
                "direction" : {
                    "description" : "The direction of traffic access control.",
                    "default" : "UPSTREAM",
                    "enum" : [ "UPSTREAM" ]
                }
            },
            "required" : [ "action", "direction" ]
        }
    }
    
    
  • Response  204

Modify - uplinkRateLimiting 

/v4_0/profiles/utp/{id}/uplinkRateLimiting

Use this API command to modify uplink rate limiting of user traffic profile

  • Request
  • Body
    {
        "uplinkRateLimitingEnabled" : true,
        "uplinkRateLimitingBps" : "0.10 mbps"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "uplinkRateLimitingEnabled" : {
                "description" : "Uplink rate limiting enabled or disabled",
                "type" : "boolean",
                "default" : false
            },
            "uplinkRateLimitingBps" : {
                "description" : "Uplink rate limiting  bps, range 0.1 to 650",
                "type" : "string"
            }
        },
        "description" : "Uplink rate limiting"
    }
    
    
  • Response  204

Disable - uplinkRateLimiting 

/v4_0/profiles/utp/{id}/uplinkRateLimiting

Use this API command to disable uplink rateLimiting of user traffic profile

  • Response  204

Modify - downlinkRateLimiting 

/v4_0/profiles/utp/{id}/downlinkRateLimiting

Use this API command to modify downlink rate limiting of user traffic profile

  • Request
  • Body
    {
        "downlinkRateLimitingEnabled" : true,
        "downlinkRateLimitingBps" : "0.10 mbps"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "downlinkRateLimitingEnabled" : {
                "description" : "Downlink rate limiting enabled or disabled",
                "type" : "boolean",
                "default" : false
            },
            "downlinkRateLimitingBps" : {
                "description" : "Downlink rate limiting bps, range 0.1 to 650",
                "type" : "string"
            }
        },
        "description" : "Downlink rate limiting"
    }
    
    
  • Response  204

Disable - downlinkRateLimiting 

/v4_0/profiles/utp/{id}/downlinkRateLimiting

Use this API command to disable downlink rate limiting of user traffic profile

  • Response  204

Delete - User Traffic Profile 

/v4_0/profiles/utp/{id}

Use this API command to delete an user traffic profile

  • Response  204

Hotspot Service 

Retrieve List 

/v4_0/rkszones/{zoneId}/portals/hotspot

Use this API command to retrieve a list of Hotspot(WISPr) of a zone.

  • Response  200
  • Body
    {
        "totalCount" : 9,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "c5dfc930-75dc-11e4-8d56-00606eb0c700",
            "name" : "protalName1"
        }, {
            "id" : "15efd160-7153-11e4-aa08-00606eb0c700",
            "name" : "protalName2"
        }, {
            "id" : "be0f0480-73a9-11e4-9d1d-f0def13d5845",
            "name" : "protalName3"
        }, {
            "id" : "7f0eef00-7423-11e4-bcef-000c299b4765",
            "name" : "protalName4"
        }, {
            "id" : "4f5c98a0-7123-11e4-bcef-000c299b4765",
            "name" : "protalName5"
        }, {
            "id" : "4a023ce0-73ab-11e4-b211-f0def13d5845",
            "name" : "protalName6"
        }, {
            "id" : "afebbc80-73be-11e4-bfde-f0def13d5845",
            "name" : "protalName7"
        }, {
            "id" : "76f4c020-7620-11e4-b8b9-00606eb0c700",
            "name" : "protalName8"
        }, {
            "id" : "96308310-752c-11e4-8276-00606eb0c700",
            "name" : "protalName9"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the service",
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the service"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve 

/v4_0/rkszones/{zoneId}/portals/hotspot/{id}

Use this API command to retrieve a Hotspot(WISPr) of zone.

  • Response  200
  • Body
    {
        "name" : "test-hotspot222",
        "id" : "3e5b3782-6f1a-42bf-9812-95d2c1df2451",
        "description" : "description",
        "smartClientSupport" : "None",
        "smartClientInfo" : null,
        "portalType" : "Internal",
        "portalUrl" : null,
        "redirect" : null,
        "portalCustomization" : {
            "language" : "en_US",
            "title" : "Ruckus Wireless - Subscriber Portal",
            "logo" : "logo",
            "termsAndConditionsRequired" : false
        },
        "userSession" : {
            "timeoutInMin" : 1440,
            "gracePeriodInMin" : 60
        },
        "location" : {
            "id" : "locationId",
            "name" : "locationName"
        },
        "macAddressFormat" : 2,
        "walledGardens" : [ "10.1.1.1", "11.11.111.11" ],
        "zoneId" : "d664f517-cdc5-4997-8248-980a0b7a0542"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the Hotspot",
                "type" : "string"
            },
            "zoneId" : {
                "description" : "Identifier of the zone which the Hotspot belongs to",
                "type" : "string"
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the Hotspot"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the Hotspot"
            },
            "smartClientSupport" : {
                "description" : "Smart client support of the Hotspot",
                "enum" : [ "None", "Enabled", "SmartClientOnly" ]
            },
            "smartClientInfo" : {
                "description" : "Smart client info of the Hotspot",
                "type" : "string"
            },
            "portalType" : {
                "description" : "Portal type of the Hotspot",
                "enum" : [ "Internal", "External" ]
            },
            "portalUrl" : {
                "type" : "string",
                "description" : "Portal URL of the Hotspot"
            },
            "location" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "description" : "Portal location id",
                        "type" : "string"
                    },
                    "name" : {
                        "description" : "Portal location name",
                        "type" : "string"
                    }
                },
                "description" : "Location of the Hotspot"
            },
            "redirect" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "url" : {
                        "type" : "string",
                        "description" : "Portal redirect URL"
                    }
                },
                "description" : "Redirect configuration of the Hotspot"
            },
            "portalCustomization" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "language" : {
                        "description" : "Language",
                        "default" : "en_US",
                        "enum" : [ "en_US", "zh_TW", "zh_CN", "nl_NL", "fr_FR", "de_DE", "ja_JP", "es_ES", "se_SE", "ar_SA", "cz_CZ", "da_DK", "tr_TR", "pt_BR" ]
                    },
                    "title" : {
                        "description" : "Title",
                        "type" : "string",
                        "minLength" : 0,
                        "maxLength" : 63
                    },
                    "logo" : {
                        "description" : "logo",
                        "type" : "string"
                    },
                    "termsAndConditionsRequired" : {
                        "description" : "Terms and conditions is required or not",
                        "type" : "boolean",
                        "default" : "false"
                    },
                    "termsAndConditionsText" : {
                        "description" : "Terms and conditions text",
                        "type" : "string",
                        "default" : "Terms of Use\n\nBy accepting this agreement and accessing the wireless network, you acknowledge that you are of legal age, you have read and understood, and agree to be bound by this agreement.\n(*) The wireless network service is provided by the property owners and is completely at their discretion. Your access to the network may be blocked, suspended, or terminated at any time for any reason.\n(*) You agree not to use the wireless network for any purpose that is unlawful or otherwise prohibited and you are fully responsible for your use.\n(*) The wireless network is provided \"as is\" without warranties of any kind, either expressed or implied.\n\nThis wireless network is powered by Ruckus Wireless.",
                        "minLength" : 0,
                        "maxLength" : 3999
                    }
                },
                "required" : [ "language" ],
                "description" : "Portal customization of the guest access profile"
            },
            "userSession" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "timeoutInMin" : {
                        "description" : "Time out value in minutes",
                        "type" : "integer",
                        "default" : 1440,
                        "minimum" : 2,
                        "maximum" : 14400
                    },
                    "gracePeriodInMin" : {
                        "description" : "Grace period in minutes",
                        "type" : "integer",
                        "default" : 60,
                        "minimum" : 1,
                        "maximum" : 14399
                    }
                },
                "description" : "User session of the Hotspot"
            },
            "walledGardens" : {
                "description" : "Walled garden map set of the Hotspot",
                "type" : "array",
                "items" : {
                    "type" : "string"
                }
            },
            "macAddressFormat" : {
                "description" : "mac address format of redirection",
                "type" : "integer",
                "default" : 2,
                "minimum" : 0,
                "maximum" : 5
            }
        }
    }
    
    

Create Internal 

/v4_0/rkszones/{zoneId}/portals/hotspot/internal

Use this API command to create a new Hotspot(WISPr) with internal logon URL of a zone.MacAddressFormat : 0(aabbccddeeff), 1(AA-BB-CC-DD-EE-FF), 2(AA:BB:CC:DD:EE:FF), 3(AABBCCDDEEFF), 4(aa-bb-cc-dd-ee-ff), 5(aa:bb:cc:dd:ee:ff)

  • Request
  • Body
    {
        "name" : "test-hotspot222",
        "description" : "description",
        "smartClientSupport" : "None",
        "portalUrl" : "https://172.17.26.59",
        "location" : {
            "id" : "locationId",
            "name" : "locationName"
        },
        "macAddressFormat" : 2,
        "walledGardens" : [ "10.11.12.16", "10.11.12.13" ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the Hotspot"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the Hotspot"
            },
            "smartClientSupport" : {
                "description" : "Smart client support of the Hotspot",
                "enum" : [ "None", "Enabled" ]
            },
            "location" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "description" : "Portal location id",
                        "type" : "string"
                    },
                    "name" : {
                        "description" : "Portal location name",
                        "type" : "string"
                    }
                },
                "description" : "Location of the Hotspot"
            },
            "redirect" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "url" : {
                        "type" : "string",
                        "description" : "Portal redirect URL"
                    }
                },
                "description" : "Redirect configuration of the Hotspot"
            },
            "userSession" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "timeoutInMin" : {
                        "description" : "Time out value in minutes",
                        "type" : "integer",
                        "default" : 1440,
                        "minimum" : 2,
                        "maximum" : 14400
                    },
                    "gracePeriodInMin" : {
                        "description" : "Grace period in minutes",
                        "type" : "integer",
                        "default" : 60,
                        "minimum" : 1,
                        "maximum" : 14399
                    }
                },
                "description" : "User session of the Hotspot"
            },
            "walledGardens" : {
                "description" : "Walled garden map set of the Hotspot",
                "type" : "array",
                "items" : {
                    "type" : "string"
                }
            },
            "macAddressFormat" : {
                "description" : "mac address format of redirection",
                "type" : "integer",
                "default" : 2,
                "minimum" : 0,
                "maximum" : 5
            }
        },
        "required" : [ "name", "smartClientSupport", "macAddressFormat" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "76f4c020-7620-11e4-b8b9-00606eb0c700"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the created portal profile",
                "type" : "string"
            }
        }
    }
    
    

Create External 

/v4_0/rkszones/{zoneId}/portals/hotspot/external

Use this API command to create a new Hotspot(WISPr) with external logon URL of a zone.MacAddressFormat : 0(aabbccddeeff), 1(AA-BB-CC-DD-EE-FF), 2(AA:BB:CC:DD:EE:FF), 3(AABBCCDDEEFF), 4(aa-bb-cc-dd-ee-ff), 5(aa:bb:cc:dd:ee:ff)

  • Request
  • Body
    {
        "name" : "test-hotspot222",
        "description" : "description",
        "smartClientSupport" : "None",
        "portalUrl" : "https://172.17.26.59",
        "location" : {
            "id" : "locationId",
            "name" : "locationName"
        },
        "macAddressFormat" : 2,
        "walledGardens" : [ "10.11.12.16", "10.11.12.13" ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the Hotspot"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the Hotspot"
            },
            "smartClientSupport" : {
                "description" : "Smart client support of the Hotspot",
                "enum" : [ "None", "Enabled" ]
            },
            "portalUrl" : {
                "type" : "string",
                "description" : "Portal URL of the Hotspot"
            },
            "location" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "description" : "Portal location id",
                        "type" : "string"
                    },
                    "name" : {
                        "description" : "Portal location name",
                        "type" : "string"
                    }
                },
                "description" : "Location of the hotspot"
            },
            "redirect" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "url" : {
                        "type" : "string",
                        "description" : "Portal redirect URL"
                    }
                },
                "description" : "Redirect configuration of the Hotspot"
            },
            "userSession" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "timeoutInMin" : {
                        "description" : "Time out value in minutes",
                        "type" : "integer",
                        "default" : 1440,
                        "minimum" : 2,
                        "maximum" : 14400
                    },
                    "gracePeriodInMin" : {
                        "description" : "Grace period in minutes",
                        "type" : "integer",
                        "default" : 60,
                        "minimum" : 1,
                        "maximum" : 14399
                    }
                },
                "description" : "User session of the Hotspot"
            },
            "walledGardens" : {
                "description" : "Walled garden map set of the Hotspot",
                "type" : "array",
                "items" : {
                    "type" : "string"
                }
            },
            "macAddressFormat" : {
                "description" : "mac address format of redirection",
                "type" : "integer",
                "default" : 2,
                "minimum" : 0,
                "maximum" : 5
            }
        },
        "required" : [ "name", "smartClientSupport", "portalUrl", "macAddressFormat" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "76f4c020-7620-11e4-b8b9-00606eb0c700"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the created portal profile",
                "type" : "string"
            }
        }
    }
    
    

Create Smart Client Only 

/v4_0/rkszones/{zoneId}/portals/hotspot/smartClientOnly

Use this API command to create a new Hotspot(WISPr) with smart client only of a zone.MacAddressFormat : 0(aabbccddeeff), 1(AA-BB-CC-DD-EE-FF), 2(AA:BB:CC:DD:EE:FF), 3(AABBCCDDEEFF), 4(aa-bb-cc-dd-ee-ff), 5(aa:bb:cc:dd:ee:ff)

  • Request
  • Body
    {
        "name" : "test-hotspot222-smartClientOnly",
        "description" : "description-smartClientOnly",
        "smartClientInfo" : "smartClient only, yyyy!",
        "location" : {
            "id" : "locationId",
            "name" : "locationName"
        },
        "macAddressFormat" : 2,
        "walledGardens" : [ "10.11.12.16", "10.11.12.13" ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the Hotspot"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the Hotspot"
            },
            "smartClientInfo" : {
                "description" : "Smart client info of the Hotspot",
                "type" : "string"
            },
            "location" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "description" : "Portal location id",
                        "type" : "string"
                    },
                    "name" : {
                        "description" : "Portal location name",
                        "type" : "string"
                    }
                },
                "description" : "Location of the Hotspot"
            },
            "redirect" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "url" : {
                        "type" : "string",
                        "description" : "Portal redirect URL"
                    }
                },
                "description" : "Redirect configuration of the Hotspot"
            },
            "userSession" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "timeoutInMin" : {
                        "description" : "Time out value in minutes",
                        "type" : "integer",
                        "default" : 1440,
                        "minimum" : 2,
                        "maximum" : 14400
                    },
                    "gracePeriodInMin" : {
                        "description" : "Grace period in minutes",
                        "type" : "integer",
                        "default" : 60,
                        "minimum" : 1,
                        "maximum" : 14399
                    }
                },
                "description" : "Redirect configuration of the Hotspot profile"
            },
            "walledGardens" : {
                "description" : "Walled garden map set of the Hotspot",
                "type" : "array",
                "items" : {
                    "type" : "string"
                }
            },
            "macAddressFormat" : {
                "description" : "mac address format of redirection",
                "type" : "integer",
                "default" : 2,
                "minimum" : 0,
                "maximum" : 5
            }
        },
        "required" : [ "name", "smartClientInfo", "macAddressFormat" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "76f4c020-7620-11e4-b8b9-00606eb0c700"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the created portal profile",
                "type" : "string"
            }
        }
    }
    
    

Modify Basic 

/v4_0/rkszones/{zoneId}/portals/hotspot/{id}

Use this API command to modify the basic information on Hotspot(WISPr) of a zone.MacAddressFormat : 0(aabbccddeeff), 1(AA-BB-CC-DD-EE-FF), 2(AA:BB:CC:DD:EE:FF), 3(AABBCCDDEEFF), 4(aa-bb-cc-dd-ee-ff), 5(aa:bb:cc:dd:ee:ff)

  • Request
  • Body
    {
        "name" : "test-hotspot-modify",
        "description" : "description-modify",
        "smartClientSupport" : "Enabled",
        "portalUrl" : "https://172.17.26.59",
        "macAddressFormat" : 2
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Name of the Hotspot"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Description of the Hotspot"
        },
        "smartClientSupport" : {
            "description" : "Smart client support of the Hotspot",
            "enum" : [ "None", "Enabled" ]
        },
        "smartClientInfo" : {
            "description" : "Smart client info of the Hotspot",
            "type" : "string"
        },
        "portalUrl" : {
            "type" : "string",
            "description" : "Portal URL of the Hotspot"
        },
        "macAddressFormat" : {
            "description" : "mac address format of redirection",
            "type" : "integer",
            "default" : 2,
            "minimum" : 0,
            "maximum" : 5
        }
    }
    
    
  • Response  204

Modify Redirect 

/v4_0/rkszones/{zoneId}/portals/hotspot/{id}/redirect

Use this API command to modify the redirect information on Hotspot(WISPr) of a zone.

  • Request
  • Body
    {
        "url" : "https://www.testurl.com"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "url" : {
                "type" : "string",
                "description" : "Portal redirect URL"
            }
        },
        "description" : "Redirect configuration of the Hotspot"
    }
    
    
  • Response  204

Modify Portal Customization 

/v4_0/rkszones/{zoneId}/portals/hotspot/{id}/portalCustomization

Use this API command to modify portal customization on Hotspot(WISPr) of a zone.

  • Request
  • Body
    {
        "language" : "en_US",
        "title" : "Ruckus Wireless - Subscriber Portal",
        "logo" : "logo",
        "termsAndConditionsRequired" : false
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "language" : {
                "description" : "Language",
                "default" : "en_US",
                "enum" : [ "en_US", "zh_TW", "zh_CN", "nl_NL", "fr_FR", "de_DE", "ja_JP", "es_ES", "se_SE", "ar_SA", "cz_CZ", "da_DK", "tr_TR", "pt_BR" ]
            },
            "title" : {
                "description" : "Title",
                "type" : "string",
                "minLength" : 0,
                "maxLength" : 63
            },
            "logo" : {
                "description" : "logo",
                "type" : "string"
            },
            "termsAndConditionsRequired" : {
                "description" : "Terms and conditions is required or not",
                "type" : "boolean",
                "default" : "false"
            },
            "termsAndConditionsText" : {
                "description" : "Terms and conditions text",
                "type" : "string",
                "default" : "Terms of Use\n\nBy accepting this agreement and accessing the wireless network, you acknowledge that you are of legal age, you have read and understood, and agree to be bound by this agreement.\n(*) The wireless network service is provided by the property owners and is completely at their discretion. Your access to the network may be blocked, suspended, or terminated at any time for any reason.\n(*) You agree not to use the wireless network for any purpose that is unlawful or otherwise prohibited and you are fully responsible for your use.\n(*) The wireless network is provided \"as is\" without warranties of any kind, either expressed or implied.\n\nThis wireless network is powered by Ruckus Wireless.",
                "minLength" : 0,
                "maxLength" : 3999
            }
        },
        "required" : [ "language" ],
        "description" : "Portal customization of the guest access profile"
    }
    
    
  • Response  204

Modify Location 

/v4_0/rkszones/{zoneId}/portals/hotspot/{id}/location

Use this API command to modify the location information on Hotspot(WISPr) of a zone.

  • Request
  • Body
    {
        "id" : "locationId",
        "name" : "locationName"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Portal location id",
                "type" : "string"
            },
            "name" : {
                "description" : "Portal location name",
                "type" : "string"
            }
        },
        "description" : "Location of the Hotspot"
    }
    
    
  • Response  204

Modify Walled Gardens 

/v4_0/rkszones/{zoneId}/portals/hotspot/{id}/walledGardens

Use this API command to modify walled gardens on Hotspot(WISPr) of a zone.

  • Request
  • Body
    [ "10.1.1.1", "11.11.111.11" ]
    
    
    Schema
    {
        "description" : "Walled garden map set of the Hotspot",
        "type" : "array",
        "items" : {
            "type" : "string"
        }
    }
    
    
  • Response  204

Delete 

/v4_0/rkszones/{zoneId}/portals/hotspot/{id}

Use this API command to delete a Hotspot(WISPr) of a zone.

  • Response  204

Hotspot20 WLAN Profile 

Retrieve List 

/v4_0/rkszones/{zoneId}/hs20s

Use this API command to retrieve a list of Hotspot 2.0 WLAN profiles of a zone.

  • Response  200
  • Body
    {
        "totalCount" : 9,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "c5dfc930-75dc-11e4-8d56-00606eb0c700",
            "name" : "protalName1"
        }, {
            "id" : "15efd160-7153-11e4-aa08-00606eb0c700",
            "name" : "protalName2"
        }, {
            "id" : "be0f0480-73a9-11e4-9d1d-f0def13d5845",
            "name" : "protalName3"
        }, {
            "id" : "7f0eef00-7423-11e4-bcef-000c299b4765",
            "name" : "protalName4"
        }, {
            "id" : "4f5c98a0-7123-11e4-bcef-000c299b4765",
            "name" : "protalName5"
        }, {
            "id" : "4a023ce0-73ab-11e4-b211-f0def13d5845",
            "name" : "protalName6"
        }, {
            "id" : "afebbc80-73be-11e4-bfde-f0def13d5845",
            "name" : "protalName7"
        }, {
            "id" : "76f4c020-7620-11e4-b8b9-00606eb0c700",
            "name" : "protalName8"
        }, {
            "id" : "96308310-752c-11e4-8276-00606eb0c700",
            "name" : "protalName9"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the service",
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the service"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve 

/v4_0/rkszones/{zoneId}/hs20s/{id}

Use this API command to retrieve a Hotspot 2.0 WLAN profile of a zone.

  • Response  200
  • Body
    {
        "id" : "b6af6e80-8409-11e4-a4e7-80fa5b024259",
        "name" : "test-hs20Wlan",
        "description" : "test-hs20Wlan-desc",
        "operator" : {
            "id" : "e6373c40-8194-11e4-aa2e-000c299b4765",
            "name" : "operatorTEST"
        },
        "identityProviders" : [ {
            "id" : "9eec1055-45dd-45c5-a631-f1b76530bb67",
            "name" : "identityProviderDisabled"
        }, {
            "id" : "5fc11810-c8bd-4876-9acf-356a1f4727a3",
            "name" : "identityProviderEnabled"
        } ],
        "defaultIdentityProvider" : {
            "id" : "5fc11810-c8bd-4876-9acf-356a1f4727a3",
            "name" : "identityProviderEnabled"
        },
        "signupSsid" : {
            "id" : "1",
            "name" : "osenWlan"
        },
        "internetOption" : true,
        "accessNetworkType" : "FREE_PUBLIC",
        "ipv4AddressType" : "UNAVAILABLE",
        "ipv6AddressType" : "UNAVAILABLE",
        "connectionCapabilities" : [ {
            "protocolName" : "ICMP",
            "protocolNumber" : 1,
            "portNumber" : 0,
            "status" : "OPEN"
        }, {
            "protocolName" : "FTP",
            "protocolNumber" : 6,
            "portNumber" : 20,
            "status" : "OPEN"
        }, {
            "protocolName" : "SSH",
            "protocolNumber" : 6,
            "portNumber" : 22,
            "status" : "CLOSED"
        }, {
            "protocolName" : "HTTP",
            "protocolNumber" : 6,
            "portNumber" : 80,
            "status" : "CLOSED"
        }, {
            "protocolName" : "Used by TLS VPN",
            "protocolNumber" : 6,
            "portNumber" : 443,
            "status" : "CLOSED"
        }, {
            "protocolName" : "Used by PPTP VPNs",
            "protocolNumber" : 6,
            "portNumber" : 1723,
            "status" : "CLOSED"
        }, {
            "protocolName" : "VoIP",
            "protocolNumber" : 6,
            "portNumber" : 5060,
            "status" : "CLOSED"
        }, {
            "protocolName" : "VoIP",
            "protocolNumber" : 17,
            "portNumber" : 5060,
            "status" : "CLOSED"
        }, {
            "protocolName" : "Used by IKEv2(IPSec VPN)",
            "protocolNumber" : 17,
            "portNumber" : 500,
            "status" : "CLOSED"
        }, {
            "protocolName" : "IPSec VPN",
            "protocolNumber" : 17,
            "portNumber" : 4500,
            "status" : "CLOSED"
        }, {
            "protocolName" : "ESP",
            "protocolNumber" : 50,
            "portNumber" : 0,
            "status" : "CLOSED"
        } ],
        "customConnectionCapabilities" : [ {
            "protocolName" : "ICMP",
            "protocolNumber" : 2,
            "portNumber" : 0,
            "status" : "OPEN"
        }, {
            "protocolName" : "FTP",
            "protocolNumber" : 2,
            "portNumber" : 20,
            "status" : "OPEN"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the Hotspot 2.0 WLAN profile",
                "type" : "string"
            },
            "zoneId" : {
                "description" : "Identifier of the zone which the Hotspot 2.0 WLAN profile belongs to",
                "type" : "string"
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the Hotspot 2.0 WLAN profile"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the Hotspot 2.0 WLAN profile"
            },
            "operator" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Operator of the Hotspot 2.0 WLAN profile"
            },
            "identityProviders" : {
                "description" : "Identity providers of the Hotspot 2.0 WLAN profile",
                "type" : "array",
                "items" : {
                    "type" : [ "object", "null" ],
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string"
                        }
                    }
                }
            },
            "defaultIdentityProvider" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Default identity provider of the Hotspot 2.0 WLAN profile"
            },
            "signupSsid" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Signup SSID of the Hotspot 2.0 WLAN profile"
            },
            "internetOption" : {
                "description" : "Internet option of the Hotspot 2.0 WLAN profile",
                "type" : "boolean"
            },
            "accessNetworkType" : {
                "description" : "Access network type of the Hotspot 2.0 WLAN profile",
                "enum" : [ "CHARGEABLE_PUBLIC", "FREE_PUBLIC", "PERSONAL_DEVICE", "PRIVATE", "PRIVATE_WITH_GUEST", "TEST", "WILDCARD" ]
            },
            "ipv4AddressType" : {
                "description" : "IPv4 address type of the v WLAN profile",
                "enum" : [ "UNAVAILABLE", "PUBLIC", "PORT_RESTRICTED", "SINGLE_NATED_PRIVATE", "DOUBLE_NATED_PRIVATE", "PORT_RESTRICTED_AND_SINGLE_NATED", "PORT_RESTRICTED_AND_DOUBLE_NATED", "UNKNOWN" ]
            },
            "ipv6AddressType" : {
                "description" : "IPv6 address type of the Hotspot 2.0 WLAN profile",
                "enum" : [ "UNAVAILABLE", "AVAILABLE", "UNKNOWN" ]
            },
            "connectionCapabilities" : {
                "description" : "Default connection capabilities of the Hotspot 2.0 WLAN profile",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "protocolName" : {
                            "description" : "Protocol aame of connection capability, cannot be modified",
                            "type" : "string",
                            "pattern" : "^[!-~]([ -~]){0,31}$"
                        },
                        "protocolNumber" : {
                            "description" : "Protocol number of connection capability, cannot be modified",
                            "type" : "number",
                            "minimum" : 0,
                            "maximum" : 254
                        },
                        "portNumber" : {
                            "description" : "Port number of connection capability, cannot be modified",
                            "type" : "number",
                            "minimum" : 0,
                            "maximum" : 65535
                        },
                        "status" : {
                            "description" : "Status of connection capability",
                            "enum" : [ "CLOSED", "OPEN", "UNKNOWN" ]
                        }
                    },
                    "required" : [ "protocolName", "protocolNumber", "portNumber", "status" ]
                }
            },
            "customConnectionCapabilities" : {
                "description" : "Custom connection capabilities of the Hotspot 2.0 WLAN profile",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "protocolName" : {
                            "description" : "Protocol aame of connection capability",
                            "type" : "string",
                            "pattern" : "^[!-~]([ -~]){0,31}$"
                        },
                        "protocolNumber" : {
                            "description" : "Protocol number of connection capability",
                            "type" : "number",
                            "minimum" : 0,
                            "maximum" : 254
                        },
                        "portNumber" : {
                            "description" : "Port number of connection capability",
                            "type" : "number",
                            "minimum" : 0,
                            "maximum" : 65535
                        },
                        "status" : {
                            "description" : "Status of connection capability",
                            "enum" : [ "CLOSED", "OPEN", "UNKNOWN" ]
                        }
                    },
                    "required" : [ "protocolName", "protocolNumber", "portNumber", "status" ]
                }
            }
        }
    }
    
    

Create 

/v4_0/rkszones/{zoneId}/hs20s

Use this API command to create a new Hotspot 2.0 WLAN profile of a zone.

  • Request
  • Body
    {
        "name" : "hotspot20WlanCreate",
        "description" : "hotspot20 Wlan profile Create desc",
        "operator" : {
            "id" : "e6373c40-8194-11e4-aa2e-000c299b4765",
            "name" : "operatorTEST"
        },
        "identityProviders" : [ {
            "id" : "9eec1055-45dd-45c5-a631-f1b76530bb67",
            "name" : "identityProviderDisabled"
        }, {
            "id" : "5fc11810-c8bd-4876-9acf-356a1f4727a3",
            "name" : "identityProviderEnabled"
        } ],
        "defaultIdentityProvider" : {
            "id" : "5fc11810-c8bd-4876-9acf-356a1f4727a3",
            "name" : "identityProviderEnabled"
        },
        "signupSsid" : {
            "id" : "1",
            "name" : "osenWlan"
        },
        "internetOption" : true,
        "accessNetworkType" : "CHARGEABLE_PUBLIC",
        "ipv4AddressType" : "UNAVAILABLE",
        "ipv6AddressType" : "UNAVAILABLE"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the Hotspot 2.0 WLAN profile"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the Hotspot 2.0 WLAN profile"
            },
            "operator" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Operator of the Hotspot 2.0 WLAN profile"
            },
            "identityProviders" : {
                "description" : "Ddentity providers of the Hotspot 2.0 WLAN profile",
                "type" : "array",
                "items" : {
                    "type" : [ "object", "null" ],
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string"
                        }
                    }
                }
            },
            "defaultIdentityProvider" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Default identity provider of the Hotspot 2.0 WLAN profile"
            },
            "signupSsid" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Signup SSID of the Hotspot 2.0 WLAN profile"
            },
            "internetOption" : {
                "description" : "Internet option of the Hotspot 2.0 WLAN profile",
                "type" : "boolean"
            },
            "accessNetworkType" : {
                "description" : "Access network type of the Hotspot 2.0 WLAN profile",
                "enum" : [ "CHARGEABLE_PUBLIC", "FREE_PUBLIC", "PERSONAL_DEVICE", "PRIVATE", "PRIVATE_WITH_GUEST", "TEST", "WILDCARD" ]
            },
            "ipv4AddressType" : {
                "description" : "IPv4 address type of the Hotspot 2.0 WLAN profile",
                "enum" : [ "UNAVAILABLE", "PUBLIC", "PORT_RESTRICTED", "SINGLE_NATED_PRIVATE", "DOUBLE_NATED_PRIVATE", "PORT_RESTRICTED_AND_SINGLE_NATED", "PORT_RESTRICTED_AND_DOUBLE_NATED", "UNKNOWN" ]
            },
            "ipv6AddressType" : {
                "description" : "IPv6 address type of the Hotspot 2.0 WLAN profile",
                "enum" : [ "UNAVAILABLE", "AVAILABLE", "UNKNOWN" ]
            }
        },
        "required" : [ "name", "operator", "defaultIdentityProvider", "internetOption", "accessNetworkType", "ipv4AddressType", "ipv6AddressType" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "76f4c020-7620-11e4-b8b9-00606eb0c700"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the created portal profile",
                "type" : "string"
            }
        }
    }
    
    

Modify Basic 

/v4_0/rkszones/{zoneId}/hs20s/{id}

Use this API command to modify the basic information on Hotspot 2.0 WLAN profile of a zone.

  • Request
  • Body
    {
        "name" : "hotspot20WlanProfilePath",
        "description" : "hotspot20 wlan profile pathc desc",
        "internetOption" : true,
        "accessNetworkType" : "CHARGEABLE_PUBLIC",
        "ipv4AddressType" : "UNAVAILABLE",
        "ipv6AddressType" : "UNAVAILABLE"
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Name of the Hotspot 2.0 WLAN profile"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Description of the Hotspot 2.0 WLAN profile"
        },
        "internetOption" : {
            "description" : "Internet option of the Hotspot 2.0 WLAN profile",
            "type" : "boolean"
        },
        "accessNetworkType" : {
            "description" : "Access network type of the Hotspot 2.0 WLAN profile",
            "enum" : [ "CHARGEABLE_PUBLIC", "FREE_PUBLIC", "PERSONAL_DEVICE", "PRIVATE", "PRIVATE_WITH_GUEST", "TEST", "WILDCARD" ]
        },
        "ipv4AddressType" : {
            "description" : "IPv4 address type of the Hotspot 2.0 Wlan profile",
            "enum" : [ "UNAVAILABLE", "PUBLIC", "PORT_RESTRICTED", "SINGLE_NATED_PRIVATE", "DOUBLE_NATED_PRIVATE", "PORT_RESTRICTED_AND_SINGLE_NATED", "PORT_RESTRICTED_AND_DOUBLE_NATED", "UNKNOWN" ]
        },
        "ipv6AddressType" : {
            "description" : "IPv6 address type of the Hotspot 2.0 Wlan profile",
            "enum" : [ "UNAVAILABLE", "AVAILABLE", "UNKNOWN" ]
        }
    }
    
    
  • Response  204

Modify Operator 

/v4_0/rkszones/{zoneId}/hs20s/{id}/operator

Use this API command to modify operator profile on Hotspot 2.0 WLAN profile of a zone.

  • Request
  • Body
    {
        "id" : "e6373c40-8194-11e4-aa2e-000c299b4765",
        "name" : "operatorTEST"
    }
    
    
    Schema
    {
        "type" : [ "object", "null" ],
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            },
            "name" : {
                "type" : "string"
            }
        },
        "description" : "Operator of the Hotspot 2.0 WLAN profile"
    }
    
    
  • Response  204

Modify Identity Providers 

/v4_0/rkszones/{zoneId}/hs20s/{id}/identityProviders

Use this API command to modify identity provider profiles on Hotspot 2.0 WLAN profile of a zone.

  • Request
  • Body
    [ {
        "id" : "9eec1055-45dd-45c5-a631-f1b76530bb67",
        "name" : "identityProviderDisabled"
    }, {
        "id" : "5fc11810-c8bd-4876-9acf-356a1f4727a3",
        "name" : "identityProviderEnabled"
    } ]
    
    
    Schema
    {
        "description" : "Identity providers of the Hotspot 2.0 WLAN profile",
        "type" : "array",
        "items" : {
            "type" : [ "object", "null" ],
            "additionalProperties" : false,
            "properties" : {
                "id" : {
                    "type" : "string"
                },
                "name" : {
                    "type" : "string"
                }
            }
        }
    }
    
    
  • Response  204

Modify Default Identity Provider 

/v4_0/rkszones/{zoneId}/hs20s/{id}/defaultIdentityProvider

Use this API command to modify the default identity provider profile on Hotspot 2.0 WLAN profile of a zone.

  • Request
  • Body
    {
        "id" : "5fc11810-c8bd-4876-9acf-356a1f4727a3",
        "name" : "identityProviderEnabled"
    }
    
    
    Schema
    {
        "type" : [ "object", "null" ],
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            },
            "name" : {
                "type" : "string"
            }
        },
        "description" : "Default identity provider of the Hotspot 2.0 WLAN profile"
    }
    
    
  • Response  204

Modify Signup SSID 

/v4_0/rkszones/{zoneId}/hs20s/{id}/signupSsid

Use this API command to modify signup SSID on Hotspot 2.0 WLAN profile of a zone.

  • Request
  • Body
    {
        "id" : "1",
        "name" : "osenWlan"
    }
    
    
    Schema
    {
        "type" : [ "object", "null" ],
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            },
            "name" : {
                "type" : "string"
            }
        },
        "description" : "Signup SSID of the Hotspot 2.0 WLAN profile"
    }
    
    
  • Response  204

Modify Default Connection Capabilities 

/v4_0/rkszones/{zoneId}/hs20s/{id}/connectionCapabilities

Use this API command to modify connection capabilities on Hotspot 2.0 WLAN profile of a zone.

  • Request
  • Body
    [ {
        "protocolName" : "ICMP",
        "protocolNumber" : 1,
        "portNumber" : 0,
        "status" : "OPEN"
    }, {
        "protocolName" : "FTP",
        "protocolNumber" : 6,
        "portNumber" : 20,
        "status" : "OPEN"
    }, {
        "protocolName" : "SSH",
        "protocolNumber" : 6,
        "portNumber" : 22,
        "status" : "UNKNOWN"
    }, {
        "protocolName" : "HTTP",
        "protocolNumber" : 6,
        "portNumber" : 80,
        "status" : "CLOSED"
    }, {
        "protocolName" : "Used by TLS VPN",
        "protocolNumber" : 6,
        "portNumber" : 443,
        "status" : "CLOSED"
    }, {
        "protocolName" : "Used by PPTP VPNs",
        "protocolNumber" : 6,
        "portNumber" : 1723,
        "status" : "CLOSED"
    }, {
        "protocolName" : "VoIP",
        "protocolNumber" : 6,
        "portNumber" : 5060,
        "status" : "CLOSED"
    }, {
        "protocolName" : "VoIP",
        "protocolNumber" : 17,
        "portNumber" : 5060,
        "status" : "CLOSED"
    }, {
        "protocolName" : "Used by IKEv2(IPSec VPN)",
        "protocolNumber" : 17,
        "portNumber" : 500,
        "status" : "CLOSED"
    }, {
        "protocolName" : "IPSec VPN",
        "protocolNumber" : 17,
        "portNumber" : 4500,
        "status" : "CLOSED"
    }, {
        "protocolName" : "ESP",
        "protocolNumber" : 50,
        "portNumber" : 0,
        "status" : "CLOSED"
    } ]
    
    
    Schema
    {
        "description" : "Default connection capabilities of the Hotspot 2.0 WLAN profile",
        "type" : "array",
        "items" : {
            "type" : "object",
            "additionalProperties" : false,
            "properties" : {
                "protocolName" : {
                    "description" : "Protocol aame of connection capability, cannot be modified",
                    "type" : "string",
                    "pattern" : "^[!-~]([ -~]){0,31}$"
                },
                "protocolNumber" : {
                    "description" : "Protocol number of connection capability, cannot be modified",
                    "type" : "number",
                    "minimum" : 0,
                    "maximum" : 254
                },
                "portNumber" : {
                    "description" : "Port number of connection capability, cannot be modified",
                    "type" : "number",
                    "minimum" : 0,
                    "maximum" : 65535
                },
                "status" : {
                    "description" : "Status of connection capability",
                    "enum" : [ "CLOSED", "OPEN", "UNKNOWN" ]
                }
            },
            "required" : [ "protocolName", "protocolNumber", "portNumber", "status" ]
        }
    }
    
    
  • Response  204

Modify Custom Connection Capabilities 

/v4_0/rkszones/{zoneId}/hs20s/{id}/customConnectionCapabilities

Use this API command to modify custom connection capabilities on Hotspot 2.0 WLAN profile of a zone.

  • Request
  • Body
    [ {
        "protocolName" : "ICMP",
        "protocolNumber" : 2,
        "portNumber" : 0,
        "status" : "OPEN"
    }, {
        "protocolName" : "FTP",
        "protocolNumber" : 2,
        "portNumber" : 20,
        "status" : "OPEN"
    } ]
    
    
    Schema
    {
        "description" : "Custom connection capabilities of the Hotspot 2.0 WLAN profile",
        "type" : "array",
        "items" : {
            "type" : "object",
            "additionalProperties" : false,
            "properties" : {
                "protocolName" : {
                    "description" : "Protocol aame of connection capability",
                    "type" : "string",
                    "pattern" : "^[!-~]([ -~]){0,31}$"
                },
                "protocolNumber" : {
                    "description" : "Protocol number of connection capability",
                    "type" : "number",
                    "minimum" : 0,
                    "maximum" : 254
                },
                "portNumber" : {
                    "description" : "Port number of connection capability",
                    "type" : "number",
                    "minimum" : 0,
                    "maximum" : 65535
                },
                "status" : {
                    "description" : "Status of connection capability",
                    "enum" : [ "CLOSED", "OPEN", "UNKNOWN" ]
                }
            },
            "required" : [ "protocolName", "protocolNumber", "portNumber", "status" ]
        }
    }
    
    
  • Response  204

Delete 

/v4_0/rkszones/{zoneId}/hs20s/{id}

Use this API command to delete a Hotspot 2.0 WLAN Profile of a zone.

  • Response  204

Authentication Service 

Retrieve List - RADIUS Authentication Service 

/v4_0/services/auth/radius

Use this API command to retrieve a list of RADIUS authentication services.

  • Response  200
  • Body
    {
        "totalCount" : 1,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "82109ce0-64e6-11e4-8916-0026b9f85aaf",
            "mvnoId" : "839f87c6-d116-497e-afce-aa8157abd30c",
            "name" : "rapheal-auth-x3",
            "friendlyName" : "rapheal-auth-x",
            "description" : "authentication service created by rapheal via public API",
            "mappings" : [ {
                "id" : "73587760-6589-11e4-800c-0026b9f85aaf",
                "groupAttr" : "abc",
                "userRole" : {
                    "id" : "a4c288b0-63cf-11e4-a18a-080027b147d4",
                    "name" : "identity user role name",
                    "userTrafficProfile" : {
                        "id" : "9474cc20-63cf-11e4-a18a-080027b147d4",
                        "name" : "rapheal-usertraffic-profile"
                    }
                }
            }, {
                "id" : "735e6ad0-6589-11e4-800c-0026b9f85aaf",
                "groupAttr" : "*",
                "userRole" : {
                    "id" : "9ac45fd6-a87b-4eef-87d7-b759fed376c5",
                    "name" : "identity user role name",
                    "userTrafficProfile" : {
                        "id" : "03ec5340-60a4-11e4-87fc-080027b147d4",
                        "name" : "System Default"
                    }
                }
            } ],
            "primary" : {
                "ip" : "1.1.1.155",
                "port" : 1812,
                "sharedSecret" : "abc"
            },
            "secondary" : {
                "ip" : "2.2.2.231",
                "port" : 1812,
                "sharedSecret" : "abc"
            },
            "healthCheckPolicy" : {
                "responseWindow" : 20,
                "reviveInterval" : 120,
                "zombiePeriod" : 40
            },
            "rateLimiting" : {
                "maxOutstandingRequestsPerServer" : 0,
                "threshold" : 0,
                "sanityTimer" : 10
            }
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the RADIUS authentication service",
                            "type" : "string"
                        },
                        "mvnoId" : {
                            "description" : "Tenant UUID",
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the RADIUS authentication service"
                        },
                        "friendlyName" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Friendly name of the RADIUS authentication service"
                        },
                        "description" : {
                            "type" : [ "string", "null" ],
                            "maxLength" : 64,
                            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                            "description" : "Description of the RADIUS authentication service"
                        },
                        "locationDeliveryEnabled" : {
                            "description" : "RFC5580 out of band location delivery support(for Ruckus AP only)",
                            "type" : "boolean",
                            "default" : false
                        },
                        "primary" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                                "ip" : {
                                    "type" : "string",
                                    "description" : "Server IP"
                                },
                                "port" : {
                                    "description" : "Server port",
                                    "type" : "integer",
                                    "minimum" : 1,
                                    "maximum" : 65535
                                },
                                "sharedSecret" : {
                                    "description" : "Server shared secrect",
                                    "type" : "string"
                                }
                            },
                            "required" : [ "ip", "port", "sharedSecret" ],
                            "description" : "Primary RADIUS server"
                        },
                        "secondary" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                                "autoFallbackDisable" : {
                                    "descriptin" : "Automatic fallback enabled or disabled",
                                    "type" : "boolean"
                                },
                                "ip" : {
                                    "type" : "string",
                                    "description" : "RADIUS server IP"
                                },
                                "port" : {
                                    "description" : "RADIUS server port",
                                    "type" : "integer",
                                    "minimum" : 1,
                                    "maximum" : 65535,
                                    "default" : 1812
                                },
                                "sharedSecret" : {
                                    "description" : "RADIUS server shared secrect",
                                    "type" : "string"
                                }
                            },
                            "required" : [ "autoFallbackDisable", "ip", "port", "sharedSecret" ],
                            "description" : "Secondary RADIUS server"
                        },
                        "healthCheckPolicy" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                                "responseWindow" : {
                                    "description" : "Response window",
                                    "type" : "integer",
                                    "minimum" : 5,
                                    "maximum" : 30,
                                    "default" : 20
                                },
                                "reviveInterval" : {
                                    "description" : "Revive interval",
                                    "type" : "integer",
                                    "minimum" : 60,
                                    "maximum" : 3600,
                                    "default" : 120
                                },
                                "zombiePeriod" : {
                                    "description" : "Zombie period",
                                    "type" : "integer",
                                    "minimum" : 30,
                                    "maximum" : 120,
                                    "default" : 40
                                }
                            },
                            "required" : [ "responseWindow", "reviveInterval", "zombiePeriod" ],
                            "description" : "Health check policy"
                        },
                        "rateLimiting" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                                "maxOutstandingRequestsPerServer" : {
                                    "description" : "Maximum outstanding requests (MOR), value should be 0 or between 10 and 4096",
                                    "type" : "integer",
                                    "default" : 0
                                },
                                "threshold" : {
                                    "description" : "Threshold, value should be 0 if MOR is 0, or between 10 and 90 if MOR is between 10 and 4096",
                                    "type" : "integer",
                                    "default" : 0
                                },
                                "sanityTimer" : {
                                    "description" : "Sanity timer ",
                                    "type" : "integer",
                                    "minimum" : 1,
                                    "maximum" : 3600,
                                    "default" : 10
                                }
                            },
                            "required" : [ "maxOutstandingRequestsPerServer", "threshold", "sanityTimer" ],
                            "description" : "Rate limiting"
                        },
                        "mappings" : {
                            "type" : "array",
                            "description" : "Group attribute and user traffic profile mapping",
                            "items" : {
                                "type" : "object",
                                "additionalProperties" : false,
                                "description" : "User traffic profile mapping",
                                "properties" : {
                                    "id" : {
                                        "type" : "string",
                                        "description" : "Group attribute mapping UUID"
                                    },
                                    "groupAttr" : {
                                        "type" : "string",
                                        "description" : "Group attribute"
                                    },
                                    "userRole" : {
                                        "type" : "object",
                                        "additionalProperties" : false,
                                        "description" : "Identity user role",
                                        "properties" : {
                                            "id" : {
                                                "type" : "string",
                                                "description" : "Identity user role UUID"
                                            },
                                            "name" : {
                                                "type" : "string",
                                                "minLength" : 2,
                                                "maxLength" : 32,
                                                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                                                "description" : "Identity user role name"
                                            },
                                            "userTrafficProfile" : {
                                                "type" : "object",
                                                "description" : "Identity user role",
                                                "properties" : {
                                                    "id" : {
                                                        "type" : "string",
                                                        "description" : "User traffic profile UUID"
                                                    },
                                                    "name" : {
                                                        "type" : "string",
                                                        "description" : "User traffic profile name"
                                                    }
                                                }
                                            }
                                        }
                                    }
                                },
                                "required" : [ "groupAttr", "userRole" ]
                            }
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve - RADIUS Authentication Service 

/v4_0/services/auth/radius/{id}

Use this API command to retrieve a RADIUS authentication service.

  • Response  200
  • Body
    {
        "id" : "82109ce0-64e6-11e4-8916-0026b9f85aaf",
        "mvnoId" : "839f87c6-d116-497e-afce-aa8157abd30c",
        "name" : "rapheal-auth-x3",
        "friendlyName" : "rapheal-auth-x",
        "description" : "authentication service created by rapheal via public API",
        "mappings" : [ {
            "id" : "73587760-6589-11e4-800c-0026b9f85aaf",
            "groupAttr" : "abc",
            "userRole" : {
                "id" : "a4c288b0-63cf-11e4-a18a-080027b147d4",
                "name" : "identity user role name",
                "userTrafficProfile" : {
                    "id" : "9474cc20-63cf-11e4-a18a-080027b147d4",
                    "name" : "rapheal-usertraffic-profile"
                }
            }
        }, {
            "id" : "735e6ad0-6589-11e4-800c-0026b9f85aaf",
            "groupAttr" : "*",
            "userRole" : {
                "id" : "9ac45fd6-a87b-4eef-87d7-b759fed376c5",
                "name" : "identity user role name",
                "userTrafficProfile" : {
                    "id" : "03ec5340-60a4-11e4-87fc-080027b147d4",
                    "name" : "System Default"
                }
            }
        } ],
        "primary" : {
            "ip" : "1.1.1.155",
            "port" : 1812,
            "sharedSecret" : "abc"
        },
        "secondary" : {
            "ip" : "2.2.2.231",
            "port" : 1812,
            "sharedSecret" : "abc"
        },
        "healthCheckPolicy" : {
            "responseWindow" : 20,
            "reviveInterval" : 120,
            "zombiePeriod" : 40
        },
        "rateLimiting" : {
            "maxOutstandingRequestsPerServer" : 0,
            "threshold" : 0,
            "sanityTimer" : 10
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the RADIUS authentication service",
                "type" : "string"
            },
            "mvnoId" : {
                "description" : "Tenant UUID",
                "type" : "string"
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the RADIUS authentication service"
            },
            "friendlyName" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Friendly name of the RADIUS authentication service"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the RADIUS authentication service"
            },
            "locationDeliveryEnabled" : {
                "description" : "RFC5580 out of band location delivery support(for Ruckus AP only)",
                "type" : "boolean",
                "default" : false
            },
            "primary" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "ip" : {
                        "type" : "string",
                        "description" : "Server IP"
                    },
                    "port" : {
                        "description" : "Server port",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 65535
                    },
                    "sharedSecret" : {
                        "description" : "Server shared secrect",
                        "type" : "string"
                    }
                },
                "required" : [ "ip", "port", "sharedSecret" ],
                "description" : "Primary RADIUS server"
            },
            "secondary" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "autoFallbackDisable" : {
                        "descriptin" : "Automatic fallback enabled or disabled",
                        "type" : "boolean"
                    },
                    "ip" : {
                        "type" : "string",
                        "description" : "RADIUS server IP"
                    },
                    "port" : {
                        "description" : "RADIUS server port",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 65535,
                        "default" : 1812
                    },
                    "sharedSecret" : {
                        "description" : "RADIUS server shared secrect",
                        "type" : "string"
                    }
                },
                "required" : [ "autoFallbackDisable", "ip", "port", "sharedSecret" ],
                "description" : "Secondary RADIUS server"
            },
            "healthCheckPolicy" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "responseWindow" : {
                        "description" : "Response window",
                        "type" : "integer",
                        "minimum" : 5,
                        "maximum" : 30,
                        "default" : 20
                    },
                    "reviveInterval" : {
                        "description" : "Revive interval",
                        "type" : "integer",
                        "minimum" : 60,
                        "maximum" : 3600,
                        "default" : 120
                    },
                    "zombiePeriod" : {
                        "description" : "Zombie period",
                        "type" : "integer",
                        "minimum" : 30,
                        "maximum" : 120,
                        "default" : 40
                    }
                },
                "required" : [ "responseWindow", "reviveInterval", "zombiePeriod" ],
                "description" : "Health check policy"
            },
            "rateLimiting" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "maxOutstandingRequestsPerServer" : {
                        "description" : "Maximum outstanding requests (MOR), value should be 0 or between 10 and 4096",
                        "type" : "integer",
                        "default" : 0
                    },
                    "threshold" : {
                        "description" : "Threshold, value should be 0 if MOR is 0, or between 10 and 90 if MOR is between 10 and 4096",
                        "type" : "integer",
                        "default" : 0
                    },
                    "sanityTimer" : {
                        "description" : "Sanity timer ",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 3600,
                        "default" : 10
                    }
                },
                "required" : [ "maxOutstandingRequestsPerServer", "threshold", "sanityTimer" ],
                "description" : "Rate limiting"
            },
            "mappings" : {
                "type" : "array",
                "description" : "Group attribute and user traffic profile mapping",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "User traffic profile mapping",
                    "properties" : {
                        "id" : {
                            "type" : "string",
                            "description" : "Group attribute mapping UUID"
                        },
                        "groupAttr" : {
                            "type" : "string",
                            "description" : "Group attribute"
                        },
                        "userRole" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "description" : "Identity user role",
                            "properties" : {
                                "id" : {
                                    "type" : "string",
                                    "description" : "Identity user role UUID"
                                },
                                "name" : {
                                    "type" : "string",
                                    "minLength" : 2,
                                    "maxLength" : 32,
                                    "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                                    "description" : "Identity user role name"
                                },
                                "userTrafficProfile" : {
                                    "type" : "object",
                                    "description" : "Identity user role",
                                    "properties" : {
                                        "id" : {
                                            "type" : "string",
                                            "description" : "User traffic profile UUID"
                                        },
                                        "name" : {
                                            "type" : "string",
                                            "description" : "User traffic profile name"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "required" : [ "groupAttr", "userRole" ]
                }
            }
        }
    }
    
    

Create - RADIUS Authentication Service 

/v4_0/services/auth/radius

Use this API command to create a new RADIUS authentication service.

  • Request
  • Body
    {
        "name" : "authenticationServiceName",
        "primary" : {
            "ip" : "192.168.1.1",
            "port" : 1812,
            "sharedSecret" : "abc"
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the RADIUS authentication service"
            },
            "friendlyName" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Friendly name of the RADIUS authentication service"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the RADIUS authentication service"
            },
            "locationDeliveryEnabled" : {
                "description" : "RFC5580 out of band location delivery support(for Ruckus AP only)",
                "type" : "boolean",
                "default" : false
            },
            "primary" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "ip" : {
                        "type" : "string",
                        "description" : "Server IP"
                    },
                    "port" : {
                        "description" : "Server port",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 65535
                    },
                    "sharedSecret" : {
                        "description" : "Server shared secrect",
                        "type" : "string"
                    }
                },
                "required" : [ "ip", "port", "sharedSecret" ],
                "description" : "Primary RADIUS server"
            },
            "secondary" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "autoFallbackDisable" : {
                        "descriptin" : "Automatic fallback enabled or disabled",
                        "type" : "boolean"
                    },
                    "ip" : {
                        "type" : "string",
                        "description" : "RADIUS server IP"
                    },
                    "port" : {
                        "description" : "RADIUS server port",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 65535,
                        "default" : 1812
                    },
                    "sharedSecret" : {
                        "description" : "RADIUS server shared secrect",
                        "type" : "string"
                    }
                },
                "required" : [ "autoFallbackDisable", "ip", "port", "sharedSecret" ],
                "description" : "Secondary RADIUS server"
            },
            "healthCheckPolicy" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "responseWindow" : {
                        "description" : "Response window",
                        "type" : "integer",
                        "minimum" : 5,
                        "maximum" : 30,
                        "default" : 20
                    },
                    "reviveInterval" : {
                        "description" : "Revive interval",
                        "type" : "integer",
                        "minimum" : 60,
                        "maximum" : 3600,
                        "default" : 120
                    },
                    "zombiePeriod" : {
                        "description" : "Zombie period",
                        "type" : "integer",
                        "minimum" : 30,
                        "maximum" : 120,
                        "default" : 40
                    }
                },
                "required" : [ "responseWindow", "reviveInterval", "zombiePeriod" ],
                "description" : "Health check policy"
            },
            "rateLimiting" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "maxOutstandingRequestsPerServer" : {
                        "description" : "Maximum outstanding requests (MOR), value should be 0 or between 10 and 4096",
                        "type" : "integer",
                        "default" : 0
                    },
                    "threshold" : {
                        "description" : "Threshold, value should be 0 if MOR is 0, or between 10 and 90 if MOR is between 10 and 4096",
                        "type" : "integer",
                        "default" : 0
                    },
                    "sanityTimer" : {
                        "description" : "Sanity timer ",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 3600,
                        "default" : 10
                    }
                },
                "required" : [ "maxOutstandingRequestsPerServer", "threshold", "sanityTimer" ],
                "description" : "Rate limiting"
            },
            "mappings" : {
                "type" : "array",
                "description" : "Group attribute and user traffic profile mapping",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "User traffic profile mapping",
                    "properties" : {
                        "groupAttr" : {
                            "type" : "string",
                            "description" : "Group attribute"
                        },
                        "userRole" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "description" : "Identity user role",
                            "properties" : {
                                "id" : {
                                    "type" : "string",
                                    "description" : "Identity user role UUID"
                                },
                                "name" : {
                                    "type" : "string",
                                    "minLength" : 2,
                                    "maxLength" : 32,
                                    "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                                    "description" : "Identity user role name"
                                }
                            }
                        }
                    },
                    "required" : [ "groupAttr", "userRole" ]
                }
            }
        },
        "required" : [ "name", "primary" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "serviceUUID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            }
        }
    }
    
    

Modify - RADIUS Authentication Service 

/v4_0/services/auth/radius/{id}

Use this API command to modify the basic information of a RADIUS authentication service.

  • Request
  • Body
    {
        "name" : "new name",
        "description" : "new description"
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Name of the RADIUS authentication service"
        },
        "friendlyName" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Friendly name of the RADIUS authentication service"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Description of the RADIUS authentication service"
        },
        "locationDeliveryEnabled" : {
            "description" : "RFC5580 out of band location delivery support(for Ruckus AP only)",
            "type" : "boolean",
            "default" : false
        }
    }
    
    
  • Response  204

Modify - Primary RADIUS Server of Authentication Service 

/v4_0/services/auth/radius/{id}/primary

Use this API command to modify primary RADIUS server of a RADIUS authentication service.

  • Request
  • Body
    {
        "ip" : "1.1.1.155",
        "port" : 1812,
        "sharedSecret" : "abc"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "ip" : {
                "type" : "string",
                "description" : "Server IP"
            },
            "port" : {
                "description" : "Server port",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 65535
            },
            "sharedSecret" : {
                "description" : "Server shared secrect",
                "type" : "string"
            }
        },
        "required" : [ "ip", "port", "sharedSecret" ],
        "description" : "Primary RADIUS server"
    }
    
    
  • Response  204

Modify - Secondary RADIUS Server of Authentication Service 

/v4_0/services/auth/radius/{id}/secondary

Use this API command to modify secondary RADIUS server of a RADIUS authentication service.

  • Request
  • Body
    {
        "ip" : "2.2.2.231",
        "port" : 1812,
        "sharedSecret" : "abc"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "autoFallbackDisable" : {
                "descriptin" : "Automatic fallback enabled or disabled",
                "type" : "boolean"
            },
            "ip" : {
                "type" : "string",
                "description" : "RADIUS server IP"
            },
            "port" : {
                "description" : "RADIUS server port",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 65535,
                "default" : 1812
            },
            "sharedSecret" : {
                "description" : "RADIUS server shared secrect",
                "type" : "string"
            }
        },
        "required" : [ "autoFallbackDisable", "ip", "port", "sharedSecret" ],
        "description" : "Secondary RADIUS server"
    }
    
    
  • Response  204

Modify - Rate Limiting of Authentication Service 

/v4_0/services/auth/radius/{id}/rateLimiting

Use this API command to modify rate limiting of a RADIUS authentication service.

  • Request
  • Body
    {
        "maxOutstandingRequestsPerServer" : 0,
        "threshold" : 0,
        "sanityTimer" : 10
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "maxOutstandingRequestsPerServer" : {
                "description" : "Maximum outstanding requests (MOR), value should be 0 or between 10 and 4096",
                "type" : "integer",
                "default" : 0
            },
            "threshold" : {
                "description" : "Threshold, value should be 0 if MOR is 0, or between 10 and 90 if MOR is between 10 and 4096",
                "type" : "integer",
                "default" : 0
            },
            "sanityTimer" : {
                "description" : "Sanity timer ",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 3600,
                "default" : 10
            }
        },
        "required" : [ "maxOutstandingRequestsPerServer", "threshold", "sanityTimer" ],
        "description" : "Rate limiting"
    }
    
    
  • Response  204

Modify - Health Check Policy of Authentication Service 

/v4_0/services/auth/radius/{id}/healthCheckPolicy

Use this API command to modify health check policy of a RADIUS authentication service.

  • Request
  • Body
    {
        "responseWindow" : 20,
        "reviveInterval" : 120,
        "zombiePeriod" : 40
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "responseWindow" : {
                "description" : "Response window",
                "type" : "integer",
                "minimum" : 5,
                "maximum" : 30,
                "default" : 20
            },
            "reviveInterval" : {
                "description" : "Revive interval",
                "type" : "integer",
                "minimum" : 60,
                "maximum" : 3600,
                "default" : 120
            },
            "zombiePeriod" : {
                "description" : "Zombie period",
                "type" : "integer",
                "minimum" : 30,
                "maximum" : 120,
                "default" : 40
            }
        },
        "required" : [ "responseWindow", "reviveInterval", "zombiePeriod" ],
        "description" : "Health check policy"
    }
    
    
  • Response  204

Modify - User Traffic Profile Mapping 

/v4_0/services/auth/radius/{id}/mappings

Use this API command to modify user traffic profile mapping of a RADIUS authentication service.

  • Request
  • Body
    [ {
        "groupAttr" : "newGroupAttr",
        "userRole" : {
            "id" : "identity user role UUID"
        }
    }, {
        "groupAttr" : "*",
        "userRole" : {
            "name" : "identity user role name"
        }
    } ]
    
    
    Schema
    {
        "type" : "array",
        "description" : "Group attribute and user traffic profile mapping",
        "items" : {
            "type" : "object",
            "additionalProperties" : false,
            "description" : "User traffic profile mapping",
            "properties" : {
                "groupAttr" : {
                    "type" : "string",
                    "description" : "Group attribute"
                },
                "userRole" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "Identity user role",
                    "properties" : {
                        "id" : {
                            "type" : "string",
                            "description" : "Identity user role UUID"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Identity user role name"
                        }
                    }
                }
            },
            "required" : [ "groupAttr", "userRole" ]
        }
    }
    
    
  • Response  204

Disable Secondary RADIUS Server of Authentication Service 

/v4_0/services/auth/radius/{id}/secondary

Use this API command to disable secondary RADIUS server of a RADIUS authentication service.

  • Response  204

Delete - RADIUS Authentication Service 

/v4_0/services/auth/radius/{id}

Use this API command to delete a RADIUS authentication service.

  • Response  204

Retrieve List - Active Directory Authentication Service 

/v4_0/services/auth/ad

Use this API command to retrieve a list of active directory authentication services.

  • Response  200
  • Body
    {
        "totalCount" : 1,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "49322250-6afd-11e4-832a-dc6020524153",
            "mvnoId" : "839f87c6-d116-497e-afce-aa8157abd30c",
            "name" : "rapheal-ad",
            "friendlyName" : "",
            "description" : "",
            "mappings" : [ {
                "id" : "c7608860-6afd-11e4-b9bb-08002716c79f",
                "groupAttr" : "*",
                "userRole" : {
                    "id" : "636431d6-c06e-4692-a28f-3914afc2a817",
                    "name" : "identity user role name",
                    "userTrafficProfile" : {
                        "id" : "fbde8510-6972-11e4-926e-08002716c79f",
                        "name" : "System Default"
                    }
                }
            } ],
            "ip" : "1.1.1.1",
            "port" : 3268,
            "windowsDomainName" : "dc=domain",
            "adminDomainName" : "[email protected]",
            "password" : "abced",
            "globalCatalogEnabled" : true
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the active directory authentication service",
                            "type" : "string"
                        },
                        "mvnoId" : {
                            "description" : "Tenant UUID",
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the active directory authentication service"
                        },
                        "friendlyName" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Friendly name of the active directory authentication service"
                        },
                        "description" : {
                            "type" : [ "string", "null" ],
                            "maxLength" : 64,
                            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                            "description" : "Description of the active directory authentication service"
                        },
                        "ip" : {
                            "type" : "string",
                            "description" : "IP address"
                        },
                        "port" : {
                            "description" : "Port",
                            "type" : "integer",
                            "minimum" : 1,
                            "maximum" : 65535,
                            "default" : 389
                        },
                        "windowsDomainName" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 64,
                            "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
                            "description" : "Windows domain name"
                        },
                        "adminDomainName" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 64,
                            "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
                            "description" : "Admin domain name"
                        },
                        "password" : {
                            "description" : "Admin password",
                            "type" : "string"
                        },
                        "globalCatalogEnabled" : {
                            "description" : "Global catalog support enabled or disabled",
                            "type" : "boolean"
                        },
                        "mappings" : {
                            "type" : "array",
                            "description" : "Group attribute and user traffic profile mapping",
                            "items" : {
                                "type" : "object",
                                "additionalProperties" : false,
                                "description" : "User traffic profile mapping",
                                "properties" : {
                                    "id" : {
                                        "type" : "string",
                                        "description" : "Group attribute mapping UUID"
                                    },
                                    "groupAttr" : {
                                        "type" : "string",
                                        "description" : "Group attribute"
                                    },
                                    "userRole" : {
                                        "type" : "object",
                                        "additionalProperties" : false,
                                        "description" : "Identity user role",
                                        "properties" : {
                                            "id" : {
                                                "type" : "string",
                                                "description" : "Identity user role UUID"
                                            },
                                            "name" : {
                                                "type" : "string",
                                                "minLength" : 2,
                                                "maxLength" : 32,
                                                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                                                "description" : "Identity user role name"
                                            },
                                            "userTrafficProfile" : {
                                                "type" : "object",
                                                "description" : "Identity user role",
                                                "properties" : {
                                                    "id" : {
                                                        "type" : "string",
                                                        "description" : "User traffic profile UUID"
                                                    },
                                                    "name" : {
                                                        "type" : "string",
                                                        "description" : "User traffic profile name"
                                                    }
                                                }
                                            }
                                        }
                                    }
                                },
                                "required" : [ "groupAttr", "userRole" ]
                            }
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve - Active Directory Authentication Service 

/v4_0/services/auth/ad/{id}

Use this API command to retrieve an active directory authentication service.

  • Response  200
  • Body
    {
        "id" : "49322250-6afd-11e4-832a-dc6020524153",
        "mvnoId" : "839f87c6-d116-497e-afce-aa8157abd30c",
        "name" : "rapheal-ad",
        "friendlyName" : "",
        "description" : "",
        "mappings" : [ {
            "id" : "c7608860-6afd-11e4-b9bb-08002716c79f",
            "groupAttr" : "*",
            "userRole" : {
                "id" : "636431d6-c06e-4692-a28f-3914afc2a817",
                "name" : "identity user role name",
                "userTrafficProfile" : {
                    "id" : "fbde8510-6972-11e4-926e-08002716c79f",
                    "name" : "System Default"
                }
            }
        } ],
        "ip" : "1.1.1.1",
        "port" : 3268,
        "windowsDomainName" : "dc=domain",
        "adminDomainName" : "[email protected]",
        "password" : "abced",
        "globalCatalogEnabled" : true
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the active directory authentication service",
                "type" : "string"
            },
            "mvnoId" : {
                "description" : "Tenant UUID",
                "type" : "string"
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the active directory authentication service"
            },
            "friendlyName" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Friendly name of the active directory authentication service"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the active directory authentication service"
            },
            "ip" : {
                "type" : "string",
                "description" : "IP address"
            },
            "port" : {
                "description" : "Port",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 65535,
                "default" : 389
            },
            "windowsDomainName" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 64,
                "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
                "description" : "Windows domain name"
            },
            "adminDomainName" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 64,
                "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
                "description" : "Admin domain name"
            },
            "password" : {
                "description" : "Admin password",
                "type" : "string"
            },
            "globalCatalogEnabled" : {
                "description" : "Global catalog support enabled or disabled",
                "type" : "boolean"
            },
            "mappings" : {
                "type" : "array",
                "description" : "Group attribute and user traffic profile mapping",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "User traffic profile mapping",
                    "properties" : {
                        "id" : {
                            "type" : "string",
                            "description" : "Group attribute mapping UUID"
                        },
                        "groupAttr" : {
                            "type" : "string",
                            "description" : "Group attribute"
                        },
                        "userRole" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "description" : "Identity user role",
                            "properties" : {
                                "id" : {
                                    "type" : "string",
                                    "description" : "Identity user role UUID"
                                },
                                "name" : {
                                    "type" : "string",
                                    "minLength" : 2,
                                    "maxLength" : 32,
                                    "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                                    "description" : "Identity user role name"
                                },
                                "userTrafficProfile" : {
                                    "type" : "object",
                                    "description" : "Identity user role",
                                    "properties" : {
                                        "id" : {
                                            "type" : "string",
                                            "description" : "User traffic profile UUID"
                                        },
                                        "name" : {
                                            "type" : "string",
                                            "description" : "User traffic profile name"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "required" : [ "groupAttr", "userRole" ]
                }
            }
        }
    }
    
    

Create - Active Directory Authentication Service 

/v4_0/services/auth/ad

Use this API command to create a new active directory authentication service.

  • Request
  • Body
    {
        "name" : "rapheal-ad2",
        "ip" : "1.1.1.15",
        "port" : 389,
        "windowsDomainName" : "dc=domain",
        "globalCatalogEnabled" : false
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the active directory authentication service"
            },
            "friendlyName" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Friendly name of the active directory authentication service"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the active directory authentication service"
            },
            "ip" : {
                "type" : "string",
                "description" : "IP address"
            },
            "port" : {
                "description" : "Port",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 65535,
                "default" : 389
            },
            "windowsDomainName" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 64,
                "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
                "description" : "Windows domain name"
            },
            "adminDomainName" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 64,
                "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
                "description" : "Admin domain name"
            },
            "password" : {
                "description" : "Admin password",
                "type" : "string"
            },
            "globalCatalogEnabled" : {
                "description" : "Global catalog support enabled or disabled",
                "type" : "boolean"
            },
            "mappings" : {
                "type" : "array",
                "description" : "Group attribute and user traffic profile mapping",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "User traffic profile mapping",
                    "properties" : {
                        "groupAttr" : {
                            "type" : "string",
                            "description" : "Group attribute"
                        },
                        "userRole" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "description" : "Identity user role",
                            "properties" : {
                                "id" : {
                                    "type" : "string",
                                    "description" : "Identity user role UUID"
                                },
                                "name" : {
                                    "type" : "string",
                                    "minLength" : 2,
                                    "maxLength" : 32,
                                    "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                                    "description" : "Identity user role name"
                                }
                            }
                        }
                    },
                    "required" : [ "groupAttr", "userRole" ]
                }
            }
        },
        "required" : [ "name", "ip", "port", "windowsDomainName", "globalCatalogEnabled" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "serviceUUID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            }
        }
    }
    
    

Modify - Active Directory Authentication Service 

/v4_0/services/auth/ad/{id}

Use this API command to modify the basic information of an active directory authentication service.

  • Request
  • Body
    {
        "adminDomainName" : "[email protected]",
        "password" : "newpassword",
        "globalCatalogEnabled" : true
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Name of the active directory authentication service"
        },
        "friendlyName" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Friendly name of the active directory authentication service"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Description of the active directory authentication service"
        },
        "ip" : {
            "type" : "string",
            "description" : "IP address"
        },
        "port" : {
            "description" : "Port",
            "type" : "integer",
            "minimum" : 1,
            "maximum" : 65535,
            "default" : 389
        },
        "windowsDomainName" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 64,
            "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
            "description" : "Windows domain name"
        },
        "adminDomainName" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 64,
            "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
            "description" : "Admin domain name"
        },
        "password" : {
            "description" : "Admin password",
            "type" : "string"
        },
        "globalCatalogEnabled" : {
            "description" : "Global catalog support enabled or disabled",
            "type" : "boolean"
        }
    }
    
    
  • Response  204

Modify - User Traffic Profile Mapping of Active Directory 

/v4_0/services/auth/ad/{id}/mappings

Use this API command to modify user traffic profile mapping of an active directory authentication service.

  • Request
  • Body
    [ {
        "groupAttr" : "newGroupAttr",
        "userRole" : {
            "id" : "identity user role UUID"
        }
    }, {
        "groupAttr" : "*",
        "userRole" : {
            "name" : "identity user role name"
        }
    } ]
    
    
    Schema
    {
        "type" : "array",
        "description" : "Group attribute and user traffic profile mapping",
        "items" : {
            "type" : "object",
            "additionalProperties" : false,
            "description" : "User traffic profile mapping",
            "properties" : {
                "groupAttr" : {
                    "type" : "string",
                    "description" : "Group attribute"
                },
                "userRole" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "Identity user role",
                    "properties" : {
                        "id" : {
                            "type" : "string",
                            "description" : "Identity user role UUID"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Identity user role name"
                        }
                    }
                }
            },
            "required" : [ "groupAttr", "userRole" ]
        }
    }
    
    
  • Response  204

Delete - Active Directory Authentication Service 

/v4_0/services/auth/ad/{id}

Use this API command to delete an active directory authentication service.

  • Response  204

Retrieve List - LDAP Authentication Service 

/v4_0/services/auth/ldap

Use this API command to retrieve a list of LDAP authentication services.

  • Response  200
  • Body
    {
        "totalCount" : 1,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "18b76a50-6a57-11e4-96af-dc6020524153",
            "mvnoId" : "839f87c6-d116-497e-afce-aa8157abd30c",
            "name" : "rapheal-ldap",
            "friendlyName" : "",
            "description" : "",
            "mappings" : [ {
                "id" : "afa788e0-6afd-11e4-b9bb-08002716c79f",
                "groupAttr" : "*",
                "userRole" : {
                    "id" : "636431d6-c06e-4692-a28f-3914afc2a817",
                    "name" : "identity user role name",
                    "userTrafficProfile" : {
                        "id" : "fbde8510-6972-11e4-926e-08002716c79f",
                        "name" : "System Default"
                    }
                }
            }, {
                "id" : "afaa4800-6afd-11e4-b9bb-08002716c79f",
                "groupAttr" : "abcd",
                "userRole" : {
                    "id" : "636431d6-c06e-4692-a28f-3914afc2a817",
                    "name" : "identity user role name",
                    "userTrafficProfile" : {
                        "id" : "fbde8510-6972-11e4-926e-08002716c79f",
                        "name" : "System Default"
                    }
                }
            } ],
            "ip" : "1.1.1.122",
            "port" : 389,
            "baseDomainName" : "dc=ldap",
            "adminDomainName" : "uid=ibm",
            "password" : "admin",
            "keyAttribute" : "uid",
            "searchFilter" : "(objectClass=*)"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the LDAP authentication service",
                            "type" : "string"
                        },
                        "mvnoId" : {
                            "description" : "Tenant UUID",
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the LDAP authentication service"
                        },
                        "friendlyName" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Friendly name of the LDAP authentication service"
                        },
                        "description" : {
                            "type" : [ "string", "null" ],
                            "maxLength" : 64,
                            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                            "description" : "Description of the LDAP authentication service"
                        },
                        "ip" : {
                            "type" : "string",
                            "description" : "IP address"
                        },
                        "port" : {
                            "description" : "Port",
                            "type" : "integer"
                        },
                        "baseDomainName" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 64,
                            "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
                            "description" : "Base domain name"
                        },
                        "adminDomainName" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 64,
                            "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
                            "description" : "Admin domain name"
                        },
                        "password" : {
                            "description" : "Admin password",
                            "type" : "string"
                        },
                        "keyAttribute" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 64,
                            "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
                            "description" : "Key attribute"
                        },
                        "searchFilter" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 64,
                            "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
                            "description" : "Search filter"
                        },
                        "mappings" : {
                            "type" : "array",
                            "description" : "Group attribute and user traffic profile mapping",
                            "items" : {
                                "type" : "object",
                                "additionalProperties" : false,
                                "description" : "User traffic profile mapping",
                                "properties" : {
                                    "id" : {
                                        "type" : "string",
                                        "description" : "Group attribute mapping UUID"
                                    },
                                    "groupAttr" : {
                                        "type" : "string",
                                        "description" : "Group attribute"
                                    },
                                    "userRole" : {
                                        "type" : "object",
                                        "additionalProperties" : false,
                                        "description" : "Identity user role",
                                        "properties" : {
                                            "id" : {
                                                "type" : "string",
                                                "description" : "Identity user role UUID"
                                            },
                                            "name" : {
                                                "type" : "string",
                                                "minLength" : 2,
                                                "maxLength" : 32,
                                                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                                                "description" : "Identity user role name"
                                            },
                                            "userTrafficProfile" : {
                                                "type" : "object",
                                                "description" : "Identity user role",
                                                "properties" : {
                                                    "id" : {
                                                        "type" : "string",
                                                        "description" : "User traffic profile UUID"
                                                    },
                                                    "name" : {
                                                        "type" : "string",
                                                        "description" : "User traffic profile name"
                                                    }
                                                }
                                            }
                                        }
                                    }
                                },
                                "required" : [ "groupAttr", "userRole" ]
                            }
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve - LDAP Authentication Service 

/v4_0/services/auth/ldap/{id}

Use this API command to retrieve a LDAP authentication service.

  • Response  200
  • Body
    {
        "id" : "18b76a50-6a57-11e4-96af-dc6020524153",
        "mvnoId" : "839f87c6-d116-497e-afce-aa8157abd30c",
        "name" : "rapheal-ldap",
        "friendlyName" : "",
        "description" : "",
        "mappings" : [ {
            "id" : "afa788e0-6afd-11e4-b9bb-08002716c79f",
            "groupAttr" : "*",
            "userRole" : {
                "id" : "636431d6-c06e-4692-a28f-3914afc2a817",
                "name" : "identity user role name",
                "userTrafficProfile" : {
                    "id" : "fbde8510-6972-11e4-926e-08002716c79f",
                    "name" : "System Default"
                }
            }
        }, {
            "id" : "afaa4800-6afd-11e4-b9bb-08002716c79f",
            "groupAttr" : "abcd",
            "userRole" : {
                "id" : "636431d6-c06e-4692-a28f-3914afc2a817",
                "name" : "identity user role name",
                "userTrafficProfile" : {
                    "id" : "fbde8510-6972-11e4-926e-08002716c79f",
                    "name" : "System Default"
                }
            }
        } ],
        "ip" : "1.1.1.122",
        "port" : 389,
        "baseDomainName" : "dc=ldap",
        "adminDomainName" : "uid=ibm",
        "password" : "admin",
        "keyAttribute" : "uid",
        "searchFilter" : "(objectClass=*)"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the LDAP authentication service",
                "type" : "string"
            },
            "mvnoId" : {
                "description" : "Tenant UUID",
                "type" : "string"
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the LDAP authentication service"
            },
            "friendlyName" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Friendly name of the LDAP authentication service"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the LDAP authentication service"
            },
            "ip" : {
                "type" : "string",
                "description" : "IP address"
            },
            "port" : {
                "description" : "Port",
                "type" : "integer"
            },
            "baseDomainName" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 64,
                "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
                "description" : "Base domain name"
            },
            "adminDomainName" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 64,
                "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
                "description" : "Admin domain name"
            },
            "password" : {
                "description" : "Admin password",
                "type" : "string"
            },
            "keyAttribute" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 64,
                "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
                "description" : "Key attribute"
            },
            "searchFilter" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 64,
                "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
                "description" : "Search filter"
            },
            "mappings" : {
                "type" : "array",
                "description" : "Group attribute and user traffic profile mapping",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "User traffic profile mapping",
                    "properties" : {
                        "id" : {
                            "type" : "string",
                            "description" : "Group attribute mapping UUID"
                        },
                        "groupAttr" : {
                            "type" : "string",
                            "description" : "Group attribute"
                        },
                        "userRole" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "description" : "Identity user role",
                            "properties" : {
                                "id" : {
                                    "type" : "string",
                                    "description" : "Identity user role UUID"
                                },
                                "name" : {
                                    "type" : "string",
                                    "minLength" : 2,
                                    "maxLength" : 32,
                                    "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                                    "description" : "Identity user role name"
                                },
                                "userTrafficProfile" : {
                                    "type" : "object",
                                    "description" : "Identity user role",
                                    "properties" : {
                                        "id" : {
                                            "type" : "string",
                                            "description" : "User traffic profile UUID"
                                        },
                                        "name" : {
                                            "type" : "string",
                                            "description" : "User traffic profile name"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "required" : [ "groupAttr", "userRole" ]
                }
            }
        }
    }
    
    

Create - LDAP Authentication Service 

/v4_0/services/auth/ldap

Use this API command to create a new LDAP authentication service.

  • Request
  • Body
    {
        "name" : "rapheal-ldap",
        "ip" : "1.1.1.1",
        "port" : 389,
        "baseDomainName" : "dc=ldap",
        "adminDomainName" : "uid=ibm",
        "password" : "admin",
        "keyAttribute" : "uid",
        "searchFilter" : "(objectClass=*)"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the LDAP authentication service"
            },
            "friendlyName" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Friendly name of the LDAP authentication service"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the LDAP authentication service"
            },
            "ip" : {
                "type" : "string",
                "description" : "IP address"
            },
            "port" : {
                "description" : "Port",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 65535,
                "default" : 389
            },
            "baseDomainName" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 64,
                "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
                "description" : "Base domain name"
            },
            "adminDomainName" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 64,
                "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
                "description" : "Admin domain name"
            },
            "password" : {
                "description" : "Admin password",
                "type" : "string"
            },
            "keyAttribute" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 64,
                "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
                "description" : "Key attribute"
            },
            "searchFilter" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 64,
                "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
                "description" : "Search filter"
            },
            "mappings" : {
                "type" : "array",
                "description" : "Group attribute and user traffic profile mapping",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "User traffic profile mapping",
                    "properties" : {
                        "groupAttr" : {
                            "type" : "string",
                            "description" : "Group attribute"
                        },
                        "userRole" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "description" : "Identity user role",
                            "properties" : {
                                "id" : {
                                    "type" : "string",
                                    "description" : "Identity user role UUID"
                                },
                                "name" : {
                                    "type" : "string",
                                    "minLength" : 2,
                                    "maxLength" : 32,
                                    "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                                    "description" : "Identity user role name"
                                }
                            }
                        }
                    },
                    "required" : [ "groupAttr", "userRole" ]
                }
            }
        },
        "required" : [ "name", "ip", "port", "baseDomainName", "adminDomainName", "password", "keyAttribute", "searchFilter" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "serviceUUID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            }
        }
    }
    
    

Modify - LDAP Authentication Service 

/v4_0/services/auth/ldap/{id}

Use this API command to modify the basic information of a LDAP authentication service.

  • Request
  • Body
    {
        "friendlyName" : "new name",
        "description" : "new description"
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Name of the LDAP authentication service"
        },
        "friendlyName" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Friendly name of the LDAP authentication service"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Description of the LDAP authentication service"
        },
        "ip" : {
            "type" : "string",
            "description" : "IP address"
        },
        "port" : {
            "description" : "Port",
            "type" : "integer",
            "minimum" : 1,
            "maximum" : 65535,
            "default" : 389
        },
        "baseDomainName" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 64,
            "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
            "description" : "Base domain name"
        },
        "adminDomainName" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 64,
            "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
            "description" : "Admin domain name"
        },
        "password" : {
            "description" : "Admin password",
            "type" : "string"
        },
        "keyAttribute" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 64,
            "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
            "description" : "Key attribute"
        },
        "searchFilter" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 64,
            "pattern" : "^[!-~]([ -~]){0,62}[!-~]$",
            "description" : "Search filter"
        }
    }
    
    
  • Response  204

Modify - User Traffic Profile Mapping of LDAP 

/v4_0/services/auth/ldap/{id}/mappings

Use this API command to modify user traffic profile mapping of a LDAP authentication service.

  • Request
  • Body
    [ {
        "groupAttr" : "newGroupAttr",
        "userRole" : {
            "id" : "identity user role UUID"
        }
    }, {
        "groupAttr" : "*",
        "userRole" : {
            "name" : "identity user role name"
        }
    } ]
    
    
    Schema
    {
        "type" : "array",
        "description" : "Group attribute and user traffic profile mapping",
        "items" : {
            "type" : "object",
            "additionalProperties" : false,
            "description" : "User traffic profile mapping",
            "properties" : {
                "groupAttr" : {
                    "type" : "string",
                    "description" : "Group attribute"
                },
                "userRole" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "Identity user role",
                    "properties" : {
                        "id" : {
                            "type" : "string",
                            "description" : "Identity user role UUID"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Identity user role name"
                        }
                    }
                }
            },
            "required" : [ "groupAttr", "userRole" ]
        }
    }
    
    
  • Response  204

Delete - LDAP Authentication Service 

/v4_0/services/auth/ldap/{id}

Use this API command to delete a LDAP authentication service.

  • Response  204

Retrieve List - OAuth Authentication Service 

/v4_0/services/auth/oauth

Use this API command to retrieve a list of OAuth authentication service.

  • Response  200
  • Body
    {
        "totalCount" : 1,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "c74c5340-ac1b-11e4-8a77-08002716c79f",
            "mvnoId" : "839f87c6-d116-497e-afce-aa8157abd30c",
            "name" : "globalOauth",
            "description" : "",
            "mappings" : [ {
                "id" : "c76bc220-ac1b-11e4-8a77-08002716c79f",
                "groupAttr" : "*",
                "userRole" : {
                    "id" : "ad0c58e3-acf7-42a2-a6a7-5a6216110906",
                    "name" : "Default",
                    "userTrafficProfile" : {
                        "id" : "f63a7ad0-8590-11e4-8051-08002716c79f",
                        "name" : "System Default"
                    }
                }
            } ],
            "type" : "FACEBOOK",
            "applicationId" : "test",
            "applicationSecret" : "test",
            "willCollectEmail" : true,
            "defaultWhitelistedDomains" : [ "fbcdn-profile-a.akamaihd.net", "fbstatic-a.akamaihd.net", "www.facebook.com" ],
            "whitelistedDomains" : [ "*.facebook.com", "ruckus.com" ]
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "oauthSpecifiedItems" : true,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the OAuth authentication service",
                            "type" : "string"
                        },
                        "type" : {
                            "description" : "OAuth Type, may be GOOGLE, FACEBOOK or LINKEDIN",
                            "enum" : [ "FACEBOOK", "GOOGLE", "LINKEDIN" ]
                        },
                        "mvnoId" : {
                            "description" : "Tenant UUID",
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the OAuth authentication service"
                        },
                        "description" : {
                            "type" : [ "string", "null" ],
                            "maxLength" : 64,
                            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                            "description" : "Description of the OAuth authentication service"
                        },
                        "applicationId" : {
                            "description" : "Application ID",
                            "type" : "string"
                        },
                        "applicationSecret" : {
                            "description" : "Application Secret",
                            "type" : "string"
                        },
                        "willCollectEmail" : {
                            "description" : "Will collect user's email address",
                            "type" : "boolean"
                        },
                        "defaultWhitelistedDomains" : {
                            "description" : "Defualt whitelisted domains",
                            "type" : "array",
                            "items" : {
                                "type" : "string"
                            }
                        },
                        "whitelistedDomains" : {
                            "description" : "Customized whitelisted domains",
                            "type" : "array",
                            "items" : {
                                "description" : "admin domain name",
                                "type" : "string"
                            }
                        },
                        "mappings" : {
                            "type" : "array",
                            "description" : "Group attribute and user traffic profile mapping",
                            "items" : {
                                "type" : "object",
                                "additionalProperties" : false,
                                "description" : "User traffic profile mapping",
                                "properties" : {
                                    "id" : {
                                        "type" : "string",
                                        "description" : "Group attribute mapping UUID"
                                    },
                                    "groupAttr" : {
                                        "type" : "string",
                                        "description" : "Group attribute"
                                    },
                                    "userRole" : {
                                        "type" : "object",
                                        "additionalProperties" : false,
                                        "description" : "Identity user role",
                                        "properties" : {
                                            "id" : {
                                                "type" : "string",
                                                "description" : "Identity user role UUID"
                                            },
                                            "name" : {
                                                "type" : "string",
                                                "minLength" : 2,
                                                "maxLength" : 32,
                                                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                                                "description" : "Identity user role name"
                                            },
                                            "userTrafficProfile" : {
                                                "type" : "object",
                                                "description" : "Identity user role",
                                                "properties" : {
                                                    "id" : {
                                                        "type" : "string",
                                                        "description" : "User traffic profile UUID"
                                                    },
                                                    "name" : {
                                                        "type" : "string",
                                                        "description" : "User traffic profile name"
                                                    }
                                                }
                                            }
                                        }
                                    }
                                },
                                "required" : [ "groupAttr", "userRole" ]
                            }
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve - OAuth Authentication Service 

/v4_0/services/auth/oauth/{id}

Use this API command to retrieve a OAuth authentication service.

  • Response  200
  • Body
    {
        "id" : "c74c5340-ac1b-11e4-8a77-08002716c79f",
        "mvnoId" : "839f87c6-d116-497e-afce-aa8157abd30c",
        "name" : "globalOauth",
        "description" : "",
        "mappings" : [ {
            "id" : "c76bc220-ac1b-11e4-8a77-08002716c79f",
            "groupAttr" : "*",
            "userRole" : {
                "id" : "ad0c58e3-acf7-42a2-a6a7-5a6216110906",
                "name" : "Default",
                "userTrafficProfile" : {
                    "id" : "f63a7ad0-8590-11e4-8051-08002716c79f",
                    "name" : "System Default"
                }
            }
        } ],
        "type" : "FACEBOOK",
        "applicationId" : "test",
        "applicationSecret" : "test",
        "willCollectEmail" : true,
        "defaultWhitelistedDomains" : [ "fbcdn-profile-a.akamaihd.net", "fbstatic-a.akamaihd.net", "*.facebook.com" ],
        "whitelistedDomains" : [ "ruckus.com" ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the OAuth authentication service",
                "type" : "string"
            },
            "type" : {
                "description" : "OAuth Type, may be GOOGLE, FACEBOOK or LINKEDIN",
                "enum" : [ "FACEBOOK", "GOOGLE", "LINKEDIN" ]
            },
            "mvnoId" : {
                "description" : "Tenant UUID",
                "type" : "string"
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the OAuth authentication service"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the OAuth authentication service"
            },
            "applicationId" : {
                "description" : "Application ID",
                "type" : "string"
            },
            "applicationSecret" : {
                "description" : "Application Secret",
                "type" : "string"
            },
            "willCollectEmail" : {
                "description" : "Will collect user's email address",
                "type" : "boolean"
            },
            "defaultWhitelistedDomains" : {
                "description" : "Defualt whitelisted domains",
                "type" : "array",
                "items" : {
                    "type" : "string"
                }
            },
            "whitelistedDomains" : {
                "description" : "Customized whitelisted domains",
                "type" : "array",
                "items" : {
                    "description" : "admin domain name",
                    "type" : "string"
                }
            },
            "mappings" : {
                "type" : "array",
                "description" : "Group attribute and user traffic profile mapping",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "User traffic profile mapping",
                    "properties" : {
                        "id" : {
                            "type" : "string",
                            "description" : "Group attribute mapping UUID"
                        },
                        "groupAttr" : {
                            "type" : "string",
                            "description" : "Group attribute"
                        },
                        "userRole" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "description" : "Identity user role",
                            "properties" : {
                                "id" : {
                                    "type" : "string",
                                    "description" : "Identity user role UUID"
                                },
                                "name" : {
                                    "type" : "string",
                                    "minLength" : 2,
                                    "maxLength" : 32,
                                    "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                                    "description" : "Identity user role name"
                                },
                                "userTrafficProfile" : {
                                    "type" : "object",
                                    "description" : "Identity user role",
                                    "properties" : {
                                        "id" : {
                                            "type" : "string",
                                            "description" : "User traffic profile UUID"
                                        },
                                        "name" : {
                                            "type" : "string",
                                            "description" : "User traffic profile name"
                                        }
                                    }
                                }
                            }
                        }
                    },
                    "required" : [ "groupAttr", "userRole" ]
                }
            }
        }
    }
    
    

Create - OAuth Authentication Service 

/v4_0/services/auth/oauth

Use this API command to create a new OAuth authentication service.

  • Request
  • Body
    {
        "type" : "GOOGLE",
        "name" : "globalOauth",
        "description" : "create oAuthAuthentication desc",
        "mappings" : [ {
            "groupAttr" : "*",
            "userRole" : {
                "name" : "Default"
            }
        } ],
        "applicationId" : "test",
        "applicationSecret" : "test",
        "willCollectEmail" : true,
        "whitelistedDomains" : [ "ruckus.com" ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "type" : {
                "description" : "OAuth Type, may be GOOGLE, FACEBOOK or LINKEDIN",
                "enum" : [ "FACEBOOK", "GOOGLE", "LINKEDIN" ]
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the OAuth authentication service"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the OAuth authentication service"
            },
            "applicationId" : {
                "description" : "Application ID",
                "type" : "string"
            },
            "applicationSecret" : {
                "description" : "Application Secret",
                "type" : "string"
            },
            "willCollectEmail" : {
                "description" : "Will collect user's email address",
                "type" : "boolean"
            },
            "whitelistedDomains" : {
                "description" : "Admin domain name",
                "type" : "array",
                "items" : {
                    "type" : "string"
                }
            },
            "mappings" : {
                "type" : "array",
                "description" : "Group attribute and user traffic profile mapping",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "User traffic profile mapping",
                    "properties" : {
                        "groupAttr" : {
                            "type" : "string",
                            "description" : "Group attribute"
                        },
                        "userRole" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "description" : "Identity user role",
                            "properties" : {
                                "id" : {
                                    "type" : "string",
                                    "description" : "Identity user role UUID"
                                },
                                "name" : {
                                    "type" : "string",
                                    "minLength" : 2,
                                    "maxLength" : 32,
                                    "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                                    "description" : "Identity user role name"
                                }
                            }
                        }
                    },
                    "required" : [ "groupAttr", "userRole" ]
                }
            }
        },
        "required" : [ "type", "name", "applicationId", "applicationSecret", "willCollectEmail" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "serviceUUID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            }
        }
    }
    
    

Modify - OAuth Authentication Service 

/v4_0/services/auth/oauth/{id}

Use this API command to modify the basic information of an OAuth authentication service.

  • Request
  • Body
    {
        "name" : "globalOauth",
        "description" : "modify oAuthAuthentication desc",
        "applicationId" : "test",
        "applicationSecret" : "test",
        "willCollectEmail" : true
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Name of the OAuth authentication service"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Description of the OAuth authentication service"
        },
        "applicationId" : {
            "description" : "Application ID",
            "type" : "string"
        },
        "applicationSecret" : {
            "description" : "Application Secret",
            "type" : "string"
        },
        "willCollectEmail" : {
            "description" : "Will collect user's email address",
            "type" : "boolean"
        }
    }
    
    
  • Response  204

Modify - Whitelisted Domains of OAuth 

/v4_0/services/auth/oauth/{id}/whitelistedDomains

Use this API command to modify whitelisted domains of an OAuth authentication service.

  • Request
  • Body
    [ "ruckus.com" ]
    
    
    Schema
    {
        "description" : "Admin domain name",
        "type" : "array",
        "items" : {
            "type" : "string"
        }
    }
    
    
  • Response  204

Modify - User Traffic Profile Mapping of OAuth 

/v4_0/services/auth/oauth/{id}/mappings

Use this API command to modify user traffic profile mapping of an OAuth authentication service.

  • Request
  • Body
    [ {
        "groupAttr" : "*",
        "userRole" : {
            "name" : "Default"
        }
    } ]
    
    
    Schema
    {
        "type" : "array",
        "description" : "Group attribute and user traffic profile mapping",
        "items" : {
            "type" : "object",
            "additionalProperties" : false,
            "description" : "User traffic profile mapping",
            "properties" : {
                "groupAttr" : {
                    "type" : "string",
                    "description" : "Group attribute"
                },
                "userRole" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "description" : "Identity user role",
                    "properties" : {
                        "id" : {
                            "type" : "string",
                            "description" : "Identity user role UUID"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Identity user role name"
                        }
                    }
                }
            },
            "required" : [ "groupAttr", "userRole" ]
        }
    }
    
    
  • Response  204

Delete - OAuth Authentication Service 

/v4_0/services/auth/oauth/{id}

Use this API command to delete an OAuth authentication service.

  • Response  204

Accounting Service 

Retrieve List - RADIUS Accounting Service 

/v4_0/services/acct/radius

Use this API command to retrieve a list of RADIUS accounting services.

  • Response  200
  • Body
    {
        "totalCount" : 1,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "accountingServiceUUID",
            "mvnoId" : "userMVNOId",
            "name" : "accountingServiceName",
            "description" : "accountingServiceDescription",
            "primary" : {
                "ip" : "192.168.1.1",
                "port" : 1812,
                "sharedSecret" : "sharedSecret"
            },
            "secondary" : {
                "ip" : "192.168.1.2",
                "port" : 1812,
                "sharedSecret" : "sharedSecret"
            },
            "healthCheckPolicy" : {
                "responseWindow" : 20,
                "reviveInterval" : 120,
                "zombiePeriod" : 40
            },
            "rateLimiting" : {
                "maxOutstandingRequestsPerServer" : 0,
                "threshold" : 0,
                "sanityTimer" : 10
            }
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the RADIUS accounting service",
                            "type" : "string"
                        },
                        "mvnoId" : {
                            "description" : "Tenant UUID",
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the RADIUS accounting service"
                        },
                        "description" : {
                            "type" : [ "string", "null" ],
                            "maxLength" : 64,
                            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                            "description" : "Description of the RADIUS accounting service"
                        },
                        "primary" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                                "ip" : {
                                    "type" : "string",
                                    "description" : "Server IP"
                                },
                                "port" : {
                                    "description" : "Server port",
                                    "type" : "integer",
                                    "minimum" : 1,
                                    "maximum" : 65535
                                },
                                "sharedSecret" : {
                                    "description" : "Server shared secrect",
                                    "type" : "string"
                                }
                            },
                            "required" : [ "ip", "port", "sharedSecret" ],
                            "description" : "Primary RADIUS server"
                        },
                        "secondary" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                                "autoFallbackDisable" : {
                                    "descriptin" : "Automatic fallback enabled or disabled",
                                    "type" : "boolean"
                                },
                                "ip" : {
                                    "type" : "string",
                                    "description" : "RADIUS server IP"
                                },
                                "port" : {
                                    "description" : "RADIUS server port",
                                    "type" : "integer",
                                    "minimum" : 1,
                                    "maximum" : 65535,
                                    "default" : 1812
                                },
                                "sharedSecret" : {
                                    "description" : "RADIUS server shared secrect",
                                    "type" : "string"
                                }
                            },
                            "required" : [ "autoFallbackDisable", "ip", "port", "sharedSecret" ],
                            "description" : "Secondary RADIUS server"
                        },
                        "healthCheckPolicy" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                                "responseWindow" : {
                                    "description" : "Response window",
                                    "type" : "integer",
                                    "minimum" : 5,
                                    "maximum" : 30,
                                    "default" : 20
                                },
                                "reviveInterval" : {
                                    "description" : "Revive interval",
                                    "type" : "integer",
                                    "minimum" : 60,
                                    "maximum" : 3600,
                                    "default" : 120
                                },
                                "zombiePeriod" : {
                                    "description" : "Zombie period",
                                    "type" : "integer",
                                    "minimum" : 30,
                                    "maximum" : 120,
                                    "default" : 40
                                }
                            },
                            "required" : [ "responseWindow", "reviveInterval", "zombiePeriod" ],
                            "description" : "Health check policy"
                        },
                        "rateLimiting" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                                "maxOutstandingRequestsPerServer" : {
                                    "description" : "Maximum outstanding requests (MOR), value should be 0 or between 10 and 4096",
                                    "type" : "integer",
                                    "default" : 0
                                },
                                "threshold" : {
                                    "description" : "Threshold, value should be 0 if MOR is 0, or between 10 and 90 if MOR is between 10 and 4096",
                                    "type" : "integer",
                                    "default" : 0
                                },
                                "sanityTimer" : {
                                    "description" : "Sanity timer ",
                                    "type" : "integer",
                                    "minimum" : 1,
                                    "maximum" : 3600,
                                    "default" : 10
                                }
                            },
                            "required" : [ "maxOutstandingRequestsPerServer", "threshold", "sanityTimer" ],
                            "description" : "Rate limiting"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve - RADIUS Accounting Service 

/v4_0/services/acct/radius/{id}

Use this API command to retrieve a RADIUS accounting service.

  • Response  200
  • Body
    {
        "id" : "accountingServiceUUID",
        "mvnoId" : "userMVNOId",
        "name" : "accountingServiceName",
        "description" : "accountingServiceDescription",
        "primary" : {
            "ip" : "192.168.1.1",
            "port" : 1812,
            "sharedSecret" : "sharedSecret"
        },
        "secondary" : {
            "ip" : "192.168.1.2",
            "port" : 1812,
            "sharedSecret" : "sharedSecret"
        },
        "healthCheckPolicy" : {
            "responseWindow" : 20,
            "reviveInterval" : 120,
            "zombiePeriod" : 40
        },
        "rateLimiting" : {
            "maxOutstandingRequestsPerServer" : 0,
            "threshold" : 0,
            "sanityTimer" : 10
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the RADIUS accounting service",
                "type" : "string"
            },
            "mvnoId" : {
                "description" : "Tenant UUID",
                "type" : "string"
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the RADIUS accounting service"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the RADIUS accounting service"
            },
            "primary" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "ip" : {
                        "type" : "string",
                        "description" : "Server IP"
                    },
                    "port" : {
                        "description" : "Server port",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 65535
                    },
                    "sharedSecret" : {
                        "description" : "Server shared secrect",
                        "type" : "string"
                    }
                },
                "required" : [ "ip", "port", "sharedSecret" ],
                "description" : "Primary RADIUS server"
            },
            "secondary" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "autoFallbackDisable" : {
                        "descriptin" : "Automatic fallback enabled or disabled",
                        "type" : "boolean"
                    },
                    "ip" : {
                        "type" : "string",
                        "description" : "RADIUS server IP"
                    },
                    "port" : {
                        "description" : "RADIUS server port",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 65535,
                        "default" : 1812
                    },
                    "sharedSecret" : {
                        "description" : "RADIUS server shared secrect",
                        "type" : "string"
                    }
                },
                "required" : [ "autoFallbackDisable", "ip", "port", "sharedSecret" ],
                "description" : "Secondary RADIUS server"
            },
            "healthCheckPolicy" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "responseWindow" : {
                        "description" : "Response window",
                        "type" : "integer",
                        "minimum" : 5,
                        "maximum" : 30,
                        "default" : 20
                    },
                    "reviveInterval" : {
                        "description" : "Revive interval",
                        "type" : "integer",
                        "minimum" : 60,
                        "maximum" : 3600,
                        "default" : 120
                    },
                    "zombiePeriod" : {
                        "description" : "Zombie period",
                        "type" : "integer",
                        "minimum" : 30,
                        "maximum" : 120,
                        "default" : 40
                    }
                },
                "required" : [ "responseWindow", "reviveInterval", "zombiePeriod" ],
                "description" : "Health check policy"
            },
            "rateLimiting" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "maxOutstandingRequestsPerServer" : {
                        "description" : "Maximum outstanding requests (MOR), value should be 0 or between 10 and 4096",
                        "type" : "integer",
                        "default" : 0
                    },
                    "threshold" : {
                        "description" : "Threshold, value should be 0 if MOR is 0, or between 10 and 90 if MOR is between 10 and 4096",
                        "type" : "integer",
                        "default" : 0
                    },
                    "sanityTimer" : {
                        "description" : "Sanity timer ",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 3600,
                        "default" : 10
                    }
                },
                "required" : [ "maxOutstandingRequestsPerServer", "threshold", "sanityTimer" ],
                "description" : "Rate limiting"
            }
        }
    }
    
    

Create - RADIUS Accounting Service 

/v4_0/services/acct/radius

Use this API command to create a new RADIUS accounting service.

  • Request
  • Body
    {
        "name" : "accountingServiceName",
        "primary" : {
            "ip" : "192.168.1.1",
            "port" : 1813,
            "sharedSecret" : "sharedSecret"
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the RADIUS accounting service"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the RADIUS accounting service"
            },
            "primary" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "ip" : {
                        "type" : "string",
                        "description" : "Server IP"
                    },
                    "port" : {
                        "description" : "Server port",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 65535
                    },
                    "sharedSecret" : {
                        "description" : "Server shared secrect",
                        "type" : "string"
                    }
                },
                "required" : [ "ip", "port", "sharedSecret" ],
                "description" : "Primary RADIUS server"
            },
            "secondary" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "autoFallbackDisable" : {
                        "descriptin" : "Automatic fallback enabled or disabled",
                        "type" : "boolean"
                    },
                    "ip" : {
                        "type" : "string",
                        "description" : "RADIUS server IP"
                    },
                    "port" : {
                        "description" : "RADIUS server port",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 65535,
                        "default" : 1812
                    },
                    "sharedSecret" : {
                        "description" : "RADIUS server shared secrect",
                        "type" : "string"
                    }
                },
                "required" : [ "autoFallbackDisable", "ip", "port", "sharedSecret" ],
                "description" : "Secondary RADIUS server"
            },
            "healthCheckPolicy" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "responseWindow" : {
                        "description" : "Response window",
                        "type" : "integer",
                        "minimum" : 5,
                        "maximum" : 30,
                        "default" : 20
                    },
                    "reviveInterval" : {
                        "description" : "Revive interval",
                        "type" : "integer",
                        "minimum" : 60,
                        "maximum" : 3600,
                        "default" : 120
                    },
                    "zombiePeriod" : {
                        "description" : "Zombie period",
                        "type" : "integer",
                        "minimum" : 30,
                        "maximum" : 120,
                        "default" : 40
                    }
                },
                "required" : [ "responseWindow", "reviveInterval", "zombiePeriod" ],
                "description" : "Health check policy"
            },
            "rateLimiting" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "maxOutstandingRequestsPerServer" : {
                        "description" : "Maximum outstanding requests (MOR), value should be 0 or between 10 and 4096",
                        "type" : "integer",
                        "default" : 0
                    },
                    "threshold" : {
                        "description" : "Threshold, value should be 0 if MOR is 0, or between 10 and 90 if MOR is between 10 and 4096",
                        "type" : "integer",
                        "default" : 0
                    },
                    "sanityTimer" : {
                        "description" : "Sanity timer ",
                        "type" : "integer",
                        "minimum" : 1,
                        "maximum" : 3600,
                        "default" : 10
                    }
                },
                "required" : [ "maxOutstandingRequestsPerServer", "threshold", "sanityTimer" ],
                "description" : "Rate limiting"
            }
        },
        "required" : [ "name", "primary" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "serviceUUID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            }
        }
    }
    
    

Modify - RADIUS Accounting Service 

/v4_0/services/acct/radius/{id}

Use this API command to modify the basic information of a RADIUS accounting service.

  • Request
  • Body
    {
        "name" : "new name",
        "description" : "new description"
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Name of the RADIUS accounting service"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Description of the RADIUS accounting service"
        }
    }
    
    
  • Response  204

Modify - Primary RADIUS Server of Accounting Service 

/v4_0/services/acct/radius/{id}/primary

Use this API command to modify primary RADIUS server of a RADIUS accounting service.

  • Request
  • Body
    {
        "ip" : "192.168.1.1",
        "port" : 1812,
        "sharedSecret" : "sharedSecret"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "ip" : {
                "type" : "string",
                "description" : "Server IP"
            },
            "port" : {
                "description" : "Server port",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 65535
            },
            "sharedSecret" : {
                "description" : "Server shared secrect",
                "type" : "string"
            }
        },
        "required" : [ "ip", "port", "sharedSecret" ],
        "description" : "Primary RADIUS server"
    }
    
    
  • Response  204

Modify - Secondary RADIUS Server of Accounting Service 

/v4_0/services/acct/radius/{id}/secondary

Use this API command to modify secondary RADIUS server of a RADIUS accounting service.

  • Request
  • Body
    {
        "ip" : "192.168.1.2",
        "port" : 1812,
        "sharedSecret" : "sharedSecret"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "autoFallbackDisable" : {
                "descriptin" : "Automatic fallback enabled or disabled",
                "type" : "boolean"
            },
            "ip" : {
                "type" : "string",
                "description" : "RADIUS server IP"
            },
            "port" : {
                "description" : "RADIUS server port",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 65535,
                "default" : 1812
            },
            "sharedSecret" : {
                "description" : "RADIUS server shared secrect",
                "type" : "string"
            }
        },
        "required" : [ "autoFallbackDisable", "ip", "port", "sharedSecret" ],
        "description" : "Secondary RADIUS server"
    }
    
    
  • Response  204

Modify - Rate Limiting of Accounting Service 

/v4_0/services/acct/radius/{id}/rateLimiting

Use this API command to modify rate limiting of a RADIUS accounting service.

  • Request
  • Body
    {
        "maxOutstandingRequestsPerServer" : 0,
        "threshold" : 0,
        "sanityTimer" : 10
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "maxOutstandingRequestsPerServer" : {
                "description" : "Maximum outstanding requests (MOR), value should be 0 or between 10 and 4096",
                "type" : "integer",
                "default" : 0
            },
            "threshold" : {
                "description" : "Threshold, value should be 0 if MOR is 0, or between 10 and 90 if MOR is between 10 and 4096",
                "type" : "integer",
                "default" : 0
            },
            "sanityTimer" : {
                "description" : "Sanity timer ",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 3600,
                "default" : 10
            }
        },
        "required" : [ "maxOutstandingRequestsPerServer", "threshold", "sanityTimer" ],
        "description" : "Rate limiting"
    }
    
    
  • Response  204

Modify - Health Check Policy of Accounting Service 

/v4_0/services/acct/radius/{id}/healthCheckPolicy

Use this API command to modify health check policy of a RADIUS accounting service.

  • Request
  • Body
    {
        "responseWindow" : 20,
        "reviveInterval" : 120,
        "zombiePeriod" : 40
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "responseWindow" : {
                "description" : "Response window",
                "type" : "integer",
                "minimum" : 5,
                "maximum" : 30,
                "default" : 20
            },
            "reviveInterval" : {
                "description" : "Revive interval",
                "type" : "integer",
                "minimum" : 60,
                "maximum" : 3600,
                "default" : 120
            },
            "zombiePeriod" : {
                "description" : "Zombie period",
                "type" : "integer",
                "minimum" : 30,
                "maximum" : 120,
                "default" : 40
            }
        },
        "required" : [ "responseWindow", "reviveInterval", "zombiePeriod" ],
        "description" : "Health check policy"
    }
    
    
  • Response  204

Disable Secondary RADIUS Server of Accounting Service 

/v4_0/services/acct/radius/{id}/secondary

Use this API command to disable secondary RADIUS server of a RADIUS accounting service.

  • Response  204

Delete - RADIUS Accounting Service 

/v4_0/services/acct/radius/{id}

Use this API command to delete a RADIUS accounting service.

  • Response  204

Hotspot20 Venue Profile 

Retrieve List 

/v4_0/rkszones/{zoneId}/hs20/venues

Use this API command to retrieve a list of Hotspot 2.0 venue profile of a zone.

  • Response  200
  • Body
    {
        "totalCount" : 9,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "c5dfc930-75dc-11e4-8d56-00606eb0c700",
            "name" : "protalName1"
        }, {
            "id" : "15efd160-7153-11e4-aa08-00606eb0c700",
            "name" : "protalName2"
        }, {
            "id" : "be0f0480-73a9-11e4-9d1d-f0def13d5845",
            "name" : "protalName3"
        }, {
            "id" : "7f0eef00-7423-11e4-bcef-000c299b4765",
            "name" : "protalName4"
        }, {
            "id" : "4f5c98a0-7123-11e4-bcef-000c299b4765",
            "name" : "protalName5"
        }, {
            "id" : "4a023ce0-73ab-11e4-b211-f0def13d5845",
            "name" : "protalName6"
        }, {
            "id" : "afebbc80-73be-11e4-bfde-f0def13d5845",
            "name" : "protalName7"
        }, {
            "id" : "76f4c020-7620-11e4-b8b9-00606eb0c700",
            "name" : "protalName8"
        }, {
            "id" : "96308310-752c-11e4-8276-00606eb0c700",
            "name" : "protalName9"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the service",
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the service"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve 

/v4_0/rkszones/{zoneId}/hs20/venues/{id}

Use this API command to retrieve a Hotspot 2.0 venue profile of a zone.

  • Response  200
  • Body
    {
        "name" : "test-hs20Venue",
        "id" : "4136c9f0-7f6d-11e4-8fea-80fa5b024259",
        "description" : "des-hs20Venue",
        "zoneId" : "6b4279d6-a003-464e-9cbc-1e7ebee387c0",
        "group" : "UtilityAndMiscellaneous",
        "type" : "Unspecified",
        "downlinkSpeedInKbps" : 22,
        "uplinkSpeedInKbps" : 224,
        "venueNames" : [ {
            "language" : "English",
            "name" : "add friendly name"
        }, {
            "language" : "German",
            "name" : "add friendly name"
        }, {
            "language" : "Japanese",
            "name" : "add friendly name"
        }, {
            "language" : "Swedish",
            "name" : "add friendly name"
        }, {
            "language" : "Turkish",
            "name" : "add friendly name"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the Hotspot 2.0 venue profile",
                "type" : "string"
            },
            "zoneId" : {
                "description" : "Identifier of the zone which the Hotspot 2.0 venue profile belongs to",
                "type" : "string"
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the Hotspot 2.0 venue profile"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the Hotspot 2.0 venue profile"
            },
            "group" : {
                "description" : "Category group of the Hotspot 2.0 venue profile",
                "enum" : [ "Unspecified", "Assembly", "Business", "Educational", "FactoryAndIndustrial", "Institutional", "Mercantile", "Residential", "Storage", "UtilityAndMiscellaneous", "Vehicular", "Outdoor" ]
            },
            "type" : {
                "description" : "Category type of the Hotspot 2.0 venue profile",
                "type" : "string"
            },
            "downlinkSpeedInKbps" : {
                "description" : "Downlink Speed of the Hotspot 2.0 venue profile",
                "type" : "number",
                "minimum" : 0,
                "maximum" : 4294967295
            },
            "uplinkSpeedInKbps" : {
                "description" : "Uplink Speed of the Hotspot 2.0 venue profile",
                "type" : "number",
                "minimum" : 0,
                "maximum" : 4294967295
            },
            "venueNames" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "language" : {
                            "enum" : [ "English", "Chinese", "Czech", "Danish", "Dutch", "French", "German", "Japanese", "Spanish", "Korean", "Swedish", "Turkish" ],
                            "description" : "Friendly name of venue"
                        },
                        "name" : {
                            "description" : "Venue name",
                            "type" : "string"
                        }
                    },
                    "required" : [ "language", "name" ]
                }
            }
        }
    }
    
    

Create 

/v4_0/rkszones/{zoneId}/hs20/venues

Use this API command to create a new Hotspot 2.0 venue profile of a zone.

  • Request
  • Body
    {
        "name" : "test-hs20Venue",
        "description" : "des-hs20Venue",
        "group" : "UtilityAndMiscellaneous",
        "type" : "Unspecified",
        "downlinkSpeedInKbps" : 22,
        "uplinkSpeedInKbps" : 224,
        "venueNames" : [ {
            "language" : "English",
            "name" : "add friendly name"
        }, {
            "language" : "German",
            "name" : "add friendly name"
        }, {
            "language" : "Japanese",
            "name" : "add friendly name"
        }, {
            "language" : "Swedish",
            "name" : "add friendly name"
        }, {
            "language" : "Turkish",
            "name" : "add friendly name"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the Hotspot 2.0 venue profile"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the Hotspot 2.0 venue profile"
            },
            "group" : {
                "description" : "Category group of the Hotspot 2.0 venue profile",
                "enum" : [ "Unspecified", "Assembly", "Business", "Educational", "FactoryAndIndustrial", "Institutional", "Mercantile", "Residential", "Storage", "UtilityAndMiscellaneous", "Vehicular", "Outdoor" ]
            },
            "type" : {
                "description" : "Category type of the Hotspot 2.0 venue profile",
                "type" : "string"
            },
            "downlinkSpeedInKbps" : {
                "description" : "Downlink Speed of the Hotspot 2.0 venue profile",
                "type" : "number",
                "minimum" : 0,
                "maximum" : 4294967295
            },
            "uplinkSpeedInKbps" : {
                "description" : "Uplink Speed of the Hotspot 2.0 venue profile",
                "type" : "number",
                "minimum" : 0,
                "maximum" : 4294967295
            },
            "venueNames" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "language" : {
                            "enum" : [ "English", "Chinese", "Czech", "Danish", "Dutch", "French", "German", "Japanese", "Spanish", "Korean", "Swedish", "Turkish" ],
                            "description" : "Friendly name of venue"
                        },
                        "name" : {
                            "description" : "Venue name",
                            "type" : "string"
                        }
                    },
                    "required" : [ "language", "name" ]
                }
            }
        },
        "required" : [ "name", "venueNames" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "76f4c020-7620-11e4-b8b9-00606eb0c700"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the created portal profile",
                "type" : "string"
            }
        }
    }
    
    

Modify Basic 

/v4_0/rkszones/{zoneId}/hs20/venues/{id}

Use this API command to modify the basic information on Hotspot 2.0 venue profile of a zone.

  • Request
  • Body
    {
        "name" : "test-hs20Venue-modify",
        "description" : "des-hs20Venue-modify",
        "group" : "UtilityAndMiscellaneous",
        "type" : "Unspecified",
        "downlinkSpeedInKbps" : 111111,
        "uplinkSpeedInKbps" : 11111
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Name of the Hotspot 2.0 venue profile"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Description of the Hotspot 2.0 venue profile"
        },
        "group" : {
            "description" : "Category group of the Hotspot 2.0 venue profile",
            "enum" : [ "Unspecified", "Assembly", "Business", "Educational", "FactoryAndIndustrial", "Institutional", "Mercantile", "Residential", "Storage", "UtilityAndMiscellaneous", "Vehicular", "Outdoor" ]
        },
        "type" : {
            "description" : "Category type of the Hotspot 2.0 venue profile",
            "type" : "string"
        },
        "downlinkSpeedInKbps" : {
            "description" : "Downlink Speed of the Hotspot 2.0 venue profile",
            "type" : "number",
            "minimum" : 0,
            "maximum" : 4294967295
        },
        "uplinkSpeedInKbps" : {
            "description" : "Uplink Speed of the Hotspot 2.0 venue profile",
            "type" : "number",
            "minimum" : 0,
            "maximum" : 4294967295
        }
    }
    
    
  • Response  204

Modify Venue Names 

/v4_0/rkszones/{zoneId}/hs20/venues/{id}/venueNames

Use this API command to modify the venue names on Hotspot 2.0 venue profile of a zone.

  • Request
  • Body
    [ {
        "language" : "English",
        "name" : "add friendly name"
    }, {
        "language" : "German",
        "name" : "add friendly name"
    }, {
        "language" : "Japanese",
        "name" : "add friendly name"
    }, {
        "language" : "Swedish",
        "name" : "add friendly name"
    }, {
        "language" : "Turkish",
        "name" : "add friendly name"
    } ]
    
    
    Schema
    {
        "type" : "array",
        "items" : {
            "type" : "object",
            "additionalProperties" : false,
            "properties" : {
                "language" : {
                    "enum" : [ "English", "Chinese", "Czech", "Danish", "Dutch", "French", "German", "Japanese", "Spanish", "Korean", "Swedish", "Turkish" ],
                    "description" : "Friendly name of venue"
                },
                "name" : {
                    "description" : "Venue name",
                    "type" : "string"
                }
            },
            "required" : [ "language", "name" ]
        }
    }
    
    
  • Response  204

Delete 

/v4_0/rkszones/{zoneId}/hs20/venues/{id}

Use this API command to delete Hotspot 2.0 venue profile of a zone.

  • Response  204

Hotspot20 Wi-Fi Operator Profile 

Retrieve List 

/v4_0/profiles/hs20/operators

Use this API command to retrieve list of Hotspot 2.0 Wi-Fi Operators.

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

  • Response  200
  • Body
    {
        "totalCount" : 1,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "267ef3a0-738b-11e4-96d5-0a7820524153",
            "name" : "new name"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the profile",
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the profile"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve 

/v4_0/profiles/hs20/operators/{id}

Use this API command to retrieve a Hotspot 2.0 Wi-Fi operator.

  • Response  200
  • Body
    {
        "name" : "public-api-operator",
        "description" : "description-changed",
        "domainNames" : [ "ruckus.com" ],
        "friendlyNames" : [ {
            "language" : "English",
            "name" : "ruckus"
        } ],
        "certificate" : {
            "id" : "certificateID",
            "name" : "certificateName"
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the profile",
                "type" : "string"
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the Hotspot 2.0 Wifi operator profile"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the Hotspot 2.0 Wifi operator profile"
            },
            "domainNames" : {
                "description" : "Domain names",
                "type" : "array",
                "items" : {
                    "description" : "Compare with FQDN, it could start with '*.'",
                    "type" : "string",
                    "pattern" : "^((?=.{1,253}$)((?=[a-z0-9-]{1,63}\.)(xn--)?[a-z0-9]+(-[a-z0-9]+)*\.)+[a-z]{2,63}|(\*\.)(?=.{1,253}$)((?=[a-z0-9-]{1,63}\.)(xn--)?[a-z0-9]+(-[a-z0-9]+)*\.)+[a-z]{2,63})$"
                }
            },
            "friendlyNames" : {
                "description" : "Friendly names",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "language" : {
                            "enum" : [ "English", "Chinese", "Czech", "Danish", "Dutch", "French", "German", "Japanese", "Spanish", "Korean", "Swedish", "Turkish" ],
                            "description" : "Language of the friendly name"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the friendly name"
                        }
                    },
                    "required" : [ "language", "name" ]
                }
            },
            "certificate" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Signup security certificate"
            }
        },
        "required" : [ "name", "domainNames", "friendlyNames" ]
    }
    
    

Create 

/v4_0/profiles/hs20/operators

Use this API command to create a new Hotspot 2.0 Wi-Fi operator,

  • Request
  • Body
    {
        "name" : "public-api-operator",
        "domainNames" : [ "ruckus.com" ],
        "friendlyNames" : [ {
            "language" : "English",
            "name" : "ruckus"
        } ],
        "certificate" : {
            "id" : "certificateID",
            "name" : "certificateName"
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the Hotspot 2.0 Wifi operator profile"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the Hotspot2.0 Wifi operator profile"
            },
            "domainNames" : {
                "description" : "Domain names",
                "type" : "array",
                "items" : {
                    "description" : "Compare with FQDN, it could start with '*.'",
                    "type" : "string",
                    "pattern" : "^((?=.{1,253}$)((?=[a-z0-9-]{1,63}\.)(xn--)?[a-z0-9]+(-[a-z0-9]+)*\.)+[a-z]{2,63}|(\*\.)(?=.{1,253}$)((?=[a-z0-9-]{1,63}\.)(xn--)?[a-z0-9]+(-[a-z0-9]+)*\.)+[a-z]{2,63})$"
                }
            },
            "friendlyNames" : {
                "description" : "Friendly names",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "language" : {
                            "enum" : [ "English", "Chinese", "Czech", "Danish", "Dutch", "French", "German", "Japanese", "Spanish", "Korean", "Swedish", "Turkish" ],
                            "description" : "Language of the friendly name"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the friendly name"
                        }
                    },
                    "required" : [ "language", "name" ]
                }
            },
            "certificate" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Signup security certificate"
            }
        },
        "required" : [ "name", "domainNames", "friendlyNames" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "profileUUID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            }
        }
    }
    
    

Modify Basic 

/v4_0/profiles/hs20/operators/{id}

Use this API command to modify the basic information of a Hotspot 2.0 Wi-Fi operator.

  • Request
  • Body
    {
        "name" : "public-api-operator-changed",
        "description" : "description-changed"
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Name of the Hotspot 2.0 Wifi operator profile"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Description of the Hotspot 2.0 Wifi operator profile"
        }
    }
    
    
  • Response  204

Modify Domain Names 

/v4_0/profiles/hs20/operators/{id}/domainNames

Use this API command to modify domain names of a Hotspot 2.0 Wi-Fi operator.

  • Request
  • Body
    [ "ruckus.com" ]
    
    
    Schema
    {
        "description" : "Domain names",
        "type" : "array",
        "items" : {
            "description" : "Compare with FQDN, it could start with '*.'",
            "type" : "string",
            "pattern" : "^((?=.{1,253}$)((?=[a-z0-9-]{1,63}\.)(xn--)?[a-z0-9]+(-[a-z0-9]+)*\.)+[a-z]{2,63}|(\*\.)(?=.{1,253}$)((?=[a-z0-9-]{1,63}\.)(xn--)?[a-z0-9]+(-[a-z0-9]+)*\.)+[a-z]{2,63})$"
        }
    }
    
    
  • Response  204

Modify Friendly Names 

/v4_0/profiles/hs20/operators/{id}/friendlyNames

Use this API command to modify friendly names of a Hotspot 2.0 Wi-Fi operator.

  • Request
  • Body
    [ {
        "language" : "English",
        "name" : "ruckus"
    } ]
    
    
    Schema
    {
        "description" : "Friendly names",
        "type" : "array",
        "items" : {
            "type" : "object",
            "additionalProperties" : false,
            "properties" : {
                "language" : {
                    "enum" : [ "English", "Chinese", "Czech", "Danish", "Dutch", "French", "German", "Japanese", "Spanish", "Korean", "Swedish", "Turkish" ],
                    "description" : "Language of the friendly name"
                },
                "name" : {
                    "type" : "string",
                    "minLength" : 2,
                    "maxLength" : 32,
                    "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                    "description" : "Name of the friendly name"
                }
            },
            "required" : [ "language", "name" ]
        }
    }
    
    
  • Response  204

Modify Certificate 

/v4_0/profiles/hs20/operators/{id}/certificate

Use this API command to enable or modify certificate of a Hotspot 2.0 Wi-Fi operator.

  • Request
  • Body
    {
        "id" : "certificateID",
        "name" : "certificateName"
    }
    
    
    Schema
    {
        "type" : [ "object", "null" ],
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            },
            "name" : {
                "type" : "string"
            }
        },
        "description" : "Signup security certificate"
    }
    
    
  • Response  204

Disable Certificate 

/v4_0/profiles/hs20/operators/{id}/certificate

Use this API command to disable certificate of a Hotspot 2.0 Wi-Fi operator.

  • Response  204

Delete 

/v4_0/profiles/hs20/operators/{id}

Use this API command to delete a Hotspot 2.0 Wi-Fi operator.

  • Response  204

Hotspot20 Identity Provider Profile 

Retrieve List 

/v4_0/profiles/hs20/identityproviders

Use this API command to retrieve list of Hotspot 2.0 identity providers.

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

  • Response  200
  • Body
    {
        "totalCount" : 1,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "267ef3a0-738b-11e4-96d5-0a7820524153",
            "name" : "new name"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the profile",
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the profile"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve 

/v4_0/profiles/hs20/identityproviders/{id}

Use this API command to retrieve a Hotspot 2.0 identity provider.

  • Response  200
  • Body
    {
        "id" : "1fb20eaf-7b9b-40c7-8b9b-7d69d6165176",
        "mvnoId" : "839f87c6-d116-497e-afce-aa8157abd30c",
        "name" : "hs20IdentithInternalOSU",
        "description" : "",
        "realms" : [ {
            "name" : "reamlll",
            "encoding" : "RFC4282",
            "eapMethods" : [ {
                "type" : "NA",
                "authSettings" : null
            }, {
                "type" : "NA",
                "authSettings" : null
            }, {
                "type" : "NA",
                "authSettings" : null
            }, {
                "type" : "NA",
                "authSettings" : null
            } ]
        } ],
        "plmns" : null,
        "homeOis" : null,
        "authentications" : [ {
            "id" : "868b0b20-8598-11e4-8acc-08002716c79f",
            "name" : "globalRadius",
            "realm" : "globalAuth",
            "serviceType" : "RADIUS",
            "vlanId" : 23,
            "refBlank" : false
        }, {
            "id" : null,
            "name" : null,
            "realm" : "No Match",
            "serviceType" : "NA",
            "vlanId" : null,
            "refBlank" : true
        }, {
            "id" : null,
            "name" : null,
            "realm" : "Unspecified",
            "serviceType" : "NA",
            "vlanId" : null,
            "refBlank" : true
        } ],
        "accountings" : [ {
            "id" : "789ff6b0-8598-11e4-8acc-08002716c79f",
            "name" : "globalRadiusAcct",
            "realm" : "globalAcct",
            "serviceType" : "RADIUS",
            "refBlank" : false
        }, {
            "id" : null,
            "name" : null,
            "realm" : "No Match",
            "serviceType" : "NA",
            "refBlank" : true
        }, {
            "id" : null,
            "name" : null,
            "realm" : "Unspecified",
            "serviceType" : "NA",
            "refBlank" : true
        } ],
        "osu" : {
            "type" : "Internal",
            "internalOSU" : {
                "provisioningProtocals" : [ "SOAP_XML" ],
                "provisioningFormat" : "R1_R2_ZEROIT",
                "provisioningUpdateType" : "NEVER",
                "osuPortal" : {
                    "type" : "Internal",
                    "internalOSUPortal" : {
                        "id" : "24cdfc80-8598-11e4-8acc-08002716c79f",
                        "name" : null,
                        "refBlank" : false
                    },
                    "externalUrl" : null
                },
                "commonLanguageIcon" : "imageDATA",
                "serviceDescriptions" : [ {
                    "language" : "English",
                    "name" : "ruckus",
                    "description" : "",
                    "icon" : ""
                } ],
                "certificate" : {
                    "id" : "certificateID",
                    "name" : "certificateName"
                },
                "osuAuthServices" : [ {
                    "id" : "11111111-1111-1111-1111-111111111111",
                    "name" : null,
                    "credentialType" : "LOCAL",
                    "realm" : "reamlll",
                    "expiration" : -1,
                    "refBlank" : false
                } ],
                "whitelistedDomains" : [ ]
            },
            "externalOSU" : null
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the Hotspot 2.0 identity provider profile",
                "type" : "string"
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the Hotspot 2.0 identity provider profile"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the Hotspot 2.0 identity provider profile"
            },
            "realms" : {
                "description" : "Realms",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of realm"
                        },
                        "encoding" : {
                            "description" : "Encoding",
                            "enum" : [ "RFC4282", "UTF8" ]
                        },
                        "eapMethods" : {
                            "description" : "EAP methods",
                            "type" : "array",
                            "items" : {
                                "type" : "object",
                                "additionalProperties" : false,
                                "properties" : {
                                    "type" : {
                                        "description" : "EAP method type",
                                        "enum" : [ "NA", "MD5", "EAP_TLS", "EAP_Cisco", "EAP_SIM", "EAP_TTLS", "EAP_AKA", "PEAP", "EAP_MSCHAP_V2", "EAP_AKAs", "Reserved" ]
                                    },
                                    "authSettings" : {
                                        "description" : "EAP method auth settings",
                                        "type" : [ "array", "null" ],
                                        "items" : {
                                            "type" : "object",
                                            "additionalProperties" : false,
                                            "properties" : {
                                                "info" : {
                                                    "description" : "EAP auth info",
                                                    "enum" : [ "Expanded", "Non", "Inner", "Expanded_Inner", "Credential", "Tunneled" ]
                                                },
                                                "type" : {
                                                    "description" : "EAP auth type",
                                                    "type" : "string"
                                                },
                                                "vendorId" : {
                                                    "description" : "EAP auth vendor ID",
                                                    "type" : [ "integer", "null" ],
                                                    "minimum" : 0,
                                                    "maximum" : 16777215
                                                },
                                                "vendorType" : {
                                                    "description" : "EAP auth vendor type",
                                                    "type" : [ "integer", "null" ],
                                                    "minimum" : 0,
                                                    "maximum" : 4294967295
                                                }
                                            },
                                            "required" : [ "info" ]
                                        }
                                    }
                                },
                                "required" : [ "type" ]
                            }
                        }
                    },
                    "required" : [ "name", "encoding", "eapMethods" ]
                }
            },
            "plmns" : {
                "description" : "PLMNs",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "mcc" : {
                            "description" : "MCC",
                            "type" : "string",
                            "pattern" : "^[0-9]{3}$"
                        },
                        "mnc" : {
                            "description" : "MNC",
                            "type" : "string",
                            "pattern" : "^[0-9]{2,3}$"
                        }
                    },
                    "required" : [ "mcc", "mnc" ]
                }
            },
            "homeOis" : {
                "description" : "Home OIs",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "name" : {
                            "description" : "Name of the home OI",
                            "type" : "string",
                            "maxLength" : 255
                        },
                        "oi" : {
                            "description" : "Orgnization ID(3Hex or 5Hex)",
                            "type" : "string",
                            "pattern" : "^(([0-9a-fA-F][0-9a-fA-F]){3}|([0-9a-fA-F][0-9a-fA-F]){5})$"
                        }
                    },
                    "required" : [ "name", "oi" ]
                }
            },
            "authentications" : {
                "description" : "Authentications",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Authentication id",
                            "type" : [ "string", "null" ]
                        },
                        "name" : {
                            "description" : "Authentication name",
                            "type" : [ "string", "null" ]
                        },
                        "realm" : {
                            "type" : "string",
                            "maxLength" : 255,
                            "pattern" : "^$|^([!-~]([ -~]){0,253}[!-~]|[!-~]{1,1})$",
                            "description" : "Authentication realm"
                        },
                        "serviceType" : {
                            "description" : "Authentication service type",
                            "enum" : [ "NA", "LOCAL_DB", "RADIUS" ]
                        },
                        "vlanId" : {
                            "description" : "Dynamic vlan ID",
                            "type" : [ "integer", "null" ],
                            "minimum" : 1,
                            "maximum" : 4094
                        }
                    },
                    "required" : [ "realm", "serviceType" ]
                }
            },
            "accountings" : {
                "description" : "Accountings",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Accounting id",
                            "type" : [ "string", "null" ]
                        },
                        "name" : {
                            "description" : "Accounting name",
                            "type" : [ "string", "null" ]
                        },
                        "realm" : {
                            "type" : "string",
                            "maxLength" : 255,
                            "pattern" : "^$|^([!-~]([ -~]){0,253}[!-~]|[!-~]{1,1})$"
                        },
                        "serviceType" : {
                            "description" : "Accounting service type",
                            "enum" : [ "NA", "RADIUS", "CGF" ]
                        }
                    },
                    "required" : [ "realm", "serviceType" ]
                }
            },
            "osu" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "type" : {
                        "description" : "Online singup type",
                        "enum" : [ "Internal", "External" ]
                    },
                    "internalOSU" : {
                        "type" : [ "object", "null" ],
                        "additionalProperties" : false,
                        "properties" : {
                            "provisioningProtocals" : {
                                "description" : "Provisioning protocal",
                                "type" : "array",
                                "items" : {
                                    "enum" : [ "SOAP_XML", "OMA_DM" ]
                                }
                            },
                            "provisioningFormat" : {
                                "description" : "Provisioning format",
                                "enum" : [ "R1_R2_ZEROIT", "R2_ZEROIT" ]
                            },
                            "provisioningUpdateType" : {
                                "description" : "Provisioning update at",
                                "enum" : [ "ALWAYS", "KNOWN_ROAM_PARTNERS", "NEVER" ]
                            },
                            "osuPortal" : {
                                "type" : "object",
                                "additionalProperties" : false,
                                "properties" : {
                                    "type" : {
                                        "description" : "Portal type",
                                        "enum" : [ "Internal", "External" ]
                                    },
                                    "internalOSUPortal" : {
                                        "type" : [ "object", "null" ],
                                        "additionalProperties" : false,
                                        "properties" : {
                                            "id" : {
                                                "type" : "string"
                                            },
                                            "name" : {
                                                "type" : "string"
                                            }
                                        },
                                        "description" : "Internal online singup portal, required when type is Internal"
                                    },
                                    "externalUrl" : {
                                        "type" : [ "string", "null" ],
                                        "pattern" : "^(https://)?(?:\w+:\w+@)?((?:(?:[-\w\d{1-3}]+\.)+(?:com|org|net|gov|mil|biz|info|mobi|name|aero|jobs|edu|co\.uk|ac\.uk|it|fr|tv|museum|asia|local|travel|[a-z]{2}))|((\b25[0-5]\b|\b[2][0-4][0-9]\b|\b[0-1]?[0-9]?[0-9]\b)(\.(\b25[0-5]\b|\b[2][0-4][0-9]\b|\b[0-1]?[0-9]?[0-9]\b)){3}))(?::[\d]{1,5})?(?:(?:(?:/(?:[-\w~!$+|.,=]|%[a-f\d]{2})+)+|/)+|\?|#)?(?:(?:\?(?:[-\w~!$+|.,*:]|%[a-f\d{2}])+=?(?:[-\w~!$+|.,*:=]|%[a-f\d]{2})*)(?:&(?:[-\w~!$+|.,*:]|%[a-f\d{2}])+=?(?:[-\w~!$+|.,*:=]|%[a-f\d]{2})*)*)*(?:#(?:[-\w~!$ |/.,*:;=]|%[a-f\d]{2})*)?$",
                                        "description" : "External online singup portal, start with https://, required when type is External"
                                    }
                                },
                                "required" : [ "type" ]
                            },
                            "commonLanguageIcon" : {
                                "description" : "The base64 encoded data of icon.",
                                "type" : "string"
                            },
                            "subscriptionDescriptions" : {
                                "description" : "Subscription descriptions",
                                "type" : "array",
                                "items" : {
                                    "type" : "object",
                                    "additionalProperties" : false,
                                    "properties" : {
                                        "language" : {
                                            "enum" : [ "English", "Chinese", "Czech", "Danish", "Dutch", "French", "German", "Japanese", "Spanish", "Korean", "Swedish", "Turkish" ],
                                            "description" : "Language of the friendly name"
                                        },
                                        "name" : {
                                            "type" : "string",
                                            "minLength" : 2,
                                            "maxLength" : 32,
                                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                                            "description" : "Name of the friendly name"
                                        },
                                        "description" : {
                                            "type" : [ "string", "null" ],
                                            "maxLength" : 64,
                                            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                                            "description" : "Description of the friendly name"
                                        },
                                        "icon" : {
                                            "description" : "The binary data of icon, maximum size 65536",
                                            "type" : "string"
                                        }
                                    },
                                    "required" : [ "language", "name" ]
                                }
                            },
                            "certificate" : {
                                "type" : [ "object", "null" ],
                                "additionalProperties" : false,
                                "properties" : {
                                    "id" : {
                                        "type" : "string"
                                    },
                                    "name" : {
                                        "type" : "string"
                                    }
                                },
                                "description" : "Online signup certificate"
                            },
                            "osuAuthServices" : {
                                "description" : "Online signup authentication services",
                                "type" : "array",
                                "items" : {
                                    "type" : "object",
                                    "additionalProperties" : false,
                                    "properties" : {
                                        "id" : {
                                            "description" : "Identifier of authentication service",
                                            "type" : "string"
                                        },
                                        "name" : {
                                            "description" : "Authentication service name",
                                            "type" : "string"
                                        },
                                        "credentialType" : {
                                            "description" : "Authentication credential type",
                                            "enum" : [ "LOCAL", "REMOTE" ]
                                        },
                                        "realm" : {
                                            "type" : "string",
                                            "maxLength" : 255,
                                            "pattern" : "^$|^([!-~]([ -~]){0,253}[!-~]|[!-~]{1,1})$",
                                            "description" : "Authentication realm"
                                        },
                                        "expiration" : {
                                            "description" : "Expiration hour. null mean never expire",
                                            "type" : [ "integer", "null" ],
                                            "minimum" : 1,
                                            "maximum" : 175200
                                        }
                                    },
                                    "required" : [ "credentialType", "realm" ]
                                }
                            },
                            "whitelistedDomains" : {
                                "description" : "whitelisted domains",
                                "type" : "array",
                                "items" : {
                                    "description" : "Compare with FQDN, it could start with '*.'",
                                    "type" : "string",
                                    "pattern" : "^((?=.{1,253}$)((?=[a-z0-9-]{1,63}\.)(xn--)?[a-z0-9]+(-[a-z0-9]+)*\.)+[a-z]{2,63}|(\*\.)(?=.{1,253}$)((?=[a-z0-9-]{1,63}\.)(xn--)?[a-z0-9]+(-[a-z0-9]+)*\.)+[a-z]{2,63})$"
                                }
                            }
                        },
                        "required" : [ "provisioningProtocals", "provisioningFormat", "provisioningUpdateType", "osuPortal", "commonLanguageIcon", "subscriptionDescriptions", "certificate", "osuAuthServices" ],
                        "description" : "Internal online singup, required when type is Internal"
                    },
                    "externalOSU" : {
                        "type" : [ "object", "null" ],
                        "additionalProperties" : false,
                        "properties" : {
                            "provisioningProtocals" : {
                                "description" : "Provisioning protocal",
                                "type" : "array",
                                "item" : {
                                    "enum" : [ "SOAP_XML", "OMA_DM" ]
                                }
                            },
                            "osuServiceUrl" : {
                                "type" : [ "string", "null" ],
                                "pattern" : "^(https://)?(?:\w+:\w+@)?((?:(?:[-\w\d{1-3}]+\.)+(?:com|org|net|gov|mil|biz|info|mobi|name|aero|jobs|edu|co\.uk|ac\.uk|it|fr|tv|museum|asia|local|travel|[a-z]{2}))|((\b25[0-5]\b|\b[2][0-4][0-9]\b|\b[0-1]?[0-9]?[0-9]\b)(\.(\b25[0-5]\b|\b[2][0-4][0-9]\b|\b[0-1]?[0-9]?[0-9]\b)){3}))(?::[\d]{1,5})?(?:(?:(?:/(?:[-\w~!$+|.,=]|%[a-f\d]{2})+)+|/)+|\?|#)?(?:(?:\?(?:[-\w~!$+|.,*:]|%[a-f\d{2}])+=?(?:[-\w~!$+|.,*:=]|%[a-f\d]{2})*)(?:&(?:[-\w~!$+|.,*:]|%[a-f\d{2}])+=?(?:[-\w~!$+|.,*:=]|%[a-f\d]{2})*)*)*(?:#(?:[-\w~!$ |/.,*:;=]|%[a-f\d]{2})*)?$",
                                "description" : "External service URL, start with https://"
                            },
                            "osuNaiRealm" : {
                                "description" : "Online signup NAI realm, it should be one of realm as defined in Hotspot 2.0 identity provider",
                                "type" : "string"
                            },
                            "commonLanguageIcon" : {
                                "description" : "The base64 encoded data of icon.",
                                "type" : "string"
                            },
                            "subscriptionDescriptions" : {
                                "description" : "Subscription descriptions",
                                "type" : "array",
                                "items" : {
                                    "type" : "object",
                                    "additionalProperties" : false,
                                    "properties" : {
                                        "language" : {
                                            "enum" : [ "English", "Chinese", "Czech", "Danish", "Dutch", "French", "German", "Japanese", "Spanish", "Korean", "Swedish", "Turkish" ],
                                            "description" : "Language of the friendly name"
                                        },
                                        "name" : {
                                            "type" : "string",
                                            "minLength" : 2,
                                            "maxLength" : 32,
                                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                                            "description" : "Name of the friendly name"
                                        },
                                        "description" : {
                                            "type" : [ "string", "null" ],
                                            "maxLength" : 64,
                                            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                                            "description" : "Description of the friendly name"
                                        },
                                        "icon" : {
                                            "description" : "The binary data of icon, maximum size 65536",
                                            "type" : "string"
                                        }
                                    },
                                    "required" : [ "language", "name" ]
                                }
                            },
                            "whitelistedDomains" : {
                                "description" : "Whitelisted domains",
                                "type" : "array",
                                "items" : {
                                    "description" : "Compare with FQDN, it could start with '*.'",
                                    "type" : "string",
                                    "pattern" : "^((?=.{1,253}$)((?=[a-z0-9-]{1,63}\.)(xn--)?[a-z0-9]+(-[a-z0-9]+)*\.)+[a-z]{2,63}|(\*\.)(?=.{1,253}$)((?=[a-z0-9-]{1,63}\.)(xn--)?[a-z0-9]+(-[a-z0-9]+)*\.)+[a-z]{2,63})$"
                                }
                            }
                        },
                        "required" : [ "provisioningProtocals", "osuServiceUrl", "osuNaiRealm", "commonLanguageIcon", "subscriptionDescriptions" ],
                        "description" : "External online singup, required when type is External"
                    }
                },
                "required" : [ "type" ],
                "description" : "Online Signup & Provisioning"
            }
        }
    }
    
    

Create 

/v4_0/profiles/hs20/identityproviders

Use this API command to create a new Hotspot 2.0 identity provider.

  • Request
  • Body
    {
        "name" : "test-hs20provider",
        "realms" : [ {
            "name" : "realm1",
            "encoding" : "RFC4282",
            "eapMethods" : [ {
                "type" : "NA"
            }, {
                "type" : "NA"
            }, {
                "type" : "NA"
            }, {
                "type" : "NA"
            } ]
        } ],
        "authentications" : [ {
            "realm" : "No Match",
            "serviceType" : "NA"
        }, {
            "realm" : "Unspecified",
            "serviceType" : "NA"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the Hotspot 2.0 identity provider profile"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the Hotspot 2.0 identity provider profile"
            },
            "realms" : {
                "description" : "Realms",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of realm"
                        },
                        "encoding" : {
                            "description" : "Encoding",
                            "enum" : [ "RFC4282", "UTF8" ]
                        },
                        "eapMethods" : {
                            "description" : "EAP methods",
                            "type" : "array",
                            "items" : {
                                "type" : "object",
                                "additionalProperties" : false,
                                "properties" : {
                                    "type" : {
                                        "description" : "EAP method type",
                                        "enum" : [ "NA", "MD5", "EAP_TLS", "EAP_Cisco", "EAP_SIM", "EAP_TTLS", "EAP_AKA", "PEAP", "EAP_MSCHAP_V2", "EAP_AKAs", "Reserved" ]
                                    },
                                    "authSettings" : {
                                        "description" : "EAP method auth settings",
                                        "type" : [ "array", "null" ],
                                        "items" : {
                                            "type" : "object",
                                            "additionalProperties" : false,
                                            "properties" : {
                                                "info" : {
                                                    "description" : "EAP auth info",
                                                    "enum" : [ "Expanded", "Non", "Inner", "Expanded_Inner", "Credential", "Tunneled" ]
                                                },
                                                "type" : {
                                                    "description" : "EAP auth type",
                                                    "type" : "string"
                                                },
                                                "vendorId" : {
                                                    "description" : "EAP auth vendor ID",
                                                    "type" : [ "integer", "null" ],
                                                    "minimum" : 0,
                                                    "maximum" : 16777215
                                                },
                                                "vendorType" : {
                                                    "description" : "EAP auth vendor type",
                                                    "type" : [ "integer", "null" ],
                                                    "minimum" : 0,
                                                    "maximum" : 4294967295
                                                }
                                            },
                                            "required" : [ "info" ]
                                        }
                                    }
                                },
                                "required" : [ "type" ]
                            }
                        }
                    },
                    "required" : [ "name", "encoding", "eapMethods" ]
                }
            },
            "plmns" : {
                "description" : "PLMNs",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "mcc" : {
                            "description" : "MCC",
                            "type" : "string",
                            "pattern" : "^[0-9]{3}$"
                        },
                        "mnc" : {
                            "description" : "MNC",
                            "type" : "string",
                            "pattern" : "^[0-9]{2,3}$"
                        }
                    },
                    "required" : [ "mcc", "mnc" ]
                }
            },
            "homeOis" : {
                "description" : "Home OIs",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "name" : {
                            "description" : "Name of the home OI",
                            "type" : "string",
                            "maxLength" : 255
                        },
                        "oi" : {
                            "description" : "Orgnization ID(3Hex or 5Hex)",
                            "type" : "string",
                            "pattern" : "^(([0-9a-fA-F][0-9a-fA-F]){3}|([0-9a-fA-F][0-9a-fA-F]){5})$"
                        }
                    },
                    "required" : [ "name", "oi" ]
                }
            },
            "authentications" : {
                "description" : "Authentications",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Authentication id",
                            "type" : [ "string", "null" ]
                        },
                        "name" : {
                            "description" : "Authentication name",
                            "type" : [ "string", "null" ]
                        },
                        "realm" : {
                            "type" : "string",
                            "maxLength" : 255,
                            "pattern" : "^$|^([!-~]([ -~]){0,253}[!-~]|[!-~]{1,1})$",
                            "description" : "Authentication realm"
                        },
                        "serviceType" : {
                            "description" : "Authentication service type",
                            "enum" : [ "NA", "LOCAL_DB", "RADIUS" ]
                        },
                        "vlanId" : {
                            "description" : "Dynamic vlan ID",
                            "type" : [ "integer", "null" ],
                            "minimum" : 1,
                            "maximum" : 4094
                        }
                    },
                    "required" : [ "realm", "serviceType" ]
                }
            },
            "accountings" : {
                "description" : "Accountings",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Accounting id",
                            "type" : [ "string", "null" ]
                        },
                        "name" : {
                            "description" : "Accounting name",
                            "type" : [ "string", "null" ]
                        },
                        "realm" : {
                            "type" : "string",
                            "maxLength" : 255,
                            "pattern" : "^$|^([!-~]([ -~]){0,253}[!-~]|[!-~]{1,1})$"
                        },
                        "serviceType" : {
                            "description" : "Accounting service type",
                            "enum" : [ "NA", "RADIUS", "CGF" ]
                        }
                    },
                    "required" : [ "realm", "serviceType" ]
                }
            },
            "osu" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "type" : {
                        "description" : "Online singup type",
                        "enum" : [ "Internal", "External" ]
                    },
                    "internalOSU" : {
                        "type" : [ "object", "null" ],
                        "additionalProperties" : false,
                        "properties" : {
                            "provisioningProtocals" : {
                                "description" : "Provisioning protocal",
                                "type" : "array",
                                "items" : {
                                    "enum" : [ "SOAP_XML", "OMA_DM" ]
                                }
                            },
                            "provisioningFormat" : {
                                "description" : "Provisioning format",
                                "enum" : [ "R1_R2_ZEROIT", "R2_ZEROIT" ]
                            },
                            "provisioningUpdateType" : {
                                "description" : "Provisioning update at",
                                "enum" : [ "ALWAYS", "KNOWN_ROAM_PARTNERS", "NEVER" ]
                            },
                            "osuPortal" : {
                                "type" : "object",
                                "additionalProperties" : false,
                                "properties" : {
                                    "type" : {
                                        "description" : "Portal type",
                                        "enum" : [ "Internal", "External" ]
                                    },
                                    "internalOSUPortal" : {
                                        "type" : [ "object", "null" ],
                                        "additionalProperties" : false,
                                        "properties" : {
                                            "id" : {
                                                "type" : "string"
                                            },
                                            "name" : {
                                                "type" : "string"
                                            }
                                        },
                                        "description" : "Internal online singup portal, required when type is Internal"
                                    },
                                    "externalUrl" : {
                                        "type" : [ "string", "null" ],
                                        "pattern" : "^(https://)?(?:\w+:\w+@)?((?:(?:[-\w\d{1-3}]+\.)+(?:com|org|net|gov|mil|biz|info|mobi|name|aero|jobs|edu|co\.uk|ac\.uk|it|fr|tv|museum|asia|local|travel|[a-z]{2}))|((\b25[0-5]\b|\b[2][0-4][0-9]\b|\b[0-1]?[0-9]?[0-9]\b)(\.(\b25[0-5]\b|\b[2][0-4][0-9]\b|\b[0-1]?[0-9]?[0-9]\b)){3}))(?::[\d]{1,5})?(?:(?:(?:/(?:[-\w~!$+|.,=]|%[a-f\d]{2})+)+|/)+|\?|#)?(?:(?:\?(?:[-\w~!$+|.,*:]|%[a-f\d{2}])+=?(?:[-\w~!$+|.,*:=]|%[a-f\d]{2})*)(?:&(?:[-\w~!$+|.,*:]|%[a-f\d{2}])+=?(?:[-\w~!$+|.,*:=]|%[a-f\d]{2})*)*)*(?:#(?:[-\w~!$ |/.,*:;=]|%[a-f\d]{2})*)?$",
                                        "description" : "External online singup portal, start with https://, required when type is External"
                                    }
                                },
                                "required" : [ "type" ]
                            },
                            "commonLanguageIcon" : {
                                "description" : "The base64 encoded data of icon.",
                                "type" : "string"
                            },
                            "subscriptionDescriptions" : {
                                "description" : "Subscription descriptions",
                                "type" : "array",
                                "items" : {
                                    "type" : "object",
                                    "additionalProperties" : false,
                                    "properties" : {
                                        "language" : {
                                            "enum" : [ "English", "Chinese", "Czech", "Danish", "Dutch", "French", "German", "Japanese", "Spanish", "Korean", "Swedish", "Turkish" ],
                                            "description" : "Language of the friendly name"
                                        },
                                        "name" : {
                                            "type" : "string",
                                            "minLength" : 2,
                                            "maxLength" : 32,
                                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                                            "description" : "Name of the friendly name"
                                        },
                                        "description" : {
                                            "type" : [ "string", "null" ],
                                            "maxLength" : 64,
                                            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                                            "description" : "Description of the friendly name"
                                        },
                                        "icon" : {
                                            "description" : "The binary data of icon, maximum size 65536",
                                            "type" : "string"
                                        }
                                    },
                                    "required" : [ "language", "name" ]
                                }
                            },
                            "certificate" : {
                                "type" : [ "object", "null" ],
                                "additionalProperties" : false,
                                "properties" : {
                                    "id" : {
                                        "type" : "string"
                                    },
                                    "name" : {
                                        "type" : "string"
                                    }
                                },
                                "description" : "Online signup certificate"
                            },
                            "osuAuthServices" : {
                                "description" : "Online signup authentication services",
                                "type" : "array",
                                "items" : {
                                    "type" : "object",
                                    "additionalProperties" : false,
                                    "properties" : {
                                        "id" : {
                                            "description" : "Identifier of authentication service",
                                            "type" : "string"
                                        },
                                        "name" : {
                                            "description" : "Authentication service name",
                                            "type" : "string"
                                        },
                                        "credentialType" : {
                                            "description" : "Authentication credential type",
                                            "enum" : [ "LOCAL", "REMOTE" ]
                                        },
                                        "realm" : {
                                            "type" : "string",
                                            "maxLength" : 255,
                                            "pattern" : "^$|^([!-~]([ -~]){0,253}[!-~]|[!-~]{1,1})$",
                                            "description" : "Authentication realm"
                                        },
                                        "expiration" : {
                                            "description" : "Expiration hour. null mean never expire",
                                            "type" : [ "integer", "null" ],
                                            "minimum" : 1,
                                            "maximum" : 175200
                                        }
                                    },
                                    "required" : [ "credentialType", "realm" ]
                                }
                            },
                            "whitelistedDomains" : {
                                "description" : "whitelisted domains",
                                "type" : "array",
                                "items" : {
                                    "description" : "Compare with FQDN, it could start with '*.'",
                                    "type" : "string",
                                    "pattern" : "^((?=.{1,253}$)((?=[a-z0-9-]{1,63}\.)(xn--)?[a-z0-9]+(-[a-z0-9]+)*\.)+[a-z]{2,63}|(\*\.)(?=.{1,253}$)((?=[a-z0-9-]{1,63}\.)(xn--)?[a-z0-9]+(-[a-z0-9]+)*\.)+[a-z]{2,63})$"
                                }
                            }
                        },
                        "required" : [ "provisioningProtocals", "provisioningFormat", "provisioningUpdateType", "osuPortal", "commonLanguageIcon", "subscriptionDescriptions", "certificate", "osuAuthServices" ],
                        "description" : "Internal online singup, required when type is Internal"
                    },
                    "externalOSU" : {
                        "type" : [ "object", "null" ],
                        "additionalProperties" : false,
                        "properties" : {
                            "provisioningProtocals" : {
                                "description" : "Provisioning protocal",
                                "type" : "array",
                                "item" : {
                                    "enum" : [ "SOAP_XML", "OMA_DM" ]
                                }
                            },
                            "osuServiceUrl" : {
                                "type" : [ "string", "null" ],
                                "pattern" : "^(https://)?(?:\w+:\w+@)?((?:(?:[-\w\d{1-3}]+\.)+(?:com|org|net|gov|mil|biz|info|mobi|name|aero|jobs|edu|co\.uk|ac\.uk|it|fr|tv|museum|asia|local|travel|[a-z]{2}))|((\b25[0-5]\b|\b[2][0-4][0-9]\b|\b[0-1]?[0-9]?[0-9]\b)(\.(\b25[0-5]\b|\b[2][0-4][0-9]\b|\b[0-1]?[0-9]?[0-9]\b)){3}))(?::[\d]{1,5})?(?:(?:(?:/(?:[-\w~!$+|.,=]|%[a-f\d]{2})+)+|/)+|\?|#)?(?:(?:\?(?:[-\w~!$+|.,*:]|%[a-f\d{2}])+=?(?:[-\w~!$+|.,*:=]|%[a-f\d]{2})*)(?:&(?:[-\w~!$+|.,*:]|%[a-f\d{2}])+=?(?:[-\w~!$+|.,*:=]|%[a-f\d]{2})*)*)*(?:#(?:[-\w~!$ |/.,*:;=]|%[a-f\d]{2})*)?$",
                                "description" : "External service URL, start with https://"
                            },
                            "osuNaiRealm" : {
                                "description" : "Online signup NAI realm, it should be one of realm as defined in Hotspot 2.0 identity provider",
                                "type" : "string"
                            },
                            "commonLanguageIcon" : {
                                "description" : "The base64 encoded data of icon.",
                                "type" : "string"
                            },
                            "subscriptionDescriptions" : {
                                "description" : "Subscription descriptions",
                                "type" : "array",
                                "items" : {
                                    "type" : "object",
                                    "additionalProperties" : false,
                                    "properties" : {
                                        "language" : {
                                            "enum" : [ "English", "Chinese", "Czech", "Danish", "Dutch", "French", "German", "Japanese", "Spanish", "Korean", "Swedish", "Turkish" ],
                                            "description" : "Language of the friendly name"
                                        },
                                        "name" : {
                                            "type" : "string",
                                            "minLength" : 2,
                                            "maxLength" : 32,
                                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                                            "description" : "Name of the friendly name"
                                        },
                                        "description" : {
                                            "type" : [ "string", "null" ],
                                            "maxLength" : 64,
                                            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                                            "description" : "Description of the friendly name"
                                        },
                                        "icon" : {
                                            "description" : "The binary data of icon, maximum size 65536",
                                            "type" : "string"
                                        }
                                    },
                                    "required" : [ "language", "name" ]
                                }
                            },
                            "whitelistedDomains" : {
                                "description" : "Whitelisted domains",
                                "type" : "array",
                                "items" : {
                                    "description" : "Compare with FQDN, it could start with '*.'",
                                    "type" : "string",
                                    "pattern" : "^((?=.{1,253}$)((?=[a-z0-9-]{1,63}\.)(xn--)?[a-z0-9]+(-[a-z0-9]+)*\.)+[a-z]{2,63}|(\*\.)(?=.{1,253}$)((?=[a-z0-9-]{1,63}\.)(xn--)?[a-z0-9]+(-[a-z0-9]+)*\.)+[a-z]{2,63})$"
                                }
                            }
                        },
                        "required" : [ "provisioningProtocals", "osuServiceUrl", "osuNaiRealm", "commonLanguageIcon", "subscriptionDescriptions" ],
                        "description" : "External online singup, required when type is External"
                    }
                },
                "required" : [ "type" ],
                "description" : "Online Signup & Provisioning"
            }
        },
        "required" : [ "name", "realms", "authentications" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "profileUUID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            }
        }
    }
    
    

Modify Basic 

/v4_0/profiles/hs20/identityproviders/{id}

Use this API command to modify the basic information of a Hotspot 2.0 identity provider.

  • Request
  • Body
    {
        "name" : "test-hs20provider"
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Name of the Hotspot 2.0 identity provider profile"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Description of the Hotspot 2.0 identity provider profile"
        }
    }
    
    
  • Response  204

Modify Realms 

/v4_0/profiles/hs20/identityproviders/{id}/realms

Use this API command to modify realms of a Hotspot 2.0 identity provider.

  • Request
  • Body
    [ {
        "name" : "realm1",
        "encoding" : "UTF8",
        "eapMethods" : [ {
            "type" : "NA"
        }, {
            "type" : "NA"
        }, {
            "type" : "NA"
        }, {
            "type" : "MD5",
            "authSettings" : [ {
                "info" : "Expanded",
                "vendorId" : 2,
                "vendorType" : 34
            }, {
                "info" : "Non",
                "type" : "PAP"
            }, {
                "info" : "Credential",
                "type" : "Softoken"
            } ]
        } ]
    } ]
    
    
    Schema
    {
        "description" : "Realms",
        "type" : "array",
        "items" : {
            "type" : "object",
            "additionalProperties" : false,
            "properties" : {
                "name" : {
                    "type" : "string",
                    "minLength" : 2,
                    "maxLength" : 32,
                    "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                    "description" : "Name of realm"
                },
                "encoding" : {
                    "description" : "Encoding",
                    "enum" : [ "RFC4282", "UTF8" ]
                },
                "eapMethods" : {
                    "description" : "EAP methods",
                    "type" : "array",
                    "items" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "properties" : {
                            "type" : {
                                "description" : "EAP method type",
                                "enum" : [ "NA", "MD5", "EAP_TLS", "EAP_Cisco", "EAP_SIM", "EAP_TTLS", "EAP_AKA", "PEAP", "EAP_MSCHAP_V2", "EAP_AKAs", "Reserved" ]
                            },
                            "authSettings" : {
                                "description" : "EAP method auth settings",
                                "type" : [ "array", "null" ],
                                "items" : {
                                    "type" : "object",
                                    "additionalProperties" : false,
                                    "properties" : {
                                        "info" : {
                                            "description" : "EAP auth info",
                                            "enum" : [ "Expanded", "Non", "Inner", "Expanded_Inner", "Credential", "Tunneled" ]
                                        },
                                        "type" : {
                                            "description" : "EAP auth type",
                                            "type" : "string"
                                        },
                                        "vendorId" : {
                                            "description" : "EAP auth vendor ID",
                                            "type" : [ "integer", "null" ],
                                            "minimum" : 0,
                                            "maximum" : 16777215
                                        },
                                        "vendorType" : {
                                            "description" : "EAP auth vendor type",
                                            "type" : [ "integer", "null" ],
                                            "minimum" : 0,
                                            "maximum" : 4294967295
                                        }
                                    },
                                    "required" : [ "info" ]
                                }
                            }
                        },
                        "required" : [ "type" ]
                    }
                }
            },
            "required" : [ "name", "encoding", "eapMethods" ]
        }
    }
    
    
  • Response  204

Modify PLMNs 

/v4_0/profiles/hs20/identityproviders/{id}/plmns

Use this API command to modify PLMNs of a Hotspot 2.0 identity provider.

  • Request
  • Body
    [ {
        "mcc" : "124",
        "mnc" : "12"
    }, {
        "mcc" : "389",
        "mnc" : "459"
    } ]
    
    
    Schema
    {
        "description" : "PLMNs",
        "type" : "array",
        "items" : {
            "type" : "object",
            "additionalProperties" : false,
            "properties" : {
                "mcc" : {
                    "description" : "MCC",
                    "type" : "string",
                    "pattern" : "^[0-9]{3}$"
                },
                "mnc" : {
                    "description" : "MNC",
                    "type" : "string",
                    "pattern" : "^[0-9]{2,3}$"
                }
            },
            "required" : [ "mcc", "mnc" ]
        }
    }
    
    
  • Response  204

Modify Home OIs 

/v4_0/profiles/hs20/identityproviders/{id}/homeOis

Use this API command to modify home OIs of a Hotspot 2.0 identity provider.

  • Request
  • Body
    [ {
        "name" : "abc",
        "oi" : "121212"
    }, {
        "name" : "edf",
        "oi" : "FFFFFFFFFF"
    } ]
    
    
    Schema
    {
        "description" : "Home OIs",
        "type" : "array",
        "items" : {
            "type" : "object",
            "additionalProperties" : false,
            "properties" : {
                "name" : {
                    "description" : "Name of the home OI",
                    "type" : "string",
                    "maxLength" : 255
                },
                "oi" : {
                    "description" : "Orgnization ID(3Hex or 5Hex)",
                    "type" : "string",
                    "pattern" : "^(([0-9a-fA-F][0-9a-fA-F]){3}|([0-9a-fA-F][0-9a-fA-F]){5})$"
                }
            },
            "required" : [ "name", "oi" ]
        }
    }
    
    
  • Response  204

Modify Authentications 

/v4_0/profiles/hs20/identityproviders/{id}/authentications

Use this API command to modify authentications of a Hotspot 2.0 identity provider.

  • Request
  • Body
    [ {
        "name" : "Local Database",
        "realm" : "No Match",
        "serviceType" : "LOCAL_DB"
    }, {
        "name" : "globalAuthRadius",
        "realm" : "Unspecified",
        "serviceType" : "RADIUS"
    }, {
        "name" : "globalAuthRadius",
        "realm" : "realmTest",
        "serviceType" : "RADIUS"
    } ]
    
    
    Schema
    {
        "description" : "Authentications",
        "type" : "array",
        "items" : {
            "type" : "object",
            "additionalProperties" : false,
            "properties" : {
                "id" : {
                    "description" : "Authentication id",
                    "type" : [ "string", "null" ]
                },
                "name" : {
                    "description" : "Authentication name",
                    "type" : [ "string", "null" ]
                },
                "realm" : {
                    "type" : "string",
                    "maxLength" : 255,
                    "pattern" : "^$|^([!-~]([ -~]){0,253}[!-~]|[!-~]{1,1})$",
                    "description" : "Authentication realm"
                },
                "serviceType" : {
                    "description" : "Authentication service type",
                    "enum" : [ "NA", "LOCAL_DB", "RADIUS" ]
                },
                "vlanId" : {
                    "description" : "Dynamic vlan ID",
                    "type" : [ "integer", "null" ],
                    "minimum" : 1,
                    "maximum" : 4094
                }
            },
            "required" : [ "realm", "serviceType" ]
        }
    }
    
    
  • Response  204

Modify Accountings 

/v4_0/profiles/hs20/identityproviders/{id}/accountings

Use this API command to modify accountings of a Hotspot 2.0 identity provider.

  • Request
  • Body
    [ {
        "realm" : "No Match",
        "serviceType" : "NA"
    }, {
        "name" : "globalAcctRadius",
        "realm" : "Unspecified",
        "serviceType" : "RADIUS"
    }, {
        "name" : "globalAcctRadius",
        "realm" : "realmTest",
        "serviceType" : "RADIUS"
    } ]
    
    
    Schema
    {
        "description" : "Accountings",
        "type" : "array",
        "items" : {
            "type" : "object",
            "additionalProperties" : false,
            "properties" : {
                "id" : {
                    "description" : "Accounting id",
                    "type" : [ "string", "null" ]
                },
                "name" : {
                    "description" : "Accounting name",
                    "type" : [ "string", "null" ]
                },
                "realm" : {
                    "type" : "string",
                    "maxLength" : 255,
                    "pattern" : "^$|^([!-~]([ -~]){0,253}[!-~]|[!-~]{1,1})$"
                },
                "serviceType" : {
                    "description" : "Accounting service type",
                    "enum" : [ "NA", "RADIUS", "CGF" ]
                }
            },
            "required" : [ "realm", "serviceType" ]
        }
    }
    
    
  • Response  204

Disable Accountings 

/v4_0/profiles/hs20/identityproviders/{id}/accountings

Use this API command to disable accountings of a Hotspot 2.0 identity provider.

  • Response  204

Modify Online Signup & Provisioning 

/v4_0/profiles/hs20/identityproviders/{id}/osu

Use this API command to modify online signup & provisioning of a Hotspot 2.0 identity provider.

  • Request
  • Body
    {
        "type" : "Internal",
        "internalOSU" : {
            "provisioningProtocals" : [ "SOAP_XML" ],
            "provisioningFormat" : "R1_R2_ZEROIT",
            "provisioningUpdateType" : "ALWAYS",
            "osuPortal" : {
                "type" : "Internal",
                "internalOSUPortal" : {
                    "name" : "${PROFILE_ONLINE_SIGNUP_NAME}"
                }
            },
            "commonLanguageIcon" : "Base64:imageData",
            "serviceDescriptions" : [ {
                "language" : "English",
                "name" : "ruckus"
            } ],
            "certificate" : {
                "id" : "certificateID",
                "name" : "certificateName"
            },
            "whitelistedDomains" : [ "google.com", "*.ruckus.com" ],
            "osuAuthServices" : [ {
                "name" : "Local Database",
                "credentialType" : "LOCAL",
                "realm" : "realm1"
            } ]
        },
        "externalOSU" : {
            "provisioningProtocals" : [ "SOAP_XML", "OMA_DM" ],
            "osuServiceUrl" : "https://ruckus.com",
            "osuNaiRealm" : "realm1",
            "commonLanguageIcon" : "Base64:imageData",
            "serviceDescriptions" : [ {
                "language" : "English",
                "name" : "ruckus"
            } ],
            "whitelistedDomains" : [ "google.com", "*.ruckus.com" ]
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "type" : {
                "description" : "Online singup type",
                "enum" : [ "Internal", "External" ]
            },
            "internalOSU" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "provisioningProtocals" : {
                        "description" : "Provisioning protocal",
                        "type" : "array",
                        "items" : {
                            "enum" : [ "SOAP_XML", "OMA_DM" ]
                        }
                    },
                    "provisioningFormat" : {
                        "description" : "Provisioning format",
                        "enum" : [ "R1_R2_ZEROIT", "R2_ZEROIT" ]
                    },
                    "provisioningUpdateType" : {
                        "description" : "Provisioning update at",
                        "enum" : [ "ALWAYS", "KNOWN_ROAM_PARTNERS", "NEVER" ]
                    },
                    "osuPortal" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "properties" : {
                            "type" : {
                                "description" : "Portal type",
                                "enum" : [ "Internal", "External" ]
                            },
                            "internalOSUPortal" : {
                                "type" : [ "object", "null" ],
                                "additionalProperties" : false,
                                "properties" : {
                                    "id" : {
                                        "type" : "string"
                                    },
                                    "name" : {
                                        "type" : "string"
                                    }
                                },
                                "description" : "Internal online singup portal, required when type is Internal"
                            },
                            "externalUrl" : {
                                "type" : [ "string", "null" ],
                                "pattern" : "^(https://)?(?:\w+:\w+@)?((?:(?:[-\w\d{1-3}]+\.)+(?:com|org|net|gov|mil|biz|info|mobi|name|aero|jobs|edu|co\.uk|ac\.uk|it|fr|tv|museum|asia|local|travel|[a-z]{2}))|((\b25[0-5]\b|\b[2][0-4][0-9]\b|\b[0-1]?[0-9]?[0-9]\b)(\.(\b25[0-5]\b|\b[2][0-4][0-9]\b|\b[0-1]?[0-9]?[0-9]\b)){3}))(?::[\d]{1,5})?(?:(?:(?:/(?:[-\w~!$+|.,=]|%[a-f\d]{2})+)+|/)+|\?|#)?(?:(?:\?(?:[-\w~!$+|.,*:]|%[a-f\d{2}])+=?(?:[-\w~!$+|.,*:=]|%[a-f\d]{2})*)(?:&(?:[-\w~!$+|.,*:]|%[a-f\d{2}])+=?(?:[-\w~!$+|.,*:=]|%[a-f\d]{2})*)*)*(?:#(?:[-\w~!$ |/.,*:;=]|%[a-f\d]{2})*)?$",
                                "description" : "External online singup portal, start with https://, required when type is External"
                            }
                        },
                        "required" : [ "type" ]
                    },
                    "commonLanguageIcon" : {
                        "description" : "The base64 encoded data of icon.",
                        "type" : "string"
                    },
                    "subscriptionDescriptions" : {
                        "description" : "Subscription descriptions",
                        "type" : "array",
                        "items" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                                "language" : {
                                    "enum" : [ "English", "Chinese", "Czech", "Danish", "Dutch", "French", "German", "Japanese", "Spanish", "Korean", "Swedish", "Turkish" ],
                                    "description" : "Language of the friendly name"
                                },
                                "name" : {
                                    "type" : "string",
                                    "minLength" : 2,
                                    "maxLength" : 32,
                                    "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                                    "description" : "Name of the friendly name"
                                },
                                "description" : {
                                    "type" : [ "string", "null" ],
                                    "maxLength" : 64,
                                    "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                                    "description" : "Description of the friendly name"
                                },
                                "icon" : {
                                    "description" : "The binary data of icon, maximum size 65536",
                                    "type" : "string"
                                }
                            },
                            "required" : [ "language", "name" ]
                        }
                    },
                    "certificate" : {
                        "type" : [ "object", "null" ],
                        "additionalProperties" : false,
                        "properties" : {
                            "id" : {
                                "type" : "string"
                            },
                            "name" : {
                                "type" : "string"
                            }
                        },
                        "description" : "Online signup certificate"
                    },
                    "osuAuthServices" : {
                        "description" : "Online signup authentication services",
                        "type" : "array",
                        "items" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                                "id" : {
                                    "description" : "Identifier of authentication service",
                                    "type" : "string"
                                },
                                "name" : {
                                    "description" : "Authentication service name",
                                    "type" : "string"
                                },
                                "credentialType" : {
                                    "description" : "Authentication credential type",
                                    "enum" : [ "LOCAL", "REMOTE" ]
                                },
                                "realm" : {
                                    "type" : "string",
                                    "maxLength" : 255,
                                    "pattern" : "^$|^([!-~]([ -~]){0,253}[!-~]|[!-~]{1,1})$",
                                    "description" : "Authentication realm"
                                },
                                "expiration" : {
                                    "description" : "Expiration hour. null mean never expire",
                                    "type" : [ "integer", "null" ],
                                    "minimum" : 1,
                                    "maximum" : 175200
                                }
                            },
                            "required" : [ "credentialType", "realm" ]
                        }
                    },
                    "whitelistedDomains" : {
                        "description" : "whitelisted domains",
                        "type" : "array",
                        "items" : {
                            "description" : "Compare with FQDN, it could start with '*.'",
                            "type" : "string",
                            "pattern" : "^((?=.{1,253}$)((?=[a-z0-9-]{1,63}\.)(xn--)?[a-z0-9]+(-[a-z0-9]+)*\.)+[a-z]{2,63}|(\*\.)(?=.{1,253}$)((?=[a-z0-9-]{1,63}\.)(xn--)?[a-z0-9]+(-[a-z0-9]+)*\.)+[a-z]{2,63})$"
                        }
                    }
                },
                "required" : [ "provisioningProtocals", "provisioningFormat", "provisioningUpdateType", "osuPortal", "commonLanguageIcon", "subscriptionDescriptions", "certificate", "osuAuthServices" ],
                "description" : "Internal online singup, required when type is Internal"
            },
            "externalOSU" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "provisioningProtocals" : {
                        "description" : "Provisioning protocal",
                        "type" : "array",
                        "item" : {
                            "enum" : [ "SOAP_XML", "OMA_DM" ]
                        }
                    },
                    "osuServiceUrl" : {
                        "type" : [ "string", "null" ],
                        "pattern" : "^(https://)?(?:\w+:\w+@)?((?:(?:[-\w\d{1-3}]+\.)+(?:com|org|net|gov|mil|biz|info|mobi|name|aero|jobs|edu|co\.uk|ac\.uk|it|fr|tv|museum|asia|local|travel|[a-z]{2}))|((\b25[0-5]\b|\b[2][0-4][0-9]\b|\b[0-1]?[0-9]?[0-9]\b)(\.(\b25[0-5]\b|\b[2][0-4][0-9]\b|\b[0-1]?[0-9]?[0-9]\b)){3}))(?::[\d]{1,5})?(?:(?:(?:/(?:[-\w~!$+|.,=]|%[a-f\d]{2})+)+|/)+|\?|#)?(?:(?:\?(?:[-\w~!$+|.,*:]|%[a-f\d{2}])+=?(?:[-\w~!$+|.,*:=]|%[a-f\d]{2})*)(?:&(?:[-\w~!$+|.,*:]|%[a-f\d{2}])+=?(?:[-\w~!$+|.,*:=]|%[a-f\d]{2})*)*)*(?:#(?:[-\w~!$ |/.,*:;=]|%[a-f\d]{2})*)?$",
                        "description" : "External service URL, start with https://"
                    },
                    "osuNaiRealm" : {
                        "description" : "Online signup NAI realm, it should be one of realm as defined in Hotspot 2.0 identity provider",
                        "type" : "string"
                    },
                    "commonLanguageIcon" : {
                        "description" : "The base64 encoded data of icon.",
                        "type" : "string"
                    },
                    "subscriptionDescriptions" : {
                        "description" : "Subscription descriptions",
                        "type" : "array",
                        "items" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                                "language" : {
                                    "enum" : [ "English", "Chinese", "Czech", "Danish", "Dutch", "French", "German", "Japanese", "Spanish", "Korean", "Swedish", "Turkish" ],
                                    "description" : "Language of the friendly name"
                                },
                                "name" : {
                                    "type" : "string",
                                    "minLength" : 2,
                                    "maxLength" : 32,
                                    "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                                    "description" : "Name of the friendly name"
                                },
                                "description" : {
                                    "type" : [ "string", "null" ],
                                    "maxLength" : 64,
                                    "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                                    "description" : "Description of the friendly name"
                                },
                                "icon" : {
                                    "description" : "The binary data of icon, maximum size 65536",
                                    "type" : "string"
                                }
                            },
                            "required" : [ "language", "name" ]
                        }
                    },
                    "whitelistedDomains" : {
                        "description" : "Whitelisted domains",
                        "type" : "array",
                        "items" : {
                            "description" : "Compare with FQDN, it could start with '*.'",
                            "type" : "string",
                            "pattern" : "^((?=.{1,253}$)((?=[a-z0-9-]{1,63}\.)(xn--)?[a-z0-9]+(-[a-z0-9]+)*\.)+[a-z]{2,63}|(\*\.)(?=.{1,253}$)((?=[a-z0-9-]{1,63}\.)(xn--)?[a-z0-9]+(-[a-z0-9]+)*\.)+[a-z]{2,63})$"
                        }
                    }
                },
                "required" : [ "provisioningProtocals", "osuServiceUrl", "osuNaiRealm", "commonLanguageIcon", "subscriptionDescriptions" ],
                "description" : "External online singup, required when type is External"
            }
        },
        "required" : [ "type" ],
        "description" : "Online Signup & Provisioning"
    }
    
    
  • Response  204

Disable Online Signup & Provisioning 

/v4_0/profiles/hs20/identityproviders/{id}/osu

Use this API command to disable online signup & provisioning of a Hotspot 2.0 identity provider.

  • Response  204

Delete 

/v4_0/profiles/hs20/identityproviders/{id}

Use this API command to delete a Hotspot 2.0 identity provider.

  • Response  204

Certificate 

Retrieve Certificate List 

/v4_0/certstore/certificate

Use this API command to retrieve list of installed certificates.

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

  • Response  200
  • Body
    {
        "totalCount" : 2,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "rootCertificate",
            "name" : "rootCertificate",
            "description" : "root certificate description"
        }, {
            "id" : "hs20Certificate",
            "name" : "hs20Certificate",
            "description" : "Hotspot20 certificate description"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the certificate",
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the certificate"
                        },
                        "description" : {
                            "type" : [ "string", "null" ],
                            "maxLength" : 64,
                            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                            "description" : "Description of the certificate"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve Certificate 

/v4_0/certstore/certificate/{id}

Use this API command to retrieve an installed certificate.

  • Response  200
  • Body
    {
        "id" : "certificateID",
        "name" : "certificateName",
        "description" : "certificate description",
        "data" : "certificateData",
        "information" : "certificateInformation",
        "intermediateData" : [ "intermediateCertifcateData1", "intermediateCertifcateData2" ],
        "rootData" : "rootCertificateData",
        "privateKeyData" : "privateKeyData",
        "certificasSigningRequest" : null,
        "passphrase" : "passphrase"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the certificate",
                "type" : "string"
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the certificate"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the certificate"
            },
            "data" : {
                "description" : "Data of the certificate",
                "type" : "string"
            },
            "information" : {
                "description" : "Information of the certificate",
                "type" : "string"
            },
            "intermediateData" : {
                "description" : "Intermediate data of the certificate",
                "type" : [ "array", "null" ],
                "items" : {
                    "type" : "string"
                }
            },
            "rootData" : {
                "description" : "Root data of the certificate",
                "type" : "string"
            },
            "privateKeyData" : {
                "description" : "Private key data of the certificate",
                "type" : "string"
            },
            "certificasSigningRequest" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Certificates signing request of the certificate"
            },
            "passphrase" : {
                "description" : "Key passphrase",
                "type" : "string"
            }
        }
    }
    
    

Retrieve Certificate Setting 

/v4_0/certstore/setting

Use this API command to retrieve certificate setting.

  • Response  200
  • Body
    {
        "serviceCertificates" : [ {
            "service" : "MANAGEMENT_WEB",
            "certificate" : {
                "id" : "dc9696f0-e43e-11e5-a304-525400fbb1bb",
                "name" : "newcert"
            }
        }, {
            "service" : "AP_PORTAL",
            "certificate" : {
                "id" : "dc9696f0-e43e-11e5-a304-525400fbb1bb",
                "name" : "newcert"
            }
        }, {
            "service" : "HOTSPOT",
            "certificate" : {
                "id" : "11111111-1111-1111-1111-111111111111",
                "name" : "Default Certificate"
            }
        }, {
            "service" : "COMMUNICATOR",
            "certificate" : {
                "id" : "11111111-1111-1111-1111-111111111111",
                "name" : "Default Certificate"
            }
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "serviceCertificates" : {
                "description" : "Certificate Setting of the service",
                "type" : [ "array" ],
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "service" : {
                            "description" : "the service",
                            "enum" : [ "MANAGEMENT_WEB", "AP_PORTAL", "HOTSPOT", "COMMUNICATOR" ]
                        },
                        "certificate" : {
                            "type" : [ "object", "null" ],
                            "additionalProperties" : false,
                            "properties" : {
                                "id" : {
                                    "type" : "string"
                                },
                                "name" : {
                                    "type" : "string"
                                }
                            },
                            "description" : "certificate of the service"
                        }
                    },
                    "required" : [ "service" ]
                }
            }
        }
    }
    
    

Retrieve CSR List 

/v4_0/certstore/csr

Use this API command to retrieve list of certificates signing request.

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

  • Response  200
  • Body
    {
        "totalCount" : 2,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "privateKey1",
            "name" : "privateKey1",
            "description" : "private key1 description"
        }, {
            "id" : "privateKey2",
            "name" : "privateKey2",
            "description" : "private key2 description"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the certificates signing request",
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the certificates signing request"
                        },
                        "description" : {
                            "type" : [ "string", "null" ],
                            "maxLength" : 64,
                            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                            "description" : "Description of the certificates signing request"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve CSR 

/v4_0/certstore/csr/{id}

Use this API command to retrieve a certificates signing request.

  • Response  200
  • Body
    {
        "id" : "csrID",
        "name" : "csr-test",
        "commonName" : "ruckus.com",
        "email" : "[email protected]",
        "organization" : "org",
        "organizationUnit" : "orgUnit",
        "city" : "shenzhen",
        "state" : "guangdong",
        "countryCode" : "US"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the certificates signing request",
                "type" : "string"
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the certificates signing request"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the certificates signing request"
            },
            "commonName" : {
                "description" : "Common name of the certificates signing request",
                "type" : "string"
            },
            "email" : {
                "description" : "Email of the certificates signing request",
                "type" : "string"
            },
            "organization" : {
                "description" : "Organization of the certificates signing request",
                "type" : "string"
            },
            "organizationUnit" : {
                "description" : "Organization unit of the certificates signing request",
                "type" : "string"
            },
            "city" : {
                "description" : "City of the certificates signing request",
                "type" : "string"
            },
            "state" : {
                "description" : "State of the certificates signing request",
                "type" : "string"
            },
            "countryCode" : {
                "description" : "Country code of the certificates signing request",
                "type" : "string"
            }
        }
    }
    
    

Create Certificate 

/v4_0/certstore/certificate

Use this API command to create an installed certificate.

  • Request
  • Body
    {
        "name" : "hs20Certificate",
        "description" : "Hotspot20 certificate description",
        "data" : "certificateData",
        "intermediateData" : [ "intermediateCertifcateData1", "intermediateCertifcateData2" ],
        "rootData" : "rootCertificateData",
        "privateKeyData" : "privateKeyData",
        "passphrase" : "passphrase"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the certificate"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the certificate"
            },
            "data" : {
                "description" : "Data of the certificate",
                "type" : "string"
            },
            "intermediateData" : {
                "description" : "Intermediate data of the certificate",
                "type" : [ "array", "null" ],
                "items" : {
                    "type" : "string"
                }
            },
            "rootData" : {
                "description" : "Root data of the certificate",
                "type" : "string"
            },
            "privateKeyData" : {
                "description" : "Private key data of the certificate",
                "type" : "string"
            },
            "certificasSigningRequest" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Certificates signing request of the certificate"
            },
            "passphrase" : {
                "description" : "Key passphrase",
                "type" : "string"
            }
        },
        "required" : [ "name", "data" ]
    }
    
    
  • Response  201
  • Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            }
        }
    }
    
    

Modify serviceCertificates 

/v4_0/certstore/setting/serviceCertificates

Use this API command to Modify serviceCertificates of the Certificate Setting.

  • Request
  • Body
    [ {
        "service" : "MANAGEMENT_WEB",
        "certificate" : {
            "id" : "dc9696f0-e43e-11e5-a304-525400fbb1bb",
            "name" : "newcert"
        }
    }, {
        "service" : "AP_PORTAL",
        "certificate" : {
            "id" : "dc9696f0-e43e-11e5-a304-525400fbb1bb",
            "name" : "newcert"
        }
    }, {
        "service" : "HOTSPOT",
        "certificate" : {
            "id" : "11111111-1111-1111-1111-111111111111",
            "name" : "Default Certificate"
        }
    }, {
        "service" : "COMMUNICATOR",
        "certificate" : {
            "id" : "11111111-1111-1111-1111-111111111111",
            "name" : "Default Certificate"
        }
    } ]
    
    
    Schema
    {
        "description" : "Certificate Setting of the service",
        "type" : [ "array" ],
        "items" : {
            "type" : "object",
            "additionalProperties" : false,
            "properties" : {
                "service" : {
                    "description" : "the service",
                    "enum" : [ "MANAGEMENT_WEB", "AP_PORTAL", "HOTSPOT", "COMMUNICATOR" ]
                },
                "certificate" : {
                    "type" : [ "object", "null" ],
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string"
                        }
                    },
                    "description" : "certificate of the service"
                }
            },
            "required" : [ "service" ]
        }
    }
    
    
  • Response  204

Create CSR 

/v4_0/certstore/csr

Use this API command to create a certificates signing request.

  • Request
  • Body
    {
        "name" : "csr-test",
        "commonName" : "ruckus.com",
        "email" : "[email protected]",
        "organization" : "org",
        "city" : "shenzhen",
        "state" : "guangdong",
        "countryCode" : "US"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the certificates signing request"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the certificates signing request"
            },
            "commonName" : {
                "type" : "string",
                "pattern" : "^(?=.{1,253}$)((?=[a-z0-9-]{1,63}\.)(xn--)?[a-z0-9]+(-[a-z0-9]+)*\.)+[a-z]{2,63}$",
                "description" : "Common name of the certificates signing request"
            },
            "email" : {
                "type" : "string",
                "pattern" : "^(\w+)([\-+.\'][\w]+)*@(\w[\-\w]*\.){1,255}([A-Za-z]){2,6}$",
                "description" : "Email of the certificates signing request"
            },
            "organization" : {
                "description" : "Organization of the certificates signing request",
                "type" : "string",
                "maxLength" : 64
            },
            "organizationUnit" : {
                "description" : "Organization unit of the certificates signing request",
                "type" : "string",
                "maxLength" : 64
            },
            "city" : {
                "description" : "City of the certificates signing request",
                "type" : "string",
                "maxLength" : 128
            },
            "state" : {
                "description" : "State of the certificates signing request",
                "type" : "string",
                "maxLength" : 128
            },
            "countryCode" : {
                "description" : "Country code of the certificates signing request",
                "type" : "string"
            }
        },
        "required" : [ "name", "commonName", "email", "organization", "city", "state", "countryCode" ]
    }
    
    
  • Response  201
  • Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            }
        }
    }
    
    

Delete Certificate 

/v4_0/certstore/certificate/{id}

Use this API command to delete an installed certificate.

  • Response  204

Delete CSR 

/v4_0/certstore/csr/{id}

Use this API command to delete a certificates signing request.

  • Response  204

AP APP 

Retrieve Total AP Count 

/v4_0/aps/totalCount

Use this API command to retrieve the total AP count within a zone or a domain.

  • Parameters
  • zoneId
    string (optional) 

    filter AP total count by zone. Default: current logon domain

    domainId
    string (optional) 

    filter AP total count by domain. Default: current logon domain

  • Response  200
  • Body
    The total count (integer)
    
    

Retrieve AP Summary 

/v4_0/aps/lineman

Use this API command to retrieve the summary information of an AP. This is used by the Ruckus Wireless AP mobile app.

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

    zoneId
    string (optional) 

    filter AP lineman by zone. Default: current login domain

    domainId
    string (optional) 

    filter AP lineman by domain. Default: current login domain

    showAlarm
    string (optional) 

    indicate to show alarm counter. Default: true

  • Response  200
  • Body
    {
        "totalCount" : 1,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "mac" : "00:11:22:33:44:55",
            "name" : "apName",
            "latitude" : "22.3",
            "longitude" : "114",
            "location" : "location",
            "configState" : "newConfig",
            "alarms" : {
                "criticalCount" : 0,
                "majorCount" : 1,
                "minorCount" : 7,
                "warningCount" : 0
            }
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "description" : "Total AP count",
                "type" : "integer"
            },
            "hasMore" : {
                "description" : "Indicates if there are more APs after the currently displayed list",
                "type" : "boolean"
            },
            "firstIndex" : {
                "description" : "Index of the first AP returned out of the complete AP list",
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "mac" : {
                            "type" : "string",
                            "pattern" : "^([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F])$",
                            "description" : "MAC address of the AP"
                        },
                        "name" : {
                            "description" : "Name of the AP",
                            "type" : "string"
                        },
                        "latitude" : {
                            "type" : "number",
                            "description" : "Latitude coordinate (in decimal format) of the AP"
                        },
                        "longitude" : {
                            "type" : "number",
                            "description" : "Longitude coordinate (in decimal format) of the AP"
                        },
                        "configState" : {
                            "description" : "State of the AP configuration",
                            "enum" : [ "newConfig", "fwApplied", "fwDownloaded", "fwFailed", "configApplied", "completed", "configFailed" ]
                        },
                        "location" : {
                            "type" : "string",
                            "pattern" : "^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                            "description" : "Location of the AP. This is a free format text description that indicates the location of the AP."
                        },
                        "alarms" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                                "criticalCount" : {
                                    "description" : "Critical alarm count",
                                    "type" : "integer"
                                },
                                "majorCount" : {
                                    "description" : "Major alarm count",
                                    "type" : "integer"
                                },
                                "minorCount" : {
                                    "description" : "Minor alarm count",
                                    "type" : "integer"
                                },
                                "warningCount" : {
                                    "description" : "Warning alarm count",
                                    "type" : "integer"
                                }
                            },
                            "description" : "Alarm counters by severity on the AP"
                        }
                    }
                }
            }
        }
    }
    
    

Upload Workflow File 

/v4_0/lineman/workflow

Use this API command to upload a workflow file used by the Ruckus Wireless AP mobile app.

  • Request
  • Body
    The workflow file
    
    
  • Response  204

Download Workflow File 

/v4_0/lineman/workflow

Use this API command to download the workflow file used by the Ruckus Wireless AP mobile app.

  • Response  200
  • Body
    The workflow file
    
    

Connectivity Tools 

SpeedFlex 

/v4_0/tool/speedflex

Use this API command to start the SpeedFlex test.

  • Request
  • Body
    {
        "tool" : "ZAP_DOWN",
        "protocol" : "UDP",
        "model" : "AP",
        "clientIp" : "1.1.1.1",
        "clientMac" : "00:11:22:33:44:55",
        "serverIp" : "2.2.2.2",
        "serverMac" : "11:22:33:44:55:66",
        "syspmtu" : 1500
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "tool" : {
                "description" : "SpeedFlex tool",
                "enum" : [ "ZAP_DOWN", "ZAP_UP" ]
            },
            "protocol" : {
                "description" : "Protocol used in the SpeedFlex test",
                "enum" : [ "UDP", "TCP" ]
            },
            "model" : {
                "description" : "Test model",
                "enum" : [ "AP", "CLIENT", "TRACE", "HOP", "NULL" ]
            },
            "clientIp" : {
                "type" : "string",
                "description" : "The HTTP request remove address is used if none is specified"
            },
            "clientMac" : {
                "type" : "string",
                "pattern" : "^([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F])$",
                "description" : "The HTTP request remove MAC address is used if none is specified"
            },
            "serverIp" : {
                "type" : "string",
                "description" : "The AP IP address is resolved from the client IP address if none is specified"
            },
            "serverMac" : {
                "type" : "string",
                "pattern" : "^([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F])$",
                "description" : "The AP MAC address is resolved from the client MAC address if none is specified"
            },
            "syspmtu" : {
                "description" : "Default: 1500",
                "type" : "integer"
            }
        },
        "required" : [ "tool", "protocol" ]
    }
    
    
  • Response  200
  • Body
    {
        "wcid" : "123",
        "resultId" : 11,
        "uplink" : 33,
        "downlink" : 44,
        "latency" : 23,
        "packetLoss" : 21,
        "etf" : 21
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "wcid" : {
                "descriptin" : "WCID",
                "type" : "string"
            },
            "resultId" : {
                "description" : "Result ID",
                "type" : "integer"
            },
            "uplink" : {
                "description" : "Uplink",
                "type" : "integer"
            },
            "downlink" : {
                "description" : "Downlink",
                "type" : "integer"
            },
            "latency" : {
                "description" : "Latency",
                "type" : "integer"
            },
            "packetLoss" : {
                "description" : "Packet loss",
                "type" : "integer"
            },
            "etf" : {
                "description" : "ETF",
                "type" : "integer"
            }
        }
    }
    
    

Retrieve SppedFlex Results 

/v4_0/tool/speedflex/{wcid}

Use this API command to retrieve existing SpeedFlex test results.

  • Response  200
  • Body
    {
        "wcid" : "123",
        "resultId" : 11,
        "uplink" : 33,
        "downlink" : 44,
        "latency" : 23,
        "packetLoss" : 21,
        "etf" : 21
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "wcid" : {
                "descriptin" : "WCID",
                "type" : "string"
            },
            "resultId" : {
                "description" : "Result ID",
                "type" : "integer"
            },
            "uplink" : {
                "description" : "Uplink",
                "type" : "integer"
            },
            "downlink" : {
                "description" : "Downlink",
                "type" : "integer"
            },
            "latency" : {
                "description" : "Latency",
                "type" : "integer"
            },
            "packetLoss" : {
                "description" : "Packet loss",
                "type" : "integer"
            },
            "etf" : {
                "description" : "ETF",
                "type" : "integer"
            }
        }
    }
    
    

Ping 

/v4_0/tool/ping

Use this API command to run the PING test on an AP.

  • Parameters
  • apMac
    string (required) 

    MAC address of the AP running the PING test

    targetIP
    string (required) 

    the IP address to PING

Trace Route 

/v4_0/tool/traceRoute

Use this API command to run the traceroute test on an AP.

  • Parameters
  • apMac
    string (required) 

    MAC address of the AP running the traceRoute test

    targetIP
    string (required) 

    the target IP address to traceRoute

    timeoutInSec
    string (optional) 

    Timeout in unit of seconds (Default: 30)

  • Response  200
  • Body
    Trace Route Result
    
    

System 

System Summary 

/v4_0/controller

Use this API command to retrieve the system summary.

  • Response  200
  • Body
    {
        "totalCount" : 1,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "b42be2c8-71bf-465a-8fd2-3911dcf885e4",
            "model" : "SCG200",
            "description" : "gui96-scg200-vm",
            "hostName" : "gui96-scg200-vm",
            "mac" : "00:0C:29:B1:34:69",
            "serialNumber" : "00000096",
            "clusterRole" : "Follower",
            "controlNatIp" : null,
            "uptimeInSec" : 165561,
            "name" : "gui96-scg200-vm-C",
            "version" : "3.0.0.0.211",
            "cpVersion" : "3.0.0.0.543",
            "dpVersion" : "3.0.0.0.56",
            "apVersion" : "3.0.0.0.125",
            "controlIp" : "172.18.114.29",
            "dataIp" : null
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the controller",
                            "type" : "string"
                        },
                        "model" : {
                            "description" : "Product model",
                            "type" : "string"
                        },
                        "description" : {
                            "description" : "Description of the controller",
                            "type" : "string"
                        },
                        "hostName" : {
                            "description" : "Host name of the controller",
                            "type" : "string"
                        },
                        "mac" : {
                            "description" : "MAC address of the controller",
                            "type" : "string"
                        },
                        "serialNumber" : {
                            "description" : "Serial number of the controller",
                            "type" : "string"
                        },
                        "clusterRole" : {
                            "description" : "Indicator the role of the controller",
                            "type" : "string"
                        },
                        "controlNatIp" : {
                            "description" : "Control NAT IP address settings",
                            "type" : "string"
                        },
                        "uptimeInSec" : {
                            "description" : "Uptime (in seconds) of the controller",
                            "type" : "integer"
                        },
                        "name" : {
                            "description" : "Name of the controller",
                            "type" : "string"
                        },
                        "version" : {
                            "description" : "SCG version",
                            "type" : "string"
                        },
                        "cpVersion" : {
                            "description" : "Control plane version",
                            "type" : "string"
                        },
                        "dpVersion" : {
                            "description" : "Data plane version",
                            "type" : "string"
                        },
                        "apVersion" : {
                            "description" : "AP version",
                            "type" : "string"
                        },
                        "controlIp" : {
                            "description" : "Control IP",
                            "type" : "string"
                        },
                        "dataIp" : {
                            "description" : "Data IP",
                            "type" : "string"
                        },
                        "controlIpv6" : {
                            "description" : "Control IPv6",
                            "type" : "string"
                        }
                    }
                }
            }
        }
    }
    
    

AP Models 

/v4_0/system/apmodels

Use this API command to retrieve AP models.

  • Response  200
  • Body
    List of AP Models(ex: ["ZF7782","ZF7762"])
    
    

System Statistics 

/v4_0/controller/{id}/statistics

Use this API command to retrieve the system statistics.

  • Parameters
  • interval
    string (optional) 

    Interval, only valid of (QUARTER, HOUR, DAY). Default: QUARTER

    size
    number (optional) 

    Size, list size to response. Default: 32

  • Response  200
  • Body
    [ {
        "cpId" : "f214c803-c88f-40f8-83d5-a6e37a9840de",
        "timestamp" : 1419877800000,
        "cpu" : {
            "percent" : 8.776667,
            "maxPercent" : 32.85,
            "minPercent" : 3.78
        },
        "disk" : {
            "total" : 71417208,
            "free" : 70844653,
            "maxFree" : 70845604,
            "minFree" : 70843696
        },
        "memory" : {
            "percent" : 77.59,
            "maxPercent" : 77.61,
            "minPercent" : 77.58
        },
        "control" : {
            "rxBps" : 898,
            "rxBpsMax" : 9160,
            "rxBpsMin" : 192,
            "rxBytes" : 101038,
            "rxDropped" : 0,
            "rxPackets" : 761,
            "txBps" : 293,
            "txBpsMax" : 4771.2,
            "txBpsMin" : 0,
            "txBytes" : 32964,
            "txDropped" : 0,
            "txPackets" : 209
        },
        "data" : {
            "rxBps" : 24,
            "rxBpsMax" : 2080,
            "rxBpsMin" : 0,
            "rxBytes" : 2794,
            "rxDropped" : 0,
            "rxPackets" : 10,
            "txBps" : 6,
            "txBpsMax" : 614.4,
            "txBpsMin" : 0,
            "txBytes" : 768,
            "txDropped" : 0,
            "txPackets" : 4
        },
        "port0" : {
            "rxBps" : 867,
            "rxBpsMax" : 9064,
            "rxBpsMin" : 192,
            "rxBytes" : 97557,
            "rxDropped" : 0,
            "rxPackets" : 732,
            "txBps" : 293,
            "txBpsMax" : 4771.2,
            "txBpsMin" : 0,
            "txBytes" : 32964,
            "txDropped" : 0,
            "txPackets" : 209
        },
        "port1" : {
            "rxBps" : 13,
            "rxBpsMax" : 1040,
            "rxBpsMin" : 0,
            "rxBytes" : 1494,
            "rxDropped" : 0,
            "rxPackets" : 6,
            "txBps" : 6,
            "txBpsMax" : 614.4,
            "txBpsMin" : 0,
            "txBytes" : 768,
            "txDropped" : 0,
            "txPackets" : 4
        },
        "port2" : {
            "rxBps" : 216,
            "rxBpsMax" : 25016,
            "rxBpsMin" : 0,
            "rxBytes" : 24328,
            "rxDropped" : 0,
            "rxPackets" : 146,
            "txBps" : 139,
            "txBpsMax" : 15129.6,
            "txBpsMin" : 0,
            "txBytes" : 15641,
            "txDropped" : 0,
            "txPackets" : 108
        },
        "port3" : {
            "rxBps" : 30,
            "rxBpsMax" : 1248,
            "rxBpsMin" : 0,
            "rxBytes" : 3481,
            "rxDropped" : 0,
            "rxPackets" : 29,
            "txBps" : 0,
            "txBpsMax" : 0,
            "txBpsMin" : 0,
            "txBytes" : 0,
            "txDropped" : 0,
            "txPackets" : 0
        }
    } ]
    
    

System Inventory 

/v4_0/system/inventory

Use this API command to retrieve the system inventory with current logon user domain.

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

  • Response  200
  • Body
    {
        "totalCount" : 2,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "zoneId" : "1690614e-1c1f-4fe8-9144-24ccf28d83c4",
            "zoneName" : "api-test-zone",
            "meshSSID" : null,
            "totalAPs" : 0,
            "discoveryAPs" : 0,
            "provisionedAPs" : 0,
            "connectedAPs" : 0,
            "disconnectedAPs" : 0,
            "rebootingAPs" : 0,
            "connectedRootAPs" : 0,
            "disconnectedRootAPs" : 0,
            "rebootingRootAPs" : 0,
            "connectedMeshAPs" : 0,
            "disconnectedMeshAPs" : 0,
            "rebootingMeshAPs" : 0,
            "connectedeMeshAPs" : 0,
            "disconnectedeMeshAPs" : 0,
            "rebootingeMeshAPs" : 0,
            "connectedDownMeshAPs" : 0,
            "disconnectedDownMeshAPs" : 0,
            "rebootingDownMeshAPs" : 0,
            "connectedMeshDisabledAPs" : 0,
            "disconnectedMeshDisabledAPs" : 0,
            "clients" : 0
        }, {
            "zoneId" : "b4187899-38ae-4ace-8e40-0bc444455156",
            "zoneName" : "Staging Zone",
            "meshSSID" : null,
            "totalAPs" : 1,
            "discoveryAPs" : 0,
            "provisionedAPs" : 0,
            "connectedAPs" : 1,
            "disconnectedAPs" : 0,
            "rebootingAPs" : 0,
            "connectedRootAPs" : 0,
            "disconnectedRootAPs" : 0,
            "rebootingRootAPs" : 0,
            "connectedMeshAPs" : 0,
            "disconnectedMeshAPs" : 0,
            "rebootingMeshAPs" : 0,
            "connectedeMeshAPs" : 0,
            "disconnectedeMeshAPs" : 0,
            "rebootingeMeshAPs" : 0,
            "connectedDownMeshAPs" : 0,
            "disconnectedDownMeshAPs" : 0,
            "rebootingDownMeshAPs" : 0,
            "connectedMeshDisabledAPs" : 1,
            "disconnectedMeshDisabledAPs" : 0,
            "clients" : 0
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array"
            }
        }
    }
    
    

Execute ap balance 

/v4_0/system/ap_balance

Execute ap balance

  • Response  200

Wireless Client 

Retrieve Total Client Count 

/v4_0/aps/{apMac}/operational/client/totalCount

Use this API command to retrieve the total client count per AP.

  • Response  200
  • Body
    The total count (integer)
    
    

Retrieve Client List 

/v4_0/aps/{apMac}/operational/client

Use this API command to retrieve the client list per AP.

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

  • Response  200
  • Body
    {
        "totalCount" : 1,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "mac" : "3C:A9:F4:0C:85:B0",
            "ipAddress" : "172.18.116.141",
            "ipv6Address" : "2001:b030:2516:1a0::5d6e",
            "hostName" : "SDC-Randall-PC",
            "osType" : "Windows 7/Vista",
            "user" : "",
            "status" : "AUTHORIZED",
            "radioId" : "0",
            "radioMode" : null,
            "channel" : "11",
            "wlanId" : "1",
            "ssid" : "client-test",
            "fromClientBytes" : 240863,
            "toClientBytes" : 642897,
            "fromClientPkts" : 2247,
            "toClientPkts" : 7678,
            "connectedSince" : 2600,
            "vlan" : "1",
            "toClientDroppedPkts" : 108
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "description" : "Total client count",
                "type" : "integer"
            },
            "hasMore" : {
                "description" : "Indicates whether there are more clients after the currently displayed list",
                "type" : "boolean"
            },
            "firstIndex" : {
                "description" : "Index of the first client returned out of the complete client list",
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "mac" : {
                            "type" : "string",
                            "pattern" : "^([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F])$",
                            "description" : "MAC of the Client"
                        },
                        "ipAddress" : {
                            "type" : "string",
                            "description" : "IP address of the Client"
                        },
                        "ipv6Address" : {
                            "type" : "string",
                            "description" : "IP V6 address of the Client"
                        },
                        "hostName" : {
                            "description" : "Host name",
                            "type" : "string"
                        },
                        "osType" : {
                            "description" : "OS type",
                            "type" : "string"
                        },
                        "user" : {
                            "description" : "User",
                            "type" : "string"
                        },
                        "status" : {
                            "description" : "Status",
                            "type" : "string"
                        },
                        "radioId" : {
                            "description" : "Radio inditifier",
                            "type" : "string"
                        },
                        "radioMode" : {
                            "description" : "Radio mode",
                            "type" : "string"
                        },
                        "channel" : {
                            "description" : "Channel",
                            "type" : "string"
                        },
                        "wlanId" : {
                            "description" : "WLAN inditifier",
                            "type" : "string"
                        },
                        "ssid" : {
                            "description" : "SSID",
                            "type" : "string"
                        },
                        "rssi" : {
                            "description" : "RSSI",
                            "type" : "string"
                        },
                        "fromClientBytes" : {
                            "description" : "From client bytes",
                            "type" : "integer"
                        },
                        "toClientBytes" : {
                            "description" : "To client bytes",
                            "type" : "integer"
                        },
                        "fromClientPkts" : {
                            "description" : "From client package frames",
                            "type" : "integer"
                        },
                        "toClientPkts" : {
                            "description" : "To client package frames",
                            "type" : "integer"
                        },
                        "connectedSince" : {
                            "description" : "Connected since (in milliseconds)",
                            "type" : "integer"
                        },
                        "vlan" : {
                            "description" : "VLAN id",
                            "type" : "string"
                        },
                        "toClientDroppedPkts" : {
                            "description" : "To client dropped packages",
                            "type" : "integer"
                        },
                        "apTxDataRate" : {
                            "description" : "AP Tx Data Rate",
                            "type" : "string"
                        },
                        "apRxSignal" : {
                            "description" : "AP Rx signal",
                            "type" : "string"
                        }
                    }
                }
            }
        }
    }
    
    

Application Visibility Control 

User Defined Retrieve List 

/v4_0/rkszones/{zoneId}/profile/avc/userDefined

Use this API command to retrieve a list of AVC User Defined profiles of a zone.

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

  • Response  200
  • Body
    {
        "totalCount" : 2,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "name" : "testdp",
            "id" : "f031d790-f2dd-11e4-b4f9-000c292547b9"
        }, {
            "name" : "postman-dp-M",
            "id" : "ba7b3fb0-f2fb-11e4-b680-80fa5b024259"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the service",
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the service"
                        }
                    }
                }
            }
        }
    }
    
    

User Defined Retrieve 

/v4_0/rkszones/{zoneId}/profile/avc/userDefined/{id}

Use this API command to retrieve a AVC User Defined profile of a zone.

  • Response  200
  • Body
    {
        "name" : "test-modify",
        "id" : "acc29c30-ee35-11e4-8c03-000c292547b9",
        "destIp" : "11.22.33.44",
        "netmask" : "255.255.255.0",
        "destPort" : 22,
        "protocol" : "TCP"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the User Defined Profile",
                "type" : "string"
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the User Defined Profile"
            },
            "destIp" : {
                "type" : "string",
                "description" : "Server IP"
            },
            "netmask" : {
                "type" : "string",
                "pattern" : "^$|(^(128|192|224|24[08]|25[245]).0.0.0$)|(^255.(0|128|192|224|24[08]|25[245]).0.0$)|(^255.255.(0|128|192|224|24[08]|25[245]).0$)|(^255.255.255.(0|128|192|224|24[08]|252|255)$)",
                "description" : "netmask of User Defined Profile"
            },
            "destPort" : {
                "description" : "destPort of User Defined Profile",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 65535
            },
            "protocol" : {
                "description" : "protocol of User Defined Profile",
                "enum" : [ "TCP", "UDP" ]
            }
        }
    }
    
    

User Defined Create 

/v4_0/rkszones/{zoneId}/profile/avc/userDefined

Use this API command to create a new AVC User Defined profile of a zone.

  • Request
  • Body
    {
        "name" : "postman-c",
        "destIp" : "11.22.33.44",
        "netmask" : "255.255.255.0",
        "destPort" : 22,
        "protocol" : "TCP"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the User Defined Profile"
            },
            "destIp" : {
                "type" : "string",
                "description" : "Server IP"
            },
            "netmask" : {
                "type" : "string",
                "pattern" : "^$|(^(128|192|224|24[08]|25[245]).0.0.0$)|(^255.(0|128|192|224|24[08]|25[245]).0.0$)|(^255.255.(0|128|192|224|24[08]|25[245]).0$)|(^255.255.255.(0|128|192|224|24[08]|252|255)$)",
                "description" : "netmask of User Defined Profile"
            },
            "destPort" : {
                "description" : "destPort of User Defined Profile",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 65535
            },
            "protocol" : {
                "description" : "protocol of User Defined Profile",
                "enum" : [ "TCP", "UDP" ]
            }
        },
        "required" : [ "name", "destIp", "netmask", "destPort", "protocol" ]
    }
    
    
  • Response  201

User Defined Modify Basic 

/v4_0/rkszones/{zoneId}/profile/avc/userDefined/{id}

Use this API command to modify the basic information on AVC User Defined profile of a zone.

  • Request
  • Body
    {
        "name" : "test-modify",
        "destIp" : "11.22.33.44",
        "netmask" : "255.255.255.0",
        "destPort" : 11,
        "protocol" : "UDP"
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Name of the User Defined Profile"
        },
        "destIp" : {
            "type" : "string",
            "description" : "Server IP"
        },
        "netmask" : {
            "type" : "string",
            "pattern" : "^$|(^(128|192|224|24[08]|25[245]).0.0.0$)|(^255.(0|128|192|224|24[08]|25[245]).0.0$)|(^255.255.(0|128|192|224|24[08]|25[245]).0$)|(^255.255.255.(0|128|192|224|24[08]|252|255)$)",
            "description" : "netmask of User Defined Profile"
        },
        "destPort" : {
            "description" : "destPort of User Defined Profile",
            "type" : "integer",
            "minimum" : 1,
            "maximum" : 65535
        },
        "protocol" : {
            "description" : "protocol of User Defined Profile",
            "enum" : [ "TCP", "UDP" ]
        }
    }
    
    
  • Response  204

User Defined Delete 

/v4_0/rkszones/{zoneId}/profile/avc/userDefined/{id}

Use this API command to delete a AVC User Defined Profile of a zone.

  • Response  204

Port Mapping Retrieve List 

/v4_0/rkszones/{zoneId}/profile/avc/portMapping

Use this API command to retrieve a list of AVC Port Mapping profiles of a zone.

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

  • Response  200
  • Body
    {
        "totalCount" : 2,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "name" : "testdp",
            "id" : "f031d790-f2dd-11e4-b4f9-000c292547b9"
        }, {
            "name" : "postman-dp-M",
            "id" : "ba7b3fb0-f2fb-11e4-b680-80fa5b024259"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the service",
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the service"
                        }
                    }
                }
            }
        }
    }
    
    

Port Mapping Retrieve 

/v4_0/rkszones/{zoneId}/profile/avc/portMapping/{id}

Use this API command to retrieve a AVC Port Mapping profile of a zone.

  • Response  200
  • Body
    {
        "name" : "postman-pm-c",
        "id" : "7057a830-f2db-11e4-8336-80fa5b024259",
        "port" : 2,
        "protocol" : "TCP"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the Port Mapping Profile",
                "type" : "string"
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the Port Mapping Profile"
            },
            "port" : {
                "description" : "port of Port Mapping Profile",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 65535
            },
            "protocol" : {
                "description" : "protocol of Port Mapping Profile",
                "enum" : [ "TCP", "UDP" ]
            }
        }
    }
    
    

Port Mapping Create 

/v4_0/rkszones/{zoneId}/profile/avc/portMapping

Use this API command to create a new AVC Port Mapping profile of a zone.

  • Request
  • Body
    {
        "name" : "postman-pm-c",
        "port" : 2,
        "protocol" : "TCP"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the Port Mapping Profile"
            },
            "port" : {
                "description" : "port of Port Mapping Profile",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 65535
            },
            "protocol" : {
                "description" : "protocol of Port Mapping Profile",
                "enum" : [ "TCP", "UDP" ]
            }
        },
        "required" : [ "name", "port", "protocol" ]
    }
    
    
  • Response  201

Port Mapping Modify Basic 

/v4_0/rkszones/{zoneId}/profile/avc/portMapping/{id}

Use this API command to modify the basic information on AVC Port Mapping profile of a zone.

  • Request
  • Body
    {
        "name" : "postman-pm-m",
        "port" : 11,
        "protocol" : "UDP"
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Name of the Port Mapping Profile"
        },
        "port" : {
            "description" : "port of Port Mapping Profile",
            "type" : "integer",
            "minimum" : 1,
            "maximum" : 65535
        },
        "protocol" : {
            "description" : "protocol of Port Mapping Profile",
            "enum" : [ "TCP", "UDP" ]
        }
    }
    
    
  • Response  204

Port Mapping Delete 

/v4_0/rkszones/{zoneId}/profile/avc/portMapping/{id}

Use this API command to delete a AVC Port Mapping Profile of a zone.

  • Response  204

Denial Policy Retrieve List 

/v4_0/rkszones/{zoneId}/profile/avc/denialPolicy

Use this API command to retrieve a list of AVC Denial Policy profiles of a zone.

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

  • Response  200
  • Body
    {
        "totalCount" : 2,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "name" : "testdp",
            "id" : "f031d790-f2dd-11e4-b4f9-000c292547b9"
        }, {
            "name" : "postman-dp-M",
            "id" : "ba7b3fb0-f2fb-11e4-b680-80fa5b024259"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the service",
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the service"
                        }
                    }
                }
            }
        }
    }
    
    

Denial Policy Retrieve 

/v4_0/rkszones/{zoneId}/profile/avc/denialPolicy/{id}

Use this API command to retrieve a AVC Denial Policy profile of a zone.

  • Response  200
  • Body
    {
        "name" : "postman-dp-c",
        "id" : "ba7b3fb0-f2fb-11e4-b680-80fa5b024259",
        "description" : "postman-dp-c",
        "rules" : [ {
            "ruleType" : "DENY",
            "applicationType" : "HTTP_DOMAIN_NAME",
            "content" : "google.ocm"
        }, {
            "ruleType" : "DENY",
            "applicationType" : "PORT",
            "content" : "22"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the Denial Policy Profile",
                "type" : "string"
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the Denial Policy Profile"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the Denial Policy Profile"
            },
            "rules" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "ruleType" : {
                            "enum" : [ "DENY" ]
                        },
                        "applicationType" : {
                            "enum" : [ "HTTP_DOMAIN_NAME", "PORT" ]
                        },
                        "content" : {
                            "description" : "content of the application rule",
                            "type" : "string"
                        }
                    }
                }
            }
        }
    }
    
    

Denial Policy Create 

/v4_0/rkszones/{zoneId}/profile/avc/denialPolicy

Use this API command to create a new AVC Denial Policy profile of a zone.

  • Request
  • Body
    {
        "name" : "postman-dp-c",
        "description" : "postman-dp-c",
        "rules" : [ {
            "ruleType" : "DENY",
            "applicationType" : "HTTP_DOMAIN_NAME",
            "content" : "google.ocm"
        }, {
            "ruleType" : "DENY",
            "applicationType" : "PORT",
            "content" : "22"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the Denial Policy Profile"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the Denial Policy Profile"
            },
            "rules" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "ruleType" : {
                            "enum" : [ "DENY" ]
                        },
                        "applicationType" : {
                            "enum" : [ "HTTP_DOMAIN_NAME", "PORT" ]
                        },
                        "content" : {
                            "description" : "content of the application rule",
                            "type" : "string"
                        }
                    }
                }
            }
        },
        "required" : [ "name", "rules" ]
    }
    
    
  • Response  201

Denial Policy Modify Basic 

/v4_0/rkszones/{zoneId}/profile/avc/denialPolicy/{id}

Use this API command to modify the basic information on AVC Denial Policy profile of a zone.

  • Request
  • Body
    {
        "name" : "postman-dp-m",
        "description" : "postman-dp-m"
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Name of the Denial Policy Profile"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Description of the Denial Policy Profile"
        }
    }
    
    
  • Response  204

Denial Policy Delete 

/v4_0/rkszones/{zoneId}/profile/avc/denialPolicy/{id}

Use this API command to delete a AVC Denial Policy Profile of a zone.

  • Response  204

Configuration backup and restore 

System configuration backup 

/v4_0/configuration/backup

Backup system configuration

  • Response  204

System configuration restore 

/v4_0/configuration/restore/{id}

Restore system configuration with specified backupUUID

  • Response  204

Retrieve List 

/v4_0/configuration

Retrive system configuration list

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

  • Response  200
  • Body
    {
        "totalCount" : 2,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "b9c6e66e-f436-402f-a8b1-004d0b9ec7d8",
            "createdOn" : "2015/04/29 16:27:13",
            "scgVersion" : "3.2.0.0.71",
            "controlPlaneSoftwareVersion" : "3.2.0.0.56",
            "dataPlaneSoftwareVersion" : "0.0.0.0",
            "createdBy" : "admin",
            "type" : "1",
            "backupElapsed" : null,
            "fileSize" : 40026
        }, {
            "id" : "b0d4df4d-c8eb-4738-ae45-ce73bf936f34",
            "createdOn" : "2015/04/29 16:48:32",
            "scgVersion" : "3.2.0.0.71",
            "controlPlaneSoftwareVersion" : "3.2.0.0.56",
            "dataPlaneSoftwareVersion" : "0.0.0.0",
            "createdBy" : "admin",
            "type" : "1",
            "backupElapsed" : null,
            "fileSize" : 40053
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of system configuration backup file.",
                            "type" : "string"
                        },
                        "createdOn" : {
                            "description" : "the create time of the configuration backup file.",
                            "type" : "number"
                        },
                        "scgVersion" : {
                            "description" : "SCG version of the configuration backup file.",
                            "type" : "string"
                        },
                        "controlPlaneSoftwareVersion" : {
                            "description" : "control plane software version of the configuration backup file",
                            "type" : "string"
                        },
                        "dataPlaneSoftwareVersion" : {
                            "description" : "data plane software version of the configuration backup file",
                            "type" : "string"
                        },
                        "createdBy" : {
                            "description" : "creator of the configuration backup file.",
                            "type" : "string"
                        },
                        "type" : {
                            "description" : "type of the configuration backup file",
                            "type" : "string"
                        },
                        "backupElapsed" : {
                            "description" : "backup elapsed of the configuration backup file",
                            "type" : "number"
                        },
                        "fileSize" : {
                            "description" : "file size of the backup file",
                            "type" : "number"
                        }
                    }
                }
            }
        }
    }
    
    

Get Auto Export Backup 

/v4_0/configurationSettings/autoExportBackup

Get Auto Export Backup Settings

  • Response  200
  • Body
    {
        "enableAutoExportBackup" : true,
        "ftpServer" : "FTP server name"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "enableAutoExportBackup" : {
                "description" : "enable auto export backup",
                "type" : "boolean"
            },
            "ftpServer" : {
                "description" : "FTP server name",
                "type" : "string"
            }
        }
    }
    
    

Get Schedule Backup Setting 

/v4_0/configurationSettings/scheduleBackup

Get Schedule Backup Setting

  • Response  200
  • Body
    {
        "enableScheduleBackup" : true,
        "interval" : "MONTHLY",
        "dateOfMonth" : 5,
        "hour" : 2,
        "minute" : 15
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "enableScheduleBackup" : {
                "description" : "enable schedule backup",
                "type" : "boolean"
            },
            "interval" : {
                "description" : "schedule interval",
                "enum" : [ "MONTHLY", "WEEKLY", "DAILY" ]
            },
            "dayOfWeek" : {
                "description" : "day of the week",
                "enum" : [ "SUNDAY", "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY" ]
            },
            "dateOfMonth" : {
                "description" : "date of the month",
                "type" : "integer"
            },
            "hour" : {
                "description" : "hour",
                "type" : "integer"
            },
            "minute" : {
                "description" : "minute",
                "type" : "integer"
            }
        }
    }
    
    

Delete 

/v4_0/configuration/{id}

Delete system configuration file

  • Response  204

Modify Auto Export Backup 

/v4_0/configurationSettings/autoExportBackup

Modify Auto Export Backup Settings

  • Request
  • Body
    {
        "enableAutoExportBackup" : true,
        "ftpServer" : "FTP server name"
    }
    
    
    Schema
    {
        "enableAutoExportBackup" : {
            "description" : "enable auto export backup",
            "type" : "boolean",
            "default" : false
        },
        "ftpServer" : {
            "description" : "ftp server name",
            "type" : "string"
        }
    }
    
    
  • Response  204

Modify Schedule Backup Setting 

/v4_0/configurationSettings/scheduleBackup

Modify Schedule Backup Setting

  • Request
  • Body
    {
        "enableScheduleBackup" : true,
        "interval" : "WEEKLY",
        "dayOfWeek" : "MONDAY",
        "hour" : 2,
        "minute" : 15
    }
    
    
    Schema
    {
        "enableScheduleBackup" : {
            "description" : "enable schedule backup",
            "type" : "boolean",
            "default" : false
        },
        "interval" : {
            "description" : "schedule interval",
            "enum" : [ "MONTHLY", "WEEKLY", "DAILY" ]
        },
        "dayOfWeek" : {
            "description" : "day of the week",
            "enum" : [ "SUNDAY", "MONDAY", "TUESDAY", "WEDNESDAY", "THURSDAY", "FRIDAY", "SATURDAY" ]
        },
        "dateOfMonth" : {
            "description" : "date of the month",
            "type" : "integer"
        },
        "hour" : {
            "description" : "hour",
            "type" : "integer",
            "default" : 0
        },
        "minute" : {
            "description" : "minute",
            "type" : "integer",
            "default" : 0
        }
    }
    
    
  • Response  204

Upload 

/v4_0/configuration/upload

Upload system configuration file

  • Response  204

Download 

/v4_0/configuration/download

Download system configuration file

  • Parameters
  • backupUUID
    string (required) 

    System configuration file uuid

    timeZone
    string (required) 

    Time zone

  • Response  200

Syslog Server 

Retrieve Syslog 

/v4_0/system/syslog

Retrieve syslog server sertting

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

  • Response  200
  • Body
    {
        "enabled" : true,
        "primaryServer" : {
            "host" : "192.1.0.1",
            "port" : 90
        },
        "secondaryServer" : {
            "host" : "192.10.8.9",
            "port" : 82,
            "redundancyMode" : "primary_backup"
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "enabled" : {
                "description" : "enable logging to remote syslog server",
                "type" : "boolean"
            },
            "primaryServer" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "host" : {
                        "description" : "address of the syslog server.",
                        "type" : "string"
                    },
                    "port" : {
                        "description" : "port number of the syslog server",
                        "type" : "integer"
                    }
                },
                "description" : "The primary server settings of syslog server"
            },
            "secondaryServer" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "host" : {
                        "description" : "address of the syslog server.",
                        "type" : "string"
                    },
                    "port" : {
                        "description" : "port number of the syslog server",
                        "type" : "integer"
                    },
                    "redundancyMode" : {
                        "description" : "The redundancy mode of syslog server",
                        "enum" : [ "active_active", "primary_backup" ]
                    }
                },
                "description" : "The secondary server settings of syslog server"
            }
        }
    }
    
    

Modify Syslog 

/v4_0/system/syslog

Modify syslog server setting

  • Request
  • Body
    {
        "enabled" : true
    }
    
    
    Schema
    {
        "enabled" : {
            "description" : "enable logging to remote syslog server",
            "type" : "boolean"
        }
    }
    
    
  • Response  204

Modify Primary Server 

/v4_0/system/syslog/primaryServer

Modify Primary Server of syslog

  • Request
  • Body
    {
        "host" : "192.1.0.1",
        "port" : 90
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "host" : {
                "description" : "address of the syslog server.",
                "type" : "string"
            },
            "port" : {
                "description" : "port number of the syslog server",
                "type" : "integer"
            }
        },
        "description" : "The primary server settings of syslog server"
    }
    
    
  • Response  204

Modify Secondary Server 

/v4_0/system/syslog/secondaryServer

Modify Secondary Server of syslog

  • Request
  • Body
    {
        "host" : "192.10.8.9",
        "port" : 82,
        "redundancyMode" : "primary_backup"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "host" : {
                "description" : "address of the syslog server.",
                "type" : "string"
            },
            "port" : {
                "description" : "port number of the syslog server",
                "type" : "integer"
            },
            "redundancyMode" : {
                "description" : "The redundancy mode of syslog server",
                "enum" : [ "active_active", "primary_backup" ]
            }
        },
        "description" : "The secondary server settings of syslog server"
    }
    
    
  • Response  204

AP Usb Software Package 

Retrieve List 

/v4_0/rkszones/{zoneId}/usbsoftware

Retrieve a list of AP Usb Software Package

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

  • Response  200
  • Body
    {
        "totalCount" : 2,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "0a6987e0-cedd-11e4-8148-f0def13d5845",
            "name" : "usbdev.tar.bz2"
        }, {
            "id" : "6b1dc3b0-d1eb-11e4-b379-f0def13d5845",
            "name" : "usbdev-test.tar.bz2"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "identifier of AP Usb Software Package",
                            "type" : "string"
                        },
                        "name" : {
                            "description" : "name of AP Usb Software Package",
                            "type" : "string"
                        }
                    }
                }
            }
        }
    }
    
    

Upload File 

/v4_0/rkszones/{zoneId}/usbsoftware

Create new AP Usb Software Package by upload file

  • Response  201
  • Body
    {
        "id" : "0a6987e0-cedd-11e4-8148-f0def13d5845"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "the identifier of the create object",
                "type" : "string"
            }
        }
    }
    
    

Delete 

/v4_0/rkszones/{zoneId}/usbsoftware/{id}

Delete specified AP Usb Software Package

  • Response  204

GET Zone Associate 

/v4_0/rkszones/{zoneId}/usbsoftware/{modelName}

Get APUsbSoftwarePackage associate with zone by model name

  • Response  200
  • Body
    {
        "id" : "APUsbSoftwarePackageId",
        "name" : "APUsbSoftwarePackageName"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "identifier of AP Usb Software Package",
                "type" : "string"
            },
            "name" : {
                "description" : "name of AP Usb Software Package",
                "type" : "string"
            }
        }
    }
    
    

GET APGroup Associate 

/v4_0/rkszones/{zoneId}/apgroups/{id}/usbsoftware/{modelName}

Get APUsbSoftwarePackage associate with APGroup by model name

  • Response  200
  • Body
    {
        "id" : "APUsbSoftwarePackageId",
        "name" : "APUsbSoftwarePackageName"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "identifier of AP Usb Software Package",
                "type" : "string"
            },
            "name" : {
                "description" : "name of AP Usb Software Package",
                "type" : "string"
            }
        }
    }
    
    

GET AP Associate 

/v4_0/aps/{apMac}/usbsoftware

Get APUsbSoftwarePackage associate AP by model name

  • Response  200
  • Body
    {
        "id" : "APUsbSoftwarePackageId",
        "name" : "APUsbSoftwarePackageName"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "identifier of AP Usb Software Package",
                "type" : "string"
            },
            "name" : {
                "description" : "name of AP Usb Software Package",
                "type" : "string"
            }
        }
    }
    
    

L2 Access Control 

Retrieve List 

/v4_0/rkszones/{zoneId}/l2ACL

Retrieve a list of L2 Access Control

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

  • Response  200
  • Body
    {
        "totalCount" : 9,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "c5dfc930-75dc-11e4-8d56-00606eb0c700",
            "name" : "protalName1"
        }, {
            "id" : "15efd160-7153-11e4-aa08-00606eb0c700",
            "name" : "protalName2"
        }, {
            "id" : "be0f0480-73a9-11e4-9d1d-f0def13d5845",
            "name" : "protalName3"
        }, {
            "id" : "7f0eef00-7423-11e4-bcef-000c299b4765",
            "name" : "protalName4"
        }, {
            "id" : "4f5c98a0-7123-11e4-bcef-000c299b4765",
            "name" : "protalName5"
        }, {
            "id" : "4a023ce0-73ab-11e4-b211-f0def13d5845",
            "name" : "protalName6"
        }, {
            "id" : "afebbc80-73be-11e4-bfde-f0def13d5845",
            "name" : "protalName7"
        }, {
            "id" : "76f4c020-7620-11e4-b8b9-00606eb0c700",
            "name" : "protalName8"
        }, {
            "id" : "96308310-752c-11e4-8276-00606eb0c700",
            "name" : "protalName9"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the service",
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the service"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve 

/v4_0/rkszones/{zoneId}/l2ACL/{id}

Retrieve an L2 Access Control

  • Response  200
  • Body
    {
        "name" : "l2acl_name",
        "id" : "128a26b0-ab73-11e4-87f2-000c29c1611c",
        "description" : "l2acl_desc",
        "zoneId" : "f4c2fbf6-7f94-44f2-a509-5308db165891",
        "restriction" : "ALLOW",
        "ruleMacs" : [ "33:11:11:11:11:12", "22:11:11:11:11:11" ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "identifier of the L2 Access Control ",
                "type" : "string"
            },
            "zoneId" : {
                "description" : "identifier of the zone which the L2 Access Control belongs to",
                "type" : "string"
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "name of the L2 Access Control "
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "description of the L2 Access Control "
            },
            "restriction" : {
                "description" : "restriction of the L2 Access Control, ALLOW: Only allow all stations listed below, BLOCK:Only block all stations listed below",
                "enum" : [ "ALLOW", "BLOCK" ]
            },
            "ruleMacs" : {
                "type" : "array",
                "items" : {
                    "type" : "string",
                    "pattern" : "^([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F])$"
                }
            }
        }
    }
    
    

Create L2 Access Control 

/v4_0/rkszones/{zoneId}/l2ACL

Create a new L2 Access Control

  • Request
  • Body
    {
        "name" : "l2acl_create_name",
        "description" : "l2acl_create_desc",
        "restriction" : "ALLOW",
        "ruleMacs" : [ "55:11:11:11:11:12", "66:11:11:11:11:11" ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "name of the L2 Access Control "
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "description of the L2 Access Control "
            },
            "restriction" : {
                "description" : "restriction of the L2 Access Control, ALLOW: Only allow all stations listed below, BLOCK:Only block all stations listed below",
                "enum" : [ "ALLOW", "BLOCK" ]
            },
            "ruleMacs" : {
                "type" : "array",
                "items" : {
                    "type" : "string",
                    "pattern" : "^([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F])$"
                }
            }
        },
        "required" : [ "name", "restriction" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "76f4c020-7620-11e4-b8b9-00606eb0c700"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the created portal profile",
                "type" : "string"
            }
        }
    }
    
    

Modify Basic 

/v4_0/rkszones/{zoneId}/l2ACL/{id}

Modify a specific L2 Access Control basic

  • Request
  • Body
    {
        "name" : "l2acl_modify_name",
        "description" : "l2acl_modify_desc",
        "restriction" : "BLOCK"
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "name of the L2 Access Control "
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "description of the L2 Access Control "
        },
        "restriction" : {
            "description" : "restriction of the L2 Access Control, ALLOW: Only allow all stations listed below, BLOCK:Only block all stations listed below",
            "enum" : [ "ALLOW", "BLOCK" ]
        }
    }
    
    
  • Response  204

Modify Rule Macs 

/v4_0/rkszones/{zoneId}/l2ACL/{id}/ruleMacs

Modify a specific L2 Access Control Rule Macs

  • Request
  • Body
    [ "55:11:11:11:11:12", "66:11:11:11:11:11" ]
    
    
    Schema
    {
        "type" : "array",
        "items" : {
            "type" : "string",
            "pattern" : "^([0-9a-fA-F][0-9a-fA-F]:){5}([0-9a-fA-F][0-9a-fA-F])$"
        }
    }
    
    
  • Response  204

Delete 

/v4_0/rkszones/{zoneId}/l2ACL/{id}

Delete an L2 Access Control

  • Response  204

Ethernet Port Profile 

Retrieve List - Ethernet Port Porfile 

/v4_0/rkszones/{zoneId}/profile/ethernetPort

Retrieve a list of Ethernet Port Porfiles within a zone

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

  • Response  200
  • Body
    {
        "totalCount" : 2,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "0",
            "name" : "Default Trunk Port"
        }, {
            "id" : "1",
            "name" : "Default Access Port"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the service",
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the service"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve - Ethernet Port Porfile 

/v4_0/rkszones/{zoneId}/profile/ethernetPort/{id}

Retrieve a Ethernet Port Porfile

  • Response  200
  • Body
    {
        "name" : "ethport",
        "id" : "13",
        "description" : "ethportDesc",
        "type" : "AccessPort",
        "tunnelEnabled" : true,
        "untagId" : 1,
        "vlanMembers" : "1",
        "dynamicVlanEnabled" : false,
        "guestVlan" : null,
        "_8021X" : {
            "type" : "Disable",
            "authenticator" : null,
            "supplicant" : null
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "identifier of the ethernet port profile",
                "type" : "string"
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "name of the ethernet port profile"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "description of the ethernet port profile"
            },
            "type" : {
                "description" : "type of the ethernet port profile",
                "enum" : [ "AccessPort", "TrunkPort", "GeneralPort" ]
            },
            "tunnelEnabled" : {
                "description" : "tunnelEnabled of the ethernet port profile for AccessPort type",
                "type" : "boolean"
            },
            "untagId" : {
                "description" : "VLAN Untag ID of the ethernet port profile",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 4094
            },
            "vlanMembers" : {
                "description" : "VLAN Members of the ethernet port profile",
                "type" : "string"
            },
            "dynamicVlanEnabled" : {
                "type" : "boolean"
            },
            "guestVlan" : {
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 4094
            },
            "_8021X" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "type" : {
                        "enum" : [ "Disable", "Supplicant", "PortBasedAuthenticator", "MACBasedAuthenticator" ]
                    },
                    "authenticator" : {
                        "type" : [ "object", "null" ],
                        "additionalProperties" : false,
                        "properties" : {
                            "authentication" : {
                                "type" : [ "object", "null" ],
                                "additionalProperties" : false,
                                "properties" : {
                                    "enableUseSCGasProxy" : {
                                        "type" : "boolean"
                                    },
                                    "server" : {
                                        "type" : [ "object", "null" ],
                                        "additionalProperties" : false,
                                        "properties" : {
                                            "id" : {
                                                "type" : "string"
                                            },
                                            "name" : {
                                                "type" : "string"
                                            }
                                        }
                                    }
                                },
                                "required" : [ "enableUseSCGasProxy" ]
                            },
                            "disabledAccounting" : {
                                "type" : "boolean"
                            },
                            "accounting" : {
                                "type" : [ "object", "null" ],
                                "additionalProperties" : false,
                                "properties" : {
                                    "enableUseSCGasProxy" : {
                                        "type" : "boolean"
                                    },
                                    "server" : {
                                        "type" : [ "object", "null" ],
                                        "additionalProperties" : false,
                                        "properties" : {
                                            "id" : {
                                                "type" : "string"
                                            },
                                            "name" : {
                                                "type" : "string"
                                            }
                                        }
                                    }
                                },
                                "required" : [ "enableUseSCGasProxy" ]
                            },
                            "macAuthByPassEnabled" : {
                                "type" : "boolean"
                            }
                        },
                        "required" : [ "macAuthByPassEnabled" ]
                    },
                    "supplicant" : {
                        "type" : [ "object", "null" ],
                        "additionalProperties" : false,
                        "properties" : {
                            "type" : {
                                "enum" : [ "MACAddress", "Custom" ]
                            },
                            "userName" : {
                                "type" : [ "string", "null" ],
                                "maxLength" : 64,
                                "pattern" : "^([!-?A-~]([!-?A-~]){0,62}[!-?A-~]|[!-?A-~]{1,1})$"
                            },
                            "password" : {
                                "type" : [ "string", "null" ],
                                "maxLength" : 64,
                                "pattern" : "^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$"
                            }
                        },
                        "required" : [ "type" ]
                    }
                },
                "required" : [ "type" ],
                "description" : "VLAN 802.1X of the ethernet port profile"
            }
        }
    }
    
    

Create - Ethernet Port Porfile 

/v4_0/rkszones/{zoneId}/profile/ethernetPort

Create a new Ethernet Port Porfile

  • Request
  • Body
    {
        "name" : "ethport",
        "description" : "ethportDesc",
        "type" : "AccessPort",
        "tunnelEnabled" : true,
        "_8021X" : {
            "type" : "Disable",
            "authenticator" : null,
            "supplicant" : null
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "name of the ethernet port profile"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "description of the ethernet port profile"
            },
            "type" : {
                "description" : "type of the ethernet port profile",
                "enum" : [ "AccessPort", "TrunkPort", "GeneralPort" ]
            },
            "tunnelEnabled" : {
                "description" : "tunnelEnabled of the ethernet port profile for AccessPort type",
                "type" : "boolean"
            },
            "untagId" : {
                "description" : "VLAN Untag ID of the ethernet port profile",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 4094
            },
            "vlanMembers" : {
                "description" : "VLAN Members of the ethernet port profile",
                "type" : "string"
            },
            "dynamicVlanEnabled" : {
                "type" : "boolean"
            },
            "guestVlan" : {
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 4094
            },
            "_8021X" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "type" : {
                        "enum" : [ "Disable", "Supplicant", "PortBasedAuthenticator", "MACBasedAuthenticator" ]
                    },
                    "authenticator" : {
                        "type" : [ "object", "null" ],
                        "additionalProperties" : false,
                        "properties" : {
                            "authentication" : {
                                "type" : [ "object", "null" ],
                                "additionalProperties" : false,
                                "properties" : {
                                    "enableUseSCGasProxy" : {
                                        "type" : "boolean"
                                    },
                                    "server" : {
                                        "type" : [ "object", "null" ],
                                        "additionalProperties" : false,
                                        "properties" : {
                                            "id" : {
                                                "type" : "string"
                                            },
                                            "name" : {
                                                "type" : "string"
                                            }
                                        }
                                    }
                                },
                                "required" : [ "enableUseSCGasProxy" ]
                            },
                            "disabledAccounting" : {
                                "type" : "boolean"
                            },
                            "accounting" : {
                                "type" : [ "object", "null" ],
                                "additionalProperties" : false,
                                "properties" : {
                                    "enableUseSCGasProxy" : {
                                        "type" : "boolean"
                                    },
                                    "server" : {
                                        "type" : [ "object", "null" ],
                                        "additionalProperties" : false,
                                        "properties" : {
                                            "id" : {
                                                "type" : "string"
                                            },
                                            "name" : {
                                                "type" : "string"
                                            }
                                        }
                                    }
                                },
                                "required" : [ "enableUseSCGasProxy" ]
                            },
                            "macAuthByPassEnabled" : {
                                "type" : "boolean"
                            }
                        },
                        "required" : [ "macAuthByPassEnabled" ]
                    },
                    "supplicant" : {
                        "type" : [ "object", "null" ],
                        "additionalProperties" : false,
                        "properties" : {
                            "type" : {
                                "enum" : [ "MACAddress", "Custom" ]
                            },
                            "userName" : {
                                "type" : [ "string", "null" ],
                                "maxLength" : 64,
                                "pattern" : "^([!-?A-~]([!-?A-~]){0,62}[!-?A-~]|[!-?A-~]{1,1})$"
                            },
                            "password" : {
                                "type" : [ "string", "null" ],
                                "maxLength" : 64,
                                "pattern" : "^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$"
                            }
                        },
                        "required" : [ "type" ]
                    }
                },
                "required" : [ "type" ],
                "description" : "VLAN 802.1X of the ethernet port profile"
            }
        },
        "required" : [ "name", "type", "_8021X" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "2"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "the identifier of the create object",
                "type" : "string"
            }
        }
    }
    
    

Modify - Ethernet Port Porfile 

/v4_0/rkszones/{zoneId}/profile/ethernetPort/{id}

Modify a specific Ethernet Port Porfile

  • Request
  • Body
    {
        "name" : "modify-ethport",
        "description" : "modify-ethport",
        "tunnelEnabled" : null,
        "untagId" : 1,
        "vlanMembers" : "1-4094",
        "dynamicVlanEnabled" : false,
        "guestVlan" : null
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "name of the ethernet port profile"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "description of the ethernet port profile"
        },
        "tunnelEnabled" : {
            "description" : "tunnelEnabled of the ethernet port profile for AccessPort type",
            "type" : "boolean"
        },
        "untagId" : {
            "description" : "VLAN Untag ID of the ethernet port profile",
            "type" : "integer",
            "minimum" : 1,
            "maximum" : 4094
        },
        "vlanMembers" : {
            "description" : "VLAN Members of the ethernet port profile",
            "type" : "string"
        },
        "dynamicVlanEnabled" : {
            "type" : "boolean"
        },
        "guestVlan" : {
            "type" : "integer",
            "minimum" : 1,
            "maximum" : 4094
        }
    }
    
    
  • Response  204

Modify - _8021X of Ethernet Port Porfile 

/v4_0/rkszones/{zoneId}/profile/ethernetPort/{id}/_8021X

Modify _8021X of Ethernet Port Porfile

  • Request
  • Body
    {
        "type" : "Supplicant",
        "authenticator" : null,
        "supplicant" : {
            "type" : "Custom",
            "userName" : "testuser",
            "password" : "testpassword"
        }
    }
    
    
    Schema
    {
        "type" : [ "object", "null" ],
        "additionalProperties" : false,
        "properties" : {
            "type" : {
                "enum" : [ "Disable", "Supplicant", "PortBasedAuthenticator", "MACBasedAuthenticator" ]
            },
            "authenticator" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "authentication" : {
                        "type" : [ "object", "null" ],
                        "additionalProperties" : false,
                        "properties" : {
                            "enableUseSCGasProxy" : {
                                "type" : "boolean"
                            },
                            "server" : {
                                "type" : [ "object", "null" ],
                                "additionalProperties" : false,
                                "properties" : {
                                    "id" : {
                                        "type" : "string"
                                    },
                                    "name" : {
                                        "type" : "string"
                                    }
                                }
                            }
                        },
                        "required" : [ "enableUseSCGasProxy" ]
                    },
                    "disabledAccounting" : {
                        "type" : "boolean"
                    },
                    "accounting" : {
                        "type" : [ "object", "null" ],
                        "additionalProperties" : false,
                        "properties" : {
                            "enableUseSCGasProxy" : {
                                "type" : "boolean"
                            },
                            "server" : {
                                "type" : [ "object", "null" ],
                                "additionalProperties" : false,
                                "properties" : {
                                    "id" : {
                                        "type" : "string"
                                    },
                                    "name" : {
                                        "type" : "string"
                                    }
                                }
                            }
                        },
                        "required" : [ "enableUseSCGasProxy" ]
                    },
                    "macAuthByPassEnabled" : {
                        "type" : "boolean"
                    }
                },
                "required" : [ "macAuthByPassEnabled" ]
            },
            "supplicant" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "type" : {
                        "enum" : [ "MACAddress", "Custom" ]
                    },
                    "userName" : {
                        "type" : [ "string", "null" ],
                        "maxLength" : 64,
                        "pattern" : "^([!-?A-~]([!-?A-~]){0,62}[!-?A-~]|[!-?A-~]{1,1})$"
                    },
                    "password" : {
                        "type" : [ "string", "null" ],
                        "maxLength" : 64,
                        "pattern" : "^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$"
                    }
                },
                "required" : [ "type" ]
            }
        },
        "required" : [ "type" ],
        "description" : "VLAN 802.1X of the ethernet port profile"
    }
    
    
  • Response  204

Delete - Ethernet Port Porfile 

/v4_0/rkszones/{zoneId}/profile/ethernetPort/{id}

Delete Ethernet Port Porfile

  • Response  204

Wechat 

Retrieve List 

/v4_0/rkszones/{zoneId}/portals/wechat

Use this API command to retrieve a list of wechat portal.

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

  • Response  200
  • Body
    {
        "totalCount" : 9,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "c5dfc930-75dc-11e4-8d56-00606eb0c700",
            "name" : "protalName1"
        }, {
            "id" : "15efd160-7153-11e4-aa08-00606eb0c700",
            "name" : "protalName2"
        }, {
            "id" : "be0f0480-73a9-11e4-9d1d-f0def13d5845",
            "name" : "protalName3"
        }, {
            "id" : "7f0eef00-7423-11e4-bcef-000c299b4765",
            "name" : "protalName4"
        }, {
            "id" : "4f5c98a0-7123-11e4-bcef-000c299b4765",
            "name" : "protalName5"
        }, {
            "id" : "4a023ce0-73ab-11e4-b211-f0def13d5845",
            "name" : "protalName6"
        }, {
            "id" : "afebbc80-73be-11e4-bfde-f0def13d5845",
            "name" : "protalName7"
        }, {
            "id" : "76f4c020-7620-11e4-b8b9-00606eb0c700",
            "name" : "protalName8"
        }, {
            "id" : "96308310-752c-11e4-8276-00606eb0c700",
            "name" : "protalName9"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the service",
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the service"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve 

/v4_0/rkszones/{zoneId}/portals/wechat/{id}

Use this API command to retrieve wechat portal by ID.

  • Response  200
  • Body
    {
        "name" : "wechat_name",
        "description" : "wechat_desc",
        "authUrl" : "http://www.ruckuswireless.com",
        "dnatDestination" : "ruckus",
        "gracePeriod" : 60,
        "blackList" : "172.15.20.80",
        "whiteList" : [ "10.1.2.3", "10.9.0.5" ],
        "dnatPortMapping" : [ {
            "sourcePort" : 80,
            "destPort" : 80
        }, {
            "sourcePort" : 60,
            "destPort" : 60
        }, {
            "sourcePort" : 83,
            "destPort" : 85
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the wechat profile"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the wechat profile"
            },
            "authUrl" : {
                "description" : "Authentication URL of the wechat profile",
                "type" : "string"
            },
            "dnatDestination" : {
                "description" : "DNAT destination of the wechat profile",
                "type" : "string"
            },
            "gracePeriod" : {
                "description" : "Grace period of the wechat profile",
                "type" : "integer",
                "default" : 60,
                "minimum" : 1,
                "maximum" : 14399
            },
            "blackList" : {
                "description" : "Black list of the wechat profile",
                "type" : "string"
            },
            "whiteList" : {
                "description" : "White list of the wechat profile",
                "type" : "array",
                "items" : {
                    "type" : "string"
                }
            },
            "dnatPortMapping" : {
                "description" : "DNAT Port Mapping of the wechat profile",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "sourcePort" : {
                            "description" : "Source port",
                            "type" : "integer",
                            "minimum" : 0,
                            "maximum" : 65535
                        },
                        "destPort" : {
                            "description" : "Destination port",
                            "type" : "integer",
                            "minimum" : 0,
                            "maximum" : 65535
                        }
                    }
                }
            }
        }
    }
    
    

Create 

/v4_0/rkszones/{zoneId}/portals/wechat

Use this API command to create wechat portal.

  • Request
  • Body
    {
        "name" : "wechat_create_name",
        "description" : "wechat_create_desc",
        "authUrl" : "http://www.ruckuswireless.com",
        "dnatDestination" : "ruckus",
        "gracePeriod" : 60,
        "blackList" : "172.15.20.80",
        "whiteList" : [ "10.1.2.3", "10.9.0.5" ],
        "dnatPortMapping" : [ {
            "sourcePort" : 80,
            "destPort" : 80
        }, {
            "sourcePort" : 60,
            "destPort" : 60
        }, {
            "sourcePort" : 83,
            "destPort" : 85
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the wechat profile"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the wechat profile"
            },
            "authUrl" : {
                "description" : "Authentication URL of the wechat profile",
                "type" : "string"
            },
            "dnatDestination" : {
                "description" : "DNAT destination of the wechat profile",
                "type" : "string"
            },
            "gracePeriod" : {
                "description" : "Grace period of the wechat profile",
                "type" : "integer",
                "default" : 60,
                "minimum" : 1,
                "maximum" : 14399
            },
            "blackList" : {
                "description" : "Black list of the wechat profile",
                "type" : "string"
            },
            "whiteList" : {
                "description" : "White list of the wechat profile",
                "type" : "array",
                "items" : {
                    "type" : "string"
                }
            },
            "dnatPortMapping" : {
                "description" : "DNAT Port Mapping of the wechat profile",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "sourcePort" : {
                            "description" : "Source port",
                            "type" : "integer",
                            "minimum" : 0,
                            "maximum" : 65535
                        },
                        "destPort" : {
                            "description" : "Destination port",
                            "type" : "integer",
                            "minimum" : 0,
                            "maximum" : 65535
                        }
                    }
                }
            }
        },
        "required" : [ "name", "authUrl", "dnatDestination", "blackList", "whiteList" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "76f4c020-7620-11e4-b8b9-00606eb0c700"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "Identifier of the created portal profile",
                "type" : "string"
            }
        }
    }
    
    

Modify Basic 

/v4_0/rkszones/{zoneId}/portals/wechat/{id}

Use this API command to modify the basic information of wechat portal.

  • Request
  • Body
    {
        "name" : "wechat_modify_name",
        "description" : "wechat_modify_desc",
        "authUrl" : "http://www.ruckuswireless.com",
        "dnatDestination" : "ruckus",
        "gracePeriod" : 60,
        "blackList" : "172.15.20.80"
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Name of the wechat profile"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Description of the wechat profile"
        },
        "authUrl" : {
            "description" : "Authentication URL of the wechat profile",
            "type" : "string"
        },
        "dnatDestination" : {
            "description" : "DNAT destination of the wechat profile",
            "type" : "string"
        },
        "gracePeriod" : {
            "description" : "Grace period of the wechat profile",
            "type" : "integer",
            "default" : 60,
            "minimum" : 1,
            "maximum" : 14399
        },
        "blackList" : {
            "description" : "Black list of the wechat profile",
            "type" : "string"
        }
    }
    
    
  • Response  204

Modify DNAT Port Mapping 

/v4_0/rkszones/{zoneId}/portals/wechat/{id}/dnatPortMapping

Use this API command to modify DNAT port mapping of a wechat profile.

  • Request
  • Body
    [ {
        "sourcePort" : 80,
        "destPort" : 80
    }, {
        "sourcePort" : 60,
        "destPort" : 60
    }, {
        "sourcePort" : 83,
        "destPort" : 85
    } ]
    
    
    Schema
    {
        "description" : "DNAT Port Mapping of the wechat profile",
        "type" : "array",
        "items" : {
            "type" : "object",
            "additionalProperties" : false,
            "properties" : {
                "sourcePort" : {
                    "description" : "Source port",
                    "type" : "integer",
                    "minimum" : 0,
                    "maximum" : 65535
                },
                "destPort" : {
                    "description" : "Destination port",
                    "type" : "integer",
                    "minimum" : 0,
                    "maximum" : 65535
                }
            }
        }
    }
    
    
  • Response  204

Delete 

/v4_0/rkszones/{zoneId}/portals/wechat/{id}

Use this API command to delete wechat portal.

  • Response  204

Identity User Role 

Retrieve List 

/v4_0/identity/userrole

Use this API command to retrieve a list of identity user role.

  • Response  200
  • Body
    {
        "totalCount" : 2,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "c5dfc930-75dc-11e4-8d56-00606eb0c700",
            "name" : "identity name"
        }, {
            "id" : "15efd160-7153-11e4-aa08-00606eb0c700",
            "name" : "identity name"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the service",
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the service"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve 

/v4_0/identity/userrole/{id}

Use this API command to retrieve identity user role by ID.

  • Response  200
  • Body
    {
        "id" : "e5db11b3-71ff-4234-80d0-c7562e9868af",
        "name" : "identity user role name",
        "description" : "identity user role desc",
        "userTrafficProfile" : {
            "id" : "91c3fcf0-2f83-11e5-a2b8-000c29cf8ec4",
            "name" : "userTrafficProfile"
        },
        "maxDevices" : {
            "maxDevicesAllowed" : "UNLIMITED",
            "maxDevicesNumber" : 0
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "the identifier of the object",
                "type" : "string"
            },
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "name"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "description"
            },
            "userTrafficProfile" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "User traffic profile"
            },
            "maxDevices" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "maxDevicesAllowed" : {
                        "description" : "Max devices allowed",
                        "enum" : [ "UNLIMITED", "LIMITED" ],
                        "default" : "LIMITED"
                    },
                    "maxDevicesNumber" : {
                        "description" : "max devices number",
                        "type" : "integer",
                        "default" : 3,
                        "minimum" : 1,
                        "maximum" : 10
                    }
                },
                "description" : "max Devices"
            }
        }
    }
    
    

Create 

/v4_0/identity/userrole

Use this API command to create identity user role.

  • Request
  • Body
    {
        "name" : "create-identity-user-role-name",
        "description" : "create identity user role desc",
        "userTrafficProfile" : {
            "name" : "utp"
        },
        "maxDevices" : {
            "maxDevicesAllowed" : "LIMITED",
            "maxDeviceNumber" : 3
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "name"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "description"
            },
            "userTrafficProfile" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "User traffic profile"
            },
            "maxDevices" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "maxDevicesAllowed" : {
                        "description" : "Max devices allowed",
                        "enum" : [ "UNLIMITED", "LIMITED" ],
                        "default" : "LIMITED"
                    },
                    "maxDevicesNumber" : {
                        "description" : "max devices number",
                        "type" : "integer",
                        "default" : 3,
                        "minimum" : 1,
                        "maximum" : 10
                    }
                },
                "description" : "max Devices"
            }
        },
        "required" : [ "name", "userTrafficProfile", "maxDevices" ]
    }
    
    
  • Response  201
  • Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "the identifier of the create object",
                "type" : "string"
            }
        }
    }
    
    

Modify Basic 

/v4_0/identity/userrole/{id}

Use this API command to modify the basic information of identity user role.

  • Request
  • Body
    {
        "name" : "modify-userrole-test",
        "description" : "modify user role test"
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "name"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "description"
        }
    }
    
    
  • Response  204

Modify max device 

/v4_0/identity/userrole/{id}/maxDevices

Use this API command to modify max device allowed of identity user role.

  • Request
  • Body
    {
        "maxDevicesAllowed" : "LIMITED",
        "maxDeviceNumber" : 3
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "maxDevicesAllowed" : {
                "description" : "Max devices allowed",
                "enum" : [ "UNLIMITED", "LIMITED" ],
                "default" : "LIMITED"
            },
            "maxDevicesNumber" : {
                "description" : "max devices number",
                "type" : "integer",
                "default" : 3,
                "minimum" : 1,
                "maximum" : 10
            }
        },
        "description" : "max Devices"
    }
    
    
  • Response  204

Modify user traffic profile 

/v4_0/identity/userrole/{id}/userTrafficProfile

Use this API command to modify user traffic profile of identity user role.

  • Request
  • Body
    {
        "name" : "userTrafficProfileName"
    }
    
    
    Schema
    {
        "type" : [ "object", "null" ],
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            },
            "name" : {
                "type" : "string"
            }
        },
        "description" : "User traffic profile"
    }
    
    
  • Response  204

Delete 

/v4_0/identity/userrole/{id}

Use this API command to delete identity user role.

  • Response  204

Data Plane 

Retrieve List 

/v4_0/enterprise/planes

Use this API command to retrieve a list of data planes.

  • Response  200
  • Body
    {
        "totalCount" : 1,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "clusterNode" : "JSZML-289",
            "description" : "api test",
            "model" : "SZ104",
            "serialNumber" : "00004567",
            "numOfAPs" : 0,
            "macAddress" : "00:00:0C:43:24:00",
            "mntCtrlIp" : "10.2.9.174",
            "apTunnelIp" : "172.17.60.86",
            "dpStatus" : "Managed",
            "clusterRole" : "Leader",
            "uptime" : "1.0d 20.0h 28.0m "
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of data plane",
                            "type" : "string"
                        },
                        "clusterNode" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the data plane"
                        },
                        "description" : {
                            "type" : [ "string", "null" ],
                            "maxLength" : 64,
                            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                            "description" : "Description of the data plane"
                        },
                        "model" : {
                            "description" : "Model",
                            "type" : "string"
                        },
                        "serialNumber" : {
                            "description" : "Serial Number",
                            "type" : "string"
                        },
                        "numOfAPs" : {
                            "description" : "# of Ruckus GRE Tunnels",
                            "type" : "integer"
                        },
                        "macAddress" : {
                            "description" : "DP MAC Address",
                            "type" : "string"
                        },
                        "mntCtrlIp" : {
                            "description" : "Management and AP Control IP address",
                            "type" : "string"
                        },
                        "apTunnelIp" : {
                            "description" : "AP Tunnel Data IP address",
                            "type" : "string"
                        },
                        "dpStatus" : {
                            "description" : "Status",
                            "type" : "string"
                        },
                        "clusterRole" : {
                            "description" : "Managed By",
                            "type" : "string"
                        },
                        "uptime" : {
                            "description" : "Uptime",
                            "type" : "string"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve 

/v4_0/enterprise/planes/{bladeUUID}

Use this API command to retrieve data plane by bladeUUID.

  • Response  200
  • Body
    {
        "managementAPControl" : {
            "ipMode" : "STATIC",
            "ipAddress" : "10.2.9.174",
            "subnetMask" : "255.255.0.0",
            "gateway" : "10.2.0.1",
            "natIp" : ""
        },
        "apTunnelData" : {
            "ipMode" : "STATIC",
            "ipAddress" : "172.17.60.86",
            "subnetMask" : "255.255.254.0",
            "gateway" : "172.17.60.1",
            "natIp" : ""
        },
        "dnsServer" : {
            "primaryDNSServer" : "172.17.17.16",
            "secondaryDNSServer" : ""
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "managementAPControl" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "ipMode" : {
                        "description" : "IP mode",
                        "enum" : [ "STATIC", "DHCP" ]
                    },
                    "ipAddress" : {
                        "description" : "IP address",
                        "type" : "string"
                    },
                    "subnetMask" : {
                        "description" : "Subnet mask",
                        "type" : "string"
                    },
                    "gateway" : {
                        "description" : "Gateway",
                        "type" : "string"
                    },
                    "natIp" : {
                        "description" : "Control NAT IP",
                        "type" : "string"
                    }
                },
                "description" : "Management and AP Control"
            },
            "apTunnelData" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "ipMode" : {
                        "description" : "IP mode",
                        "enum" : [ "STATIC", "DHCP" ]
                    },
                    "ipAddress" : {
                        "description" : "IP address",
                        "type" : "string"
                    },
                    "subnetMask" : {
                        "description" : "Subnet Mask",
                        "type" : "string"
                    },
                    "gateway" : {
                        "description" : "Gateway",
                        "type" : "string"
                    },
                    "natIp" : {
                        "description" : "Data NAT IP",
                        "type" : "string"
                    }
                },
                "description" : "AP tunnel data"
            },
            "dnsServer" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "primaryDNSServer" : {
                        "description" : "Primary DNS Server",
                        "type" : "string"
                    },
                    "secondaryDNSServer" : {
                        "description" : "Secondary DNS Server",
                        "type" : "string"
                    }
                },
                "description" : "DNS server"
            }
        }
    }
    
    

Modify management and AP control 

/v4_0/enterprise/planes/{bladeUUID}/managementAPControl

Use this API command to modify management and AP control of data plane. It may take 5 to 10 minutes to restart the network and controller services.

  • Request
  • Body
    {
        "ipMode" : "STATIC",
        "ipAddress" : "10.2.9.174",
        "subnetMask" : "255.255.0.0",
        "gateway" : "10.2.0.1"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "ipMode" : {
                "description" : "IP mode",
                "enum" : [ "STATIC", "DHCP" ]
            },
            "ipAddress" : {
                "description" : "IP address",
                "type" : "string"
            },
            "subnetMask" : {
                "description" : "Subnet mask",
                "type" : "string"
            },
            "gateway" : {
                "description" : "Gateway",
                "type" : "string"
            },
            "natIp" : {
                "description" : "Control NAT IP",
                "type" : "string"
            }
        },
        "description" : "Management and AP Control"
    }
    
    
  • Response  204

Modify AP tunnel data 

/v4_0/enterprise/planes/{bladeUUID}/apTunnelData

Use this API command to modify AP tunnel data of data plane. It may take 5 to 10 minutes to restart the network and controller services.

  • Request
  • Body
    {
        "ipMode" : "STATIC",
        "ipAddress" : "172.17.60.86",
        "subnetMask" : "255.255.254.0",
        "gateway" : "172.17.60.1"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "ipMode" : {
                "description" : "IP mode",
                "enum" : [ "STATIC", "DHCP" ]
            },
            "ipAddress" : {
                "description" : "IP address",
                "type" : "string"
            },
            "subnetMask" : {
                "description" : "Subnet Mask",
                "type" : "string"
            },
            "gateway" : {
                "description" : "Gateway",
                "type" : "string"
            },
            "natIp" : {
                "description" : "Data NAT IP",
                "type" : "string"
            }
        },
        "description" : "AP tunnel data"
    }
    
    
  • Response  204

Modify IPv4 DNS server 

/v4_0/enterprise/planes/{bladeUUID}/dnsServer

Use this API command to modify IPv4 DNS server of data plane. It may take 5 to 10 minutes to restart the network and controller services.

  • Request
  • Body
    {
        "primaryDNSServer" : "172.17.17.16"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "primaryDNSServer" : {
                "description" : "Primary DNS Server",
                "type" : "string"
            },
            "secondaryDNSServer" : {
                "description" : "Secondary DNS Server",
                "type" : "string"
            }
        },
        "description" : "DNS server"
    }
    
    
  • Response  204

Modify Static Route 

/v4_0/enterprise/planes/{bladeUUID}/staticRoute

Use this API command to modify static route of data plane. It may take 5 to 10 minutes to restart the network and controller services.

  • Request
  • Body
    [ {
        "networkAddress" : "10.2.2.0",
        "subnetMask" : "255.255.254.0",
        "gateway" : "10.2.2.254",
        "interfaceType" : "DATA",
        "metric" : 0
    } ]
    
    
    Schema
    {
        "description" : "Static route",
        "type" : "array",
        "items" : {
            "type" : "object",
            "additionalProperties" : false,
            "properties" : {
                "networkAddress" : {
                    "description" : "Network address",
                    "type" : "string"
                },
                "subnetMask" : {
                    "description" : "Subnet mask",
                    "type" : "string"
                },
                "gateway" : {
                    "description" : "Gateway",
                    "type" : "string"
                },
                "interfaceType" : {
                    "description" : "Interface type",
                    "enum" : [ "MANAGEMENT", "DATA" ]
                },
                "metric" : {
                    "description" : "Metric",
                    "type" : "integer"
                }
            },
            "required" : [ "networkAddress", "subnetMask", "gateway", "interfaceType" ]
        }
    }
    
    
  • Response  200

Modify User Defined Interface 

/v4_0/enterprise/planes/{bladeUUID}/userDefinedInterface

Use this API command to modify user defined interface. It may take 5 to 10 minutes to restart the network and controller services.

  • Request
  • Body
    [ {
        "name" : "interface-name",
        "physicalInterface" : "CONTROL_INTERFACE",
        "service" : "NOT_SPECIFIED",
        "ipAddress" : "2.2.2.2",
        "subnetMask" : "255.255.255.0",
        "vlan" : "11"
    }, {
        "name" : "interface-name",
        "physicalInterface" : "CONTROL_INTERFACE",
        "service" : "NOT_SPECIFIED",
        "ipAddress" : "8.8.8.8",
        "subnetMask" : "255.255.255.0",
        "vlan" : "221"
    } ]
    
    
    Schema
    {
        "description" : "User Defined Interface",
        "type" : "array",
        "items" : {
            "type" : "object",
            "additionalProperties" : false,
            "properties" : {
                "name" : {
                    "description" : "Name",
                    "type" : "string"
                },
                "physicalInterface" : {
                    "description" : "Physical interface",
                    "enum" : [ "CONTROL_INTERFACE" ]
                },
                "service" : {
                    "description" : "Service",
                    "enum" : [ "HOTSPOT", "NOT_SPECIFIED" ]
                },
                "ipAddress" : {
                    "description" : "IP Address",
                    "type" : "string"
                },
                "subnetMask" : {
                    "description" : "Subnet Mask",
                    "type" : "string"
                },
                "vlan" : {
                    "description" : "VLAN",
                    "type" : "string"
                }
            },
            "required" : [ "name", "physicalInterface", "service", "ipAddress", "subnetMask", "vlan" ]
        }
    }
    
    
  • Response  200

Cluster backup and restore 

Cluster backup 

/v4_0/cluster/backup

Backup cluster

  • Response  204

Cluster restore 

/v4_0/cluster/restore/{id:.+}

Restore cluster backup by ID

  • Response  204

Retrieve List 

/v4_0/cluster

Retrive cluster backup list

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

    timezone
    string (optional) 

    Change display timezone of created date and time, like timezone=Asia/Taipei, default is UTC time.

  • Response  200
  • Body
    {
        "totalCount" : 1,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "20150907031120_3.2.0.0.721",
            "version" : "3.2.0.0.721",
            "filesize" : "998.4 MB",
            "createdOn" : "2015/09/07 11:11:20"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of cluster backup file.",
                            "type" : "string"
                        },
                        "version" : {
                            "description" : "the patch version of the cluster backup file.",
                            "type" : "string"
                        },
                        "filesize" : {
                            "description" : "filesize of the cluster backup file.",
                            "type" : "number"
                        },
                        "createdOn" : {
                            "description" : "Created date and time of the cluster backup file",
                            "type" : "string"
                        }
                    }
                }
            }
        }
    }
    
    

Delete 

/v4_0/cluster/{id:.+}

Delete cluster backup by ID

  • Response  204

System Upgrade 

Upload File 

/v4_0/upgrade/upload

Use this API command to upload patch file

  • Response  200
  • Body
    {
        "clusterOperationProgress" : {
            "operation" : "None",
            "overallProgress" : 0,
            "isSelfBladeRebooting" : null,
            "bladeProgresss" : [ {
                "bladeUUID" : "386988fe-72fe-41e0-a373-7a73fea5d16e",
                "hostName" : "neilscg200",
                "iterationName" : "None",
                "state" : "",
                "progress" : 0
            } ],
            "previousOperationRecord" : {
                "operation" : "Upload",
                "success" : true,
                "errorMsg" : null
            },
            "clusterSubTaskState" : "Completed",
            "clusterOperationBlockUI" : false,
            "clusterOperationDisplayMsg" : ""
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "clusterOperationProgress" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "operation" : {
                        "description" : "operation of clusterOperationProgress",
                        "enum" : [ "None", "Join", "Backup", "Restore", "Upload", "Upgrade", "BackupAndUpgrade", "RemoveBlade", "ChangeBladeIP", "DiskSnapshot", "UploadVDPFirmware" ]
                    },
                    "overallProgress" : {
                        "description" : "overallProgress of clusterOperationProgress",
                        "type" : "integer"
                    },
                    "isSelfBladeRebooting" : {
                        "description" : "isSelfBladeRebooting of clusterOperationProgress",
                        "type" : "boolean"
                    },
                    "bladeProgresss" : {
                        "description" : "bladeProgressMap of clusterOperationProgress",
                        "type" : "array",
                        "items" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                                "bladeUUID" : {
                                    "description" : "bladeUUID of bladeProgress",
                                    "type" : "string"
                                },
                                "hostName" : {
                                    "description" : "hostName of bladeProgress",
                                    "type" : "string"
                                },
                                "iterationName" : {
                                    "description" : "iterationName of bladeProgress",
                                    "type" : "string"
                                },
                                "state" : {
                                    "description" : "state of bladeProgress",
                                    "type" : "string"
                                },
                                "progress" : {
                                    "description" : "progress of bladeProgress",
                                    "type" : "integer"
                                }
                            }
                        }
                    },
                    "previousOperationRecord" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "properties" : {
                            "operation" : {
                                "description" : "operation of previousOperationRecord",
                                "enum" : [ "None", "Join", "Backup", "Restore", "Upload", "Upgrade", "BackupAndUpgrade", "RemoveBlade", "ChangeBladeIP", "DiskSnapshot", "UploadVDPFirmware" ]
                            },
                            "success" : {
                                "description" : "success of previousOperationRecord",
                                "type" : "boolean"
                            },
                            "errorMsg" : {
                                "description" : "errorMsg of previousOperationRecord",
                                "type" : "string"
                            }
                        },
                        "description" : "previousOperationRecord of clusterOperationProgress"
                    },
                    "clusterSubTaskState" : {
                        "description" : "clusterSubTaskState of clusterOperationProgress",
                        "enum" : [ "None", "Running", "Failed", "Completed" ]
                    },
                    "clusterOperationBlockUI" : {
                        "description" : "clusterOperationBlockUI of clusterOperationProgress",
                        "type" : "boolean"
                    },
                    "clusterOperationDisplayMsg" : {
                        "description" : "clusterOperationDisplayMsg of clusterOperationProgress",
                        "type" : "string"
                    }
                },
                "description" : "upgrade status"
            }
        }
    }
    
    

Retrive Cluster Progress Status 

/v4_0/upgrade/status

Use this API command to retrive cluster progress status

  • Response  200
  • Body
    {
        "clusterOperationProgress" : {
            "operation" : "None",
            "overallProgress" : 0,
            "isSelfBladeRebooting" : null,
            "bladeProgresss" : [ {
                "bladeUUID" : "386988fe-72fe-41e0-a373-7a73fea5d16e",
                "hostName" : "neilscg200",
                "iterationName" : "None",
                "state" : "",
                "progress" : 0
            } ],
            "previousOperationRecord" : {
                "operation" : "Upload",
                "success" : true,
                "errorMsg" : null
            },
            "clusterSubTaskState" : "Completed",
            "clusterOperationBlockUI" : false,
            "clusterOperationDisplayMsg" : ""
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "clusterOperationProgress" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "operation" : {
                        "description" : "operation of clusterOperationProgress",
                        "enum" : [ "None", "Join", "Backup", "Restore", "Upload", "Upgrade", "BackupAndUpgrade", "RemoveBlade", "ChangeBladeIP", "DiskSnapshot", "UploadVDPFirmware" ]
                    },
                    "overallProgress" : {
                        "description" : "overallProgress of clusterOperationProgress",
                        "type" : "integer"
                    },
                    "isSelfBladeRebooting" : {
                        "description" : "isSelfBladeRebooting of clusterOperationProgress",
                        "type" : "boolean"
                    },
                    "bladeProgresss" : {
                        "description" : "bladeProgressMap of clusterOperationProgress",
                        "type" : "array",
                        "items" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                                "bladeUUID" : {
                                    "description" : "bladeUUID of bladeProgress",
                                    "type" : "string"
                                },
                                "hostName" : {
                                    "description" : "hostName of bladeProgress",
                                    "type" : "string"
                                },
                                "iterationName" : {
                                    "description" : "iterationName of bladeProgress",
                                    "type" : "string"
                                },
                                "state" : {
                                    "description" : "state of bladeProgress",
                                    "type" : "string"
                                },
                                "progress" : {
                                    "description" : "progress of bladeProgress",
                                    "type" : "integer"
                                }
                            }
                        }
                    },
                    "previousOperationRecord" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "properties" : {
                            "operation" : {
                                "description" : "operation of previousOperationRecord",
                                "enum" : [ "None", "Join", "Backup", "Restore", "Upload", "Upgrade", "BackupAndUpgrade", "RemoveBlade", "ChangeBladeIP", "DiskSnapshot", "UploadVDPFirmware" ]
                            },
                            "success" : {
                                "description" : "success of previousOperationRecord",
                                "type" : "boolean"
                            },
                            "errorMsg" : {
                                "description" : "errorMsg of previousOperationRecord",
                                "type" : "string"
                            }
                        },
                        "description" : "previousOperationRecord of clusterOperationProgress"
                    },
                    "clusterSubTaskState" : {
                        "description" : "clusterSubTaskState of clusterOperationProgress",
                        "enum" : [ "None", "Running", "Failed", "Completed" ]
                    },
                    "clusterOperationBlockUI" : {
                        "description" : "clusterOperationBlockUI of clusterOperationProgress",
                        "type" : "boolean"
                    },
                    "clusterOperationDisplayMsg" : {
                        "description" : "clusterOperationDisplayMsg of clusterOperationProgress",
                        "type" : "string"
                    }
                },
                "description" : "upgrade status"
            }
        }
    }
    
    

Retrive Upload Patch Info 

/v4_0/upgrade/patch

Use this API command to retrive upload file Info

  • Response  200
  • Body
    {
        "clusterOperationProgress" : {
            "operation" : "None",
            "overallProgress" : 0,
            "isSelfBladeRebooting" : null,
            "bladeProgresss" : [ {
                "bladeUUID" : "386988fe-72fe-41e0-a373-7a73fea5d16e",
                "hostName" : "neilscg200",
                "iterationName" : "None",
                "state" : "",
                "progress" : 0
            } ],
            "previousOperationRecord" : {
                "operation" : "Upload",
                "success" : true,
                "errorMsg" : null
            },
            "clusterSubTaskState" : "Completed",
            "clusterOperationBlockUI" : false,
            "clusterOperationDisplayMsg" : ""
        },
        "uploadPatchInfo" : {
            "fileName" : "scg-installer_3.2.1.0.2.ximg",
            "fileSize" : 893545600,
            "fileUploadPath" : null,
            "controlbladeVersion" : "3.2.1.0.4",
            "allowVersions" : null,
            "databladeVersion" : "3.2.1.0.6",
            "apVersion" : "3.2.1.99.528",
            "version" : "3.2.1.0.2"
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "clusterOperationProgress" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "operation" : {
                        "description" : "operation of clusterOperationProgress",
                        "enum" : [ "None", "Join", "Backup", "Restore", "Upload", "Upgrade", "BackupAndUpgrade", "RemoveBlade", "ChangeBladeIP", "DiskSnapshot", "UploadVDPFirmware" ]
                    },
                    "overallProgress" : {
                        "description" : "overallProgress of clusterOperationProgress",
                        "type" : "integer"
                    },
                    "isSelfBladeRebooting" : {
                        "description" : "isSelfBladeRebooting of clusterOperationProgress",
                        "type" : "boolean"
                    },
                    "bladeProgresss" : {
                        "description" : "bladeProgressMap of clusterOperationProgress",
                        "type" : "array",
                        "items" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                                "bladeUUID" : {
                                    "description" : "bladeUUID of bladeProgress",
                                    "type" : "string"
                                },
                                "hostName" : {
                                    "description" : "hostName of bladeProgress",
                                    "type" : "string"
                                },
                                "iterationName" : {
                                    "description" : "iterationName of bladeProgress",
                                    "type" : "string"
                                },
                                "state" : {
                                    "description" : "state of bladeProgress",
                                    "type" : "string"
                                },
                                "progress" : {
                                    "description" : "progress of bladeProgress",
                                    "type" : "integer"
                                }
                            }
                        }
                    },
                    "previousOperationRecord" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "properties" : {
                            "operation" : {
                                "description" : "operation of previousOperationRecord",
                                "enum" : [ "None", "Join", "Backup", "Restore", "Upload", "Upgrade", "BackupAndUpgrade", "RemoveBlade", "ChangeBladeIP", "DiskSnapshot", "UploadVDPFirmware" ]
                            },
                            "success" : {
                                "description" : "success of previousOperationRecord",
                                "type" : "boolean"
                            },
                            "errorMsg" : {
                                "description" : "errorMsg of previousOperationRecord",
                                "type" : "string"
                            }
                        },
                        "description" : "previousOperationRecord of clusterOperationProgress"
                    },
                    "clusterSubTaskState" : {
                        "description" : "clusterSubTaskState of clusterOperationProgress",
                        "enum" : [ "None", "Running", "Failed", "Completed" ]
                    },
                    "clusterOperationBlockUI" : {
                        "description" : "clusterOperationBlockUI of clusterOperationProgress",
                        "type" : "boolean"
                    },
                    "clusterOperationDisplayMsg" : {
                        "description" : "clusterOperationDisplayMsg of clusterOperationProgress",
                        "type" : "string"
                    }
                },
                "description" : "upgrade status"
            },
            "uploadPatchInfo" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "fileName" : {
                        "description" : "fileName of uploadPatchInfo",
                        "type" : "string"
                    },
                    "fileSize" : {
                        "description" : "fileSize of uploadPatchInfo",
                        "type" : "number"
                    },
                    "fileUploadPath" : {
                        "description" : "fileUploadPath of uploadPatchInfo",
                        "type" : "string"
                    },
                    "controlbladeVersion" : {
                        "description" : "controlbladeVersion of uploadPatchInfo",
                        "type" : "string"
                    },
                    "databladeVersion" : {
                        "description" : "databladeVersion of uploadPatchInfo",
                        "type" : "string"
                    },
                    "apVersion" : {
                        "description" : "apVersion of uploadPatchInfo",
                        "type" : "string"
                    },
                    "version" : {
                        "description" : "version of uploadPatchInfo",
                        "type" : "string"
                    },
                    "allowVersions" : {
                        "description" : "allowVersions of uploadPatchInfo",
                        "type" : "array",
                        "items" : {
                            "type" : "string"
                        }
                    }
                },
                "description" : "upgrade patch info"
            }
        }
    }
    
    

System Upgrade 

/v4_0/upgrade

Use this API command to do system upgrade

  • Response  200
  • Body
    {
        "clusterOperationProgress" : {
            "operation" : "None",
            "overallProgress" : 0,
            "isSelfBladeRebooting" : null,
            "bladeProgresss" : [ {
                "bladeUUID" : "386988fe-72fe-41e0-a373-7a73fea5d16e",
                "hostName" : "neilscg200",
                "iterationName" : "None",
                "state" : "",
                "progress" : 0
            } ],
            "previousOperationRecord" : {
                "operation" : "Upload",
                "success" : true,
                "errorMsg" : null
            },
            "clusterSubTaskState" : "Completed",
            "clusterOperationBlockUI" : false,
            "clusterOperationDisplayMsg" : ""
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "clusterOperationProgress" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "operation" : {
                        "description" : "operation of clusterOperationProgress",
                        "enum" : [ "None", "Join", "Backup", "Restore", "Upload", "Upgrade", "BackupAndUpgrade", "RemoveBlade", "ChangeBladeIP", "DiskSnapshot", "UploadVDPFirmware" ]
                    },
                    "overallProgress" : {
                        "description" : "overallProgress of clusterOperationProgress",
                        "type" : "integer"
                    },
                    "isSelfBladeRebooting" : {
                        "description" : "isSelfBladeRebooting of clusterOperationProgress",
                        "type" : "boolean"
                    },
                    "bladeProgresss" : {
                        "description" : "bladeProgressMap of clusterOperationProgress",
                        "type" : "array",
                        "items" : {
                            "type" : "object",
                            "additionalProperties" : false,
                            "properties" : {
                                "bladeUUID" : {
                                    "description" : "bladeUUID of bladeProgress",
                                    "type" : "string"
                                },
                                "hostName" : {
                                    "description" : "hostName of bladeProgress",
                                    "type" : "string"
                                },
                                "iterationName" : {
                                    "description" : "iterationName of bladeProgress",
                                    "type" : "string"
                                },
                                "state" : {
                                    "description" : "state of bladeProgress",
                                    "type" : "string"
                                },
                                "progress" : {
                                    "description" : "progress of bladeProgress",
                                    "type" : "integer"
                                }
                            }
                        }
                    },
                    "previousOperationRecord" : {
                        "type" : "object",
                        "additionalProperties" : false,
                        "properties" : {
                            "operation" : {
                                "description" : "operation of previousOperationRecord",
                                "enum" : [ "None", "Join", "Backup", "Restore", "Upload", "Upgrade", "BackupAndUpgrade", "RemoveBlade", "ChangeBladeIP", "DiskSnapshot", "UploadVDPFirmware" ]
                            },
                            "success" : {
                                "description" : "success of previousOperationRecord",
                                "type" : "boolean"
                            },
                            "errorMsg" : {
                                "description" : "errorMsg of previousOperationRecord",
                                "type" : "string"
                            }
                        },
                        "description" : "previousOperationRecord of clusterOperationProgress"
                    },
                    "clusterSubTaskState" : {
                        "description" : "clusterSubTaskState of clusterOperationProgress",
                        "enum" : [ "None", "Running", "Failed", "Completed" ]
                    },
                    "clusterOperationBlockUI" : {
                        "description" : "clusterOperationBlockUI of clusterOperationProgress",
                        "type" : "boolean"
                    },
                    "clusterOperationDisplayMsg" : {
                        "description" : "clusterOperationDisplayMsg of clusterOperationProgress",
                        "type" : "string"
                    }
                },
                "description" : "upgrade status"
            }
        }
    }
    
    

Retrive Upgrade History 

/v4_0/upgrade/history

Use this API command to retrive upgrade history

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

    timezone
    string (optional) 
  • Response  200
  • Body
    {
        "totalCount" : 1,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "startTime" : "2015/10/15 02:48:38",
            "version" : "3.2.1.0.1",
            "cbVersion" : "3.2.1.0.20151014063356",
            "dpVersion" : "3.2.1.0.20",
            "apFwVersion" : "3.2.1.99.537",
            "oldVersion" : "3.2.1.0.1",
            "oldCbVersion" : "3.2.1.0.20151014063356",
            "oldDpVersion" : "3.2.1.0.20",
            "oldApFwVersion" : "3.2.1.99.537",
            "fileName" : "Fresh Installation",
            "elapsedSeconds" : 772
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "startTime" : {
                            "description" : "startTime of the upgrade history",
                            "type" : "string"
                        },
                        "version" : {
                            "description" : "version of the upgrade history",
                            "type" : "string"
                        },
                        "cbVersion" : {
                            "description" : "cbVersion of the upgrade history",
                            "type" : "string"
                        },
                        "dpVersion" : {
                            "description" : "dpVersion of the upgrade history",
                            "type" : "string"
                        },
                        "apFwVersion" : {
                            "description" : "apFwVersion of the upgrade history",
                            "type" : "string"
                        },
                        "oldVersion" : {
                            "description" : "oldVersion of the upgrade history",
                            "type" : "string"
                        },
                        "oldCbVersion" : {
                            "description" : "oldCbVersion of the upgrade history",
                            "type" : "string"
                        },
                        "oldDpVersion" : {
                            "description" : "oldDpVersion of the upgrade history",
                            "type" : "string"
                        },
                        "oldApFwVersion" : {
                            "description" : "oldApFwVersion of the upgrade history",
                            "type" : "string"
                        },
                        "fileName" : {
                            "description" : "fileName of the upgrade history",
                            "type" : "string"
                        },
                        "elapsedSeconds" : {
                            "description" : "elapsedSeconds of the upgrade history",
                            "type" : "number"
                        }
                    }
                }
            }
        }
    }
    
    

Application Log And Status 

Retrieve List 

/v4_0/applications/{bladeUUID}

Use this API command to retrieve a list of application log and status.

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

  • Response  200
  • Body
    {
        "totalCount" : 1,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "applicationName" : "API",
            "healthStatus" : "Online",
            "logLevel" : "WARN",
            "numOfLogs" : 1,
            "logFileNames" : [ "api.log" ]
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "applicationName" : {
                            "description" : "Application name",
                            "type" : "string"
                        },
                        "healthStatus" : {
                            "description" : "Health status",
                            "type" : "string"
                        },
                        "logLevel" : {
                            "description" : "Log level",
                            "type" : "string"
                        },
                        "numOfLogs" : {
                            "description" : "# of Logs",
                            "type" : "integer"
                        },
                        "logFileNames" : {
                            "description" : "List of log file name",
                            "type" : "array",
                            "items" : {
                                "type" : "string"
                            }
                        }
                    }
                }
            }
        }
    }
    
    

Get control plane list 

/v4_0/applications/controlplane

Use this API command to retrieve a list of control plane.

  • Response  200
  • Body
    {
        "totalCount" : 1,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "cpUUID" : "9db2975b-1af2-4153-b400-b7f094058b4f",
            "cpName" : "R-KVM-200-C"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "cpUUID" : {
                            "description" : "Identifier of control plane",
                            "type" : "string"
                        },
                        "cpName" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of control plane"
                        }
                    }
                }
            }
        }
    }
    
    

Modify Log Level 

/v4_0/applications

Use this API command to modify log level of specified application.

  • Request
  • Body
    {
        "applicationName" : "API",
        "logLevel" : "WARN"
    }
    
    
    Schema
    {
        "applicationName" : {
            "description" : "Application name.",
            "type" : "string"
        },
        "logLevel" : {
            "description" : "Log level.",
            "enum" : [ "DEBUG", "INFO", "WARN", "ERROR" ]
        }
    }
    
    
  • Response  204

Download log 

/v4_0/applications/download/{bladeUUID}

Use this API command to download logs of the application.

  • Parameters
  • appName
    string (optional) 

    Download all logs of the specified application name.

    logFileName
    string (optional) 

    Download log of the specified log file name.

  • Response  200

Download snapshot log 

/v4_0/applications/downloadsnap/{bladeUUID}

Use this API command to download snapshot logs.

  • Response  200

LWAPP TO SCG 

Modify Basic 

/v4_0/lwapp2scg

Use this API command to modify the basic information of the Lwapp Config.

  • Request
  • Body
    {
        "policy" : "ACCEPT",
        "pasvMaxPort" : 65000,
        "pasvMinPort" : 16384,
        "natIpTranslation" : true
    }
    
    
    Schema
    {
        "policy" : {
            "description" : "policy of the lwapp",
            "enum" : [ "DENY", "ACCEPT", "DENY_ALL", "ACCEPT_ALL" ]
        },
        "pasvMaxPort" : {
            "description" : "pasvMaxPort of the lwapp",
            "type" : "integer",
            "minimum" : 16384,
            "maximum" : 65000
        },
        "pasvMinPort" : {
            "description" : "pasvMinPort of the lwapp",
            "type" : "integer",
            "minimum" : 16384,
            "maximum" : 65000
        },
        "natIpTranslation" : {
            "description" : "natIpTranslation of the lwapp",
            "type" : "boolean"
        }
    }
    
    
  • Response  204

Modify ApList 

/v4_0/lwapp2scg/apList

Use this API command to modify the apList of the Lwapp Config.

  • Request
  • Body
    [ "12345", "00:1D:2E:45:10:00" ]
    
    
    Schema
    {
        "description" : "accessPoint List  of the lwapp",
        "type" : "array",
        "items" : {
            "description" : "AP MAC Address or AP Serial Number",
            "type" : "string"
        }
    }
    
    
  • Response  204

Identity User 

Retrieve Identity User List 

/v4_0/identity/users

Use this API command to retrieve a list of identity user.

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

    timeZone
    string (optional) 

    Display created date and time by specified time zone. Default is UTC.

    userName
    string (optional) 

    filter identity user list by user name.

    displayName
    string (optional) 

    filter identity user list by display name.

    firstName
    string (optional) 

    filter identity user list by first name.

    lastName
    string (optional) 

    filter identity user list by last name.

    email
    string (optional) 

    filter identity user list by email.

    phone
    string (optional) 

    filter identity user list by phone.

    userType
    string (optional) 

    filter identity user list by user type.

    userSource
    string (optional) 

    filter identity user list by user source.

    isDisabled
    string (optional) 

    filter identity user list by isDisabled.

    createdOnFrom
    string (optional) 

    filter identity user list by created date and time. The start time of created date and time.

    createdOnTo
    string (optional) 

    filter identity user list by created date and time. The end time of created date and time.

  • Response  200
  • Body
    {
        "totalCount" : 2,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "09115c82-a049-4609-8fd8-1100b875592d",
            "displayName" : "display name",
            "userName" : "user name",
            "userSource" : "Local Database",
            "userType" : "LOCAL",
            "isDisabled" : "NO",
            "createdOn" : "2015/09/25 15:49:37"
        }, {
            "id" : "b5f02dbf-c769-436d-ae2d-44a6af194b57",
            "displayName" : "display name",
            "userName" : "user name",
            "userSource" : "Local Database",
            "userType" : "LOCAL",
            "isDisabled" : "NO",
            "createdOn" : "2015/09/23 16:35:44"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the identity user",
                            "type" : "string"
                        },
                        "displayName" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Display name"
                        },
                        "userName" : {
                            "description" : "User Name",
                            "type" : "string"
                        },
                        "userSource" : {
                            "description" : "User Source",
                            "type" : "string"
                        },
                        "userType" : {
                            "description" : "User Type",
                            "type" : "string"
                        },
                        "isDisabled" : {
                            "description" : "Is disalbed",
                            "type" : "string"
                        },
                        "createdOn" : {
                            "description" : "Created on",
                            "type" : "string"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve AAAServer List 

/v4_0/identity/users/aaaserver

Use this API command to retrieve a list of aaa server.

  • Response  200
  • Body
    {
        "totalCount" : 2,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "94b5c120-6014-11e5-b24f-525400c0e1b3",
            "name" : "globalRadius"
        }, {
            "id" : "11111111-1111-1111-1111-111111111111",
            "name" : "Local Database"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "the identifier of the AAA server",
                            "type" : "string"
                        },
                        "name" : {
                            "description" : "the identifier of the AAA server",
                            "type" : "string"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve Package List 

/v4_0/identity/users/packages

Use this API command to retrieve a list of packages.

  • Response  200
  • Body
    {
        "totalCount" : 2,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "subscriberPackage" : {
                "id" : "839f87c6-d116-497e-afce-aa8157abd30c",
                "name" : "External User Package"
            },
            "packageExpiration" : "2 Years"
        }, {
            "subscriberPackage" : {
                "id" : "f482f1ce-d7a7-4c55-b582-0ae3eccd4489",
                "name" : "Local User Package"
            },
            "packageExpiration" : "Never Expires"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "subscriberPackage" : {
                            "type" : [ "object", "null" ],
                            "additionalProperties" : false,
                            "properties" : {
                                "id" : {
                                    "type" : "string"
                                },
                                "name" : {
                                    "type" : "string"
                                }
                            },
                            "description" : "Subscriber package"
                        },
                        "packageExpiration" : {
                            "description" : "Package expiration interval and value",
                            "type" : "string"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve Country List 

/v4_0/identity/users/countries

Use this API command to retrieve a list of countries.

  • Response  200
  • Body
    {
        "totalCount" : 3,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "countryShortName" : "HU",
            "countryName" : "HUNGARY"
        }, {
            "countryShortName" : "AE",
            "countryName" : "UNITED ARAB EMIRATES"
        }, {
            "countryShortName" : "UZ",
            "countryName" : "UZBEKISTAN"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "countryShortName" : {
                            "description" : "Short name of country",
                            "type" : "string"
                        },
                        "countryName" : {
                            "description" : "Full name of country",
                            "type" : "string"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve 

/v4_0/identity/users/{id}

Use this API command to retrieve identity user.

  • Response  200
  • Body
    {
        "userName" : "username",
        "password" : "",
        "firstName" : "firstname",
        "lastName" : "lastname",
        "email" : "[email protected]",
        "phone" : "99-999-9999",
        "address" : "address",
        "city" : "city name",
        "state" : "state name",
        "zipCode" : "zip code",
        "countryName" : "country name",
        "remark" : "remark description",
        "subscriberPackage" : {
            "id" : "f482f1ce-d7a7-4c55-b582-0ae3eccd4489",
            "name" : "Local User Package"
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "firstName" : {
                "description" : "First name",
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32
            },
            "lastName" : {
                "description" : "Last Name",
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32
            },
            "email" : {
                "description" : "Email",
                "type" : "string"
            },
            "phone" : {
                "description" : "Phone",
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32
            },
            "address" : {
                "description" : "Address",
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 256
            },
            "city" : {
                "description" : "City",
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 50
            },
            "state" : {
                "description" : "State",
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32
            },
            "zipCode" : {
                "description" : "Zip Code",
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32
            },
            "countryName" : {
                "description" : "Country",
                "type" : "string"
            },
            "remark" : {
                "description" : "Remark",
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32
            },
            "userName" : {
                "description" : "User Name",
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 64
            },
            "subscriberPackage" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Subscriber package"
            }
        }
    }
    
    

Create 

/v4_0/identity/users

Use this API command to create identity user.

  • Request
  • Body
    {
        "firstName" : "first name",
        "lastName" : "last name",
        "email" : "[email protected]",
        "phone" : "999-9-9999999",
        "address" : "address",
        "city" : "city",
        "state" : "state",
        "zipCode" : "11023",
        "countryName" : "TAIWAN",
        "remark" : "remark description",
        "userName" : "ruckus",
        "password" : "password",
        "isDisabled" : "NO",
        "subscriberPackage" : {
            "id" : "f482f1ce-d7a7-4c55-b582-0ae3eccd4489"
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "firstName" : {
                "description" : "First name",
                "type" : "string"
            },
            "lastName" : {
                "description" : "Last Name",
                "type" : "string"
            },
            "email" : {
                "description" : "Email",
                "type" : "string"
            },
            "phone" : {
                "description" : "Phone",
                "type" : "string"
            },
            "address" : {
                "description" : "Address",
                "type" : "string"
            },
            "city" : {
                "description" : "City",
                "type" : "string"
            },
            "state" : {
                "description" : "State",
                "type" : "string"
            },
            "zipCode" : {
                "description" : "Zip Code",
                "type" : "string"
            },
            "countryName" : {
                "description" : "Country",
                "type" : "string"
            },
            "isDisabled" : {
                "description" : "Is Disabled",
                "enum" : [ "NO", "YES" ]
            },
            "remark" : {
                "description" : "Remark",
                "type" : "string"
            },
            "userName" : {
                "description" : "User Name",
                "type" : "string"
            },
            "password" : {
                "description" : "Password",
                "type" : "string"
            },
            "subscriberPackage" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "Subscriber package"
            }
        },
        "required" : [ "firstName", "lastName", "isDisabled", "userName", "password" ]
    }
    
    
  • Response  201
  • Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "the identifier of the create object",
                "type" : "string"
            }
        }
    }
    
    

Modify Basic 

/v4_0/identity/users/{id}

Use this API command to modify the basic information of identity user.

  • Request
  • Body
    {
        "firstName" : "first name",
        "lastName" : "last name",
        "email" : "[email protected]",
        "phone" : "999-9-9999999",
        "address" : "address",
        "city" : "city",
        "state" : "state",
        "zipCode" : "11023",
        "countryName" : "TAIWAN",
        "remark" : "remark description",
        "password" : "password"
    }
    
    
    Schema
    {
        "firstName" : {
            "description" : "First name",
            "type" : "string"
        },
        "lastName" : {
            "description" : "Last Name",
            "type" : "string"
        },
        "email" : {
            "description" : "Email",
            "type" : "string"
        },
        "phone" : {
            "description" : "Phone",
            "type" : "string"
        },
        "address" : {
            "description" : "Address",
            "type" : "string"
        },
        "city" : {
            "description" : "City",
            "type" : "string"
        },
        "state" : {
            "description" : "State",
            "type" : "string"
        },
        "zipCode" : {
            "description" : "Zip Code",
            "type" : "string"
        },
        "countryName" : {
            "description" : "Country",
            "type" : "string"
        },
        "isDisabled" : {
            "description" : "Is Disabled",
            "enum" : [ "NO", "YES" ]
        },
        "remark" : {
            "description" : "Remark",
            "type" : "string"
        },
        "password" : {
            "description" : "Password",
            "type" : "string"
        }
    }
    
    
  • Response  204

Modify Subscriber Package 

/v4_0/identity/users/{id}/subscriberPackage

Use this API command to modify subscriber package.

  • Request
  • Body
    {
        "id" : "f482f1ce-d7a7-4c55-b582-0ae3eccd4489"
    }
    
    
    Schema
    {
        "type" : [ "object", "null" ],
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            },
            "name" : {
                "type" : "string"
            }
        },
        "description" : "Subscriber package"
    }
    
    
  • Response  204

Delete 

/v4_0/identity/users/{id}

Use this API command to delete identity user.

  • Response  204

Identity Guest Pass 

Retrieve Identity Guest Pass List 

/v4_0/identity/guestpass

Use this API command to retrieve a list of identity guest pass.

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

    timeZone
    string (optional) 

    Display created date and time by specified time zone. Default is UTC.

    wlan
    string (optional) 

    filter identity guest pass list by wlan id.

    displayName
    string (optional) 

    filter identity guest pass list by display name.

    expirationFrom
    string (optional) 

    filter identity guest pass list by expiration date and time. The start time of expiration date and time.The format is yyyy-MM-dd HH:mm:ss.

    expirationTo
    string (optional) 

    filter identity guest pass list by expiration date and time. The end time of expiration date and time.The format is yyyy-MM-dd HH:mm:ss.

    generatedTimeFrom
    string (optional) 

    filter identity guest pass list by generated date and time. The start time of generated date and time.The format is yyyy-MM-dd HH:mm:ss.

    generatedTimeTo
    string (optional) 

    filter identity guest pass list by generated date and time. The end time of generated date and time.The format is yyyy-MM-dd HH:mm:ss.

  • Response  200
  • Body
    {
        "totalCount" : 2,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "key" : "6ygwR3B2",
            "guestName" : "guest-name-1",
            "remarks" : "remark",
            "generatedOn" : "2015/10/26 10:19:30",
            "expirationDate" : "2015/10/27 10:19:30",
            "wlanRestrition" : "[wlan-name] of [zone-name]"
        }, {
            "key" : "J8cjtQM9",
            "guestName" : "guest-name-2",
            "remarks" : "remark",
            "generatedOn" : "2015/10/26 09:54:36",
            "expirationDate" : "2015/10/27 00:54:36",
            "wlanRestrition" : "[wlan-name] of [zone-name]"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "key" : {
                            "description" : "Identifier of the identity guest pass",
                            "type" : "string"
                        },
                        "guestName" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Guest name of the identity guest pass"
                        },
                        "remarks" : {
                            "description" : "Remarks",
                            "type" : "string"
                        },
                        "generatedOn" : {
                            "description" : "Generated date and time",
                            "type" : "string"
                        },
                        "expirationDate" : {
                            "description" : "Expiration date and time",
                            "type" : "string"
                        },
                        "wlanRestrition" : {
                            "description" : "Wlan description",
                            "type" : "string"
                        }
                    }
                }
            }
        }
    }
    
    

Generate Identity Guest Pass 

/v4_0/identity/guestpass/generate

Use this API command to generate identity guest pass.

  • Request
  • Body
    {
        "guestName" : "guest name",
        "wlan" : {
            "name" : "wlan name"
        },
        "zone" : {
            "name" : "zone name"
        },
        "numberOfPasses" : 1,
        "passValidFor" : {
            "expirationValue" : 15,
            "expirationUnit" : "HOUR"
        },
        "autoGeneratedPassword" : true,
        "passEffectSince" : "CREATION_TIME",
        "passUseDays" : 7,
        "maxDevices" : {
            "maxDevicesAllowed" : "LIMITED",
            "maxDevicesNumber" : 3
        },
        "sessionDuration" : {
            "requireLoginAgain" : true,
            "sessionValue" : 3,
            "sessionUnit" : "DAY"
        },
        "remarks" : "comment"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "guestName" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Guest name"
            },
            "wlan" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "wlan id"
            },
            "zone" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "zone id"
            },
            "numberOfPasses" : {
                "description" : "Number of passes",
                "type" : "integer"
            },
            "passValidFor" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "expirationValue" : {
                        "type" : "integer"
                    },
                    "expirationUnit" : {
                        "enum" : [ "HOUR", "DAY", "WEEK" ]
                    }
                },
                "description" : "Pass valid for"
            },
            "autoGeneratedPassword" : {
                "description" : "Pass generation",
                "type" : "boolean"
            },
            "passValue" : {
                "description" : "Pass value",
                "type" : "string"
            },
            "passEffectSince" : {
                "description" : "Pass effective since",
                "enum" : [ "CREATION_TIME", "FIRST_USE" ]
            },
            "passUseDays" : {
                "description" : "Expire new guest pass if not used within",
                "type" : "integer"
            },
            "maxDevices" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "maxDevicesAllowed" : {
                        "description" : "Max devices allowed",
                        "enum" : [ "UNLIMITED", "LIMITED" ],
                        "default" : "LIMITED"
                    },
                    "maxDevicesNumber" : {
                        "description" : "max devices number",
                        "type" : "integer",
                        "default" : 3,
                        "minimum" : 1,
                        "maximum" : 10
                    }
                },
                "description" : "max Devices"
            },
            "sessionDuration" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "requireLoginAgain" : {
                        "type" : "boolean"
                    },
                    "sessionValue" : {
                        "type" : "integer"
                    },
                    "sessionUnit" : {
                        "enum" : [ "MIN", "HOUR", "DAY", "WEEK" ]
                    }
                },
                "description" : "session duration"
            },
            "remarks" : {
                "description" : "Remarks",
                "type" : "string"
            }
        },
        "required" : [ "guestName", "wlan", "zone", "numberOfPasses", "passValidFor", "maxDevices" ]
    }
    
    
  • Response  201
  • Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "the identifier of the create object",
                "type" : "string"
            }
        }
    }
    
    

Import Identity Guest Pass 

/v4_0/identity/guestpass/upload

Use this API command to upload identity guest pass csv file.

  • Response  204

Common Identity Guest Pass Settings 

/v4_0/identity/guestpass/upload/common

Use this API command to update common identity guest pass settings.

  • Request
  • Body
    {
        "wlan" : {
            "name" : "wlan name"
        },
        "zone" : {
            "name" : "zone name"
        },
        "passValidFor" : {
            "expirationValue" : 15,
            "expirationUnit" : "HOUR"
        },
        "passEffectSince" : "CREATION_TIME",
        "passUseDays" : 7,
        "maxDevices" : {
            "maxDevicesAllowed" : "LIMITED",
            "maxDevicesNumber" : 3
        },
        "sessionDuration" : {
            "requireLoginAgain" : true,
            "sessionValue" : 3,
            "sessionUnit" : "DAY"
        }
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "wlan" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "wlan id"
            },
            "zone" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "zone id"
            },
            "passValidFor" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "expirationValue" : {
                        "type" : "integer"
                    },
                    "expirationUnit" : {
                        "enum" : [ "HOUR", "DAY", "WEEK" ]
                    }
                },
                "description" : "Pass valid for"
            },
            "passEffectSince" : {
                "description" : "Pass effective since",
                "enum" : [ "CREATION_TIME", "FIRST_USE" ]
            },
            "passUseDays" : {
                "description" : "Expire new guest pass if not used within",
                "type" : "integer"
            },
            "maxDevices" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "maxDevicesAllowed" : {
                        "description" : "Max devices allowed",
                        "enum" : [ "UNLIMITED", "LIMITED" ],
                        "default" : "LIMITED"
                    },
                    "maxDevicesNumber" : {
                        "description" : "max devices number",
                        "type" : "integer",
                        "default" : 3,
                        "minimum" : 1,
                        "maximum" : 10
                    }
                },
                "description" : "max Devices"
            },
            "sessionDuration" : {
                "type" : "object",
                "additionalProperties" : false,
                "properties" : {
                    "requireLoginAgain" : {
                        "type" : "boolean"
                    },
                    "sessionValue" : {
                        "type" : "integer"
                    },
                    "sessionUnit" : {
                        "enum" : [ "MIN", "HOUR", "DAY", "WEEK" ]
                    }
                },
                "description" : "session duration"
            }
        },
        "required" : [ "wlan", "zone", "passValidFor", "maxDevices" ]
    }
    
    
  • Response  201

DNS Server Management 

Retrieve list 

/v4_0/profiles/dnsserver

Use this API command to retrieve a list of DNS server profile.

  • Parameters
  • index
    number (optional) 

    The index of the first entry to be retrieved. Default: 0

    listSize
    number (optional) 

    The maximum number of entries to be retrieved. Default: 100

  • Response  200
  • Body
    {
        "totalCount" : 1,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "267ef3a0-738b-11e4-96d5-0a7820524153",
            "name" : "new name"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the profile",
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the profile"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve 

/v4_0/profiles/dnsserver/{id}

Use this API command to retrieve DNS server profile.

  • Response  200
  • Body
    {
        "name" : "DNS server name",
        "description" : "DNS server description",
        "primaryIp" : "172.17.60.61",
        "secondaryIp" : "172.17.60.53",
        "tertiaryIp" : "172.17.60.50"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the dns server service"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the dns server service"
            },
            "primaryIp" : {
                "description" : "Primary ip of DNS server service",
                "type" : "string"
            },
            "secondaryIp" : {
                "description" : "Secondary ip of DNS server service",
                "type" : "string"
            },
            "tertiaryIp" : {
                "description" : "Tertiary ip of DNS server service",
                "type" : "string"
            }
        }
    }
    
    

Create 

/v4_0/profiles/dnsserver

Use this API command to create DNS server profile.

  • Request
  • Body
    {
        "name" : "DNS server name",
        "description" : "DNS server description",
        "primaryIp" : "172.17.60.61",
        "secondaryIp" : "172.17.60.53",
        "tertiaryIp" : "172.17.60.50"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "Name of the dns server service"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "Description of the dns server service"
            },
            "primaryIp" : {
                "description" : "Primary ip of DNS server service",
                "type" : "string"
            },
            "secondaryIp" : {
                "description" : "Secondary ip of DNS server service",
                "type" : "string"
            },
            "tertiaryIp" : {
                "description" : "Tertiary ip of DNS server service",
                "type" : "string"
            }
        },
        "required" : [ "name", "primaryIp" ]
    }
    
    
  • Response  201
  • Body
    {
        "id" : "profileUUID"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "type" : "string"
            }
        }
    }
    
    

Modify Basic 

/v4_0/profiles/dnsserver/{id}

Use this API command to modify the basic information of DNS server profile.

  • Request
  • Body
    {
        "name" : "DNS server name",
        "description" : "DNS server description",
        "primaryIp" : "172.17.60.61",
        "secondaryIp" : "172.17.60.53",
        "tertiaryIp" : "172.17.60.50"
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "Name of the dns server service"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "Description of the dns server service"
        },
        "primaryIp" : {
            "description" : "Primary ip of DNS server service",
            "type" : "string"
        },
        "secondaryIp" : {
            "description" : "Secondary ip of DNS server service",
            "type" : "string"
        },
        "tertiaryIp" : {
            "description" : "Tertiary ip of DNS server service",
            "type" : "string"
        }
    }
    
    
  • Response  204

Delete 

/v4_0/profiles/dnsserver/{id}

Use this API command to delete DNS server profile.

  • Response  204

Identity Subscription Package 

Retrieve subscription package list 

/v4_0/identity/packages

Use this API command to retrieve a list of subscription package.

  • Response  200
  • Body
    {
        "totalCount" : 3,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "24cfb9af-4b3f-4d0a-8a92-b2eba022687b",
            "name" : "subscription-package-name1",
            "description" : "description",
            "expirationInterval" : "HOUR",
            "expirationValue" : 8
        }, {
            "id" : "839f87c6-d116-497e-afce-aa8157abd30c",
            "name" : "External User Package",
            "description" : "External User Package",
            "expirationInterval" : "YEAR",
            "expirationValue" : 2
        }, {
            "id" : "6547be7c-6787-487e-b672-f90faf77b6d0",
            "name" : "Local User Package",
            "description" : "Local User Package",
            "expirationInterval" : "NEVER",
            "expirationValue" : 0
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "the identifier of the subscription package",
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "name of the subscription package"
                        },
                        "description" : {
                            "type" : [ "string", "null" ],
                            "maxLength" : 64,
                            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                            "description" : "description of the subscription package"
                        },
                        "expirationInterval" : {
                            "description" : "Expiration interval",
                            "enum" : [ "HOUR", "DAY", "WEEK", "MONTH", "YEAR", "NEVER" ]
                        },
                        "expirationValue" : {
                            "description" : "Expiration value",
                            "type" : "integer"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve 

/v4_0/identity/packages/{id}

Use this API command to retrieve subscription package.

  • Response  200
  • Body
    {
        "name" : "subscription-package-name",
        "description" : "description",
        "expirationInterval" : "DAY",
        "expirationValue" : 3
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "name"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "description of the subscription package"
            },
            "expirationInterval" : {
                "description" : "Expiration interval",
                "enum" : [ "HOUR", "DAY", "WEEK", "MONTH", "YEAR", "NEVER" ]
            },
            "expirationValue" : {
                "description" : "Expiration value",
                "type" : "integer"
            }
        }
    }
    
    

Create 

/v4_0/identity/packages

Use this API command to create subscription package.

  • Request
  • Body
    {
        "name" : "subscription-package-name",
        "description" : "description",
        "expirationInterval" : "HOUR",
        "expirationValue" : 5
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "name of subscription package"
            },
            "description" : {
                "type" : [ "string", "null" ],
                "maxLength" : 64,
                "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
                "description" : "description of the subscription package"
            },
            "expirationInterval" : {
                "description" : "Expiration interval",
                "enum" : [ "HOUR", "DAY", "WEEK", "MONTH", "YEAR", "NEVER" ]
            },
            "expirationValue" : {
                "description" : "Expiration value",
                "type" : "integer"
            }
        },
        "required" : [ "name", "expirationInterval", "expirationValue" ]
    }
    
    
  • Response  201
  • Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "id" : {
                "description" : "the identifier of the create object",
                "type" : "string"
            }
        }
    }
    
    

Modify Basic 

/v4_0/identity/packages/{id}

Use this API command to modify the basic information of subscription package.

  • Request
  • Body
    {
        "name" : "subscription-package-name",
        "description" : "description",
        "expirationInterval" : "DAY",
        "expirationValue" : 3
    }
    
    
    Schema
    {
        "name" : {
            "type" : "string",
            "minLength" : 2,
            "maxLength" : 32,
            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
            "description" : "name of subscription package"
        },
        "description" : {
            "type" : [ "string", "null" ],
            "maxLength" : 64,
            "pattern" : "^$|^([!-~]([ -~]){0,62}[!-~]|[!-~]{1,1})$",
            "description" : "description of the subscription package"
        },
        "expirationInterval" : {
            "description" : "Expiration interval",
            "enum" : [ "HOUR", "DAY", "WEEK", "MONTH", "YEAR", "NEVER" ]
        },
        "expirationValue" : {
            "description" : "Expiration value",
            "type" : "integer"
        }
    }
    
    
  • Response  204

Delete 

/v4_0/identity/packages/{id}

Use this API command to delete subscription package.

  • Response  204

Test AAA Server 

Test AAA 

/v4_0/system/aaa/test

Use this API command to test AAA server.

  • Request
  • Body
    {
        "serverType" : "GLOBAL",
        "aaaType" : "RADIUS",
        "aaaServer" : {
            "name" : "apiAAAServer"
        },
        "userName" : "admin",
        "password" : "admin!234",
        "authProtocol" : "CHAP"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "serverType" : {
                "description" : "Radius server type.",
                "enum" : [ "ADMIN", "GLOBAL", "ZONE" ]
            },
            "aaaType" : {
                "description" : "Authentication/Accounting service protocol. RADIUS for Radius, AD and LDAP. RADIUSAcct for RADIUS Accounting",
                "enum" : [ "RADIUS", "RADIUSAcct" ]
            },
            "aaaServer" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "AAA server id or name"
            },
            "userName" : {
                "description" : "User name",
                "type" : "string"
            },
            "password" : {
                "description" : "Password",
                "type" : "string"
            },
            "authProtocol" : {
                "description" : "Authentication protocol",
                "enum" : [ "PAP", "CHAP" ],
                "default" : "PAP"
            }
        },
        "required" : [ "aaaServer", "userName", "password", "authProtocol" ]
    }
    
    
  • Response  200
  • Body
    {
        "primaryServer" : "Success",
        "secondaryServer" : null
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "primaryServer" : {
                "description" : "Primary server test result",
                "type" : "string"
            },
            "secondaryServer" : {
                "description" : "Secondary server test result",
                "type" : "string"
            }
        }
    }
    
    

Enterprise Tunnel Profile 

Retrieve 

/v4_0/profiles/enterpriseTunnel

Use this API command to retrieve Enterprise tunnel profile.

  • Response  200
  • Body
    {
        "name" : "Default Tunnel Profile",
        "tunnelMtuAutoEnabled" : true,
        "tunnelMtuSize" : null,
        "tunnelType" : "RuckusGRE",
        "ruckusTunnelModel" : "GREUDP",
        "tunnelEncryption" : false,
        "natUDPPort" : 65535,
        "primaryGateway" : null,
        "secondaryGateway" : null,
        "primaryGatewayV6" : null,
        "secondaryGatewayV6" : null,
        "tunnelKeepAliveInterval" : null,
        "tunnelKeepAliveRetryLimit" : null,
        "forceDisassociateClientEnabled" : false,
        "ipsecProfile" : null
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "name" : {
                "type" : "string",
                "minLength" : 2,
                "maxLength" : 32,
                "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                "description" : "name of the SoftGRE profile"
            },
            "tunnelType" : {
                "description" : "Tunnel type configuration of the zone. No_Tunneled is for IPv6 mode",
                "enum" : [ "No_Tunneled", "RuckusGRE", "SoftGRE", "SoftGREIpsec" ]
            },
            "ipsecProfile" : {
                "type" : [ "object", "null" ],
                "additionalProperties" : false,
                "properties" : {
                    "id" : {
                        "type" : "string"
                    },
                    "name" : {
                        "type" : "string"
                    }
                },
                "description" : "ipsec profile configuration of the Zone."
            },
            "tunnelMtuAutoEnabled" : {
                "description" : "Enable mtu auto",
                "type" : "boolean"
            },
            "tunnelMtuSize" : {
                "description" : "Tunnel mtu size, IPV4:850-1500, IPV6:1384-1500.",
                "type" : "integer",
                "default" : 1500
            },
            "ruckusTunnelModel" : {
                "description" : "Ruckus GRE, TunnelModel",
                "enum" : [ "GRE", "GREUDP" ]
            },
            "natUDPPort" : {
                "description" : "Ruckus GRE, Data plane UDP Port.",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 65535,
                "default" : 23233
            },
            "tunnelEncryption" : {
                "description" : "Ruckus GRE ,Enable tunnel encryption",
                "type" : "boolean"
            },
            "primaryGateway" : {
                "description" : "Soft GRE primary gateway",
                "type" : "string"
            },
            "secondaryGateway" : {
                "description" : "Soft GRE, secondary gateway",
                "type" : "string"
            },
            "primaryGatewayV6" : {
                "description" : "Soft GRE, primary gateway for IPV6",
                "type" : "string"
            },
            "secondaryGatewayV6" : {
                "description" : "Soft GRE, secondary gateway for IPV6",
                "type" : "string"
            },
            "tunnelKeepAliveInterval" : {
                "description" : "Soft GRE tunnel keep alive interval, 1-180. Default 10.",
                "type" : "integer",
                "minimum" : 1,
                "maximum" : 180,
                "default" : 10
            },
            "tunnelKeepAliveRetryLimit" : {
                "description" : "Soft GRE tunnel keep alive retry limit, 2-10. Default 5.",
                "type" : "integer",
                "minimum" : 2,
                "maximum" : 10,
                "default" : 5
            },
            "forceDisassociateClientEnabled" : {
                "description" : "Enable forceDisassociateClient",
                "type" : "boolean"
            }
        }
    }
    
    

Modify Basic 

/v4_0/profiles/enterpriseTunnel

Use this API command to modify the basic information of Enterprise tunnel profile.

  • Request
  • Body
    {
        "tunnelType" : "SoftGREIpsec",
        "tunnelMtuAutoEnabled" : true,
        "primaryGateway" : "172.17.87.11",
        "secondaryGateway" : "111.111.11.11",
        "tunnelKeepAliveInterval" : 10,
        "tunnelKeepAliveRetryLimit" : 5,
        "forceDisassociateClientEnabled" : false
    }
    
    
    Schema
    {
        "tunnelType" : {
            "description" : "Tunnel type configuration of the zone. No_Tunneled is for IPv6 mode",
            "enum" : [ "No_Tunneled", "RuckusGRE", "SoftGRE", "SoftGREIpsec" ]
        },
        "tunnelMtuAutoEnabled" : {
            "description" : "Enable mtu auto",
            "type" : "boolean"
        },
        "tunnelMtuSize" : {
            "description" : "Tunnel mtu size, IPV4:850-1500, IPV6:1384-1500.",
            "type" : "integer",
            "default" : 1500
        },
        "ruckusTunnelModel" : {
            "description" : "Ruckus GRE, TunnelModel",
            "enum" : [ "GRE", "GREUDP" ]
        },
        "natUDPPort" : {
            "description" : "Ruckus GRE, Data plane UDP Port.",
            "type" : "integer",
            "minimum" : 1,
            "maximum" : 65535,
            "default" : 23233
        },
        "tunnelEncryption" : {
            "description" : "Ruckus GRE ,Enable tunnel encryption",
            "type" : "boolean"
        },
        "primaryGateway" : {
            "description" : "Soft GRE primary gateway",
            "type" : "string"
        },
        "secondaryGateway" : {
            "description" : "Soft GRE, secondary gateway",
            "type" : "string"
        },
        "primaryGatewayV6" : {
            "description" : "Soft GRE, primary gateway for IPV6",
            "type" : "string"
        },
        "secondaryGatewayV6" : {
            "description" : "Soft GRE, secondary gateway for IPV6",
            "type" : "string"
        },
        "tunnelKeepAliveInterval" : {
            "description" : "Soft GRE tunnel keep alive interval, 1-180. Default 10.",
            "type" : "integer",
            "minimum" : 1,
            "maximum" : 180,
            "default" : 10
        },
        "tunnelKeepAliveRetryLimit" : {
            "description" : "Soft GRE tunnel keep alive retry limit, 2-10. Default 5.",
            "type" : "integer",
            "minimum" : 2,
            "maximum" : 10,
            "default" : 5
        },
        "forceDisassociateClientEnabled" : {
            "description" : "Enable forceDisassociateClient",
            "type" : "boolean"
        }
    }
    
    
  • Response  204

DPSK 

Retrieve DPSK info By Zone 

/v4_0/rkszones/{zoneId}/dpsk

Use this API command to retrieve DPSK info of a zone.

  • Response  200
  • Body
    {
        "resultCount" : 1,
        "dpskInfoList" : [ {
            "id" : "caa96db0-5c62-4559-8c38-669f31943ca8",
            "wlanId" : "3",
            "userName" : "BatchDPSK_User_0",
            "macAddress" : null,
            "passphrase" : "zheO}VO2",
            "vlanId" : null,
            "creationDateTime" : "2015/12/11 17:59:04",
            "expirationDateTime" : "Not start using"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "resultCount" : {
                "type" : "integer"
            },
            "dpskInfoList" : {
                "description" : "Information list of DPSK",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of DPSK",
                            "type" : "string"
                        },
                        "wlanId" : {
                            "description" : "Wlan ID of DPSK",
                            "type" : "string"
                        },
                        "userName" : {
                            "description" : "User Name of DPSK",
                            "type" : "string"
                        },
                        "macAddress" : {
                            "description" : "Mac address of DPSK",
                            "type" : "string"
                        },
                        "passphrase" : {
                            "description" : "passphrase of DPSK",
                            "type" : "string"
                        },
                        "vlanId" : {
                            "description" : "Vlan id of DPSK",
                            "type" : "integer"
                        },
                        "creationDateTime" : {
                            "description" : "Creationd date/time of DPSK",
                            "type" : "number"
                        },
                        "expirationDateTime" : {
                            "description" : "Expiration date/time of DPSK",
                            "type" : "string"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve DPSK info By WLAN 

/v4_0/rkszones/{zoneId}/wlans/{id}/dpsk

Use this API command to retrieve DPSK info of a WLAN.

  • Response  200
  • Body
    {
        "resultCount" : 1,
        "dpskInfoList" : [ {
            "id" : "caa96db0-5c62-4559-8c38-669f31943ca8",
            "wlanId" : "3",
            "userName" : "BatchDPSK_User_0",
            "macAddress" : null,
            "passphrase" : "zheO}VO2",
            "vlanId" : null,
            "creationDateTime" : "2015/12/11 17:59:04",
            "expirationDateTime" : "Not start using"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "resultCount" : {
                "type" : "integer"
            },
            "dpskInfoList" : {
                "description" : "Information list of DPSK",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of DPSK",
                            "type" : "string"
                        },
                        "wlanId" : {
                            "description" : "Wlan ID of DPSK",
                            "type" : "string"
                        },
                        "userName" : {
                            "description" : "User Name of DPSK",
                            "type" : "string"
                        },
                        "macAddress" : {
                            "description" : "Mac address of DPSK",
                            "type" : "string"
                        },
                        "passphrase" : {
                            "description" : "passphrase of DPSK",
                            "type" : "string"
                        },
                        "vlanId" : {
                            "description" : "Vlan id of DPSK",
                            "type" : "integer"
                        },
                        "creationDateTime" : {
                            "description" : "Creationd date/time of DPSK",
                            "type" : "number"
                        },
                        "expirationDateTime" : {
                            "description" : "Expiration date/time of DPSK",
                            "type" : "string"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve DPSK info By Id 

/v4_0/rkszones/{zoneId}/wlans/{id}/dpsk/{dpskId}

Use this API command to retrieve DPSK info.

  • Response  200
  • Body
    {
        "resultCount" : 1,
        "dpskInfoList" : [ {
            "id" : "caa96db0-5c62-4559-8c38-669f31943ca8",
            "wlanId" : "3",
            "userName" : "BatchDPSK_User_0",
            "macAddress" : null,
            "passphrase" : "zheO}VO2",
            "vlanId" : null,
            "creationDateTime" : "2015/12/11 17:59:04",
            "expirationDateTime" : "Not start using"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "resultCount" : {
                "type" : "integer"
            },
            "dpskInfoList" : {
                "description" : "Information list of DPSK",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of DPSK",
                            "type" : "string"
                        },
                        "wlanId" : {
                            "description" : "Wlan ID of DPSK",
                            "type" : "string"
                        },
                        "userName" : {
                            "description" : "User Name of DPSK",
                            "type" : "string"
                        },
                        "macAddress" : {
                            "description" : "Mac address of DPSK",
                            "type" : "string"
                        },
                        "passphrase" : {
                            "description" : "passphrase of DPSK",
                            "type" : "string"
                        },
                        "vlanId" : {
                            "description" : "Vlan id of DPSK",
                            "type" : "integer"
                        },
                        "creationDateTime" : {
                            "description" : "Creationd date/time of DPSK",
                            "type" : "number"
                        },
                        "expirationDateTime" : {
                            "description" : "Expiration date/time of DPSK",
                            "type" : "string"
                        }
                    }
                }
            }
        }
    }
    
    

Upload DPSK file 

/v4_0/rkszones/{zoneId}/wlans/{id}/dpsk/upload

Use this API command to upload DPSK file of a WLAN. (CSV file is only accepted.)

  • Request
  • Body
    The DPSK file
    
    
  • Response  201

Batch Generate DPSKs 

/v4_0/rkszones/{zoneId}/wlans/{id}/dpsk/batchGenUnbound

Use this API command to batch generate DPSKs of a WLAN.

  • Parameters
  • amount
    number (required) 
    vlanId
    number (optional) 
    userRoleId
    string (optional) 
  • Response  201
  • Body
    {
        "resultCount" : 1,
        "dpskInfoList" : [ {
            "id" : "caa96db0-5c62-4559-8c38-669f31943ca8",
            "wlanId" : "3",
            "userName" : "BatchDPSK_User_0",
            "macAddress" : null,
            "passphrase" : "zheO}VO2",
            "vlanId" : null,
            "creationDateTime" : "2015/12/11 17:59:04",
            "expirationDateTime" : "Not start using"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "resultCount" : {
                "type" : "integer"
            },
            "dpskInfoList" : {
                "description" : "Information list of DPSK",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of DPSK",
                            "type" : "string"
                        },
                        "wlanId" : {
                            "description" : "Wlan ID of DPSK",
                            "type" : "string"
                        },
                        "userName" : {
                            "description" : "User Name of DPSK",
                            "type" : "string"
                        },
                        "macAddress" : {
                            "description" : "Mac address of DPSK",
                            "type" : "string"
                        },
                        "passphrase" : {
                            "description" : "passphrase of DPSK",
                            "type" : "string"
                        },
                        "vlanId" : {
                            "description" : "Vlan id of DPSK",
                            "type" : "integer"
                        },
                        "creationDateTime" : {
                            "description" : "Creationd date/time of DPSK",
                            "type" : "number"
                        },
                        "expirationDateTime" : {
                            "description" : "Expiration date/time of DPSK",
                            "type" : "string"
                        }
                    }
                }
            }
        }
    }
    
    

Retrieve interval of delete expired DPSK 

/v4_0/rkszones/{zoneId}/deleteExpiredDpsk

Use this API command to retrieve interval of delete expired DPSK of a zone.

  • Response  200
  • Body
    {
        "deleteExpiredDpsk" : "Never"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "deleteExpiredDpsk" : {
                "description" : "Delete expired DPSK interval of the Zone.",
                "enum" : [ "Never", "AfterOneDay", "AfterSixMonths" ]
            }
        }
    }
    
    

Modify interval of delete expired DPSK 

/v4_0/rkszones/{zoneId}/deleteExpiredDpsk

Use this API command to modify interval of delete expired DPSK of a zone.

  • Request
  • Body
    {
        "deleteExpiredDpsk" : "AfterOneDay"
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "deleteExpiredDpsk" : {
                "description" : "Delete expired DPSK interval of the Zone.",
                "enum" : [ "Never", "AfterOneDay", "AfterSixMonths" ]
            }
        }
    }
    
    
  • Response  204

Delete DPSK 

/v4_0/rkszones/{zoneId}/wlans/{id}/dpsk

Use this API command to delete DPSKs of a WLAN.

  • Request
  • Body
    {
        "idList" : [ "fb357b53-48dd-4a23-b6bf-2e3d935d8df3", "c2074deb-0f0c-47fa-bf56-f3f2f5b64de0" ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "idList" : {
                "type" : "array",
                "items" : {
                    "description" : "Id list of DPSK",
                    "type" : "string"
                }
            }
        }
    }
    
    
  • Response  200
  • Body
    {
        "resultCount" : 2
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "resultCount" : {
                "type" : "integer"
            }
        }
    }
    
    

SNMP Agent 

Retrieve SNMP Agent 

/v4_0/system/snmpAgent

Retrieve SNMP Agent sertting

  • Response  200
  • Body
    {
        "snmpNotificationEnabled" : false,
        "snmpV2Agent" : [ {
            "communityName" : "communityName",
            "readEnabled" : false,
            "writeEnabled" : false,
            "notificationEnabled" : true,
            "notificationType" : "TRAP",
            "notificationTarget" : [ {
                "address" : "111.11.11.112",
                "port" : 1
            }, {
                "address" : "111.11.11.114",
                "port" : 162
            }, {
                "address" : "111.11.11.114",
                "port" : 162
            } ]
        } ],
        "snmpV3Agent" : [ {
            "userName" : "bbb",
            "authProtocol" : "SHA",
            "authPassword" : "authPassword",
            "readEnabled" : true,
            "writeEnabled" : true,
            "notificationEnabled" : false
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "snmpNotificationEnabled" : {
                "description" : "Enable SNMP Notifications Globally (If SNMP Notification is disabled globally, no Notification message is sent out.)",
                "type" : "boolean"
            },
            "snmpV2Agent" : {
                "description" : "Community List of the SNMP V2 Agent.",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "communityName" : {
                            "description" : "name of the SNMP Community.",
                            "type" : "string"
                        },
                        "readEnabled" : {
                            "description" : "read privilege of the SNMP Coummunity",
                            "type" : "boolean"
                        },
                        "writeEnabled" : {
                            "description" : "write privilege of the SNMP Coummunity",
                            "type" : "boolean"
                        },
                        "notificationEnabled" : {
                            "description" : "notification privilege of the SNMP Coummunity",
                            "type" : "boolean"
                        },
                        "notificationType" : {
                            "description" : "type of the notification privilege",
                            "enum" : [ "TRAP", "INFORM" ]
                        },
                        "notificationTarget" : {
                            "description" : "Trap List of the SNMP Coummunity",
                            "type" : "array",
                            "items" : {
                                "type" : "object",
                                "additionalProperties" : false,
                                "properties" : {
                                    "address" : {
                                        "description" : "address of the SNMP Trap",
                                        "type" : "string"
                                    },
                                    "port" : {
                                        "description" : "port number of the SNMP Trap",
                                        "type" : "integer",
                                        "minimum" : 1,
                                        "maximum" : 65535
                                    }
                                },
                                "required" : [ "address", "port" ]
                            }
                        }
                    },
                    "required" : [ "communityName" ]
                }
            },
            "snmpV3Agent" : {
                "description" : "User List of the SNMP V2 Agent.",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "userName" : {
                            "description" : "name of the SNMP User.",
                            "type" : "string"
                        },
                        "authProtocol" : {
                            "description" : "authProtocol of the SNMP User.",
                            "enum" : [ "MD5", "SHA" ]
                        },
                        "authPassword" : {
                            "description" : "authPassword of the SNMP User.",
                            "type" : "string",
                            "minLength" : 8
                        },
                        "privProtocol" : {
                            "description" : "privProtocol of the SNMP User.",
                            "enum" : [ "DES", "AES" ]
                        },
                        "privPassword" : {
                            "description" : "privPassword of the SNMP User.",
                            "type" : "string",
                            "minLength" : 8
                        },
                        "readEnabled" : {
                            "description" : "read privilege of the SNMP User",
                            "type" : "boolean"
                        },
                        "writeEnabled" : {
                            "description" : "write privilege of the SNMP User",
                            "type" : "boolean"
                        },
                        "notificationEnabled" : {
                            "description" : "notification privilege of the SNMP User",
                            "type" : "boolean"
                        },
                        "notificationType" : {
                            "description" : "type of the notification privilege",
                            "enum" : [ "TRAP", "INFORM" ]
                        },
                        "notificationTarget" : {
                            "description" : "Trap List of the SNMP User",
                            "type" : "array",
                            "items" : {
                                "type" : "object",
                                "additionalProperties" : false,
                                "properties" : {
                                    "address" : {
                                        "description" : "address of the SNMP Trap",
                                        "type" : "string"
                                    },
                                    "port" : {
                                        "description" : "port number of the SNMP Trap",
                                        "type" : "integer",
                                        "minimum" : 1,
                                        "maximum" : 65535
                                    }
                                },
                                "required" : [ "address", "port" ]
                            }
                        }
                    },
                    "required" : [ "userName" ]
                }
            }
        }
    }
    
    

Modify SNMP Agent 

/v4_0/system/snmpAgent

Modify syslog server setting

  • Request
  • Body
    {
        "snmpNotificationEnabled" : true,
        "snmpV2Agent" : [ {
            "communityName" : "aaa",
            "readEnabled" : false,
            "writeEnabled" : false,
            "notificationEnabled" : true,
            "notificationType" : "TRAP",
            "notificationTarget" : [ {
                "address" : "111.11.11.112",
                "port" : 1
            }, {
                "address" : "111.11.11.114",
                "port" : 162
            }, {
                "address" : "111.11.11.114",
                "port" : 162
            } ]
        } ],
        "snmpV3Agent" : [ {
            "userName" : "userName",
            "authProtocol" : "SHA",
            "authPassword" : "authPassword",
            "privProtocol" : "DES",
            "privPassword" : "privPassword",
            "readEnabled" : true,
            "writeEnabled" : true,
            "notificationEnabled" : true,
            "notificationType" : "TRAP",
            "notificationTarget" : [ {
                "address" : "111.11.11.112",
                "port" : 1
            }, {
                "address" : "111.11.11.114",
                "port" : 162
            }, {
                "address" : "111.11.11.114",
                "port" : 162
            } ]
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "snmpNotificationEnabled" : {
                "description" : "Enable SNMP Notifications Globally (If SNMP Notification is disabled globally, no Notification message is sent out.)",
                "type" : "boolean"
            },
            "snmpV2Agent" : {
                "description" : "Community List of the SNMP V2 Agent.",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "communityName" : {
                            "description" : "name of the SNMP Community.",
                            "type" : "string"
                        },
                        "readEnabled" : {
                            "description" : "read privilege of the SNMP Coummunity",
                            "type" : "boolean"
                        },
                        "writeEnabled" : {
                            "description" : "write privilege of the SNMP Coummunity",
                            "type" : "boolean"
                        },
                        "notificationEnabled" : {
                            "description" : "notification privilege of the SNMP Coummunity",
                            "type" : "boolean"
                        },
                        "notificationType" : {
                            "description" : "type of the notification privilege",
                            "enum" : [ "TRAP", "INFORM" ]
                        },
                        "notificationTarget" : {
                            "description" : "Trap List of the SNMP Coummunity",
                            "type" : "array",
                            "items" : {
                                "type" : "object",
                                "additionalProperties" : false,
                                "properties" : {
                                    "address" : {
                                        "description" : "address of the SNMP Trap",
                                        "type" : "string"
                                    },
                                    "port" : {
                                        "description" : "port number of the SNMP Trap",
                                        "type" : "integer",
                                        "minimum" : 1,
                                        "maximum" : 65535
                                    }
                                },
                                "required" : [ "address", "port" ]
                            }
                        }
                    },
                    "required" : [ "communityName" ]
                }
            },
            "snmpV3Agent" : {
                "description" : "User List of the SNMP V2 Agent.",
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "userName" : {
                            "description" : "name of the SNMP User.",
                            "type" : "string"
                        },
                        "authProtocol" : {
                            "description" : "authProtocol of the SNMP User.",
                            "enum" : [ "MD5", "SHA" ]
                        },
                        "authPassword" : {
                            "description" : "authPassword of the SNMP User.",
                            "type" : "string",
                            "minLength" : 8
                        },
                        "privProtocol" : {
                            "description" : "privProtocol of the SNMP User.",
                            "enum" : [ "DES", "AES" ]
                        },
                        "privPassword" : {
                            "description" : "privPassword of the SNMP User.",
                            "type" : "string",
                            "minLength" : 8
                        },
                        "readEnabled" : {
                            "description" : "read privilege of the SNMP User",
                            "type" : "boolean"
                        },
                        "writeEnabled" : {
                            "description" : "write privilege of the SNMP User",
                            "type" : "boolean"
                        },
                        "notificationEnabled" : {
                            "description" : "notification privilege of the SNMP User",
                            "type" : "boolean"
                        },
                        "notificationType" : {
                            "description" : "type of the notification privilege",
                            "enum" : [ "TRAP", "INFORM" ]
                        },
                        "notificationTarget" : {
                            "description" : "Trap List of the SNMP User",
                            "type" : "array",
                            "items" : {
                                "type" : "object",
                                "additionalProperties" : false,
                                "properties" : {
                                    "address" : {
                                        "description" : "address of the SNMP Trap",
                                        "type" : "string"
                                    },
                                    "port" : {
                                        "description" : "port number of the SNMP Trap",
                                        "type" : "integer",
                                        "minimum" : 1,
                                        "maximum" : 65535
                                    }
                                },
                                "required" : [ "address", "port" ]
                            }
                        }
                    },
                    "required" : [ "userName" ]
                }
            }
        },
        "required" : [ "snmpNotificationEnabled" ]
    }
    
    
  • Response  204

Bridge 

Retrieve List 

/v4_0/profiles/bridge

Use this API command to retrieve a list of Bridge profile.

  • Response  200
  • Body
    {
        "totalCount" : 1,
        "hasMore" : false,
        "firstIndex" : 0,
        "list" : [ {
            "id" : "267ef3a0-738b-11e4-96d5-0a7820524153",
            "name" : "new name"
        } ]
    }
    
    
    Schema
    {
        "type" : "object",
        "additionalProperties" : false,
        "properties" : {
            "totalCount" : {
                "type" : "integer"
            },
            "hasMore" : {
                "type" : "boolean"
            },
            "firstIndex" : {
                "type" : "integer"
            },
            "list" : {
                "type" : "array",
                "items" : {
                    "type" : "object",
                    "additionalProperties" : false,
                    "properties" : {
                        "id" : {
                            "description" : "Identifier of the profile",
                            "type" : "string"
                        },
                        "name" : {
                            "type" : "string",
                            "minLength" : 2,
                            "maxLength" : 32,
                            "pattern" : "^[!-~]([ -~]){0,30}[!-~]$",
                            "description" : "Name of the profile"
                        }
                    }
                }
            }
        }
    }
    
    

Generated by aglio on 07 Jun 2016