vnfr - User documentation

Schema Globals

Global Schema Type
rw_ypbc_Vnfr_Vnfr_t_schema
Global Schema Pointer
rw_ypbc_Vnfr_Vnfr_g_schema

vnfr data

vnfr:vnfr-catalog

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog
XPath Keyed Path
/vnfr:vnfr-catalog
RW.REST URI Path
/vnfr:vnfr-catalog

Fields
NameTypeDescription
vnfrLISTVirtual Network Function Record (VNFR).

JSON Sample

XML Sample

vnfr:vnfr

Virtual Network Function Record (VNFR).

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING

Fields
NameTypeDescription
idSTRINGIdentifier for the VNFR.
nsr-id-refSTRINGNS instance identifier. This is a leafref /nsr:ns-instance-config/nsr:nsr/nsr:id
member-vnf-index-refLEAFREFReference to member VNF index in Network service.
dashboard-urlSTRINGDashboard URL
nameSTRINGVNFR name.
short-nameSTRINGVNFR short name.
vendorSTRINGVendor of the VNFR.
descriptionSTRINGDescription of the VNFR.
versionSTRINGVersion of the VNFR
create-timeUINT32Creation timestamp of this Virtual Network Function. The timestamp is expressed as seconds since unix epoch - 1970-01-01T00:00:00Z
uptimeUINT32Active period of this Virtual Network Function. Uptime is expressed in seconds
vnfdCONTAINERVNF descriptor used to instantiate this VNF
vnf-configurationCONTAINERInformation about the VNF configuration. Note: If the NS contains multiple instances of the same VNF, each instance could have a different configuration.
mgmt-interfaceCONTAINER
internal-vlrLIST
connection-pointLISTList for external connection points. Each VNF has one or more external connection points. As the name implies that external connection points are used for connecting the VNF to other VNFs or to external networks. Each VNF exposes these connection points to the orchestrator. The orchestrator can construct network services by connecting the connection points between different VNFs. The NFVO will use VLDs and VNFFGs at the network service level to construct network services.
vdurLISTList of Virtual Deployment Units
http-endpointLISTList of http endpoints to be used by monitoring params
monitoring-paramLISTList of monitoring parameters at the network service level
operational-statusENUMThe operational status of the VNFR instance init : The VNF has just started. vl-init-phase : The internal VLs in the VNF are being instantiated. vm-init-phase : The VMs for VDUs in the VNF are being instantiated. running : The VNF is in running state. terminate : The VNF is being terminated. vm-terminate-phase : The VMs in the VNF are being terminated. vl-terminate-phase : The internal VLs in the VNF are being terminated. terminated : The VNF is in the terminated state. failed : The VNF instantiation failed
config-statusENUMThe configuration status of the NS instance configuring: At least one of the VNFs in this instance is in configuring state configured: All the VNFs in this NS instance are configured or config-not-needed state
placement-groups-infoLIST Placement groups to which this VDU belongs and its cloud construct

JSON Sample

XML Sample

vnfr:vnfd

VNF descriptor used to instantiate this VNF

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd

Fields
NameTypeDescription
idSTRINGIdentifier for the VNFD.
nameSTRINGVNFD name.
short-nameSTRINGShort name to appear as label in the UI
vendorSTRINGVendor of the VNFD.
logoSTRINGVendor logo for the Virtual Network Function
descriptionSTRINGDescription of the VNFD.
versionSTRINGVersion of the VNFD
vnf-configurationCONTAINERInformation about the VNF configuration. Note: If the NS contains multiple instances of the same VNF, each instance could have a different configuration.
mgmt-interfaceCONTAINERInterface over which the VNF is managed.
internal-vldLISTList of Internal Virtual Link Descriptors (VLD). The internal VLD describes the basic topology of the connectivity such as E-LAN, E-Line, E-Tree. between internal VNF components of the system.
ip-profilesLISTList of IP Profiles. IP Profile describes the IP characteristics for the Virtual-Link
connection-pointLISTList for external connection points. Each VNF has one or more external connection points that connect the VNF to other VNFs or to external networks. Each VNF exposes connection points to the orchestrator, which can construct network services by connecting the connection points between different VNFs. The NFVO will use VLDs and VNFFGs at the network service level to construct network services.
vduLISTList of Virtual Deployment Units
vdu-dependencyLISTList of VDU dependencies.
service-function-chainENUMType of node in Service Function Chaining Architecture
service-function-typeSTRINGType of Service Function. NOTE: This needs to map with Service Function Type in ODL to support VNFFG. Service Function Type is mandatory param in ODL SFC. This is temporarily set to string for ease of use
http-endpointLISTList of http endpoints to be used by monitoring params
monitoring-paramLISTList of monitoring parameters at the network service level
placement-groupsLISTList of placement groups at VNF level

JSON Sample

XML Sample

vnfr:vnf-configuration

Information about the VNF configuration. Note: If the NS contains multiple instances of the same VNF, each instance could have a different configuration.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vnf-configuration
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vnf-configuration
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vnf-configuration

Fields
NameTypeDescription
netconfCONTAINER
restCONTAINER
scriptCONTAINER
jujuCONTAINER
config-accessCONTAINER
config-attributesCONTAINERMiscellaneous input parameters to be considered while processing the NSD to apply configuration
service-primitiveLISTList of service primitives supported by the configuration agent for this VNF.
initial-config-primitiveLISTInitial set of configuration primitives.
config-templateSTRINGConfiguration template for each VNF

JSON Sample

XML Sample

vnfr:netconf

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vnf-configuration/vnfr:netconf
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vnf-configuration/vnfr:netconf
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vnf-configuration/netconf

Fields
NameTypeDescription
targetENUMNetconf configuration target
protocolENUMProtocol to use for NETCONF, such as ssh
portUINT16Port for the NETCONF server.

JSON Sample

XML Sample

vnfr:rest

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vnf-configuration/vnfr:rest
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vnf-configuration/vnfr:rest
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vnf-configuration/rest

Fields
NameTypeDescription
portUINT16Port for the REST server.

JSON Sample

XML Sample

vnfr:script

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vnf-configuration/vnfr:script
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vnf-configuration/vnfr:script
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vnf-configuration/script

Fields
NameTypeDescription
script-typeENUMScript type - currently supported : bash, expect

JSON Sample

XML Sample

vnfr:juju

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vnf-configuration/vnfr:juju
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vnf-configuration/vnfr:juju
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vnf-configuration/juju

Fields
NameTypeDescription
charmSTRINGJuju charm to use with the VNF.

JSON Sample

XML Sample

vnfr:config-access

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vnf-configuration/vnfr:config-access
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vnf-configuration/vnfr:config-access
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vnf-configuration/config-access

Fields
NameTypeDescription
mgmt-ip-addressUNIONIP address to be used to configure this VNF, optional if it is possible to resolve dynamically.
usernameSTRINGUser name for configuration.
passwordSTRINGPassword for configuration access authentication.

JSON Sample

XML Sample

vnfr:config-attributes

Miscellaneous input parameters to be considered while processing the NSD to apply configuration

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vnf-configuration/vnfr:config-attributes
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vnf-configuration/vnfr:config-attributes
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vnf-configuration/config-attributes

Fields
NameTypeDescription
config-priorityUINT64Configuration priority - order of configuration to be applied to each VNF in this NS. A low number takes precedence over a high number
config-delayUINT64Wait (seconds) before applying the configuration to VNF

JSON Sample

XML Sample

vnfr:service-primitive

List of service primitives supported by the configuration agent for this VNF.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vnf-configuration/vnfr:service-primitive
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vnf-configuration/vnfr:service-primitive[vnfr:name='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vnf-configuration/service-primitive/STRING

Fields
NameTypeDescription
nameSTRINGName of the service primitive.
parameterLISTList of parameters to the service primitive.

JSON Sample

XML Sample

vnfr:parameter

List of parameters to the service primitive.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vnf-configuration/vnfr:service-primitive/vnfr:parameter
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vnf-configuration/vnfr:service-primitive[vnfr:name='STRING']/vnfr:parameter[vnfr:name='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vnf-configuration/service-primitive/STRING/parameter/STRING

Fields
NameTypeDescription
nameSTRINGName of the parameter.
data-typeENUMData type associated with the name.
mandatoryBOOLEANIs this field mandatory
default-valueSTRINGThe default value for this field
parameter-poolSTRINGNSD parameter pool name to use for this parameter
read-onlyBOOLEANThe value should be dimmed by the UI. Only applies to parameters with default values.
hiddenBOOLEANThe value should be hidden by the UI. Only applies to parameters with default values.

JSON Sample

XML Sample

vnfr:initial-config-primitive

Initial set of configuration primitives.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vnf-configuration/vnfr:initial-config-primitive
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vnf-configuration/vnfr:initial-config-primitive[vnfr:seq='0']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vnf-configuration/initial-config-primitive/0

Fields
NameTypeDescription
seqUINT64Sequence number for the configuration primitive.
nameSTRINGName of the configuration primitive.
user-defined-scriptSTRINGA user defined script.
parameterLIST

JSON Sample

XML Sample

vnfr:parameter

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vnf-configuration/vnfr:initial-config-primitive/vnfr:parameter
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vnf-configuration/vnfr:initial-config-primitive[vnfr:seq='0']/vnfr:parameter[vnfr:name='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vnf-configuration/initial-config-primitive/0/parameter/STRING

Fields
NameTypeDescription
nameSTRING
valueSTRINGValue of the configuration primitive.

JSON Sample

XML Sample

vnfr:mgmt-interface

Interface over which the VNF is managed.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:mgmt-interface
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:mgmt-interface
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/mgmt-interface

Fields
NameTypeDescription
ip-addressUNION
vdu-idLEAFREF
cpLEAFREF
portUINT16Port for the management interface.
dashboard-paramsCONTAINERParameters for the VNF dashboard

JSON Sample

XML Sample

vnfr:dashboard-params

Parameters for the VNF dashboard

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:mgmt-interface/vnfr:dashboard-params
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:mgmt-interface/vnfr:dashboard-params
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/mgmt-interface/dashboard-params

Fields
NameTypeDescription
pathSTRINGThe HTTP path for the dashboard
httpsBOOLEANPick HTTPS instead of HTTP , Default is false
portUINT16The HTTP port for the dashboard

JSON Sample

XML Sample

vnfr:internal-vld

List of Internal Virtual Link Descriptors (VLD). The internal VLD describes the basic topology of the connectivity such as E-LAN, E-Line, E-Tree. between internal VNF components of the system.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:internal-vld
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:internal-vld[vnfr:id='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/internal-vld/STRING

Fields
NameTypeDescription
idSTRINGIdentifier for the VLD
nameSTRINGName of the internal VLD
short-nameSTRINGShort name to appear as label in the UI
descriptionSTRINGDescription of internal VLD.
typeENUM
root-bandwidthUINT64For ELAN this is the aggregate bandwidth.
leaf-bandwidthUINT64For ELAN this is the bandwidth of branches.
internal-connection-pointLISTList of internal connection points in this VLD
provider-networkCONTAINERContainer for the provider network.
vim-network-nameSTRINGName of network in VIM account. This is used to indicate pre-provisioned network name in cloud account.
ip-profile-refSTRINGNamed reference to IP-profile object

JSON Sample

XML Sample

vnfr:internal-connection-point

List of internal connection points in this VLD

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:internal-vld/vnfr:internal-connection-point
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:internal-vld[vnfr:id='STRING']/vnfr:internal-connection-point[vnfr:id-ref='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/internal-vld/STRING/internal-connection-point/STRING

Fields
NameTypeDescription
id-refLEAFREFreference to the internal connection point id

JSON Sample

XML Sample

vnfr:provider-network

Container for the provider network.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:internal-vld/vnfr:provider-network
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:internal-vld[vnfr:id='STRING']/vnfr:provider-network
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/internal-vld/STRING/provider-network

Fields
NameTypeDescription
physical-networkSTRINGName of the physical network on which the provider network is built.
overlay-typeENUMType of the overlay network. LOCAL - Provider network implemented in a single compute node FLAT - Provider network shared by all tenants VLAN - Provider network implemented using 802.1Q tagging VXLAN - Provider networks implemented using RFC 7348 GRE - Provider networks implemented using GRE tunnels
segmentation_idUINT32ID of segregated virtual networks

JSON Sample

XML Sample

vnfr:ip-profiles

List of IP Profiles. IP Profile describes the IP characteristics for the Virtual-Link

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:ip-profiles
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:ip-profiles[vnfr:name='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/ip-profiles/STRING

Fields
NameTypeDescription
nameSTRINGName of the IP-Profile
descriptionSTRINGDescription for IP profile
ip-profile-paramsCONTAINER

JSON Sample

XML Sample

vnfr:ip-profile-params

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:ip-profiles/vnfr:ip-profile-params
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:ip-profiles[vnfr:name='STRING']/vnfr:ip-profile-params
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/ip-profiles/STRING/ip-profile-params

Fields
NameTypeDescription
ip-versionENUM
subnet-addressUNIONSubnet IP prefix associated with IP Profile
gateway-addressUNIONIP Address of the default gateway associated with IP Profile
security-groupSTRINGName of the security group
dns-serverLIST
dhcp-paramsCONTAINER
subnet-prefix-poolSTRINGVIM Specific reference to pre-created subnet prefix

JSON Sample

XML Sample

vnfr:dns-server

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:ip-profiles/vnfr:ip-profile-params/vnfr:dns-server
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:ip-profiles[vnfr:name='STRING']/vnfr:ip-profile-params/vnfr:dns-server[vnfr:address='UNION_VALUE']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/ip-profiles/STRING/ip-profile-params/dns-server/UNION_VALUE

Fields
NameTypeDescription
addressUNIONList of DNS Servers associated with IP Profile

JSON Sample

XML Sample

vnfr:dhcp-params

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:ip-profiles/vnfr:ip-profile-params/vnfr:dhcp-params
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:ip-profiles[vnfr:name='STRING']/vnfr:ip-profile-params/vnfr:dhcp-params
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/ip-profiles/STRING/ip-profile-params/dhcp-params

Fields
NameTypeDescription
enabledBOOLEANThis flag indicates if DHCP is enabled or not
start-addressUNIONStart IP address of the IP-Address range associated with DHCP domain
countUINT32Size of the DHCP pool associated with DHCP domain

JSON Sample

XML Sample

vnfr:connection-point

List for external connection points. Each VNF has one or more external connection points that connect the VNF to other VNFs or to external networks. Each VNF exposes connection points to the orchestrator, which can construct network services by connecting the connection points between different VNFs. The NFVO will use VLDs and VNFFGs at the network service level to construct network services.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:connection-point
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:connection-point[vnfr:name='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/connection-point/STRING

Fields
NameTypeDescription
nameSTRINGName of the connection point
idSTRINGIdentifier for the internal connection points
short-nameSTRINGShort name to appear as label in the UI
typeENUMType of the connection point.
port-security-enabledBOOLEANEnables the port security for the port

JSON Sample

XML Sample

vnfr:vdu

List of Virtual Deployment Units

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu[vnfr:id='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu/STRING

Fields
NameTypeDescription
idSTRINGUnique id for the VDU
nameSTRINGUnique name for the VDU
descriptionSTRINGDescription of the VDU.
countUINT64Number of instances of VDU
mgmt-vpciSTRINGSpecifies the virtual PCI address. Expressed in the following format dddd:dd:dd.d. For example 0000:00:12.0. This information can be used to pass as metadata during the VM creation.
vm-flavorCONTAINER
guest-epaCONTAINER
vswitch-epaCONTAINER
hypervisor-epaCONTAINER
host-epaCONTAINERSpecifies the host level EPA attributes.
alarmLIST
imageSTRINGImage name for the software image. If the image name is found within the VNF package it will be uploaded to all VIM accounts during onboarding process. Otherwise, the image must be added to the VIM account with the same name as entered here.
image-checksumSTRINGImage md5sum for the software image. The md5sum, if provided, along with the image name uniquely identifies an image uploaded to the CAL.
cloud-initSTRINGContents of cloud-init script, provided inline, in cloud-config format
cloud-init-fileSTRINGName of file with contents of cloud-init script in cloud-config format
supplemental-boot-dataCONTAINER
internal-connection-pointLISTList for internal connection points. Each VNFC has zero or more internal connection points. Internal connection points are used for connecting the VNF with components internal to the VNF. If a VNF has only one VNFC, it may not have any internal connection points.
internal-interfaceLISTList of internal interfaces for the VNF
external-interfaceLISTList of external interfaces for the VNF. The external interfaces enable sending traffic to and from VNF.
volumesLIST

JSON Sample

XML Sample

vnfr:vm-flavor

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu/vnfr:vm-flavor
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu[vnfr:id='STRING']/vnfr:vm-flavor
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu/STRING/vm-flavor

Fields
NameTypeDescription
vcpu-countUINT16Number of VCPUs for the VM.
memory-mbUINT64Amount of memory in MB.
storage-gbUINT64Amount of disk space in GB.

JSON Sample

XML Sample

vnfr:guest-epa

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu/vnfr:guest-epa
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu[vnfr:id='STRING']/vnfr:guest-epa
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu/STRING/guest-epa

Fields
NameTypeDescription
trusted-executionBOOLEANThis VM should be allocated from trusted pool
mempage-sizeENUMMemory page allocation size. If a VM requires hugepages, it should choose LARGE or SIZE_2MB or SIZE_1GB. If the VM prefers hugepages it should choose PREFER_LARGE. LARGE : Require hugepages (either 2MB or 1GB) SMALL : Doesn't require hugepages SIZE_2MB : Requires 2MB hugepages SIZE_1GB : Requires 1GB hugepages PREFER_LARGE : Application prefers hugepages
cpu-pinning-policyENUMCPU pinning policy describes association between virtual CPUs in guest and the physical CPUs in the host. DEDICATED : Virtual CPUs are pinned to physical CPUs SHARED : Multiple VMs may share the same physical CPUs. ANY : Any policy is acceptable for the VM
cpu-thread-pinning-policyENUMCPU thread pinning policy describes how to place the guest CPUs when the host supports hyper threads: AVOID : Avoids placing a guest on a host with threads. SEPARATE: Places vCPUs on separate cores, and avoids placing two vCPUs on two threads of same core. ISOLATE : Places each vCPU on a different core, and places no vCPUs from a different guest on the same core. PREFER : Attempts to place vCPUs on threads of the same core.
pcie-deviceLISTList of pcie passthrough devices.
numa-unawareEMPTY
numa-node-policyCONTAINERThis policy defines NUMA topology of the guest. Specifically identifies if the guest should be run on a host with one NUMA node or multiple NUMA nodes. As an example a guest might need 8 VCPUs and 4 GB of memory. However, it might need the VCPUs and memory distributed across multiple NUMA nodes. In this scenario, NUMA node 1 could run with 6 VCPUs and 3GB, and NUMA node 2 could run with 2 VCPUs and 1GB.

JSON Sample

XML Sample

vnfr:pcie-device

List of pcie passthrough devices.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu/vnfr:guest-epa/vnfr:pcie-device
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu[vnfr:id='STRING']/vnfr:guest-epa/vnfr:pcie-device[vnfr:device-id='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu/STRING/guest-epa/pcie-device/STRING

Fields
NameTypeDescription
device-idSTRINGDevice identifier.
countUINT64Number of devices to attach to the VM.

JSON Sample

XML Sample

vnfr:numa-node-policy

This policy defines NUMA topology of the guest. Specifically identifies if the guest should be run on a host with one NUMA node or multiple NUMA nodes. As an example a guest might need 8 VCPUs and 4 GB of memory. However, it might need the VCPUs and memory distributed across multiple NUMA nodes. In this scenario, NUMA node 1 could run with 6 VCPUs and 3GB, and NUMA node 2 could run with 2 VCPUs and 1GB.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu/vnfr:guest-epa/vnfr:numa-node-policy
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu[vnfr:id='STRING']/vnfr:guest-epa/vnfr:numa-node-policy
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu/STRING/guest-epa/numa-node-policy

Fields
NameTypeDescription
node-cntUINT16The number of NUMA nodes to expose to the VM.
mem-policyENUMThis policy specifies how the memory should be allocated in a multi-node scenario. STRICT : The memory must be allocated strictly from the memory attached to the NUMA node. PREFERRED : The memory should be allocated preferentially from the memory attached to the NUMA node
nodeLIST

JSON Sample

XML Sample

vnfr:node

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu/vnfr:guest-epa/vnfr:numa-node-policy/vnfr:node
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu[vnfr:id='STRING']/vnfr:guest-epa/vnfr:numa-node-policy/vnfr:node[vnfr:id='0']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu/STRING/guest-epa/numa-node-policy/node/0

Fields
NameTypeDescription
idUINT64NUMA node identification. Typically it's 0 or 1
vcpuLISTList of VCPUs to allocate on this NUMA node.
memory-mbUINT64Memory size expressed in MB for this NUMA node.
num-coresUINT8
paired-threadsCONTAINER
num-threadsUINT8

JSON Sample

XML Sample

vnfr:vcpu

List of VCPUs to allocate on this NUMA node.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu/vnfr:guest-epa/vnfr:numa-node-policy/vnfr:node/vnfr:vcpu
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu[vnfr:id='STRING']/vnfr:guest-epa/vnfr:numa-node-policy/vnfr:node[vnfr:id='0']/vnfr:vcpu[vnfr:id='0']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu/STRING/guest-epa/numa-node-policy/node/0/vcpu/0

Fields
NameTypeDescription
idUINT64List of VCPUs ids to allocate on this NUMA node

JSON Sample

XML Sample

vnfr:paired-threads

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu/vnfr:guest-epa/vnfr:numa-node-policy/vnfr:node/vnfr:paired-threads
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu[vnfr:id='STRING']/vnfr:guest-epa/vnfr:numa-node-policy/vnfr:node[vnfr:id='0']/vnfr:paired-threads
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu/STRING/guest-epa/numa-node-policy/node/0/paired-threads

Fields
NameTypeDescription
num-paired-threadsUINT8
paired-thread-idsLISTList of thread pairs to use in case of paired-thread NUMA

JSON Sample

XML Sample

vnfr:paired-thread-ids

List of thread pairs to use in case of paired-thread NUMA

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu/vnfr:guest-epa/vnfr:numa-node-policy/vnfr:node/vnfr:paired-threads/vnfr:paired-thread-ids
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu[vnfr:id='STRING']/vnfr:guest-epa/vnfr:numa-node-policy/vnfr:node[vnfr:id='0']/vnfr:paired-threads/vnfr:paired-thread-ids[vnfr:thread-a='0']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu/STRING/guest-epa/numa-node-policy/node/0/paired-threads/paired-thread-ids/0

Fields
NameTypeDescription
thread-aUINT8
thread-bUINT8

JSON Sample

XML Sample

vnfr:vswitch-epa

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu/vnfr:vswitch-epa
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu[vnfr:id='STRING']/vnfr:vswitch-epa
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu/STRING/vswitch-epa

Fields
NameTypeDescription
ovs-accelerationENUMSpecifies Open vSwitch acceleration mode. MANDATORY: OVS acceleration is required PREFERRED: OVS acceleration is preferred
ovs-offloadENUMSpecifies Open vSwitch hardware offload mode. MANDATORY: OVS offload is required PREFERRED: OVS offload is preferred

JSON Sample

XML Sample

vnfr:hypervisor-epa

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu/vnfr:hypervisor-epa
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu[vnfr:id='STRING']/vnfr:hypervisor-epa
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu/STRING/hypervisor-epa

Fields
NameTypeDescription
typeENUMSpecifies the type of hypervisor. KVM: KVM XEN: XEN
versionSTRING

JSON Sample

XML Sample

vnfr:host-epa

Specifies the host level EPA attributes.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu/vnfr:host-epa
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu[vnfr:id='STRING']/vnfr:host-epa
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu/STRING/host-epa

Fields
NameTypeDescription
cpu-modelENUMHost CPU model. Examples include: SandyBridge, IvyBridge
cpu-archENUMHost CPU architecture.
cpu-vendorENUMHost CPU Vendor.
cpu-socket-countUINT64Number of sockets on the host.
cpu-core-countUINT64Number of cores on the host.
cpu-core-thread-countUINT64Number of threads per cores on the host.
cpu-featureLISTList of CPU features.
om-cpu-model-stringSTRINGOpenMANO CPU model string
om-cpu-featureLISTList of OpenMANO CPU features

JSON Sample

XML Sample

vnfr:cpu-feature

List of CPU features.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu/vnfr:host-epa/vnfr:cpu-feature
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu[vnfr:id='STRING']/vnfr:host-epa/vnfr:cpu-feature[vnfr:feature='PREFER_AES']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu/STRING/host-epa/cpu-feature/PREFER_AES

Fields
NameTypeDescription
featureENUMCPU feature.

JSON Sample

XML Sample

vnfr:om-cpu-feature

List of OpenMANO CPU features

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu/vnfr:host-epa/vnfr:om-cpu-feature
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu[vnfr:id='STRING']/vnfr:host-epa/vnfr:om-cpu-feature[vnfr:feature='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu/STRING/host-epa/om-cpu-feature/STRING

Fields
NameTypeDescription
featureSTRINGCPU feature

JSON Sample

XML Sample

vnfr:alarm

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu/vnfr:alarm
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu[vnfr:id='STRING']/vnfr:alarm[vnfr:alarm-id='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu/STRING/alarm/STRING

Fields
NameTypeDescription
alarm-idSTRINGThis field is reserved for the identifier assigned by the VIM provider
nameSTRINGA human readable string to identify the alarm
descriptionSTRINGA description of this alarm
vdur-idSTRINGThe identifier of the VDUR that the alarm is associated with
actionsCONTAINER
repeatBOOLEANThis flag indicates whether the alarm should be repeatedly emitted while the associated threshold has been crossed.
enabledBOOLEANThis flag indicates whether the alarm has been enabled or disabled.
severityENUMA measure of the importance or urgency of the alarm
metricENUMThe metric to be tracked by this alarm.
statisticENUMThe type of metric statistic that is tracked by this alarm
operationENUMThe relational operator used to define whether an alarm should be triggered in certain scenarios, such as if the metric statistic goes above or below a specified value.
valueDECIMAL64This value defines the threshold that, if crossed, will trigger the alarm.
periodUINT32The period defines the length of time (seconds) that the metric data are collected over in oreder to evaluate the chosen statistic.
evaluationsUINT32Defines the length of time (seconds) in which metric data are collected in order to evaluate the chosen statistic.

JSON Sample

XML Sample

vnfr:actions

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu/vnfr:alarm/vnfr:actions
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu[vnfr:id='STRING']/vnfr:alarm[vnfr:alarm-id='STRING']/vnfr:actions
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu/STRING/alarm/STRING/actions

Fields
NameTypeDescription
okLIST
insufficient-dataLIST
alarmLIST

JSON Sample

XML Sample

vnfr:ok

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu/vnfr:alarm/vnfr:actions/vnfr:ok
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu[vnfr:id='STRING']/vnfr:alarm[vnfr:alarm-id='STRING']/vnfr:actions/vnfr:ok[vnfr:url='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu/STRING/alarm/STRING/actions/ok/STRING

Fields
NameTypeDescription
urlSTRING

JSON Sample

XML Sample

vnfr:insufficient-data

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu/vnfr:alarm/vnfr:actions/vnfr:insufficient-data
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu[vnfr:id='STRING']/vnfr:alarm[vnfr:alarm-id='STRING']/vnfr:actions/vnfr:insufficient-data[vnfr:url='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu/STRING/alarm/STRING/actions/insufficient-data/STRING

Fields
NameTypeDescription
urlSTRING

JSON Sample

XML Sample

vnfr:alarm

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu/vnfr:alarm/vnfr:actions/vnfr:alarm
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu[vnfr:id='STRING']/vnfr:alarm[vnfr:alarm-id='STRING']/vnfr:actions/vnfr:alarm[vnfr:url='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu/STRING/alarm/STRING/actions/alarm/STRING

Fields
NameTypeDescription
urlSTRING

JSON Sample

XML Sample

vnfr:supplemental-boot-data

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu/vnfr:supplemental-boot-data
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu[vnfr:id='STRING']/vnfr:supplemental-boot-data
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu/STRING/supplemental-boot-data

Fields
NameTypeDescription
config-fileLISTList of configuration files to be written on an additional drive
boot-data-driveBOOLEANSome VIMs implement additional drives to host config-files or meta-data

JSON Sample

XML Sample

vnfr:config-file

List of configuration files to be written on an additional drive

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu/vnfr:supplemental-boot-data/vnfr:config-file
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu[vnfr:id='STRING']/vnfr:supplemental-boot-data/vnfr:config-file[vnfr:source='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu/STRING/supplemental-boot-data/config-file/STRING

Fields
NameTypeDescription
sourceSTRINGName of the configuration file
destSTRINGFull path of the destination in the guest

JSON Sample

XML Sample

vnfr:internal-connection-point

List for internal connection points. Each VNFC has zero or more internal connection points. Internal connection points are used for connecting the VNF with components internal to the VNF. If a VNF has only one VNFC, it may not have any internal connection points.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu/vnfr:internal-connection-point
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu[vnfr:id='STRING']/vnfr:internal-connection-point[vnfr:id='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu/STRING/internal-connection-point/STRING

Fields
NameTypeDescription
nameSTRINGName of the connection point
idSTRINGIdentifier for the internal connection points
short-nameSTRINGShort name to appear as label in the UI
typeENUMType of the connection point.
port-security-enabledBOOLEANEnables the port security for the port

JSON Sample

XML Sample

vnfr:internal-interface

List of internal interfaces for the VNF

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu/vnfr:internal-interface
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu[vnfr:id='STRING']/vnfr:internal-interface[vnfr:name='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu/STRING/internal-interface/STRING

Fields
NameTypeDescription
nameSTRINGName of internal interface. Note that this name has only local significance to the VDU.
vdu-internal-connection-point-refLEAFREF
virtual-interfaceCONTAINERContainer for the virtual interface properties

JSON Sample

XML Sample

vnfr:virtual-interface

Container for the virtual interface properties

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu/vnfr:internal-interface/vnfr:virtual-interface
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu[vnfr:id='STRING']/vnfr:internal-interface[vnfr:name='STRING']/vnfr:virtual-interface
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu/STRING/internal-interface/STRING/virtual-interface

Fields
NameTypeDescription
typeENUMSpecifies the type of virtual interface between VM and host. VIRTIO : Use the traditional VIRTIO interface. PCI-PASSTHROUGH : Use PCI-PASSTHROUGH interface. SR-IOV : Use SR-IOV interface. E1000 : Emulate E1000 interface. RTL8139 : Emulate RTL8139 interface. PCNET : Emulate PCNET interface. OM-MGMT : Used to specify openmano mgmt external-connection type
vpciSTRINGSpecifies the virtual PCI address. Expressed in the following format dddd:dd:dd.d. For example 0000:00:12.0. This information can be used to pass as metadata during the VM creation.
bandwidthUINT64Aggregate bandwidth of the NIC.

JSON Sample

XML Sample

vnfr:external-interface

List of external interfaces for the VNF. The external interfaces enable sending traffic to and from VNF.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu/vnfr:external-interface
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu[vnfr:id='STRING']/vnfr:external-interface[vnfr:name='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu/STRING/external-interface/STRING

Fields
NameTypeDescription
nameSTRINGName of the external interface. Note that this name has only local significance to the VDU.
vnfd-connection-point-refLEAFREFName of the external connection point.
virtual-interfaceCONTAINERContainer for the virtual interface properties

JSON Sample

XML Sample

vnfr:virtual-interface

Container for the virtual interface properties

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu/vnfr:external-interface/vnfr:virtual-interface
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu[vnfr:id='STRING']/vnfr:external-interface[vnfr:name='STRING']/vnfr:virtual-interface
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu/STRING/external-interface/STRING/virtual-interface

Fields
NameTypeDescription
typeENUMSpecifies the type of virtual interface between VM and host. VIRTIO : Use the traditional VIRTIO interface. PCI-PASSTHROUGH : Use PCI-PASSTHROUGH interface. SR-IOV : Use SR-IOV interface. E1000 : Emulate E1000 interface. RTL8139 : Emulate RTL8139 interface. PCNET : Emulate PCNET interface. OM-MGMT : Used to specify openmano mgmt external-connection type
vpciSTRINGSpecifies the virtual PCI address. Expressed in the following format dddd:dd:dd.d. For example 0000:00:12.0. This information can be used to pass as metadata during the VM creation.
bandwidthUINT64Aggregate bandwidth of the NIC.

JSON Sample

XML Sample

vnfr:volumes

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu/vnfr:volumes
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu[vnfr:id='STRING']/vnfr:volumes[vnfr:name='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu/STRING/volumes/STRING

Fields
NameTypeDescription
nameSTRINGName of the disk-volumes, e.g. vda, vdb etc
descriptionSTRINGDescription for Volume
sizeUINT64Size of disk in GB
ephemeralEMPTY
imageSTRINGImage name for the software image. If the image name is found within the VNF package it will be uploaded to all VIM accounts during onboarding process. Otherwise, the image must be added to the VIM account with the same name as entered here.
image-checksumSTRINGImage md5sum for the software image. The md5sum, if provided, along with the image name uniquely identifies an image uploaded to the CAL.
device-busENUMType of disk-bus on which this disk is exposed to guest
device-typeENUMThe type of device as exposed to guest

JSON Sample

XML Sample

vnfr:vdu-dependency

List of VDU dependencies.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:vdu-dependency
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:vdu-dependency[vnfr:vdu-source-ref='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/vdu-dependency/STRING

Fields
NameTypeDescription
vdu-source-refLEAFREF
vdu-depends-on-refLEAFREFReference to the VDU on which the source VDU depends.

JSON Sample

XML Sample

vnfr:http-endpoint

List of http endpoints to be used by monitoring params

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:http-endpoint
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:http-endpoint[vnfr:path='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/http-endpoint/STRING

Fields
NameTypeDescription
pathSTRINGThe HTTP path on the management server
httpsBOOLEANPick HTTPS instead of HTTP , Default is false
portUINT16The HTTP port to connect to
usernameSTRINGThe HTTP basic auth username
passwordSTRINGThe HTTP basic auth password
polling-interval-secsUINT8The HTTP polling interval in seconds
methodENUMMethod that the URI should perform. Deafult action is GET.
headersLISTCustom HTTP headers to put on HTTP request

JSON Sample

XML Sample

vnfr:headers

Custom HTTP headers to put on HTTP request

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:http-endpoint/vnfr:headers
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:http-endpoint[vnfr:path='STRING']/vnfr:headers[vnfr:key='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/http-endpoint/STRING/headers/STRING

Fields
NameTypeDescription
keySTRINGHTTP header key
valueSTRINGHTTP header value

JSON Sample

XML Sample

vnfr:monitoring-param

List of monitoring parameters at the network service level

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:monitoring-param
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:monitoring-param[vnfr:id='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/monitoring-param/STRING

Fields
NameTypeDescription
idSTRING
nameSTRING
http-endpoint-refLEAFREF
json-query-methodENUM
json-query-paramsCONTAINER
descriptionSTRING
group-tagSTRINGA tag to group monitoring parameters
widget-typeENUMDefines the UI Display variant of measured counters.
unitsSTRINGMeasured Counter Units (e.g., Packets, Kbps, Mbps, etc.)
value-typeENUM
numeric-constraintsCONTAINER
text-constraintsCONTAINER
value-integerINT64Current value for an integer parameter
value-decimalDECIMAL64Current value for a decimal parameter
value-stringSTRINGCurrent value for a string parameter

JSON Sample

XML Sample

vnfr:json-query-params

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:monitoring-param/vnfr:json-query-params
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:monitoring-param[vnfr:id='STRING']/vnfr:json-query-params
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/monitoring-param/STRING/json-query-params

Fields
NameTypeDescription
json-pathSTRINGThe jsonpath to use to extract value from JSON structure
object-pathSTRINGThe objectpath to use to extract value from JSON structure

JSON Sample

XML Sample

vnfr:numeric-constraints

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:monitoring-param/vnfr:numeric-constraints
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:monitoring-param[vnfr:id='STRING']/vnfr:numeric-constraints
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/monitoring-param/STRING/numeric-constraints

Fields
NameTypeDescription
min-valueUINT64Minimum value for the parameter
max-valueUINT64Maximum value for the parameter

JSON Sample

XML Sample

vnfr:text-constraints

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:monitoring-param/vnfr:text-constraints
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:monitoring-param[vnfr:id='STRING']/vnfr:text-constraints
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/monitoring-param/STRING/text-constraints

Fields
NameTypeDescription
min-lengthUINT8Minimum string length for the parameter
max-lengthUINT8Maximum string length for the parameter

JSON Sample

XML Sample

vnfr:placement-groups

List of placement groups at VNF level

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:placement-groups
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:placement-groups[vnfr:name='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/placement-groups/STRING

Fields
NameTypeDescription
nameSTRINGPlace group construct to define the compute resource placement strategy in cloud environment
requirementSTRINGThis is free text space used to describe the intent/rationale behind this placement group. This is for human consumption only
strategyENUMStrategy associated with this placement group Following values are possible - COLOCATION: Colocation strategy imply intent to share the physical infrastructure (hypervisor/network) among all members of this group. - ISOLATION: Isolation strategy imply intent to not share the physical infrastructure (hypervisor/network) among the members of this group.
member-vdusLISTList of VDUs that are part of this placement group

JSON Sample

XML Sample

vnfr:member-vdus

List of VDUs that are part of this placement group

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnfd/vnfr:placement-groups/vnfr:member-vdus
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnfd/vnfr:placement-groups[vnfr:name='STRING']/vnfr:member-vdus[vnfr:member-vdu-ref='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnfd/placement-groups/STRING/member-vdus/STRING

Fields
NameTypeDescription
member-vdu-refLEAFREF

JSON Sample

XML Sample

vnfr:vnf-configuration

Information about the VNF configuration. Note: If the NS contains multiple instances of the same VNF, each instance could have a different configuration.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnf-configuration
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnf-configuration
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnf-configuration

Fields
NameTypeDescription
netconfCONTAINER
restCONTAINER
scriptCONTAINER
jujuCONTAINER
config-accessCONTAINER
config-attributesCONTAINERMiscellaneous input parameters to be considered while processing the NSD to apply configuration
service-primitiveLISTList of service primitives supported by the configuration agent for this VNF.
initial-config-primitiveLISTInitial set of configuration primitives.
config-templateSTRINGConfiguration template for each VNF

JSON Sample

XML Sample

vnfr:netconf

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnf-configuration/vnfr:netconf
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnf-configuration/vnfr:netconf
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnf-configuration/netconf

Fields
NameTypeDescription
targetENUMNetconf configuration target
protocolENUMProtocol to use for NETCONF, such as ssh
portUINT16Port for the NETCONF server.

JSON Sample

XML Sample

vnfr:rest

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnf-configuration/vnfr:rest
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnf-configuration/vnfr:rest
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnf-configuration/rest

Fields
NameTypeDescription
portUINT16Port for the REST server.

JSON Sample

XML Sample

vnfr:script

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnf-configuration/vnfr:script
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnf-configuration/vnfr:script
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnf-configuration/script

Fields
NameTypeDescription
script-typeENUMScript type - currently supported : bash, expect

JSON Sample

XML Sample

vnfr:juju

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnf-configuration/vnfr:juju
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnf-configuration/vnfr:juju
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnf-configuration/juju

Fields
NameTypeDescription
charmSTRINGJuju charm to use with the VNF.

JSON Sample

XML Sample

vnfr:config-access

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnf-configuration/vnfr:config-access
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnf-configuration/vnfr:config-access
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnf-configuration/config-access

Fields
NameTypeDescription
mgmt-ip-addressUNIONIP address to be used to configure this VNF, optional if it is possible to resolve dynamically.
usernameSTRINGUser name for configuration.
passwordSTRINGPassword for configuration access authentication.

JSON Sample

XML Sample

vnfr:config-attributes

Miscellaneous input parameters to be considered while processing the NSD to apply configuration

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnf-configuration/vnfr:config-attributes
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnf-configuration/vnfr:config-attributes
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnf-configuration/config-attributes

Fields
NameTypeDescription
config-priorityUINT64Configuration priority - order of configuration to be applied to each VNF in this NS. A low number takes precedence over a high number
config-delayUINT64Wait (seconds) before applying the configuration to VNF

JSON Sample

XML Sample

vnfr:service-primitive

List of service primitives supported by the configuration agent for this VNF.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnf-configuration/vnfr:service-primitive
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnf-configuration/vnfr:service-primitive[vnfr:name='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnf-configuration/service-primitive/STRING

Fields
NameTypeDescription
nameSTRINGName of the service primitive.
parameterLISTList of parameters to the service primitive.

JSON Sample

XML Sample

vnfr:parameter

List of parameters to the service primitive.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnf-configuration/vnfr:service-primitive/vnfr:parameter
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnf-configuration/vnfr:service-primitive[vnfr:name='STRING']/vnfr:parameter[vnfr:name='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnf-configuration/service-primitive/STRING/parameter/STRING

Fields
NameTypeDescription
nameSTRINGName of the parameter.
data-typeENUMData type associated with the name.
mandatoryBOOLEANIs this field mandatory
default-valueSTRINGThe default value for this field
parameter-poolSTRINGNSD parameter pool name to use for this parameter
read-onlyBOOLEANThe value should be dimmed by the UI. Only applies to parameters with default values.
hiddenBOOLEANThe value should be hidden by the UI. Only applies to parameters with default values.

JSON Sample

XML Sample

vnfr:initial-config-primitive

Initial set of configuration primitives.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnf-configuration/vnfr:initial-config-primitive
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnf-configuration/vnfr:initial-config-primitive[vnfr:seq='0']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnf-configuration/initial-config-primitive/0

Fields
NameTypeDescription
seqUINT64Sequence number for the configuration primitive.
nameSTRINGName of the configuration primitive.
user-defined-scriptSTRINGA user defined script.
parameterLIST

JSON Sample

XML Sample

vnfr:parameter

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vnf-configuration/vnfr:initial-config-primitive/vnfr:parameter
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vnf-configuration/vnfr:initial-config-primitive[vnfr:seq='0']/vnfr:parameter[vnfr:name='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vnf-configuration/initial-config-primitive/0/parameter/STRING

Fields
NameTypeDescription
nameSTRING
valueSTRINGValue of the configuration primitive.

JSON Sample

XML Sample

vnfr:mgmt-interface

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:mgmt-interface
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:mgmt-interface
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/mgmt-interface

Fields
NameTypeDescription
ip-addressUNION
portUINT16

JSON Sample

XML Sample

vnfr:internal-vlr

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:internal-vlr
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:internal-vlr[vnfr:vlr-ref='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/internal-vlr/STRING

Fields
NameTypeDescription
vlr-refLEAFREFReference to a VLR record in the VLR catalog
internal-connection-point-refLEAF_LIST

JSON Sample

XML Sample

vnfr:internal-connection-point-ref

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:internal-vlr/vnfr:internal-connection-point-ref
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:internal-vlr[vnfr:vlr-ref='STRING']/vnfr:internal-connection-point-ref
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/internal-vlr/STRING/internal-connection-point-ref

JSON Sample

XML Sample

vnfr:connection-point

List for external connection points. Each VNF has one or more external connection points. As the name implies that external connection points are used for connecting the VNF to other VNFs or to external networks. Each VNF exposes these connection points to the orchestrator. The orchestrator can construct network services by connecting the connection points between different VNFs. The NFVO will use VLDs and VNFFGs at the network service level to construct network services.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:connection-point
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:connection-point[vnfr:name='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/connection-point/STRING

Fields
NameTypeDescription
nameSTRINGName of the connection point
idSTRINGIdentifier for the internal connection points
short-nameSTRINGShort name to appear as label in the UI
typeENUMType of the connection point.
port-security-enabledBOOLEANEnables the port security for the port
vlr-refLEAFREFReference to the VLR associated with this connection point
ip-addressUNIONIP address assigned to the external connection point
mac-addressSTRINGMAC address assigned to the external connection point
connection-point-idSTRING

JSON Sample

XML Sample

vnfr:vdur

List of Virtual Deployment Units

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING

Fields
NameTypeDescription
idSTRINGUnique id for the VDU
nameSTRINGname of the instantiated VDUR
unique-short-nameSTRINGShort Unique name of the VDU This will be of the format NSR name-ShortnedString-VDUname NSR name and VDU name shall be constrained to 10 characters
vdu-id-refLEAFREF
vim-idSTRINGAllocated VM resource id
flavor-idSTRINGVIM assigned flavor id
image-idSTRINGVIM assigned image id
management-ipUNIONManagement IP address
vm-management-ipUNIONVM Private Management IP address
console-urlSTRINGConsole URL for this VDU, if available
vm-flavorCONTAINER
guest-epaCONTAINER
vswitch-epaCONTAINER
hypervisor-epaCONTAINER
host-epaCONTAINERSpecifies the host level EPA attributes.
supplemental-boot-dataCONTAINER
volumesLIST
alarmsLISTA list of the alarms that have been created for this VDU
internal-connection-pointLISTList for internal connection points. Each VNFC has zero or more internal connection points. Internal connection points are used for connecting the VNF components internal to the VNF. If a VNF has only one VNFC, it may not have any internal connection points.
internal-interfaceLISTList of internal interfaces for the VNF
external-interfaceLISTList of external interfaces for the VNF. The external interfaces enable sending traffic to and from VNF.
operational-statusENUMThe operational status of the VDU init : The VDU has just started. vm-init-phase : The VDUs in the VNF is being created in VIM. vm-alloc-pending : The VM alloc is pending in VIM running : The VDU is active in VM terminate : The VDU is being terminated vm-terminate-phase : The VDU in the VNF is being terminated in VIM. terminated : The VDU is in the terminated state. failed : The VDU instantiation failed.
placement-groups-infoLIST Placement groups to which this VDU belongs and its cloud construct

JSON Sample

XML Sample

vnfr:vm-flavor

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:vm-flavor
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:vm-flavor
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/vm-flavor

Fields
NameTypeDescription
vcpu-countUINT16Number of VCPUs for the VM.
memory-mbUINT64Amount of memory in MB.
storage-gbUINT64Amount of disk space in GB.

JSON Sample

XML Sample

vnfr:guest-epa

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:guest-epa
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:guest-epa
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/guest-epa

Fields
NameTypeDescription
trusted-executionBOOLEANThis VM should be allocated from trusted pool
mempage-sizeENUMMemory page allocation size. If a VM requires hugepages, it should choose LARGE or SIZE_2MB or SIZE_1GB. If the VM prefers hugepages it should choose PREFER_LARGE. LARGE : Require hugepages (either 2MB or 1GB) SMALL : Doesn't require hugepages SIZE_2MB : Requires 2MB hugepages SIZE_1GB : Requires 1GB hugepages PREFER_LARGE : Application prefers hugepages
cpu-pinning-policyENUMCPU pinning policy describes association between virtual CPUs in guest and the physical CPUs in the host. DEDICATED : Virtual CPUs are pinned to physical CPUs SHARED : Multiple VMs may share the same physical CPUs. ANY : Any policy is acceptable for the VM
cpu-thread-pinning-policyENUMCPU thread pinning policy describes how to place the guest CPUs when the host supports hyper threads: AVOID : Avoids placing a guest on a host with threads. SEPARATE: Places vCPUs on separate cores, and avoids placing two vCPUs on two threads of same core. ISOLATE : Places each vCPU on a different core, and places no vCPUs from a different guest on the same core. PREFER : Attempts to place vCPUs on threads of the same core.
pcie-deviceLISTList of pcie passthrough devices.
numa-unawareEMPTY
numa-node-policyCONTAINERThis policy defines NUMA topology of the guest. Specifically identifies if the guest should be run on a host with one NUMA node or multiple NUMA nodes. As an example a guest might need 8 VCPUs and 4 GB of memory. However, it might need the VCPUs and memory distributed across multiple NUMA nodes. In this scenario, NUMA node 1 could run with 6 VCPUs and 3GB, and NUMA node 2 could run with 2 VCPUs and 1GB.

JSON Sample

XML Sample

vnfr:pcie-device

List of pcie passthrough devices.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:guest-epa/vnfr:pcie-device
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:guest-epa/vnfr:pcie-device[vnfr:device-id='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/guest-epa/pcie-device/STRING

Fields
NameTypeDescription
device-idSTRINGDevice identifier.
countUINT64Number of devices to attach to the VM.

JSON Sample

XML Sample

vnfr:numa-node-policy

This policy defines NUMA topology of the guest. Specifically identifies if the guest should be run on a host with one NUMA node or multiple NUMA nodes. As an example a guest might need 8 VCPUs and 4 GB of memory. However, it might need the VCPUs and memory distributed across multiple NUMA nodes. In this scenario, NUMA node 1 could run with 6 VCPUs and 3GB, and NUMA node 2 could run with 2 VCPUs and 1GB.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:guest-epa/vnfr:numa-node-policy
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:guest-epa/vnfr:numa-node-policy
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/guest-epa/numa-node-policy

Fields
NameTypeDescription
node-cntUINT16The number of NUMA nodes to expose to the VM.
mem-policyENUMThis policy specifies how the memory should be allocated in a multi-node scenario. STRICT : The memory must be allocated strictly from the memory attached to the NUMA node. PREFERRED : The memory should be allocated preferentially from the memory attached to the NUMA node
nodeLIST

JSON Sample

XML Sample

vnfr:node

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:guest-epa/vnfr:numa-node-policy/vnfr:node
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:guest-epa/vnfr:numa-node-policy/vnfr:node[vnfr:id='0']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/guest-epa/numa-node-policy/node/0

Fields
NameTypeDescription
idUINT64NUMA node identification. Typically it's 0 or 1
vcpuLISTList of VCPUs to allocate on this NUMA node.
memory-mbUINT64Memory size expressed in MB for this NUMA node.
num-coresUINT8
paired-threadsCONTAINER
num-threadsUINT8

JSON Sample

XML Sample

vnfr:vcpu

List of VCPUs to allocate on this NUMA node.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:guest-epa/vnfr:numa-node-policy/vnfr:node/vnfr:vcpu
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:guest-epa/vnfr:numa-node-policy/vnfr:node[vnfr:id='0']/vnfr:vcpu[vnfr:id='0']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/guest-epa/numa-node-policy/node/0/vcpu/0

Fields
NameTypeDescription
idUINT64List of VCPUs ids to allocate on this NUMA node

JSON Sample

XML Sample

vnfr:paired-threads

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:guest-epa/vnfr:numa-node-policy/vnfr:node/vnfr:paired-threads
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:guest-epa/vnfr:numa-node-policy/vnfr:node[vnfr:id='0']/vnfr:paired-threads
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/guest-epa/numa-node-policy/node/0/paired-threads

Fields
NameTypeDescription
num-paired-threadsUINT8
paired-thread-idsLISTList of thread pairs to use in case of paired-thread NUMA

JSON Sample

XML Sample

vnfr:paired-thread-ids

List of thread pairs to use in case of paired-thread NUMA

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:guest-epa/vnfr:numa-node-policy/vnfr:node/vnfr:paired-threads/vnfr:paired-thread-ids
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:guest-epa/vnfr:numa-node-policy/vnfr:node[vnfr:id='0']/vnfr:paired-threads/vnfr:paired-thread-ids[vnfr:thread-a='0']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/guest-epa/numa-node-policy/node/0/paired-threads/paired-thread-ids/0

Fields
NameTypeDescription
thread-aUINT8
thread-bUINT8

JSON Sample

XML Sample

vnfr:vswitch-epa

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:vswitch-epa
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:vswitch-epa
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/vswitch-epa

Fields
NameTypeDescription
ovs-accelerationENUMSpecifies Open vSwitch acceleration mode. MANDATORY: OVS acceleration is required PREFERRED: OVS acceleration is preferred
ovs-offloadENUMSpecifies Open vSwitch hardware offload mode. MANDATORY: OVS offload is required PREFERRED: OVS offload is preferred

JSON Sample

XML Sample

vnfr:hypervisor-epa

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:hypervisor-epa
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:hypervisor-epa
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/hypervisor-epa

Fields
NameTypeDescription
typeENUMSpecifies the type of hypervisor. KVM: KVM XEN: XEN
versionSTRING

JSON Sample

XML Sample

vnfr:host-epa

Specifies the host level EPA attributes.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:host-epa
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:host-epa
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/host-epa

Fields
NameTypeDescription
cpu-modelENUMHost CPU model. Examples include: SandyBridge, IvyBridge
cpu-archENUMHost CPU architecture.
cpu-vendorENUMHost CPU Vendor.
cpu-socket-countUINT64Number of sockets on the host.
cpu-core-countUINT64Number of cores on the host.
cpu-core-thread-countUINT64Number of threads per cores on the host.
cpu-featureLISTList of CPU features.
om-cpu-model-stringSTRINGOpenMANO CPU model string
om-cpu-featureLISTList of OpenMANO CPU features

JSON Sample

XML Sample

vnfr:cpu-feature

List of CPU features.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:host-epa/vnfr:cpu-feature
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:host-epa/vnfr:cpu-feature[vnfr:feature='PREFER_AES']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/host-epa/cpu-feature/PREFER_AES

Fields
NameTypeDescription
featureENUMCPU feature.

JSON Sample

XML Sample

vnfr:om-cpu-feature

List of OpenMANO CPU features

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:host-epa/vnfr:om-cpu-feature
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:host-epa/vnfr:om-cpu-feature[vnfr:feature='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/host-epa/om-cpu-feature/STRING

Fields
NameTypeDescription
featureSTRINGCPU feature

JSON Sample

XML Sample

vnfr:supplemental-boot-data

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:supplemental-boot-data
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:supplemental-boot-data
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/supplemental-boot-data

Fields
NameTypeDescription
config-fileLISTList of configuration files to be written on an additional drive
boot-data-driveBOOLEANSome VIMs implement additional drives to host config-files or meta-data

JSON Sample

XML Sample

vnfr:config-file

List of configuration files to be written on an additional drive

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:supplemental-boot-data/vnfr:config-file
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:supplemental-boot-data/vnfr:config-file[vnfr:source='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/supplemental-boot-data/config-file/STRING

Fields
NameTypeDescription
sourceSTRINGName of the configuration file
destSTRINGFull path of the destination in the guest

JSON Sample

XML Sample

vnfr:volumes

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:volumes
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:volumes[vnfr:name='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/volumes/STRING

Fields
NameTypeDescription
nameSTRINGName of the disk-volumes, e.g. vda, vdb etc
volume-idSTRINGVIM assigned volume id
descriptionSTRINGDescription for Volume
sizeUINT64Size of disk in GB
ephemeralEMPTY
imageSTRINGImage name for the software image. If the image name is found within the VNF package it will be uploaded to all VIM accounts during onboarding process. Otherwise, the image must be added to the VIM account with the same name as entered here.
image-checksumSTRINGImage md5sum for the software image. The md5sum, if provided, along with the image name uniquely identifies an image uploaded to the CAL.
device-busENUMType of disk-bus on which this disk is exposed to guest
device-typeENUMThe type of device as exposed to guest

JSON Sample

XML Sample

vnfr:alarms

A list of the alarms that have been created for this VDU

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:alarms
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:alarms[vnfr:alarm-id='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/alarms/STRING

Fields
NameTypeDescription
alarm-idSTRINGThis field is reserved for the identifier assigned by the VIM provider
nameSTRINGA human readable string to identify the alarm
descriptionSTRINGA description of this alarm
vdur-idSTRINGThe identifier of the VDUR that the alarm is associated with
actionsCONTAINER
repeatBOOLEANThis flag indicates whether the alarm should be repeatedly emitted while the associated threshold has been crossed.
enabledBOOLEANThis flag indicates whether the alarm has been enabled or disabled.
severityENUMA measure of the importance or urgency of the alarm
metricENUMThe metric to be tracked by this alarm.
statisticENUMThe type of metric statistic that is tracked by this alarm
operationENUMThe relational operator used to define whether an alarm should be triggered in certain scenarios, such as if the metric statistic goes above or below a specified value.
valueDECIMAL64This value defines the threshold that, if crossed, will trigger the alarm.
periodUINT32The period defines the length of time (seconds) that the metric data are collected over in oreder to evaluate the chosen statistic.
evaluationsUINT32Defines the length of time (seconds) in which metric data are collected in order to evaluate the chosen statistic.

JSON Sample

XML Sample

vnfr:actions

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:alarms/vnfr:actions
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:alarms[vnfr:alarm-id='STRING']/vnfr:actions
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/alarms/STRING/actions

Fields
NameTypeDescription
okLIST
insufficient-dataLIST
alarmLIST

JSON Sample

XML Sample

vnfr:ok

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:alarms/vnfr:actions/vnfr:ok
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:alarms[vnfr:alarm-id='STRING']/vnfr:actions/vnfr:ok[vnfr:url='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/alarms/STRING/actions/ok/STRING

Fields
NameTypeDescription
urlSTRING

JSON Sample

XML Sample

vnfr:insufficient-data

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:alarms/vnfr:actions/vnfr:insufficient-data
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:alarms[vnfr:alarm-id='STRING']/vnfr:actions/vnfr:insufficient-data[vnfr:url='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/alarms/STRING/actions/insufficient-data/STRING

Fields
NameTypeDescription
urlSTRING

JSON Sample

XML Sample

vnfr:alarm

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:alarms/vnfr:actions/vnfr:alarm
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:alarms[vnfr:alarm-id='STRING']/vnfr:actions/vnfr:alarm[vnfr:url='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/alarms/STRING/actions/alarm/STRING

Fields
NameTypeDescription
urlSTRING

JSON Sample

XML Sample

vnfr:internal-connection-point

List for internal connection points. Each VNFC has zero or more internal connection points. Internal connection points are used for connecting the VNF components internal to the VNF. If a VNF has only one VNFC, it may not have any internal connection points.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:internal-connection-point
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:internal-connection-point[vnfr:id='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/internal-connection-point/STRING

Fields
NameTypeDescription
nameSTRINGName of the connection point
idSTRINGIdentifier for the internal connection points
short-nameSTRINGShort name to appear as label in the UI
typeENUMType of the connection point.
port-security-enabledBOOLEANEnables the port security for the port
ip-addressUNIONIP address assigned to the internal connection point
mac-addressSTRINGMAC address assigned to the internal connection point

JSON Sample

XML Sample

vnfr:internal-interface

List of internal interfaces for the VNF

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:internal-interface
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:internal-interface[vnfr:name='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/internal-interface/STRING

Fields
NameTypeDescription
nameSTRINGName of internal interface. Note that this name has only local significance to the VDU.
vdur-internal-connection-point-refLEAFREF
virtual-interfaceCONTAINERContainer for the virtual interface properties

JSON Sample

XML Sample

vnfr:virtual-interface

Container for the virtual interface properties

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:internal-interface/vnfr:virtual-interface
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:internal-interface[vnfr:name='STRING']/vnfr:virtual-interface
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/internal-interface/STRING/virtual-interface

Fields
NameTypeDescription
typeENUMSpecifies the type of virtual interface between VM and host. VIRTIO : Use the traditional VIRTIO interface. PCI-PASSTHROUGH : Use PCI-PASSTHROUGH interface. SR-IOV : Use SR-IOV interface.
bandwidthUINT64Aggregate bandwidth of the NIC.
ovs-offloadENUMDefines if the NIC supports OVS offload. MANDATORY : OVS offload support in the NIC is mandatory. PREFERRED : OVS offload support in the NIC is preferred.
vendor-idSTRINGSpecifies the vendor specific id for the device. This is used when a NIC from specific HW vendor is required.
datapath-librarySTRINGSpecifies the name and version of the datapath library the NIC is expected to support.
provider-network-nameSTRINGName of the provider network to which this NIC is attached.

JSON Sample

XML Sample

vnfr:external-interface

List of external interfaces for the VNF. The external interfaces enable sending traffic to and from VNF.

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:external-interface
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:external-interface[vnfr:name='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/external-interface/STRING

Fields
NameTypeDescription
nameSTRINGName of the external interface. Note that this name has only local significance.
vnfd-connection-point-refLEAFREFName of the external connection point.
virtual-interfaceCONTAINERContainer for the virtual interface properties

JSON Sample

XML Sample

vnfr:virtual-interface

Container for the virtual interface properties

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:external-interface/vnfr:virtual-interface
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:external-interface[vnfr:name='STRING']/vnfr:virtual-interface
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/external-interface/STRING/virtual-interface

Fields
NameTypeDescription
typeENUMSpecifies the type of virtual interface between VM and host. VIRTIO : Use the traditional VIRTIO interface. PCI-PASSTHROUGH : Use PCI-PASSTHROUGH interface. SR-IOV : Use SR-IOV interface.
bandwidthUINT64Aggregate bandwidth of the NIC.
ovs-offloadENUMDefines if the NIC supports OVS offload. MANDATORY : OVS offload support in the NIC is mandatory. PREFERRED : OVS offload support in the NIC is preferred.
vendor-idSTRINGSpecifies the vendor specific id for the device. This is used when a NIC from specific HW vendor is required.
datapath-librarySTRINGSpecifies the name and version of the datapath library the NIC is expected to support.
provider-network-nameSTRINGName of the provider network to which this NIC is attached.

JSON Sample

XML Sample

vnfr:placement-groups-info

Placement groups to which this VDU belongs and its cloud construct

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:placement-groups-info
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:placement-groups-info[vnfr:name='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/placement-groups-info/STRING

Fields
NameTypeDescription
nameSTRINGPlace group construct to define the compute resource placement strategy in cloud environment
requirementSTRINGThis is free text space used to describe the intent/rationale behind this placement group. This is for human consumption only
strategyENUMStrategy associated with this placement group Following values are possible - COLOCATION: Colocation strategy imply intent to share the physical infrastructure (hypervisor/network) among all members of this group. - ISOLATION: Isolation strategy imply intent to not share the physical infrastructure (hypervisor/network) among the members of this group.
cloud-typeENUM
availability-zoneCONTAINERName of the Availability Zone
server-groupCONTAINERName of the Affinity/Anti-Affinity Server Group
host-aggregateLISTName of the Host Aggregate
aws-constructEMPTY
openmano-constructEMPTY
vsphere-constructEMPTY
mock-constructEMPTY
cloudsim-constructEMPTY

JSON Sample

XML Sample

vnfr:availability-zone

Name of the Availability Zone

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:placement-groups-info/vnfr:availability-zone
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:placement-groups-info[vnfr:name='STRING']/vnfr:availability-zone
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/placement-groups-info/STRING/availability-zone

Fields
NameTypeDescription
nameSTRING

JSON Sample

XML Sample

vnfr:server-group

Name of the Affinity/Anti-Affinity Server Group

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:placement-groups-info/vnfr:server-group
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:placement-groups-info[vnfr:name='STRING']/vnfr:server-group
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/placement-groups-info/STRING/server-group

Fields
NameTypeDescription
nameSTRING

JSON Sample

XML Sample

vnfr:host-aggregate

Name of the Host Aggregate

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:vdur/vnfr:placement-groups-info/vnfr:host-aggregate
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:vdur[vnfr:id='STRING']/vnfr:placement-groups-info[vnfr:name='STRING']/vnfr:host-aggregate[vnfr:metadata-key='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/vdur/STRING/placement-groups-info/STRING/host-aggregate/STRING

Fields
NameTypeDescription
metadata-keySTRINGName of the additional information attached to the host-aggregate
metadata-valueSTRINGValue of the corresponding metadata-key

JSON Sample

XML Sample

vnfr:http-endpoint

List of http endpoints to be used by monitoring params

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:http-endpoint
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:http-endpoint[vnfr:path='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/http-endpoint/STRING

Fields
NameTypeDescription
pathSTRINGThe HTTP path on the management server
httpsBOOLEANPick HTTPS instead of HTTP , Default is false
portUINT16The HTTP port to connect to
usernameSTRINGThe HTTP basic auth username
passwordSTRINGThe HTTP basic auth password
polling-interval-secsUINT8The HTTP polling interval in seconds
methodENUMMethod that the URI should perform. Deafult action is GET.
headersLISTCustom HTTP headers to put on HTTP request

JSON Sample

XML Sample

vnfr:headers

Custom HTTP headers to put on HTTP request

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:http-endpoint/vnfr:headers
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:http-endpoint[vnfr:path='STRING']/vnfr:headers[vnfr:key='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/http-endpoint/STRING/headers/STRING

Fields
NameTypeDescription
keySTRINGHTTP header key
valueSTRINGHTTP header value

JSON Sample

XML Sample

vnfr:monitoring-param

List of monitoring parameters at the network service level

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:monitoring-param
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:monitoring-param[vnfr:id='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/monitoring-param/STRING

Fields
NameTypeDescription
idSTRING
nameSTRING
http-endpoint-refLEAFREF
json-query-methodENUM
json-query-paramsCONTAINER
descriptionSTRING
group-tagSTRINGA tag to group monitoring parameters
widget-typeENUMDefines the UI Display variant of measured counters.
unitsSTRINGMeasured Counter Units (e.g., Packets, Kbps, Mbps, etc.)
value-typeENUM
numeric-constraintsCONTAINER
text-constraintsCONTAINER
value-integerINT64Current value for an integer parameter
value-decimalDECIMAL64Current value for a decimal parameter
value-stringSTRINGCurrent value for a string parameter

JSON Sample

XML Sample

vnfr:json-query-params

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:monitoring-param/vnfr:json-query-params
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:monitoring-param[vnfr:id='STRING']/vnfr:json-query-params
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/monitoring-param/STRING/json-query-params

Fields
NameTypeDescription
json-pathSTRINGThe jsonpath to use to extract value from JSON structure
object-pathSTRINGThe objectpath to use to extract value from JSON structure

JSON Sample

XML Sample

vnfr:numeric-constraints

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:monitoring-param/vnfr:numeric-constraints
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:monitoring-param[vnfr:id='STRING']/vnfr:numeric-constraints
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/monitoring-param/STRING/numeric-constraints

Fields
NameTypeDescription
min-valueUINT64Minimum value for the parameter
max-valueUINT64Maximum value for the parameter

JSON Sample

XML Sample

vnfr:text-constraints

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:monitoring-param/vnfr:text-constraints
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:monitoring-param[vnfr:id='STRING']/vnfr:text-constraints
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/monitoring-param/STRING/text-constraints

Fields
NameTypeDescription
min-lengthUINT8Minimum string length for the parameter
max-lengthUINT8Maximum string length for the parameter

JSON Sample

XML Sample

vnfr:placement-groups-info

Placement groups to which this VDU belongs and its cloud construct

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:placement-groups-info
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:placement-groups-info[vnfr:name='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/placement-groups-info/STRING

Fields
NameTypeDescription
nameSTRINGPlace group construct to define the compute resource placement strategy in cloud environment
requirementSTRINGThis is free text space used to describe the intent/rationale behind this placement group. This is for human consumption only
strategyENUMStrategy associated with this placement group Following values are possible - COLOCATION: Colocation strategy imply intent to share the physical infrastructure (hypervisor/network) among all members of this group. - ISOLATION: Isolation strategy imply intent to not share the physical infrastructure (hypervisor/network) among the members of this group.
cloud-typeENUM
availability-zoneCONTAINERName of the Availability Zone
server-groupCONTAINERName of the Affinity/Anti-Affinity Server Group
host-aggregateLISTName of the Host Aggregate
aws-constructEMPTY
openmano-constructEMPTY
vsphere-constructEMPTY
mock-constructEMPTY
cloudsim-constructEMPTY

JSON Sample

XML Sample

vnfr:availability-zone

Name of the Availability Zone

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:placement-groups-info/vnfr:availability-zone
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:placement-groups-info[vnfr:name='STRING']/vnfr:availability-zone
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/placement-groups-info/STRING/availability-zone

Fields
NameTypeDescription
nameSTRING

JSON Sample

XML Sample

vnfr:server-group

Name of the Affinity/Anti-Affinity Server Group

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:placement-groups-info/vnfr:server-group
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:placement-groups-info[vnfr:name='STRING']/vnfr:server-group
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/placement-groups-info/STRING/server-group

Fields
NameTypeDescription
nameSTRING

JSON Sample

XML Sample

vnfr:host-aggregate

Name of the Host Aggregate

Key Identifiers:
XPath Path
/vnfr:vnfr-catalog/vnfr:vnfr/vnfr:placement-groups-info/vnfr:host-aggregate
XPath Keyed Path
/vnfr:vnfr-catalog/vnfr:vnfr[vnfr:id='STRING']/vnfr:placement-groups-info[vnfr:name='STRING']/vnfr:host-aggregate[vnfr:metadata-key='STRING']
RW.REST URI Path
/vnfr:vnfr-catalog/vnfr/STRING/placement-groups-info/STRING/host-aggregate/STRING

Fields
NameTypeDescription
metadata-keySTRINGName of the additional information attached to the host-aggregate
metadata-valueSTRINGValue of the corresponding metadata-key

JSON Sample

XML Sample

vnfr rpc input

vnfr:create-alarm

Key Identifiers:
XPath Path
/vnfr:create-alarm
XPath Keyed Path
/vnfr:create-alarm
RW.REST URI Path
/input

Fields
NameTypeDescription
cloud-accountSTRING
vdur-idSTRING
alarmCONTAINER

JSON Sample

XML Sample

vnfr:alarm

Key Identifiers:
XPath Path
/vnfr:create-alarm/vnfr:alarm
XPath Keyed Path
/vnfr:create-alarm/vnfr:alarm
RW.REST URI Path
/input/alarm

Fields
NameTypeDescription
alarm-idSTRINGThis field is reserved for the identifier assigned by the VIM provider
nameSTRINGA human readable string to identify the alarm
descriptionSTRINGA description of this alarm
vdur-idSTRINGThe identifier of the VDUR that the alarm is associated with
actionsCONTAINER
repeatBOOLEANThis flag indicates whether the alarm should be repeatedly emitted while the associated threshold has been crossed.
enabledBOOLEANThis flag indicates whether the alarm has been enabled or disabled.
severityENUMA measure of the importance or urgency of the alarm
metricENUMThe metric to be tracked by this alarm.
statisticENUMThe type of metric statistic that is tracked by this alarm
operationENUMThe relational operator used to define whether an alarm should be triggered in certain scenarios, such as if the metric statistic goes above or below a specified value.
valueDECIMAL64This value defines the threshold that, if crossed, will trigger the alarm.
periodUINT32The period defines the length of time (seconds) that the metric data are collected over in oreder to evaluate the chosen statistic.
evaluationsUINT32Defines the length of time (seconds) in which metric data are collected in order to evaluate the chosen statistic.

JSON Config Sample

JSON Sample

XML Config Sample

XML Sample

vnfr:actions

Key Identifiers:
XPath Path
/vnfr:create-alarm/vnfr:alarm/vnfr:actions
XPath Keyed Path
/vnfr:create-alarm/vnfr:alarm/vnfr:actions
RW.REST URI Path
/input/alarm/actions

Fields
NameTypeDescription
okLIST
insufficient-dataLIST
alarmLIST

JSON Config Sample

JSON Sample

XML Config Sample

XML Sample

vnfr:ok

Key Identifiers:
XPath Path
/vnfr:create-alarm/vnfr:alarm/vnfr:actions/vnfr:ok
XPath Keyed Path
/vnfr:create-alarm/vnfr:alarm/vnfr:actions/vnfr:ok[vnfr:url='STRING']
RW.REST URI Path
/input/alarm/actions/ok/STRING

Fields
NameTypeDescription
urlSTRING

JSON Config Sample

JSON Sample

XML Config Sample

XML Sample

vnfr:insufficient-data

Key Identifiers:
XPath Path
/vnfr:create-alarm/vnfr:alarm/vnfr:actions/vnfr:insufficient-data
XPath Keyed Path
/vnfr:create-alarm/vnfr:alarm/vnfr:actions/vnfr:insufficient-data[vnfr:url='STRING']
RW.REST URI Path
/input/alarm/actions/insufficient-data/STRING

Fields
NameTypeDescription
urlSTRING

JSON Config Sample

JSON Sample

XML Config Sample

XML Sample

vnfr:alarm

Key Identifiers:
XPath Path
/vnfr:create-alarm/vnfr:alarm/vnfr:actions/vnfr:alarm
XPath Keyed Path
/vnfr:create-alarm/vnfr:alarm/vnfr:actions/vnfr:alarm[vnfr:url='STRING']
RW.REST URI Path
/input/alarm/actions/alarm/STRING

Fields
NameTypeDescription
urlSTRING

JSON Config Sample

JSON Sample

XML Config Sample

XML Sample

vnfr:destroy-alarm

Key Identifiers:
XPath Path
/vnfr:destroy-alarm
XPath Keyed Path
/vnfr:destroy-alarm
RW.REST URI Path
/input

Fields
NameTypeDescription
cloud-accountSTRING
alarm-idSTRING

JSON Sample

XML Sample

vnfr rpc output

vnfr:create-alarm

Key Identifiers:
XPath Path
/vnfr:create-alarm
XPath Keyed Path
/vnfr:create-alarm
RW.REST URI Path
/output

Fields
NameTypeDescription
alarm-idSTRING

JSON Sample

XML Sample

vnfr:destroy-alarm

Key Identifiers:
XPath Path
/vnfr:destroy-alarm
XPath Keyed Path
/vnfr:destroy-alarm
RW.REST URI Path
/output

JSON Sample

XML Sample