ExtremeCloud Appliance :: Platform Manager API (1.15.1)

Download OpenAPI specification:Download

Introduction

The Platform Manager API provides a programmatic interface to access and manage backup files, flash memory, license information, controller logs, network test data, and platform settings. It is based on RESTful principles and uses standard HTTP methods for requests and responses. It uses OAuth 2.0 for authentication and authorization. API request and response bodies are formatted in JavaScript Object Notation (JSON).
Note: To submit API calls, your RESTful API consuming program needs to have logged in using credentials granting at least read permissions, and only user accounts with FullAdmin credentials can make configuration changes through the REST API.

Authentication and Authorization

The Platform Manager REST API uses the OAuth 2.0 protocol to provide secure authorized access to the API. OAuth is an authorization framework that enables web, mobile, and desktop applications to access protected resources. To begin, pass your client login credentials in the Authorization header within a POST request to the management/v1/oauth2/token endpoint. In exchange for these credentials the ExtremeCloud Appliance authorization server issues tokens called bearer tokens that you use for authorization when making subsequent REST API calls.

bearerAuth

Security scheme type: HTTP
HTTP Authorization Scheme bearer

BackupManager

Get names of all backup files stored on the controller

Authorizations:

Responses

200
default

Error message

get /v1/configuration/backupfilelist

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/configuration/backupfilelist

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "backupfile":
    [
    ]
}

Get current schedule for periodic backups

Authorizations:

Responses

200
default

Error message

get /v1/configuration/backupschedule

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/configuration/backupschedule

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "frequency": "weekly",
  • "backupWhat": "configuration",
  • "backupDestination": "flash",
  • "transferMethod": "scp",
  • "remoteFile":
    {
    },
  • "dailyOptions":
    {
    },
  • "weeklyOptions":
    {
    },
  • "monthlyOptions":
    {
    },
  • "startTime": "12-20"
}

Update backup schedule on the controller

Replaces the complete backup schedule on the controller with one that is input, provided that all attributes of the new schedule are valid. If the frequency attribute of the new schedule is none then the rest of the schedule attributes are ignored. If the frequency is set to none any previously set backup schedule is canceled and no new scheduled backups will occur till another schedule is installed.

Authorizations:
Request Body schema: application/json

new schedule to set

frequency
string (BackupFrequencyType)
Enum: "none" "daily" "weekly" "monthly"

Represents an enum data type containing the possible frequencies of configuration backups.

backupWhat
string (BackupTypes)
Enum: "all" "configuration"
backupDestination
string (BackupDestination)
Enum: "none" "local" "remote" "flash"

A list of backup destination setting options (local, remote,..).

transferMethod
string (FileTransferMethod)
Enum: "ftp" "scp" "http"
remoteFile
object (RemoteFile)
dailyOptions
object (DailyScheduleOptions)
weeklyOptions
object (WeeklyScheduleOptions)
monthlyOptions
object (MonthlyScheduleOptions)
startTime
string

The time at which the periodic backup starts each day that it runs. The time is in 24 hour military local time in the form HH-MM. A dash ('-') is used in place of a ':' as the separator between hours and minutes.

Responses

200
default

Error message

put /v1/configuration/backupschedule

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/configuration/backupschedule

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "frequency": "weekly",
  • "backupWhat": "configuration",
  • "backupDestination": "flash",
  • "transferMethod": "scp",
  • "remoteFile":
    {
    },
  • "dailyOptions":
    {
    },
  • "weeklyOptions":
    {
    },
  • "monthlyOptions":
    {
    },
  • "startTime": "12-20"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "frequency": "weekly",
  • "backupWhat": "configuration",
  • "backupDestination": "flash",
  • "transferMethod": "scp",
  • "remoteFile":
    {
    },
  • "dailyOptions":
    {
    },
  • "weeklyOptions":
    {
    },
  • "monthlyOptions":
    {
    },
  • "startTime": "12-20"
}

Create a new backup schedule on the controller

Replaces the complete backup schedule on the controller with one that is input, provided that all attributes of the new schedule are valid. If the frequency attribute of the new schedule is none then the rest of the schedule attributes are ignored. If the frequency is set to none any previously set backup schedule is canceled and no new scheduled backups will occur till another schedule is installed.

Authorizations:
Request Body schema: application/json

new schedule to set

frequency
string (BackupFrequencyType)
Enum: "none" "daily" "weekly" "monthly"

Represents an enum data type containing the possible frequencies of configuration backups.

backupWhat
string (BackupTypes)
Enum: "all" "configuration"
backupDestination
string (BackupDestination)
Enum: "none" "local" "remote" "flash"

A list of backup destination setting options (local, remote,..).

transferMethod
string (FileTransferMethod)
Enum: "ftp" "scp" "http"
remoteFile
object (RemoteFile)
dailyOptions
object (DailyScheduleOptions)
weeklyOptions
object (WeeklyScheduleOptions)
monthlyOptions
object (MonthlyScheduleOptions)
startTime
string

The time at which the periodic backup starts each day that it runs. The time is in 24 hour military local time in the form HH-MM. A dash ('-') is used in place of a ':' as the separator between hours and minutes.

Responses

200
default

Error message

post /v1/configuration/backupschedule

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/configuration/backupschedule

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "frequency": "weekly",
  • "backupWhat": "configuration",
  • "backupDestination": "flash",
  • "transferMethod": "scp",
  • "remoteFile":
    {
    },
  • "dailyOptions":
    {
    },
  • "weeklyOptions":
    {
    },
  • "monthlyOptions":
    {
    },
  • "startTime": "12-20"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "frequency": "weekly",
  • "backupWhat": "configuration",
  • "backupDestination": "flash",
  • "transferMethod": "scp",
  • "remoteFile":
    {
    },
  • "dailyOptions":
    {
    },
  • "weeklyOptions":
    {
    },
  • "monthlyOptions":
    {
    },
  • "startTime": "12-20"
}

Create a new configuration backup file

Authorizations:
Request Body schema: application/json

The identifier backup represents backup operations(what to backup & destination)

backupWhat
string (BackupTypes)
Enum: "all" "configuration"
backupDestination
string (LocalDestination)
Enum: "local" "flash"

Responses

200
default

Error message

put /v1/configuration/createbackup

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/configuration/createbackup

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "backupWhat": "configuration",
  • "backupDestination": "local"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Upload a configuration backup file

Authorizations:
Request Body schema: multipart/form-data
fileInputStream
string <binary>

Input stream

fileMetaData
string <binary>

Input file meta data (see Usage) Usage: curl -k -i -X POST -H 'Authorization: Bearer 6359d9d3c431157983d13b4edbca6026' -H "Content-Type: multipart/form-data" -F "file=@V2110-smoke.01032018.121518.zip" https://192.168.3.62:5825/platformmanager/v1/configuration/fileupload

body
string <binary>

Responses

200
default

Error message

post /v1/configuration/fileupload

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/configuration/fileupload

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Download backup file via HTTP

If the identified backup file exists, the file (in .zip format) is transferred back to the requestor with appropriate HTTP headers and mime type. If not, a standard 404 type error is returned.

Authorizations:
path Parameters
id
required
string

Name of the backup file to download via HTTP.

Responses

200
default

Error message

put /v1/configuration/backupfile/{id}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/configuration/backupfile/{id}

Response samples

Content type
application/json
Copy
Expand all Collapse all
null

Delete backup file

Deletes the backup file the name of which was passed in as a parameter. The delete occurs in line and the method does not return till the delete operation completes. The method returns true if the deletion succeeded and false for any other reason.

Authorizations:
path Parameters
id
required
string

The identifier number for the backup file to be deleted

Responses

200
default

Error message

delete /v1/configuration/backupfile/{id}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/configuration/backupfile/{id}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Copy backup file to remote server

Copies a backup file on the controller to a server elsewhere in the network. This method returns immediately even if it succeeds. The file transfer takes place in the background.

Authorizations:
path Parameters
protocol
required
string

Only FTP and SCP are supported.

Request Body schema: application/json

The details to use when transferring the file. The remoteFile.fileName attribute must match the name of a backup file stored locally on the controller at the time the command is issued.

serverIP
string

The IPv4 address of the server that is storing or going to store the subject file. It cannot be null.

userid
string

The user ID to authenticate with the file server. It cannot be null.

password
string

The password to authenticate with the file server. It cannot be null.

directory
string

The path on the server of the directory in which the subject file resides or is to be stored. It cannot be null but could be '/'

fileName
string

The name of the file that is to be pulled from or pushed to the file server. It cannot be null, a zero length string or begin or end with blanks.

localDestination
string (LocalDestination)
Enum: "local" "flash"

Responses

200
default

Error message

put /v1/configuration/copybackupto/{protocol}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/configuration/copybackupto/{protocol}

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "serverIP": "8.8.8.8",
  • "userid": "Admin",
  • "password": "abc123",
  • "directory": "/",
  • "fileName": "example.txt",
  • "localDestination": "local"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Transfer backup file to remote server

Copies a backup file on the controller to a server elsewhere in the network. This method returns immediately even if it succeeds. The file transfer takes place in the background.

Authorizations:
path Parameters
protocol
required
string

Only FTP and SCP are supported.

Request Body schema: application/json

The details to use when transferring the file. The remoteFile.fileName attribute must match the name of a backup file stored locally on the controller at the time the command is issued.

serverIP
string

The IPv4 address of the server that is storing or going to store the subject file. It cannot be null.

userid
string

The user ID to authenticate with the file server. It cannot be null.

password
string

The password to authenticate with the file server. It cannot be null.

directory
string

The path on the server of the directory in which the subject file resides or is to be stored. It cannot be null but could be '/'

fileName
string

The name of the file that is to be pulled from or pushed to the file server. It cannot be null, a zero length string or begin or end with blanks.

localDestination
string (LocalDestination)
Enum: "local" "flash"

Responses

200
default

Error message

post /v1/configuration/copybackupto/{protocol}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/configuration/copybackupto/{protocol}

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "serverIP": "8.8.8.8",
  • "userid": "Admin",
  • "password": "abc123",
  • "directory": "/",
  • "fileName": "example.txt",
  • "localDestination": "local"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Copy backup file from remote server to controller

This method is the inverse of copyBackupTo. It copies a file (assumed to be a controller backup) from a mounted USB flash drive or a remote FTP or SCP file server. The file is not restored. It is simply copied to the controller. Returns true if the input parameters are valid and false otherwise. The copy can take time so the method does not wait for the copy to complete before returning.

Authorizations:
path Parameters
protocol
required
string

Only FTP and SCP are supported.

Request Body schema: application/json

The attributes necessary to pull the desired backup file from a file server.

serverIP
string

The IPv4 address of the server that is storing or going to store the subject file. It cannot be null.

userid
string

The user ID to authenticate with the file server. It cannot be null.

password
string

The password to authenticate with the file server. It cannot be null.

directory
string

The path on the server of the directory in which the subject file resides or is to be stored. It cannot be null but could be '/'

fileName
string

The name of the file that is to be pulled from or pushed to the file server. It cannot be null, a zero length string or begin or end with blanks.

localDestination
string (LocalDestination)
Enum: "local" "flash"

Responses

200
default

Error message

put /v1/configuration/copyrestorefrom/{protocol}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/configuration/copyrestorefrom/{protocol}

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "serverIP": "8.8.8.8",
  • "userid": "Admin",
  • "password": "abc123",
  • "directory": "/",
  • "fileName": "example.txt",
  • "localDestination": "local"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Transfer backup file from remote server to controller

This method is the inverse of copyBackupTo. It copies a file (assumed to be a controller backup) from a mounted USB flash drive or a remote FTP or SCP file server. The file is not restored. It is simply copied to the controller. Returns true if the input parameters are valid and false otherwise. The copy can take time so the method does not wait for the copy to complete before returning.

Authorizations:
path Parameters
protocol
required
string

Only FTP and SCP are supported.

Request Body schema: application/json

The attributes necessary to pull the desired backup file from a file server.

serverIP
string

The IPv4 address of the server that is storing or going to store the subject file. It cannot be null.

userid
string

The user ID to authenticate with the file server. It cannot be null.

password
string

The password to authenticate with the file server. It cannot be null.

directory
string

The path on the server of the directory in which the subject file resides or is to be stored. It cannot be null but could be '/'

fileName
string

The name of the file that is to be pulled from or pushed to the file server. It cannot be null, a zero length string or begin or end with blanks.

localDestination
string (LocalDestination)
Enum: "local" "flash"

Responses

200
default

Error message

post /v1/configuration/copyrestorefrom/{protocol}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/configuration/copyrestorefrom/{protocol}

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "serverIP": "8.8.8.8",
  • "userid": "Admin",
  • "password": "abc123",
  • "directory": "/",
  • "fileName": "example.txt",
  • "localDestination": "local"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Pre-check configuration of backup file

A method to pre-check upload of a configuration backup file for errors. A configuration backup file (upto 10 files allowed) or backup file extension "*.zip". Usage: curl -k -H "Authorization: Bearer 5637242c9e3f9b7a7b4847a35a4afad9" -X GET https://192.168.3.62:5825/platformmanager/v1/configuration/prefileupload/"V2110-smoke.01032018.121518.zip"

Authorizations:
path Parameters
filename
required
string

Responses

200
default

Error message

get /v1/configuration/prefileupload/{filename}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/configuration/prefileupload/{filename}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Restore contents of backup file

Restores the contents of the identified backup file into the filesystem. Returns true if the restore was started and false otherwise. The restore can take time so the method does not wait for the restore to complete before returning.

Authorizations:
path Parameters
id
required
string

Identifier for the backup file to be restored. File must be on the controller at the time this command is issued.

Responses

200
default

Error message

put /v1/configuration/restorefile/{id}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/configuration/restorefile/{id}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

FlashMemoryMgr

Mount USB flash drive

A command that causes the controller to mount a USB flash memory drive that has been plugged into the controller. The controller does not auto-mount USB flash drives so this method must be called before trying to use the USB drive with the controller. The method should not return till the mount operation completes.

Authorizations:

Responses

204
default

Error message

put /v1/flashmemory/mount

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/flashmemory/mount

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Get USB flash memory information

Authorizations:

Responses

200
default

Error message

get /v1/flashmemory/status

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/flashmemory/status

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "status": "mounted",
  • "totalMemory": "...",
  • "usedMemory": "...",
  • "freeMemory": "...",
  • "availableFiles":
    [
    ]
}

Unmount USB flash drive

This method unmounts a USB key (memory stick) that is mounted on the controller. The USB key should be unmounted manually before removing it from the controller's USB socket. The method always returns success, even when no USB key is mounted. The method does not return till the unmount operation completes.

Authorizations:

Responses

204
default

Error message

put /v1/flashmemory/unmount

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/flashmemory/unmount

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Delete file from the mounted flash drive

A command that causes the controller to delete a file from the mounted flash drive. Returns OK if the file was deleted or an error. The method returns 404 if the file is not in the root directory of the flash drive or a flash drive is not mounted.

Authorizations:
path Parameters
id
required
string

The name of the file to be deleted from the USB key.

Responses

204
default

Error message

delete /v1/flashmemory/delete/{id}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/flashmemory/delete/{id}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

LicenseMgr

Get controller license info

Authorizations:

Responses

200

License summary information.

default

Error message

get /v1/license

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/license

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "licenseType": "Permanent",
  • "regulatoryDomain": "World Wide",
  • "lockingId": "1833E-CE157",
  • "maxClients": 1000,
  • "maxAps": 50,
  • "licensedAps": 50,
  • "expireDate": 2398885071000,
  • "violationReason": "",
  • "maxSwitches": 50,
  • "licensedDevices": 50,
  • "availableDevices": 44,
  • "activeAps": 5,
  • "activeSwitches": 1,
  • "pkiInstalledFrom": 0,
  • "pkiVerified": 0,
  • "blockEditing": false
}

Install activation key

Authorizations:
Request Body schema: application/json

license key to be install

key
string
type
number
optionKeys
Array of objects (KeyElement)

Responses

200
default

Error message

put /v1/license

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/license

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "key": "...",
  • "type": 12345,
  • "optionKeys":
    [
    ]
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Get controller license file

Authorizations:

Responses

200
default

Error message

get /v3/license/file

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v3/license/file

Response samples

Content type
application/json
Copy
Expand all Collapse all
null

Upload license lock file

Authorizations:
Request Body schema: application/json

license file info

file
string
data
string

Responses

200
default

Error message

post /v3/license/file

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v3/license/file

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "file": "...",
  • "data": "..."
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Decode license capacity

Authorizations:
Request Body schema: application/json

list of encoded licenses string

lic
Array of strings

Responses

200
default

failure message

put /v3/license/decode

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v3/license/decode

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "lic":
    [
    ]
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "lic":
    [
    ]
}

LogConfiguration

Get controller access point logs

A method to get controller's aps log. example : curl -X GET 'https://192.168.3.62:5825/platformmanager/v1/logging/aps'

Authorizations:
query Parameters
endTime
number >= 1

End time in milliseconds

startTime
number >= 1

Start time in milliseconds

Responses

200
default

Error message

get /v1/logging/aps

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/logging/aps

Response samples

Content type
application/json
Copy
Expand all Collapse all
null

Get controller events log

Authorizations:
query Parameters
endTime
number >= 1

End time in milliseconds

startTime
number >= 1

Start time in milliseconds

Responses

200
default

Error message

get /v1/logging/events

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/logging/events

Response samples

Content type
application/json
Copy
Expand all Collapse all
"string"

Get controller stations log

Authorizations:
query Parameters
endTime
number >= 1

End time in milliseconds

startTime
number >= 1

Start time in milliseconds

Responses

200
default

Error message

get /v1/logging/stations

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/logging/stations

Response samples

Content type
application/json
Copy
Expand all Collapse all
null

Get controller syslog settings

Authorizations:

Responses

200

Success message if set works, otherwise a failure code.

default

Error message

get /v1/logging/syslog

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/logging/syslog

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "syslogConfiguration":
    {
    },
  • "incVarLog": true,
  • "incAuditLog": true,
  • "incStationEvent": true,
  • "syslogAuditFacility": "local6",
  • "syslogStationEventFacility": "local6",
  • "syslogMsgFacility": "local4",
  • "syslogEventFacility": "local6",
  • "custId": "...",
  • "id": "..."
}

Update syslog configuration

Authorizations:
Request Body schema: application/json
custId
string
id
string
syslogConfiguration
object (SyslogConfigurationElement)

This POJO represents the switch level configuration with a collection of destination IP addresses of the servers and UDP ports.

incVarLog
boolean

Allows user to set radio mode to Off, or enable a combination of protocols. Mode options will depend on AP model and radios band. For radio1: a/n/ac == 84, ac-strict == 132. For radio2: b/g == 3, g/n == 18, b/g/n == 19, n-strict == 32
Validations : Not null, non-empty and a valid RadioMode value as string.

incAuditLog
boolean
incStationEvent
boolean
syslogAuditFacility
string (FacilityLogsLevelElement)
Enum: "local0" "local1" "local2" "local3" "local4" "local5" "local6"

A list of log levels used in facility logging.

syslogStationEventFacility
string (FacilityLogsLevelElement)
Enum: "local0" "local1" "local2" "local3" "local4" "local5" "local6"

A list of log levels used in facility logging.

syslogMsgFacility
string (FacilityLogsLevelElement)
Enum: "local0" "local1" "local2" "local3" "local4" "local5" "local6"

A list of log levels used in facility logging.

syslogEventFacility
string (FacilityLogsLevelElement)
Enum: "local0" "local1" "local2" "local3" "local4" "local5" "local6"

A list of log levels used in facility logging.

Responses

200
default

Error message

put /v1/logging/syslog

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/logging/syslog

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "syslogConfiguration":
    {
    },
  • "incVarLog": true,
  • "incAuditLog": true,
  • "incStationEvent": true,
  • "syslogAuditFacility": "local6",
  • "syslogStationEventFacility": "local6",
  • "syslogMsgFacility": "local4",
  • "syslogEventFacility": "local6",
  • "custId": "...",
  • "id": "..."
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "syslogConfiguration":
    {
    },
  • "incVarLog": true,
  • "incAuditLog": true,
  • "incStationEvent": true,
  • "syslogAuditFacility": "local6",
  • "syslogStationEventFacility": "local6",
  • "syslogMsgFacility": "local4",
  • "syslogEventFacility": "local6",
  • "custId": "...",
  • "id": "..."
}

Get current log configuration

Authorizations:

Responses

200
default

Error message

get /v1/logging/systemloglevel

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/logging/systemloglevel

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "logLevel": "major",
  • "sendStationEventTrap": true
}

Update controller sever log level

configure the controller's severe log level that you want to receive. the log levels are Information, Minor, Major, Critical. For example, if you select Minor, you receive all Minor, Major and Critical messages. If you select Major you receive all Major and Critical messages. The default is Minor. If set reportStationEvents to true, controller will collect and display station session events on the controller station events log.

Authorizations:
Request Body schema: application/json
logLevel
string (SystemlogLogging)
Enum: "critical" "major" "minor" "info"
sendStationEventTrap
boolean

Responses

200
default

Error message

put /v1/logging/systemloglevel

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/logging/systemloglevel

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "logLevel": "major",
  • "sendStationEventTrap": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "logLevel": "major",
  • "sendStationEventTrap": true
}

NetworkTestMgr

Get available flash size

Authorizations:

Responses

200
default

Error message

get /v1/network/test/availableflashsize

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/network/test/availableflashsize

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Update ping test configuration details

The ping test is run in line and the results are streamed back as they are received. Sometimes this can result in the entire ping session being returned in one file.

Authorizations:
Request Body schema: application/json

An object containing the details that control this particular run of the ping test. ping source-interface name Admin 192.168.3.48

targetIPAddress
string

The IP address to be tested for connectivity with the controller.

specificInterface
boolean

Indicates whether the test is to be performed using a specific interface or topology defined on the controller. If true, then the topology attribute must be set to the name of a topology or interface defined on the controller and the controller will only test for reachability from that interface. If set to false, the controller will pick the interface/topology to use for testing based on internal routing rules.

sourceInterface
string

Represents the controller interface/topology from which the connectivity test will be conducted. Can be null if specificInterface is set to false. If specificInterface is set to true, sourceInterface must be between 1 and 63 characters long, and not contain invalid characters. Valid values: 'Admin' or any of the physical interfaces name

Responses

200
default

Error message

put /v1/network/test/ping

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/network/test/ping

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "targetIPAddress": "172.16.65.1",
  • "specificInterface": true,
  • "sourceInterface": "Admin"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Update ping test attributes

The ping test is run in line and the results are streamed back as they are received. Sometimes this can result in the entire ping session being returned in one file.

Authorizations:
Request Body schema: application/json

An object containing the details that control this particular run of the ping test.

targetIPAddress
string

The IP address to be tested for connectivity with the controller.

specificInterface
boolean

Indicates whether the test is to be performed using a specific interface or topology defined on the controller. If true, then the topology attribute must be set to the name of a topology or interface defined on the controller and the controller will only test for reachability from that interface. If set to false, the controller will pick the interface/topology to use for testing based on internal routing rules.

sourceInterface
string

Represents the controller interface/topology from which the connectivity test will be conducted. Can be null if specificInterface is set to false. If specificInterface is set to true, sourceInterface must be between 1 and 63 characters long, and not contain invalid characters. Valid values: 'Admin' or any of the physical interfaces name

Responses

200
default

Error message

post /v1/network/test/ping

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/network/test/ping

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "targetIPAddress": "172.16.65.1",
  • "specificInterface": true,
  • "sourceInterface": "Admin"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Start TCP dump operation

Starts a tcpdump operation. Attempts to download the dump file will fail until the test is completed or stopped manually. The dump proceeds in the background till it times out or is stopped. Once the dump completes the tcpdump capture file can be downloaded by calling getTcpDumpFile.

Authorizations:
Request Body schema: application/json
sourceInterface
string
captureFileName
string
captureFileMaxMegabytes
number
destination
string (LocalDestination)
Enum: "local" "flash"

Responses

200
default

Error message

put /v1/network/test/tcpdump

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/network/test/tcpdump

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "sourceInterface": "...",
  • "captureFileName": "...",
  • "captureFileMaxMegabytes": 12345,
  • "destination": "flash"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "sourceInterface": "...",
  • "captureFileName": "...",
  • "captureFileMaxMegabytes": 12345,
  • "destination": "flash"
}

Start TCP dump operation

Starts a tcpdump operation. Attempts to download the dump file will fail until the test is completed or stopped manually. The dump proceeds in the background till it times out or is stopped. Once the dump completes the tcpdump capture file can be downloaded by calling getTcpDumpFile.

Authorizations:
Request Body schema: application/json
sourceInterface
string
captureFileName
string
captureFileMaxMegabytes
number
destination
string (LocalDestination)
Enum: "local" "flash"

Responses

200
default

Error message

post /v1/network/test/tcpdump

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/network/test/tcpdump

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "sourceInterface": "...",
  • "captureFileName": "...",
  • "captureFileMaxMegabytes": 12345,
  • "destination": "flash"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "sourceInterface": "...",
  • "captureFileName": "...",
  • "captureFileMaxMegabytes": 12345,
  • "destination": "flash"
}

Get list of all TCP dump files

Returns a list of all the tcpdump files stored on the controller. The filenames can be used to retrieve or delete individual files.

Authorizations:

Responses

200
default

Error message

get /v1/network/test/tcpdumpfiles

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/network/test/tcpdumpfiles

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "captureFile":
    [
    ]
}

Update traceroute attributes

Traceroute is run inline and the results are streamed back as they are received. Sometimes this can result in the entire traceroute session being returned in one file. This can take a noticeable period of time (10-20 seconds), so a progress indicator may be useful in a UI.

Authorizations:
Request Body schema: application/json

An object containing the attributes that will control the requested run of traceroute.

targetIPAddress
string

The IP address to be tested for connectivity with the controller.

specificInterface
boolean

Indicates whether the test is to be performed using a specific interface or topology defined on the controller. If true, then the topology attribute must be set to the name of a topology or interface defined on the controller and the controller will only test for reachability from that interface. If set to false, the controller will pick the interface/topology to use for testing based on internal routing rules.

sourceInterface
string

Represents the controller interface/topology from which the connectivity test will be conducted. Can be null if specificInterface is set to false. If specificInterface is set to true, sourceInterface must be between 1 and 63 characters long, and not contain invalid characters. Valid values: 'Admin' or any of the physical interfaces name

Responses

200
default

Error message

put /v1/network/test/traceroute

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/network/test/traceroute

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "targetIPAddress": "172.16.65.1",
  • "specificInterface": true,
  • "sourceInterface": "Admin"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Configure traceroute attributes

Traceroute is run inline and the results are streamed back as they are received. Sometimes this can result in the entire traceroute session being returned in one file. This can take a noticeable period of time (10-20 seconds), so a progress indicator may be useful in a UI.

Authorizations:
Request Body schema: application/json

An object containing the attributes that will control the requested run of traceroute.

targetIPAddress
string

The IP address to be tested for connectivity with the controller.

specificInterface
boolean

Indicates whether the test is to be performed using a specific interface or topology defined on the controller. If true, then the topology attribute must be set to the name of a topology or interface defined on the controller and the controller will only test for reachability from that interface. If set to false, the controller will pick the interface/topology to use for testing based on internal routing rules.

sourceInterface
string

Represents the controller interface/topology from which the connectivity test will be conducted. Can be null if specificInterface is set to false. If specificInterface is set to true, sourceInterface must be between 1 and 63 characters long, and not contain invalid characters. Valid values: 'Admin' or any of the physical interfaces name

Responses

200
default

Error message

post /v1/network/test/traceroute

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/network/test/traceroute

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "targetIPAddress": "172.16.65.1",
  • "specificInterface": true,
  • "sourceInterface": "Admin"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Get current status of the TCP dump process

Authorizations:

Responses

200
default

Error message

get /v1/network/test/tcpdump/status

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/network/test/tcpdump/status

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "availableSpaceOnFlashInMegaBytes": 0,
  • "availableSpaceOnLocalInMegaBytes": 100,
  • "running": true
}

Stop TCP dump operation

Stops any tcpdump operation in progress on the controller. To keep things simple this returns success whether a tcpdump is in progress or not.

Authorizations:

Responses

200
default

Error message

put /v1/network/test/tcpdump/stop

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/network/test/tcpdump/stop

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Get TCP dump capture file

A method that allows the caller to download the named tcpdump capture file to his location.

Authorizations:
path Parameters
id
required
string

Name of the tcpdump capture file to retrieve from the controller.

Responses

200
default

Error message

get /v1/network/test/tcpdumpfile/{id}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/network/test/tcpdumpfile/{id}

Response samples

Content type
application/json
Copy
Expand all Collapse all
null

Delete TCP dump file

Delete the named TCP Dump File. Returns 404 if the named file does not exist on the controller. i.e. curl -H "Content-Type: " -X DELETE
https://192.168.3.62:5825 /platformmanager/v1/network/test/tcpdumpfile/"mgmt_traffic_blah1.cap(flash)"

Authorizations:
path Parameters
id
required
string

The name of the tcpdump capture file to delete from controller storage.

Responses

200
default

Error message

delete /v1/network/test/tcpdumpfile/{id}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/network/test/tcpdumpfile/{id}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Platform

Get MAC address format for user authentication

Authorizations:

Responses

200

the current mac address format setting

default

Error message

get /v1/macformat

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/macformat

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "macAddressFormat": "UPPERCASE_NO_DELIMITERS"
}

Update MAC Address format for user authentication

Authorizations:
Request Body schema: application/json
macAddressFormat
string (MacFormat)
Default: "UPPERCASE_NO_DELIMITERS"
Enum: "UPPERCASE_NO_DELIMITERS" "UPPERCASE_COLON_PER2X" "UPPERCASE_HYPHEN_PER2X" "UPPERCASE_DOT_PER4X" "UPPERCASE_HYPHEN_PER6X" "UPPERCASE_SPACE_PER2X" "LOWERCASE_NO_DELIMITERS" "LOWERCASE_COLON_PER2X" "LOWERCASE_HYPHEN_PER2X" "LOWERCASE_DOT_PER4X" "LOWERCASE_HYPHEN_PER6X" "LOWERCASE_SPACE_PER2X"

Responses

200
default

Error message

put /v1/macformat

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/macformat

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "macAddressFormat": "UPPERCASE_NO_DELIMITERS"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "macAddressFormat": "UPPERCASE_NO_DELIMITERS"
}

Get admin interface setting

Authorizations:

Responses

200

the administration interface's setting.

default

Error message

get /v1/admin

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/admin

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "name": "Admin",
  • "mode": "Management",
  • "ipAddress": "10.41.0.1",
  • "cidr": 24,
  • "mtu": 1500,
  • "cert": 0,
  • "certCa": 0,
  • "custId": "...",
  • "id": "..."
}

Set admin interface attributes

Authorizations:
Request Body schema: application/json
custId
string
id
string
name
string

Represents the unique name of the Administrator Interface. This property cannot be modified.

mode
string (ModesAdminInterface)
Enum: "Routed" "BridgedAtAp" "BridgedAtAc" "ThirdPartyAP" "Physical" "Management" "FabricAttach"
ipAddress
string

Represents a valid IP Address of the Management Interface.

cidr
number

Net Mask
Validations : 9 to 30!

mtu
number

Represents the MTU size, only 1500 size is supported

cert
number

Represents a boolean value to indicate if a custom certificate is installed: 0 or 1

certCa
number

Represents a boolean value to indicate if a custom CA certificate is installed: 0 or 1

Responses

204
default

Error message

put /v1/admin

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/admin

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "name": "Admin",
  • "mode": "Management",
  • "ipAddress": "10.41.0.1",
  • "cidr": 24,
  • "mtu": 1500,
  • "cert": 0,
  • "certCa": 0,
  • "custId": "...",
  • "id": "..."
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "name": "Admin",
  • "mode": "Management",
  • "ipAddress": "10.41.0.1",
  • "cidr": 24,
  • "mtu": 1500,
  • "cert": 0,
  • "certCa": 0,
  • "custId": "...",
  • "id": "..."
}

Get packet capture file list Deprecated

Authorizations:

Responses

200
default

Error message

get /v1/appacketcapturefiles

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/appacketcapturefiles

Response samples

Content type
application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get packet capture status Deprecated

Authorizations:

Responses

200
default

Error message

get /v1/appacketcapturestatus

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/appacketcapturestatus

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "pktCaptureStatus": "Inactive"
}

Get packet capture status Deprecated

Authorizations:

Responses

200
default

Error message

get /v2/appacketcapturestatus

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v2/appacketcapturestatus

Response samples

Content type
application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get packet capture name mapped to ID Deprecated

Authorizations:

Responses

200

Map with packet capture name and corresponding ID

default

Error response

get /v2/appacketcapture/nametoidmap

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v2/appacketcapture/nametoidmap

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "property1": "string",
  • "property2": "string"
}

Get controller's availability settings

Authorizations:

Responses

200
default

Error message

get /v1/availability

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/availability

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "availabilityEnabled": true,
  • "availabilityRole": "PRIMARY",
  • "availabilityPairAddr": "172.16.63.1"
}

Update controller's availability settings

Authorizations:
Request Body schema: application/json
availabilityEnabled
boolean
availabilityRole
string (AvailabilityRole)
Enum: "PRIMARY" "BACKUP"
availabilityPairAddr
string

The IP address of the Peer EAE.

Responses

200
default

Error message

put /v1/availability

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/availability

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "availabilityEnabled": true,
  • "availabilityRole": "PRIMARY",
  • "availabilityPairAddr": "172.16.63.1"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "availabilityEnabled": true,
  • "availabilityRole": "PRIMARY",
  • "availabilityPairAddr": "172.16.63.1"
}

Get current access point packet capture settings Deprecated

Authorizations:

Responses

200

the current packet capture setting

default

Error message

get /v1/currentappacketcapturesetting

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/currentappacketcapturesetting

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "apSerialNumber": "...",
  • "siteId": "...",
  • "maxPktCount": 12345,
  • "duration": 12345,
  • "filter":
    {
    },
  • "captureIf":
    {
    },
  • "custId": "...",
  • "id": "...",
  • "canDelete": true,
  • "canEdit": true
}

Get current access point packet capture settings Deprecated

Authorizations:
query Parameters
ids
string <uuid>

The list of ids if not provided all current capture status will be returned.

Responses

200

the current packet capture setting

default

Error message

get /v2/currentappacketcapturesetting

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v2/currentappacketcapturesetting

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "apSerialNumber": "...",
  • "siteId": "...",
  • "maxPktCount": 12345,
  • "duration": 12345,
  • "filter":
    {
    },
  • "captureIf":
    {
    },
  • "custId": "...",
  • "id": "...",
  • "canDelete": true,
  • "canEdit": true
}

Get guest portal session timeout settings

Authorizations:

Responses

200
default

Error message

get /v1/guestportalsessiontimeout

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/guestportalsessiontimeout

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "hour": 1,
  • "minute": 0
}

Update guest portal session timeout settings

Authorizations:
Request Body schema: application/json
hour
number
minute
number

Responses

200
default

Error message

put /v1/guestportalsessiontimeout

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/guestportalsessiontimeout

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "hour": 1,
  • "minute": 0
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "hour": 1,
  • "minute": 0
}

Get controller host attributes

Returns an object containing the controller's view of its Host Name, Domain Name and the DNS servers it can use.

Authorizations:

Responses

200
default

Error message

get /v1/hostattributes

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/hostattributes

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "hostName": "EAE",
  • "domainName": "extremenetworks.com",
  • "dnsServers":
    [
    ]
}

Update controller host attributes

Sets an object containing the controller's view of its Host Name, Domain Name and the DNS servers it can use.

Authorizations:
Request Body schema: application/json

An object that contains the domain name, host name and list of DNS servers that are assigned to the controller.

hostName
string
domainName
string
dnsServers
Array of strings

Responses

200
default

Error message

put /v1/hostattributes

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/hostattributes

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "hostName": "EAE",
  • "domainName": "extremenetworks.com",
  • "dnsServers":
    [
    ]
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "hostName": "EAE",
  • "domainName": "extremenetworks.com",
  • "dnsServers":
    [
    ]
}

Configure controller host attributes

Sets an object containing the controller's view of its Host Name, Domain Name and the DNS servers it can use.

Authorizations:
Request Body schema: application/json

An object that contains the domain name, host name and list of DNS servers that are assigned to the controller.

hostName
string
domainName
string
dnsServers
Array of strings

Responses

200
default

Error message

post /v1/hostattributes

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/hostattributes

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "hostName": "EAE",
  • "domainName": "extremenetworks.com",
  • "dnsServers":
    [
    ]
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "hostName": "EAE",
  • "domainName": "extremenetworks.com",
  • "dnsServers":
    [
    ]
}

Update controller topology attributes

Authorizations:
Request Body schema: application/json
custId
string
id
string
name
string

The user assigned identifier for the physical topology. For release 1.0 the interfaces cannot be renamed, but that ability will be added in a future release.

mode
string (Modes)
Enum: "Routed" "BridgedAtAp" "BridgedAtAc" "ThirdPartyAP" "Physical" "Management" "FabricAttach"
vlanId
number

The VLAN ID. This attribute is mandatory and must be unique across all physical topologies on the controller. However the actual values don't matter so long as VLAN traffic is untagged. Note that 4094 is reserved for internal use by the controller.

tagged
boolean

Indicates whether the port should include an 802.1Q tag containing the VLAN ID associated with the physical port.

port
number

The port to which the described physical interface is mapped.

allowManagementTraffic
boolean

A boolean that indicates whether management traffic (e.g. ssh, HTTPS) is allowed through this topology to the controller's management applications. This defaults to true for the NSE and false for the Wireless Controller.

apRegistration
boolean

A boolean that indicates whether AP registration is allowed through this interface to the controller.

mtu
number

The maximum transmission unit (MTU) on the interface. This attribute is read-only.

layer3
boolean
ipAddress
string

The IPv4 address of the controller on this interface(topology).

cidr
number

The IPv4 CIDR (Classless Inter-Domain Routing).

dhcpMode
string (DhcpMode)
Enum: "DHCPNone" "DHCPRelay" "DHCPLocal"
localDhcp
object (DhcpLocalServerElement)

This class defines a local DHCP server.

dhcpServers
string
cert
number
certCa
number
fqdn
string

Responses

200
default

Error message

put /v1/interface

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/interface

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "name": "...",
  • "mode": "BridgedAtAp",
  • "vlanId": 1027,
  • "tagged": true,
  • "port": 0,
  • "allowManagementTraffic": true,
  • "apRegistration": true,
  • "mtu": 1500,
  • "layer3": true,
  • "ipAddress": "172.16.63.1",
  • "cidr": 24,
  • "dhcpMode": "DHCPRelay",
  • "localDhcp":
    {
    },
  • "dhcpServers": "...",
  • "cert": 12345,
  • "certCa": 12345,
  • "fqdn": "...",
  • "custId": "...",
  • "id": "..."
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "name": "...",
  • "mode": "BridgedAtAp",
  • "vlanId": 1027,
  • "tagged": true,
  • "port": 0,
  • "allowManagementTraffic": true,
  • "apRegistration": true,
  • "mtu": 1500,
  • "layer3": true,
  • "ipAddress": "172.16.63.1",
  • "cidr": 24,
  • "dhcpMode": "DHCPRelay",
  • "localDhcp":
    {
    },
  • "dhcpServers": "...",
  • "cert": 12345,
  • "certCa": 12345,
  • "fqdn": "...",
  • "custId": "...",
  • "id": "..."
}

Configure controller topology attributes

Authorizations:
Request Body schema: application/json
custId
string
id
string
name
string

The user assigned identifier for the physical topology. For release 1.0 the interfaces cannot be renamed, but that ability will be added in a future release.

mode
string (Modes)
Enum: "Routed" "BridgedAtAp" "BridgedAtAc" "ThirdPartyAP" "Physical" "Management" "FabricAttach"
vlanId
number

The VLAN ID. This attribute is mandatory and must be unique across all physical topologies on the controller. However the actual values don't matter so long as VLAN traffic is untagged. Note that 4094 is reserved for internal use by the controller.

tagged
boolean

Indicates whether the port should include an 802.1Q tag containing the VLAN ID associated with the physical port.

port
number

The port to which the described physical interface is mapped.

allowManagementTraffic
boolean

A boolean that indicates whether management traffic (e.g. ssh, HTTPS) is allowed through this topology to the controller's management applications. This defaults to true for the NSE and false for the Wireless Controller.

apRegistration
boolean

A boolean that indicates whether AP registration is allowed through this interface to the controller.

mtu
number

The maximum transmission unit (MTU) on the interface. This attribute is read-only.

layer3
boolean
ipAddress
string

The IPv4 address of the controller on this interface(topology).

cidr
number

The IPv4 CIDR (Classless Inter-Domain Routing).

dhcpMode
string (DhcpMode)
Enum: "DHCPNone" "DHCPRelay" "DHCPLocal"
localDhcp
object (DhcpLocalServerElement)

This class defines a local DHCP server.

dhcpServers
string
cert
number
certCa
number
fqdn
string

Responses

200
default

Error message

post /v1/interface

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/interface

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "name": "...",
  • "mode": "BridgedAtAp",
  • "vlanId": 1027,
  • "tagged": true,
  • "port": 0,
  • "allowManagementTraffic": true,
  • "apRegistration": true,
  • "mtu": 1500,
  • "layer3": true,
  • "ipAddress": "172.16.63.1",
  • "cidr": 24,
  • "dhcpMode": "DHCPRelay",
  • "localDhcp":
    {
    },
  • "dhcpServers": "...",
  • "cert": 12345,
  • "certCa": 12345,
  • "fqdn": "...",
  • "custId": "...",
  • "id": "..."
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "name": "...",
  • "mode": "BridgedAtAp",
  • "vlanId": 1027,
  • "tagged": true,
  • "port": 0,
  • "allowManagementTraffic": true,
  • "apRegistration": true,
  • "mtu": 1500,
  • "layer3": true,
  • "ipAddress": "172.16.63.1",
  • "cidr": 24,
  • "dhcpMode": "DHCPRelay",
  • "localDhcp":
    {
    },
  • "dhcpServers": "...",
  • "cert": 12345,
  • "certCa": 12345,
  • "fqdn": "...",
  • "custId": "...",
  • "id": "..."
}

Get list of physical interfaces on the controller

Authorizations:

Responses

200

A list containing the administration interface and the two data plane interfaces.

default

Error message

get /v1/interfaces

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/interfaces

Response samples

Content type
application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get current location settings

Authorizations:

Responses

200
default

Error message

get /v1/location

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/location

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "enable": true,
  • "apHeight": 300,
  • "defaultEnvironment": "interiorWalls",
  • "autoCollection": "none",
  • "areaNotification": true,
  • "onDemandUsers":
    {
    }
}

Set current location settings

Authorizations:
Request Body schema: application/json
enable
boolean
apHeight
number
defaultEnvironment
string (LocationEnvironmentModelType)
Enum: "openSpace" "lightDivisions" "dryWalls" "hardDivisions" "interiorWalls"

A list of the types of physical environments where the location collection feature could be deployed.

autoCollection
string (LocationAutoCollectionType)
Enum: "none" "clients" "all"

A list of possible settings for location auto-collection.

areaNotification
boolean
onDemandUsers
object (OnDemandUsers)

Responses

200
default

Error message

put /v1/location

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/location

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "enable": true,
  • "apHeight": 300,
  • "defaultEnvironment": "interiorWalls",
  • "autoCollection": "none",
  • "areaNotification": true,
  • "onDemandUsers":
    {
    }
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "enable": true,
  • "apHeight": 300,
  • "defaultEnvironment": "interiorWalls",
  • "autoCollection": "none",
  • "areaNotification": true,
  • "onDemandUsers":
    {
    }
}

Get mobility setting

Authorizations:

Responses

200
default

Error message

get /v1/mobility

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/mobility

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "mobilityEnabled": true,
  • "physicalIfIp": "10.47.2.1",
  • "discoveryMethod": "SLDP",
  • "mobilityManagerIp": "172.16.63.1",
  • "mobilityBackupManagerIp": "192.168.3.1"
}

Update mobility setting

Authorizations:
Request Body schema: application/json
mobilityEnabled
boolean
physicalIfIp
string

The IP address of a physical interface.

discoveryMethod
string (DiscoveryMethod)
Enum: "SLDP" "StaticConfiguration"
mobilityManagerIp
string

The IP address of the mobility manager.

mobilityBackupManagerIp
string

The IP address of the mobility backup manager. This field is read-only.

Responses

200
default

Error message

put /v1/mobility

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/mobility

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "mobilityEnabled": true,
  • "physicalIfIp": "10.47.2.1",
  • "discoveryMethod": "SLDP",
  • "mobilityManagerIp": "172.16.63.1",
  • "mobilityBackupManagerIp": "192.168.3.1"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "mobilityEnabled": true,
  • "physicalIfIp": "10.47.2.1",
  • "discoveryMethod": "SLDP",
  • "mobilityManagerIp": "172.16.63.1",
  • "mobilityBackupManagerIp": "192.168.3.1"
}

Get NTP settings

Authorizations:

Responses

200

NTP configuration

default

Error message

get /v1/ntpsettings

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/ntpsettings

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "isNtpClient": true,
  • "remoteTimeServers":
    [
    ]
}

Update NTP settings

Authorizations:
Request Body schema: application/json

the collection of NTP settings to be applied to the controller

isNtpClient
boolean
remoteTimeServers
Array of strings

Responses

200
default

Error message

put /v1/ntpsettings

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/ntpsettings

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "isNtpClient": true,
  • "remoteTimeServers":
    [
    ]
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "isNtpClient": true,
  • "remoteTimeServers":
    [
    ]
}

Configure NTP settings

Authorizations:
Request Body schema: application/json

the collection of NTP settings to be applied to the controller.

isNtpClient
boolean
remoteTimeServers
Array of strings

Responses

200
default

Error message

post /v1/ntpsettings

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/ntpsettings

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "isNtpClient": true,
  • "remoteTimeServers":
    [
    ]
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "isNtpClient": true,
  • "remoteTimeServers":
    [
    ]
}

Get product system attributes

Authorizations:

Responses

200
default

Error message

get /v1/productenv

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/productenv

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "upgradeImageSuffix":
    [
    ],
  • "productVersion": "04.26.01.0166",
  • "supportFlash": true,
  • "supportJumboFrame": true,
  • "productName": "VE6120 Small",
  • "lagPorts": 12345,
  • "numberOfPhysicalPorts": 12345,
  • "portNameAndPort":
    [
    ]
}

Get product name

Authorizations:

Responses

200

the product name

default

Error message

get /v1/productname

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/productname

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "productName": "VE6120 Small"
}

Get product version

Authorizations:

Responses

200

the product version

default

Error message

get /v1/productversion

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/productversion

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "productVersion": "04.26.01.0166"
}

Get login management settings

A method to retrieve the login management setting with the list of radius servers used for radius login.

Authorizations:

Responses

200

the current setting of login management

default

Error message

get /v1/radiuslogin

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/radiuslogin

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "custId": "string",
  • "id": "string",
  • "loginAuthMode":
    [
    ],
  • "radiusList":
    [
    ]
}

Set login management settings

A method to set the login management settings including the list of radius servers used for radius login.

Authorizations:
Request Body schema: application/json
custId
string
id
string
loginAuthMode
Array of strings (LoginModes)
Items Enum: "local" "radius"

Login Authentication Mode Configuration (Priority Base - first in list has the highest priority)

radiusList
Array of objects (RadiusLoginElement)

Radius servers setting for login

Responses

200

the current setting of login management

default

Error message

put /v1/radiuslogin

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/radiuslogin

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "custId": "string",
  • "id": "string",
  • "loginAuthMode":
    [
    ],
  • "radiusList":
    [
    ]
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "custId": "string",
  • "id": "string",
  • "loginAuthMode":
    [
    ],
  • "radiusList":
    [
    ]
}

Restore factory defaults

Replaces the platform and application data with factory defaults, then restarts the platform. It supports with options. if license is set to true, controller will remove the license. if managementPort is set to true, controller will reset the management port to factory default. Returns true if the method was invoked successfully.

Authorizations:
Request Body schema: application/json
license
boolean
mgmtport
boolean

Responses

204
default

Error message

put /v1/resettodefaults

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/resettodefaults

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "license": true,
  • "mgmtport": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Restart operating system, platform software, and applications

Causes the operating system, platform software and applications to reinitialize. Returns true if the method was invoked successfully.

Authorizations:

Responses

204
default

ERROR happens in this case

put /v1/restart

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/restart

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Intiate controlled shutdown

Causes a controlled shutdown of the application, the operating system and the platform. Returns true if the method was invoked successfully.

Authorizations:

Responses

204
default

Error message

put /v1/shutdown

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/shutdown

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Start access point capture packets Deprecated

Authorizations:
Request Body schema: application/json
custId
string
id
string
canDelete
boolean
canEdit
boolean
name
string^[A-Z0-9.-_]{0,128}$

user can name the capture as he wish (if null or empty - it will be auto generated).

destination
string (DestinationType)
Enum: "Local" "ScpServer" "AwsS3"
scpStorage
object (ScpServerStorageElement)
awsStorage
object (AwsStorageElement)
apSerialNumber
string

A string containing the globally unique serial number of the AP. The actual length and format of the string depends on the type of device being registered. This attribute of the device must not be null.
Valid character set : Alphanumeric, characters

siteId
string

The site UUID.

maxPktCount
number >= 1

An integer containing the set packet capture threshold. If not manually stopped, packet capture continuesuntil the specified Maximum Packet Count threshold is reached or the max packetcapture data limit of 1 GB is reached.

truncatedPktSize
number >= 0

how many bytes of each captured packet are put to pcap

duration
number

An integer containing the set packet capture duration in minutes . Ifnot manually stopped, packet capture continues until the specified Maximum Packet Count threshold is reached or the max duration of 1 week is reached.

filter
object (CaptureFilterElement) Recursive

This POJO represents the properties of filters used by the packet capture engine.

captureIf
object (CaptureLocationElement) Recursive

This POJO represents the options for location packet capture.

Responses

201

the result of start ap capture packets

default

Error message

post /v1/startappacketcapture

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/startappacketcapture

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "apSerialNumber": "...",
  • "siteId": "...",
  • "maxPktCount": 12345,
  • "duration": 12345,
  • "filter":
    {
    },
  • "captureIf":
    {
    },
  • "custId": "...",
  • "id": "...",
  • "canDelete": true,
  • "canEdit": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "apSerialNumber": "...",
  • "siteId": "...",
  • "maxPktCount": 12345,
  • "duration": 12345,
  • "filter":
    {
    },
  • "captureIf":
    {
    },
  • "custId": "...",
  • "id": "...",
  • "canDelete": true,
  • "canEdit": true
}

Update currently running AP capture Deprecated

A method to change already running access point capture (identified by id from startappacketcapture) without stopping the capture. It is only available for Centralized site/AP.

Authorizations:
Request Body schema: application/json
custId
string
id
string
canDelete
boolean
canEdit
boolean
name
string^[A-Z0-9.-_]{0,128}$

user can name the capture as he wish (if null or empty - it will be auto generated).

destination
string (DestinationType)
Enum: "Local" "ScpServer" "AwsS3"
scpStorage
object (ScpServerStorageElement)
awsStorage
object (AwsStorageElement)
apSerialNumber
string

A string containing the globally unique serial number of the AP. The actual length and format of the string depends on the type of device being registered. This attribute of the device must not be null.
Valid character set : Alphanumeric, characters

siteId
string

The site UUID.

maxPktCount
number >= 1

An integer containing the set packet capture threshold. If not manually stopped, packet capture continuesuntil the specified Maximum Packet Count threshold is reached or the max packetcapture data limit of 1 GB is reached.

truncatedPktSize
number >= 0

how many bytes of each captured packet are put to pcap

duration
number

An integer containing the set packet capture duration in minutes . Ifnot manually stopped, packet capture continues until the specified Maximum Packet Count threshold is reached or the max duration of 1 week is reached.

filter
object (CaptureFilterElement) Recursive

This POJO represents the properties of filters used by the packet capture engine.

captureIf
object (CaptureLocationElement) Recursive

This POJO represents the options for location packet capture.

Responses

201

the result of refresh ap capture packets

default

Error message

post /v1/refreshappacketcapture

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/refreshappacketcapture

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "apSerialNumber": "...",
  • "siteId": "...",
  • "maxPktCount": 12345,
  • "duration": 12345,
  • "filter":
    {
    },
  • "captureIf":
    {
    },
  • "custId": "...",
  • "id": "...",
  • "canDelete": true,
  • "canEdit": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "apSerialNumber": "...",
  • "siteId": "...",
  • "maxPktCount": 12345,
  • "duration": 12345,
  • "filter":
    {
    },
  • "captureIf":
    {
    },
  • "custId": "...",
  • "id": "...",
  • "canDelete": true,
  • "canEdit": true
}

Stop access point capture packets Deprecated

Authorizations:
query Parameters
ids
string <uuid>

List of ids to stop.(if not ids not given stop all running captures)

Responses

204

the result of stop operation

default

Error message

put /v1/stopappacketcapture

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/stopappacketcapture

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Get a list of supported time zones

Authorizations:

Responses

200

a list of supported timeZone

default

Error message

get /v1/supportedtimezones

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/supportedtimezones

Response samples

Content type
application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get system time

This is the current time in the JSON format. { "hour" : 15, "minute" : 36, "second" : 56, "year" : 2016, "month" : 8, "day" : 26 } The time does not include an indication of the time zone. The time is assumed to be the local time. The timezone is assumed from the other settings.

Authorizations:

Responses

200
default

Error message

get /v1/systemtime

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/systemtime

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "hour": 18,
  • "minute": 30,
  • "second": 30,
  • "year": 2016,
  • "month": 8,
  • "day": 24
}

Update system time

When setting time, leading zeros are not allowed for Numbers. leading zeros or space will cause error.

Authorizations:
Request Body schema: application/json
hour
number
minute
number
second
number
year
number
month
number
day
number

Responses

200
default

Error message

put /v1/systemtime

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/systemtime

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "hour": 18,
  • "minute": 30,
  • "second": 30,
  • "year": 2016,
  • "month": 8,
  • "day": 24
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "hour": 18,
  • "minute": 30,
  • "second": 30,
  • "year": 2016,
  • "month": 8,
  • "day": 24
}

Get time zone

Authorizations:

Responses

200

the timeZone

default

Error message

get /v1/timezone

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/timezone

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "timeZone": "America/Toronto"
}

Update time zone

Authorizations:
Request Body schema: application/json

the timeZone to set

timeZone
string

Responses

200
default

Error message

put /v1/timezone

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/timezone

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "timeZone": "America/Toronto"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "timeZone": "America/Toronto"
}

Create time zone

Authorizations:
Request Body schema: application/json

the timeZone to set

timeZone
string

Responses

200
default

Error message

post /v1/timezone

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/timezone

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "timeZone": "America/Toronto"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "timeZone": "America/Toronto"
}

Get web session timeout setting

Authorizations:

Responses

200
default

Error message

get /v1/websessiontimeout

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/websessiontimeout

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "hour": 1,
  • "minute": 0
}

Update web session timeout setting

Authorizations:
Request Body schema: application/json
hour
number
minute
number

Responses

200
default

Error message

put /v1/websessiontimeout

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/websessiontimeout

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "hour": 1,
  • "minute": 0
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "hour": 1,
  • "minute": 0
}

Get packet capture file Deprecated

Authorizations:
path Parameters
localStorage
required
string

Responses

200
default

Error message

get /v1/appacketcapturefile/{localStorage}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/appacketcapturefile/{localStorage}

Response samples

Content type
application/json
Copy
Expand all Collapse all
null

Delete packet capture file Deprecated

Authorizations:
path Parameters
localStorage
required
string

Responses

200
default

Error message

delete /v1/appacketcapturefile/{localStorage}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/appacketcapturefile/{localStorage}

Response samples

Content type
application/json
Copy
Expand all Collapse all
null

Get current Certs list

Authorizations:

Responses

200
default

Error message

get /v1/interface/certs

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/interface/certs

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "certdata":
    [
    ]
}

Get a named topology on the controller

Authorizations:
path Parameters
id
required
string

Responses

200

the identified topology or a 404 error.

default

Error message

get /v1/interface/{id}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/interface/{id}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "name": "...",
  • "mode": "BridgedAtAp",
  • "vlanId": 1027,
  • "tagged": true,
  • "port": 0,
  • "allowManagementTraffic": true,
  • "apRegistration": true,
  • "mtu": 1500,
  • "layer3": true,
  • "ipAddress": "172.16.63.1",
  • "cidr": 24,
  • "dhcpMode": "DHCPRelay",
  • "localDhcp":
    {
    },
  • "dhcpServers": "...",
  • "cert": 12345,
  • "certCa": 12345,
  • "fqdn": "...",
  • "custId": "...",
  • "id": "..."
}

Delete physical interface

A method to delete a physical interface. Admin interface cann't be deleted.

Authorizations:
path Parameters
id
required
string

Responses

200

Success message if set works, otherwise a failure code.

default

Error message

delete /v1/interface/{id}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/interface/{id}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Get log file

Accepts the type of a log file and returns the type file to the caller or a 404 error if the file(file type) does not exist. file type are { upgrade_history, upgrade_details, import_details}

Authorizations:
path Parameters
type
required
string

Responses

200
default

Error message

get /v1/logfile/{type}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/logfile/{type}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Get NTP Status

Authorizations:

Responses

200

an object that can describes the NTP configuration status

default

Error message

get /v1/ntpsettings/status

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/ntpsettings/status

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ntpReachable": true
}

Update login management settings

A method to test the login management radius setting by providing username, password and radius server list to check upon

Authorizations:
Request Body schema: application/json
custId
string
id
string
username
string

Username for testing radius login

password
string

Password for testing radius login

radiusList
Array of objects (RadiusLoginElement)

Radius servers setting for login

Responses

200

the result of the user login

default

Error message

put /v1/radiuslogin/test

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/radiuslogin/test

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "custId": "string",
  • "id": "string",
  • "username": "string",
  • "password": "string",
  • "radiusList":
    [
    ]
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Check login management settings

A method to test the login management radius setting by providing username, password and radius server list to check upon

Authorizations:
Request Body schema: application/json
custId
string
id
string
username
string

Username for testing radius login

password
string

Password for testing radius login

radiusList
Array of objects (RadiusLoginElement)

Radius servers setting for login

Responses

200

the result of the user login

default

Error message

post /v1/radiuslogin/test

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/radiuslogin/test

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "custId": "string",
  • "id": "string",
  • "username": "string",
  • "password": "string",
  • "radiusList":
    [
    ]
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Apply certificate to platform

Authorizations:
Request Body schema: application/json
name
required
string

A string containing the name of the topology where the certificate is applied.
Validations : Not null and not empty!

key
string

A string containing the filename of the Server Private Key in PEM format.

ca
string

A string containing the filename of the Intermediate Certification Authority certificate in PEM format.

cert
string

A string containing the filename of the Server Certificate in PEM format.

pfx
string

A string containing the filename of the Server Public/Private Key file in PKCS#12 format.

password
string

A string containing the password for the Server Public/Private Key file in PKCS#12 format.

address
string

A string containing the IP Address of the topology where the certificate is installed.


Validations : Not null and valid IP address!

reset
boolean

A flag to reset the custom installed certificate back to factory default.

Responses

200
default

Error message

post /v1/interface/cert/apply

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/interface/cert/apply

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "key": "server.key",
  • "ca": "intermca.crt",
  • "cert": "server.crt",
  • "pfx": "custompair.pfx",
  • "password": "...",
  • "name": "Admin",
  • "address": "172.16.65.1",
  • "reset": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Upload certificate to platform

Authorizations:
Request Body schema: multipart/form-data
fileInputStream
string <binary>
fileMetaData
string <binary>
body
string <binary>

Responses

200
default

Error message

post /v1/interface/cert/fileupload

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/interface/cert/fileupload

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Generate CSR

Authorizations:
Request Body schema: application/json
name
required
string

A string containing the name of the topology where the certificate is applied.
Validations : Not null and not empty!

address
string

A string containing the IP Address of the topology where the certificate is installed.
Validations : Not null and valid IP address!

ipVersion
string (IpAddressType)
Enum: "four" "six"
keySize
string (CertificateKeySizeType)
Enum: "tenTwentyFour" "twentyFortyEight"

A list containing X509 private key sizes that are supported.

country
string
state
string
location
string
organization
string
unit
string
commonName
string

A string containing the name used by DNS Servers to get the IP address of the interface.

email
string

Responses

200
default

Error message

post /v1/interface/cert/signrequest

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/interface/cert/signrequest

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "name": "Admin",
  • "address": "172.16.65.1",
  • "ipVersion": "four",
  • "keySize": "twentyFortyEight",
  • "country": "US",
  • "state": "CA",
  • "location": "San Jose",
  • "organization": "Extreme Networks",
  • "unit": "Wireless",
  • "commonName": "*.switches.extremenetworks.com",
  • "email": "..."
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "name": "Admin",
  • "address": "172.16.65.1",
  • "ipVersion": "four",
  • "keySize": "twentyFortyEight",
  • "country": "US",
  • "state": "CA",
  • "location": "San Jose",
  • "organization": "Extreme Networks",
  • "unit": "Wireless",
  • "commonName": "*.switches.extremenetworks.com",
  • "email": "..."
}

Get CSR

Authorizations:
path Parameters
address
required
string

Responses

200
default

Error message

get /v1/interface/cert/csr/{address}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/interface/cert/csr/{address}

Response samples

Content type
application/json
Copy
Expand all Collapse all
null

Get L2 ports

Authorizations:

Responses

200

Setting L2 ports successful

default

Error response

get /v1/l2ports

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/l2ports

Response samples

Content type
application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Set L2 ports

Authorizations:
Request Body schema: application/json

Complete list of l2 ports.

Array
lagMembers
Array of integers

List of port IDs included in LAG

Responses

200

Setting l2ports successfull

default

Error response

put /v1/l2ports

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/l2ports

Request samples

Content type
application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Response samples

Content type
application/json
Example
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Get L2 (physical) ports stats

Authorizations:

Responses

200

L2 (physical) ports stats

default

Error response

get /v1/report/l2ports

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/report/l2ports

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "id": 0,
  • "name": "string",
  • "type": 0,
  • "mtu": 0,
  • "speed": 0,
  • "address": "string",
  • "adminStatus": true,
  • "opStatus": true,
  • "inOctets": 0,
  • "inUcPkts": 0,
  • "inMcPkts": 0,
  • "inBcPkts": 0,
  • "inDiscards": 0,
  • "inErrors": 0,
  • "inUkProtos": 0,
  • "outOctets": 0,
  • "outUcPkts": 0,
  • "outMcPkts": 0,
  • "outBcPkts": 0,
  • "outDiscards": 0,
  • "outErrors": 0
}

PacketCaptureManager

Get all AP packet captures instances

Authorizations:

Responses

200

Get all AP packet capture instances

default

Error response

get /v3/packetcaptures

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v3/packetcaptures

Response samples

Content type
application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Create a new packet capture instance.

Authorizations:
Request Body schema: application/json

Start a new AP packet capture.

custId
string
id
string
canDelete
boolean
canEdit
boolean
name
string^[A-Z0-9.-_]{0,128}$

user can name the capture as he wish (if null or empty - it will be auto generated).

storage
object
apSerialNumber
string

A string containing the globally unique serial number of the AP. The actual length and format of the string depends on the type of device being registered. This attribute of the device must not be null.
Valid character set : Alphanumeric, characters

siteId
string

The site UUID.

maxPktCount
number >= 1

An integer containing the set packet capture threshold. If not manually stopped, packet capture continuesuntil the specified Maximum Packet Count threshold is reached or the max packetcapture data limit of 1 GB is reached.

truncatedPktSize
number >= 0

how many bytes of each captured packet are put to pcap

duration
number

An integer containing the set packet capture duration in minutes . Ifnot manually stopped, packet capture continues until the specified Maximum Packet Count threshold is reached or the max duration of 1 week is reached.

filter
object (CaptureFilterElement) Recursive

This POJO represents the properties of filters used by the packet capture engine.

captureIf
object (CaptureLocationElement) Recursive

This POJO represents the options for location packet capture.

status
string (PktCaptureStatusV3)
Default: "Inactive"
Enum: "Inactive" "Active"

Responses

201

Newly created packet capture (id and Name).

default

Error response

post /v3/packetcaptures

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v3/packetcaptures

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "apSerialNumber": "...",
  • "siteId": "...",
  • "maxPktCount": 12345,
  • "duration": 12345,
  • "filter":
    {
    },
  • "captureIf":
    {
    },
  • "custId": "...",
  • "id": "...",
  • "canDelete": true,
  • "canEdit": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "apSerialNumber": "...",
  • "siteId": "...",
  • "maxPktCount": 12345,
  • "duration": 12345,
  • "filter":
    {
    },
  • "captureIf":
    {
    },
  • "custId": "...",
  • "id": "...",
  • "canDelete": true,
  • "canEdit": true
}

Get the default AP packet capture configuration

Authorizations:

Responses

200

AP packet capture instance with attributes set to default values

default

Error response

get /v3/packetcaptures/default

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v3/packetcaptures/default

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "apSerialNumber": "...",
  • "siteId": "...",
  • "maxPktCount": 12345,
  • "duration": 12345,
  • "filter":
    {
    },
  • "captureIf":
    {
    },
  • "custId": "...",
  • "id": "...",
  • "canDelete": true,
  • "canEdit": true
}

Get AP packet capture name to ID map

Authorizations:

Responses

200

Map with AP packet capture name and corresponding ID

default

Error response

get /v3/packetcaptures/nametoidmap

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v3/packetcaptures/nametoidmap

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "property1": "string",
  • "property2": "string"
}

Get an AP packet capture by ID

Authorizations:
path Parameters
id
required
string

A non-empty, valid AP packet capture ID

Responses

200

AP packet capture instance with the given ID

default

Error response

get /v3/packetcaptures/{id}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v3/packetcaptures/{id}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "apSerialNumber": "...",
  • "siteId": "...",
  • "maxPktCount": 12345,
  • "duration": 12345,
  • "filter":
    {
    },
  • "captureIf":
    {
    },
  • "custId": "...",
  • "id": "...",
  • "canDelete": true,
  • "canEdit": true
}

Refresh an AP packet capture

Authorizations:
path Parameters
id
required
string

A non-empty, valid AP packet capture ID

Request Body schema: application/json

A valid AP packet capture with the configured parameters.

custId
string
id
string
canDelete
boolean
canEdit
boolean
name
string^[A-Z0-9.-_]{0,128}$

user can name the capture as he wish (if null or empty - it will be auto generated).

storage
object
apSerialNumber
string

A string containing the globally unique serial number of the AP. The actual length and format of the string depends on the type of device being registered. This attribute of the device must not be null.
Valid character set : Alphanumeric, characters

siteId
string

The site UUID.

maxPktCount
number >= 1

An integer containing the set packet capture threshold. If not manually stopped, packet capture continuesuntil the specified Maximum Packet Count threshold is reached or the max packetcapture data limit of 1 GB is reached.

truncatedPktSize
number >= 0

how many bytes of each captured packet are put to pcap

duration
number

An integer containing the set packet capture duration in minutes . Ifnot manually stopped, packet capture continues until the specified Maximum Packet Count threshold is reached or the max duration of 1 week is reached.

filter
object (CaptureFilterElement) Recursive

This POJO represents the properties of filters used by the packet capture engine.

captureIf
object (CaptureLocationElement) Recursive

This POJO represents the options for location packet capture.

status
string (PktCaptureStatusV3)
Default: "Inactive"
Enum: "Inactive" "Active"

Responses

200

The updated packet capture

default

Error response

put /v3/packetcaptures/{id}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v3/packetcaptures/{id}

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "apSerialNumber": "...",
  • "siteId": "...",
  • "maxPktCount": 12345,
  • "duration": 12345,
  • "filter":
    {
    },
  • "captureIf":
    {
    },
  • "custId": "...",
  • "id": "...",
  • "canDelete": true,
  • "canEdit": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "apSerialNumber": "...",
  • "siteId": "...",
  • "maxPktCount": 12345,
  • "duration": 12345,
  • "filter":
    {
    },
  • "captureIf":
    {
    },
  • "custId": "...",
  • "id": "...",
  • "canDelete": true,
  • "canEdit": true
}

Stop an AP packet capture

Authorizations:
path Parameters
id
required
string

A non-empty, valid packet capture ID

Responses

200

packet capture stoppedd successfully

default

Error response

delete /v3/packetcaptures/{id}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v3/packetcaptures/{id}

Response samples

Content type
application/json
Example
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Get packet capture file list

Authorizations:

Responses

200

Get AP packet capture file list

default

Error response

get /v3/packetcaptures/files

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v3/packetcaptures/files

Response samples

Content type
application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get AP packet capture file

Authorizations:
path Parameters
localStorage
required
string

Responses

200

Returns requested packet capture file

default

Error message

get /v3/packetcaptures/files/{localStorage}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v3/packetcaptures/files/{localStorage}

Response samples

Content type
application/json
Copy
Expand all Collapse all
null

Delete AP packet capture file

Authorizations:
path Parameters
localStorage
required
string

Responses

200
default

Error message

delete /v3/packetcaptures/files/{localStorage}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v3/packetcaptures/files/{localStorage}

Response samples

Content type
application/json
Copy
Expand all Collapse all
null

PlatformReports

Get platform details

Get details set mainly at manufacturing time, such as the platform type and the platform's MAC addresses.

Authorizations:

Responses

200
default

Error message

get /v1/reports/manufacturinginformation

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/reports/manufacturinginformation

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Get system information report

Authorizations:

Responses

200
default

Error message

get /v1/reports/systeminformation

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/reports/systeminformation

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

RoutesManager

Get list of static routes on the controller

Authorizations:

Responses

200

a list containing static routes

default

Error message

get /v1/routes/allroutes

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/routes/allroutes

Response samples

Content type
application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Get default gateway of the controller

Authorizations:

Responses

200

the default gateway

default

Error message

get /v1/routes/defaultgateway

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/routes/defaultgateway

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ipv4Address": "..."
}

Update controller default gateway

Authorizations:
Request Body schema: application/json
ipv4Address
string

Responses

200
default

Error message

put /v1/routes/defaultgateway

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/routes/defaultgateway

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ipv4Address": "..."
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ipAddress": "...",
  • "cidr": 12345,
  • "gateWay": "...",
  • "portName": "...",
  • "vlanMapToEsa": 12345
}

Create default gateway

Authorizations:
Request Body schema: application/json
ipv4Address
string

Responses

200
default

Error message

post /v1/routes/defaultgateway

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/routes/defaultgateway

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ipv4Address": "..."
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ipAddress": "...",
  • "cidr": 12345,
  • "gateWay": "...",
  • "portName": "...",
  • "vlanMapToEsa": 12345
}

Update static route

A method to set attributes of a static route on the controller. ** Note: the portName and vlanMapToEsa fields are not used during the PUT/POST **

Authorizations:
Request Body schema: application/json
ipAddress
string
cidr
number
gateWay
string
portName
string
vlanMapToEsa
number

Responses

200

route if set works, otherwise 422,500 error

default

Error message

put /v1/routes/route

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/routes/route

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ipAddress": "...",
  • "cidr": 12345,
  • "gateWay": "...",
  • "portName": "...",
  • "vlanMapToEsa": 12345
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ipAddress": "...",
  • "cidr": 12345,
  • "gateWay": "...",
  • "portName": "...",
  • "vlanMapToEsa": 12345
}

Create new static route

A method to set attributes of a static route on the controller. ** Note: the portName and vlanMapToEsa fields are not used during the PUT/POST **

Authorizations:
Request Body schema: application/json
ipAddress
string
cidr
number
gateWay
string
portName
string
vlanMapToEsa
number

Responses

200

Updated route

default

Error message

post /v1/routes/route

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/routes/route

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ipAddress": "...",
  • "cidr": 12345,
  • "gateWay": "...",
  • "portName": "...",
  • "vlanMapToEsa": 12345
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ipAddress": "...",
  • "cidr": 12345,
  • "gateWay": "...",
  • "portName": "...",
  • "vlanMapToEsa": 12345
}

Get static route by IP address

Authorizations:
path Parameters
id
required
string

is IP address of route

Responses

200

the identified route or 422 error

default

Error message

get /v1/routes/route/{id}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/routes/route/{id}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "ipAddress": "...",
  • "cidr": 12345,
  • "gateWay": "...",
  • "portName": "...",
  • "vlanMapToEsa": 12345
}

Delete static route based on IP address

Authorizations:
path Parameters
id
required
string

IP address of static route

Responses

200

Success message if set works, otherwise 422, 500 error.

default

Error message

delete /v1/routes/route/{id}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/routes/route/{id}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

SnmpSettingsManager

Get SNMP settings

Authorizations:

Responses

200
default

ERROR happens in this case

get /v1/snmp

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/snmp

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "custId": "string",
  • "id": "string",
  • "canDelete": true,
  • "canEdit": true,
  • "snmpVersion": "DISABLED",
  • "engineId": "string",
  • "context": "string",
  • "trapSeverity": "None",
  • "v2Communities":
    {
    },
  • "v3Users":
    [
    ],
  • "notifications":
    [
    ]
}

Update SNMP agent settings

Validates the values of all the attributes of the input SnmpBaseSettings object and if they are all valid, replaces the current SNMP agent settings with the new settings.

Authorizations:
Request Body schema: application/json
custId
string
id
string
canDelete
boolean
canEdit
boolean
snmpVersion
string (SNMPVersion)
Enum: "DISABLED" "SNMPv2c" "SNMPv3"
engineId
string

The SNMPv3 engine ID for the controller running the SNMP agent. The engine ID must be from 5 to 32 characters long. If SNMPv3 is selected engineId is mandatory and v2Communities will be nullified.

context
string

A string containing the descriptionof the SNMP context in V3 mode.

trapSeverity
string (TrapSeverity)
Enum: "None" "Critical" "Major" "Minor" "Informational"
v2Communities
object
v3Users
Array of objects (SNMPUser)

A list of SNMPUser configurations. If SNMPv3 is selected, v3Users is mandatory and v2Communities will be nullified.

notifications
Array of objects (SNMPNotification)

A list of SNMPNotification / Trap destination configuration.

Responses

200
default

Error message

put /v1/snmp

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/snmp

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "custId": "string",
  • "id": "string",
  • "canDelete": true,
  • "canEdit": true,
  • "snmpVersion": "DISABLED",
  • "engineId": "string",
  • "context": "string",
  • "trapSeverity": "None",
  • "v2Communities":
    {
    },
  • "v3Users":
    [
    ],
  • "notifications":
    [
    ]
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "custId": "string",
  • "id": "string",
  • "canDelete": true,
  • "canEdit": true,
  • "snmpVersion": "DISABLED",
  • "engineId": "string",
  • "context": "string",
  • "trapSeverity": "None",
  • "v2Communities":
    {
    },
  • "v3Users":
    [
    ],
  • "notifications":
    [
    ]
}

TechSupport

Create a single log file for controller

Causes the controller to collect its log files and configuration into a single tar.gz file suitable for forwarding to support organizations. This method will fail if the controller already hosts the maximum number of techsupport files. In that case use deleteTechSupportFile to remove some before generating another one.

Authorizations:
Request Body schema: application/json
filename
string
mode
string (TechSupportContentType)
Enum: "controller" "ap" "log" "all" "lite"

An enumeration containing a list of supported content types.

apNoStats
boolean

Responses

202
default

Error message

post /v1/techsupport/generate

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/techsupport/generate

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "filename": "...",
  • "mode": "ap",
  • "apNoStats": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Get all tech support files

Authorizations:

Responses

200
default

Error message

get /v1/techsupport/listall

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/techsupport/listall

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "techsupportfile":
    [
    ]
}

Get status of tech support file generating process

Authorizations:

Responses

200
default

Error message

get /v1/techsupport/status

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/techsupport/status

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Get tech support file by name

Authorizations:
path Parameters
id
required
string

Responses

200
default

Error message

get /v1/techsupport/file/{id}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/techsupport/file/{id}

Response samples

Content type
application/json
Copy
Expand all Collapse all
null

Delete tech support file by name

Authorizations:
path Parameters
id
required
string

The name, including extension of the techsupport file to be deleted.

Responses

200
default

Error message

delete /v1/techsupport/file/{id}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/techsupport/file/{id}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

UpgradeManager

Upload an image file

A method to upload an image file. Image file extension is base on the platform (upto 3 files allowed) or one backup file extension "-rescue-user.tgz". Usage: curl -i -X POST -H "Content-Type: multipart/form-data" -F "file=@NSEM-01.00.00.0055T-1.dle" https://192.168.3.62:5825/platformmanager/v1/upgrades/fileupload

Authorizations:
Request Body schema: multipart/form-data
fileInputStream
string <binary>
fileMetaData
string <binary>
body
string <binary>

Responses

200
default

Error message

post /v1/upgrades/fileupload

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/upgrades/fileupload

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Get amount of free space available in the partition used to store system upgrade images

Authorizations:

Responses

200
default

Error message

get /v1/upgrades/freespaceforimages

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/upgrades/freespaceforimages

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "size": "3000"
}

Get local upgrade schedule

Authorizations:

Responses

200
default

Error message

get /v1/upgrades/scheduleupgrade

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/upgrades/scheduleupgrade

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "upgradeFileName": "...",
  • "upgradeBackupFileName": "...",
  • "systemImageBackup": "...",
  • "startTime": "..."
}

Schedule local upgrade for a specific date and time

A method that attempts to schedule a local upgrade for a specific date and time. The date must be a valid calendar date (e.g. not Feb 30). It is an error if the date is not at least 5 minutes into the future or more than one year into the future. ** Note: the year and second fields are not USED. **. if enabled is set to false, controller will apply cancel command to cancel the previous scheduled upgrade. The scheduling is performed in line. The scheduling is complete when the method returns.

Authorizations:
Request Body schema: application/json
filename
required
string
backupDestination
required
string(none|local|flash)
startTime
object (SystemTimeWithoutYear)
enabled
boolean

Responses

200
default

Error message

put /v1/upgrades/scheduleupgrade

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/upgrades/scheduleupgrade

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "filename": "string",
  • "backupDestination": "string",
  • "startTime":
    {
    },
  • "enabled": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Change local upgrade schedule

A method that attempts to schedule a local upgrade for a specific date and time. The date must be a valid calendar date (e.g. not Feb 30). It is an error if the date is not at least 5 minutes into the future or more than one year into the future. ** Note: the year and second fields are not USED. **. if enabled is set to false, controller will apply cancel command to cancel the previous scheduled upgrade. The scheduling is performed in line. The scheduling is complete when the method returns.

Authorizations:
Request Body schema: application/json
filename
required
string
backupDestination
required
string(none|local|flash)
startTime
object (SystemTimeWithoutYear)
enabled
boolean

Responses

200
default

Error message

post /v1/upgrades/scheduleupgrade

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/upgrades/scheduleupgrade

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "filename": "string",
  • "backupDestination": "string",
  • "startTime":
    {
    },
  • "enabled": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Get list of files on the controller containing an upgrade bundle

Authorizations:

Responses

200
default

Error message

get /v1/upgrades/upgradeimagelist

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/upgrades/upgradeimagelist

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "upgradefile":
    [
    ]
}

Delete access point image file

A method to delete an AP image file. Image file must not be a default image for no platform Usage: curl -i -k -H "Authorization: Bearer 1370b88682bfb843a0433bf643edf6c5" -H "Content-Type: application/json" -X DELETE -d '{"apPlatform":"AP3916-camera","filename":"AP3916IC-V1-0-8-7.dlf"}' 'https://192.168.3.62:5825/platformmanager/v1/upgrades/apimages/delete'

Authorizations:

Responses

200
default

Error message

delete /v1/upgrades/apimages/delete

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/upgrades/apimages/delete

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Create an access point image file

A method to upload an AP image file. Image file extension is base on AP (Camera are differnt) (upto 14/10 files allowed) Usage: curl -k -H "Authorization: Bearer 1370b88682bfb843a0433bf643edf6c5" -X POST --form apPlatform="AP3916-camera" --form file=@"AP3916IC06042017.dlf" 'https://192.168.3.62:5825/platformmanager/v1/upgrades/apimages/fileupload'

Authorizations:
Request Body schema: multipart/form-data
apPlatform
string

: AP Platform

fileInputStream
string <binary>
fileMetaData
string <binary>
body
string <binary>

Responses

200
default

Error message

post /v1/upgrades/apimages/fileupload

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/upgrades/apimages/fileupload

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Get list of access point images

A method that lists the AP images. Usage: curl -k -H "Authorization: Bearer 1370b88682bfb843a0433bf643edf6c5" -X GET 'https://192.168.3.62:5825/platformmanager/v1/upgrades/apimages/list'

Authorizations:

Responses

200

List : the list of AP images.

default

Error message

get /v1/upgrades/apimages/list

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/upgrades/apimages/list

Response samples

Content type
application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Set default access point image

A method to set the default AP image for AP type. Image file must be present image. Usage: curl -i -k -H "Authorization: Bearer 1370b88682bfb843a0433bf643edf6c5" -H "Content-Type: application/json" -X POST -d '{"apPlatform":"AP3916-camera","filename":"AP3916IC-V5-0-8-7.dlf"}' 'https://192.168.3.62:5825/platformmanager/v1/upgrades/apimages/setdefault'

Authorizations:
Request Body schema: application/json
apPlatform
required
string
filename
required
string

Responses

200
default

Error message

post /v1/upgrades/apimages/setdefault

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/upgrades/apimages/setdefault

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "apPlatform": "...",
  • "filename": "..."
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Copy image upgrade file

A method to copy a system image upgrade file from a remote file server to the controller. The file is simply copied to the controller. It is not installed by executing this method. Returns true if the file transfer can be started and false otherwise. Note that the upgrade files for the controller end in a suffix that identifies the type of platform that can take the upgrade. If the file name suffix is not the one for the host platform then the upgrade will not be performed.

Authorizations:
path Parameters
protocol
required
string

The protocol to use to transfer the upgrade file from a file server to the controller.

Request Body schema: application/json
serverIP
string

The IPv4 address of the server that is storing or going to store the subject file. It cannot be null.

userid
string

The user ID to authenticate with the file server. It cannot be null.

password
string

The password to authenticate with the file server. It cannot be null.

directory
string

The path on the server of the directory in which the subject file resides or is to be stored. It cannot be null but could be '/'

fileName
string

The name of the file that is to be pulled from or pushed to the file server. It cannot be null, a zero length string or begin or end with blanks.

localDestination
string (LocalDestination)
Enum: "local" "flash"

Responses

200
default

Error message

put /v1/upgrades/copyupgradefrom/{protocol}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/upgrades/copyupgradefrom/{protocol}

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "serverIP": "8.8.8.8",
  • "userid": "Admin",
  • "password": "abc123",
  • "directory": "/",
  • "fileName": "example.txt",
  • "localDestination": "local"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Transfer remote image upgrade file to controller

A method to copy a system image upgrade file from a remote file server to the controller. The file is simply copied to the controller. It is not installed by executing this method. Returns true if the file transfer can be started and false otherwise. Note that the upgrade files for the controller end in a suffix that identifies the type of platform that can take the upgrade. If the file name suffix is not the one for the host platform then the upgrade will not be performed.

Authorizations:
path Parameters
protocol
required
string

The protocol to use to transfer the upgrade file from a file server to the controller.

Request Body schema: application/json
serverIP
string

The IPv4 address of the server that is storing or going to store the subject file. It cannot be null.

userid
string

The user ID to authenticate with the file server. It cannot be null.

password
string

The password to authenticate with the file server. It cannot be null.

directory
string

The path on the server of the directory in which the subject file resides or is to be stored. It cannot be null but could be '/'

fileName
string

The name of the file that is to be pulled from or pushed to the file server. It cannot be null, a zero length string or begin or end with blanks.

localDestination
string (LocalDestination)
Enum: "local" "flash"

Responses

200
default

Error message

post /v1/upgrades/copyupgradefrom/{protocol}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/upgrades/copyupgradefrom/{protocol}

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "serverIP": "8.8.8.8",
  • "userid": "Admin",
  • "password": "abc123",
  • "directory": "/",
  • "fileName": "example.txt",
  • "localDestination": "local"
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Check upgrade image file for errors

A method to pre-check upload of image file for errors. Image file extension is base on the platform (upto 3 files allowed) or one backup file extension "-rescue-user.tgz". Usage: curl -k -H "Authorization: Bearer 5637242c9e3f9b7a7b4847a35a4afad9" -X GET https://192.168.3.62:5825/platformmanager/v1/upgrades/prefileupload/"NSEM-01.00.00.0055T-1.dle"

Authorizations:
path Parameters
filename
required
string

Responses

200
default

Error message

get /v1/upgrades/prefileupload/{filename}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/upgrades/prefileupload/{filename}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Delete upgrade file from the controller

Attempts to delete the named system image upgrade file from the controller's local storage. The delete is performed in line. Returns true if the delete succeeded and false otherwise. i.e. curl -H "Content-Type: " -X DELETE http://10.47.21.24:8181/platformmanager/platform/v1/upgrades/upgradeimage/"NSEM-01.00.00.0011s-1.dle(flash)"

Authorizations:
path Parameters
id
required
string

The name of an upgrade file on the controller that will be deleted.

Responses

200
default

ERROR happens in this case

delete /v1/upgrades/upgradeimage/{id}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/upgrades/upgradeimage/{id}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Upgrade backup files for the controller

Attempts to install the upgrade contained in the file named in the input parameter. The method returns true if the input parameters are valid and the upgrade is started and false otherwise. The method returns before the upgrade completes as an upgrade requires disabling services on the controller and at least 1 system restart. Note that the upgrade files for the controller end in a suffix that identifies the type of platform that can take the upgrade. If the file name suffix is not the one for the host platform then the upgrade will not be performed.

Authorizations:
path Parameters
backupmethod
required
string

Whether to take a backup of the partitions that will be modified by the upgrade before installing the upgrade file. The choices are none - fastest but if a failure occurs the controller can't be restored to its pre-upgrade state local - save the system image backup on local storage. The UpgradeManager picks a name for the system image backup. Note remote copying of system image backup file during upgrade is not supported on OneController at this time.

id
required
string

Name (base name and file extension) of the upgrade file that is to be installed on OneController during the upgrade.

Responses

200
default

Error message

put /v1/upgrades/dolocalupgrade/{backupmethod}/{id}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/upgrades/dolocalupgrade/{backupmethod}/{id}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Greengrass(Experimental)

Get log file by type

Accepts the type of a log file and returns that log file to the caller or a 404 error if the file does not exist.

Authorizations:
path Parameters
type
required
string (GreengrassLogType)
Value: "Running"
Example: Running

Type can be one of "Running"/...

Responses

200
default

Error message

get /v1/greengrass/logfile/{type}

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/greengrass/logfile/{type}

Response samples

Content type
application/json
Copy
Expand all Collapse all
null

Upload certificate to Greengrass

Authorizations:
Request Body schema: multipart/form-data
fileInputStream
string <binary>
fileMetaData
string <binary>
body
string <binary>

Responses

200
default

Error message

post /v1/greengrass/cert/fileupload

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/greengrass/cert/fileupload

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Upload Greengrass configuration

Upload configuration for Greengrass ('config.json')

Authorizations:
Request Body schema: multipart/form-data
fileInputStream
string <binary>
fileMetaData
string <binary>
body
string <binary>

Responses

200
default

Error message

post /v1/greengrass/config/fileupload

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/greengrass/config/fileupload

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Start Greengrass daemon

Authorizations:
Request Body schema: application/json
forceRestart
boolean
Default: false

Responses

200
default

Error message

put /v1/greengrass/start

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/greengrass/start

Request samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "forceRestart": true
}

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}

Get current status of Greengrass daemon

Authorizations:

Responses

200
default

Error message

get /v1/greengrass/status

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/greengrass/status

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "running": true
}

Stop the Greengrass daemon

Authorizations:

Responses

200
default

Error message

put /v1/greengrass/stop

ExtremeCloud Appliance REST API server

https://www.example.com:5825/platformmanager/v1/greengrass/stop

Response samples

Content type
application/json
Copy
Expand all Collapse all
{
  • "result": "CLI Export start: Wed Aug 22 16:46:00 2018, CLI Export end: Wed Aug 22 16:46:01 2018, SUCCESS: Backup/Export complete: EAE.22082018.164600"
}