etsi-nfv-ns.yang 49.8 KB
Newer Older
1
submodule etsi-nfv-ns {
2
  yang-version 1.1;
3
4
5
6
  belongs-to etsi-nfv {
    prefix nfv;
  }

7
8
9
  import etsi-nfv-common {
    prefix common;
  }
10

11
12
13
  include etsi-nfv-vnf;
  include etsi-nfv-pnf;

14
15
16
17
18
19
  description
    "Models for NS according to ETSI GS NFV-IFA 014.";

  revision 2017-01-20 {
    description
      "Initial revision
20
21
       Common data structure to support NSD according to:
       ETSI GS NFV-IFA 011 Ed251v243";
22

23
    reference
24
      "ETSI GS NFV-IFA 011 Ed251v243";
25
26
27
28
29
30
  }

  grouping resource-handle {
    leaf vim-id {
      type string;
    }
31
    leaf resource-provider-id {
32
33
34
35
36
37
38
      type string;
    }
    leaf resource-id {
      type string;
    }
  }

39

40
41
42
  grouping nsd {
    list nsd {
      key "id";
43

44
45
46
      leaf id {
        type string;
        description
47
48
49
50
51
          "Identifier of this NSD information element. It Globally
           uniquely identifies an instance of the NSD.";
        reference
          "GS NFV IFA014: Section 6.2.2.2 Network Service Descriptor
           information element";
52
53
54
55
      }
      leaf designer {
        type string;
        description
56
57
58
59
          "Identifies the designer of the NSD.";
        reference
          "GS NFV IFA014: Section 6.2.2.2 Network Service Descriptor
           information element";
60
61
62
63
      }
      leaf version {
        type string;
        description
64
65
66
67
          "Identifies the version of the NSD.";
        reference
          "GS NFV IFA014: Section 6.2.2.2 Network Service Descriptor
           information element";
68
69
70
71
      }
      leaf name {
        type string;
        description
72
73
74
75
          "Provides the human readable name of the NSD.";
        reference
          "GS NFV IFA014: Section 6.2.2.2 Network Service Descriptor
           information element";
76
77
78
      }
      leaf invariant-id {
        type string;
79
80
81
82
83
84
85
        description
          "Identifies an NSD in a version independent manner. This
           attribute is invariant across versions of the network
           service descriptor.";
        reference
          "GS NFV IFA014: Section 6.2.2.2 Network Service Descriptor
           information element";
86
87
      }

88
89
      leaf-list nested-nsd-id {
        must ". != ../id";
90
        type leafref {
91
          path "../../nsd/id";
92
        }
93
94
95
96
97
        description
          "References the NSD of a constituent nested NS.";
        reference
          "GS NFV IFA014: Section 6.2.2.2 Network Service Descriptor
           information element";
98
99
      }

100
101
102
      leaf-list vnfd-id {
        type leafref {
          path "../../vnfd/id";
103
        }
104
105
106
107
108
        description
          "References the VNFD of a constituent VNF.";
        reference
          "GS NFV IFA014: Section 6.2.2.2 Network Service Descriptor
           information element";
109
      }
110
111
112
113
114
115
116
117
118
119
120
121
122

      leaf-list pnfd-id {
	type leafref {
	  path "../../pnfd/id";
	}
        description
          "References the PNFD of a constituent PNF.";
        reference
          "GS NFV IFA014: Section 6.2.2.2 Network Service Descriptor
           information element";
      }

      list sapd {
123
124
        key "id";
        description
125
126
127
128
129
130
          "Provides the descriptor of a service access point of the
           network service.";
        reference
          "GS NFV IFA014: Section 6.2.2.2 Network Service Descriptor
           information element";

131
132
        leaf id {
          type string;
133
134
135
          description
            "Identifier of this Cpd information element.";
          reference
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
136
            "GS NFV IFA014: Section 6.6.3.1 Cpd information element";
137
138
139
        }

        leaf address-assignment {
140
          type boolean;
141
          description
142
143
            "Specify whether the SAP address assignment is under the
             responsibility of management and orchestration functions
144
             or not. If it is set to True, management and
145
146
147
148
149
             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";
150
        }
151

152
153
        leaf virtual-link-desc {
          type leafref {
154
            path "../../virtual-link-desc/id";
155
156
          }
          description
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
            "References the descriptor of the NS VL instance to
             which the SAP instantiated from this SAPD connects to.";
          reference
            "GS NFV IFA014: Section 6.2.3.2 Sapd information element";
        }

        choice associated-cpd-id {
          container vnf {
            leaf vnfd-id {
              mandatory true;
              type leafref {
                path "../../../../nfv:vnfd/nfv:id";
              }
              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 {
                path "../../../../nfv:pnfd/nfv:id";
              }
              must "boolean(../pnfd-id[.=current()])";
            }

            leaf ext-cpd-id {
              mandatory true;
              type leafref {
                path "deref(../pnfd-id)/../nfv:ext-cpd/nfv:id";
              }
            }
          }
          container ns {
            leaf nsd-id {
            mandatory true;
              type leafref {
                path "../../../../nfv:nsd/nfv:id";
              }
              must "boolean(../nsd-id[.=current()])";
	    }

            leaf ext-cpd-id {
              mandatory true;
              type leafref {
                path "deref(../nsd-id)/../nfv:sapd/nfv:id";
              }
            }
          }
        }
213
      }
214

215
216
217
      list virtual-link-desc {
        key "id";
        description
218
219
220
221
          "Provides the constituent VLDs.";
        reference
          "GS NFV IFA014: Section 6.2.2.2 Network Service Descriptor
           information element";
222
223
        leaf id {
          type string;
224
225
226
227
228
229
          description
            "Identifier of the NsVirtualLinkDesc information element.
             It uniquely identifies a VLD.";
          reference
            "GS NFV IFA014: Section 6.5.2.2 NsVirtualLinkDesc
             information element";
230
        }
231

232
233
        leaf provider {
          type string;
234
235
236
237
238
          description
            "Defines the organization generating the VLD.";
          reference
            "GS NFV IFA014: Section 6.5.2.2 NsVirtualLinkDesc
             information element";
239
        }
240

241
242
243
        leaf version {
          mandatory true;
          type string;
244
245
246
247
248
          description
            "Specifies the version of the VLD.";
          reference
            "GS NFV IFA014: Section 6.5.2.2 NsVirtualLinkDesc
             information element";
249
        }
250

251
        uses common:connectivity-type;
252

253
        list df {
254
          key "id";
255
256
257
258
259
260
261
262
263

          description
            "The VirtualLinkDf information element specifies
             properties for instantiating a VL according to a
             specific flavour.";
          reference
            "GS NFV IFA014: Section 6.5.2.2 NsVirtualLinkDesc
             information element";

264
265
          leaf id {
            type string;
266
267
268
269
270
271
            description
              "Identifies this VirtualLinkDf information element
               within a VLD.";
            reference
              "GS NFV IFA014: Section 6.5.4.2 VirtualLinkDf
               information element";
272
273
274
          }

          container qos {
275
276
277
278
279
280
281
            description
              "The QoS information element specifies quality of
               service parameters applicable to a VL.";
            reference
              "GS NFV IFA014: Section 6.5.4.2 VirtualLinkDf
               information element";

282
283
284
285
            leaf latency {
              mandatory true;
              type uint32;
              units "ms";
286
287
288
289
290
              description
                "Specifies the maximum latency in ms.";
              reference
                "GS NFV IFA014: Section 6.5.6.2 QoS information
                 element";
291
292
293
294
295
296
            }

            leaf packet-delay-variation {
              mandatory true;
              type uint32;
              units "ms";
297
298
299
300
301
              description
                "Specifies the maximum jitter in ms.";
              reference
                "GS NFV IFA014: Section 6.5.6.2 QoS information
                 element";
302
303
304
305
306
307
308
            }

            leaf packet-loss-ratio {
              type decimal64 {
                fraction-digits "2";
                range "0..1.00";
              }
309
310
311
312
313
              description
                "Specifies the maximum packet loss ratio.";
              reference
                "GS NFV IFA014: Section 6.5.6.2 QoS information
                 element";
314
            }
315

316
            leaf priority {
317
              type uint32;
318
319
320
              description
                "Specifies the priority level in case of
                 congestion on the underlying physical links.";
321
322
323
              reference
                "GS NFV IFA014: Section 6.5.6.2 QoS information
                 element";
324
325
            }
          }
326

327
328
329
330
331
332
          leaf service-availability-level {
            type enumeration {
              enum "level-1";
              enum "level-2";
              enum "level-3";
            }
333
334
335
336
337
338
339
340
341
            description
              "Specifies one of the three levels defined in ETSI
               ETSI GS NFV-REL 001 [i.5]
                 * Level 1.
                 * Level 2.
                 * Level 3.";
            reference
              "GS NFV IFA014: Section 6.5.4.2 VirtualLinkDf
               information element";
342
343
344
345
346
347
348
349
350
          }
        }

        leaf test-access {
          type enumeration {
            enum none;
            enum passive-monitoring;
            enum active;
          }
351
352
353
354
355
          description
            "Specifies test access facilities expected on the VL.";
          reference
            "GS NFV IFA014: Section 6.5.2.2 NsVirtualLinkDesc
             information element";
356
357
358
359
        }

        leaf description {
          type string;
360
361
362
363
364
365
          description
            "Provides human-readable information on the purpose of
             the virtual link (e.g. VL for control plane traffic).";
          reference
            "GS NFV IFA014: Section 6.5.2.2 NsVirtualLinkDesc
             information element";
366
        }
367
        uses common:security-parameters;
368
      }
369
370

      list vnffgd {
371
        key "id";
372
373
374
375
376
377
378
379

        description
          "Provides the descriptors of the applicable forwarding
           graphs.";
        reference
          "GS NFV IFA014: Section 6.2.2.2 Network Service Descriptor
           information element";

380
381
        leaf id {
          type string;
382
383
384
385
386
387
          description
            "Identifier of this Vnffgd information element. It
             uniquely identifies a VNFFGD.";
          reference
            "GS NFV IFA014: Section 6.4.2.2 Vnffgd information
             element";
388
389
        }

390
391
392
        leaf-list vnf-profile-id {
          type leafref {
            path "../../df/vnf-profile/id";
393
          }
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
          description
            "References the VnfProfile of a constituent VNF.";
          reference
            "GS NFV IFA014: Section 6.4.2.2 Vnffgd information
             element";
        }

        leaf-list pnf-profile-id {
          type leafref {
            path "../../df/pnf-profile/id";
          }
          description
            "References the PnfProfile of a constituent PNF.";
          reference
            "GS NFV IFA014: Section 6.4.2.2 Vnffgd information
             element";
        }

        leaf-list nested-ns-profile-id {
          type leafref {
            path "../../df/ns-profile/id";
          }
          description
            "References the NsProfile of a nestedNS.";
          reference
            "GS NFV IFA014: Section 6.4.2.2 Vnffgd information
             element";
        }

        leaf virtual-link-profile-id {
          type leafref {
            path "../../df/virtual-link-profile/id";
          }
          description
            "References the Virtual Link Profile of a constituent
             VL.";
          reference
            "GS NFV IFA014: Section 6.4.2.2 Vnffgd information
             element";
        }

        list cpd-pool {
          key "id";

          description
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
439
440
441
            "Describes a pool of descriptors of connection points
             attached to one of the constituent VNFs and PNFs and/or
             one of the SAPs of the parent NS or of a nested NS.";
442
443
444
445
446
447
          reference
            "GS NFV IFA014: Section 6.4.2.2 Vnffgd information
             element";

          leaf id {
            type string;
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
448
449
450
          }

          choice constituent-base-element-id {
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
            mandatory "true";
            container vnf-profile {
              leaf vnf-profile-id {
                must ". = deref(../../vnfd-profile-id)" {
                }
                type leafref {
                  path "/nfv/nsd/df/vnf-profile/id";
                }
              }
            }
            container pnf-profile {
              leaf pnf-profile-id {
                must ". = deref(../../pnfd-profile-id)" {
                }
                type leafref {
                  path "/nfv/nsd/df/pnf-profile/id";
                }
              }
            }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
470
	    container ns-profile {
471
472
473
474
475
476
477
478
              leaf ns-profile-id {
                must ". = deref(../../ns-profile-id)" {
                }
                type leafref {
                  path "/nfv/nsd/df/ns-profile/id";
                }
              }
            }
479
            description
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
480
              "Reference to the profile of an NS constituent.";
481
            reference
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
482
483
              "GS NFV IFA014: Section 6.4.8 CpdInConstituentElement
               information element";
484
485
          }

Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
486
          choice constituent-cpd-id {
487
488
489
490
491
492
493
494
495
496
497
498
            container vnf {
              leaf vnfd-id {
                must ". = deref(../../vnfd-profile-id)/../vnfd-id" {
                }
                type leafref {
                  path "/nfv/vnfd/id";
                }
              }
              leaf cpd-id {
                type leafref {
                  path "deref(../vnfd-id)/../nfv:ext-cpd/nfv:id";
                }
499
500
              }
            }
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
            container pnf {
              leaf pnfd-id {
                must ". = deref(../../pnfd-profile-id)/../pnfd-id" {
                }
                type leafref {
                  path "/nfv/pnfd/id";
                }
              }
              leaf pnf-cpd-id {
                type leafref {
                  path "deref(../pnfd-id)/../nfv:ext-cpd/nfv:id";
                }
              }
            }
            container ns {
              leaf nsd-id {
                must ". = deref(../../ns-profile-id)/../nsd-id" {
                }

                type leafref {
                  path "/nfv/nsd/id";
                }
              }
              leaf sap-cpd-id {
                type leafref {
                  path "deref(../nsd-id)/../nfv:sapd/nfv:id";
                }
              }
            }
            description
              "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.";
            reference
              "GS NFV IFA014: Section 6.4.4.2 CpdPool information
               element";
          }
        }

        list nfpd {
          key "id";

          description
            "The network forwarding path associated to the VNFFG.";
          reference
            "GS NFV IFA014: Section 6.4.2.2 Vnffgd information
             element";

          leaf id {
            type string;
            description
              "Identifies this nfpd information element within a
               VNFFGD.";
            reference
              "GS NFV IFA014: Section 6.4.3.2 Nfpd information
               element";
          }

          leaf rule {
            type string;
            description
              "Provides an NFP classification and selection rule.
               The rule may be expressed as a criteria constructed
               out of atomic assertions linked by Boolean operators
               AND, OR and NOT.";
            reference
              "GS NFV IFA014: Section 6.4.3.2 Nfpd information
               element";
          }

          list position-desc-id {
            key "id";

            description
              "Describes a position in the NFP in terms of one or
               more CP profiles and rules for distributing the
               traffic among CP and SAP instances created from the
               CPD or SAPD associated to these profiles. This shall
               be connection point profile, which is either a CPD
               associated with the VnfProfile of a constituent VNF,
               or a CPD associated with the PnfProfile of a
               constituent PNF, or a SAPD associated with the
               NsProfile of a nested NS. The related VnfProfile,
               PnfProfile and NsProfile shall be included in the
               parent VNFFGD.";
            reference
              "GS NFV IFA014: Section 6.4.3.2 Nfpd information
               element";

            leaf id {
              type string;
              description
                "Identifier of this NfpPositionDesc element.";
              reference
                "GS NFV IFA014: Section 6.4.5.2 NfpPositionDesc
                 information element";
            }

            list cp-profile-id {
              key "id";

              description
                "References the profile of a connection point to be
                 traversed by the traffic flows matching the criteria.
                 This shall be a connection point attached to one of
                 the constituent VNFs and PNFs of the parent VNFFG,
                 or a SAP of one of the constituent nested NSs of the
                 parent VNFFG.";
              reference
                "GS NFV IFA014: Section 6.4.5.2 NfpPositionDesc
                 information element";

              leaf id {
                type string;
                description
                  "Identifier of this CpProfile information element.
                   It uniquely identifies a CpProfile.";
                reference
                  "GS NFV IFA014: Section 6.4.6.2 CpProfile
                   information element";
              }

              list constituent-profile-elements {
                key "id";

                description
                  "Specifies the constituents of the CpProfile.";
                reference
                  "GS NFV IFA014: Section 6.4.6.2 CpProfile
                   information element";

                leaf id {
                  type string;
                  description
                    "Specifies the constituents of the CpProfile.";
                  reference
                    "GS NFV IFA014: Section 6.4.7.2
                     ConstituentProfileElements information element";
                }

                leaf cpd-id {
                  type string;
                  description
                    "References the VNF external CPD for a given
                     VnfProfile, or the PNF external CPD for a given
                     PnfProfile, or a NS SAPD for a give NsProfile
                     identified by the constituentBasedElementId.";
                  reference
                    "GS NFV IFA014: Section 6.4.7.2
                     ConstituentProfileElements information element";
                }
652
653
654
655
656
              }
            }
          }
        }
      }
657

658
659
660
661
662
663
664
665
666
667
668
669
      leaf-list autoscale-rule {
        type string;
      }
      list lifecycle-management-script {
        key "event";
        leaf event {
          type string;
        }
        leaf script {
          type string;
        }
      }
670
671

      list df {
672
        min-elements 1;
673
674
675
676
677
678
679
680
681
        must "default-instantiation-level or " +
          "count(ns-instantiation-level) = 1" {
          error-message
            "default-instantiation-level must be present if there " +
            "multiple instantion-level";
          reference
            "GS NFV IFA014: Section 6.3.2.2 NsDf information element";
        }

682
683
        key "id";
        description
684
685
686
687
          "Identifies a DF within the scope of an NSD.";
        reference
          "GS NFV IFA014: Section 6.2.2.2 Network Service Descriptor
           information element";
688
689
690

        leaf id {
          type string;
691
692
693
694
695
          description
            "Identifies this NsDf information element. It identifies
             a NS DF within the NSD.";
          reference
            "GS NFV IFA014: Section 6.3.2.2 NsDf information element";
696
697
698
699
        }

        leaf flavor-key {
          type leafref {
700
            path "../monitored-info/id";
701
          }
702
703
704
705
706
707
708
709
710
711
          description
            "Assurance parameter against which this flavour is being
             described.

             The key can be a combination of multiple assurance
             parameters with a logical relationship between them.
             The parameters should be present as a monitoredInfo
             attribute in the NSD.";
          reference
            "GS NFV IFA014: Section 6.3.2.2 NsDf information element";
712
713
714
        }

        list vnf-profile {
715
716
717
718
719
          must "min-number-of-instances <= max-number-of-instances";
          must "boolean(../../vnfd-id[.=current()/vnfd-id])" {
            error-message "VNFDs in the profile has to be listed as a " +
              "dependency of the network service " +
              "descriptor.";
720
721
          }
          key "id";
722
723
724
725
          description
            "VNF profile to be used for the NS flavour.";
          reference
            "GS NFV IFA014: Section 6.3.2.2 NsDf information element";
726
727
728

          leaf id {
            type string;
729
730
731
732
733
734
            description
              "Identifier of this vnfProfile information element. It
               uniquely identifies a VnfProfile.";
            reference
              "GS NFV IFA014: Section 6.3.3.2 VnfProfile information
               element";
735
736
          }

737
          leaf vnfd-id {
738
739
            mandatory true;
            type leafref {
740
              path "/nfv/vnfd/id";
741
            }
742
743
744
745
746
            description
              "References a VNFD.";
            reference
              "GS NFV IFA014: Section 6.3.3.2 VnfProfile information
               element";
747
748
          }

749
          leaf flavor-id {
750
751
            mandatory true;
            type leafref {
752
              path "deref(../vnfd-id)/../df/id";
753
            }
754
755
756
757
758
            description
              "Identifies a flavour within the VNFD.";
            reference
              "GS NFV IFA014: Section 6.3.3.2 VnfProfile information
               element";
759
760
761
762
763
          }

          leaf instantiation-level {
            mandatory true;
            type leafref {
764
              path "deref(../flavor-id)/../instantiation-level/id";
765
            }
766
767
768
769
770
771
772
773
            description
              "Identifier of the instantiation level of the VNF DF
               to be used for instantiation. If not present, the
               default instantiation level as declared in the VNFD
               shall be used.";
            reference
              "GS NFV IFA014: Section 6.3.3.2 VnfProfile information
               element";
774
775
776
777
          }

          leaf min-number-of-instances {
            mandatory true;
778
779
780
781
782
783
784
            type uint16;
            description
              "Minimum number of instances of the VNF based on this
               VNFD that is permitted to exist for this VnfProfile.";
            reference
              "GS NFV IFA014: Section 6.3.3.2 VnfProfile information
               element";
785
          }
786

787
788
          leaf max-number-of-instances {
            mandatory true;
789
790
791
792
793
794
795
            type uint16;
            description
              "Maximum number of instances of the VNF based on this
               VNFD that is permitted to exist for this VnfProfile.";
            reference
              "GS NFV IFA014: Section 6.3.3.2 VnfProfile information
               element";
796
797
          }

798
          uses common:local-affinity-or-anti-affinity-rule;
799

800
801
802
          list affinity-or-anti-affinity-group {
            key "id";

803
804
805
806
807
808
809
            description
              "Identifier(s) of the affinity or anti-affinity
               group(s) the VnfProfile belongs to.";
            reference
              "GS NFV IFA014: Section 6.3.3.2 VnfProfile information
               element";

810
811
            leaf id {
              type leafref {
812
                path "../../../affinity-or-anti-affinity-group/id";
813
814
815
816
817
              }
            }
          }

          list virtual-link-connectivity {
818
819
820
821
822
823
824
825
826
            key "virtual-link-profile-id";

            description
              "Defines the connection information of the VNF, it
               contains connection relationship between a VNF
               connection point and a NS Virtual Link.";
            reference
              "GS NFV IFA014: Section 6.3.3.2 VnfProfile information
               element";
827

828
            leaf virtual-link-profile-id {
829
              type leafref {
830
                path "../../../virtual-link-profile/id";
831
              }
832
833
834
835
836
              description
                "Reference an NS VL profile.";
              reference
                "GS NFV IFA014: Section 6.3.7.2, NsVirutalLinkConnectivity
                 information element.";
837
838
            }

Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
839
840
841
            list constituent-cpd-id {
              key "constituent-base-element-id";

842
              description
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
843
844
845
846
                "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.";
847
              reference
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
                "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(../../../vnfd-id)/../nfv:ext-cpd/nfv:id";
                }
                description
                  "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.";
                reference
                  "GS NFV IFA014: Section 6.4.4.2 CpdPool information
                   element";
              }
874
875
            }
          }
876
        }
877

878
879
880
881
882
883
884
        list pnf-profile {
          key "id";
          must "boolean(../../pnfd-id[.=current()/pnfd-id])" {
            error-message "PNFDs in the profile has to be listed as a " +
              "dependency of the network service " +
              "descriptor.";
          }
885

886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
          leaf id {
            type string;
            description
              "Identifier of this PnfProfile information element.
               It uniquely identifies a PnfProfile.";
            reference
              "GS NFV IFA014: Section 6.3.6.2 PnfProfile information
               element";
          }

          leaf pnfd-id {
            type leafref {
              path "/nfv/pnfd/id";
            }
            description
              "References a PNFD.";
            reference
              "GS NFV IFA014: Section 6.3.6.2 PnfProfile information
               element";
          }

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

            description
              "Defines the connection information of the PNF, it
               contains connection relationship between a PNF
               connection point and a NS Virtual Link.";
            reference
              "GS NFV IFA014: Section 6.3.6.2 PnfProfile information
               element";

            leaf virtual-link-profile-id {
919
              type leafref {
920
                path "../../../virtual-link-profile/id";
921
              }
922
923
924
925
926
              description
                "Reference an NS VL profile.";
              reference
                "GS NFV IFA014: Section 6.3.7.2, NsVirutalLinkConnectivity
                 information element.";
927
928
            }

Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
929
930
931
            list constituent-cpd-id {
              key "constituent-base-element-id";

932
              description
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
933
934
935
936
                "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.";
937
              reference
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
                "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(../../../pnfd-id)/../nfv:ext-cpd/nfv:id";
                }
                description
                  "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.";
                reference
                  "GS NFV IFA014: Section 6.4.4.2 CpdPool information
                   element";
              }
964
965
966
967
            }
          }
        }

968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
        list virtual-link-profile {
          key "id";

          description
            "VL profile to be used for the NS flavour.";
          reference
            "GS NFV IFA014: Section 6.3.2.2 NsDf information element";

          leaf id {
            type string;
            description
              "Uniquely identifies this VirtualLinkProfile
               information element.";
            reference
              "GS NFV IFA014: Section 6.3.2.2 VirtualLinkProfile
               information element";
984
985
          }

986
          leaf virtual-link-desc-id {
987
988
            mandatory true;
            type leafref {
989
              path "../../../virtual-link-desc/id";
990
            }
991
992
993
994
995
            description
              "Uniquely references a VLD.";
            reference
              "GS NFV IFA014: Section 6.3.2.2 VirtualLinkProfile
               information element";
996
997
          }

998
          leaf flavor-id {
999
1000
            mandatory true;
            type leafref {
1001
              path "deref(../virtual-link-desc-id)/../df/id";
1002
            }
1003
1004
1005
1006
1007
            description
              "Identifies a flavour within the VLD.";
            reference
              "GS NFV IFA014: Section 6.3.2.2 VirtualLinkProfile
               information element";
1008
1009
          }

1010
          uses common:local-affinity-or-anti-affinity-rule;
1011

1012
1013
1014
          list affinity-or-anti-affinity-group {
            key "id";

1015
1016
1017
1018
1019
1020
1021
1022
            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";

1023
1024
            leaf id {
              type leafref {
1025
                path "../../../affinity-or-anti-affinity-group/id";
1026
1027
1028
1029
1030
              }
            }
          }

          container max-bitrate-requirements {
1031
1032
1033
1034
1035
1036
            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";
1037
            uses common:link-bitrate-requirements;
1038
1039
          }
          container min-bitrate-requirements {
1040
1041
1042
1043
1044
1045
            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";
1046
            uses common:link-bitrate-requirements;
1047
1048
1049
1050
          }
        }

        list scaling-aspect {
1051
1052
1053
1054
1055
1056
1057
1058
          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 {
1059
            type string;
1060
1061
1062
1063
1064
1065
1066
            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";
1067
          }
1068

1069
1070
          leaf name {
            type string;
1071
1072
1073
1074
1075
1076
            description
              "Provides a human readable name of the NS scaling
               aspect.";
            reference
              "GS NFV IFA014: Section 6.7.2.2 NsScalingAspect
               information element";
1077
          }
1078

1079
1080
          leaf description {
            type string;
1081
1082
1083
1084
1085
1086
            description
              "Provides a human readable description of the NS
               scaling aspect.";
            reference
              "GS NFV IFA014: Section 6.7.2.2 NsScalingAspect
               information element";
1087
          }
1088

1089
1090
          leaf scaling-level {
            type leafref {
1091
              path "../../ns-instantiation-level/id";
1092
            }
1093
1094
1095
1096
1097
            description
              "Describes the details of an NS level.";
            reference
              "GS NFV IFA014: Section 6.7.2.2 NsScalingAspect
               information element";
1098
1099
1100
1101
1102
1103
          }
        }

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

1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
          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";

1114
1115
          leaf id {
            type string;
1116
1117
1118
1119
1120
1121
            description
              "Identifier of Identifier of this 
               AffinityOrAntiAffinityGroup information element.";
            reference
              "GS NFV IFA014: Section 6.3.5.2 AffinityOrAntiAffinity
               information element";
1122
1123
1124
1125
          }

          leaf affinity-type {
            mandatory true;
1126
            type common:affinity-type;
1127
1128
1129
1130
1131
1132
            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";
1133
1134
1135
1136
          }

          leaf affinity-scope {
            mandatory true;
1137
            type common:affinity-scope;
1138
1139
1140
1141
1142
1143
            description
              "Specifies the scope of the affinity or anti-affinity
               relationship e.g. a NFVI node, an NFVI PoP, etc.";
            reference
              "GS NFV IFA014: Section 6.3.5.2 AffinityOrAntiAffinity
               information element";
1144
1145
1146
          }
        }

1147
        list ns-instantiation-level {
1148
1149
          min-elements 1;
          key "id";
1150
1151
1152
1153
1154
1155
1156
1157

          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";

1158
1159
          leaf id {
            type string;
1160
1161
1162
1163
1164
1165
            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";
1166
1167
1168
1169
          }

          leaf description {
            type string;
1170
1171
1172
1173
1174
            description
              "Human readable description of the NS level.";
            reference
              "GS NFV IFA014: Section 6.3.9.2 NsLevel information
               element";
1175
1176
1177
          }

          list vnf-to-level-mapping {
1178
1179
1180
1181
1182
1183
1184
1185
1186
            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";
1187

1188
            leaf vnf-profile-id {
1189
              type leafref {
1190
                path "../../../vnf-profile/id";
1191
              }
1192
1193
1194
1195
1196
1197
              description
                "Identifies the profile to be used for a VNF
                 involved in an NS level.";
              reference
                "GS NFV IFA014: Section 6.7.4.2 VnfToLevelMapping
                 information element";
1198
1199
1200
1201
1202
            }

            leaf number-of-instances {
              mandatory true;
              type uint32;
1203
1204
1205
1206
1207
1208
              description
                "Specifies the number of VNF instances required for
                 an NS level.";
              reference
                "GS NFV IFA014: Section 6.7.4.2 VnfToLevelMapping
                 information element";
1209
1210
1211
            }
          }

1212
1213
1214
1215
1216
1217
1218
1219
1220
          list virtual-link-to-level-mapping {
            key "virtual-link-profile-id";

            description
              "Specifies the profile of the VLs involved in this NS
               level and, for each of them, the needed bandwidth.";
            reference
              "GS NFV IFA014: Section 6.3.9.2 NsLevel information
               element";
1221

1222
            leaf virtual-link-profile-id {
1223
              type leafref {
1224
                path "../../../virtual-link-profile/id";
1225
              }
1226
1227
1228
1229
1230
1231
              description
                "Identifies the profile to be used for a VL involved
                 in an NS level.";
              reference
                "GS NFV IFA014: Section 6.7.5.2
                 VirtualLinkToLevelMapping information element";
1232
1233
            }

1234
            uses common:link-bitrate-requirements;
1235
1236
1237
          }

          list ns-to-level-mapping {
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
            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 {
1249
              type leafref {
1250
                path "../../../ns-profile/id";
1251
              }
1252
1253
1254
1255
1256
1257
              description
                "Identifies 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
                 element";
1258
1259
1260
1261
1262
            }

            leaf number-of-instances {
              mandatory true;
              type uint32;
1263
1264
1265
1266
1267
1268
              description
                "Specifies the number of nested NS instances required
                 for the NS scale level.";
              reference
                "GS NFV IFA014: Section 6.7.6.2 NsToLevel information
                 element";
1269
1270
            }
          }
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286

          must "(count(vnf-to-level-mapping) + " +
            "count(virtual-link-to-level-mapping) + " +
            "count(ns-to-level-mapping)) > 0" {
            error-message "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";
          }
1287
1288
1289
1290
        }

        leaf default-instantiation-level {
          type leafref {
1291
            path "../ns-instantiation-level/id";
1292
          }
1293
1294
1295
1296
1297
1298
          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";
1299
1300
1301
        }

        list ns-profile {
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
          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 "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;
1329
            type leafref {
1330
              path "/nfv/nsd/id";
1331
            }
1332
1333
1334
1335
1336
1337
            description
              "Identifies the NSD applicable to NS instantiated
               according to this profile.";
            reference
              "GS NFV IFA014: Section 6.3.11.2 NsProfile information
               element";
1338
          }
1339
1340
          leaf ns-df-id {
            mandatory true;
1341
            type leafref {
1342
              path "deref(../nsd-id)/../df/id";
1343
            }
1344
1345
1346
1347
1348
1349
            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";
1350
          }
1351
1352
          leaf instantiation-level-id {
            mandatory true;
1353
            type leafref {
1354
              path "deref(../ns-df-id)/../ns-instantiation-level/id";
1355
            }
1356
1357
1358
1359
1360
1361
1362
1363
            description
              "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.";
            reference
              "GS NFV IFA014: Section 6.3.11.2 NsProfile information
               element";
1364
1365
1366
1367
          }
          leaf min-number-of-instances {
            type uint16;
            mandatory true;
1368
1369
1370
1371
1372
1373
1374
            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";
1375
1376
1377
1378
          }
          leaf max-number-of-instances {
            type uint16;
            mandatory true;
1379
1380
1381
1382
1383
1384
1385
            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";
1386
          }
1387
1388

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

1391
1392
1393
1394
1395
1396
1397
            description
              "Identifies an affinity or anti-affinity group the NSs
               created according to this NsProfile belongs to.";
            reference
              "GS NFV IFA014: Section 6.3.11.2 NsProfile information
               element";

1398
1399
            leaf id {
              type leafref {
1400
                path "../../../affinity-or-anti-affinity-group/id";
1401
1402
1403
              }
            }
          }
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417

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

            leaf virtual-link-profile-id {
              type leafref {
                path "../../../virtual-link-profile/id";
              }
              description
                "Reference an NS VL profile.";
              reference
                "GS NFV IFA014: Section 6.3.7.2, NsVirutalLinkConnectivity
                 information element.";
            }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
1418
1419
1420
1421
1422
1423
1424
1425
1426

            list constituent-cpd-id {
              key "constituent-base-element-id";

              description
                "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.";
1427
              reference
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
                "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)/../nfv:sapd/nfv:id";
                }
                description
                  "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.";
                reference
                  "GS NFV IFA014: Section 6.4.4.2 CpdPool information
                   element";
              }
            }
	  }
	}
1457

1458
        list dependencies {
1459
          key "id";
1460
1461
1462
1463
1464
1465
1466

          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";

1467
1468
1469
          leaf id {
            type string;
          }
1470
          choice primary-id {
1471
1472
            leaf primary-vnf-profile {
              type leafref {
1473
                path "../../vnf-profile/vnfd-id";
1474
1475
1476
1477
              }
            }
            leaf primary-ns-profile {
              type leafref {
1478
                path "../../ns-profile/nsd-id";
1479
1480
              }
            }
1481
1482
1483
1484
1485
            description
              "References a VnfProfile or NsProfile.";
            reference
              "GS NFV IFA014: Section 6.3.12.2 Dependencies
               information element";
1486
          }
1487
          choice secondary-id {
1488
1489
            leaf secondary-vnf-profile {
              type leafref {
1490
                path "../../vnf-profile/vnfd-id";
1491
1492
1493
1494
              }
            }
            leaf secondary-ns-profile {
              type leafref {
1495
                path "../../ns-profile/nsd-id";
1496
1497
              }
            }
1498
1499
1500
1501
1502
            description
              "References a VnfProfile or NsProfile.";
            reference
              "GS NFV IFA014: Section 6.3.12.2 Dependencies
               information element";
1503
1504
          }
        }
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575

        list monitored-info {
          key "id";

          leaf id {
            type string;
          }

          container vnf-indicator-info {
            leaf vnfd-id {
              type leafref {
                path "/nfv/vnfd/id";
              }
              description
                "Identifies a VNFD.";
              reference
                "GS NFV IFA014: Section 6.2.7.2 VnfIndicatorData
                 information element";
            }
            leaf vnf-indicator {
              mandatory true;
              type leafref {
                path "deref(../vnfd-id)/../indicator/id";
              }
              description
                "Identifies a VNF indicator within the VNFD.";
              reference
                "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;
              description
                "Human readable name of the monitoring parameter.";
              reference
                "GS NFV IFA014: Section 6.2.8.2 MonitoringParameter
                 information element";
            }

            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
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585

            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";