OpenDoveDcsServiceApplianceNorthbound

Open DOVE Northbound REST APIs for DCS Service Appliance.


Authentication scheme [for now]: HTTP Basic
Authentication realm : opendaylight
Transport : HTTP and HTTPS

HTTPS Authentication is disabled by default. Administrator can enable it in tomcat-server.xml after adding a proper keystore / SSL certificate from a trusted authority.
More info : http://tomcat.apache.org/tomcat-7.0-doc/ssl-howto.html#Configuration

The following resources are part of this group:

/odcs/{saUUID}/role

Mount Point: /controller/nb/v2/opendove/odmc/odcs/{saUUID}/role

PUT

Sets/Resets the odcs service role on a service appliance

Parameters

name description type default
saUUID (no documentation provided) path

Request Body

element: openDoveServiceApplianceRequest
media types: application/json

(no documentation provided)

Response Body

element: openDoveServiceApplianceRequest
media types: application/json

Updated service appliance information


Example:

Request URL:
http://localhost:8080/controller/nb/v2/opendove/odcs/uuid/role

Request body in JSON:
{
"service_appliance": {
"isDCS": true
}
}

Response body in JSON:
{
"service_appliance": {
"ip_family": 4,
"ip": "10.10.10.1",
"uuid": "uuid",
"dcs_rest_service_port": 1888,
"dgw_rest_service_port": 1888,
"dcs_raw_service_port": 932,
"timestamp": "now",
"build_version": "openDSA-1",
"dcs_config_version": 60,
"canBeDCS": true,
"canBeDGW": true,
"isDCS": true,
"isDGW": false
}
}

Status Codes

code description
200 Operation successful
204 No content
401 Unauthorized
409 DCS is in a Conflicted State
404 Not Found
500 Internal Error