-.. contents::\r
- :depth: 3\r
-..\r
-\r
- **GVNFM Northbound & Southbound APIs**\r
- **V0.1**\r
-\r
-**1 Scope**\r
-=============\r
-\r
-The scope of the present document is to describe the GVNFM exposed API specification over Or-Vnfm reference point and Ve-Vnfm-vnf reference point.\r
-Some content has been updated, about the API Swagger definition, you can find here 'GVNFM_LCM_APIs<https://gerrit.onap.org/r/gitweb?p=vfc/gvnfm/vnflcm.git;a=blob;f=lcm/lcm/swagger/swagger.json;h=f098d282927d3535f5e9e6950f26b9171e04d30c;hb=HEAD>'.\r
-\r
-\r
-**2 Terms, Definitions and Abbreviations**\r
-===========================================\r
-\r
- For the purposes of the present document, the following\r
- abbreviations apply:\r
-\r
-+------------------------+-----------------------------------------------------+\r
-| **Abbreviation** | |\r
-+========================+=====================================================+\r
-| NFVO | Network Functions Virtualization Orchestrator |\r
-+------------------------+-----------------------------------------------------+\r
-| VNFM | Virtual Network Function Manager |\r
-+------------------------+-----------------------------------------------------+\r
-| VNF | Virtual Network Function |\r
-+------------------------+-----------------------------------------------------+\r
-\r
-Table 2-1 abbreviations\r
-\r
-**3. Interfaces provided by GVNFM** (Or-Vnfm) \r
-==========================================================\r
-\r
- Interfaces use RESTful API and the format is as follows:\r
- http(s)://[hostname][:port]/gvnfmapi/lcm/v1/[……]\r
-\r
-|image0|\r
-\r
-\r
- **{apiRoot} is** http(s)://[hostname][:port]/gvnfmapi\r
-\r
-**3.1 Create VNF Identifier**\r
------------------------------\r
-\r
-+---------------------+--------------------------------------------------------------+\r
-| If Definition | Description |\r
-+=====================+==============================================================+\r
-| URI | http(s)://[hostname][:port]/gvnfmapi/lcm/v1/vnf\_instances |\r
-+---------------------+--------------------------------------------------------------+\r
-| Operation | POST |\r
-+---------------------+--------------------------------------------------------------+\r
-| Direction | NFVO->VNFMLCM |\r
-+---------------------+--------------------------------------------------------------+\r
-\r
-**3.1.1 Request**\r
-\r
-+---------------------------+-------------+---------------+------------------+-------------------------------------------------------------------------------------+\r
-| Parameter | Qualifier | Cardinality | Content | Description |\r
-+===========================+=============+===============+==================+=====================================================================================+\r
-| vnfdId | M | 1 | Identifier | Identifier that identifies the VNFD which defines the VNF instance to be created. |\r
-+---------------------------+-------------+---------------+------------------+-------------------------------------------------------------------------------------+\r
-| vnfInstanceName | M | 1 | String | Human-readable name of the VNF instance to be created. |\r
-+---------------------------+-------------+---------------+------------------+-------------------------------------------------------------------------------------+\r
-| vnfInstanceDescription | O | 0..1 | String | Human-readable description of the VNF instance to be created. |\r
-+---------------------------+-------------+---------------+------------------+-------------------------------------------------------------------------------------+\r
-\r
- {\r
- "vnfdId": "zte\_vFW\_51610", \r
- "vnfInstanceName": "vFW\_01",\r
- "vnfInstanceDescription": " vFW in Nanjing TIC Edge"\r
-\r
- }\r
-\r
-**3.1.2 Response**\r
-\r
-+-----------------+-------------+---------------+------------------+-----------------------------------------+\r
-| Parameter | Qualifier | Cardinality | Content | Description |\r
-+=================+=============+===============+==================+=========================================+\r
-| vnfInstanceId | M | 1 | Identifier | VNF instance identifier just created. |\r
-+-----------------+-------------+---------------+------------------+-----------------------------------------+\r
-\r
- {\r
- "vnfInstanceId": "1"\r
-\r
- }\r
-\r
-**3.1.3 Response Code**\r
-\r
-+-----------+-----------------------+-----------------------------------------------------------+\r
-| Code | Meaning | Description |\r
-+===========+=======================+===========================================================+\r
-| 201 | Created | A VNF Instance identifier was created successfully. |\r
-+-----------+-----------------------+-----------------------------------------------------------+\r
-| 4xx/5xx | <name from RFC7231> | <description> |\r
-+-----------+-----------------------+-----------------------------------------------------------+\r
-\r
-**3.2 Delete VNF Identifier**\r
------------------------------\r
-\r
-+---------------------+------------------------------------------------------------------------------+\r
-| If Definition | Description |\r
-+=====================+==============================================================================+\r
-| URI | http(s)://[hostname][:port]/gvnfmapi/lcm/v1/vnf\_instances/{vnfInstanceId} |\r
-+---------------------+------------------------------------------------------------------------------+\r
-| Operation | DELETE |\r
-+---------------------+------------------------------------------------------------------------------+\r
-| Direction | NFVO->VNFMLCM |\r
-+---------------------+------------------------------------------------------------------------------+\r
-\r
-**3.2.1 Request**\r
-\r
-+-------------+-------------+---------------+---------------+---------------+\r
-| Parameter | Qualifier | Cardinality | Content | Description |\r
-+=============+=============+===============+===============+===============+\r
-| n/a | | | | |\r
-+-------------+-------------+---------------+---------------+---------------+\r
-\r
-**3.2.2 Response**\r
-\r
-+-------------+-------------+---------------+---------------+---------------+\r
-| Parameter | Qualifier | Cardinality | Content | Description |\r
-+=============+=============+===============+===============+===============+\r
-| n/a | | | | |\r
-+-------------+-------------+---------------+---------------+---------------+\r
-\r
-**3.2.3 Response Code**\r
-\r
-+--------+-----------+-------------------+\r
-| Code | Meaning | Description |\r
-+--------+-----------+-------------------+\r
-\r
-+-----------+-----------------------+----------------------------------------------------------------------------------------------+\r
-| 204 | No Content | The VNF instance resource and the associated VNF identifier were deleted successfully. |\r
-+===========+=======================+==============================================================================================+\r
-| 4xx/5xx | <name from RFC7231> | <description> |\r
-+-----------+-----------------------+----------------------------------------------------------------------------------------------+\r
-\r
-**3.3 Instantiate VNF**\r
------------------------\r
-\r
-+---------------------+-------------------------------------------------------------------------------------------+\r
-| If Definition | Description |\r
-+=====================+===========================================================================================+\r
-| URI | http(s)://[hostname][:port]/gvnfmapi/lcm/v1/vnf_instances/{vnfInstanceId}/instantiate |\r
-+---------------------+-------------------------------------------------------------------------------------------+\r
-| Operation | POST |\r
-+---------------------+-------------------------------------------------------------------------------------------+\r
-| Direction | NFVO->VNFMLCM |\r
-+---------------------+-------------------------------------------------------------------------------------------+\r
-\r
-3.3.1 **Request**\r
-\r
-+--------------------+-----------+-------------+---------------------+---------------------------------------------------------------+\r
-| Parameter | Qualifier | Cardinality | Content | Description |\r
-+====================+===========+=============+=====================+===============================================================+\r
-| flavourId | M | 1 | IdentifierInV nfd | Identifier of the VNF deployment flavour to be instantiated. |\r
-+--------------------+-----------+-------------+---------------------+---------------------------------------------------------------+\r
-| instantiation | O | 0..1 | IdentifierInVnfd | Identifier of the instantiation |\r
-| LevelId | | | | level of the deployment |\r
-| | | | | flavour to be instantiated. If |\r
-| | | | | not present, the default |\r
-| | | | | instantiation level as |\r
-| | | | | declared in the VNFD is |\r
-| | | | | instantiated. |\r
-| | | | | |\r
-| | | | | Reserved |\r
-+--------------------+-----------+-------------+---------------------+---------------------------------------------------------------+\r
-| extVirtualLinks | O | 0..N | ExtVirtualLin kData | Information about external VLs to connect the VNF to. |\r
-+--------------------+-----------+-------------+---------------------+---------------------------------------------------------------+\r
-| extManagedVirtualL | O | 0..N | ExtManaged | Information about internal |\r
-| inks | | | VirtualLinkData | VLs that are managed by |\r
-| | | | | other entities than the VNFM. |\r
-| | | | | |\r
-| | | | | Reserved |\r
-+--------------------+-----------+-------------+---------------------+---------------------------------------------------------------+\r
-| localization | O | 0..1 | String | Localization language of the VNF to be instantiated can be |\r
-| Language | | | | declared in the VNFD. The value shall comply with the format |\r
-| | | | | defined in IETF RFC 5646 [6]. |\r
-| | | | | |\r
-| | | | | Reserved |\r
-+--------------------+-----------+-------------+---------------------+---------------------------------------------------------------+\r
-| additionalParams | O | 0..N | KeyValuePair | Additional input parameters for the instantiation process, |\r
-| | | | | specific to the VNF being instantiated. |\r
-+--------------------+-----------+-------------+---------------------+---------------------------------------------------------------+\r
-\r
-**ExtVirtualLinkData:**\r
-\r
-+------------------+-----------+-------------+-----------------+----------------------------------------------------------------------------------+\r
-| Attribute | Qualifier | Cardinality | Content | Description |\r
-+==================+===========+=============+=================+==================================================================================+\r
-| vlInstanceId | O | 0..1 | Identifier | Identifier of the VL instance. |\r
-+------------------+-----------+-------------+-----------------+----------------------------------------------------------------------------------+\r
-| vim | CM | 0..1 | VimInfo | Information about the VIM that manages this resource. |\r
-| | | | | This attribute shall be supported and present if VNF-related resource management |\r
-| | | | | in direct mode is applicable. |\r
-+------------------+-----------+-------------+-----------------+----------------------------------------------------------------------------------+\r
-| resourceProvider | CM | 0..1 | Identifier | Identifies the entity responsible for the management of this resource. |\r
-| Id | | | | This attribute shall be present if |\r
-| | | | | VNF-related resource management in indirect mode is applicable. |\r
-| | | | | |\r
-| | | | | Reserved |\r
-+------------------+-----------+-------------+-----------------+----------------------------------------------------------------------------------+\r
-| resourceId | M | 1 | IdentifierInVim | The identifier of the resource in the scope of the VIM or the resource provider. |\r
-+------------------+-----------+-------------+-----------------+----------------------------------------------------------------------------------+\r
-| extCps | M | 1..N | VnfExtCpData | External CPs of the VNF to be connected to this external VL. |\r
-+------------------+-----------+-------------+-----------------+----------------------------------------------------------------------------------+\r
-\r
- **VimInfo:**\r
-\r
-+-----------------+-----------+-------------+--------------+------------------------------------------------------------------------------------------------------------------------------------------+\r
-| Attribute | Qualifier | Cardinality | Content | Description |\r
-+=================+===========+=============+==============+==========================================================================================================================================+\r
-| vimInfoId | M | 1 | Identifier | The identifier of this VimInfo instance, for the purpose of referencing it from other information elements. |\r
-+-----------------+-----------+-------------+--------------+------------------------------------------------------------------------------------------------------------------------------------------+\r
-| vimId | M | 1 | Identifier | The identifier of the VIM. |\r
-+-----------------+-----------+-------------+--------------+------------------------------------------------------------------------------------------------------------------------------------------+\r
-| interfaceInfo | M | 0..N | KeyValuePair | Information about the interface to the VIM, including VIM provider type, API version, and protocol type. |\r
-+-----------------+-----------+-------------+--------------+------------------------------------------------------------------------------------------------------------------------------------------+\r
-| accessInfo | M | 0..N | KeyValuePair | Authentication credentials for accessing the VIM. Examples may include those to support different authentication schemes, e.g., OAuth, |\r
-| | | | | Token, etc. |\r
-+-----------------+-----------+-------------+--------------+------------------------------------------------------------------------------------------------------------------------------------------+\r
-| interface | M | 1 | String | Information about the interface endpoint. An example is a URL. |\r
-| Endpoint | | | | Token, etc. |\r
-+-----------------+-----------+-------------+--------------+------------------------------------------------------------------------------------------------------------------------------------------+\r
-\r
- **interfaceInfo:**\r
-\r
-+------------------+---------------+--------------------------------------+\r
-| **Key Define** | **Content** | **Description** |\r
-+==================+===============+======================================+\r
-| vimType | String | The type of the VIM. |\r
-+------------------+---------------+--------------------------------------+\r
-| apiVersion | String | The Version of the api of the VIM. |\r
-+------------------+---------------+--------------------------------------+\r
-| protocolType | String | http https |\r
-+------------------+---------------+--------------------------------------+\r
-\r
- **accessInfo:**\r
-\r
-+------------------+---------------+--------------------------+\r
-| **Key Define** | **Content** | **Description** |\r
-+==================+===============+==========================+\r
-| tenant | String | Tenant Name of tenant |\r
-+------------------+---------------+--------------------------+\r
-| username | String | Username for login |\r
-+------------------+---------------+--------------------------+\r
-| password | String | Password of login user |\r
-+------------------+---------------+--------------------------+\r
-\r
- **VnfExtCpData:**\r
-\r
-+------------------------+---------------------+-----------------------+--------------------+-----------------------------------------------------------+\r
-| **Attribute** | **Qualifier** | **Cardinality** | **Content** | **Description** |\r
-+========================+=====================+=======================+====================+===========================================================+\r
-| cpdId | M | 1 | IdentifierInVnfd | The identifier of the CPD in the VNFD. |\r
-+------------------------+---------------------+-----------------------+--------------------+-----------------------------------------------------------+\r
-| addresses | O | 0..N | NetworkAddress | List of (fixed) network addresses that |\r
-| | | | | need to be configured on the CP. This attribute shall |\r
-| | | | | be present if fixed addresses need to be configured. |\r
-+------------------------+---------------------+-----------------------+--------------------+-----------------------------------------------------------+\r
-| numDynamicAddre sses | O | 0..1 | Integer | Number of network addresses to be assigned dynamically. |\r
-| | | | | This attribute shall be present if dynamic |\r
-| | | | | addresses need to be configured. |\r
-| | | | | Reserved |\r
-+------------------------+---------------------+-----------------------+--------------------+-----------------------------------------------------------+\r
-\r
- **NetworkAddress:**\r
-\r
-+-----------------+---------------------+-----------------------+-------------------+---------------------------------------------------------------------------------------------------------------+\r
-| **Attribute** | **Qualifier** | **Cardinality** | **Content** | **Description** |\r
-+=================+=====================+=======================+===================+===============================================================================================================+\r
-| addressType | M | 1 | Enum | Describes the type of the address to be assigned to the CP instantiated from the parent CPD. |\r
-| | | | | |\r
-| | | | | Permitted values: |\r
-| | | | | |\r
-| | | | | - MAC |\r
-| | | | | |\r
-| | | | | - IP |\r
-+-----------------+---------------------+-----------------------+-------------------+---------------------------------------------------------------------------------------------------------------+\r
-| l2AddressData | CM | 0..1 | String | Provides the information on the MAC addresses to be assigned to the CP(s) instantiated from the parent CPD. |\r
-| | | | | |\r
-| | | | | Shall be present when the addressType is MAC address. |\r
-+-----------------+---------------------+-----------------------+-------------------+---------------------------------------------------------------------------------------------------------------+\r
-| l3AddressData | CM | 0..1 | L3AddressData | Provides the information on the IP addresses to be assigned to the CP instantiated from the parent CPD. |\r
-| | | | | |\r
-| | | | | Shall be present when the addressType is IP address. |\r
-+-----------------+---------------------+-----------------------+-------------------+---------------------------------------------------------------------------------------------------------------+\r
-\r
- **L3AddressData:**\r
-\r
-+-----------------+---------------------+-----------------------+-------------------+-----------------------+\r
-| **Attribute** | **Qualifier** | **Cardinality** | **Content** | **Description** |\r
-+=================+=====================+=======================+===================+=======================+\r
-| iPAddressType | M | 1 | ENUM | IP address type. |\r
-| | | | | |\r
-| | | | | Permitted values: |\r
-| | | | | |\r
-| | | | | - IPv4 |\r
-| | | | | |\r
-| | | | | - IPv6 |\r
-+-----------------+---------------------+-----------------------+-------------------+-----------------------+\r
-| iPAddress | M | 1 | String | IP address |\r
-+-----------------+---------------------+-----------------------+-------------------+-----------------------+\r
-\r
- {\r
-\r
- "flavourId": "flavour\_1", \r
- "instantiationLevelId":"instantiationLevel\_1", \r
- "extVirtualLinks": [\r
-\r
- { "vlInstanceId": "1",\r
- "vim": {\r
- "vimInfoId": "1",\r
- "vimId": "1", \r
- "interfaceInfo": {\r
-\r
- "vimType": "vim",\r
- "apiVersion": "v2",\r
- "protocolType": "http"\r
-\r
- },\r
- "accessInfo": {\r
-\r
- "tenant": "tenant\_vCPE", \r
- "username": "vCPE", \r
- "password": "vCPE\_321"\r
-\r
- },\r
- "interfaceEndpoint": "http://10.43.21.105:80/"\r
-\r
- },\r
- "resourceId": "1246", \r
- "extCps": [\r
-\r
- {\r
- "cpdId": "11", "addresses": [\r
-\r
- {\r
- "addressType": "MAC", \r
- "l2AddressData": "00:f3:43:20:a2:a3"\r
-\r
- },\r
- {\r
-\r
- "addressType": "IP", \r
- "l3AddressData": {\r
-\r
- "iPAddressType": "IPv4", \r
- "iPAddress": "192.168.104.2"\r
-\r
- }\r
-\r
- }\r
-\r
- ],\r
- "numDynamicAddresses": 0\r
-\r
- },\r
-\r
- ...\r
-\r
- ]\r
-\r
- }\r
-\r
- ],\r
-\r
- "localizationLanguage": "en\_US", "additionalParams": {...}\r
-\r
- }\r
-\r
-\r
-**3.3.2 Response**\r
-\r
-+-------------+-------------+---------------+------------------+---------------------------------------------------------+\r
-| Parameter | Qualifier | Cardinality | Content | Description |\r
-+=============+=============+===============+==================+=========================================================+\r
-| vnfLcOpId | M | 1 | Identifier | Identifier of the VNF lifecycle operation occurrence. |\r
-+-------------+-------------+---------------+------------------+---------------------------------------------------------+\r
-\r
- {\r
-\r
- "vnfLcOpId": "1"\r
-\r
- }\r
-\r
- **3.3.3 Response Code**\r
-\r
-+-----------+-----------------------+------------------------------------------------------------------------------------------+\r
-| Code | Meaning | Description |\r
-+===========+=======================+==========================================================================================+\r
-| 202 | Accepted | The request is accepted for processing, but the processing has not been completed. |\r
-+-----------+-----------------------+------------------------------------------------------------------------------------------+\r
-| 4xx/5xx | <name from RFC7231> | <description> |\r
-+-----------+-----------------------+------------------------------------------------------------------------------------------+\r
-\r
-**3.4 Terminate VNF**\r
----------------------\r
-\r
-+---------------------+-----------------------------------------------------------------------------------------+\r
-| If Definition | Description |\r
-+=====================+=========================================================================================+\r
-| URI | http(s)://[hostname][:port]/gvnfmapi/lcm/v1/vnf\_instances/{vnfInstanceId}/term inate |\r
-+---------------------+-----------------------------------------------------------------------------------------+\r
-| Operation | POST |\r
-+---------------------+-----------------------------------------------------------------------------------------+\r
-| Direction | NFVO->VNFMLCM |\r
-+---------------------+-----------------------------------------------------------------------------------------+\r
-\r
-**3.4.1 Request**\r
-\r
-+-------------------+-------------+---------------+---------------+-------------------------------------------------------------------------+\r
-| Parameter | Qualifier | Cardinality | Content | Description |\r
-+===================+=============+===============+===============+=========================================================================+\r
-| terminationType | M | 1 | Enum | Indicates whether forceful or graceful termination is requested. |\r
-| | | | | |\r
-| | | | | Permitted values: |\r
-| | | | | |\r
-| | | | | - FORCEFUL: The VNFM |\r
-| | | | | will shut down the VNF and release the resources immediately |\r
-| | | | | after accepting the request. |\r
-| | | | | - GRACEFUL: The VNFM |\r
-| | | | | |\r
-| | | | | will first arrange to take the VNF out of service after accepting |\r
-| | | | | the request. Once the operation is successful or once the timer |\r
-| | | | | value specified in the |\r
-| | | | | |\r
-| | | | | “gracefulTerminationTime out” attribute expires, the VNFM will shut |\r
-| | | | | down the VNF and release the resources. |\r
-+-------------------+-------------+---------------+---------------+-------------------------------------------------------------------------+\r
-| graceful | O | 0..1 | Integer | This attribute is only |\r
-| Termination | | | | applicable in case of graceful |\r
-| Timeout | | | | termination. It defines the |\r
-| | | | | time to wait for the VNF to be |\r
-| | | | | taken out of service before |\r
-| | | | | shutting down the VNF and |\r
-| | | | | releasing the resources. |\r
-| | | | | The unit is seconds. |\r
-| | | | | If not given and the |\r
-| | | | | "terminationType" |\r
-| | | | | attribute is set to |\r
-| | | | | "GRACEFUL", it is expected |\r
-| | | | | that the VNFM waits for |\r
-| | | | | the successful taking out of |\r
-| | | | | service of the VNF, no |\r
-| | | | | matter how long it takes, |\r
-| | | | | before shutting down the |\r
-| | | | | VNF and releasing the |\r
-| | | | | resources. |\r
-+-------------------+-------------+---------------+---------------+-------------------------------------------------------------------------+\r
-\r
- {\r
- "terminationType": "GRACEFUL", \r
- "gracefulTerminationTimeout": 120\r
-\r
- }\r
-\r
-**3.4.2 Response**\r
-\r
-+-------------+-------------+---------------+------------------+---------------------------------------------------------+\r
-| Parameter | Qualifier | Cardinality | Content | Description |\r
-+=============+=============+===============+==================+=========================================================+\r
-| vnfLcOpId | M | 1 | Identifier | Identifier of the VNF lifecycle operation occurrence. |\r
-+-------------+-------------+---------------+------------------+---------------------------------------------------------+\r
-\r
- {\r
- "vnfLcOpId": "2"\r
-\r
- }\r
-\r
-**3.4.3 Response Code**\r
-\r
-+-----------+-----------------------+------------------------------------------------------------------------------------------+\r
-| Code | Meaning | Description |\r
-+===========+=======================+==========================================================================================+\r
-| 202 | Accepted | The request is accepted for processing, but the processing has not been completed. |\r
-+-----------+-----------------------+------------------------------------------------------------------------------------------+\r
-| 4xx/5xx | <name from RFC7231> | <description> |\r
-+-----------+-----------------------+------------------------------------------------------------------------------------------+\r
-\r
-**3.5 Query multiple VNF**\r
----------------------------\r
-+---------------------+--------------------------------------------------------------+\r
-| If Definition | Description |\r
-+=====================+==============================================================+\r
-| URI | http(s)://[hostname][:port]/gvnfmapi/lcm/v1/vnf\_instances |\r
-+---------------------+--------------------------------------------------------------+\r
-| Operation | GET |\r
-+---------------------+--------------------------------------------------------------+\r
-| Direction | NFVO->VNFMLCM |\r
-+---------------------+--------------------------------------------------------------+\r
-\r
-**3.5.1 Request**\r
-\r
-+-------------+-------------+---------------+---------------+---------------+\r
-| Parameter | Qualifier | Cardinality | Content | Description |\r
-+=============+=============+===============+===============+===============+\r
-| n/a | | | | |\r
-+-------------+-------------+---------------+---------------+---------------+\r
-\r
-**3.5.2 Response**\r
-\r
-+--------------------+-------------+---------------+------------------------+--------------------------------------------------------------------------------------+\r
-| Parameter | Qualifier | Cardinality | Content | Description |\r
-+====================+=============+===============+========================+======================================================================================+\r
-| vnfInstanceInfos | M | 0..N | VnfInstanceI nfo | Returned if information about zero or more VNF instances was queried successfully. |\r
-+--------------------+-------------+---------------+------------------------+--------------------------------------------------------------------------------------+\r
-+--------------------+-------------+---------------+------------------------+--------------------------------------------------------------------------------------+\r
-\r
- **VnfInstanceInfo:**\r
-\r
-+----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+\r
-| Attribute | Qualifier|Cardinality | Content | Description |\r
-+==================================+==========+============+============================+=======================================================================================================================================================+\r
-| vnfInstanceId | M | 1 | Identifier | VNF instance identifier. |\r
-+----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+\r
-| vnfInstanceName | M | 1 | String | VNF instance name. |\r
-+----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+\r
-| vnfInstanceDescr iption | M | 1 | String | Human-readable description of the VNF instance. |\r
-+----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+\r
-| onboardedVnfPk gInfoId | M | 1 | Identifier | Identifier of information held by the NFVO about the specific VNF Package on which the VNF is based. This identifier was allocated by the NFVO. |\r
-+----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+\r
-| vnfdId | M | 1 | Identifier | Identifier of the VNFD on which the VNF instance is based. |\r
-+----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+\r
-| vnfdVersion | M | 1 | Identifier | Identifies the version of the VNFD. The value is copied from the VNFD. |\r
-+----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+\r
-| vnfSoftwareVersi on | M | 1 | String | Software version of the VNF. |\r
-| | | | | |\r
-| | | | | The value is copied from the VNFD. |\r
-+----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+\r
-| vnfProvider | M | 1 | String | Name of the person or company providing the VNF. |\r
-| | | | | |\r
-| | | | | The value is copied from the VNFD. |\r
-+----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+\r
-| vnfProductName | M | 1 | String | Name to identify the VNF Product. The value is copied from the VNFD. |\r
-+----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+\r
-| vnfConfigurableP roperties | O | 0..N | KeyValuePair | Current values of the configurable properties of the VNF instance. |\r
-| | | | | |\r
-| | | | | Configurable properties as declared in the VNFD. |\r
-+----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+\r
-| instantiationState | M | 1 | Enum | The instantiation state of the VNF. |\r
-| | | | | |\r
-| | | | | Permitted values: |\r
-| | | | | |\r
-| | | | | - NOT\_INSTANTIATED: The VNF |\r
-| | | | | |\r
-| | | | | instance is terminated or not instantiated. |\r
-| | | | | |\r
-| | | | | - INSTANTIATED: The VNF instance is instantiated. |\r
-+----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+\r
-| instantiatedVnfInf o | CM | 0..1 | InstantiatedVnf Info | Information specific to an instantiated VNF instance. |\r
-| | | | | |\r
-| | | | | This attribute shall be present if the instantiateState attribute value is INSTANTIATED. |\r
-+----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+\r
-| metadata | O | 0..N | KeyValuePair | Additional metadata describing the VNF instance. |\r
-| | | | | |\r
-| | | | | This attribute can be modified with the Modify VNF information operation. |\r
-+----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+\r
-| extensions | O | 0..N | KeyValuePair | VNF-specific attributes. |\r
-| | | | | |\r
-| | | | | This attribute can be modified with the Modify VNF information operation. |\r
-+----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+\r
-\r
- **InstantiatedVnfInfo:**\r
-\r
-+------------------------------+-----------+------------+------------------------------+------------------------------------------------------------------------------------------------------------------------+\r
-| Attribute | Qualifier | Cardinality| Content | Description |\r
-+==============================+===========+============+==============================+========================================================================================================================+\r
-| flavourId | M | 1 | IdentifierInVnfd | Identifier of the VNF deployment flavour to be instantiated. |\r
-| | | | | |\r
-| | | | | Reserved |\r
-+------------------------------+-----------+------------+------------------------------+------------------------------------------------------------------------------------------------------------------------+\r
-| vnfState | M | 1 | ENUM | State of the VNF instance. |\r
-| | | | | |\r
-| | | | | Permitted values: |\r
-| | | | | |\r
-| | | | | - STARTED: The VNF instance is up and running. |\r
-| | | | | |\r
-| | | | | - STOPPED: The VNF instance has been shut down. |\r
-+------------------------------+-----------+------------+------------------------------+------------------------------------------------------------------------------------------------------------------------+\r
-| scaleStatus | O | 0..N | ScaleInfo | Scale status of the VNF, one entry per aspect. Represents for every scaling aspect how "big" the VNF has been scaled |\r
-| | | | | |\r
-| | | | | w.r.t. that aspect. |\r
-| | | | | |\r
-| | | | | This attribute shall be present if the VNF supports scaling. |\r
-+------------------------------+-----------+------------+------------------------------+------------------------------------------------------------------------------------------------------------------------+\r
-| extCpInfo | O | 0..N | CpInfo | Information about the external CPs exposed by the VNF instance. |\r
-+------------------------------+-----------+------------+------------------------------+------------------------------------------------------------------------------------------------------------------------+\r
-| extVirtualLink | O | 0..N | ExtVirtualLinkI nfo | Information about the external VLs the VNF instance is connected to. |\r
-+------------------------------+-----------+------------+------------------------------+------------------------------------------------------------------------------------------------------------------------+\r
-| extManagedVirtu alLink | O | 0..N | extManagedVir tualLinkInfo | Information about the externally-managed internal VLs of the VNF instance. |\r
-| | | | | |\r
-| | | | | Reserved |\r
-+------------------------------+-----------+------------+------------------------------+------------------------------------------------------------------------------------------------------------------------+\r
-| monitoringParam eters | O | 0..N | MonitoringPar ameter | Active monitoring parameters. |\r
-| | | | | |\r
-| | | | | Reserved |\r
-+------------------------------+-----------+------------+------------------------------+------------------------------------------------------------------------------------------------------------------------+\r
-| localizationLangu age | O | 0..1 | String | Localization language of the VNF to be instantiated. |\r
-| | | | | |\r
-| | | | | The value shall comply with the format defined in IETF RFC 5646 [6]. |\r
-+------------------------------+-----------+------------+------------------------------+------------------------------------------------------------------------------------------------------------------------+\r
-| vimInfo | CM | 0..N | VimInfo | Information about VIM(s) managing resources for the VNF instance. |\r
-| | | | | |\r
-| | | | | This attribute shall be supported and present if VNF-related resource management in direct mode is applicable. |\r
-+------------------------------+-----------+------------+------------------------------+------------------------------------------------------------------------------------------------------------------------+\r
-| vnfcResourceInfo | CM | 0..N | VnfcResourceI nfo | Information about the virtualised compute and storage resource(s) used by the VNFCs of the VNF instance. |\r
-| | | | | |\r
-| | | | | This attribute shall be supported and present if VNF-related resource management in direct mode is applicable. |\r
-+------------------------------+-----------+------------+------------------------------+------------------------------------------------------------------------------------------------------------------------+\r
-| virtualLinkResourceInfo | CM | 0..N | VirtualLinkRes ourceInfo | Information about the virtualised network resource(s) used by the VLs of the VNF instance. |\r
-| | | | | |\r
-| | | | | This attribute shall be supported and present if VNF-related resource management in direct mode is applicable. |\r
-+------------------------------+-----------+------------+------------------------------+------------------------------------------------------------------------------------------------------------------------+\r
-| virtualStorageResourceInfo | CM | 0..N | VirtualStorage ResourceInfo | Information about the virtualised storage resource(s) used as storage for the VNF instance. |\r
-| | | | | |\r
-| | | | | This attribute shall be supported and present if VNF-related resource management in direct mode is applicable. |\r
-+------------------------------+-----------+------------+------------------------------+------------------------------------------------------------------------------------------------------------------------+\r
-\r
-**ScaleInfo:**\r
-\r
-+------------------+-------------+--------------------+--------------------+-------------------------------------------------------------------------------------------------------------------------------------+\r
-| Attribute | Qualifier | Cardinalit y | Content | Description |\r
-+==================+=============+====================+====================+=====================================================================================================================================+\r
-| aspectId | M | 1 | IdentifierInVnfd | Identifier of the scaling aspect. |\r
-+------------------+-------------+--------------------+--------------------+-------------------------------------------------------------------------------------------------------------------------------------+\r
-| scaleLevel | M | 1 | Integer | Indicates the scale level. The minimum value shall be 0 and the maximum value shall be <= maxScaleLevel as described in the VNFD. |\r
-+------------------+-------------+--------------------+--------------------+-------------------------------------------------------------------------------------------------------------------------------------+\r
-+------------------+-------------+--------------------+--------------------+-------------------------------------------------------------------------------------------------------------------------------------+\r
-\r
- **CpInfo:**\r
-\r
-+--------------------+-------------+--------------------+--------------------+------------------------------------------------------------------+\r
-| Attribute | Qualifier | Cardinalit y | Content | Description |\r
-+====================+=============+====================+====================+==================================================================+\r
-| cpInstanceId | M | 1 | Identifier | Identifier of the CP instance. |\r
-+--------------------+-------------+--------------------+--------------------+------------------------------------------------------------------+\r
-| cpdId | M | 1 | IdentifierInVnfd | Identifier of the CPD, in the VNFD. |\r
-+--------------------+-------------+--------------------+--------------------+------------------------------------------------------------------+\r
-| addresses | O | 0..N | NetworkAddre ss | List of network addresses that have been configured on the CP. |\r
-+--------------------+-------------+--------------------+--------------------+------------------------------------------------------------------+\r
-\r
- **ExtVirtualLinkInfo:**\r
-\r
-+------------------------+-------------+--------------------+-------------------+-------------------------------------------------+\r
-| Attribute | Qualifier | Cardinalit y | Content | Description |\r
-+========================+=============+====================+===================+=================================================+\r
-| extVirtualLinkId | M | 1 | Identifier | Identifier of the external VL. |\r
-+------------------------+-------------+--------------------+-------------------+-------------------------------------------------+\r
-| resourceHandle | M | 1 | ResourceHand le | Identifier of the resource realizing this VL. |\r
-+------------------------+-------------+--------------------+-------------------+-------------------------------------------------+\r
-| linkPorts | O | 0..N | VnfLinkPort | Link ports of this VL. |\r
-+------------------------+-------------+--------------------+-------------------+-------------------------------------------------+\r
-\r
- **ResourceHandle:**\r
-\r
-+---------------------+------------+------------+-------------------+--------------------------------------------------------------------------------------------------------+\r
-| Attribute | Qualifier | Cardinality| Content | Description |\r
-+=====================+============+============+===================+========================================================================================================+\r
-| vimId | CM | 0..1 | Identifier | Identifier of the VimInfo information element defining the VIM who manages the resource. |\r
-| | | | | |\r
-| | | | | This attribute shall be present if |\r
-| | | | | |\r
-| | | | | VNF-related resource management in direct mode is applicable. |\r
-| | | | | |\r
-| | | | | The value refers to a vimInfo item in the VnfInstance. |\r
-+---------------------+------------+------------+-------------------+--------------------------------------------------------------------------------------------------------+\r
-| resourceProviderId | CM | 0..1 | Identifier | Identifier of the entity responsible for the management of the resource. |\r
-| | | | | |\r
-| | | | | This attribute shall be present when VNF-related resource management in indirect mode is applicable. |\r
-| | | | | |\r
-| | | | | Reserved |\r
-+---------------------+------------+------------+-------------------+--------------------------------------------------------------------------------------------------------+\r
-| resourceId | M | 1 | IdentifierInVim | Identifier of the resource in the scope of the VIM or the resource provider. |\r
-+---------------------+------------+------------+-------------------+--------------------------------------------------------------------------------------------------------+\r
-\r
- **VnfLinkPort:**\r
-\r
-+----------------------+-------------+--------------------+-------------------+------------------------------------------------------------------------------------------------+\r
-| Attribute | Qualifier | Cardinalit y | Content | Description |\r
-+======================+=============+====================+===================+================================================================================================+\r
-| resourceHandle | M | 1 | ResourceHand le | Identifier of the virtualised network resource realizing this link port. |\r
-+----------------------+-------------+--------------------+-------------------+------------------------------------------------------------------------------------------------+\r
-| cpInstanceId | M | 1 | IdentifierInVnf | External CP of the VNF to be connected to this link port. |\r
-| | | | | |\r
-| | | | | There shall be at most one link port associated with any external connection point instance. |\r
-| | | | | |\r
-| | | | | The value refers to an extCpInfo item in the VnfInstance. |\r
-+----------------------+-------------+--------------------+-------------------+------------------------------------------------------------------------------------------------+\r
-+----------------------+-------------+--------------------+-------------------+------------------------------------------------------------------------------------------------+\r
-\r
- **VnfcResourceInfo:**\r
-\r
-+-----------------------+------------+------------+--------------------+---------------------------------------------------------------------------------------------------------------------+\r
-| Attribute | Qualifier | Cardinality| Content | Description |\r
-+=======================+============+============+====================+=====================================================================================================================+\r
-| vnfcInstanceId | M | 1 | IdentifierInVnf | Identifier of this VNFC instance. |\r
-+-----------------------+------------+------------+--------------------+---------------------------------------------------------------------------------------------------------------------+\r
-| vduId | M | 1 | IdentifierInVnfd | Reference to the applicable Vdu information element in the VNFD. |\r
-+-----------------------+------------+------------+--------------------+---------------------------------------------------------------------------------------------------------------------+\r
-| computeResourc e | M | 1 | ResourceHand le | Reference to the VirtualCompute resource. |\r
-+-----------------------+------------+------------+--------------------+---------------------------------------------------------------------------------------------------------------------+\r
-| storageResourceI ds | M | 1..N | IdentifierInVnf | Reference(s) to the VirtualStorage resource(s). |\r
-| | | | | |\r
-| | | | | The value refers to a VirtualStorageResourceInfo item in the VnfInstance. |\r
-+-----------------------+------------+------------+--------------------+---------------------------------------------------------------------------------------------------------------------+\r
-| reservationId | O | 0..1 | Identifier | The reservation identifier applicable to the resource. It shall be present when an applicable reservation exists. |\r
-| | | | | |\r
-| | | | | Reserved |\r
-+-----------------------+------------+------------+--------------------+---------------------------------------------------------------------------------------------------------------------+\r
-\r
- **VirtualStorageResourceInfo:**\r
-\r
-+---------------------------------+-------------+--------------------+--------------------+---------------------------------------------------------------------------------------------------------------------+\r
-| Attribute | Qualifier | Cardinalit y | Content | Description |\r
-+=================================+=============+====================+====================+=====================================================================================================================+\r
-| virtualStorageInst anceId | M | 1 | IdentifierInVnf | Identifier of this virtual storage resource instance. |\r
-+---------------------------------+-------------+--------------------+--------------------+---------------------------------------------------------------------------------------------------------------------+\r
-| virtualStorageDe scId | M | 1 | IdentifierInVnfd | Identifier of the VirtualStorageDesc in the VNFD. |\r
-+---------------------------------+-------------+--------------------+--------------------+---------------------------------------------------------------------------------------------------------------------+\r
-| storageResource | M | 1 | ResourceHand le | Reference to the VirtualStorage resource. |\r
-+---------------------------------+-------------+--------------------+--------------------+---------------------------------------------------------------------------------------------------------------------+\r
-| reservationId | M | 0..1 | Identifier | The reservation identifier applicable to the resource. It shall be present when an applicable reservation exists. |\r
-| | | | | |\r
-| | | | | Reserved |\r
-+---------------------------------+-------------+--------------------+--------------------+---------------------------------------------------------------------------------------------------------------------+\r
-\r
- **VirtualLinkResourceInfo:**\r
-\r
-+------------------------------+-----------+--------------+--------------------+---------------------------------------------------------------------------------------------------------------------+\r
-| Attribute | Qualifier | Cardinality | Content | Description |\r
-+==============================+===========+==============+====================+=====================================================================================================================+\r
-| virtualLinkInstanceId | M | 1 | IdentifierInVnf | Identifier of this VL instance. |\r
-+------------------------------+-----------+--------------+--------------------+---------------------------------------------------------------------------------------------------------------------+\r
-| virtualLinkDescId | M | 1 | IdentifierInVnfd | Identifier of the Virtual Link Descriptor (VLD) in the VNFD. |\r
-+------------------------------+-----------+--------------+--------------------+---------------------------------------------------------------------------------------------------------------------+\r
-| networkResource | M | 1 | ResourceHand le | Reference to the VirtualNetwork resource. |\r
-+------------------------------+-----------+--------------+--------------------+---------------------------------------------------------------------------------------------------------------------+\r
-| reservationId | M | 0..1 | Identifier | The reservation identifier applicable to the resource. It shall be present when an applicable reservation exists. |\r
-| | | | | |\r
-| | | | | Reserved |\r
-+------------------------------+-----------+--------------+--------------------+---------------------------------------------------------------------------------------------------------------------+\r
-\r
- [\r
-\r
- {\r
-\r
- "vnfInstanceId": "1", \r
- "vnfInstanceName": "vFW\_01",\r
- "vnfInstanceDescription": "vFW in Nanjing TIC Edge",\r
- "onboardedVnfPkgInfoId": "1",\r
- "vnfdId": "zte\_vFW\_51610", \r
- "vnfdVersion": "V1.0",\r
- "vnfSoftwareVersion": "V1.0", \r
- "vnfProvider": "ZTE",\r
- "vnfProductName": "vFW", \r
- "vnfConfigurableProperties": {...},\r
- "instantiationState": "INSTANTIATED", \r
- "instantiatedVnfInfo": {\r
-\r
- "flavourId": "1", \r
- "vnfState": "STARTED", \r
- "scaleStatus": [\r
-\r
- {\r
- "aspectId": "aspect1", \r
- "scaleLevel": 1\r
-\r
- }\r
-\r
- ],\r
-\r
- "extCpInfo": [\r
-\r
- {\r
- "cpInstanceId": "1",\r
- "cpdId": "1", "addresses": [\r
-\r
- {\r
- "addressType": "MAC", \r
- "l2AddressData": "00:f3:43:20:a2:a3"\r
-\r
- },\r
-\r
- {\r
- "addressType": "IP", \r
- "l3AddressData": {\r
-\r
- "iPAddressType": "IPv4", \r
- "address": "192.168.104.2"\r
-\r
- }\r
-\r
- }\r
-\r
- ]\r
-\r
- } \r
-\r
- ],\r
- "extVirtualLink": [\r
-\r
- {\r
- "extVirtualLinkId": "extvl1", \r
- "resourceHandle": {\r
-\r
- "vimId": "1",\r
- "resourceId": "1111"\r
-\r
- },\r
-\r
- "linkPorts": [\r
-\r
- {\r
- "resourceHandle": \r
-\r
- { \r
- "vimId": "1",\r
- "resourceId": "2121"\r
-\r
- },\r
-\r
- "cpInstanceId": "1"\r
-\r
- }\r
-\r
- ]\r
-\r
- }\r
-\r
- ],\r
-\r
- "monitoringParameters": {...}, \r
- "localizationLanguage": "en\_US",\r
- "vimInfo": [\r
-\r
- {\r
- "vimInfoId": "1",\r
- "vimId": "1", \r
- "interfaceInfo": {\r
-\r
- "vimType": "vim",\r
- "apiVersion": "v2", \r
- "protocolType": "http"\r
-\r
- },\r
-\r
- "accessInfo": {\r
-\r
- "tenant": "tenant\_vCPE", \r
- "username": "vCPE", \r
- "password": "vCPE\_321"\r
-\r
- },\r
-\r
- "interfaceEndpoint": "http://10.43.21.105:80/"\r
-\r
- }\r
-\r
- ],\r
- "vnfcResourceInfo": [\r
-\r
- {\r
- "vnfcInstanceId": "vm1", \r
- "vduId": "vdu1", \r
- "computeResource": {\r
-\r
- "vimId": "1",\r
- "resourceId": "3333"\r
-\r
- },\r
-\r
- "storageResourceIds": [ "storage1"\r
- ]\r
-\r
- }\r
-\r
- ],\r
-\r
- "virtualLinkResourceInfo": [\r
-\r
- {\r
- "virtualLinkInstanceId": "vl01", \r
- "virtualLinkDescId": "vl01",\r
- "networkResource": {\r
-\r
- "vimId": "1",\r
- "resourceId": "4444"\r
-\r
- }\r
-\r
- }\r
-\r
- ],\r
- "virtualStorageResourceInfo": [\r
-\r
- {\r
- "virtualStorageInstanceId": "storage1", \r
- "virtualStorageDescId":"storage1", \r
- "storageResource": {\r
-\r
- "vimId": "1",\r
- "resourceId": "555"\r
-\r
- }\r
-\r
- }\r
-\r
- ]\r
-\r
- },\r
- "metadata": {...},\r
- "extensions": {...}\r
-\r
- }\r
-\r
-]\r
-\r
-**3.5.3 Response Code**\r
-\r
-+-----------+-----------------------+----------------------------------+\r
-| Code | Meaning | Description |\r
-+===========+=======================+==================================+\r
-| 200 | Ok | The request has succeeded. |\r
-+-----------+-----------------------+----------------------------------+\r
-| 4xx/5xx | <name from RFC7231> | <description> |\r
-+-----------+-----------------------+----------------------------------+\r
-\r
-**3.6 Query single VNF**\r
-------------------------\r
-+---------------------+------------------------------------------------------------------------------+\r
-| If Definition | Description |\r
-+=====================+==============================================================================+\r
-| URI | http(s)://[hostname][:port]/gvnfmapi/lcm/v1/vnf_instances/{vnfInstanceId} |\r
-+---------------------+------------------------------------------------------------------------------+\r
-| Operation | GET |\r
-+---------------------+------------------------------------------------------------------------------+\r
-| Direction | NFVO->VNFMLCM |\r
-+---------------------+------------------------------------------------------------------------------+\r
-\r
-**3.6.1 Request**\r
-\r
-+-------------+-------------+---------------+---------------+---------------+\r
-| Parameter | Qualifier | Cardinality | Content | Description |\r
-+=============+=============+===============+===============+===============+\r
-| n/a | | | | |\r
-+-------------+-------------+---------------+---------------+---------------+\r
-\r
-**3.6.2 Response**\r
-\r
-+-------------------+-------------+---------------+------------------------+---------------------------------------+\r
-| Parameter | Qualifier | Cardinality | Content | Description |\r
-+===================+=============+===============+========================+=======================================+\r
-| vnfInstanceInfo | M | 1 | VnfInstanceI nfo | The information of the VNF instance |\r
-+-------------------+-------------+---------------+------------------------+---------------------------------------+\r
-+-------------------+-------------+---------------+------------------------+---------------------------------------+\r
-\r
-**3.6.3 Response Code**\r
-\r
-+-----------+-----------------------+----------------------------------+\r
-| Code | Meaning | Description |\r
-+===========+=======================+==================================+\r
-| 200 | Ok | The request has succeeded. |\r
-+-----------+-----------------------+----------------------------------+\r
-| 4xx/5xx | <name from RFC7231> | <description> |\r
-+-----------+-----------------------+----------------------------------+\r
-\r
- {\r
-\r
- "vnfInstanceId": "1", \r
- "vnfInstanceName": "vFW\_01",\r
- "vnfInstanceDescription": "vFW in Nanjing TIC Edge",\r
- "onboardedVnfPkgInfoId": "1",\r
- "vnfdId": "zte\_vFW\_51610", \r
- "vnfdVersion": "V1.0",\r
- "vnfSoftwareVersion": "V1.0", \r
- "vnfProvider": "ZTE",\r
- "vnfProductName": "vFW", \r
- "vnfConfigurableProperties": {...},\r
- "instantiationState": "INSTANTIATED", \r
- "instantiatedVnfInfo": {\r
- "flavourId": "1", \r
- "vnfState": "STARTED", \r
- "scaleStatus": [\r
-\r
- {\r
- "aspectId": "aspect1", \r
- "scaleLevel": 1\r
-\r
- }\r
-\r
- ],\r
-\r
- "extCpInfo": [\r
-\r
- {\r
- "cpInstanceId": "1",\r
- "cpdId": "1", "addresses": [\r
-\r
- {\r
- "addressType": "MAC", \r
- "l2AddressData": "00:f3:43:20:a2:a3"\r
-\r
- },\r
-\r
- {\r
- "addressType": "IP", \r
- "l3AddressData": {\r
-\r
- "iPAddressType": "IPv4", \r
- "address": "192.168.104.2"\r
-\r
- }\r
-\r
- }\r
-\r
- ]\r
-\r
- }\r
-\r
- ],\r
-\r
- "extVirtualLink": [\r
-\r
- {\r
- "extVirtualLinkId": "extvl1", \r
- "resourceHandle": {\r
-\r
- "vimId": "1",\r
- "resourceId": "1111"\r
-\r
- },\r
-\r
- "linkPorts": [\r
-\r
- {\r
- "resourceHandle":\r
- \r
- { \r
- "vimId": "1",\r
- "resourceId": "2121"\r
-\r
- },\r
- "cpInstanceId": "1"\r
-\r
- }\r
-\r
- ]\r
-\r
- }\r
-\r
- ],\r
-\r
- "monitoringParameters": {...}, \r
- "localizationLanguage": "en\_US",\r
- "vimInfo": [\r
-\r
- {\r
- "vimInfoId": "1",\r
- "vimId": "1", \r
- "interfaceInfo": {\r
-\r
- "vimType": "vim",\r
- "apiVersion": "v2", \r
- "protocolType": "http"\r
-\r
- },\r
-\r
- "accessInfo": {\r
-\r
- "tenant": "tenant\_vCPE", \r
- "username": "vCPE", \r
- "password": "vCPE\_321"\r
-\r
- },\r
- "interfaceEndpoint": "http://10.43.21.105:80/"\r
-\r
- }\r
-\r
- ],\r
-\r
- "vnfcResourceInfo": [\r
-\r
- {\r
- "vnfcInstanceId": "vm1", \r
- "vduId": "vdu1", \r
- "computeResource": {\r
-\r
- "vimId": "1",\r
- "resourceId": "3333"\r
-\r
- },\r
-\r
- "storageResourceIds": [ "storage1"\r
- ]\r
-\r
- }\r
-\r
- ],\r
-\r
- "virtualLinkResourceInfo": [\r
-\r
- {\r
- "virtualLinkInstanceId": "vl01", \r
- "virtualLinkDescId": "vl01",\r
- "networkResource": {\r
-\r
- "vimId": "1",\r
- "resourceId": "4444"\r
-\r
- }\r
-\r
- }\r
-\r
- ],\r
-\r
- "virtualStorageResourceInfo": [\r
-\r
- {\r
- "virtualStorageInstanceId": "storage1", \r
- "virtualStorageDescId": "storage1", \r
- "storageResource": {\r
-\r
- "vimId": "1",\r
- "resourceId": "555"\r
-\r
- }\r
-\r
- }\r
-\r
- ]\r
-\r
- },\r
- "metadata": {...},\r
- "extensions": {...}\r
-\r
- }\r
-\r
-**3.7 Get Operation Status**\r
-------------------------------\r
-+---------------------+-------------------------------------------------------------------------------------------------+\r
-| If Definition | Description |\r
-+=====================+=================================================================================================+\r
-| URI | http(s)://[hostname][:port]/gvnfmapi/lcm/v1/vnf\_lc\_ops/{vnfLcOpId}&response Id={responseId} |\r
-+---------------------+-------------------------------------------------------------------------------------------------+\r
-| Operation | GET |\r
-+---------------------+-------------------------------------------------------------------------------------------------+\r
-| Direction | NFVO->GVNFM |\r
-+---------------------+-------------------------------------------------------------------------------------------------+\r
-\r
-**3.7.1 Request**\r
-\r
- None\r
-\r
-**3.7.2 Response**\r
-\r
-+--------------------+-------------+---------------+-----------+----------------------------------------------------------------------------------+\r
-| Parameter | Qualifier | Cardinality | Content | Description |\r
-+====================+=============+===============+===========+==================================================================================+\r
-| vnfLcOpId | M | 1 | String | Identifier of a VNF lifecycle operation occurrence |\r
-+--------------------+-------------+---------------+-----------+----------------------------------------------------------------------------------+\r
-| vnfInstanceId | M | 1 | String | Identifier of the VNF instance to which the operation applies |\r
-+--------------------+-------------+---------------+-----------+----------------------------------------------------------------------------------+\r
-| lcmOperationType | M | 1 | ENUM | Type of the actual LCM operation represented by this lcm operation occurrence. |\r
-| | | | | |\r
-| | | | | Permitted values: |\r
-| | | | | |\r
-| | | | | - INSTANTIATE:the |\r
-| | | | | |\r
-| | | | | Instantiate VNF LCM operation. |\r
-| | | | | |\r
-| | | | | - SCALE: the Scale VNF LCM operation. |\r
-| | | | | |\r
-| | | | | - SCALE\_TO\_LEVEL: the |\r
-| | | | | |\r
-| | | | | Scale VNF to Level LCM operation. |\r
-| | | | | |\r
-| | | | | - CHANGE\_FLAVOUR: |\r
-| | | | | |\r
-| | | | | the Change VNF Flavour LCM operation. |\r
-| | | | | |\r
-| | | | | - TERMINATE: the |\r
-| | | | | |\r
-| | | | | Terminate VNF LCM operation. |\r
-| | | | | |\r
-| | | | | - HEAL: the Heal VNF LCM operation. |\r
-| | | | | |\r
-| | | | | - OPERATE: the Operate VNF LCM operation. |\r
-| | | | | |\r
-| | | | | - CHANGE\_EXT\_VLS: the |\r
-| | | | | |\r
-| | | | | Change VNF external VLs LCM operation. (Reserved) |\r
-+--------------------+-------------+---------------+-----------+----------------------------------------------------------------------------------+\r
-| startTime | M | 1 | String | Date-time of the start of the operation. |\r
-| | | | | |\r
-| | | | | Representation: String formatted according to RFC 3339 [13] |\r
-+--------------------+-------------+---------------+-----------+----------------------------------------------------------------------------------+\r
-| responseDescriptor | M | 1 | VnfLcOp | Including:responseId,progress,statusstatusDescription |\r
-| | | | Response | |\r
-| | | | Descriptor| ,errorCode,responseHistoryList |\r
-+--------------------+-------------+---------------+-----------+----------------------------------------------------------------------------------+\r
-\r
- **VnfLcOpResponseDescriptor:**\r
-\r
-+---------------------------+-----------------+--------------------+---------------+-----------------------------------------------------------+\r
-| Attribute | Qualifier | Cardinalit y | Content | Description |\r
-+===========================+=================+====================+===============+===========================================================+\r
-| responseId | M | 1 | Integer | Response Identifier |\r
-+---------------------------+-----------------+--------------------+---------------+-----------------------------------------------------------+\r
-| progress | M | 1 | Integer | progress (1-100) |\r
-+---------------------------+-----------------+--------------------+---------------+-----------------------------------------------------------+\r
-| lcmOperationStatus | M | 1 | ENUM | Status of a VNF lifecycle operation occurrence |\r
-| | | | | |\r
-| | | | | Permitted values: |\r
-| | | | | |\r
-| | | | | - STARTING: The operation is starting.. |\r
-| | | | | |\r
-| | | | | - PROCESSING: The operation is |\r
-| | | | | currently in execution. |\r
-| | | | | |\r
-| | | | | - COMPLETED: The operation has completed successfully. |\r
-| | | | | |\r
-| | | | | - FAILED: The operation has failed and it cannot be |\r
-| | | | | retried or rolled back, as it is determined |\r
-| | | | | that such action won't succeed. |\r
-| | | | | - FAILED\_TEMP: The operation has failed and execution |\r
-| | | | | has stopped, but the execution of the |\r
-| | | | | operation is not considered to be closed. |\r
-| | | | | |\r
-| | | | | (Reserved) |\r
-| | | | | |\r
-| | | | | - ROLLING\_BACK: The operation is currently being rolled |\r
-| | | | | back. (Reserved) |\r
-| | | | | |\r
-| | | | | - ROLLED\_BACK: The state of the VNF prior to the |\r
-| | | | | original operation invocation has been |\r
-| | | | | |\r
-| | | | | restored as closely as possible. (Reserved) | \r
-+---------------------------+-----------------+--------------------+---------------+-----------------------------------------------------------+\r
-| statusDescripti on | O | 0..1 | String | Status Description of a VNF lifecycle operation |\r
-| | | | | occurrence |\r
-+---------------------------+-----------------+--------------------+---------------+-----------------------------------------------------------+\r
-| errorCode | O | 0..1 | Integer | Errorcode |\r
-+---------------------------+-----------------+--------------------+---------------+-----------------------------------------------------------+\r
-| responseHistor yList | O | 0..N | VnfLcOpDetail | History Response Messages from the requested |\r
-| | | | | responseId to lastest one. |\r
-+---------------------------+-----------------+--------------------+---------------+-----------------------------------------------------------+\r
-\r
- **VnfLcOpDetail:**\r
-\r
-+---------------------------+-----------------+--------------------+---------------+-----------------------------------------------------------+\r
-| Attribute | Qualifier | Cardinalit y | Content | Description |\r
-+===========================+=================+====================+===============+===========================================================+\r
-| responseId | M | 1 | Integer | Response Identifier |\r
-+---------------------------+-----------------+--------------------+---------------+-----------------------------------------------------------+\r
-| progress | M | 1 | Integer | progress (1-100) |\r
-+---------------------------+-----------------+--------------------+---------------+-----------------------------------------------------------+\r
-| lcmOperationS tatus | M | 1 | ENUM | Status of a VNF lifecycle operation occurrence |\r
-| | | | | |\r
-| | | | | Permitted values: |\r
-| | | | | |\r
-| | | | | - STARTING: The operation is starting.. |\r
-| | | | | |\r
-| | | | | - PROCESSING: The operation is currently in execution. |\r
-| | | | | |\r
-| | | | | - COMPLETED: The operation has completed successfully. |\r
-| | | | | |\r
-| | | | | - FAILED: The operation has failed and it |\r
-| | | | | cannot be retried or rolled back, as it is |\r
-| | | | | determined that such action won't succeed. |\r
-| | | | | |\r
-| | | | | |\r
-| | | | | - FAILED\_TEMP: The operation has failed and execution |\r
-| | | | | has stopped, but the execution of the operation |\r
-| | | | | is not considered to be closed. (Reserved) |\r
-| | | | | |\r
-| | | | | - ROLLING\_BACK: The operation is currently being |\r
-| | | | | rolled back. (Reserved) |\r
-| | | | | |\r
-| | | | | |\r
-| | | | | - ROLLED\_BACK: The state of the VNF prior to the |\r
-| | | | | original operation invocation has been restored |\r
-| | | | | as closely as possible. (Reserved) |\r
-| | | | | |\r
-+---------------------------+-----------------+--------------------+---------------+-----------------------------------------------------------+\r
-| statusDescription | O | 0..1 | String | Status Description of a VNF lifecycle operation occurrence|\r
-+---------------------------+-----------------+--------------------+---------------+-----------------------------------------------------------+\r
-| errorCode | O | 0..1 | Integer | Errorcode |\r
-+---------------------------+-----------------+--------------------+---------------+-----------------------------------------------------------+\r
-\r
- {\r
-\r
- "vnfLcOpId": "1234566",\r
-\r
- "vnfInstanceId": "1", \r
- "lcmOperationType": "INSTANTIATE",\r
-\r
- "startTime": "2017-01-01T12:00:27.87+00:20",\r
-\r
- "responseDescriptor": {\r
- \r
- "responseId": 3,\r
- "progress": 40, \r
- "lcmOperationStatus": "PROCESSING",\r
- "statusDescription": "OMC VMs are decommissioned in VIM",\r
- "errorCode": null,\r
- "responseHistoryList": [\r
-\r
- {\r
- "responseId": 1,\r
- "progress": 40, \r
- "lcmOperationStatus": "PROCESSING",\r
- "statusDescription": "OMC VMs are decommissioned in VIM",\r
- "errorCode": null\r
-\r
- },\r
- {\r
-\r
- "responseId": 2,\r
- "progress": 41, \r
- "lcmOperationStatus": "PROCESSING",\r
- "statusDescription": "OMC VMs are decommissioned in VIM",\r
- "errorCode": null\r
-\r
- }\r
-\r
- ]\r
-\r
- }\r
-\r
- }\r
-\r
-**3.7.3 Response Code**\r
-\r
-+-----------+-----------------------+----------------------------------+\r
-| Code | Meaning | Description |\r
-+===========+=======================+==================================+\r
-| 200 | Ok | The request has succeeded. |\r
-+-----------+-----------------------+----------------------------------+\r
-| 4xx/5xx | <name from RFC7231> | <description> |\r
-+-----------+-----------------------+----------------------------------+\r
-\r
-**4.Interfaces provided by VNF**\ (Ve-Vnfm-vnf)\r
-===============================================\r
-\r
-**4.1 Set Initial Configuration**\r
----------------------------------\r
-\r
-+---------------------+---------------------------------------------+\r
-| If Definition | Description |\r
-+=====================+=============================================+\r
-| URI | http(s)://[hostname][:port]/configuration |\r
-+---------------------+---------------------------------------------+\r
-| Operation | POST |\r
-+---------------------+---------------------------------------------+\r
-| Direction | VNFM->VNF |\r
-+---------------------+---------------------------------------------+\r
-\r
- **4.1.1Request**\r
-\r
-+-------------------------+-------------+---------------+--------------------------+------------------------------------------------------------------------------+\r
-| Parameter | Qualifier | Cardinality | Content | Description |\r
-+=========================+=============+===============+==========================+==============================================================================+\r
-| vnfInstanceId | M | 1 | Identifier | Identifier of the VNF instance which the VNF to set initial configuration. |\r
-+-------------------------+-------------+---------------+--------------------------+------------------------------------------------------------------------------+\r
-| vnfConfigurationData | O | 0..1 | VnfConfigur ation | Configuration data for the VNF instance. |\r
-+-------------------------+-------------+---------------+--------------------------+------------------------------------------------------------------------------+\r
-| vnfcConfigurationData | O | 0..N | VnfcConfigu ration | Configuration data for VNFC instances. |\r
-+-------------------------+-------------+---------------+--------------------------+------------------------------------------------------------------------------+\r
-\r
-**VnfConfiguration:**\r
-\r
-+-----------------------+-----------------+--------------------+----------------------------------+------------------------------------------------------------------------------+\r
-| Attribute | Qualifier | Cardinalit y | Content | Description |\r
-+=======================+=================+====================+==================================+==============================================================================+\r
-| cp | O | 0..N | CpConfiguratio n | External CPs |\r
-+-----------------------+-----------------+--------------------+----------------------------------+------------------------------------------------------------------------------+\r
-| vnfSpecificData | O | 0..1 | VnfConfigurabl eProperties | Configuration object containing values of VNF configurable properties. |\r
-+-----------------------+-----------------+--------------------+----------------------------------+------------------------------------------------------------------------------+\r
-\r
-**CpConfiguration:**\r
-\r
-+-----------------+-------------+--------------------+--------------+-------------------------------------------------------------------------------------------------------+\r
-| Attribute | Qualifier | Cardinalit y | Content | Description |\r
-+=================+=============+====================+==============+=======================================================================================================+\r
-| cpId | M | 1 | Identifier | Uniquely identifies a CP instance within the namespace of a specific VNF instance or VNFC instance. |\r
-+-----------------+-------------+--------------------+--------------+-------------------------------------------------------------------------------------------------------+\r
-| cpdId | M | 1 | Identifier | Uniquely identifies a type of CP instance within the namespace of a VNFD. |\r
-+-----------------+-------------+--------------------+--------------+-------------------------------------------------------------------------------------------------------+\r
-| cpAddress | M | 1..N | CpAddress | Address and Port assigned to the CP. |\r
-+-----------------+-------------+--------------------+--------------+-------------------------------------------------------------------------------------------------------+\r
-\r
- **CpAddress:**\r
-\r
-+--------------------------+-------------+--------------------+-------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+\r
-| Attribute | Qualifier | Cardinalit y | Content | Description |\r
-+==========================+=============+====================+===================+===============================================================================================================================================+\r
-| address | M | 0..N | NetworkAddre ss | The address assigned to the CP instance (e.g. IP address, MAC address, etc.). It shall be provided for configuring a fixed address. |\r
-+--------------------------+-------------+--------------------+-------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+\r
-| useDynamicAddress | M | 0..1 | ENUM | It determines whether an address shall be assigned dynamically. It shall be provided if a dynamic address needs to be configured on the CP. |\r
-| | | | | |\r
-| | | | | A cardinality of "0" indicates that no dynamic address needs to be configured on the CP. |\r
-| | | | | |\r
-| | | | | Permitted values: |\r
-| | | | | |\r
-| | | | | - TRUE |\r
-| | | | | |\r
-| | | | | - FALSE |\r
-+--------------------------+-------------+--------------------+-------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+\r
-| port | M | 0..1 | Not specified | The port assigned to the CP instance (e.g. IP port number, Ethernet port number, etc.). |\r
-| | | | | |\r
-| | | | | Reserved |\r
-+--------------------------+-------------+--------------------+-------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+\r
-\r
- **VnfConfigurableProperties:**\r
-\r
-+--------------------+-----------+--------------+--------+-----------------------------------------------------------------------------------------------+\r
-| Attribute | Qualifier | Cardinality | Content| Description |\r
-+====================+===========+==============+========+===============================================================================================+\r
-| autoScalable | O | 0..1 | ENUM | It permits to enable (TRUE) / disable (FALSE) the auto-scaling functionality. |\r
-| | | | | |\r
-| | | | | A cardinality of "0" indicates that configuring this present VNF property is not supported. |\r
-| | | | | |\r
-| | | | | Permitted values: |\r
-| | | | | |\r
-| | | | | - TRUE |\r
-| | | | | |\r
-| | | | | - FALSE |\r
-+--------------------+-----------+--------------+--------+-----------------------------------------------------------------------------------------------+\r
-| autoHealable | O | 0..1 | ENUM | It permits to enable (TRUE) / disable (FALSE) the auto-healing functionality. |\r
-| | | | | |\r
-| | | | | A cardinality of "0" indicates that configuring this present VNF property is not supported. |\r
-| | | | | |\r
-| | | | | Permitted values: |\r
-| | | | | |\r
-| | | | | - TRUE |\r
-| | | | | |\r
-| | | | | - FALSE |\r
-+--------------------+-----------+--------------+--------+-----------------------------------------------------------------------------------------------+\r
-\r
-**VnfcConfiguration:**\r
-\r
-+------------------------+-------------+--------------------+--------------------+----------------------------------------------------------------------------------------+\r
-| Attribute | Qualifier | Cardinalit y | Content | Description |\r
-+========================+=============+====================+====================+========================================================================================+\r
-| vnfcId | M | 1 | Identifier | Uniquely identifies a VNFC instance within the namespace of a specific VNF instance. |\r
-+------------------------+-------------+--------------------+--------------------+----------------------------------------------------------------------------------------+\r
-| cp | O | 0..N | CpConfiguratio n | Internal CPs. |\r
-+------------------------+-------------+--------------------+--------------------+----------------------------------------------------------------------------------------+\r
-| vnfcSpecificData | O | 0..1 | KeyValuePair | Configuration object containing values of VNFC configurable properties |\r
-+------------------------+-------------+--------------------+--------------------+----------------------------------------------------------------------------------------+\r
-\r
- {\r
-\r
- "vnfInstanceId": "1", \r
- "vnfConfigurationData": {\r
-\r
- "cp": [\r
-\r
- {\r
- "cpId": "cp-1",\r
- "cpdId": "cpd-a", \r
- "cpAddress": [\r
-\r
- {\r
- "addresses": [\r
-\r
- {\r
- "addressType": "MAC", \r
- "l2AddressData": "00:f3:43:20:a2:a3"\r
-\r
- },\r
- {\r
-\r
- "addressType": "IP", \r
- "l3AddressData": {\r
-\r
- "iPAddressType": "IPv4", \r
- "iPAddress": "192.168.104.2"\r
-\r
- }\r
-\r
- }\r
-\r
- ],\r
-\r
- "useDynamicAddress": "FALSE"\r
-\r
- }\r
-\r
- ]\r
-\r
- }\r
-\r
- ],\r
-\r
- "vnfSpecificData": { \r
-\r
- "autoScalable": "FALSE", \r
- "autoHealable": "FALSE"\r
-\r
- }\r
-\r
- },\r
-\r
- "vnfcConfigurationData": \r
- { \r
- "vnfcId": "vnfc-1", \r
- "cp": [\r
-\r
- {\r
- "cpId": "cp-11",\r
- "cpdId": "cpd-1a",\r
- "cpAddress": [\r
-\r
- {\r
- "addresses": [\r
-\r
- {\r
- "addressType": "MAC", \r
- "l2AddressData": "00:f3:43:21:a2:a3"\r
-\r
- },\r
- {\r
-\r
- "addressType": "IP", \r
- "l3AddressData": {\r
-\r
- "iPAddressType": "IPv4", \r
- "iPAddress": "192.168.105.2"\r
-\r
- }\r
-\r
- }\r
-\r
- ],\r
- "useDynamicAddress": "FALSE"\r
-\r
- }\r
-\r
- ]\r
-\r
- }\r
-\r
- ],\r
-\r
- "vnfcSpecificData": {}\r
-\r
- }\r
-\r
- }\r
-\r
-\r
- **4.1.2 Response**\r
-\r
-+-----------------------+-------------+---------------+-------------------+---------------------------------+\r
-| Parameter | Qualifier | Cardinality | Content | Description |\r
-+=======================+=============+===============+===================+=================================+\r
-| vnfConfigurationData | O | 0..1 | VnfConfiguration | Correspond to the |\r
-| | | | | vnfConfigurationData in the |\r
-| | | | | input information elements of |\r
-| | | | | the SetInitialConfiguration |\r
-| | | | | operation if it has. |\r
-+-----------------------+-------------+---------------+-------------------+---------------------------------+\r
-| vnfcConfigurationDa | O | 0..N | VnfConfiguration | Correspond to the |\r
-| ta | | | | vnfcConfigurationData in the |\r
-| | | | | input information elements of |\r
-| | | | | the SetInitialConfiguration |\r
-| | | | | operation if it has. |\r
-+-----------------------+-------------+---------------+-------------------+---------------------------------+\r
-\r
- {\r
- "vnfConfigurationData": { \r
-\r
- "cp": [\r
-\r
- {\r
- "cpId": "cp-1",\r
- "cpdId": "cpd-a", "cpAddress": [\r
-\r
- {\r
- "addresses": [\r
-\r
- {\r
- "addressType": "MAC", \r
- "l2AddressData": "00:f3:43:20:a2:a3"\r
-\r
- },\r
- {\r
-\r
- "addressType": "IP", \r
- "l3AddressData": {\r
-\r
- "iPAddressType": "IPv4", \r
- "iPAddress": "192.168.104.2"\r
-\r
- }\r
-\r
- }\r
-\r
- ],\r
-\r
- "useDynamicAddress": "FALSE"\r
-\r
- }\r
-\r
- ]\r
-\r
- }\r
-\r
- ],\r
- "vnfSpecificData": { \r
-\r
- "autoScalable": "FALSE", \r
- "autoHealable": "FALSE",\r
- …\r
-\r
- }\r
-\r
- },\r
-\r
- "vnfcConfigurationData": { \r
-\r
- "vnfcId": "vnfc-1", \r
- "cp": [\r
-\r
- {\r
- "cpId": "cp-11",\r
- "cpdId": "cpd-1a", \r
- "cpAddress": [\r
-\r
- {\r
- "addresses": [\r
-\r
- {\r
-\r
- "addressType": "MAC", \r
- "l2AddressData": "00:f3:43:21:a2:a3"\r
-\r
- },\r
- {\r
-\r
- "addressType": "IP", \r
- "l3AddressData": {\r
-\r
- "iPAddressType": "IPv4", \r
- "iPAddress": "192.168.105.2"\r
-\r
- }\r
-\r
- }\r
-\r
- ],\r
-\r
- "useDynamicAddress": "FALSE"\r
-\r
- }\r
-\r
- ]\r
-\r
- }\r
-\r
- ],\r
-\r
- "vnfcSpecificData": {…}\r
-\r
- }\r
-\r
- }\r
-\r
- **4.1.3Response Code**\r
-\r
-+-----------+-----------------------+-----------------------------------------------------------+\r
-| Code | Meaning | Description |\r
-+===========+=======================+===========================================================+\r
-| 201 | Created | A VNF Instance identifier was created successfully. |\r
-+-----------+-----------------------+-----------------------------------------------------------+\r
-| 4xx/5xx | <name from RFC7231> | <description> |\r
-+-----------+-----------------------+-----------------------------------------------------------+\r
-\r
-.. |image0| image:: VNFM_API.png\r
- :width: 5.07047in\r
- :height: 5.6320in
\ No newline at end of file
+.. contents::
+ :depth: 3
+..
+
+ **GVNFM Northbound & Southbound APIs**
+ **V0.1**
+
+**1 Scope**
+=============
+
+The scope of the this document is to describe the GVNFM exposed API specification over Or-Vnfm reference point and Ve-Vnfm-vnf reference point.
+Some content has been updated, about the API Swagger definition, you can find here 'GVNFM_LCM_APIs<https://gerrit.onap.org/r/gitweb?p=vfc/gvnfm/vnflcm.git;a=blob;f=lcm/lcm/swagger/swagger.json;h=f098d282927d3535f5e9e6950f26b9171e04d30c;hb=HEAD>'.
+
+
+**2 Terms, Definitions and Abbreviations**
+===========================================
+
+ For the purpose of the present document, the following
+ abbreviations apply:
+
++------------------------+-----------------------------------------------------+
+| **Abbreviation** | |
++========================+=====================================================+
+| NFVO | Network Functions Virtualization Orchestrator |
++------------------------+-----------------------------------------------------+
+| VNFM | Virtual Network Function Manager |
++------------------------+-----------------------------------------------------+
+| VNF | Virtual Network Function |
++------------------------+-----------------------------------------------------+
+
+Table 2-1 abbreviations
+
+**3. Interfaces provided by GVNFM** (Or-Vnfm)
+==========================================================
+
+ Interfaces use RESTful API and the format is as follows:
+ http(s)://[hostname][:port]/api/vnflcm/v1/[……]
+
+|image0|
+
+
+ **{apiRoot} is** http(s)://[hostname][:port]/api
+
+**3.1 Create VNF Identifier**
+-----------------------------
+
++---------------------+--------------------------------------------------------------+
+| If Definition | Description |
++=====================+==============================================================+
+| URI | http(s)://[hostname][:port]/api/vnflcm/v1/vnf\_instances |
++---------------------+--------------------------------------------------------------+
+| Operation | POST |
++---------------------+--------------------------------------------------------------+
+| Direction | NFVO->VNFMLCM |
++---------------------+--------------------------------------------------------------+
+
+**3.1.1 Request**
+
++---------------------------+-------------+---------------+------------------+-------------------------------------------------------------------------------------+
+| Parameter | Qualifier | Cardinality | Content | Description |
++===========================+=============+===============+==================+=====================================================================================+
+| vnfdId | M | 1 | Identifier | Identifier that identifies the VNFD which defines the VNF instance to be created. |
++---------------------------+-------------+---------------+------------------+-------------------------------------------------------------------------------------+
+| vnfInstanceName | M | 1 | String | Human-readable name of the VNF instance to be created. |
++---------------------------+-------------+---------------+------------------+-------------------------------------------------------------------------------------+
+| vnfInstanceDescription | O | 0..1 | String | Human-readable description of the VNF instance to be created. |
++---------------------------+-------------+---------------+------------------+-------------------------------------------------------------------------------------+
+
+ {
+ "vnfdId": "zte\_vFW\_51610",
+ "vnfInstanceName": "vFW\_01",
+ "vnfInstanceDescription": " vFW in Nanjing TIC Edge"
+
+ }
+
+**3.1.2 Response**
+
++-----------------+-------------+---------------+------------------+-----------------------------------------+
+| Parameter | Qualifier | Cardinality | Content | Description |
++=================+=============+===============+==================+=========================================+
+| vnfInstanceId | M | 1 | Identifier | VNF instance identifier just created. |
++-----------------+-------------+---------------+------------------+-----------------------------------------+
+
+ {
+ "vnfInstanceId": "1"
+
+ }
+
+**3.1.3 Response Code**
+
++-----------+-----------------------+-----------------------------------------------------------+
+| Code | Meaning | Description |
++===========+=======================+===========================================================+
+| 201 | Created | A VNF Instance identifier was created successfully. |
++-----------+-----------------------+-----------------------------------------------------------+
+| 4xx/5xx | <name from RFC7231> | <description> |
++-----------+-----------------------+-----------------------------------------------------------+
+
+**3.2 Delete VNF Identifier**
+-----------------------------
+
++---------------------+------------------------------------------------------------------------------+
+| If Definition | Description |
++=====================+==============================================================================+
+| URI | http(s)://[hostname][:port]/api/vnflcm/v1/vnf\_instances/{vnfInstanceId} |
++---------------------+------------------------------------------------------------------------------+
+| Operation | DELETE |
++---------------------+------------------------------------------------------------------------------+
+| Direction | NFVO->VNFMLCM |
++---------------------+------------------------------------------------------------------------------+
+
+**3.2.1 Request**
+
++-------------+-------------+---------------+---------------+---------------+
+| Parameter | Qualifier | Cardinality | Content | Description |
++=============+=============+===============+===============+===============+
+| n/a | | | | |
++-------------+-------------+---------------+---------------+---------------+
+
+**3.2.2 Response**
+
++-------------+-------------+---------------+---------------+---------------+
+| Parameter | Qualifier | Cardinality | Content | Description |
++=============+=============+===============+===============+===============+
+| n/a | | | | |
++-------------+-------------+---------------+---------------+---------------+
+
+**3.2.3 Response Code**
+
++--------+-----------+-------------------+
+| Code | Meaning | Description |
++--------+-----------+-------------------+
+
++-----------+-----------------------+----------------------------------------------------------------------------------------------+
+| 204 | No Content | The VNF instance resource and the associated VNF identifier were deleted successfully. |
++===========+=======================+==============================================================================================+
+| 4xx/5xx | <name from RFC7231> | <description> |
++-----------+-----------------------+----------------------------------------------------------------------------------------------+
+
+**3.3 Instantiate VNF**
+-----------------------
+
++---------------------+-------------------------------------------------------------------------------------------+
+| If Definition | Description |
++=====================+===========================================================================================+
+| URI | http(s)://[hostname][:port]/api/vnflcm/v1/vnf_instances/{vnfInstanceId}/instantiate |
++---------------------+-------------------------------------------------------------------------------------------+
+| Operation | POST |
++---------------------+-------------------------------------------------------------------------------------------+
+| Direction | NFVO->VNFMLCM |
++---------------------+-------------------------------------------------------------------------------------------+
+
+3.3.1 **Request**
+
++--------------------+-----------+-------------+---------------------+---------------------------------------------------------------+
+| Parameter | Qualifier | Cardinality | Content | Description |
++====================+===========+=============+=====================+===============================================================+
+| flavourId | M | 1 | IdentifierInV nfd | Identifier of the VNF deployment flavour to be instantiated. |
++--------------------+-----------+-------------+---------------------+---------------------------------------------------------------+
+| instantiation | O | 0..1 | IdentifierInVnfd | Identifier of the instantiation |
+| LevelId | | | | level of the deployment |
+| | | | | flavour to be instantiated. If |
+| | | | | not present, the default |
+| | | | | instantiation level as |
+| | | | | declared in the VNFD is |
+| | | | | instantiated. |
+| | | | | |
+| | | | | Reserved |
++--------------------+-----------+-------------+---------------------+---------------------------------------------------------------+
+| extVirtualLinks | O | 0..N | ExtVirtualLin kData | Information about external VLs to connect the VNF to. |
++--------------------+-----------+-------------+---------------------+---------------------------------------------------------------+
+| extManagedVirtualL | O | 0..N | ExtManaged | Information about internal |
+| inks | | | VirtualLinkData | VLs that are managed by |
+| | | | | other entities than the VNFM. |
+| | | | | |
+| | | | | Reserved |
++--------------------+-----------+-------------+---------------------+---------------------------------------------------------------+
+| localization | O | 0..1 | String | Localization language of the VNF to be instantiated can be |
+| Language | | | | declared in the VNFD. The value shall comply with the format |
+| | | | | defined in IETF RFC 5646 [6]. |
+| | | | | |
+| | | | | Reserved |
++--------------------+-----------+-------------+---------------------+---------------------------------------------------------------+
+| additionalParams | O | 0..N | KeyValuePair | Additional input parameters for the instantiation process, |
+| | | | | specific to the VNF being instantiated. |
++--------------------+-----------+-------------+---------------------+---------------------------------------------------------------+
+
+**ExtVirtualLinkData:**
+
++------------------+-----------+-------------+-----------------+----------------------------------------------------------------------------------+
+| Attribute | Qualifier | Cardinality | Content | Description |
++==================+===========+=============+=================+==================================================================================+
+| vlInstanceId | O | 0..1 | Identifier | Identifier of the VL instance. |
++------------------+-----------+-------------+-----------------+----------------------------------------------------------------------------------+
+| vim | CM | 0..1 | VimInfo | Information about the VIM that manages this resource. |
+| | | | | This attribute shall be supported and present if VNF-related resource management |
+| | | | | in direct mode is applicable. |
++------------------+-----------+-------------+-----------------+----------------------------------------------------------------------------------+
+| resourceProvider | CM | 0..1 | Identifier | Identifies the entity responsible for the management of this resource. |
+| Id | | | | This attribute shall be present if |
+| | | | | VNF-related resource management in indirect mode is applicable. |
+| | | | | |
+| | | | | Reserved |
++------------------+-----------+-------------+-----------------+----------------------------------------------------------------------------------+
+| resourceId | M | 1 | IdentifierInVim | The identifier of the resource in the scope of the VIM or the resource provider. |
++------------------+-----------+-------------+-----------------+----------------------------------------------------------------------------------+
+| extCps | M | 1..N | VnfExtCpData | External CPs of the VNF to be connected to this external VL. |
++------------------+-----------+-------------+-----------------+----------------------------------------------------------------------------------+
+
+ **VimInfo:**
+
++-----------------+-----------+-------------+--------------+------------------------------------------------------------------------------------------------------------------------------------------+
+| Attribute | Qualifier | Cardinality | Content | Description |
++=================+===========+=============+==============+==========================================================================================================================================+
+| vimInfoId | M | 1 | Identifier | The identifier of this VimInfo instance, for the purpose of referencing it from other information elements. |
++-----------------+-----------+-------------+--------------+------------------------------------------------------------------------------------------------------------------------------------------+
+| vimId | M | 1 | Identifier | The identifier of the VIM. |
++-----------------+-----------+-------------+--------------+------------------------------------------------------------------------------------------------------------------------------------------+
+| interfaceInfo | M | 0..N | KeyValuePair | Information about the interface to the VIM, including VIM provider type, API version and protocol type. |
++-----------------+-----------+-------------+--------------+------------------------------------------------------------------------------------------------------------------------------------------+
+| accessInfo | M | 0..N | KeyValuePair | Authentication credentials for accessing the VIM. Examples may include those to support different authentication schemes, e.g., OAuth, |
+| | | | | Token etc. |
++-----------------+-----------+-------------+--------------+------------------------------------------------------------------------------------------------------------------------------------------+
+| interface | M | 1 | String | Information about the interface endpoint. An example is a URL. |
+| Endpoint | | | | Token etc. |
++-----------------+-----------+-------------+--------------+------------------------------------------------------------------------------------------------------------------------------------------+
+
+ **interfaceInfo:**
+
++------------------+---------------+--------------------------------------+
+| **Key Define** | **Content** | **Description** |
++==================+===============+======================================+
+| vimType | String | The type of the VIM. |
++------------------+---------------+--------------------------------------+
+| apiVersion | String | The version of the api of the VIM. |
++------------------+---------------+--------------------------------------+
+| protocolType | String | http https |
++------------------+---------------+--------------------------------------+
+
+ **accessInfo:**
+
++------------------+---------------+--------------------------+
+| **Key Define** | **Content** | **Description** |
++==================+===============+==========================+
+| tenant | String | Tenant Name of tenant |
++------------------+---------------+--------------------------+
+| username | String | Username for login |
++------------------+---------------+--------------------------+
+| password | String | Password of login user |
++------------------+---------------+--------------------------+
+
+ **VnfExtCpData:**
+
++------------------------+---------------------+-----------------------+--------------------+-----------------------------------------------------------+
+| **Attribute** | **Qualifier** | **Cardinality** | **Content** | **Description** |
++========================+=====================+=======================+====================+===========================================================+
+| cpdId | M | 1 | IdentifierInVnfd | The identifier of the CPD in the VNFD. |
++------------------------+---------------------+-----------------------+--------------------+-----------------------------------------------------------+
+| addresses | O | 0..N | NetworkAddress | List of (fixed) network addresses that |
+| | | | | need to be configured on the CP. This attribute shall |
+| | | | | be present if fixed addresses need to be configured. |
++------------------------+---------------------+-----------------------+--------------------+-----------------------------------------------------------+
+| numDynamicAddre sses | O | 0..1 | Integer | Number of network addresses to be assigned dynamically. |
+| | | | | This attribute shall be present if dynamic |
+| | | | | addresses need to be configured. |
+| | | | | Reserved |
++------------------------+---------------------+-----------------------+--------------------+-----------------------------------------------------------+
+
+ **NetworkAddress:**
+
++-----------------+---------------------+-----------------------+-------------------+---------------------------------------------------------------------------------------------------------------+
+| **Attribute** | **Qualifier** | **Cardinality** | **Content** | **Description** |
++=================+=====================+=======================+===================+===============================================================================================================+
+| addressType | M | 1 | Enum | Describes the type of the address to be assigned to the CP instantiated from the parent CPD. |
+| | | | | |
+| | | | | Permitted values: |
+| | | | | |
+| | | | | - MAC |
+| | | | | |
+| | | | | - IP |
++-----------------+---------------------+-----------------------+-------------------+---------------------------------------------------------------------------------------------------------------+
+| l2AddressData | CM | 0..1 | String | Provides the information on the MAC addresses to be assigned to the CP(s) instantiated from the parent CPD. |
+| | | | | |
+| | | | | Shall be present when the addressType is MAC address. |
++-----------------+---------------------+-----------------------+-------------------+---------------------------------------------------------------------------------------------------------------+
+| l3AddressData | CM | 0..1 | L3AddressData | Provides the information on the IP addresses to be assigned to the CP instantiated from the parent CPD. |
+| | | | | |
+| | | | | Shall be present when the addressType is IP address. |
++-----------------+---------------------+-----------------------+-------------------+---------------------------------------------------------------------------------------------------------------+
+
+ **L3AddressData:**
+
++-----------------+---------------------+-----------------------+-------------------+-----------------------+
+| **Attribute** | **Qualifier** | **Cardinality** | **Content** | **Description** |
++=================+=====================+=======================+===================+=======================+
+| iPAddressType | M | 1 | ENUM | IP address type. |
+| | | | | |
+| | | | | Permitted values: |
+| | | | | |
+| | | | | - IPv4 |
+| | | | | |
+| | | | | - IPv6 |
++-----------------+---------------------+-----------------------+-------------------+-----------------------+
+| iPAddress | M | 1 | String | IP address |
++-----------------+---------------------+-----------------------+-------------------+-----------------------+
+
+ {
+
+ "flavourId": "flavour\_1",
+ "instantiationLevelId":"instantiationLevel\_1",
+ "extVirtualLinks": [
+
+ { "vlInstanceId": "1",
+ "vim": {
+ "vimInfoId": "1",
+ "vimId": "1",
+ "interfaceInfo": {
+
+ "vimType": "vim",
+ "apiVersion": "v2",
+ "protocolType": "http"
+
+ },
+ "accessInfo": {
+
+ "tenant": "tenant\_vCPE",
+ "username": "vCPE",
+ "password": "vCPE\_321"
+
+ },
+ "interfaceEndpoint": "http://10.43.21.105:80/"
+
+ },
+ "resourceId": "1246",
+ "extCps": [
+
+ {
+ "cpdId": "11", "addresses": [
+
+ {
+ "addressType": "MAC",
+ "l2AddressData": "00:f3:43:20:a2:a3"
+
+ },
+ {
+
+ "addressType": "IP",
+ "l3AddressData": {
+
+ "iPAddressType": "IPv4",
+ "iPAddress": "192.168.104.2"
+
+ }
+
+ }
+
+ ],
+ "numDynamicAddresses": 0
+
+ },
+
+ ...
+
+ ]
+
+ }
+
+ ],
+
+ "localizationLanguage": "en\_US", "additionalParams": {...}
+
+ }
+
+
+**3.3.2 Response**
+
++-------------+-------------+---------------+------------------+---------------------------------------------------------+
+| Parameter | Qualifier | Cardinality | Content | Description |
++=============+=============+===============+==================+=========================================================+
+| vnfLcOpId | M | 1 | Identifier | Identifier of the VNF lifecycle operation occurrence. |
++-------------+-------------+---------------+------------------+---------------------------------------------------------+
+
+ {
+
+ "vnfLcOpId": "1"
+
+ }
+
+ **3.3.3 Response Code**
+
++-----------+-----------------------+------------------------------------------------------------------------------------------+
+| Code | Meaning | Description |
++===========+=======================+==========================================================================================+
+| 202 | Accepted | The request is accepted for processing, but the processing has not been completed. |
++-----------+-----------------------+------------------------------------------------------------------------------------------+
+| 4xx/5xx | <name from RFC7231> | <description> |
++-----------+-----------------------+------------------------------------------------------------------------------------------+
+
+**3.4 Terminate VNF**
+---------------------
+
++---------------------+-----------------------------------------------------------------------------------------+
+| If Definition | Description |
++=====================+=========================================================================================+
+| URI | http(s)://[hostname][:port]/api/vnflcm/v1/vnf\_instances/{vnfInstanceId}/term inate |
++---------------------+-----------------------------------------------------------------------------------------+
+| Operation | POST |
++---------------------+-----------------------------------------------------------------------------------------+
+| Direction | NFVO->VNFMLCM |
++---------------------+-----------------------------------------------------------------------------------------+
+
+**3.4.1 Request**
+
++-------------------+-------------+---------------+---------------+-------------------------------------------------------------------------+
+| Parameter | Qualifier | Cardinality | Content | Description |
++===================+=============+===============+===============+=========================================================================+
+| terminationType | M | 1 | Enum | Indicates whether forceful or graceful termination is requested. |
+| | | | | |
+| | | | | Permitted values: |
+| | | | | |
+| | | | | - FORCEFUL: The VNFM |
+| | | | | will shut down the VNF and release the resources immediately |
+| | | | | after accepting the request. |
+| | | | | - GRACEFUL: The VNFM |
+| | | | | |
+| | | | | will first arrange to take the VNF out of service after accepting |
+| | | | | the request. Once the operation is successful or once the timer |
+| | | | | value specified in the |
+| | | | | |
+| | | | | “gracefulTerminationTime out” attribute expires, the VNFM will shut |
+| | | | | down the VNF and release the resources. |
++-------------------+-------------+---------------+---------------+-------------------------------------------------------------------------+
+| graceful | O | 0..1 | Integer | This attribute is only |
+| Termination | | | | applicable in case of graceful |
+| Timeout | | | | termination. It defines the |
+| | | | | time to wait for the VNF to be |
+| | | | | taken out of service before |
+| | | | | shutting down the VNF and |
+| | | | | releasing the resources. |
+| | | | | The unit is seconds. |
+| | | | | If not given and the |
+| | | | | "terminationType" |
+| | | | | attribute is set to |
+| | | | | "GRACEFUL", it is expected |
+| | | | | that the VNFM waits for |
+| | | | | the successful taking out of |
+| | | | | service of the VNF, no |
+| | | | | matter how long it takes, |
+| | | | | before shutting down the |
+| | | | | VNF and releasing the |
+| | | | | resources. |
++-------------------+-------------+---------------+---------------+-------------------------------------------------------------------------+
+
+ {
+ "terminationType": "GRACEFUL",
+ "gracefulTerminationTimeout": 120
+
+ }
+
+**3.4.2 Response**
+
++-------------+-------------+---------------+------------------+---------------------------------------------------------+
+| Parameter | Qualifier | Cardinality | Content | Description |
++=============+=============+===============+==================+=========================================================+
+| vnfLcOpId | M | 1 | Identifier | Identifier of the VNF lifecycle operation occurrence. |
++-------------+-------------+---------------+------------------+---------------------------------------------------------+
+
+ {
+ "vnfLcOpId": "2"
+
+ }
+
+**3.4.3 Response Code**
+
++-----------+-----------------------+------------------------------------------------------------------------------------------+
+| Code | Meaning | Description |
++===========+=======================+==========================================================================================+
+| 202 | Accepted | The request is accepted for processing, but the processing has not been completed. |
++-----------+-----------------------+------------------------------------------------------------------------------------------+
+| 4xx/5xx | <name from RFC7231> | <description> |
++-----------+-----------------------+------------------------------------------------------------------------------------------+
+
+**3.5 Query multiple VNF**
+---------------------------
++---------------------+--------------------------------------------------------------+
+| If Definition | Description |
++=====================+==============================================================+
+| URI | http(s)://[hostname][:port]/api/vnflcm/v1/vnf\_instances |
++---------------------+--------------------------------------------------------------+
+| Operation | GET |
++---------------------+--------------------------------------------------------------+
+| Direction | NFVO->VNFMLCM |
++---------------------+--------------------------------------------------------------+
+
+**3.5.1 Request**
+
++-------------+-------------+---------------+---------------+---------------+
+| Parameter | Qualifier | Cardinality | Content | Description |
++=============+=============+===============+===============+===============+
+| n/a | | | | |
++-------------+-------------+---------------+---------------+---------------+
+
+**3.5.2 Response**
+
++--------------------+-------------+---------------+------------------------+--------------------------------------------------------------------------------------+
+| Parameter | Qualifier | Cardinality | Content | Description |
++====================+=============+===============+========================+======================================================================================+
+| vnfInstanceInfos | M | 0..N | VnfInstanceI nfo | Returned if information about zero or more VNF instances was queried successfully. |
++--------------------+-------------+---------------+------------------------+--------------------------------------------------------------------------------------+
++--------------------+-------------+---------------+------------------------+--------------------------------------------------------------------------------------+
+
+ **VnfInstanceInfo:**
+
++----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+
+| Attribute | Qualifier|Cardinality | Content | Description |
++==================================+==========+============+============================+=======================================================================================================================================================+
+| vnfInstanceId | M | 1 | Identifier | VNF instance identifier. |
++----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+
+| vnfInstanceName | M | 1 | String | VNF instance name. |
++----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+
+| vnfInstanceDescr iption | M | 1 | String | Human-readable description of the VNF instance. |
++----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+
+| onboardedVnfPk gInfoId | M | 1 | Identifier | Identifier of information held by the NFVO about the specific VNF Package on which the VNF is based. This identifier was allocated by the NFVO. |
++----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+
+| vnfdId | M | 1 | Identifier | Identifier of the VNFD on which the VNF instance is based. |
++----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+
+| vnfdVersion | M | 1 | Identifier | Identifies the version of the VNFD. The value is copied from the VNFD. |
++----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+
+| vnfSoftwareVersi on | M | 1 | String | Software version of the VNF. |
+| | | | | |
+| | | | | The value is copied from the VNFD. |
++----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+
+| vnfProvider | M | 1 | String | Name of the person or company providing the VNF. |
+| | | | | |
+| | | | | The value is copied from the VNFD. |
++----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+
+| vnfProductName | M | 1 | String | Name to identify the VNF Product. The value is copied from the VNFD. |
++----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+
+| vnfConfigurableP roperties | O | 0..N | KeyValuePair | Current values of the configurable properties of the VNF instance. |
+| | | | | |
+| | | | | Configurable properties as declared in the VNFD. |
++----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+
+| instantiationState | M | 1 | Enum | The instantiation state of the VNF. |
+| | | | | |
+| | | | | Permitted values: |
+| | | | | |
+| | | | | - NOT\_INSTANTIATED: The VNF |
+| | | | | |
+| | | | | instance is terminated or not instantiated. |
+| | | | | |
+| | | | | - INSTANTIATED: The VNF instance is instantiated. |
++----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+
+| instantiatedVnfInf o | CM | 0..1 | InstantiatedVnf Info | Information specific to an instantiated VNF instance. |
+| | | | | |
+| | | | | This attribute shall be present if the instantiateState attribute value is INSTANTIATED. |
++----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+
+| metadata | O | 0..N | KeyValuePair | Additional metadata describing the VNF instance. |
+| | | | | |
+| | | | | This attribute can be modified with the Modify VNF information operation. |
++----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+
+| extensions | O | 0..N | KeyValuePair | VNF-specific attributes. |
+| | | | | |
+| | | | | This attribute can be modified with the Modify VNF information operation. |
++----------------------------------+----------+------------+----------------------------+-------------------------------------------------------------------------------------------------------------------------------------------------------+
+
+ **InstantiatedVnfInfo:**
+
++------------------------------+-----------+------------+------------------------------+------------------------------------------------------------------------------------------------------------------------+
+| Attribute | Qualifier | Cardinality| Content | Description |
++==============================+===========+============+==============================+========================================================================================================================+
+| flavourId | M | 1 | IdentifierInVnfd | Identifier of the VNF deployment flavour to be instantiated. |
+| | | | | |
+| | | | | Reserved |
++------------------------------+-----------+------------+------------------------------+------------------------------------------------------------------------------------------------------------------------+
+| vnfState | M | 1 | ENUM | State of the VNF instance. |
+| | | | | |
+| | | | | Permitted values: |
+| | | | | |
+| | | | | - STARTED: The VNF instance is up and running. |
+| | | | | |
+| | | | | - STOPPED: The VNF instance has been shut down. |
++------------------------------+-----------+------------+------------------------------+------------------------------------------------------------------------------------------------------------------------+
+| scaleStatus | O | 0..N | ScaleInfo | Scale status of the VNF, one entry per aspect. Represents for every scaling aspect how "big" the VNF has been scaled |
+| | | | | |
+| | | | | w.r.t. that aspect. |
+| | | | | |
+| | | | | This attribute shall be present if the VNF supports scaling. |
++------------------------------+-----------+------------+------------------------------+------------------------------------------------------------------------------------------------------------------------+
+| extCpInfo | O | 0..N | CpInfo | Information about the external CPs exposed by the VNF instance. |
++------------------------------+-----------+------------+------------------------------+------------------------------------------------------------------------------------------------------------------------+
+| extVirtualLink | O | 0..N | ExtVirtualLinkI nfo | Information about the external VLs the VNF instance is connected to. |
++------------------------------+-----------+------------+------------------------------+------------------------------------------------------------------------------------------------------------------------+
+| extManagedVirtu alLink | O | 0..N | extManagedVir tualLinkInfo | Information about the externally-managed internal VLs of the VNF instance. |
+| | | | | |
+| | | | | Reserved |
++------------------------------+-----------+------------+------------------------------+------------------------------------------------------------------------------------------------------------------------+
+| monitoringParam eters | O | 0..N | MonitoringPar ameter | Active monitoring parameters. |
+| | | | | |
+| | | | | Reserved |
++------------------------------+-----------+------------+------------------------------+------------------------------------------------------------------------------------------------------------------------+
+| localizationLangu age | O | 0..1 | String | Localization language of the VNF to be instantiated. |
+| | | | | |
+| | | | | The value shall comply with the format defined in IETF RFC 5646 [6]. |
++------------------------------+-----------+------------+------------------------------+------------------------------------------------------------------------------------------------------------------------+
+| vimInfo | CM | 0..N | VimInfo | Information about VIM(s) managing resources for the VNF instance. |
+| | | | | |
+| | | | | This attribute shall be supported and present if VNF-related resource management in direct mode is applicable. |
++------------------------------+-----------+------------+------------------------------+------------------------------------------------------------------------------------------------------------------------+
+| vnfcResourceInfo | CM | 0..N | VnfcResourceI nfo | Information about the virtualised compute and storage resource(s) used by the VNFCs of the VNF instance. |
+| | | | | |
+| | | | | This attribute shall be supported and present if VNF-related resource management in direct mode is applicable. |
++------------------------------+-----------+------------+------------------------------+------------------------------------------------------------------------------------------------------------------------+
+| virtualLinkResourceInfo | CM | 0..N | VirtualLinkRes ourceInfo | Information about the virtualised network resource(s) used by the VLs of the VNF instance. |
+| | | | | |
+| | | | | This attribute shall be supported and present if VNF-related resource management in direct mode is applicable. |
++------------------------------+-----------+------------+------------------------------+------------------------------------------------------------------------------------------------------------------------+
+| virtualStorageResourceInfo | CM | 0..N | VirtualStorage ResourceInfo | Information about the virtualised storage resource(s) used as storage for the VNF instance. |
+| | | | | |
+| | | | | This attribute shall be supported and present if VNF-related resource management in direct mode is applicable. |
++------------------------------+-----------+------------+------------------------------+------------------------------------------------------------------------------------------------------------------------+
+
+**ScaleInfo:**
+
++------------------+-------------+--------------------+--------------------+-------------------------------------------------------------------------------------------------------------------------------------+
+| Attribute | Qualifier | Cardinalit y | Content | Description |
++==================+=============+====================+====================+=====================================================================================================================================+
+| aspectId | M | 1 | IdentifierInVnfd | Identifier of the scaling aspect. |
++------------------+-------------+--------------------+--------------------+-------------------------------------------------------------------------------------------------------------------------------------+
+| scaleLevel | M | 1 | Integer | Indicates the scale level. The minimum value shall be 0 and the maximum value shall be <= maxScaleLevel as described in the VNFD. |
++------------------+-------------+--------------------+--------------------+-------------------------------------------------------------------------------------------------------------------------------------+
++------------------+-------------+--------------------+--------------------+-------------------------------------------------------------------------------------------------------------------------------------+
+
+ **CpInfo:**
+
++--------------------+-------------+--------------------+--------------------+------------------------------------------------------------------+
+| Attribute | Qualifier | Cardinalit y | Content | Description |
++====================+=============+====================+====================+==================================================================+
+| cpInstanceId | M | 1 | Identifier | Identifier of the CP instance. |
++--------------------+-------------+--------------------+--------------------+------------------------------------------------------------------+
+| cpdId | M | 1 | IdentifierInVnfd | Identifier of the CPD, in the VNFD. |
++--------------------+-------------+--------------------+--------------------+------------------------------------------------------------------+
+| addresses | O | 0..N | NetworkAddre ss | List of network addresses that have been configured on the CP. |
++--------------------+-------------+--------------------+--------------------+------------------------------------------------------------------+
+
+ **ExtVirtualLinkInfo:**
+
++------------------------+-------------+--------------------+-------------------+-------------------------------------------------+
+| Attribute | Qualifier | Cardinalit y | Content | Description |
++========================+=============+====================+===================+=================================================+
+| extVirtualLinkId | M | 1 | Identifier | Identifier of the external VL. |
++------------------------+-------------+--------------------+-------------------+-------------------------------------------------+
+| resourceHandle | M | 1 | ResourceHand le | Identifier of the resource realizing this VL. |
++------------------------+-------------+--------------------+-------------------+-------------------------------------------------+
+| linkPorts | O | 0..N | VnfLinkPort | Link ports of this VL. |
++------------------------+-------------+--------------------+-------------------+-------------------------------------------------+
+
+ **ResourceHandle:**
+
++---------------------+------------+------------+-------------------+--------------------------------------------------------------------------------------------------------+
+| Attribute | Qualifier | Cardinality| Content | Description |
++=====================+============+============+===================+========================================================================================================+
+| vimId | CM | 0..1 | Identifier | Identifier of the VimInfo information element defining the VIM who manages the resource. |
+| | | | | |
+| | | | | This attribute shall be present if |
+| | | | | |
+| | | | | VNF-related resource management in direct mode is applicable. |
+| | | | | |
+| | | | | The value refers to a vimInfo item in the VnfInstance. |
++---------------------+------------+------------+-------------------+--------------------------------------------------------------------------------------------------------+
+| resourceProviderId | CM | 0..1 | Identifier | Identifier of the entity responsible for the management of the resource. |
+| | | | | |
+| | | | | This attribute shall be present when VNF-related resource management in indirect mode is applicable. |
+| | | | | |
+| | | | | Reserved |
++---------------------+------------+------------+-------------------+--------------------------------------------------------------------------------------------------------+
+| resourceId | M | 1 | IdentifierInVim | Identifier of the resource in the scope of the VIM or the resource provider. |
++---------------------+------------+------------+-------------------+--------------------------------------------------------------------------------------------------------+
+
+ **VnfLinkPort:**
+
++----------------------+-------------+--------------------+-------------------+------------------------------------------------------------------------------------------------+
+| Attribute | Qualifier | Cardinalit y | Content | Description |
++======================+=============+====================+===================+================================================================================================+
+| resourceHandle | M | 1 | ResourceHand le | Identifier of the virtualised network resource realizing this link port. |
++----------------------+-------------+--------------------+-------------------+------------------------------------------------------------------------------------------------+
+| cpInstanceId | M | 1 | IdentifierInVnf | External CP of the VNF to be connected to this link port. |
+| | | | | |
+| | | | | There shall be at most one link port associated with any external connection point instance. |
+| | | | | |
+| | | | | The value refers to an extCpInfo item in the VnfInstance. |
++----------------------+-------------+--------------------+-------------------+------------------------------------------------------------------------------------------------+
++----------------------+-------------+--------------------+-------------------+------------------------------------------------------------------------------------------------+
+
+ **VnfcResourceInfo:**
+
++-----------------------+------------+------------+--------------------+---------------------------------------------------------------------------------------------------------------------+
+| Attribute | Qualifier | Cardinality| Content | Description |
++=======================+============+============+====================+=====================================================================================================================+
+| vnfcInstanceId | M | 1 | IdentifierInVnf | Identifier of this VNFC instance. |
++-----------------------+------------+------------+--------------------+---------------------------------------------------------------------------------------------------------------------+
+| vduId | M | 1 | IdentifierInVnfd | Reference to the applicable Vdu information element in the VNFD. |
++-----------------------+------------+------------+--------------------+---------------------------------------------------------------------------------------------------------------------+
+| computeResourc e | M | 1 | ResourceHand le | Reference to the VirtualCompute resource. |
++-----------------------+------------+------------+--------------------+---------------------------------------------------------------------------------------------------------------------+
+| storageResourceI ds | M | 1..N | IdentifierInVnf | Reference(s) to the VirtualStorage resource(s). |
+| | | | | |
+| | | | | The value refers to a VirtualStorageResourceInfo item in the VnfInstance. |
++-----------------------+------------+------------+--------------------+---------------------------------------------------------------------------------------------------------------------+
+| reservationId | O | 0..1 | Identifier | The reservation identifier applicable to the resource. It shall be present when an applicable reservation exists. |
+| | | | | |
+| | | | | Reserved |
++-----------------------+------------+------------+--------------------+---------------------------------------------------------------------------------------------------------------------+
+
+ **VirtualStorageResourceInfo:**
+
++---------------------------------+-------------+--------------------+--------------------+---------------------------------------------------------------------------------------------------------------------+
+| Attribute | Qualifier | Cardinalit y | Content | Description |
++=================================+=============+====================+====================+=====================================================================================================================+
+| virtualStorageInst anceId | M | 1 | IdentifierInVnf | Identifier of this virtual storage resource instance. |
++---------------------------------+-------------+--------------------+--------------------+---------------------------------------------------------------------------------------------------------------------+
+| virtualStorageDe scId | M | 1 | IdentifierInVnfd | Identifier of the VirtualStorageDesc in the VNFD. |
++---------------------------------+-------------+--------------------+--------------------+---------------------------------------------------------------------------------------------------------------------+
+| storageResource | M | 1 | ResourceHand le | Reference to the VirtualStorage resource. |
++---------------------------------+-------------+--------------------+--------------------+---------------------------------------------------------------------------------------------------------------------+
+| reservationId | M | 0..1 | Identifier | The reservation identifier applicable to the resource. It shall be present when an applicable reservation exists. |
+| | | | | |
+| | | | | Reserved |
++---------------------------------+-------------+--------------------+--------------------+---------------------------------------------------------------------------------------------------------------------+
+
+ **VirtualLinkResourceInfo:**
+
++------------------------------+-----------+--------------+--------------------+---------------------------------------------------------------------------------------------------------------------+
+| Attribute | Qualifier | Cardinality | Content | Description |
++==============================+===========+==============+====================+=====================================================================================================================+
+| virtualLinkInstanceId | M | 1 | IdentifierInVnf | Identifier of this VL instance. |
++------------------------------+-----------+--------------+--------------------+---------------------------------------------------------------------------------------------------------------------+
+| virtualLinkDescId | M | 1 | IdentifierInVnfd | Identifier of the Virtual Link Descriptor (VLD) in the VNFD. |
++------------------------------+-----------+--------------+--------------------+---------------------------------------------------------------------------------------------------------------------+
+| networkResource | M | 1 | ResourceHand le | Reference to the VirtualNetwork resource. |
++------------------------------+-----------+--------------+--------------------+---------------------------------------------------------------------------------------------------------------------+
+| reservationId | M | 0..1 | Identifier | The reservation identifier applicable to the resource. It shall be present when an applicable reservation exists. |
+| | | | | |
+| | | | | Reserved |
++------------------------------+-----------+--------------+--------------------+---------------------------------------------------------------------------------------------------------------------+
+
+ [
+
+ {
+
+ "vnfInstanceId": "1",
+ "vnfInstanceName": "vFW\_01",
+ "vnfInstanceDescription": "vFW in Nanjing TIC Edge",
+ "onboardedVnfPkgInfoId": "1",
+ "vnfdId": "zte\_vFW\_51610",
+ "vnfdVersion": "V1.0",
+ "vnfSoftwareVersion": "V1.0",
+ "vnfProvider": "ZTE",
+ "vnfProductName": "vFW",
+ "vnfConfigurableProperties": {...},
+ "instantiationState": "INSTANTIATED",
+ "instantiatedVnfInfo": {
+
+ "flavourId": "1",
+ "vnfState": "STARTED",
+ "scaleStatus": [
+
+ {
+ "aspectId": "aspect1",
+ "scaleLevel": 1
+
+ }
+
+ ],
+
+ "extCpInfo": [
+
+ {
+ "cpInstanceId": "1",
+ "cpdId": "1", "addresses": [
+
+ {
+ "addressType": "MAC",
+ "l2AddressData": "00:f3:43:20:a2:a3"
+
+ },
+
+ {
+ "addressType": "IP",
+ "l3AddressData": {
+
+ "iPAddressType": "IPv4",
+ "address": "192.168.104.2"
+
+ }
+
+ }
+
+ ]
+
+ }
+
+ ],
+ "extVirtualLink": [
+
+ {
+ "extVirtualLinkId": "extvl1",
+ "resourceHandle": {
+
+ "vimId": "1",
+ "resourceId": "1111"
+
+ },
+
+ "linkPorts": [
+
+ {
+ "resourceHandle":
+
+ {
+ "vimId": "1",
+ "resourceId": "2121"
+
+ },
+
+ "cpInstanceId": "1"
+
+ }
+
+ ]
+
+ }
+
+ ],
+
+ "monitoringParameters": {...},
+ "localizationLanguage": "en\_US",
+ "vimInfo": [
+
+ {
+ "vimInfoId": "1",
+ "vimId": "1",
+ "interfaceInfo": {
+
+ "vimType": "vim",
+ "apiVersion": "v2",
+ "protocolType": "http"
+
+ },
+
+ "accessInfo": {
+
+ "tenant": "tenant\_vCPE",
+ "username": "vCPE",
+ "password": "vCPE\_321"
+
+ },
+
+ "interfaceEndpoint": "http://10.43.21.105:80/"
+
+ }
+
+ ],
+ "vnfcResourceInfo": [
+
+ {
+ "vnfcInstanceId": "vm1",
+ "vduId": "vdu1",
+ "computeResource": {
+
+ "vimId": "1",
+ "resourceId": "3333"
+
+ },
+
+ "storageResourceIds": [ "storage1"
+ ]
+
+ }
+
+ ],
+
+ "virtualLinkResourceInfo": [
+
+ {
+ "virtualLinkInstanceId": "vl01",
+ "virtualLinkDescId": "vl01",
+ "networkResource": {
+
+ "vimId": "1",
+ "resourceId": "4444"
+
+ }
+
+ }
+
+ ],
+ "virtualStorageResourceInfo": [
+
+ {
+ "virtualStorageInstanceId": "storage1",
+ "virtualStorageDescId":"storage1",
+ "storageResource": {
+
+ "vimId": "1",
+ "resourceId": "555"
+
+ }
+
+ }
+
+ ]
+
+ },
+ "metadata": {...},
+ "extensions": {...}
+
+ }
+
+]
+
+**3.5.3 Response Code**
+
++-----------+-----------------------+----------------------------------+
+| Code | Meaning | Description |
++===========+=======================+==================================+
+| 200 | Ok | The request has succeeded. |
++-----------+-----------------------+----------------------------------+
+| 4xx/5xx | <name from RFC7231> | <description> |
++-----------+-----------------------+----------------------------------+
+
+**3.6 Query single VNF**
+------------------------
++---------------------+------------------------------------------------------------------------------+
+| If Definition | Description |
++=====================+==============================================================================+
+| URI | http(s)://[hostname][:port]/api/vnflcm/v1/vnf_instances/{vnfInstanceId} |
++---------------------+------------------------------------------------------------------------------+
+| Operation | GET |
++---------------------+------------------------------------------------------------------------------+
+| Direction | NFVO->VNFMLCM |
++---------------------+------------------------------------------------------------------------------+
+
+**3.6.1 Request**
+
++-------------+-------------+---------------+---------------+---------------+
+| Parameter | Qualifier | Cardinality | Content | Description |
++=============+=============+===============+===============+===============+
+| n/a | | | | |
++-------------+-------------+---------------+---------------+---------------+
+
+**3.6.2 Response**
+
++-------------------+-------------+---------------+------------------------+---------------------------------------+
+| Parameter | Qualifier | Cardinality | Content | Description |
++===================+=============+===============+========================+=======================================+
+| vnfInstanceInfo | M | 1 | VnfInstanceI nfo | The information of the VNF instance |
++-------------------+-------------+---------------+------------------------+---------------------------------------+
++-------------------+-------------+---------------+------------------------+---------------------------------------+
+
+**3.6.3 Response Code**
+
++-----------+-----------------------+----------------------------------+
+| Code | Meaning | Description |
++===========+=======================+==================================+
+| 200 | Ok | The request has succeeded. |
++-----------+-----------------------+----------------------------------+
+| 4xx/5xx | <name from RFC7231> | <description> |
++-----------+-----------------------+----------------------------------+
+
+ {
+
+ "vnfInstanceId": "1",
+ "vnfInstanceName": "vFW\_01",
+ "vnfInstanceDescription": "vFW in Nanjing TIC Edge",
+ "onboardedVnfPkgInfoId": "1",
+ "vnfdId": "zte\_vFW\_51610",
+ "vnfdVersion": "V1.0",
+ "vnfSoftwareVersion": "V1.0",
+ "vnfProvider": "ZTE",
+ "vnfProductName": "vFW",
+ "vnfConfigurableProperties": {...},
+ "instantiationState": "INSTANTIATED",
+ "instantiatedVnfInfo": {
+ "flavourId": "1",
+ "vnfState": "STARTED",
+ "scaleStatus": [
+
+ {
+ "aspectId": "aspect1",
+ "scaleLevel": 1
+
+ }
+
+ ],
+
+ "extCpInfo": [
+
+ {
+ "cpInstanceId": "1",
+ "cpdId": "1", "addresses": [
+
+ {
+ "addressType": "MAC",
+ "l2AddressData": "00:f3:43:20:a2:a3"
+
+ },
+
+ {
+ "addressType": "IP",
+ "l3AddressData": {
+
+ "iPAddressType": "IPv4",
+ "address": "192.168.104.2"
+
+ }
+
+ }
+
+ ]
+
+ }
+
+ ],
+
+ "extVirtualLink": [
+
+ {
+ "extVirtualLinkId": "extvl1",
+ "resourceHandle": {
+
+ "vimId": "1",
+ "resourceId": "1111"
+
+ },
+
+ "linkPorts": [
+
+ {
+ "resourceHandle":
+
+ {
+ "vimId": "1",
+ "resourceId": "2121"
+
+ },
+ "cpInstanceId": "1"
+
+ }
+
+ ]
+
+ }
+
+ ],
+
+ "monitoringParameters": {...},
+ "localizationLanguage": "en\_US",
+ "vimInfo": [
+
+ {
+ "vimInfoId": "1",
+ "vimId": "1",
+ "interfaceInfo": {
+
+ "vimType": "vim",
+ "apiVersion": "v2",
+ "protocolType": "http"
+
+ },
+
+ "accessInfo": {
+
+ "tenant": "tenant\_vCPE",
+ "username": "vCPE",
+ "password": "vCPE\_321"
+
+ },
+ "interfaceEndpoint": "http://10.43.21.105:80/"
+
+ }
+
+ ],
+
+ "vnfcResourceInfo": [
+
+ {
+ "vnfcInstanceId": "vm1",
+ "vduId": "vdu1",
+ "computeResource": {
+
+ "vimId": "1",
+ "resourceId": "3333"
+
+ },
+
+ "storageResourceIds": [ "storage1"
+ ]
+
+ }
+
+ ],
+
+ "virtualLinkResourceInfo": [
+
+ {
+ "virtualLinkInstanceId": "vl01",
+ "virtualLinkDescId": "vl01",
+ "networkResource": {
+
+ "vimId": "1",
+ "resourceId": "4444"
+
+ }
+
+ }
+
+ ],
+
+ "virtualStorageResourceInfo": [
+
+ {
+ "virtualStorageInstanceId": "storage1",
+ "virtualStorageDescId": "storage1",
+ "storageResource": {
+
+ "vimId": "1",
+ "resourceId": "555"
+
+ }
+
+ }
+
+ ]
+
+ },
+ "metadata": {...},
+ "extensions": {...}
+
+ }
+
+**3.7 Get Operation Status**
+------------------------------
++---------------------+-------------------------------------------------------------------------------------------------+
+| If Definition | Description |
++=====================+=================================================================================================+
+| URI | http(s)://[hostname][:port]/api/vnflcm/v1/vnf\_lc\_ops/{vnfLcOpId}&response Id={responseId} |
++---------------------+-------------------------------------------------------------------------------------------------+
+| Operation | GET |
++---------------------+-------------------------------------------------------------------------------------------------+
+| Direction | NFVO->GVNFM |
++---------------------+-------------------------------------------------------------------------------------------------+
+
+**3.7.1 Request**
+
+ None
+
+**3.7.2 Response**
+
++--------------------+-------------+---------------+-----------+----------------------------------------------------------------------------------+
+| Parameter | Qualifier | Cardinality | Content | Description |
++====================+=============+===============+===========+==================================================================================+
+| vnfLcOpId | M | 1 | String | Identifier of a VNF lifecycle operation occurrence |
++--------------------+-------------+---------------+-----------+----------------------------------------------------------------------------------+
+| vnfInstanceId | M | 1 | String | Identifier of the VNF instance to which the operation applies |
++--------------------+-------------+---------------+-----------+----------------------------------------------------------------------------------+
+| lcmOperationType | M | 1 | ENUM | Type of the actual LCM operation represented by this lcm operation occurrence. |
+| | | | | |
+| | | | | Permitted values: |
+| | | | | |
+| | | | | - INSTANTIATE:the |
+| | | | | |
+| | | | | Instantiate VNF LCM operation. |
+| | | | | |
+| | | | | - SCALE: the Scale VNF LCM operation. |
+| | | | | |
+| | | | | - SCALE\_TO\_LEVEL: the |
+| | | | | |
+| | | | | Scale VNF to Level LCM operation. |
+| | | | | |
+| | | | | - CHANGE\_FLAVOUR: |
+| | | | | |
+| | | | | the Change VNF Flavour LCM operation. |
+| | | | | |
+| | | | | - TERMINATE: the |
+| | | | | |
+| | | | | Terminate VNF LCM operation. |
+| | | | | |
+| | | | | - HEAL: the Heal VNF LCM operation. |
+| | | | | |
+| | | | | - OPERATE: the Operate VNF LCM operation. |
+| | | | | |
+| | | | | - CHANGE\_EXT\_VLS: the |
+| | | | | |
+| | | | | Change VNF external VLs LCM operation. (Reserved) |
++--------------------+-------------+---------------+-----------+----------------------------------------------------------------------------------+
+| startTime | M | 1 | String | Date-time of the start of the operation. |
+| | | | | |
+| | | | | Representation: String formatted according to RFC 3339 [13] |
++--------------------+-------------+---------------+-----------+----------------------------------------------------------------------------------+
+| responseDescriptor | M | 1 | VnfLcOp | Including:responseId,progress,statusstatusDescription |
+| | | | Response | |
+| | | | Descriptor| ,errorCode,responseHistoryList |
++--------------------+-------------+---------------+-----------+----------------------------------------------------------------------------------+
+
+ **VnfLcOpResponseDescriptor:**
+
++---------------------------+-----------------+--------------------+---------------+-----------------------------------------------------------+
+| Attribute | Qualifier | Cardinalit y | Content | Description |
++===========================+=================+====================+===============+===========================================================+
+| responseId | M | 1 | Integer | Response Identifier |
++---------------------------+-----------------+--------------------+---------------+-----------------------------------------------------------+
+| progress | M | 1 | Integer | progress (1-100) |
++---------------------------+-----------------+--------------------+---------------+-----------------------------------------------------------+
+| lcmOperationStatus | M | 1 | ENUM | Status of a VNF lifecycle operation occurrence |
+| | | | | |
+| | | | | Permitted values: |
+| | | | | |
+| | | | | - STARTING: The operation is starting.. |
+| | | | | |
+| | | | | - PROCESSING: The operation is |
+| | | | | currently in execution. |
+| | | | | |
+| | | | | - COMPLETED: The operation has completed successfully. |
+| | | | | |
+| | | | | - FAILED: The operation has failed and it cannot be |
+| | | | | retried or rolled back, as it is determined |
+| | | | | that such action won't succeed. |
+| | | | | - FAILED\_TEMP: The operation has failed and execution |
+| | | | | has stopped, but the execution of the |
+| | | | | operation is not considered to be closed. |
+| | | | | |
+| | | | | (Reserved) |
+| | | | | |
+| | | | | - ROLLING\_BACK: The operation is currently being rolled |
+| | | | | back. (Reserved) |
+| | | | | |
+| | | | | - ROLLED\_BACK: The state of the VNF prior to the |
+| | | | | original operation invocation has been |
+| | | | | |
+| | | | | restored as closely as possible. (Reserved) |
++---------------------------+-----------------+--------------------+---------------+-----------------------------------------------------------+
+| statusDescripti on | O | 0..1 | String | Status Description of a VNF lifecycle operation |
+| | | | | occurrence |
++---------------------------+-----------------+--------------------+---------------+-----------------------------------------------------------+
+| errorCode | O | 0..1 | Integer | Errorcode |
++---------------------------+-----------------+--------------------+---------------+-----------------------------------------------------------+
+| responseHistor yList | O | 0..N | VnfLcOpDetail | History Response Messages from the requested |
+| | | | | responseId to lastest one. |
++---------------------------+-----------------+--------------------+---------------+-----------------------------------------------------------+
+
+ **VnfLcOpDetail:**
+
++---------------------------+-----------------+--------------------+---------------+-----------------------------------------------------------+
+| Attribute | Qualifier | Cardinalit y | Content | Description |
++===========================+=================+====================+===============+===========================================================+
+| responseId | M | 1 | Integer | Response Identifier |
++---------------------------+-----------------+--------------------+---------------+-----------------------------------------------------------+
+| progress | M | 1 | Integer | progress (1-100) |
++---------------------------+-----------------+--------------------+---------------+-----------------------------------------------------------+
+| lcmOperationS tatus | M | 1 | ENUM | Status of a VNF lifecycle operation occurrence |
+| | | | | |
+| | | | | Permitted values: |
+| | | | | |
+| | | | | - STARTING: The operation is starting.. |
+| | | | | |
+| | | | | - PROCESSING: The operation is currently in execution. |
+| | | | | |
+| | | | | - COMPLETED: The operation has completed successfully. |
+| | | | | |
+| | | | | - FAILED: The operation has failed and it |
+| | | | | cannot be retried or rolled back, as it is |
+| | | | | determined that such action won't succeed. |
+| | | | | |
+| | | | | |
+| | | | | - FAILED\_TEMP: The operation has failed and execution |
+| | | | | has stopped, but the execution of the operation |
+| | | | | is not considered to be closed. (Reserved) |
+| | | | | |
+| | | | | - ROLLING\_BACK: The operation is currently being |
+| | | | | rolled back. (Reserved) |
+| | | | | |
+| | | | | |
+| | | | | - ROLLED\_BACK: The state of the VNF prior to the |
+| | | | | original operation invocation has been restored |
+| | | | | as closely as possible. (Reserved) |
+| | | | | |
++---------------------------+-----------------+--------------------+---------------+-----------------------------------------------------------+
+| statusDescription | O | 0..1 | String | Status Description of a VNF lifecycle operation occurrence|
++---------------------------+-----------------+--------------------+---------------+-----------------------------------------------------------+
+| errorCode | O | 0..1 | Integer | Errorcode |
++---------------------------+-----------------+--------------------+---------------+-----------------------------------------------------------+
+
+ {
+
+ "vnfLcOpId": "1234566",
+
+ "vnfInstanceId": "1",
+ "lcmOperationType": "INSTANTIATE",
+
+ "startTime": "2017-01-01T12:00:27.87+00:20",
+
+ "responseDescriptor": {
+
+ "responseId": 3,
+ "progress": 40,
+ "lcmOperationStatus": "PROCESSING",
+ "statusDescription": "OMC VMs are decommissioned in VIM",
+ "errorCode": null,
+ "responseHistoryList": [
+
+ {
+ "responseId": 1,
+ "progress": 40,
+ "lcmOperationStatus": "PROCESSING",
+ "statusDescription": "OMC VMs are decommissioned in VIM",
+ "errorCode": null
+
+ },
+ {
+
+ "responseId": 2,
+ "progress": 41,
+ "lcmOperationStatus": "PROCESSING",
+ "statusDescription": "OMC VMs are decommissioned in VIM",
+ "errorCode": null
+
+ }
+
+ ]
+
+ }
+
+ }
+
+**3.7.3 Response Code**
+
++-----------+-----------------------+----------------------------------+
+| Code | Meaning | Description |
++===========+=======================+==================================+
+| 200 | Ok | The request has succeeded. |
++-----------+-----------------------+----------------------------------+
+| 4xx/5xx | <name from RFC7231> | <description> |
++-----------+-----------------------+----------------------------------+
+
+**4.Interfaces provided by VNF**\ (Ve-Vnfm-vnf)
+===============================================
+
+**4.1 Set Initial Configuration**
+---------------------------------
+
++---------------------+---------------------------------------------+
+| If Definition | Description |
++=====================+=============================================+
+| URI | http(s)://[hostname][:port]/configuration |
++---------------------+---------------------------------------------+
+| Operation | POST |
++---------------------+---------------------------------------------+
+| Direction | VNFM->VNF |
++---------------------+---------------------------------------------+
+
+ **4.1.1Request**
+
++-------------------------+-------------+---------------+--------------------------+------------------------------------------------------------------------------+
+| Parameter | Qualifier | Cardinality | Content | Description |
++=========================+=============+===============+==========================+==============================================================================+
+| vnfInstanceId | M | 1 | Identifier | Identifier of the VNF instance which the VNF to set initial configuration. |
++-------------------------+-------------+---------------+--------------------------+------------------------------------------------------------------------------+
+| vnfConfigurationData | O | 0..1 | VnfConfigur ation | Configuration data for the VNF instance. |
++-------------------------+-------------+---------------+--------------------------+------------------------------------------------------------------------------+
+| vnfcConfigurationData | O | 0..N | VnfcConfigu ration | Configuration data for VNFC instances. |
++-------------------------+-------------+---------------+--------------------------+------------------------------------------------------------------------------+
+
+**VnfConfiguration:**
+
++-----------------------+-----------------+--------------------+----------------------------------+------------------------------------------------------------------------------+
+| Attribute | Qualifier | Cardinalit y | Content | Description |
++=======================+=================+====================+==================================+==============================================================================+
+| cp | O | 0..N | CpConfiguratio n | External CPs |
++-----------------------+-----------------+--------------------+----------------------------------+------------------------------------------------------------------------------+
+| vnfSpecificData | O | 0..1 | VnfConfigurabl eProperties | Configuration object containing values of VNF configurable properties. |
++-----------------------+-----------------+--------------------+----------------------------------+------------------------------------------------------------------------------+
+
+**CpConfiguration:**
+
++-----------------+-------------+--------------------+--------------+-------------------------------------------------------------------------------------------------------+
+| Attribute | Qualifier | Cardinalit y | Content | Description |
++=================+=============+====================+==============+=======================================================================================================+
+| cpId | M | 1 | Identifier | Uniquely identifies a CP instance within the namespace of a specific VNF instance or VNFC instance. |
++-----------------+-------------+--------------------+--------------+-------------------------------------------------------------------------------------------------------+
+| cpdId | M | 1 | Identifier | Uniquely identifies a type of CP instance within the namespace of a VNFD. |
++-----------------+-------------+--------------------+--------------+-------------------------------------------------------------------------------------------------------+
+| cpAddress | M | 1..N | CpAddress | Address and Port assigned to the CP. |
++-----------------+-------------+--------------------+--------------+-------------------------------------------------------------------------------------------------------+
+
+ **CpAddress:**
+
++--------------------------+-------------+--------------------+-------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
+| Attribute | Qualifier | Cardinalit y | Content | Description |
++==========================+=============+====================+===================+===============================================================================================================================================+
+| address | M | 0..N | NetworkAddre ss | The address assigned to the CP instance (e.g. IP address, MAC address, etc.). It shall be provided for configuring a fixed address. |
++--------------------------+-------------+--------------------+-------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
+| useDynamicAddress | M | 0..1 | ENUM | It determines whether an address shall be assigned dynamically. It shall be provided if a dynamic address needs to be configured on the CP. |
+| | | | | |
+| | | | | A cardinality of "0" indicates that no dynamic address needs to be configured on the CP. |
+| | | | | |
+| | | | | Permitted values: |
+| | | | | |
+| | | | | - TRUE |
+| | | | | |
+| | | | | - FALSE |
++--------------------------+-------------+--------------------+-------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
+| port | M | 0..1 | Not specified | The port assigned to the CP instance (e.g. IP port number, Ethernet port number, etc.). |
+| | | | | |
+| | | | | Reserved |
++--------------------------+-------------+--------------------+-------------------+-----------------------------------------------------------------------------------------------------------------------------------------------+
+
+ **VnfConfigurableProperties:**
+
++--------------------+-----------+--------------+--------+-----------------------------------------------------------------------------------------------+
+| Attribute | Qualifier | Cardinality | Content| Description |
++====================+===========+==============+========+===============================================================================================+
+| autoScalable | O | 0..1 | ENUM | It permits to enable (TRUE) / disable (FALSE) the auto-scaling functionality. |
+| | | | | |
+| | | | | A cardinality of "0" indicates that configuring this present VNF property is not supported. |
+| | | | | |
+| | | | | Permitted values: |
+| | | | | |
+| | | | | - TRUE |
+| | | | | |
+| | | | | - FALSE |
++--------------------+-----------+--------------+--------+-----------------------------------------------------------------------------------------------+
+| autoHealable | O | 0..1 | ENUM | It permits to enable (TRUE) / disable (FALSE) the auto-healing functionality. |
+| | | | | |
+| | | | | A cardinality of "0" indicates that configuring this present VNF property is not supported. |
+| | | | | |
+| | | | | Permitted values: |
+| | | | | |
+| | | | | - TRUE |
+| | | | | |
+| | | | | - FALSE |
++--------------------+-----------+--------------+--------+-----------------------------------------------------------------------------------------------+
+
+**VnfcConfiguration:**
+
++------------------------+-------------+--------------------+--------------------+----------------------------------------------------------------------------------------+
+| Attribute | Qualifier | Cardinalit y | Content | Description |
++========================+=============+====================+====================+========================================================================================+
+| vnfcId | M | 1 | Identifier | Uniquely identifies a VNFC instance within the namespace of a specific VNF instance. |
++------------------------+-------------+--------------------+--------------------+----------------------------------------------------------------------------------------+
+| cp | O | 0..N | CpConfiguratio n | Internal CPs. |
++------------------------+-------------+--------------------+--------------------+----------------------------------------------------------------------------------------+
+| vnfcSpecificData | O | 0..1 | KeyValuePair | Configuration object containing values of VNFC configurable properties |
++------------------------+-------------+--------------------+--------------------+----------------------------------------------------------------------------------------+
+
+ {
+
+ "vnfInstanceId": "1",
+ "vnfConfigurationData": {
+
+ "cp": [
+
+ {
+ "cpId": "cp-1",
+ "cpdId": "cpd-a",
+ "cpAddress": [
+
+ {
+ "addresses": [
+
+ {
+ "addressType": "MAC",
+ "l2AddressData": "00:f3:43:20:a2:a3"
+
+ },
+ {
+
+ "addressType": "IP",
+ "l3AddressData": {
+
+ "iPAddressType": "IPv4",
+ "iPAddress": "192.168.104.2"
+
+ }
+
+ }
+
+ ],
+
+ "useDynamicAddress": "FALSE"
+
+ }
+
+ ]
+
+ }
+
+ ],
+
+ "vnfSpecificData": {
+
+ "autoScalable": "FALSE",
+ "autoHealable": "FALSE"
+
+ }
+
+ },
+
+ "vnfcConfigurationData":
+ {
+ "vnfcId": "vnfc-1",
+ "cp": [
+
+ {
+ "cpId": "cp-11",
+ "cpdId": "cpd-1a",
+ "cpAddress": [
+
+ {
+ "addresses": [
+
+ {
+ "addressType": "MAC",
+ "l2AddressData": "00:f3:43:21:a2:a3"
+
+ },
+ {
+
+ "addressType": "IP",
+ "l3AddressData": {
+
+ "iPAddressType": "IPv4",
+ "iPAddress": "192.168.105.2"
+
+ }
+
+ }
+
+ ],
+ "useDynamicAddress": "FALSE"
+
+ }
+
+ ]
+
+ }
+
+ ],
+
+ "vnfcSpecificData": {}
+
+ }
+
+ }
+
+
+ **4.1.2 Response**
+
++-----------------------+-------------+---------------+-------------------+---------------------------------+
+| Parameter | Qualifier | Cardinality | Content | Description |
++=======================+=============+===============+===================+=================================+
+| vnfConfigurationData | O | 0..1 | VnfConfiguration | Correspond to the |
+| | | | | vnfConfigurationData in the |
+| | | | | input information elements of |
+| | | | | the SetInitialConfiguration |
+| | | | | operation if it has. |
++-----------------------+-------------+---------------+-------------------+---------------------------------+
+| vnfcConfigurationDa | O | 0..N | VnfConfiguration | Correspond to the |
+| ta | | | | vnfcConfigurationData in the |
+| | | | | input information elements of |
+| | | | | the SetInitialConfiguration |
+| | | | | operation if it has. |
++-----------------------+-------------+---------------+-------------------+---------------------------------+
+
+ {
+ "vnfConfigurationData": {
+
+ "cp": [
+
+ {
+ "cpId": "cp-1",
+ "cpdId": "cpd-a", "cpAddress": [
+
+ {
+ "addresses": [
+
+ {
+ "addressType": "MAC",
+ "l2AddressData": "00:f3:43:20:a2:a3"
+
+ },
+ {
+
+ "addressType": "IP",
+ "l3AddressData": {
+
+ "iPAddressType": "IPv4",
+ "iPAddress": "192.168.104.2"
+
+ }
+
+ }
+
+ ],
+
+ "useDynamicAddress": "FALSE"
+
+ }
+
+ ]
+
+ }
+
+ ],
+ "vnfSpecificData": {
+
+ "autoScalable": "FALSE",
+ "autoHealable": "FALSE",
+ …
+
+ }
+
+ },
+
+ "vnfcConfigurationData": {
+
+ "vnfcId": "vnfc-1",
+ "cp": [
+
+ {
+ "cpId": "cp-11",
+ "cpdId": "cpd-1a",
+ "cpAddress": [
+
+ {
+ "addresses": [
+
+ {
+
+ "addressType": "MAC",
+ "l2AddressData": "00:f3:43:21:a2:a3"
+
+ },
+ {
+
+ "addressType": "IP",
+ "l3AddressData": {
+
+ "iPAddressType": "IPv4",
+ "iPAddress": "192.168.105.2"
+
+ }
+
+ }
+
+ ],
+
+ "useDynamicAddress": "FALSE"
+
+ }
+
+ ]
+
+ }
+
+ ],
+
+ "vnfcSpecificData": {…}
+
+ }
+
+ }
+
+ **4.1.3Response Code**
+
++-----------+-----------------------+-----------------------------------------------------------+
+| Code | Meaning | Description |
++===========+=======================+===========================================================+
+| 201 | Created | A VNF Instance identifier was created successfully. |
++-----------+-----------------------+-----------------------------------------------------------+
+| 4xx/5xx | <name from RFC7231> | <description> |
++-----------+-----------------------+-----------------------------------------------------------+
+
+.. |image0| image:: VNFM_API.png
+ :width: 5.07047in
+ :height: 5.6320in