Use my VNFM

In this section are described the REST interfaces which allow you to integrate your VNFM with Openbaton's NFVO.

NFVO - VNFM ReST interface

Nfvo exposes a ReST interface for the communication with the VnfManagers. The sequence diagram regarding the instantiation of a NetworkServiceRecord is shown in the following picture.

As shown in the picture, NFVO calls some ReST methods on the vnfm in a particular order. Then it expects some kind of back call. The list of these call exchange is described in the following sections. The ALLOCATE_RESOURCES call is not needed if the vnfm will take care of creating VMs. The communication with the EMS is particular to each VnfManagers. In order to be able to be found, the Vnfm needs to register to the NFVO. This can be done through a particular call.

In the following 'Vnfm-Or' means that the Vnfm sends to the Nfvo and 'Or-Vnfm' means that the Nfvo sends to the Vnfm.

Params	Meaning
OrEndpoint	the endpoint of the NFVO (i.e. http://127.0.0.1:8080)
VnfmEnpoint	the endpoint of the Vnfm. this is given to the nfvo while registering

Registering a Vnfm to the Nfvo (Vnfm-Or)

This call registers a vnfm to a nfvo.

request path

POST request on

OrEndpoint/admin/v1/vnfm-register

request body

{
    "type":"dummy",
    "endpointType":"REST",
    "endpoint":"VnfmEndpoint",
    "description":"MyVnfm",
    "enabled":"true"
}

request structure

Field	Meaning
type	the vnfm type you are going to handle (specified in VirtualNetowrkFunctionDescriptor → endpoint)
endpointType	the vnfm type you are going to implement (REST or AMQP)
endpoint	the vnfm endpoint you have chosen (basically http://<IP>:<PORT>)

INSTANTIATE (Or-Vnfm)

This call sends the Vnfm the Virtual Network Function Descriptor, which shall be used to create the Virtual Network Funtion Record and also sends to the Vnfm all the scripts which are executed in actions like INSTANTIATE, MODIFY or START. This call triggers the creation of a virtual machine for the sent vnfd and the execution of the scripts which are associated with the INSTANTIATE lifecycle event in the vnfd.

request path

POST request on VnfmEnpoint

request body

{
    "vnfd":{  ...  }, 
    "vnfdf":{  ...  },
    "vlrs":[  ...  ],
    "extention":{  
      "nsr-id":"...",
      "brokerIp":"...",
      ...
    },
    "action":"INSTANTIATE",
    "vimInstances": {
      "vdu_id":[
        { ... },
        { ... }
      ]
    },
    "vnfPackage": { ... },
    "keypairs":[
    { ... }
    ]  
}

request structure

Field	Meaning
vnfd	the VirtualNetworkFunctionDescriptor from which a VirtualNetworkFunctionRecord is created
vnfdf	the deployment flavours to be used
vlrs	the list of VirtualLinkRecords of the NetworkServiceRecord
extention	some info like the NetworkServiceRecord id
action	the action to be executed
vimInstances	a map containing per each vdu id the list of VimInstance objects
vnfPackage	the VNFPackage of the VirtualNetowrkFunctionRecord
keypairs	the list of additional keypairs to be added to the VM

GrantOperation (Vnfm-Or)

This call sends the Virtual Network Function Record to the Nfvo in order to ask if there are enough resources

request path

POST request on OrEndpoint/admin/v1/vnfm-core-grant

request body

{
    "virtualNetworkFunctionDescriptor":{..},
    "vduSet":[
      { ... }
    ],
    "deploymentFlavourKey":"whatever",
    "action":"GRANT_OPERATION",
    "virtualNetworkFunctionRecord":{..}
}

request structure

Field	Meaning
action	the action has to be executed
virtualNetworkFunctionRecord	the VirtualNetowrkFunctionRecord
virtualNetworkFunctionDescriptor	the virtualNetworkFunctionDescriptor
vduSet	the Set of all the VDU of this virtualNetworkFunctionRecord

GrantOperation (Or-Vnfm)

This call returns the answer from the Nfvo of the grant operation

request path

POST request on VnfmEnpoint

request body

{
    "grantAllowed": true,
    "vduVim": {
      "vdu_id": {  }
    },
    "virtualNetworkFunctionRecord":{}
}

request structure

Field	Meaning
grantAllowed	if the nfvo has granted the allocate resources
vduVim	which vim was chosen per vdu
virtualNetworkFunctionRecord	the virtualNetworkFunctionRecord

AllocateResources (Vnfm-Or)

This call sends the Virtual Network Function Record to the Nfvo in order to allocate resources

request path

POST request on OrEndpoint/admin/v1/vnfm-core-allocate

request body

{
    "virtualNetworkFunctionRecord":{..},
    "vimInstances":{
      "vdu_id":{ ... }
    },
    "userdata":"",
    "keypairs":[
    { ... }
    ]
}

request structure

Field	Meaning
virtualNetworkFunctionRecord	the VirtualNetowrkFunctionRecord
vimInstances	the chosen vim per vdu
userdata	the userdata
keypairs	the keypairs to be added to the VM by the NFVO

AllocateResources (Or-Vnfm)

This call returns the new VirtualNetowrkFunctionRecord to the Vnfm

request path

POST request on VnfmEnpoint

request body

{
    "vnfr": { ... }
}

request structure

Field	Meaning
virtualNetworkFunctionRecord	the virtualNetworkFunctionRecord updated

Instantiate (Vnfm-Or)

This call sends back the created Virtual Network Function Record to the Nfvo.

request path

POST request on OrEndpoint/admin/v1/vnfm-core-actions

request body

{
    "virtualNetworkFunctionRecord":{  ...  }, 
    "action":"INSTANTIATE"
}

request structure

Field	Meaning
virtualNetworkFunctionRecord	the created VirtualNetworkFunctionRecord
action	the action that was executed

Modify (aka AddRelations) (Or-Vnfm)

The Nfvo uses this request to provide dependencies of Virtual Network Functions to the Vnfm. The scripts associated with the CONFIGURATION lifecycle event in the vnfr will be executed.

request path

POST request on

VnfmEnpoint

request body

{
    "vnfr":{ ... }, 
    "vnfrd":{ ... }, 
    "action":"MODIFY"
}

request structure

Field	Meaning
vnfr	the VirtualNetowrkFunctionRecord target of the depedendecy
vnfrd	the VNFDependency containing all the source parameters needed by the scripts
action	the action to be executed

Modify (aka AddRelations) (Vnfm-Or)

This call sends back the modified Virtual Network Function Record to the Nfvo.

request path

POST request on

OrEndpoint/admin/v1/vnfm-core-actions

request body

{
    "virtualNetworkFunctionRecord":{ ... },
    "action":"MODIFY"
}

request structure

Field	Meaning
virtualNetworkFunctionRecord	the VirtualNetworkFunctionRecord
action	the action that was executed

Start (Or-Vnfm)

This call will trigger the execution of the scripts associated with the START lifecycle event in the vnfr.

request path

POST request on

VnfmEnpoint

request body

{
    "vnfr":{  ...  },
    "action":"START"
}

request structure

Field	Meaning
vnfr
action	the action to be executed

Start (Vnfm-Or)

request path

POST request on

OrEndpoint/admin/v1/vnfm-core-actions

request body

{
    "virtualNetworkFunctionRecord":{  ...  },
    "action":"START"
}

request structure

Field	Meaning
virtualNetworkFunctionRecord	the Virtual Network Function Record
action	the action that was executed