...
| Attribute | Required? | Cardinality | Content | Values | Description |
|---|---|---|---|---|---|
requestInfo | Y | 1 | RequestInfo Object | The content of the RequestInfo object. | |
routeRequestrouteInfo | Y | 1 | RouteRequestInfoRouteInfo | The content of Router request object |
RequestInfo Object
| Attribute | Required? | Cardinality | Content | Values | Description |
|---|---|---|---|---|---|
transactionId | Y | 1 | UUID/String | A unique ID to track an ONAP transaction. | |
requestId | Y | 1 | UUID/String | A unique ID to track multiple requests associated with a transaction. | |
callbackUrl | Y | 1 | URL | The end point of a callback service where recommendations are posted. | |
| callbackHeader | N | 1 | JSON blob | The header information a client expecting in a async callback. | |
sourceId | Y | 1 | String | The unique ID of a client making an optimization call. | |
requestType | Y | 1 | String | create, update, delete | The type of a request |
numSolutions | N | 1 | Integer | Expected number of solutions. numSolution can also be specified using an optimization query policies, where the default configured value is 1. The value from a request gets higher precedence over the value defined in a policy. | |
optimizers | Y | 1..N | List of Strings | placement | A list of optimization services. |
timeout | N | 1 | Integer | A tolerance window (in secs) for expecting solutions. Default is 600 secs. |
RouteInfo Object
| Attribute | Required? | Cardinality | Content | Values | Description |
|---|---|---|---|---|---|
routeRequest | Y | 1 | RouteRequestInfo | The content of Router request object |
RouteRequestInfo Object
| Attribute | Required? | Cardinality | Content | Values | Description |
|---|---|---|---|---|---|
| srcPort | Y | 1 | RoutePortInfo | Source port info | |
| destPort | Y | 1 | RoutePortInfo | Destination Port info |
RoutePortInfo Object
| Attribute | Required? | Cardinality | Content | Values | Description |
|---|---|---|---|---|---|
accessTopologyId | Y | 1 | String | Access Topology Id | |
accessClientId | Y | 1 | String | Client Id | |
accessProviderId | Y | 1 | String | ||
accessNodeId | Y | 1 | String | ||
accessLtpId | Y | 1 | Integer |
Synchronous Response Body
...
| Attribute | Required? | Cardinality | Content | Values | Description |
|---|---|---|---|---|---|
startTime | Y | 1 | Timestamp | ||
finishTime | Y | 1 | Timestamp | ||
VPNs | N | 0..N | List of VPNInfo | List of VPN's |
VPN Info
| Attribute | Required? | Cardinality | Content | Values | Description |
|---|---|---|---|---|---|
accessTopologyId | Y | 1 | String | Access Topology Id | |
accessClientId | Y | 1 | String | ||
accessProviderId | Y | 1 | String | ||
accessNodeId | Y | 1 | String | ||
srcAccessLtpId | Y | 1 | Integer | ||
dstAccessLtpId | Y | 1 | Integer |
HTTP Response Code
| HTTP Code | Response Phrase | Description |
|---|---|---|
201 | Created | An optimization solution is found. |
202 | Accepted | An optimization request is accepted. |
400 | Bad request | Bad request. |
401 | Unauthorized | Request body is not compliant with the API definition. |
404 | Not found | The server cannot find the requested URI. |
405 | Method not found | The requested method is not supported by a server. |
500 | Internal server error | The server encountered an internal server error or timed out. |
| 520 | Solver error | Requested number of solutions cannot be found. |
...
| Code Block | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"requestInfo": {
"transactionId": "xxx-xxx-xxxx",
"requestId": "yyy-yyy-yyyy",
"callbackUrl": "https://wiki.onap.org:5000/callbackUrl",
"sourceId": "",
"requestType": "create",
"numSolutions": 1,
"optimizers": [
"route"
],
"timeout": 600
},
"routeInfo": {
"routeRequest": {
"srcPort": {
{ "accessTopologyId": "Topo113",
"accessClientId": "clientU12",
"accessProviderId": "VDF1234",
"accessNodeId": "Node123",
"accessLtpId": "1345"
},
"dstPort": {
{ "accessTopologyId": "Topo3421",
"accessClientId": "clientD123",
"accessProviderId": "VDF3214",
"accessNodeId": "node323",
"accessLtpId": "3452"
}
}
},
} |
Synchronous Response Example
...
| Code Block | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
{
"transactionId": "xxx-xxx-xxxx",
"requestId": "yyy-yyy-yyyy",
"requestStatus": "accepted",
"statusMessage": "",
"solutions": [
{
"startTime": "2016-10-01T00:30+01:00",
" "finishTime": "2016-10-01T00:40+01.00",
"VPNs": [
{
"accessTopologyId": ”Topo123”"Topo123",
"accessClientId": “client"client-123”123",
"accessProviderId": “provider"provider-123”123",
"accessNodeId": “node"node-123”123",
"srcAccessLtpId": “ltp"ltp-src-123”123",
"dstAccessLtpId": “ltp"ltp-dst-123”123"
}
]
] } }
]
} |