diff --git a/.jenkins.sh b/.jenkins.sh index 428f50831afd7d442b5789bcceea2dffe572d8a7..bb3201349329943a9d18b7687063c33b947e1b7e 100644 --- a/.jenkins.sh +++ b/.jenkins.sh @@ -19,7 +19,7 @@ docker run "$IMG" echo "Building HTML tree" docker run -v"$(pwd)/src/yang/:/yang/" mjethanandani/pyang \ "/bin/sh" -c "cd /yang/ && pyang -f jstree -p /yang/ \ - /yang/etsi-nfv.yang > etsi-nfv.html" + /yang/etsi-nfv-descriptors.yang > etsi-nfv.html" sed -r -i 's|||g' src/yang/etsi-nfv.html sed -r -i 's|data\:image/gif\;base64,R0lGODlhS.*RCAA7|https://www.etsi.org/images/ETSILogoTwitter.png\" height=\"100|g' src/yang/etsi-nfv.html diff --git a/example-data/complex-vnfd.xml b/example-data/complex-vnfd.xml index cf8048d9ed6ecdf8099420b9fb2e393ad4a0151e..e1eaac635bcc9c3bc42f513da8ff7695446b0452 100644 --- a/example-data/complex-vnfd.xml +++ b/example-data/complex-vnfd.xml @@ -240,7 +240,7 @@ control-plane - anti-affinity + anti-affinity nfvi-node @@ -328,7 +328,7 @@ control-plane - anti-affinity + anti-affinity nfvi-node diff --git a/example-data/nfv.xml b/example-data/nfv.xml index ccd703c0309351f77bd06017e23c619a7640ecb7..a74911a4d73eb34f7a0b0820292c55e40d96c1d2 100644 --- a/example-data/nfv.xml +++ b/example-data/nfv.xml @@ -343,10 +343,10 @@ outside - + CSR - left - + left + fw2dpi @@ -585,17 +585,17 @@ CSR inside - + firewall-nsd - inside - + inside + outside - + CSR - left - + left + r2fw diff --git a/src/yang/etsi-nfv-common.yang b/src/yang/etsi-nfv-common.yang index 18ba9a8b1dcc8ac334be244316434718075809bf..a8eef0d9466a44cc2268cd410308821518fd9549 100644 --- a/src/yang/etsi-nfv-common.yang +++ b/src/yang/etsi-nfv-common.yang @@ -482,8 +482,11 @@ submodule etsi-nfv-common { "Applicable to VirtualComputeDesc and VirtualStorageDesc. When present, specifies the allowed migration types in the order of preference in case of an impact starting with the - most preferred type. Possible values: NO_MIGRATION, - OFFLINE_MIGRATION, LIVE_MIGRATION."; + most preferred type. + Values: + • NO_MIGRATION + • OFFLINE_MIGRATION + • LIVE_MIGRATION."; reference "GS NFV-IFA011: Section 7.1.8.17, NfviMaintenanceInfo information element"; @@ -565,11 +568,15 @@ submodule etsi-nfv-common { } min-elements 1; description - "Identifies the protocols that the VL uses (Ethernet, - MPLS, ODU2, IPV4, IPV6, Pseudo-Wire). The top layer - protocol of the VL protocol stack shall always be provided. - The lower layer protocols may be included when there are - specific requirements on these layers."; + "Specifies the protocols that the VL uses + Values: + • Ethernet + • MPLS + • ODU2 + • IPV4 + • IPV6 + • Pseudo-Wire + • etc."; reference "GS NFV IFA011: Section 7.1.7.3, ConnectivityType information element."; @@ -578,7 +585,7 @@ submodule etsi-nfv-common { leaf flow-pattern { type flow-pattern; description - "Identifies the flow pattern of the connectivity (Line, + "Specifies the flow pattern of the connectivity (Line, Tree, Mesh)."; reference "GS NFV IFA011: Section 7.1.7.3, ConnectivityType @@ -700,9 +707,15 @@ submodule etsi-nfv-common { base layer-protocol; } description - "Identifies a protocol that the connection points - corresponding to the CPD support for connectivity purposes - (e.g. Ethernet, MPLS, ODU2, IPV4, IPV6, Pseudo-Wire, etc.)."; + "Specifies which protocol the CP uses for connectivity purposes + Values: + • Ethernet + • MPLS + • ODU2 + • IPV4 + • IPV6 + • Pseudo-Wire + • etc."; reference "GS NFV IFA011: Section 7.1.6.3 Cpd information element"; } @@ -740,7 +753,15 @@ submodule etsi-nfv-common { } description "One of the values of the attribute layerProtocol of the Cpd - IE."; + IE. + Values: + • Ethernet + • MPLS + • ODU2 + • IPV4 + • IPV6 + • Pseudo-Wire + • etc."; reference "GS NFV IFA011: Section 7.1.6.8 CpProtocolData information element"; @@ -756,10 +777,10 @@ submodule etsi-nfv-common { description "Describes the type of the address to be assigned to the CP instantiated from the parent CPD. - Value: - • MAC address. - • IP address. - • Etc. + Values: + • MAC address + • IP address + • etc. The content type shall be aligned with the address type supported by the layerProtocol attribute of the parent CPD."; @@ -826,9 +847,10 @@ submodule etsi-nfv-common { enum "ipv6"; } description - "Define address type. The address type should be aligned - with the address type supported by the layerProtocol - attribute of the parent VnfExtCpd."; + "Define address type. + Values: + • IPV4 + • IPV6."; reference "GS NFV IFA011: Section 7.1.3.4, L3AddressData information element."; @@ -843,6 +865,16 @@ submodule etsi-nfv-common { "GS NFV IFA011: Section 7.1.3.4, L3AddressData information element."; } + + leaf fixed-ip-address { + type string; + description + "IP address to be assigned to the CP instance."; + reference + "GS NFV IFA011: Section 7.1.3.4, L3AddressData + information element."; + } + } description "Provides information on the addresses to be assigned to the @@ -907,7 +939,10 @@ submodule etsi-nfv-common { default "ingress"; description "The direction in which the security group rule is applied. - Permitted values: INGRESS, EGRESS. Defaults to INGRESS."; + Values: + • INGRESS + • EGRESS + Defaults to INGRESS."; reference "GS NFV IFA011: Section 7.1.6.9, SecurityGroupRule information element."; @@ -921,7 +956,10 @@ submodule etsi-nfv-common { default "ipv4"; description "Indicates the protocol carried over the Ethernet layer. - Permitted values: IPV4, IPV6. Defaults to IPV4."; + Values: + • IPV4 + • IPV6 + Defaults to IPV4."; reference "GS NFV IFA011: Section 7.1.6.9, SecurityGroupRule information element."; @@ -937,8 +975,13 @@ submodule etsi-nfv-common { description "Indicates the protocol carried over the IP layer. Permitted values: any protocol defined in the IANA - protocol registry, e.g. TCP, UDP, ICMP, etc. Defaults - to TCP."; + protocol registry. + Values: + • TCP + • UDP + • ICMP + • etc. + Defaults to TCP."; reference "GS NFV IFA011: Section 7.1.6.9, SecurityGroupRule information element."; diff --git a/src/yang/etsi-nfv-ns.yang b/src/yang/etsi-nfv-ns.yang index 67100d91d55eba5004920232f2940f699a129fc1..ae3cf1e19736251f9752643d0b817312bbeb70d5 100644 --- a/src/yang/etsi-nfv-ns.yang +++ b/src/yang/etsi-nfv-ns.yang @@ -62,8 +62,10 @@ submodule etsi-nfv-ns { leaf type { type affinity-type; description - "Specifies whether the rule is an affinity rule or an - anti-affinity rule."; + "Specifies the rule. + Values: + • AFFINITY + • ANTI_AFFINITY."; reference "GS NFV IFA014: Section 6.3.8.2, LocalAffinityOrAntiAffinityRule information element."; @@ -72,8 +74,13 @@ submodule etsi-nfv-ns { leaf scope { type affinity-scope; description - "Specifies the scope of the rule, possible values are - 'NFVI-PoP', 'NFVI-node' network-link-and-node etc."; + "Specifies the scope of the rule. + Values: + • NFVI_POP + • ZONE + • ZONE_GROUP + • NFVI_NODE + • etc."; reference "GS NFV IFA014: Section 6.3.8.2, LocalAffinityOrAntiAffinityRule information element."; @@ -173,27 +180,6 @@ submodule etsi-nfv-ns { "GS NFV IFA014: Section 6.2.2.2 Network Service Descriptor information element"; - leaf id { - type string; - description - "Identifier of this Cpd information element."; - reference - "GS NFV IFA014: Section 6.6.3.1 Cpd information element"; - } - - leaf address-assignment { - type boolean; - description - "Specify whether the SAP address assignment is under the - responsibility of management and orchestration functions - or not. If it is set to True, management and - orchestration functions are responsible for assigning - addresses to the access points instantiated from this - SAPD."; - reference - "GS NFV IFA014: Section 6.2.3.2 Sapd information element"; - } - choice cpd-or-virtual-link { leaf virtual-link-desc { type leafref { @@ -206,8 +192,8 @@ submodule etsi-nfv-ns { "GS NFV IFA014: Section 6.2.3.2 Sapd information element"; } - choice associated-cpd-id { - container vnf { + container associated-cpd { + choice constituent-base-element-id { leaf vnfd-id { mandatory true; type leafref { @@ -215,16 +201,6 @@ submodule etsi-nfv-ns { } must "boolean(../../../vnfd-id[.=current()])"; } - - leaf ext-cpd-id { - mandatory true; - type leafref { - path "deref(../vnfd-id)/../nfv:ext-cpd/nfv:id"; - } - } - } - - container pnf { leaf pnfd-id { mandatory true; type leafref { @@ -232,34 +208,68 @@ submodule etsi-nfv-ns { } must "boolean(../pnfd-id[.=current()])"; } - - leaf ext-cpd-id { + leaf nsd-id { mandatory true; type leafref { - path "deref(../pnfd-id)/../nfv:ext-cpd/nfv:id"; + path "../../../../nsd/id"; } + must "boolean(../nsd-id[.=current()])"; } + description + "References the profile of an NS constituent."; + reference + "GS NFV IFA014: Section 6.4.8 CpdInConstituentElement information element"; } - container ns { - leaf nsd-id { + choice constituent-cpd-id { + leaf vnf-ext-cpd { mandatory true; type leafref { - path "../../../../nsd/id"; + path "deref(../vnfd-id)/../nfv:ext-cpd/nfv:id"; } - must "boolean(../nsd-id[.=current()])"; } - - leaf ext-cpd-id { + leaf pnf-ext-cpd { + mandatory true; + type leafref { + path "deref(../pnfd-id)/../nfv:ext-cpd/nfv:id"; + } + } + leaf sapd { mandatory true; type leafref { path "deref(../nsd-id)/../sapd/id"; } } + description + "References the VNF external CPD for a given VnfProfile, or the PNF + external CPD for a given PnfProfile, or an NS SAPD for a given NsProfile + identified by the constituentBaseElementId."; + reference + "GS NFV IFA014: Section 6.4.8 CpdInConstituentElement information element"; } + description + "Describes a CPD or SAPD in the context of an NS constituent element, which + the SAPs instantiated from this SAPD are mapped to."; + reference + "GS NFV IFA014: Section 6.2.3 Sapd information element"; + + } + } + + uses cpd; + leaf security-group-rule-id { + type leafref { + path "../../security-group-rule/id"; } + description + "Reference of the security group rules bound to this + CPD."; + reference + "GS NFV IFA014: Section 6.6.3 Cpd information element"; } } + uses security-group-rule; + list virtual-link-desc { key "id"; description @@ -631,7 +641,7 @@ submodule etsi-nfv-ns { path "../../../nfp-position-element/id"; } description - "Reference to one or a pair of CPDs or SAPDs."; + "References one or a pair of CPDs or SAPDs."; reference "GS NFV IFA014: Section 6.4.5.2 NfpPositionDesc information element"; @@ -642,16 +652,20 @@ submodule etsi-nfv-ns { base forwarding-behaviour; } description - "Identifies a rule to apply to forward traffic to CP or - SAP instances corresponding to the referenced CPD(s) - and SAPD(s). The minimum list of rules to be supported + "Specifies a rule to apply to forward traffic to CP or + SAP instances corresponding to the referenced CP + profiles(s). The minimum list of rules to be supported shall include: • ALL = Traffic flows shall be forwarded simultaneously to all CP or SAP instances created from the referenced CP profile(s). • LB = Traffic flows shall be forwarded to one CP or SAP instance created from the referenced CP profile(s) - selected based on a load-balancing algorithm."; + selected based on a load-balancing algorithm + Values: + • ALL + • LB + • etc."; reference "GS NFV IFA014: Section 6.4.5.2 NfpPositionDesc information element"; @@ -758,7 +772,7 @@ submodule etsi-nfv-ns { leaf id { type string; description - "Identifier of this vnfProfile information element. It + "Identifier of this VnfProfile information element. It uniquely identifies a VnfProfile."; reference "GS NFV IFA014: Section 6.3.3.2 VnfProfile information @@ -783,7 +797,7 @@ submodule etsi-nfv-ns { path "deref(../vnfd-id)/../nfv:df/nfv:id"; } description - "Identifies a flavour within the VNFD."; + "References a flavour within the VNFD."; reference "GS NFV IFA014: Section 6.3.3.2 VnfProfile information element"; @@ -834,8 +848,8 @@ submodule etsi-nfv-ns { path "../../affinity-or-anti-affinity-group/id"; } description - "Identifier(s) of the affinity or anti-affinity - group(s) the VnfProfile belongs to."; + "Reference(s) the affinity or anti-affinity group(s) + the VnfProfile belongs to."; reference "GS NFV IFA014: Section 6.3.3.2 VnfProfile information element"; @@ -1043,7 +1057,7 @@ submodule etsi-nfv-ns { path "deref(../virtual-link-desc-id)/../df/id"; } description - "Identifies a flavour within the VLD."; + "Refernces a flavour within the VLD."; reference "GS NFV IFA014: Section 6.3.2.2 VirtualLinkProfile information element"; @@ -1056,9 +1070,9 @@ submodule etsi-nfv-ns { path "../../affinity-or-anti-affinity-group/id"; } description - "Identifies an affinity or anti-affinity group the - VLs instantiated according to the VlProfile belong - to."; + "Reference(s) the affinity or anti-affinity group(s) + the VLs instantiated according to the VlProfile + belong to."; reference "GS NFV IFA014: Section 6.3.4.2 VirtualLinkProfile information element"; @@ -1082,6 +1096,170 @@ submodule etsi-nfv-ns { information element"; uses link-bitrate-requirements; } + container virtual-link-protocol-data { + leaf associated-layer-protocol { + type identityref { + base layer-protocol; + } + description + "One of the values of the attribute layerProtocol of + the ConnectivityType IE. + Values: + • Ethernet + • MPLS + • ODU2 + • IPV4 + • IPV6 + • Pseudo-Wire + • etc."; + reference + "GS NFV IFA014: Section 6.3.13.2, + VirtualLinkProtocolData information element."; + } + + container l2-protocol-data { + when "(../associated-layer-protocol = 'Ethernet') or " + + "(../associated-layer-protocol = 'MPLS') or " + + "(../associated-layer-protocol = 'ODU2') or " + + "(../associated-layer-protocol = 'Pseudo-Wire')"; + + leaf name { + type string; + description + "Network name associated with this L2 protocol."; + reference + "GS NFV IFA014: Section 6.3.14.2, + L2ProtocolData information element."; + } + + leaf network-type { + type enumeration { + enum flat; + enum vlan; + enum vxlan; + enum gre; + } + description + "Specifies the network type for this L2 protocol. + Values: + • FLAT + • VLAN + • VXLAN + • GRE."; + reference + "GS NFV IFA014: Section 6.3.14.2, + L2ProtocolData information element."; + } + + leaf vlan-transparent { + type boolean; + description + "Specifies whether to support VLAN transparency for + this L2 protocol or not."; + reference + "GS NFV IFA014: Section 6.3.14.2, + L2ProtocolData information element."; + } + + leaf mtu { + type uint16; + description + "Specifies the maximum transmission unit (MTU) value + for this L2 protocol."; + reference + "GS NFV IFA014: Section 6.3.14.2, + L2ProtocolData information element."; + } + + leaf segmentation-id { + type string; + description + "If present, specifies a specific virtualised network + segment, which depends on the network type. For e.g., + VLAN ID for VLAN network type and tunnel ID for + GRE/VXLAN network types."; + reference + "GS NFV IFA014: Section 6.3.14.2, + L2ProtocolData information element."; + } + + description + "Specifies the L2 protocol data for this virtual link. + Shall be present when the associatedLayerProtocol + attribute indicates a L2 protocol and shall be absent + otherwise."; + reference + "GS NFV IFA014: Section 6.3.13.2, + VirtualLinkProtocolData information element."; + } + + container l3-protocol-data { + when "(../associated-layer-protocol = 'IPv4') or " + + "(../associated-layer-protocol = 'IPv6')"; + + leaf name { + type string; + description + "Network name associated with this L3 protocol."; + reference + "GS NFV IFA014: Section 6.3.15.2, + L3ProtocolData information element."; + } + + leaf ip-version { + type enumeration { + enum ipv4; + enum ipv6; + } + default "ipv4"; + description + "Specifies IP version of this L3 protocol. + Values: + • IPV4. + • IPV6."; + reference + "GS NFV IFA014: Section 6.3.15.2, + L3ProtocolData information element."; + } + + leaf cidr { + type string; + description + "Specifies the CIDR (Classless InterDomain Routing) + of this L3 protocol. + The network address and subnet mask in + cidr format."; + reference + "GS NFV IFA014: Section 6.3.15.2, + L3ProtocolData information element."; + } + + leaf-list ip-allocation-pools { + type string; + description + "Specifies the allocation pools with start and end + IP addresses for this L3 protocol."; + reference + "GS NFV IFA014: Section 6.3.15.2, + L3ProtocolData information element."; + } + description + "Specifies the L3 protocol data for this virtual link. + Shall be present when the associatedLayerProtocol + attribute indicates a L3 protocol and shall be absent + otherwise."; + reference + "GS NFV IFA014: Section 6.3.13.2, + VirtualLinkProtocolData information element."; + } + description + "Specifies the protocol data for a VL instantiated + according to this profile. Cardinality 0 is used when + no protocol data needs to be specified."; + reference + "GS NFV IFA014: Section 6.3.4.2 VirtualLinkProfile + information element"; + } } list scaling-aspect { @@ -1151,19 +1329,22 @@ submodule etsi-nfv-ns { leaf id { type string; description - "Identifier of Identifier of this - AffinityOrAntiAffinityGroup information element."; + "Identifier of this AffinityOrAntiAffinityGroup + information element."; reference "GS NFV IFA014: Section 6.3.5.2 AffinityOrAntiAffinity information element"; } - leaf type { + leaf affinityorAntiaffinity { mandatory true; type affinity-type; description "Specifies the type of relationship that the members of - the group have: 'affinity' or 'anti-affinity.'"; + the group have. + Values: + • AFFINITY + • ANTI-AFFINITY"; reference "GS NFV IFA014: Section 6.3.5.2 AffinityOrAntiAffinity information element"; @@ -1174,8 +1355,12 @@ submodule etsi-nfv-ns { type affinity-scope; description "Specifies the scope of the affinity or anti-affinity - relationship e.g. a NFVI node, an NFVI PoP, - network-link-and-node etc."; + relationship. + Values: + • NFVI_NODE + • NFVI_POP + • NETWORK_LINK_AND_NODE + • etc."; reference "GS NFV IFA014: Section 6.3.5.2 AffinityOrAntiAffinity information element"; @@ -1228,7 +1413,7 @@ submodule etsi-nfv-ns { path "../../../vnf-profile/id"; } description - "Identifies the profile to be used for a VNF + "References the profile to be used for a VNF involved in an NS level."; reference "GS NFV IFA014: Section 6.7.4.2 VnfToLevelMapping @@ -1262,7 +1447,7 @@ submodule etsi-nfv-ns { path "../../../virtual-link-profile/id"; } description - "Identifies the profile to be used for a VL involved + "References the profile to be used for a VL involved in an NS level."; reference "GS NFV IFA014: Section 6.7.5.2 @@ -1288,7 +1473,7 @@ submodule etsi-nfv-ns { path "../../../ns-profile/id"; } description - "Identifies the profile to be used for a nested NS + "References the profile to be used for a nested NS involved in the NS level."; reference "GS NFV IFA014: Section 6.7.6.2 NsToLevel information @@ -1330,7 +1515,7 @@ submodule etsi-nfv-ns { path "../ns-instantiation-level/id"; } description - "Identifies the NS level which represents the default NS + "References the NS level which represents the default NS instantiation level for this DF. It shall be present if there are multiple 'nsIinstantiationLevel' entries."; reference @@ -1417,7 +1602,7 @@ submodule etsi-nfv-ns { key "id"; description - "Specifies a NS Profile supported by this NS DF."; + "Specifies nested NS Profile to be used for this NS DF."; reference "GS NFV IFA014: Section 6.3.2.2 NsDf information element"; @@ -1436,7 +1621,7 @@ submodule etsi-nfv-ns { path "../../../../nsd/id"; } description - "Identifies the NSD applicable to NS instantiated + "References the NSD applicable to NS instantiated according to this profile."; reference "GS NFV IFA014: Section 6.3.11.2 NsProfile information @@ -1449,7 +1634,7 @@ submodule etsi-nfv-ns { path "deref(../nsd-id)/../df/id"; } description - "Identifies the applicable network service DF within + "References the applicable network service DF within the scope of the NSD."; reference "GS NFV IFA014: Section 6.3.11.2 NsProfile information @@ -1462,7 +1647,7 @@ submodule etsi-nfv-ns { path "deref(../ns-df-id)/../ns-instantiation-level/id"; } description - "Identifies the NS level within the referenced NS DF to + "References the NS level within the referenced NS DF to be used in the context of the parent NS instantiation. If not present, the default NS instantiation level as declared in the referenced NSD shall be used."; @@ -1500,8 +1685,8 @@ submodule etsi-nfv-ns { path "../../affinity-or-anti-affinity-group/id"; } description - "Identifies an affinity or anti-affinity group the NSs - created according to this NsProfile belongs to."; + "Reference(s) the affinity or anti-affinity group(s) the + NSs created according to this NsProfile belongs to."; reference "GS NFV IFA014: Section 6.3.11.2 NsProfile information element"; @@ -1585,7 +1770,10 @@ submodule etsi-nfv-ns { } } description - "References a VnfProfile or NsProfile."; + "References a VnfProfile or NsProfile for + describing dependencies between VNF and/or + nested NS instances in terms of primary + entities."; reference "GS NFV IFA014: Section 6.3.12.2 Dependencies information element"; @@ -1603,7 +1791,10 @@ submodule etsi-nfv-ns { } } description - "References a VnfProfile or NsProfile."; + "References a VnfProfile or NsProfile for + describing dependencies between VNF and/or + nested NS instances in terms of secondary + entities."; reference "GS NFV IFA014: Section 6.3.12.2 Dependencies information element"; @@ -1623,7 +1814,7 @@ submodule etsi-nfv-ns { path "/nfv:nfv/nfv:vnfd/nfv:id"; } description - "Identifies a VNFD."; + "References a VNFD."; reference "GS NFV IFA014: Section 6.2.7.2 VnfIndicatorData information element"; @@ -1635,7 +1826,7 @@ submodule etsi-nfv-ns { path "deref(../vnfd-id)/../nfv:indicator/nfv:id"; } description - "Identifies a VNF indicator within the VNFD."; + "References a VNF indicator within the VNFD."; reference "GS NFV IFA014: Section 6.2.7.2 VnfIndicatorData information element"; @@ -1694,6 +1885,22 @@ submodule etsi-nfv-ns { } } + leaf priority { + type uint32; + description + "Specifies the priority for the NS instance. + + The allowed range will be reasonably high. The 'zero' + value will express the highest priority and the fact + that the NS instance based on this DF cannot be + pre-empted during resource allocation. + + Examples for the usage of priority include conflict + resolution in case of resource shortage."; + reference + "GS NFV IFA014: Section 6.3.2.2 NsDf information element"; + } + leaf service-availability-level { type uint32; description diff --git a/src/yang/etsi-nfv-vnf.yang b/src/yang/etsi-nfv-vnf.yang index 6b5f2dc9374bf377237e2b22f39e3dabf34693f4..843a49eb4bc248ac7e7553ce8f6764e8449e4473 100755 --- a/src/yang/etsi-nfv-vnf.yang +++ b/src/yang/etsi-nfv-vnf.yang @@ -194,7 +194,10 @@ submodule etsi-nfv-vnf { type affinity-type; description "Specifies whether the rule is an affinity rule or an - anti-affinity rule."; + anti-affinity rule + Values + • affinity + • anti-affinity."; reference "GS NFV IFA011: Section 7.1.8.11, LocalAffinityOrAntiAffinityRule information element."; @@ -203,9 +206,13 @@ submodule etsi-nfv-vnf { leaf scope { type affinity-scope; description - "Specifies the scope of the rule. Possible values are - 'NFVI-PoP', 'Zone', 'ZoneGroup', 'NFVI-node', and - 'network-link-and-node'."; + "Specifies the scope of the rule. + Values: + • NFVI-PoP + • Zone + • ZoneGroup + • NFVI-node + • network-link-and-node."; reference "GS NFV IFA011: Section 7.1.8.11, LocalAffinityOrAntiAffinityRule information element."; @@ -436,7 +443,8 @@ submodule etsi-nfv-vnf { "Describes the type of the virtual network interface realizing the CPs instantiated from this CPD. This is used to determine which mechanism driver(s) to be used - to bind the port. Value: + to bind the port. + Values: • NORMAL • VIRTIO • DIRECT @@ -586,6 +594,85 @@ submodule etsi-nfv-vnf { "GS NFV IFA011: Section 7.1.6.7, VnfcConfigurableProperties Information element."; } + + list trunk-port { + key "parent-port-cpd"; + description + "Specifies the logical topology between an intCpd in + trunk mode, used to describe a trunk port, and other + intCpds used to describe subports of the same trunk. + + Cardinality 0 is used when there is no intCpd with + trunkmode = True, or when no individual intCpds to + describe the subports are included in the Vdu."; + reference + "GS NFV IFA011: Section 7.1.6.2, Vdu information element"; + + leaf parent-port-cpd { + type leafref { + path "../../int-cpd/id"; + } + description + "Reference of the internal VDU CPD which is used to + instantiate the parent port in a logical trunk model."; + reference + "GS NFV IFA011: Section 7.1.6.11, Information elements + related to TrunkPort Topology."; + } + + list sub-port-list { + key "sub-port-cpd"; + description + "Provides information used for the subport."; + reference + "GS NFV IFA011: Section 7.1.6.11, Information elements + related to subport of a trunk parent port."; + + leaf sub-port-cpd{ + type leafref { + path "../../../int-cpd/id"; + } + description + "Reference of the internal VDU CPD which is used + to instantiate the subport in a logical trunk model."; + reference + "GS NFV IFA011: Section 7.1.6.12, Information elements + related to subport of a trunk parent port."; + } + leaf segmentation-type { + default "vlan"; + type enumeration { + enum "vlan"; + enum "inherit"; + } + description + "Specifies the encapsulation type for the traffics + coming in and out of the trunk subport. + Values: + • VLAN: the subport uses VLAN as encapsulation type. + • INHERIT: the subport gets its segmentation type + from the network it’s connected to. + + Cardinality 0 means default value VLAN is used."; + reference + "GS NFV IFA011: Section 7.1.6.12, Information elements + related to to subport of a trunk parent port."; + } + leaf segmentation-id { + type uint32; + description + "Specifies the segmentation ID for the subport, which is + used to differentiate the traffics on different networks + coming in and out of the trunk port. If a value is provided + here it may be overridden by a value provided at run time + when the infrastructure doesn’t support mapping of + segmentation IDs."; + reference + "GS NFV IFA011: Section 7.1.6.12, Information elements + related to subport of a trunk parent port."; + } + } + } } list virtual-compute-desc { @@ -866,7 +953,10 @@ submodule etsi-nfv-vnf { enum "dynamic"; } description - "The policy can take values of 'static' or 'dynamic'. + "Indicates the policy for CPU pinning. + Values: + • static + • dynamic In case of 'static' the virtual CPU cores are requested to be allocated to logical CPU cores according to the rules defined in @@ -890,29 +980,13 @@ submodule etsi-nfv-vnf { type string; } description - "A list of rules that should be considered during the + "List of rules that should be considered during the allocation of the virtual CPUs to logical CPUs in case of 'static' virtualCpuPinningPolicy."; reference "GS NFV IFA011: Section 7.1.9.2.4, VirtualCpuPinningData information element."; } - - leaf-list cpu-policy { - type enumeration { - enum "dedicated"; - enum "shared"; - } - description - "Shows the list of dedicated virtual CPU cores and - shared virtual CPU cores in a VM. Dedicated refers to - a virtual CPU core occupies one physical CPU core. - Shared refers to multi virtual CPU cores shared one - physical CPU core."; - reference - "GS NFV IFA011: Section 7.1.9.2.4, - VirtualCpuPinningData information element."; - } description "The virtual CPU pinning configuration for the virtualised compute resource."; @@ -963,8 +1037,11 @@ submodule etsi-nfv-vnf { } default "nfv:block"; description - "Type of virtualised storage resource (BLOCK, OBJECT, - FILE)."; + "Type of virtualised storage resource + Values: + • BLOCK + • OBJECT + • FILE."; reference "GS NFV IFA011: Section 7.1.9.4, Information elements related to Virtual Storage."; @@ -1532,8 +1609,9 @@ submodule etsi-nfv-vnf { key "id"; leaf-list int-cpd { + min-elements 1; type leafref { - path "../../vdu/int-cpd/int-virtual-link-desc"; + path "../../vdu/int-cpd/id"; } description "Reference to the internal VDU CPD which is used to @@ -1541,20 +1619,30 @@ submodule etsi-nfv-vnf { virtual IP addresses allocated when a VipCp instance is created from the VipCpd."; reference - "GS NFV IFA011: Section 7.1.x, VipCpd information element."; + "GS NFV IFA011: Section 7.1.17.2, VipCpd information element."; } - leaf-list vnf-ext-cpd { + leaf int-virtual-link-desc { type leafref { - path "../../ext-cpd/id"; + path "../../int-virtual-link-desc/id"; } description - "Reference to the VNF external CPD which is used to - instantiate external CPs. These external CPs share the - virtual IP addresses allocated when a VipCp instance is - created from the VipCpd."; + "Reference of the internal VLD which this VipCpd + connects to"; + reference + "GS NFV IFA011: Section 7.1.17.2 VipCpd information element."; + } + + leaf dedicated-ip-address { + type boolean; + description + "If set to true, it indicates that the VIP address + shall be different from the addresses allocated to + all of the VduCp instances associated to it. + If set to false, the VIP address shall be the same + as one of the VduCp instances associated to it."; reference - "GS NFV IFA011: Section 7.1.x, VipCpd information element."; + "GS NFV IFA011: Section 7.1.17.2 VipCpd information element."; } leaf vip-function { @@ -1563,16 +1651,19 @@ submodule etsi-nfv-vnf { } description "It indicates the function the virtual IP address is used - for. Permitted values: high availability, load balancing."; + for. + Values: + • high availability + • load balancing."; reference - "GS NFV IFA011: Section 7.1.x, VipCpd information element."; + "GS NFV IFA011: Section 7.1.17.2, VipCpd information element."; } uses cpd; description "Describes virtual IP addresses to be shared among instances - of connection points. See clause 7.1.x."; + of connection points. See clause 7.1.17."; reference "GS NFV IFA011: Section 7.1.2, VNFD information element."; } @@ -1651,7 +1742,7 @@ submodule etsi-nfv-vnf { path "../../affinity-or-anti-affinity-group/id"; } description - "Identifier(s) of the affinity or anti-affinity + "References of the affinity or anti-affinity group(s) the VDU belongs to."; reference "GS NFV IFA011: Section 7.1.8.3, VduProfile information @@ -1708,7 +1799,7 @@ submodule etsi-nfv-vnf { path "../../affinity-or-anti-affinity-group/id"; } description - "Identifier(s) of the affinity or anti-affinity + "References of the affinity or anti-affinity group(s) the VnfVirtualLinkDesc belongs to."; reference "GS NFV IFA011: Section 7.1.8.4, VirtualLinkProfile @@ -1784,7 +1875,13 @@ submodule etsi-nfv-vnf { } description "One of the values of the attribute layerProtocol of - the ConnectivityType IE."; + the ConnectivityType IE + Values: + • Ethernet + • MPLS + • ODU2 + • Pseudo-Wire + • etc."; reference "GS NFV IFA011: Section 7.1.8.13, VirtualLinkProtocolData information element."; @@ -1814,7 +1911,11 @@ submodule etsi-nfv-vnf { } description "Specifies the network type for this L2 protocol. - Possible values: FLAT, VLAN, VXLAN, GRE."; + Values: + • FLAT + • VLAN + • VXLAN + • GRE."; reference "GS NFV IFA011: Section 7.1.8.14, L2ProtocolData information element."; @@ -1883,8 +1984,8 @@ submodule etsi-nfv-vnf { default "ipv4"; description "Specifies IP version of this L3 protocol. - Value: - • IPV4. + Values: + • IPV4 • IPV6."; reference "GS NFV IFA011: Section 7.1.8.15, @@ -1941,10 +2042,11 @@ submodule etsi-nfv-vnf { enum dhcpv6-stateless; } description - "Specifies IPv6 address mode. Possible values: - • SLAAC. - • DHCPV6-STATEFUL. - • DHCPV6-STATELESS. + "Specifies IPv6 address mode. + Values: + • SLAAC + • DHCPV6-STATEFUL + • DHCPV6-STATELESS May be present when the value of the ipVersion attribute is 'IPV6' and shall be absent otherwise."; reference @@ -1970,6 +2072,52 @@ submodule etsi-nfv-vnf { } } + list vip-cp-profile { + key "id"; + description + "Defines the minimum and maximum number of VIP CP instances + created from each of the VipCpds used in this flavour. + Shall be present if the deployment flavour can contain + VIP CP instances."; + reference + "GS NFV IFA011: Section 7.1.8.2, VnfDf information + element."; + + leaf id { + type leafref { + path "../../../vip-cpd/id"; + } + description + "Uniquely references a VIP CPD."; + reference + "GS NFV IFA011: Section 7.1.8.20, VipCpProfile information + element."; + } + + leaf min-number-of-instances { + type uint16; + description + "Minimum number of instances of the VIP CP based on the + referenced VIP CPD that is permitted to exist for this + flavour. Shall be zero or greater."; + reference + "GS NFV IFA011: Section 7.1.8.20, VipCpProfile information + element."; + } + + leaf max-number-of-instances { + type uint16; + description + "Maximum number of instances of the VIP CP based on the + referenced VIP CPD that is permitted to exist for this + flavour. Shall be greater than zero and not less than + the value of 'minNumberOfInstances'."; + reference + "GS NFV IFA011: Section 7.1.8.20, VipCpProfile information + element."; + } + } + list instantiation-level { key "id"; min-elements 1; @@ -2047,6 +2195,45 @@ submodule etsi-nfv-vnf { } } + list vip-cp-level { + key "id"; + description + "Indicates the number of VIP CP instances based on + a particular VipCpd to be part of this level. + + If a particular VipCpd is defined with + minNumberOfInstances= maxNumberOfInstances=1 in the + vipCpProfile of the DF, that vipCpd may be omitted + from the 'vipCpLevel' attribute, which shall be + interpreted that one related VIP CP instance is + part of this level."; + reference + "GS NFV IFA011: Section 7.1.8.7, InstantiationLevel information + element."; + + leaf id { + type leafref { + path "../../../../vip-cpd/id"; + } + description + "Uniquely references a VIP CPD."; + reference + "GS NFV IFA011: Section 7.1.10.6, VipCpLevel information + element."; + } + + leaf number-of-instances { + type uint16; + description + "Number of VIP CP instances based on the referenced + VipCpd to deploy for an instantiation level or for + a scaling delta. Shall be zero or greater."; + reference + "GS NFV IFA011: Section 7.1.10.6, VipCpLevel information + element."; + } + } + list scaling-info { key "scaling-aspect-id"; description @@ -2085,10 +2272,10 @@ submodule etsi-nfv-vnf { path "../instantiation-level/id"; } description - "This attribute references the 'instantiationLevel' - entry which defines the default instantiation level for - this DF. It shall be present if there are multiple - 'instantiationLevel' entries."; + "References the 'instantiationLevel' entry which defines + the default instantiation level for this DF. It shall be + present if there are multiple 'instantiationLevel' + entries."; reference "GS NFV IFA011: Section 7.1.8.2 VnfDf information element"; @@ -2102,7 +2289,13 @@ submodule etsi-nfv-vnf { "Indicates which operations are available for this DF via the VNF LCM interface. Instantiate VNF, Query VNF and Terminate VNF are supported in all DF and therefore - need not be included in this list."; + need not be included in this list. + Values: + • Scale VNF + • Scale VNF to level + • Heal VNF + • Operate VNF + • etc."; reference "GS NFV IFA011: Section 7.1.8.2 VnfDf information element"; @@ -2473,7 +2666,8 @@ submodule etsi-nfv-vnf { } } - container change-current-vnf-package-op-config { + list change-current-vnf-package-op-config { + key "id"; description "Configuration parameters for the ChangeCurrentVnfPackageOpConfig operation."; @@ -2481,6 +2675,16 @@ submodule etsi-nfv-vnf { "GS NFV IFA011: Section 7.1.5.2 VnfLcmOperationsConfiguration information element"; + leaf id { + type string; + description + "Identifier of this parameter set for later referencing."; + reference + "GS NFV IFA011: Section 7.1.5.13 + ChangeCurrentVnfPackageOpConfig information + element"; + } + list parameter { key "key"; @@ -2535,12 +2739,15 @@ submodule etsi-nfv-vnf { AffinityOrAntiAffinityGroup information element"; } - leaf type { + leaf affinityorAntiaffinity { mandatory true; type affinity-type; description "Specifies the type of relationship that the members of - the group have: 'affinity' or 'anti-affinity'."; + the group have. + Values: + • AFFINITY + • ANTI-AFFINITY"; reference "GS NFV IFA011: Section 7.1.8.12 AffinityOrAntiAffinityGroup information element"; @@ -2551,8 +2758,13 @@ submodule etsi-nfv-vnf { type affinity-scope; description "Specifies the scope of the affinity or anti-affinity - relationship. Possible values are 'NFVI-PoP', 'Zone', - 'ZoneGroup', 'NFVI-node' and 'network-link-and-node'."; + relationship. + Values: + • NFVI-PoP + • Zone + • ZoneGroup + • NFVI-node + • network-link-and-node"; reference "GS NFV IFA011: Section 7.1.8.12 AffinityOrAntiAffinityGroup information element"; @@ -2597,11 +2809,11 @@ submodule etsi-nfv-vnf { enum both; } description - "Describe the source of the indicator. The possible - values are: - • VNF. - • EM. - • Both. + "Describe the source of the indicator. + Values: + • VNF + • EM + • Both This tells the consumer where to send the subscription request."; @@ -2628,11 +2840,11 @@ submodule etsi-nfv-vnf { enum vnf-lcm-coordination; } description - "Identifies an interface produced by the VNF. Valid - values: - - VNF_CONFIGURATION - - VNF_INDICATOR - - VNF_LCM_COORDINATION"; + "Identifies an interface produced by the VNF. + Values: + • VNF_CONFIGURATION + • VNF_INDICATOR + • VNF_LCM_COORDINATION"; reference "GS NFV IFA011: Section 7.1.8.16 VnfInterfaceDetails information element"; @@ -2672,6 +2884,68 @@ submodule etsi-nfv-vnf { element"; } + list supported-coordination-actions { + key "vnf-lcm-operation"; + + description + "References applicable LCM coordination actions + that can be invoked during each of the listed + VNF LCM operations."; + reference + "GS NFV IFA011: Section 7.1.8.2 VnfDf information + element"; + + leaf vnf-lcm-operation { + type enumeration { + enum "instantiate"; + enum "scale"; + enum "scale_to_level"; + enum "change_flavour"; + enum "terminate"; + enum "heal"; + enum "operate"; + enum "change_ext_conn"; + enum "modify_info"; + enum "create_snapshot"; + enum "revert_to_snapshot"; + } + description + "Identifies the specific VNF LCM operation. + Values: + • INSTANTIATE + • SCALE + • SCALE_TO_LEVEL + • CHANGE_FLAVOUR + • TERMINATE + • HEAL + • OPERATE + • CHANGE_EXT_CONN + • MODIFY_INFO + • CREATE_SNAPSHOT + • REVERT_TO_SNAPSHOT."; + reference + "GS NFV IFA011: Section 7.1.16.3 LcmCoordinationActionMapping + information element"; + } + leaf coordination-action-name { + type leafref { + path "../../../lcm-operations-coordination/coordination-action-name"; + } + description + "References to the names of coordination actions that can be + invoked during the LCM operation indicated by the + 'vnfLcmOperation' attribute. + + The related coordination actions shall either be declared + in the VnfLcmOperationCoordination information element + in the same VNFD, or shall be well-known standardized + coordination action name identifiers."; + reference + "GS NFV IFA011: Section 7.1.16.3 LcmCoordinationActionMapping + information element"; + } + } + list monitoring-parameter { key "id"; @@ -2846,6 +3120,38 @@ submodule etsi-nfv-vnf { "GS NFV IFA011: Section 7.1.10.4 ScalingDelta information element"; } + + list vip-cp-delta { + key "id"; + description + "Number of VIP CP instances based on a particular + VipCpd to be created or removed."; + reference + "GS NFV IFA011: Section 7.1.10.4, ScalingDelta information + element."; + + leaf id { + type leafref { + path "../../../../../../vip-cpd/id"; + } + description + "Uniquely references a VIP CPD."; + reference + "GS NFV IFA011: Section 7.1.10.6, VipCpLevel information + element."; + } + + leaf number-of-instances { + type uint16; + description + "Number of VIP CP instances based on the referenced + VipCpd to deploy for an instantiation level or for + a scaling delta. Shall be zero or greater."; + reference + "GS NFV IFA011: Section 7.1.10.6, VipCpLevel information + element."; + } + } description "Declares different scaling deltas, each of which is applied for one or more scaling steps of this @@ -2890,6 +3196,44 @@ submodule etsi-nfv-vnf { information element"; } } + + list dependencies { + key "id"; + + description + "Specifies the order in which instances of the VNFCs + have to be created."; + reference + "GS NFV IFA011: Section 7.1.8.2 VnfDf information element"; + + leaf id { + type string; + } + + leaf primary-id { + type leafref { + path "../../vdu-profile/id"; + } + description + "References a VduProfile for describing dependencies + between VNFCs in terms of primary entities."; + reference + "GS NFV IFA011: Section 7.1.8.19 Dependencies + information element"; + } + + leaf secondary-id { + type leafref { + path "../../vdu-profile/id"; + } + description + "References a VduProfile for describing dependencies + between VNFCs in terms of secondary entities."; + reference + "GS NFV IFA011: Section 7.1.8.19 Dependencies + information element"; + } + } } container configurable-properties { @@ -3407,7 +3751,7 @@ submodule etsi-nfv-vnf { leaf additional-params-id { type leafref { path "../../df/lcm-operations-configuration/" + - "change-current-vnf-package-op-config/parameter/key"; + "change-current-vnf-package-op-config/id"; } description "References the ChangeCurrentVnfPackageOpConfig information @@ -3429,12 +3773,12 @@ submodule etsi-nfv-vnf { description "When present, it specifies the type of modification resulting from transitioning from srcVnfdId to dstVnfdId. - The possible values include at least: + Values: - UP - indicating that the destination VNF version is newer - than the source version, - DOWN - indicating that the destination VNF version is - older than the source version. + • UP:indicating that the destination VNF version is newer + than the source version, + • DOWN:indicating that the destination VNF version is + older than the source version. When provided, UP and DOWN values shall always be supported as the first value. In addition, a vendor may @@ -3523,13 +3867,14 @@ submodule etsi-nfv-vnf { information element"; } - leaf coordination-id { + leaf coordination-action-name { type leafref { - path "../../lcm-operations-coordination/id"; + path "../../lcm-operations-coordination/coordination-action-name"; } description - "Reference to applicable VNF LCM operation coordination - actions."; + "Reference to applicable VNF LCM operation coordination actions + that can be invoked during a VNF package change as defined by + the 'selector' attribute."; reference "GS NFV IFA011: Section 7.1.15.2 VnfPackageChangeInfo information element"; @@ -3558,13 +3903,13 @@ submodule etsi-nfv-vnf { } list lcm-operations-coordination { - key "id"; + key "coordination-action-name"; - leaf id { + leaf coordination-action-name { type string; description "Identifies the specific VNF LCM operation coordination - action."; + action.Shall be unique within the scope of VNFD"; reference "GS NFV IFA011: Section 7.1.16.2 VnfLcmOperationCoordination information element"; @@ -3588,9 +3933,9 @@ submodule etsi-nfv-vnf { "Specifies the type of the endpoint exposing the LCM operation coordination such as other operations supporting or management systems (e.g. an EM) or the VNF instance. - Allowed values: + Values: • MGMT: coordination with other operation supporting - management systems. + management systems • VNF: coordination with the VNF instance."; reference "GS NFV IFA011: Section 7.1.16.2 VnfLcmOperationCoordination @@ -3598,24 +3943,67 @@ submodule etsi-nfv-vnf { } leaf coordination-stage { - type string; + type enumeration { + enum "start"; + enum "end"; + } + description + "Indicates whether the coordination action is invoked before + or after all other changes performed by the VNF LCM + operation. + Values: + • START:the coordination action is invoked after receiving + the grant and before the LCM operation performs any + other changes. + • END:the coordination action is invoked after the LCM + operation has performed all other changes. + + This attribute shall be omitted if the coordination action + is intended to be invoked at an intermediate stage of the + LCM operation, i.e. neither at the start nor at the end. + In this case, the actual instant during the LCM operation + when invoking the coordination is determined by means outside + the scope of the present document such as VNFM-internal logic + or LCM script."; + reference + "GS NFV IFA011: Section 7.1.16.2 VnfLcmOperationCoordination + information element"; + } + + list input-parameter { + key "key"; + + leaf key { + type string; + } + leaf value { + type string; + } description - "Indicates the coordination stage during the VNF LCM - operation."; + "Input parameter needed by the external coordinating + entity."; reference "GS NFV IFA011: Section 7.1.16.2 VnfLcmOperationCoordination information element"; } - leaf coordination-params { - type string; + list output-parameter { + key "key"; + + leaf key { + type string; + } + leaf value { + type string; + } description - "Input information needed by the external coordinating + "Output parameter provided by the external coordinating entity."; reference "GS NFV IFA011: Section 7.1.16.2 VnfLcmOperationCoordination information element"; } + description "Provides information used for the coordination in VNF LCM operations.";