4 "description": "This is the ONAP OOF OSDF (Optimization Service Design Framework) API",
8 "email": "frank.sandoval@oamtechnologies.com"
12 "url": "http://www.apache.org/licenses/LICENSE-2.0.html"
15 "securityDefinitions": {
18 "description": "HTTP Basic Auth"
30 "Placement Optimization"
32 "summary": "create/update a placement",
33 "operationId": "createPlacement",
34 "description": "create/update a placement",
44 "name": "placementRequest",
45 "description": "placement request",
47 "$ref": "#/definitions/PlacementRequest"
53 "description": "An optimization solution is found."
56 "description": "An optimization request is accepted"
59 "description": "bad request"
62 "description": "Request body is not compliant with the API definition"
65 "description": "The server cannot find the requested URI"
68 "description": "The requested method is not supported by a server."
71 "description": "The server encountered an internal server error or timed out"
76 "/api/oof/placement/v1": {
79 "Placement Optimization"
81 "summary": "create/update a placement",
82 "operationId": "createPlacementv1",
83 "description": "create/update a placement",
93 "name": "placementRequest",
94 "description": "placement request",
96 "$ref": "#/definitions/PlacementRequest"
102 "description": "An optimization solution is found."
105 "description": "An optimization request is accepted"
108 "description": "bad request"
111 "description": "Request body is not compliant with the API definition"
114 "description": "The server cannot find the requested URI"
117 "description": "The requested method is not supported by a server."
120 "description": "The server encountered an internal server error or timed out"
128 "PCI/ANR Optimization"
130 "summary": "Initiate PCI/ANR Optimization",
131 "operationId": "initiatePCIOptRequest",
132 "description": "Initiate PCI/ANR Optimization",
142 "name": "PCIOptimizationRequest",
143 "description": "PCI request",
145 "$ref": "#/definitions/PCIOptRequest"
151 "description": "An optimization solution is found."
154 "description": "An optimization request is accepted"
157 "description": "bad request"
160 "description": "Request body is not compliant with the API definition"
163 "description": "The server cannot find the requested URI"
166 "description": "The requested method is not supported by a server."
169 "description": "The server encountered an internal server error or timed out"
177 "PCI/ANR Optimization"
179 "summary": "Initiate PCI/ANR Optimization",
180 "operationId": "initiatePCIOptRequestv1",
181 "description": "Initiate PCI/ANR Optimization",
191 "name": "PCIOptimizationRequest",
192 "description": "PCI request",
194 "$ref": "#/definitions/PCIOptRequest"
200 "description": "An optimization solution is found."
203 "description": "An optimization request is accepted"
206 "description": "bad request"
209 "description": "Request body is not compliant with the API definition"
212 "description": "The server cannot find the requested URI"
215 "description": "The requested method is not supported by a server."
218 "description": "The server encountered an internal server error or timed out"
223 "/api/oof/selection/nst/v1": {
228 "summary": "NST selection",
229 "operationId": "selectNstRequest",
230 "description": "Request for NST selection",
240 "name": "NSTSelectionRequest",
241 "description": "nst selection request",
243 "$ref": "#/definitions/NSTSelectionRequest"
249 "description": "An optimization request is accepted",
251 "$ref": "#/definitions/SynchronousResponse"
255 "description": "bad request"
258 "description": "Request body is not compliant with the API definition"
261 "description": "The server cannot find the requested URI"
264 "description": "The requested method is not supported by a server."
267 "description": "The server encountered an internal server error or timed out"
272 "/api/oof/selection/nsi/v1": {
277 "summary": "NSI selection",
278 "operationId": "selectNsiRequest",
279 "description": "Request for NSI selection",
289 "name": "NSISelectionRequest",
290 "description": "NSI selection request",
292 "$ref": "#/definitions/NSISelectionRequest"
298 "description": "An optimization request is accepted",
300 "$ref": "#/definitions/SynchronousResponse"
304 "description": "bad request"
307 "description": "Request body is not compliant with the API definition"
310 "description": "The server cannot find the requested URI"
313 "description": "The requested method is not supported by a server."
316 "description": "The server encountered an internal server error or timed out"
321 "/api/oof/selection/nssi/v1": {
326 "summary": "NSSI selection",
327 "operationId": "selectNssiRequest",
328 "description": "Request for NSSI selection",
338 "name": "NSSISelectionRequest",
339 "description": "NSSI selection request",
341 "$ref": "#/definitions/NSSISelectionRequest"
347 "description": "An optimization request is accepted",
349 "$ref": "#/definitions/SynchronousResponse"
353 "description": "bad request"
356 "description": "Request body is not compliant with the API definition"
359 "description": "The server cannot find the requested URI"
362 "description": "The requested method is not supported by a server."
365 "description": "The server encountered an internal server error or timed out"
370 "/api/oof/route/v1": {
375 "summary": "Find the optimistic route between OTN domains",
377 "operationId": "getRoute",
388 "description": "Source and Destination nodes across which optmistic route have to be obtained.",
391 "$ref": "#/definitions/RouteRequest"
397 "description": "successful operation",
401 "$ref": "#/definitions/routeResponseBody"
406 "description": "Invalid input"
411 "/api/oof/mdons/route/v1": {
414 "Inter Domain Route Select"
416 "summary":"Find the optimistic inter domain route for multi domain optical system",
418 "operationId":"getInterDomainRoute",
429 "description":"Source and Destination interfaces across which optmistic route have to be obtained.",
432 "$ref":"#/definitions/InterDomainRouteRequest"
438 "description":"successful operation",
440 "$ref":"#/definitions/InterDomainRouteResponseBody"
444 "description":"bad request"
447 "description":"Request body is not compliant with the API definition"
450 "description":"The server cannot find the requested URI"
453 "description":"The requested method is not supported by a server."
456 "description":"The server encountered an internal server error or timed out"
463 "InterDomainRouteRequest":{
467 "$ref":"#/definitions/requestInfo"
470 "$ref":"#/definitions/interDomainRouteInfo"
474 "interDomainRouteInfo":{
478 "$ref":"#/definitions/interDomainRouteRequest"
482 "interDomainRouteRequest":{
486 "$ref":"#/definitions/interDomainPortDetails"
489 "$ref":"#/definitions/interDomainPortDetails"
493 "description":"The rate of the service."
497 "interDomainPortDetails":{
502 "description":"The port id."
506 "description":"The node id."
510 "description":"The controller id to which the node belongs to."
514 "InterDomainRouteResponseBody":{
519 "description":"A unique Id for an ONAP transaction."
523 "description":"A unique ID to track multiple requests associated with a transaction."
527 "description":"Reasoning if a requestStatus is failure."
531 "description":"The status of a request."
534 "$ref":"#/definitions/InterDomainRouteSolutionInfo"
538 "InterDomainRouteSolutionInfo":{
542 "$ref":"#/definitions/interDomainResponseRouteinfo"
546 "interDomainResponseRouteinfo":{
552 "$ref":"#/definitions/serviceRouteDetails"
560 "description":"A list of link names of the route.",
568 "serviceRouteDetails":{
573 "description":"Source port Id of the domain Service."
577 "description":"Destination Port Id of the domain Service."
581 "description":"Controller Id of the domain."
589 "$ref": "#/definitions/requestInfo"
592 "$ref": "#/definitions/routeInfo"
601 "description": "A unique ID to track an ONAP transaction."
605 "description": "A unique ID to track multiple requests associated with a transaction."
609 "description": "The end point of a callback service where recommendations are posted."
613 "description": "The header information a client expecting in a async callback."
617 "description": "The unique ID of a client making an optimization call."
622 "description": "The type of request being placed.",
632 "description": "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."
635 "description": "A list of optimization services that can be used to resolve the route",
644 "description": "A tolerance window (in secs) for expecting solutions. Default is 600 secs."
652 "$ref": "#/definitions/routeRequest"
660 "$ref": "#/definitions/routePortInfo"
663 "$ref": "#/definitions/routePortInfo"
670 "accessTopologyId": {
672 "description": "A unique ID of the Access Topology."
677 "description": "A unique ID of the client which provides the access."
679 "accessProviderId": {
682 "description": "A unique ID of the access provider"
687 "description": "A unique ID of the node to/from which the route has to be established."
692 "description": "A unique ID of the Termination Point to/from which the route has to be established."
696 "routeResponseBody": {
701 "description": "A unique Id for an ONAP transaction."
705 "description": "A unique ID to track multiple requests associated with a transaction."
709 "description": "Reasoning if a requestStatus is failure."
713 "description": "The status of a request."
716 "$ref": "#/definitions/RouteSolutionInfo"
720 "RouteSolutionInfo": {
725 "format": "date-time",
726 "description": "start time of the operation in RFC 3339 notation for example, 2017-07-21T17:32:28Z."
730 "format": "date-time",
731 "description": "end time of the operation in RFC 3339 notation for example, 2017-07-21T17:32:28Z."
734 "description": "A list of vpn info that can be used to establish the route between source and destination port/node.",
737 "$ref": "#/definitions/link"
747 "description": "Id or name identifies a link uniquely."
751 "PlacementRequest": {
761 "$ref": "#/definitions/RequestInfo"
764 "$ref": "#/definitions/PlacementInfo"
767 "$ref": "#/definitions/LicenseInfo"
770 "$ref": "#/definitions/ServiceInfo"
789 "description": "unique ID to track an ONAP transaction",
790 "example": "d290f1ee-6c54-4b01-90e6-d701748f0851"
795 "description": "A unique ID to track multiple requests associated with a transaction",
796 "example": "d290f1ee-6c54-4b01-90e6-d701748f0851"
801 "description": "The end point of a callback service where recommendations are posted.",
802 "example": "myDomain.com/myCallback"
806 "description": "JSON blob. The header information a client expecting in a async callback.",
813 "description": "The unique ID of a client making an optimization call.",
814 "example": "d290f1ee-6c54-4b01-90e6-d701748f0851"
823 "description": "The type of a request",
828 "description": "Expected number of solutions.",
841 "description": "A list of optimization services.",
848 "description": "A tolerance window (in second) for expecting solutions.",
860 "requestParameters": {
862 "description": "JSON blob. A service ordering information",
867 "placementDemands": {
870 "$ref": "#/definitions/PlacementDemand"
872 "description": "The resource information for a placement service"
877 "$ref": "#/definitions/SubscriberInfo"
879 "description": "The information of a service subscriber."
886 "resourceModuleName",
891 "resourceModuleName": {
893 "description": "A resource name as defined in a service mode",
894 "example": "myResourceName"
896 "serviceResourceId": {
898 "description": "A unique resource Id with a local scope between client and OOF.",
899 "example": "myResourceId"
903 "additionalProperties": {
914 "description": "placement parameters defined in the ordering system, keyname include tenantId",
919 "resourceModelInfo": {
920 "$ref": "#/definitions/ModelMetaData"
922 "existingCandidates": {
923 "$ref": "#/definitions/Candidates"
925 "excludedCandidates": {
926 "$ref": "#/definitions/Candidates"
928 "requiredCandidates": {
929 "$ref": "#/definitions/Candidates"
940 "modelInvariantId": {
942 "description": "A model invariant Id as defined in a service model.",
943 "example": "my model invariant Id"
947 "description": "A unique model Id as defined in a service model.",
948 "example": "my unique model Id"
952 "description": "A model name as defined in a service model",
953 "example": "my model name"
957 "description": "A model type as defined in a service model.",
958 "example": "my model type"
962 "description": "A model version as defined in a service model.",
963 "example": "my model version"
965 "modelCustomizationName": {
967 "description": "A model customization name as defined in a service model.",
968 "example": "my model customization"
982 "service_instance_id",
986 "description": "The type of a candidate.",
987 "example": "service_instance_id"
994 "description": "A list of identifiers.",
995 "example": "candidateId"
999 "description": "The name of a cloud owner. Only required if identifierType is cloud_region_id",
1000 "example": "cloud_owner"
1007 "globalSubscriberId",
1009 "subscriberCommonSiteId"
1012 "globalSubscriberId": {
1014 "description": "An ID of a subscriber.",
1015 "example": "subscriber_id"
1019 "description": "The name of a subscriber. If the name is not known, the value must be 'unknown'",
1020 "example": "subscriber_name"
1022 "subscriberCommonSiteId": {
1024 "description": "Id representing a subscriber location",
1025 "example": "subscriber_location_id"
1038 "$ref": "#/definitions/LicenseDemands"
1040 "description": "A list of resources for license selection"
1047 "resourceModuleName",
1048 "serviceResourceId",
1052 "resourceModuleName": {
1054 "description": "A resource name as defined in a service model.",
1055 "example": "service_instance_id"
1057 "serviceResourceId": {
1059 "description": "A unique resource Id with a local scope between client and OOF.",
1060 "example": "service_instance_id"
1062 "resourceModelInfo": {
1063 "$ref": "#/definitions/ModelMetaData"
1065 "existingLicenses": {
1066 "$ref": "#/definitions/LicenseModel"
1073 "entitlementPoolUUID",
1074 "licenseKeyGroupUUID"
1077 "entitlementPoolUUID": {
1083 "description": "Entitlement pool UUIDs associated with a resource.",
1084 "example": "candidateId"
1086 "licenseKeyGroupUUID": {
1092 "description": "License key groups associated with a resource",
1093 "example": "candidateId"
1097 "SynchronousResponse": {
1108 "description": "A unique Id for an ONAP transaction",
1109 "example": "ONAP transaction id"
1114 "description": "A unique ID to track multiple requests associated with a transaction.",
1115 "example": "requests id"
1119 "description": "Reasoning if a requestStatus is failure.",
1120 "example": "requestStatus"
1128 "description": "The status of a request.",
1129 "example": "success"
1133 "PlacementAsynchronousResponse": {
1145 "description": "A unique Id for an ONAP transaction",
1146 "example": "ONAP transaction id"
1151 "description": "A unique ID to track multiple requests associated with a transaction.",
1152 "example": "requests id"
1156 "description": "Reasoning if a requestStatus is failure.",
1157 "example": "requestStatus"
1165 "description": "The status of a request.",
1166 "example": "success"
1169 "$ref": "#/definitions/Solutions"
1176 "placementSolutions",
1180 "placementSolutions": {
1183 "$ref": "#/definitions/ComprehensiveSolution"
1185 "description": "A list of placement solutions."
1187 "licenseSolutions": {
1190 "$ref": "#/definitions/LicenseSolution"
1192 "description": "A list of license solutions."
1196 "ComprehensiveSolution": {
1199 "placementSolutions"
1202 "placementSolutions": {
1205 "$ref": "#/definitions/PlacementSolution"
1207 "description": "A list of placement solutions."
1211 "PlacementSolution": {
1214 "resourceModuleName",
1215 "serviceResourceId",
1220 "resourceModuleName": {
1222 "description": "The name of a resource as defined in the service model",
1223 "example": "resource name"
1225 "serviceResourceId": {
1227 "description": "A resource Id as defined in a service model.",
1228 "example": "resource id"
1233 "service_instance_id"
1235 "description": "The type of a candidate.",
1236 "example": "candidate type"
1240 "description": "The id of a candidate.",
1241 "example": "candidate id"
1246 "$ref": "#/definitions/AssignmentInfo"
1248 "description": "Additional information related to a candidate."
1261 "description": "An attribute name",
1262 "example": "attribute name"
1266 "description": "An attribute value.",
1267 "example": "attribute value"
1271 "LicenseSolution": {
1274 "resourceModuleName",
1275 "serviceResourceId",
1276 "entitlementPoolUUID",
1277 "licenseKeyGroupUUID",
1278 "entitlementPoolInvariantUUID",
1279 "licenseKeyGroupInvariantUUID"
1282 "resourceModuleName": {
1284 "description": "A resource name as defined in a service",
1285 "example": "resource name"
1287 "serviceResourceId": {
1289 "description": "A resource Id as defined in a service.",
1290 "example": "resource Id"
1292 "entitlementPoolUUID": {
1298 "description": "A list of entitlementPoolUUIDs",
1299 "example": "entitlementPoolUUID"
1301 "licenseKeyGroupUUID": {
1307 "description": "A list of licenseKeyGroupUUID.",
1308 "example": "licenseKeyGroupUUID"
1310 "entitlementPoolInvariantUUID": {
1316 "description": "A list of entitlementPoolInvariantUUID",
1317 "example": "entitlementPoolInvariantUUID"
1319 "licenseKeyGroupInvariantUUID": {
1325 "description": "A list of licenseKeyGroupInvariantUUID",
1326 "example": "licenseKeyGroupInvariantUUID"
1333 "serviceInstanceId",
1338 "serviceInstanceId": {
1340 "description": "A service instance id associated with a request.",
1341 "example": "service_instance_id"
1344 "$ref": "#/definitions/ModelMetaData"
1348 "description": "The name of a service",
1349 "example": "service_name"
1361 "$ref": "#/definitions/RequestInfo"
1364 "$ref": "#/definitions/CellInfo"
1379 "description": "Id of network requiring PCI optimization",
1387 "description": "List of cellIds triggering need for PCI optimization (eg.potential confusion)",
1396 "$ref": "#/definitions/ANRInfo"
1398 "description": "A list of ANR Input."
1405 "description": "List of blacklisted cells whose PCI values should not be changed",
1411 "priorityTreatmentCells": {
1416 "description": "List of cells which should be given special treatment during optimization",
1424 "description": "Type of trigger causing need for PCI optimization",
1425 "example": "NbrListChange"
1429 "PCIAsynchronousResponse": {
1441 "description": "A unique Id for an ONAP transaction",
1442 "example": "ONAP transaction id"
1447 "description": "A unique ID to track multiple requests associated with a transaction.",
1448 "example": "requests id"
1452 "description": "Reasoning if a requestStatus is failure.",
1453 "example": "requestStatus"
1461 "description": "The status of a request.",
1462 "example": "success"
1465 "$ref": "#/definitions/PCIANRSolutions"
1469 "PCIANRSolutions": {
1479 "description": "Id of network requiring PCI optimization",
1485 "$ref": "#/definitions/PCISolution"
1487 "description": "A list of PCI solutions."
1492 "$ref": "#/definitions/ANRInfo"
1494 "description": "A list of ANR solutions."
1507 "description": "cellId with modified PCI value",
1508 "example": "cell0001"
1512 "description": "New PCI value for cellId",
1521 "removeableNeighbors"
1526 "description": "cellId with modified PCI value",
1527 "example": "cell0001"
1529 "removeableNeighbors": {
1534 "description": "List of neighbors to be removed",
1542 "NSTSelectionRequest": {
1550 "$ref": "#/definitions/RequestInfo2"
1553 "$ref": "#/definitions/ServiceProfileNst"
1557 "NSISelectionRequest": {
1566 "$ref": "#/definitions/ServiceProfile"
1569 "$ref": "#/definitions/RequestInfo2"
1573 "description": "List of NST(s)",
1575 "$ref": "#/definitions/NSTInfo"
1580 "NSSISelectionRequest": {
1589 "$ref": "#/definitions/SliceProfile"
1592 "$ref": "#/definitions/RequestInfo2"
1595 "$ref": "#/definitions/NSSTInfo"
1609 "description": "UUID of NST"
1614 "description": "Invariant UUID"
1628 "description": "UUID of NSST"
1633 "description": "Invariant UUID"
1639 "description": "JSON blob. Containing service profile parameters. The contents are based on 3GPP TS 23.541 Release 16 contents, and will be in the form of attribute value pairs.",
1644 "ServiceProfileNst": {
1647 "serviceProfileParameters"
1650 "serviceProfileParameters": {
1651 "$ref": "#/definitions/ServiceProfile"
1657 "description": "JSON blob. Containing slice profile parameters. The contents are based on 3GPP TS 23.541 Release 16 contents, and will be in the form of attribute value pairs.",
1674 "description": "unique ID to track an ONAP transaction",
1675 "example": "d290f1ee-6c54-4b01-90e6-d701748f0851"
1680 "description": "A unique ID to track multiple requests associated with a transaction",
1681 "example": "d290f1ee-6c54-4b01-90e6-d701748f0851"
1686 "description": "The end point of a callback service where recommendations are posted.",
1687 "example": "myDomain.com/myCallback"
1691 "description": "JSON blob. The header information a client expecting in a async callback.",
1698 "description": "The unique ID of a client making an optimization call.",
1699 "example": "d290f1ee-6c54-4b01-90e6-d701748f0851"
1703 "description": "A tolerance window (in second) for expecting solutions.",
1708 "NSTAsynchronousResponse": {
1720 "description": "unique ID to track an ONAP transaction",
1721 "example": "d290f1ee-6c54-4b01-90e6-d701748f0851"
1726 "description": "A unique ID to track multiple requests associated with a transaction",
1727 "example": "d290f1ee-6c54-4b01-90e6-d701748f0851"
1731 "description": "Reasoning if a requestStatus is failed."
1740 "description": "The status of a request."
1745 "$ref": "#/definitions/NSTSolution"
1747 "description": "A list of NST solutions"
1763 "description": "Invariant UUID of NST"
1767 "format": "UUID of NST"
1771 "description": "NST name"
1775 "description": "JSON blob. Containing details of match of requirements in slice profile and percentage of fit"
1779 "NSIAsynchronousResponse": {
1791 "description": "unique ID to track an ONAP transaction",
1792 "example": "d290f1ee-6c54-4b01-90e6-d701748f0851"
1797 "description": "A unique ID to track multiple requests associated with a transaction",
1798 "example": "d290f1ee-6c54-4b01-90e6-d701748f0851"
1802 "description": "Reasoning if a requestStatus is failed."
1811 "description": "The status of a request."
1814 "$ref": "#/definitions/NSISolution"
1821 "sharedNSIsolutions": {
1824 "$ref": "#/definitions/SharedNSISolution"
1826 "description": "A list of shared NSI solutions"
1828 "newNSISolutions": {
1831 "$ref": "#/definitions/NewNSISolution"
1833 "description": "A list of new NSI solutions"
1837 "SharedNSISolution": {
1850 "description": "Invariant UUID of NST"
1855 "description": "UUID of NST"
1859 "description": "Name of NSI"
1864 "description": "Id of NSI"
1869 "$ref": "#/definitions/NSSI"
1871 "description": "A list of NSSIs"
1886 "description": "Name of NSSI"
1890 "description": "Id of NSSI"
1894 "description": "UUID of NSST"
1898 "description": "invariantUUID of NSST"
1903 "$ref": "#/definitions/SliceProfile"
1905 "description": "list of SliceProfiles"
1917 "$ref": "#/definitions/NSTResponseInfo"
1921 "description": "List of NSSIs which when concatenated shall form the NSI, in case NSSI is not present, only the sliceProfile will be included",
1923 "$ref": "#/definitions/NSSIInfo"
1928 "description": "JSON blob. Containing details of match of requirements in service profile, and recommendation rank"
1932 "NSTResponseInfo": {
1942 "description": "NST name"
1947 "description": "UUID of NST"
1952 "description": "Invariant UUID"
1964 "description": "JSON blob. Containing details of match of requirements in slice profile and percentage of fit"
1967 "$ref": "#/definitions/NSSTResponseInfo"
1970 "$ref": "#/definitions/NSSIObject"
1974 "NSSTResponseInfo": {
1984 "description": "Name of the NSST"
1989 "description": "UUID of NSST"
1994 "description": "Invariant UUID"
2008 "description": "Name of NSSI"
2012 "description": "Id of NSSI"
2016 "description": "JSON blob. Containing details of match of requirements in slice profile and percentage of fit"
2020 "NSSIAsynchronousResponse": {
2032 "description": "unique ID to track an ONAP transaction",
2033 "example": "d290f1ee-6c54-4b01-90e6-d701748f0851"
2038 "description": "A unique ID to track multiple requests associated with a transaction",
2039 "example": "d290f1ee-6c54-4b01-90e6-d701748f0851"
2043 "description": "Reasoning if a requestStatus is failed."
2052 "description": "The status of a request."
2057 "$ref": "#/definitions/NSSISolution"
2059 "description": "A list of NSSI solutions"
2076 "description": "Invariant UUID of NSST"
2081 "description": "UUID of NSST"
2085 "description": "Name of NSSI"
2089 "description": "Id of NSSI"
2093 "description": "JSON blob. Containing details of match of requirements in slice profile and percentage of fit"
2101 "host": "virtserver.swaggerhub.com",
2102 "basePath": "/oof-osdf/v1"