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"
417 "$ref": "#/definitions/requestInfo"
420 "$ref": "#/definitions/routeInfo"
429 "description": "A unique ID to track an ONAP transaction."
433 "description": "A unique ID to track multiple requests associated with a transaction."
437 "description": "The end point of a callback service where recommendations are posted."
441 "description": "The header information a client expecting in a async callback."
445 "description": "The unique ID of a client making an optimization call."
450 "description": "The type of request being placed.",
460 "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."
463 "description": "A list of optimization services that can be used to resolve the route",
472 "description": "A tolerance window (in secs) for expecting solutions. Default is 600 secs."
480 "$ref": "#/definitions/routeRequest"
488 "$ref": "#/definitions/routePortInfo"
491 "$ref": "#/definitions/routePortInfo"
498 "accessTopologyId": {
500 "description": "A unique ID of the Access Topology."
505 "description": "A unique ID of the client which provides the access."
507 "accessProviderId": {
510 "description": "A unique ID of the access provider"
515 "description": "A unique ID of the node to/from which the route has to be established."
520 "description": "A unique ID of the Termination Point to/from which the route has to be established."
524 "routeResponseBody": {
529 "description": "A unique Id for an ONAP transaction."
533 "description": "A unique ID to track multiple requests associated with a transaction."
537 "description": "Reasoning if a requestStatus is failure."
541 "description": "The status of a request."
544 "$ref": "#/definitions/RouteSolutionInfo"
548 "RouteSolutionInfo": {
553 "format": "date-time",
554 "description": "start time of the operation in RFC 3339 notation for example, 2017-07-21T17:32:28Z."
558 "format": "date-time",
559 "description": "end time of the operation in RFC 3339 notation for example, 2017-07-21T17:32:28Z."
562 "description": "A list of vpn info that can be used to establish the route between source and destination port/node.",
565 "$ref": "#/definitions/link"
575 "description": "Id or name identifies a link uniquely."
579 "PlacementRequest": {
589 "$ref": "#/definitions/RequestInfo"
592 "$ref": "#/definitions/PlacementInfo"
595 "$ref": "#/definitions/LicenseInfo"
598 "$ref": "#/definitions/ServiceInfo"
617 "description": "unique ID to track an ONAP transaction",
618 "example": "d290f1ee-6c54-4b01-90e6-d701748f0851"
623 "description": "A unique ID to track multiple requests associated with a transaction",
624 "example": "d290f1ee-6c54-4b01-90e6-d701748f0851"
629 "description": "The end point of a callback service where recommendations are posted.",
630 "example": "myDomain.com/myCallback"
634 "description": "JSON blob. The header information a client expecting in a async callback.",
641 "description": "The unique ID of a client making an optimization call.",
642 "example": "d290f1ee-6c54-4b01-90e6-d701748f0851"
651 "description": "The type of a request",
656 "description": "Expected number of solutions.",
669 "description": "A list of optimization services.",
676 "description": "A tolerance window (in second) for expecting solutions.",
688 "requestParameters": {
690 "description": "JSON blob. A service ordering information",
695 "placementDemands": {
698 "$ref": "#/definitions/PlacementDemand"
700 "description": "The resource information for a placement service"
705 "$ref": "#/definitions/SubscriberInfo"
707 "description": "The information of a service subscriber."
714 "resourceModuleName",
719 "resourceModuleName": {
721 "description": "A resource name as defined in a service mode",
722 "example": "myResourceName"
724 "serviceResourceId": {
726 "description": "A unique resource Id with a local scope between client and OOF.",
727 "example": "myResourceId"
731 "additionalProperties": {
742 "description": "placement parameters defined in the ordering system, keyname include tenantId",
747 "resourceModelInfo": {
748 "$ref": "#/definitions/ModelMetaData"
750 "existingCandidates": {
751 "$ref": "#/definitions/Candidates"
753 "excludedCandidates": {
754 "$ref": "#/definitions/Candidates"
756 "requiredCandidates": {
757 "$ref": "#/definitions/Candidates"
768 "modelInvariantId": {
770 "description": "A model invariant Id as defined in a service model.",
771 "example": "my model invariant Id"
775 "description": "A unique model Id as defined in a service model.",
776 "example": "my unique model Id"
780 "description": "A model name as defined in a service model",
781 "example": "my model name"
785 "description": "A model type as defined in a service model.",
786 "example": "my model type"
790 "description": "A model version as defined in a service model.",
791 "example": "my model version"
793 "modelCustomizationName": {
795 "description": "A model customization name as defined in a service model.",
796 "example": "my model customization"
810 "service_instance_id",
814 "description": "The type of a candidate.",
815 "example": "service_instance_id"
822 "description": "A list of identifiers.",
823 "example": "candidateId"
827 "description": "The name of a cloud owner. Only required if identifierType is cloud_region_id",
828 "example": "cloud_owner"
835 "globalSubscriberId",
837 "subscriberCommonSiteId"
840 "globalSubscriberId": {
842 "description": "An ID of a subscriber.",
843 "example": "subscriber_id"
847 "description": "The name of a subscriber. If the name is not known, the value must be 'unknown'",
848 "example": "subscriber_name"
850 "subscriberCommonSiteId": {
852 "description": "Id representing a subscriber location",
853 "example": "subscriber_location_id"
866 "$ref": "#/definitions/LicenseDemands"
868 "description": "A list of resources for license selection"
875 "resourceModuleName",
880 "resourceModuleName": {
882 "description": "A resource name as defined in a service model.",
883 "example": "service_instance_id"
885 "serviceResourceId": {
887 "description": "A unique resource Id with a local scope between client and OOF.",
888 "example": "service_instance_id"
890 "resourceModelInfo": {
891 "$ref": "#/definitions/ModelMetaData"
893 "existingLicenses": {
894 "$ref": "#/definitions/LicenseModel"
901 "entitlementPoolUUID",
902 "licenseKeyGroupUUID"
905 "entitlementPoolUUID": {
911 "description": "Entitlement pool UUIDs associated with a resource.",
912 "example": "candidateId"
914 "licenseKeyGroupUUID": {
920 "description": "License key groups associated with a resource",
921 "example": "candidateId"
925 "SynchronousResponse": {
936 "description": "A unique Id for an ONAP transaction",
937 "example": "ONAP transaction id"
942 "description": "A unique ID to track multiple requests associated with a transaction.",
943 "example": "requests id"
947 "description": "Reasoning if a requestStatus is failure.",
948 "example": "requestStatus"
956 "description": "The status of a request.",
961 "PlacementAsynchronousResponse": {
973 "description": "A unique Id for an ONAP transaction",
974 "example": "ONAP transaction id"
979 "description": "A unique ID to track multiple requests associated with a transaction.",
980 "example": "requests id"
984 "description": "Reasoning if a requestStatus is failure.",
985 "example": "requestStatus"
993 "description": "The status of a request.",
997 "$ref": "#/definitions/Solutions"
1004 "placementSolutions",
1008 "placementSolutions": {
1011 "$ref": "#/definitions/ComprehensiveSolution"
1013 "description": "A list of placement solutions."
1015 "licenseSolutions": {
1018 "$ref": "#/definitions/LicenseSolution"
1020 "description": "A list of license solutions."
1024 "ComprehensiveSolution": {
1027 "placementSolutions"
1030 "placementSolutions": {
1033 "$ref": "#/definitions/PlacementSolution"
1035 "description": "A list of placement solutions."
1039 "PlacementSolution": {
1042 "resourceModuleName",
1043 "serviceResourceId",
1048 "resourceModuleName": {
1050 "description": "The name of a resource as defined in the service model",
1051 "example": "resource name"
1053 "serviceResourceId": {
1055 "description": "A resource Id as defined in a service model.",
1056 "example": "resource id"
1061 "service_instance_id"
1063 "description": "The type of a candidate.",
1064 "example": "candidate type"
1068 "description": "The id of a candidate.",
1069 "example": "candidate id"
1074 "$ref": "#/definitions/AssignmentInfo"
1076 "description": "Additional information related to a candidate."
1089 "description": "An attribute name",
1090 "example": "attribute name"
1094 "description": "An attribute value.",
1095 "example": "attribute value"
1099 "LicenseSolution": {
1102 "resourceModuleName",
1103 "serviceResourceId",
1104 "entitlementPoolUUID",
1105 "licenseKeyGroupUUID",
1106 "entitlementPoolInvariantUUID",
1107 "licenseKeyGroupInvariantUUID"
1110 "resourceModuleName": {
1112 "description": "A resource name as defined in a service",
1113 "example": "resource name"
1115 "serviceResourceId": {
1117 "description": "A resource Id as defined in a service.",
1118 "example": "resource Id"
1120 "entitlementPoolUUID": {
1126 "description": "A list of entitlementPoolUUIDs",
1127 "example": "entitlementPoolUUID"
1129 "licenseKeyGroupUUID": {
1135 "description": "A list of licenseKeyGroupUUID.",
1136 "example": "licenseKeyGroupUUID"
1138 "entitlementPoolInvariantUUID": {
1144 "description": "A list of entitlementPoolInvariantUUID",
1145 "example": "entitlementPoolInvariantUUID"
1147 "licenseKeyGroupInvariantUUID": {
1153 "description": "A list of licenseKeyGroupInvariantUUID",
1154 "example": "licenseKeyGroupInvariantUUID"
1161 "serviceInstanceId",
1166 "serviceInstanceId": {
1168 "description": "A service instance id associated with a request.",
1169 "example": "service_instance_id"
1172 "$ref": "#/definitions/ModelMetaData"
1176 "description": "The name of a service",
1177 "example": "service_name"
1189 "$ref": "#/definitions/RequestInfo"
1192 "$ref": "#/definitions/CellInfo"
1207 "description": "Id of network requiring PCI optimization",
1215 "description": "List of cellIds triggering need for PCI optimization (eg.potential confusion)",
1224 "$ref": "#/definitions/ANRInfo"
1226 "description": "A list of ANR Input."
1233 "description": "List of blacklisted cells whose PCI values should not be changed",
1239 "priorityTreatmentCells": {
1244 "description": "List of cells which should be given special treatment during optimization",
1252 "description": "Type of trigger causing need for PCI optimization",
1253 "example": "NbrListChange"
1257 "PCIAsynchronousResponse": {
1269 "description": "A unique Id for an ONAP transaction",
1270 "example": "ONAP transaction id"
1275 "description": "A unique ID to track multiple requests associated with a transaction.",
1276 "example": "requests id"
1280 "description": "Reasoning if a requestStatus is failure.",
1281 "example": "requestStatus"
1289 "description": "The status of a request.",
1290 "example": "success"
1293 "$ref": "#/definitions/PCIANRSolutions"
1297 "PCIANRSolutions": {
1307 "description": "Id of network requiring PCI optimization",
1313 "$ref": "#/definitions/PCISolution"
1315 "description": "A list of PCI solutions."
1320 "$ref": "#/definitions/ANRInfo"
1322 "description": "A list of ANR solutions."
1335 "description": "cellId with modified PCI value",
1336 "example": "cell0001"
1340 "description": "New PCI value for cellId",
1349 "removeableNeighbors"
1354 "description": "cellId with modified PCI value",
1355 "example": "cell0001"
1357 "removeableNeighbors": {
1362 "description": "List of neighbors to be removed",
1370 "NSTSelectionRequest": {
1378 "$ref": "#/definitions/RequestInfo2"
1381 "$ref": "#/definitions/ServiceProfileNst"
1385 "NSISelectionRequest": {
1394 "$ref": "#/definitions/ServiceProfile"
1397 "$ref": "#/definitions/RequestInfo2"
1401 "description": "List of NST(s)",
1403 "$ref": "#/definitions/NSTInfo"
1408 "NSSISelectionRequest": {
1417 "$ref": "#/definitions/SliceProfile"
1420 "$ref": "#/definitions/RequestInfo2"
1423 "$ref": "#/definitions/NSSTInfo"
1437 "description": "UUID of NST"
1442 "description": "Invariant UUID"
1456 "description": "UUID of NSST"
1461 "description": "Invariant UUID"
1467 "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.",
1472 "ServiceProfileNst": {
1475 "serviceProfileParameters"
1478 "serviceProfileParameters": {
1479 "$ref": "#/definitions/ServiceProfile"
1485 "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.",
1502 "description": "unique ID to track an ONAP transaction",
1503 "example": "d290f1ee-6c54-4b01-90e6-d701748f0851"
1508 "description": "A unique ID to track multiple requests associated with a transaction",
1509 "example": "d290f1ee-6c54-4b01-90e6-d701748f0851"
1514 "description": "The end point of a callback service where recommendations are posted.",
1515 "example": "myDomain.com/myCallback"
1519 "description": "JSON blob. The header information a client expecting in a async callback.",
1526 "description": "The unique ID of a client making an optimization call.",
1527 "example": "d290f1ee-6c54-4b01-90e6-d701748f0851"
1531 "description": "A tolerance window (in second) for expecting solutions.",
1536 "NSTAsynchronousResponse": {
1548 "description": "unique ID to track an ONAP transaction",
1549 "example": "d290f1ee-6c54-4b01-90e6-d701748f0851"
1554 "description": "A unique ID to track multiple requests associated with a transaction",
1555 "example": "d290f1ee-6c54-4b01-90e6-d701748f0851"
1559 "description": "Reasoning if a requestStatus is failed."
1568 "description": "The status of a request."
1573 "$ref": "#/definitions/NSTSolution"
1575 "description": "A list of NST solutions"
1591 "description": "Invariant UUID of NST"
1595 "format": "UUID of NST"
1599 "description": "NST name"
1603 "description": "JSON blob. Containing details of match of requirements in slice profile and percentage of fit"
1607 "NSIAsynchronousResponse": {
1619 "description": "unique ID to track an ONAP transaction",
1620 "example": "d290f1ee-6c54-4b01-90e6-d701748f0851"
1625 "description": "A unique ID to track multiple requests associated with a transaction",
1626 "example": "d290f1ee-6c54-4b01-90e6-d701748f0851"
1630 "description": "Reasoning if a requestStatus is failed."
1639 "description": "The status of a request."
1642 "$ref": "#/definitions/NSISolution"
1649 "sharedNSIsolutions": {
1652 "$ref": "#/definitions/SharedNSISolution"
1654 "description": "A list of shared NSI solutions"
1656 "newNSISolutions": {
1659 "$ref": "#/definitions/NewNSISolution"
1661 "description": "A list of new NSI solutions"
1665 "SharedNSISolution": {
1678 "description": "Invariant UUID of NST"
1683 "description": "UUID of NST"
1687 "description": "Name of NSI"
1692 "description": "Id of NSI"
1697 "$ref": "#/definitions/NSSI"
1699 "description": "A list of NSSIs"
1714 "description": "Name of NSSI"
1718 "description": "Id of NSSI"
1722 "description": "UUID of NSST"
1726 "description": "invariantUUID of NSST"
1731 "$ref": "#/definitions/SliceProfile"
1733 "description": "list of SliceProfiles"
1745 "$ref": "#/definitions/NSTResponseInfo"
1749 "description": "List of NSSIs which when concatenated shall form the NSI, in case NSSI is not present, only the sliceProfile will be included",
1751 "$ref": "#/definitions/NSSIInfo"
1756 "description": "JSON blob. Containing details of match of requirements in service profile, and recommendation rank"
1760 "NSTResponseInfo": {
1770 "description": "NST name"
1775 "description": "UUID of NST"
1780 "description": "Invariant UUID"
1792 "description": "JSON blob. Containing details of match of requirements in slice profile and percentage of fit"
1795 "$ref": "#/definitions/NSSTResponseInfo"
1798 "$ref": "#/definitions/NSSIObject"
1802 "NSSTResponseInfo": {
1812 "description": "Name of the NSST"
1817 "description": "UUID of NSST"
1822 "description": "Invariant UUID"
1836 "description": "Name of NSSI"
1840 "description": "Id of NSSI"
1844 "description": "JSON blob. Containing details of match of requirements in slice profile and percentage of fit"
1848 "NSSIAsynchronousResponse": {
1860 "description": "unique ID to track an ONAP transaction",
1861 "example": "d290f1ee-6c54-4b01-90e6-d701748f0851"
1866 "description": "A unique ID to track multiple requests associated with a transaction",
1867 "example": "d290f1ee-6c54-4b01-90e6-d701748f0851"
1871 "description": "Reasoning if a requestStatus is failed."
1880 "description": "The status of a request."
1885 "$ref": "#/definitions/NSSISolution"
1887 "description": "A list of NSSI solutions"
1904 "description": "Invariant UUID of NSST"
1909 "description": "UUID of NSST"
1913 "description": "Name of NSSI"
1917 "description": "Id of NSSI"
1921 "description": "JSON blob. Containing details of match of requirements in slice profile and percentage of fit"
1929 "host": "virtserver.swaggerhub.com",
1930 "basePath": "/oof-osdf/v1"