Skip to content

sites

Overview

API to add, modify, delete, and get sites.

Version information

Version : v2

URI scheme

Host :
BasePath : /sdwan/nitro/v2/config_editor/
Schemes : HTTP

Tags

  • sites : Operations related to sites

Paths

POST operation for sites

POST /sites

Description

Use this operation to add site

Responses

HTTP Code Description Schema
200 Resource successfully added sites_post_success_schema
400 Failed: bad input parameter ErrorSchema
401 Unauthorized: Failed Authentication ErrorSchema
403 Unauthorized: Forbidden ErrorSchema
405 Failed: Data format unacceptable ErrorSchema
415 Failed: Data format unacceptable ErrorSchema
500 Failed: Internal Server Error ErrorSchema

Produces

  • application/json

Tags

  • sites

Get operation for sites

GET /sites

Description

Use this operation to get the list of sites

Responses

HTTP Code Description Schema
200 API Successfully executed sites_response_schema
400 Failed: bad input parameter ErrorSchema
401 Unauthorized: Failed Authentication ErrorSchema
403 Unauthorized: Forbidden ErrorSchema
405 Failed: Data format unacceptable ErrorSchema
415 Failed: Data format unacceptable ErrorSchema
500 Failed: Internal Server Error ErrorSchema

Produces

  • application/json

Tags

  • sites

PUT operation for sites

PUT /sites

Description

Use this operation to modify site

Parameters

Type Name Schema
Body body
optional
sites_request_schema

Responses

HTTP Code Description Schema
200 Resource modified added sites_put_success_schema
400 Failed: bad input parameter ErrorSchema
401 Unauthorized: Failed Authentication ErrorSchema
403 Unauthorized: Forbidden ErrorSchema
405 Failed: Data format unacceptable ErrorSchema
415 Failed: Data format unacceptable ErrorSchema
500 Failed: Internal Server Error ErrorSchema

Consumes

  • application/json

Produces

  • application/json

Tags

  • sites

DELETE operation for sites

DELETE /sites/{deletePathParam}

Description

Use this operation to delete a site

Parameters

Type Name Description Schema
Path deletePathParam
required
Object Primary Key for DELETE operation object

Responses

HTTP Code Description Schema
200 Resource delete added sites_delete_success_schema
400 Failed: bad input parameter ErrorSchema
401 Unauthorized: Failed Authentication ErrorSchema
403 Unauthorized: Forbidden ErrorSchema
405 Failed: Data format unacceptable ErrorSchema
415 Failed: Data format unacceptable ErrorSchema
500 Failed: Internal Server Error ErrorSchema

Produces

  • application/json

Tags

  • sites

Definitions

ErrorSchema

Name Schema
errorcode
optional
integer
errormessage
optional
string

mode

Operating mode of this site

Type : enum (primary_mcn, secondary_mcn, primary_rcn, secondary_rcn, client)

model

site model

Type : enum (cb210, cb400, cb410, cb1000, cb1100, cb2000, cb2100, cb4000, cb4100, cb5100, cb6100, cbvpx, cbvpxl)

package_name

Config package name using which the site API operation should be performed.

Type : string

persist_ucast_refresh_time_ms

Gateway ARP Timer: (ms)

Type : integer

region

Region to which the site belongs to

Type : string

secure_key

Hexadecimal secure key used for encryption and membership verification in the Virtual WAN network. This field is optional. If the value is not provided, API generates the secure key.

Type : string

site_location

Site location.

Type : string

site_name

Site Name

Type : string

sites

Name Schema
mode
optional
mode
model
optional
model
package_name
optional
package_name
persist_ucast_refresh_time_ms
optional
persist_ucast_refresh_time_ms
region
optional
region
secure_key
optional
secure_key
site_location
optional
site_location
site_name
optional
site_name
user_ucast_refresh_time_ms
optional
user_ucast_refresh_time_ms

sites_delete_success_schema

Name Schema
sites
optional
sites

sites

Name Description Schema
message
optional
Example : "resource deleted succesfully" string

sites_post_success_schema

Name Schema
sites
optional
sites

sites

Name Description Schema
message
optional
Example : "resource added succesfully" string

sites_put_success_schema

Name Schema
sites
optional
sites

sites

Name Description Schema
message
optional
Example : "resource modified succesfully" string

sites_request_schema

Name Schema
sites
optional
sites

sites_response_schema

Type : < sites_response_schema > array

sites_response_schema

Name Schema
mode
optional
mode
model
optional
model
package_name
optional
package_name
persist_ucast_refresh_time_ms
optional
persist_ucast_refresh_time_ms
region
optional
region
secure_key
optional
secure_key
site_location
optional
site_location
site_name
optional
site_name
user_ucast_refresh_time_ms
optional
user_ucast_refresh_time_ms

user_ucast_refresh_time_ms

Host ARP Timer: (ms)

Type : integer