etsi-nfv-ns.yang 49.4 KB
Newer Older
            "GS NFV IFA014: Section 6.3.2.2 VirtualLinkProfile
             information element";
        }
        uses local-affinity-or-anti-affinity-rule;

        list affinity-or-anti-affinity-group {
          key "id";

          description
            "Identifies an affinity or anti-affinity group the
             VLs instantiated according to the VlProfile belong
             to.";
          reference
            "GS NFV IFA014: Section 6.3.4.2 VirtualLinkProfile
             information element";

          leaf id {
            type leafref {
              path "../../../affinity-or-anti-affinity-group/id";
        container max-bitrate-requirements {
          description
            "Specifies the maximum bitrate requirements for a VL
             instantiated according to this profile.";
          reference
            "GS NFV IFA014: Section 6.3.4.2 VirtualLinkProfile
             information element";
          uses link-bitrate-requirements;
        }
        container min-bitrate-requirements {
          description
            "Specifies the minimum bitrate requirements for a VL
             instantiated according to this profile.";
          reference
            "GS NFV IFA014: Section 6.3.4.2 VirtualLinkProfile
             information element";
          uses link-bitrate-requirements;
        }
      }
      list scaling-aspect {
        key "id";
        description
          "The scaling aspects supported by this DF of the NS.";
        reference
          "GS NFV IFA014: Section 6.3.2.2 NsDf information element";

        leaf id {
          type string;
          description
            "Identifier of this NsScalingAspect information element.
             It uniquely identifies the NS scaling aspect in an
             NSD.";
          reference
            "GS NFV IFA014: Section 6.7.2.2 NsScalingAspect
             information element";
        leaf name {
          type string;
          description
            "Provides a human readable name of the NS scaling
             aspect.";
          reference
            "GS NFV IFA014: Section 6.7.2.2 NsScalingAspect
             information element";
        }
        leaf description {
          type string;
            "Provides a human readable description of the NS
             scaling aspect.";
            "GS NFV IFA014: Section 6.7.2.2 NsScalingAspect
             information element";
        }
        leaf scaling-level {
          type leafref {
            path "../../ns-instantiation-level/id";
          description
            "Describes the details of an NS level.";
          reference
            "GS NFV IFA014: Section 6.7.2.2 NsScalingAspect
             information element";
        }
      }
      list affinity-or-anti-affinity-group {
        key "id";
        description
          "Specifies affinity or anti-affinity relationship
           applicable between the VNF instances created using
           different VNFDs, the Virtual Link instances created
           using different NsVirtualLinkDescs or the nested NS
           instances created using different NSDs in the same
           affinity or anti-affinity group.";
        reference
          "GS NFV IFA014: Section 6.3.2.2 NsDf information element";
        leaf id {
          type string;
          description
            "Identifier of Identifier of this
             AffinityOrAntiAffinityGroup information element.";
          reference
            "GS NFV IFA014: Section 6.3.5.2 AffinityOrAntiAffinity
             information element";
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
        leaf type {
          mandatory true;
          type affinity-type;
          description
            "Specifies the type of relationship that the members of
             the group have: 'affinity' or 'anti-affinity.'";
          reference
            "GS NFV IFA014: Section 6.3.5.2 AffinityOrAntiAffinity
             information element";
        }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
        leaf scope {
          mandatory true;
          type affinity-scope;
            "Specifies the scope of the affinity or anti-affinity
             relationship e.g. a NFVI node, an NFVI PoP, etc.";
            "GS NFV IFA014: Section 6.3.5.2 AffinityOrAntiAffinity
             information element";
        }
      }
      list ns-instantiation-level {
        min-elements 1;
        key "id";
        description
          "Describes the details of an NS level.";
        reference
          "GS NFV IFA014: Section 6.3.2.2 NsDf information element
           GS NFV IFA014: Section 6.7.2.2 NsScaling information
           element";

        leaf id {
          type string;
          description
            "Identifier of this NsLevel information element. It
             uniquely identifies an NS level within the DF.";
          reference
            "GS NFV IFA014: Section 6.3.9.2 NsLevel information
             element";
        }

        leaf description {
          type string;
          description
            "Human readable description of the NS level.";
          reference
            "GS NFV IFA014: Section 6.3.9.2 NsLevel information
             element";
        }

        list vnf-to-level-mapping {
          key "vnf-profile-id";

          description
            "Specifies the profile of the VNFs involved in this NS
             level and, for each of them, the required number of
             instances.";
          reference
            "GS NFV IFA014: Section 6.3.9.2 NsLevel information
             element";

          leaf vnf-profile-id {
            type leafref {
              path "../../../vnf-profile/id";
            }
              "Identifies the profile to be used for a VNF
               involved in an NS level.";
              "GS NFV IFA014: Section 6.7.4.2 VnfToLevelMapping
               information element";
          leaf number-of-instances {
            default 1;
            type uint32;
              "Specifies the number of VNF instances required for
               an NS level.";
              "GS NFV IFA014: Section 6.7.4.2 VnfToLevelMapping
               information element";
        list virtual-link-to-level-mapping {
          key "virtual-link-profile-id";
            "Specifies the profile of the VLs involved in this NS
             level and, for each of them, the needed bandwidth.";
            "GS NFV IFA014: Section 6.3.9.2 NsLevel information
          leaf virtual-link-profile-id {
            type leafref {
              path "../../../virtual-link-profile/id";
            }
              "Identifies the profile to be used for a VL involved
               in an NS level.";
              "GS NFV IFA014: Section 6.7.5.2
               VirtualLinkToLevelMapping information element";
          uses link-bitrate-requirements;
        }

        list ns-to-level-mapping {
          key "ns-profile-id";
          description
            "Specifies the profile of the nested NSs involved in
             this NS level and, for each of them, the required
             number of instances.";
          reference
            "GS NFV IFA014: Section 6.3.9.2 NsLevel information
             element";
          leaf ns-profile-id {
            type leafref {
              path "../../../ns-profile/id";
            }
              "Identifies the profile to be used for a nested NS
               involved in the NS level.";
              "GS NFV IFA014: Section 6.7.6.2 NsToLevel information
          leaf number-of-instances {
            default 1;
            type uint32;
              "Specifies the number of nested NS instances required
               for the NS scale level.";
              "GS NFV IFA014: Section 6.7.6.2 NsToLevel information
        must "(count(vnf-to-level-mapping) + " +
             "count(virtual-link-to-level-mapping) + " +
             "count(ns-to-level-mapping)) > 0" {
          error-message
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
            "At least one attribute between " +
            "vnf-to-level-mapping, " +
            "virtual-link-to-level-mapping and " +
            "ns-to-level-mapping shall be present.";
          description
            "At least one attribute between vnfToLevelMapping,
             vlirtualLinkToLevelMapping and nsToLevelMapping shall
             be present.";
          reference
            "GS NFV IFA014: Section 6.3.9.2 NsLevel information
             element";
        }
      }
      leaf default-instantiation-level {
        type leafref {
          path "../ns-instantiation-level/id";
        }
        description
          "Identifies the NS level which represents the default NS
           instantiation level for this DF. It shall be present if
           there are multiple 'nsIinstantiationLevel' entries.";
        reference
          "GS NFV IFA014: Section 6.3.2.2 NsDf information element";
      }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
      container ns-lcm-additional-params {
        container instantiate {
          list params {
            key "key";

            leaf key {
              type string;
            }

            leaf value {
              type string;
            }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
            description
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
              "Array of KVP requirements for additional parameters
               of NS to be passed when invoking the Instantiate Ns
               operation.";
            reference
              "GS NFV IFA014: Section 6.2.10.3
               InstantiateNsAdditionalParams information element";
          }
        }

        container scale {
          list params {
            key "key";

            leaf key {
              type string;
            }

            leaf value {
              type string;
            }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
            description
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
              "Array of KVP requirements for additional parameters
               of NS to be passed when invoking the Scale Ns
               operation.";
            reference
              "GS NFV IFA014: Section 6.2.10.4
               ScaleNsAdditionalParams information element";
          }
        }

        container heal {
          list params {
            key "key";

            leaf key {
              type string;
            }

            leaf value {
              type string;
            }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
            description
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
              "Array of KVP requirements for additional parameters
               of NS to be passed when invoking the Heal Ns
               operation.";
            reference
              "GS NFV IFA014: Section 6.2.10.5
               HealNsAdditionalParams information element";
          }
        }
      }

      list ns-profile {
        must "min-number-of-instances <= max-number-of-instances" {
          error-message
            "min-number-of-instances has to be less than or equal" +
            "max-number-of-instances.";
        }
        must "boolean(../../nested-nsd-id[.=current()/nsd-id])" {
          error-message
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
            "PNFDs in the profile has to be listed as a " +
            "dependency of the network service " +
            "descriptor.";
        }
        key "id";
        description
          "Specifies a NS Profile supported by this NS DF.";
        reference
          "GS NFV IFA014: Section 6.3.2.2 NsDf information element";
        leaf id {
          type string;
          description
            "Identifies an NS profile.";
          reference
            "GS NFV IFA014: Section 6.3.11.2 NsProfile information
             element";
        }
        leaf nsd-id {
          mandatory true;
          type leafref {
            path "../../../../nsd/id";
          description
            "Identifies the NSD applicable to NS instantiated
             according to this profile.";
          reference
            "GS NFV IFA014: Section 6.3.11.2 NsProfile information
             element";
        }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
        leaf ns-df-id {
          mandatory true;
          type leafref {
            path "deref(../nsd-id)/../df/id";
          description
            "Identifies the applicable network service DF within
             the scope of the NSD.";
          reference
            "GS NFV IFA014: Section 6.3.11.2 NsProfile information
             element";
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
        leaf instantiation-level-id {
          mandatory true;
          type leafref {
            path "deref(../ns-df-id)/../ns-instantiation-level/id";
            "Identifies 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.";
            "GS NFV IFA014: Section 6.3.11.2 NsProfile information
             element";
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
        leaf min-number-of-instances {
          type uint16;
          default 1;
          description
            "Minimum number of nested NS instances based on the
             referenced NSD that is permitted to exist for this
             NsProfile.";
          reference
            "GS NFV IFA014: Section 6.3.11.2 NsProfile information
             element";
        }

Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
        leaf max-number-of-instances {
          type uint16;
          default 1;
          description
            "Maximum number of nested NS instances based on the
             referenced NSD that is permitted to exist for this
             NsProfile.";
          reference
            "GS NFV IFA014: Section 6.3.11.2 NsProfile information
             element";
        }

        list affinity-or-anti-affinity-group-id {
            "Identifies an affinity or anti-affinity group the NSs
             created according to this NsProfile belongs to.";
            "GS NFV IFA014: Section 6.3.11.2 NsProfile information
             element";
            type leafref {
              path "../../../affinity-or-anti-affinity-group/id";
        }

        list virtual-link-connectivity {
          key "virtual-link-profile-id";

          leaf virtual-link-profile-id {
            type leafref {
              path "../../../virtual-link-profile/id";
              "Reference an NS VL profile.";
              "GS NFV IFA014: Section 6.3.7.2, NsVirutalLinkConnectivity
               information element.";
          list constituent-cpd-id {
            key "constituent-base-element-id";
              "Describes a connection point on a VNF/PNF or a SAP
               which connects to virtual links instantiated from
               the profile identified in the virtualLinkProfileId
               attribute.";
              "GS NFV IFA014: Section 6.3.7
               NsVirtualLinkConnectivity information element";
            leaf constituent-base-element-id {
              type leafref {
                path "../../../id";
              description
                "Reference to the profile of an NS constituent.";
              reference
                "GS NFV IFA014: Section 6.4.8
                 CpdInConstituentElement information element";
            leaf constituent-cpd-id {
              type leafref {
                path "deref(../../../nsd-id)/../sapd/id";
                "A reference to the descriptor of a connection point
                 attached to one of the constituent VNFs and PNFs or to
                 the descriptor of a NS SAP.";
                "GS NFV IFA014: Section 6.4.4.2 CpdPool information
                 element";
      list dependencies {
        key "id";
        description
          "Specifies the order in which instances of the VNFs and/or
           nested NSs have to be created.";
        reference
          "GS NFV IFA014: Section 6.3.2.2 NsDf information element";
        choice primary-id {
          leaf primary-vnf-profile {
            type leafref {
              path "../../vnf-profile/vnfd-id";
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
            }
          }
          leaf primary-ns-profile {
            type leafref {
              path "../../ns-profile/nsd-id";
            }
          }
            "References a VnfProfile or NsProfile.";
            "GS NFV IFA014: Section 6.3.12.2 Dependencies
             information element";
        }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
        choice secondary-id {
          leaf secondary-vnf-profile {
            type leafref {
              path "../../vnf-profile/vnfd-id";
            }
          leaf secondary-ns-profile {
            type leafref {
              path "../../ns-profile/nsd-id";
          }
          description
            "References a VnfProfile or NsProfile.";
          reference
            "GS NFV IFA014: Section 6.3.12.2 Dependencies
             information element";
        }
      }

      list monitored-info {
        key "id";

        leaf id {
          type string;
        }

        container vnf-indicator-info {
          leaf vnfd-id {
            type leafref {
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
              path "/nfv:nfv/nfv:vnfd/nfv:id";
              "Identifies a VNFD.";
              "GS NFV IFA014: Section 6.2.7.2 VnfIndicatorData
               information element";
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
          leaf vnf-indicator {
            mandatory true;
            type leafref {
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
              path "deref(../vnfd-id)/../nfv:indicator/nfv:id";
              "Identifies a VNF indicator within the VNFD.";
              "GS NFV IFA014: Section 6.2.7.2 VnfIndicatorData
               information element";
          description
            "Uniquely identifies this VNF Indicator information
             element.";
          reference
            "GS NFV IFA014: Section 6.2.6.2 MonitoredData
             information element";
        // monitoringParameter in IFA014 is defined by MonitoredData
        // whereas monitoringParameter in IFA011 is defined by
        // MonitoringParameter.
        container monitoring-parameter {
          leaf id {
            type string;
            description
              "Unique identifier of this monitoring parameter
               information element.";
            reference
              "GS NFV IFA014: Section 6.2.8.2 MonitoringParameter
               information element";
          leaf name {
            type string;
              "Human readable name of the monitoring parameter.";
              "GS NFV IFA014: Section 6.2.8.2 MonitoringParameter
          leaf performance-metric {
            mandatory true;
            type string;
            description
              "Defines the virtualised resource-related performance
               metric.";
            reference
              "GS NFV IFA014: Section 6.2.8.2 MonitoringParameter
               information element";
          }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed

          leaf collection-period {
            type string;
            description
              "An attribute that describes the periodicity at
               which to collect the performance information.";
            reference
              "GS NFV IFA014: Section 6.2.8.2 MonitoringParameter
               information element";

      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";
      }
    uses security-parameters;