1 =================================================
2 ONAP VFC Network Service Lifecycle Management API
3 =================================================
14 VFC Network Service Lifecycle Management Rest API.
24 | *Contact* : ONAP VFC team
25 | *Contact Email* : onap-discuss@lists.onap.org
30 | *BasePath* : /api/nslcm/v1
31 | *Schemes* : HTTP, HTTPS
36 - ``application/json``
41 - ``application/json``
56 +---------+-------------+--------------------------------------+------------------+
57 | Type | Name | Description | Schema |
58 +=========+=============+======================================+==================+
59 | **Path* | | **jobId** | job Id | string |
60 | * | | *required | | |
62 +---------+-------------+--------------------------------------+------------------+
63 | **Query | | **respons | job response message id | string |
67 +---------+-------------+--------------------------------------+------------------+
72 +-------------------------+--------------------------------------------------+
73 | HTTP Code | Schema |
74 +=========================+==================================================+
75 | **202** | `JobDetailInfo <#_jobdetailinfo>`__ |
76 +-------------------------+--------------------------------------------------+
98 +---------+-------------+--------------------------------------+------------------+
99 | Type | Name | Description | Schema |
100 +=========+=============+======================================+==================+
101 | **Body* | | **NSCreat | NS Instance Create Request | `NsCreateRequest |
102 | * | eRequest** | | <#_nscreaterequ |
103 | | | *required | | est>`__ |
105 +---------+-------------+--------------------------------------+------------------+
110 +---------+----------------------------------------------------+----------------+
111 | HTTP | Description | Schema |
113 +=========+====================================================+================+
114 | **200** | successful operation | `NsCreateRespo |
115 | | | nse <#_nscreat |
116 | | | eresponse>`__ |
117 +---------+----------------------------------------------------+----------------+
118 | **404** | URL not found | No Content |
119 +---------+----------------------------------------------------+----------------+
141 +---------+-------------+--------------------------------------+------------------+
142 | Type | Name | Description | Schema |
143 +=========+=============+======================================+==================+
144 | **Query | | **csarId* | job response message id | string |
146 | | | *required | | |
148 +---------+-------------+--------------------------------------+------------------+
153 +---------+----------------------------------------------------+----------------+
154 | HTTP | Description | Schema |
156 +=========+====================================================+================+
157 | **200** | successful operation | `NsInstancesIn |
158 | | | fo <#_nsinstan |
160 +---------+----------------------------------------------------+----------------+
161 | **404** | URL not found | No Content |
162 +---------+----------------------------------------------------+----------------+
174 POST /ns/{nsInstanceId}/Instantiate
184 +---------+-------------+--------------------------------------+------------------+
185 | Type | Name | Description | Schema |
186 +=========+=============+======================================+==================+
187 | **Path* | | **nsInsta | | string |
189 | | | *required | | |
191 +---------+-------------+--------------------------------------+------------------+
192 | **Body* | | **NSInsta | NS Instantiate Request Body | `NsInstantiateRe |
193 | * | ntiateReque | | quest <#_nsinsta |
194 | | st** | | ntiaterequest>`_ |
195 | | | *required | | _ |
197 +---------+-------------+--------------------------------------+------------------+
202 +---------+----------------------------------------------------+----------------+
203 | HTTP | Description | Schema |
205 +=========+====================================================+================+
206 | **200** | | `JobInfo <#_jo |
208 +---------+----------------------------------------------------+----------------+
209 | **201** | Invalid Request | No Content |
210 +---------+----------------------------------------------------+----------------+
211 | **404** | URL not found | No Content |
212 +---------+----------------------------------------------------+----------------+
224 POST /ns/{nsInstanceId}/scale
234 +---------+-------------+--------------------------------------+------------------+
235 | Type | Name | Description | Schema |
236 +=========+=============+======================================+==================+
237 | **Path* | | **nsInsta | | string |
239 | | | *required | | |
241 +---------+-------------+--------------------------------------+------------------+
242 | **Body* | | **ScaleNS | Scale NS Request Body | `NsScaleRequest |
243 | * | Request** | | <#_nsscalereques |
244 | | | *required | | t>`__ |
246 +---------+-------------+--------------------------------------+------------------+
251 +---------+----------------------------------------------------+----------------+
252 | HTTP | Description | Schema |
254 +=========+====================================================+================+
255 | **200** | | `JobInfo <#_jo |
257 +---------+----------------------------------------------------+----------------+
258 | **201** | Invalid Request | No Content |
259 +---------+----------------------------------------------------+----------------+
260 | **404** | URL not found | No Content |
261 +---------+----------------------------------------------------+----------------+
273 GET /ns/{ns_instance_id}
283 +---------+----------------------------------------------------+----------------+
284 | HTTP | Description | Schema |
286 +=========+====================================================+================+
287 | **200** | successful operation | `NsInstanceInf |
288 | | | o <#_nsinstanc |
290 +---------+----------------------------------------------------+----------------+
302 DELETE /ns/{ns_instance_id}
312 +---------+-------------+--------------------------------------+------------------+
313 | Type | Name | Description | Schema |
314 +=========+=============+======================================+==================+
315 | **Path* | | **ns\_ins | Identifier of the NS instance. | string |
316 | * | tance\_id** | | |
317 | | | *required | | |
319 +---------+-------------+--------------------------------------+------------------+
324 +---------+----------------------------------------------------+----------------+
325 | HTTP | Description | Schema |
327 +=========+====================================================+================+
328 | **204** | The NS instance resource and the associated NS | No Content |
329 | | identifier were deleted successfully. | |
330 +---------+----------------------------------------------------+----------------+
342 POST /ns/{ns_instance_id}/heal
352 +---------+-------------+--------------------------------------+------------------+
353 | Type | Name | Description | Schema |
354 +=========+=============+======================================+==================+
355 | **Path* | | **ns\_ins | Identifier of the NS instance. | string |
356 | * | tance\_id** | | |
357 | | | *required | | |
359 +---------+-------------+--------------------------------------+------------------+
360 | **Body* | | **healVnf | healVnfData | `NsHealRequest < |
361 | * | Data** | | #_nshealrequest> |
362 | | | *required | | `__ |
364 +---------+-------------+--------------------------------------+------------------+
369 +---------+----------------------------------------------------+----------------+
370 | HTTP | Description | Schema |
372 +=========+====================================================+================+
373 | **202** | | `JobInfo <#_jo |
375 +---------+----------------------------------------------------+----------------+
376 | **404** | URL not found | No Content |
377 +---------+----------------------------------------------------+----------------+
378 | **500** | the url is invalid | No Content |
379 +---------+----------------------------------------------------+----------------+
391 POST /ns/{ns_instance_id}/terminate
401 +---------+-------------+--------------------------------------+------------------+
402 | Type | Name | Description | Schema |
403 +=========+=============+======================================+==================+
404 | **Path* | | **ns\_ins | Identifier of the NS instance. | string |
405 | * | tance\_id** | | |
406 | | | *required | | |
408 +---------+-------------+--------------------------------------+------------------+
409 | **Body* | | **NsTermi | NsTerminateRequest | `NsTerminateRequ |
410 | * | nateRequest | | est <#_nstermina |
411 | | ** | | terequest>`__ |
412 | | | *required | | |
414 +---------+-------------+--------------------------------------+------------------+
419 +---------+----------------------------------------------------+----------------+
420 | HTTP | Description | Schema |
422 +=========+====================================================+================+
423 | **202** | | `JobInfo <#_jo |
425 +---------+----------------------------------------------------+----------------+
426 | **500** | the url is invalid | No Content |
427 +---------+----------------------------------------------------+----------------+
440 +--------------------------------+-------------------------------------------+
442 +================================+===========================================+
443 | | **jobId** | string |
445 +--------------------------------+-------------------------------------------+
446 | | **responseDescriptor** | `responseDescriptor <#_jobdetailinfo_resp |
447 | | *optional* | onsedescriptor>`__ |
448 +--------------------------------+-------------------------------------------+
450 **responseDescriptor**
452 +--------------------------------+-------------------------------------------+
454 +================================+===========================================+
455 | | **errorCode** | string |
457 +--------------------------------+-------------------------------------------+
458 | | **progress** | string |
460 +--------------------------------+-------------------------------------------+
461 | | **responseHistoryList** | < `jobResponseInfo <#_jobresponseinfo>`__ |
462 | | *optional* | > array |
463 +--------------------------------+-------------------------------------------+
464 | | **responseId** | string |
466 +--------------------------------+-------------------------------------------+
467 | | **status** | string |
469 +--------------------------------+-------------------------------------------+
470 | | **statusDescription** | string |
472 +--------------------------------+-------------------------------------------+
477 +--------------------------------+-------------------------------------------+
479 +================================+===========================================+
480 | | **jobId** | string |
482 +--------------------------------+-------------------------------------------+
487 +--------------------------------+-------------------------------------------+
489 +================================+===========================================+
490 | | **locationConstraints** | `locationConstraints <#_locationconstrain |
491 | | *optional* | t_locationconstraints>`__ |
492 +--------------------------------+-------------------------------------------+
493 | | **vnfProfileId** | string |
495 +--------------------------------+-------------------------------------------+
497 **locationConstraints**
499 +--------------------------------+-------------------------------------------+
501 +================================+===========================================+
502 | | **vimid** | string |
504 +--------------------------------+-------------------------------------------+
509 +-------------+---------------------------------------------+------------------+
510 | Name | Description | Schema |
511 +=============+=============================================+==================+
512 | | **csarId* | the NS package ID | string |
516 +-------------+---------------------------------------------+------------------+
517 | | **descrip | | string |
521 +-------------+---------------------------------------------+------------------+
522 | | **nsName* | | string |
526 +-------------+---------------------------------------------+------------------+
531 +--------------------------------+-------------------------------------------+
533 +================================+===========================================+
534 | | **nsInstanceId** | string |
536 +--------------------------------+-------------------------------------------+
541 +--------------------------------+-------------------------------------------+
543 +================================+===========================================+
544 | | **additionalParams** | `additionalParams <#_nshealrequest_additi |
545 | | *optional* | onalparams>`__ |
546 +--------------------------------+-------------------------------------------+
547 | | **cause** | string |
549 +--------------------------------+-------------------------------------------+
550 | | **vnfInstanceId** | string |
552 +--------------------------------+-------------------------------------------+
556 +--------------------------------+-------------------------------------------+
558 +================================+===========================================+
559 | | **action** | string |
561 +--------------------------------+-------------------------------------------+
562 | | **actionvminfo** | `actionvminfo <#_nshealrequest_actionvmin |
563 | | *optional* | fo>`__ |
564 +--------------------------------+-------------------------------------------+
568 +--------------------------------+-------------------------------------------+
570 +================================+===========================================+
571 | | **vmid** | string |
573 +--------------------------------+-------------------------------------------+
574 | | **vmname** | string |
576 +--------------------------------+-------------------------------------------+
581 +--------------------------------+-------------------------------------------+
583 +================================+===========================================+
584 | | **description** | string |
586 +--------------------------------+-------------------------------------------+
587 | | **nsInstanceId** | string |
589 +--------------------------------+-------------------------------------------+
590 | | **nsName** | string |
592 +--------------------------------+-------------------------------------------+
593 | | **nsState** | string |
595 +--------------------------------+-------------------------------------------+
596 | | **nsdId** | string |
598 +--------------------------------+-------------------------------------------+
599 | | **vlInfo** | < `vlInfo <#_vlinfo>`__ > array |
601 +--------------------------------+-------------------------------------------+
602 | | **vnfInfo** | < `vnfInfo <#_vnfinfo>`__ > array |
604 +--------------------------------+-------------------------------------------+
605 | | **vnffgInfo** | < `vnffgInfo <#_vnffginfo>`__ > array |
607 +--------------------------------+-------------------------------------------+
612 *Type* : < `NsInstanceInfo <#_nsinstanceinfo>`__ > array
617 +--------------------------------+-------------------------------------------+
619 +================================+===========================================+
620 | | **LocationConstraints** | < |
621 | | *optional* | `LocationConstraint <#_locationconstraint |
624 +--------------------------------+-------------------------------------------+
625 | | **additionalParamForNs** | string |
627 +--------------------------------+-------------------------------------------+
632 +--------------------------------+-------------------------------------------+
634 +================================+===========================================+
635 | | **aspectId** | string |
637 +--------------------------------+-------------------------------------------+
638 | | **numberOfSteps** | integer |
640 +--------------------------------+-------------------------------------------+
641 | | **scalingDirection** | string |
643 +--------------------------------+-------------------------------------------+
648 +--------------------------------+-------------------------------------------+
650 +================================+===========================================+
651 | | **scaleNsByStepsData** | `NsScaleByStepsData <#_nsscalebystepsdata |
652 | | *optional* | >`__ |
653 +--------------------------------+-------------------------------------------+
654 | | **scaleType** | string |
656 +--------------------------------+-------------------------------------------+
661 +--------------------------------+-------------------------------------------+
663 +================================+===========================================+
664 | | **gracefulTerminationTimeout | string |
667 +--------------------------------+-------------------------------------------+
668 | | **terminationType** | string |
670 +--------------------------------+-------------------------------------------+
675 +--------------------------------+-------------------------------------------+
677 +================================+===========================================+
678 | | **cpInstanceId** | string |
680 +--------------------------------+-------------------------------------------+
681 | | **cpInstanceName** | string |
683 +--------------------------------+-------------------------------------------+
684 | | **cpdId** | string |
686 +--------------------------------+-------------------------------------------+
691 +--------------------------------+-------------------------------------------+
693 +================================+===========================================+
694 | | **errorCode** | string |
696 +--------------------------------+-------------------------------------------+
697 | | **progress** | string |
699 +--------------------------------+-------------------------------------------+
700 | | **responseId** | string |
702 +--------------------------------+-------------------------------------------+
703 | | **status** | string |
705 +--------------------------------+-------------------------------------------+
706 | | **statusDescription** | string |
708 +--------------------------------+-------------------------------------------+
713 +--------------------------------+-------------------------------------------+
715 +================================+===========================================+
716 | | **relatedCpInstanceId** | < `cpInfo <#_cpinfo>`__ > array |
718 +--------------------------------+-------------------------------------------+
719 | | **vlInstanceId** | string |
721 +--------------------------------+-------------------------------------------+
722 | | **vlInstanceName** | string |
724 +--------------------------------+-------------------------------------------+
725 | | **vldId** | string |
727 +--------------------------------+-------------------------------------------+
732 +--------------------------------+-------------------------------------------+
734 +================================+===========================================+
735 | | **vnfInstanceId** | string |
737 +--------------------------------+-------------------------------------------+
738 | | **vnfInstanceName** | string |
740 +--------------------------------+-------------------------------------------+
741 | | **vnfdId** | string |
743 +--------------------------------+-------------------------------------------+
748 +--------------------------------+-------------------------------------------+
750 +================================+===========================================+
751 | | **cpId** | string |
753 +--------------------------------+-------------------------------------------+
754 | | **nfp** | string |
756 +--------------------------------+-------------------------------------------+
757 | | **pnfId** | string |
759 +--------------------------------+-------------------------------------------+
760 | | **virtualLinkId** | string |
762 +--------------------------------+-------------------------------------------+
763 | | **vnfId** | string |
765 +--------------------------------+-------------------------------------------+
766 | | **vnffgInstanceId** | string |
768 +--------------------------------+-------------------------------------------+