5 "title": "ONAP VNFM Driver Development Related API",
6 "description": "ONAP VNFM Driver Development Related Rest API.",
8 "name": "ONAP VFC team",
9 "email": "onap-discuss@lists.onap.org",
10 "url": "https://gerrit.onap.org/r/#/admin/projects/vfc/nfvo/lcm"
25 "/{vnfmtype}/v1/{vnfmid}/vnfs": {
30 "summary": "vnf create&instantiate",
31 "description": "VNF create&instantiate Rest API should be provided by the VNFM Driver",
32 "operationId": "vnf_instantiate",
43 "description": "The value of vnfmtype should be the SVNFM driver service name",
50 "description": "The value of vnfmid should be the VNFM Instantiate ID",
57 "description": "instantiate request param",
60 "$ref": "#/definitions/VnfInstantiateRequest"
68 "$ref": "#/definitions/VnfInstantiateResponse"
74 "/{vnfmtype}/v1/{vnfmid}/vnfs/{vnfInstanceId}/scale": {
79 "summary": "vnf Scale",
80 "description": "VNF Scale Rest API should be provided by the VNFM Driver",
81 "operationId": "vnf_scale",
92 "description": "The value of vnfmtype should be the SVNFM driver service name",
99 "description": "The value of vnfmid should be the VNFM Instantiate ID",
106 "description": "The value of vnfInstanceId should be the VNF Instantiate ID",
107 "name": "vnfInstanceId",
113 "description": "instantiate request param",
116 "$ref": "#/definitions/VnfScaleRequest"
124 "$ref": "#/definitions/JobInfo"
128 "description": "the VNF instance id is wrong"
131 "description": "the url is invalid"
136 "/{vnfmtype}/v1/{vnfmid}/vnfs/{vnfInstanceId}/heal": {
141 "summary": "vnf heal",
142 "description": "VNF Heal Rest API should be provided by the VNFM Driver",
143 "operationId": "vnf_heal",
154 "description": "The value of vnfmtype should be the SVNFM driver service name",
161 "description": "The value of vnfmid should be the VNFM Instantiate ID",
168 "description": "The value of vnfInstanceId should be the VNF Instantiate ID",
169 "name": "vnfInstanceId",
175 "description": "instantiate request param",
178 "$ref": "#/definitions/VnfHealRequest"
186 "$ref": "#/definitions/JobInfo"
190 "description": "the VNF instance id is wrong"
193 "description": "the url is invalid"
198 "/{vnfmtype}/v1/{vnfmid}/vnfs/{vnfInstanceId}/terminate": {
203 "summary": "terminate&delete vnf",
204 "description": "VNF terminate&delete Rest API should be provided by the VNFM Driver",
205 "operationId": "terminate_vnf",
216 "description": "The value of vnfmtype should be the SVNFM driver service name",
223 "description": "The value of vnfmid should be the VNFM Instantiate ID",
230 "description": "The value of vnfInstanceId should be the VNF Instantiate ID",
231 "name": "vnfInstanceId",
237 "description": "instantiate request param",
240 "$ref": "#/definitions/VnfTerminateRequest"
246 "description": "successful operation",
248 "$ref": "#/definitions/JobInfo"
252 "description": "the VNF instance id is wrong"
255 "description": "the url is invalid"
260 "/{vnfmtype}/v1/{vnfmid}/vnfs/{vnfInstanceId}": {
265 "summary": "query the specified vnf info",
267 "operationId": "query_vnf",
278 "description": "The value of vnfmtype should be the SVNFM driver service name",
285 "description": "The value of vnfmid should be the VNFM Instantiate ID",
292 "description": "The value of vnfInstanceId should be the VNF Instantiate ID",
293 "name": "vnfInstanceId",
299 "description": "successful operation",
301 "$ref": "#/definitions/VnfInfo"
305 "description": "the vnf instance id is wrong"
308 "description": "the url is invalid"
313 "/nslcm/v1/ns/grantvnf": {
318 "summary": "grantvnf",
319 "description": "Grant VNF, provived by the NSLCM component",
320 "operationId": "grantvnf",
325 "description": "Grant VNF Request",
328 "$ref": "#/definitions/GrantVNFRequest"
336 "$ref": "#/definitions/GrantVNFResponse"
340 "description": "URL not found"
343 "description": "the url is invalid"
348 "/nslcm/v1/vnfs/{vnfInstanceId}/Notify": {
353 "summary": "VNF LCM Notification",
354 "description": "VNF LCM Notification API should be provided by NSLCM component",
355 "operationId": "VNF_LCM_Notification",
360 "description": "VNF Instance Id",
361 "name": "vnfInstanceId",
366 "name": "vnf Notification",
367 "description": "VNF LCM Notification",
370 "$ref": "#/definitions/VNFLCMNotification"
379 "description": "URL not found"
382 "description": "the url is invalid"
387 "/{vnfmid}/jobs/{jobid}": {
392 "summary": "jobstatus",
393 "description": "Job Infomation API should be provided by VNFM Driver",
394 "operationId": "get_jobstatus",
399 "description": "job Id",
406 "description": "The value of vnfmid should be the VNFM Instantiate ID",
413 "description": "job response message id",
414 "name": "responseId",
422 "$ref": "#/definitions/JobDetailInfo"
428 "/catalog/v1/vnfpackages/{csarId}": {
433 "summary": "query vnf package info",
434 "description": "query one vnf package info via vnf package csarId",
435 "operationId": "query_vnf_package",
446 "description": "csar id of vnf package",
453 "description": "successful operation",
455 "$ref": "#/definitions/VnfPkgDetailInfo"
459 "description": "internal error"
464 "/nslcm/vl/vnfms/{vnfmid}":{
469 "summary": "Query VNFM register info",
470 "description": "query VNFM register info",
471 "operationId": "query_vnfm_info",
482 "description": "vnfm id",
489 "description": "successful operation",
491 "$ref": "#/definitions/VnfmInfo"
495 "description": "URL not found"
498 "description": "internal error"
503 "/nslcm/vl/vims/{vimid}":{
508 "summary": "Query VIM register info",
509 "description": "query VIM register info",
510 "operationId": "query_VIM_info",
521 "description": "vim id",
528 "description": "successful operation",
530 "$ref": "#/definitions/VimInfo"
534 "description": "URL not found"
537 "description": "internal error"
553 "statusDescription": {
570 "responseDescriptor": {
579 "statusDescription": {
588 "responseHistoryList": {
591 "$ref": "#/definitions/jobResponseInfo"
603 "description": " The value should be VDU,VL,CP,Strorage."
605 "resourceDefinitionId": {
622 "lifecycleOperation": {
624 "description": "The value should be Instantiate,Scaleout,Scalein,Scaleup,Scaledown, Heal, Terminal"
632 "$ref": "#/definitions/ResourceChange"
638 "$ref": "#/definitions/ResourceChange"
643 "description": "The data type is KeyValuePair. Additional parameters passed by the NFVO, specific to the VNF and the LCM operation."
647 "GrantVNFResponse": {
664 "description": "The vim Type value wil be openstack"
668 "description": "The api Version Type value will be "
672 "description": "The protocol Type value will be http or https"
681 "description": "Tenant Name of tenant"
685 "description": "Username for login"
689 "description": "Password of login user"
693 "interfaceEndpoint": {
695 "description": "Information about the interface endpoint. It is a URL"
701 "VnfNotificationType": {
702 "description": "The type of the notification",
715 "description": "Identifier of the VNFC instance"
719 "description": "Identifier of the VDU in the VNFD"
722 "$ref": "#/definitions/VnfNotificationType",
723 "description": "The type of the change"
727 "description": "Identifier of vim"
731 "description": "Identifier of virtual machine"
735 "description": "Name of virtual machine"
739 "AffectedVirtualLinkType": {
740 "description": "The type of the affected virtual link",
747 "AffectedVirtualLink":{
752 "description": "Identifier of the VL instance"
756 "description": "Identifier of the VLD in the VNFD"
759 "$ref": "#/definitions/VnfNotificationType",
760 "description": "The type of the change"
764 "description": "network Resource",
767 "$ref": "#/definitions/AffectedVirtualLinkType",
768 "description": "Must be network"
772 "description": "Identifier of the resource in the scope of the VIM"
778 "VnfCpNotificationType": {
779 "description": "The type of the notification for connection points",
790 "virtualLinkInstanceId": {
792 "description": "Identifier of the VL instance"
796 "description": "Identifier of the connection point"
800 "description": "Identifier of the connection point in the VNFD"
804 "description": "The type of the owner."
808 "description": "Identifier of the owner. Mandatory if ownerType is specified."
811 "$ref": "#/definitions/VnfCpNotificationType",
812 "description": "The type of the change"
816 "description": "port Resource",
820 "description": "Identifier of the VIM"
824 "description": "Identifier of the resource in the scope of the VIM"
828 "description": "Resource name in the vim"
832 "description": "The identifier of the tenant"
836 "description": "The IP address of the port"
840 "description": "The MAC address of the port"
844 "description": "The instance id of the server to which the port is attached to"
850 "AffectedVirtualStorage" : {
853 "VNFLCMNotification": {
870 "description": "The affected VNFCs",
872 "$ref": "#/definitions/AffectedVnfc"
877 "description": "The affected Connected Points",
879 "$ref": "#/definitions/AffectedCp"
884 "description": "The affected virtual links",
886 "$ref": "#/definitions/AffectedVirtualLink"
889 "affectedVirtualStorage": {
891 "description": "The affected virtual storages. (Not supported)",
893 "$ref": "#/definitions/AffectedVirtualStorage"
898 "VnfInstantiateRequest": {
910 "vnfInstanceDescription": {
916 "$ref": "#/definitions/extVirtualLinkInfo"
924 "extVirtualLinkInfo":{
937 "$ref": "#/definitions/vimInfo"
942 "VnfInstantiateResponse": {
958 "description": "The VNF scale type value should be SCALE_OUT, SCALE_IN"
962 "description": "Identifies the aspect of the VNF that is requested to be scaled"
966 "description": "Number of scaling steps to be executed as part of this ScaleVnf operation. It shall be a positive number"
970 "description": "Additional parameters passed by the NFVO as input to the scaling process, specific to the VNF being scaled"
996 "VnfTerminateRequest":{
1002 "gracefulTerminationTimeout": {
1021 "vnfInstanceName": {
1024 "vnfInstanceDescription": {
1061 "description": "The vim Type value wil be openstack"
1065 "description": "The api Version Type value will be "
1069 "description": "The protocol Type value will be http or https"
1078 "description": "Tenant Name of tenant"
1082 "description": "Username for login"
1086 "description": "Password of login user"
1090 "interfaceEndpoint": {
1092 "description": "Information about the interface endpoint. It is a URL"
1096 "VnfPkgDetailInfo": {
1101 "description": "vnf package id, UUID"
1104 "$ref": "#/definitions/VnfPkgInfo"
1107 "$ref": "#/definitions/VnfPkgImgListInfo"
1109 "vnfInstanceInfo": {
1110 "$ref": "#/definitions/VnfInstListInfo"
1116 "description": "vnf package infomation",
1120 "description": "vnf package id, UUID"
1124 "description": "VNF descriptor ID"
1128 "description": "VNF descriptor vendor ID"
1132 "description": "VNF descriptor version"
1136 "description": "VNF Software version"
1140 "description": "The download uri of VNF package"
1144 "VnfInstListInfo": {
1147 "$ref": "#/definitions/VnfInstInfo"
1155 "description": "VNF instance ID"
1157 "vnfInstanceName": {
1159 "description": "VNF instance name"
1163 "VnfPkgImgListInfo": {
1166 "$ref": "#/definitions/VnfPkgImgInfo"
1174 "description": "image file name"
1178 "description": "image file path in the csar or image url in external repository"
1187 "description": "vnfm Id"
1191 "description": "vnfm name"
1195 "description": "vnfm type"
1199 "description": "vnfm url"
1203 "description": "vnfm login username"
1207 "description": "vnfm login password"
1211 "description": "vim Id"
1215 "description": "vendor name"
1219 "description": "vnfm version"
1223 "description": "vnfm description"
1227 "description": "vnfm certificate Url"
1231 "description": "vnfm info createTime"
1240 "description": "vim Id"
1244 "description": "vnfm name"
1248 "description": "vnfm type"
1252 "description": "vnfm url"
1256 "description": "vnfm login username"
1260 "description": "vnfm login password"
1264 "description": "vendor name"
1268 "description": "vnfm version"
1272 "description": "vnfm description"
1276 "description": "vnfm info createTime"