etsi-nfv-vnf.yang 89.5 KB
Newer Older
1
submodule etsi-nfv-vnf {
2
  yang-version 1.1;
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
3
  belongs-to etsi-nfv-descriptors {
4
5
6
    prefix nfv;
  }

7
8
  include etsi-nfv-common;

9
10
11
12
13
14
15
16
17
18
  import ietf-inet-types {
    prefix inet;
  }
  import ietf-yang-types {
    prefix yang;
  }

  description
    "Models for VNFD according to GS NFV-IFA 011.";

19
  revision 2019-03-18 {
20
21
22
23
    description
      "Initial revision.

       Common data structure to support VNFD according to:
24
       VNFD according to ETSI GS NFV-IFA 011 Ed261v254";
25
26

    reference
27
      "ETSI GS NFV-IFA 011 Ed261v254";
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
  }

  grouping virtual-network-interface-requirements {
    list virtual-network-interface-requirement {
      key "name";
      description
        "Specifies requirements on a virtual network interface
         realising the CPs instantiated from this CPD.";
      reference
        "GS NFV-IFA011: Section 7.1.6.4, VduCpd information
         element";

      leaf name {
        type string;
        description
          "Provides a human readable name for the requirement.";
        reference
          "GS NFV-IFA011: Section 7.1.6.6,
           VirtualNetworkInterfaceRequirements information element";
      }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
48

49
50
51
52
53
54
55
56
      leaf description {
        type string;
        description
          "Provides a human readable description of the requirement.";
        reference
          "GS NFV-IFA011: Section 7.1.6.6,
           VirtualNetworkInterfaceRequirements information element";
      }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
57

58
      leaf support-mandatory {
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
59
        default "false";
60
61
62
63
64
65
66
67
68
        type boolean;
        description
          "Indicates whether fulfilling the constraint is
           mandatory (true) for successful operation or desirable
           (false).";
        reference
          "GS NFV-IFA011: Section 7.1.6.6,
           VirtualNetworkInterfaceRequirements information element";
      }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
69

70
71
      list network-interface-requirements {
        key "key";
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
72
        min-elements "1";
73
        max-elements "1";
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
74

75
76
77
78
79
80
81
82
83
84
85
86
87
88
        leaf key {
          type string;
        }
        leaf value {
          type string;
        }
        description
          "The network interface requirements. An element from an
           array of key-value pairs that articulate the network
           interface deployment requirements.";
        reference
          "GS NFV-IFA011: Section 7.1.6.6,
           VirtualNetworkInterfaceRequirements information element";
      }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
89

Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
90
      leaf nicio-requirements {
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
91
        type leafref {
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
92
          path "/nfv/vnfd/virtual-compute-desc/id";
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
93
        }
94
        description
95
96
97
98
          "This references (couples) the CPD with any logical node I/O
           requirements (for network devices) that may have been
           created. Linking these attributes is necessary so that so
           that I/O requirements that need to be articulated at the
99
100
101
102
103
104
105
106
107
108
109
110
111
112
           logical node level can be associated with the network
           interface requirements associated with the CPD.";
        reference
          "GS NFV-IFA011: Section 7.1.6.6,
           VirtualNetworkInterfaceRequirements information element";
      }
    }
  }

  grouping vnfd {
    list vnfd {
      key "id";
      description
        "A VNF Descriptor (VNFD) is a deployment template which
113
         describes a VNF in terms of deployment and operational
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
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
         behaviour requirements. It also contains connectivity,
         interface and virtualised resource requirements";
      reference
        "GS NFV-IFA011: Section 7.1.2, VNFD information element";
      leaf id {
        type string;
        description
          "Identifier of this VNFD information element. This attribute
           shall be globally unique. The format will be defined in the
           data model specification phase.";
        reference
          "GS NFV-IFA011: Section 7.1.2, VNFD information element";
      }
      leaf provider {
        type string;
        mandatory true;
        description
          "Provider of the VNF and of the VNFD";
        reference
          "GS NFV-IFA011: Section 7.1.2, VNFD information element";
      }
      leaf product-name {
        type string;
        mandatory true;
        description
          "Name to identify the VNF Product. Invariant for the VNF
           Product lifetime.";
        reference
          "GS NFV-IFA011: Section 7.1.2, VNFD information element";
      }
      leaf software-version {
        type string;
        mandatory true;
        description
          "Software version of the VNF. This is changed when there is
           any change to the software that is included in the VNF
           Package";
        reference
          "GS NFV-IFA011: Section 7.1.2, VNFD information element";
      }
      leaf version {
        type string;
        mandatory true;
        description
          "Identifies the version of the VNFD";
        reference
          "GS NFV-IFA011: Section 7.1.2, VNFD information element";
      }
      leaf product-info-name {
        type string;
        description
          "Human readable name of the VNFD. Can change
           during the VNF Product lifetime.";
        reference
          "GS NFV-IFA011: Section 7.1.2, VNFD information element";
      }
      leaf product-info-description {
        type string;
        description
          "Human readable description of the VNFD. Can change during
           the VNF Product lifetime.";
        reference
          "GS NFV-IFA011: Section 7.1.2, VNFD information element";
      }
      leaf-list vnfm-info {
        type string;
        min-elements 1;
        description
          "Identifies VNFM(s) compatible with the VNF described in
           this version of the VNFD.";
        reference
          "GS NFV-IFA011: Section 7.1.2, VNFD information element";
      }
      leaf localization-language {
        type string;
        description
          "Information about the language of the VNF.";
        reference
          "GS NFV-IFA011: Section 7.1.2, VNFD information element";
      }
      leaf default-localization-language {
        when "../localization-language";
        type string;
        description
          "Default localization language that is instantiated if no
           information about selected localization language is
           available. Shall be present if 'localization-language'
           is present and shall be absent otherwise.";
        reference
          "GS NFV-IFA011: Section 7.1.2, VNFD information element";
      }
205

206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
      list vdu {
        key "id";
        min-elements 1;
        description
          "The Virtualisation Deployment Unit (VDU) is a construct supporting
           the description of the deployment and operational behaviour of a
           VNF component, or the entire VNF if it was not componentized in
           components.";
        reference
          "GS NFV IFA011: Section 7.1.2, VNFD information element";
        leaf id {
          type string;
          description
            "Unique identifier of this VDU in VNFD.";
          reference
            "GS NFV IFA011: Section 7.1.6.2, Vdu information element";
        }
        leaf name {
          type string;
          mandatory true;
          description
            "Human readable name of the VDU.";
          reference
            "GS NFV IFA011: Section 7.1.6.2, Vdu information element";
        }
        leaf description {
          type string;
          description
            "Human readable description of the VDU.";
          reference
            "GS NFV IFA011: Section 7.1.6.2, Vdu information element";
        }
        list int-cpd {
          key "id";
          min-elements 1;
          description
            "A internal-connection-point element is a type of
             connection point and describes network connectivity
             between a VDU instance and an internal Virtual Link or
             an external connection point.";
          reference
            "GS NFV IFA011: Section 7.1.6.2, Vdu information element";
248

Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
249
250
251
          leaf int-virtual-link-desc {
            type leafref {
              path "../../../nfv:int-virtual-link-desc/nfv:id";
252
            }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
253
254
255
256
257
258
            description
              "Reference of the internal VLD which this internal CPD
               connects to.";
            reference
              "GS NFV IFA011: Section 7.1.6.4, VduCpd information
               element";
259
          }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
260

261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
          leaf bitrate-requirement {
            type uint64;
            units "Mbps";
            description
              "Bitrate requirement on this CP.";
            reference
              "GS NFV IFA011: Section 7.1.6.4, VduCpd information
               element.";
          }
          uses virtual-network-interface-requirements;
          leaf-list order {
            type uint32;
            description
              "The order of the NIC to be assigned on the compute
               instance (e.g. 2 for eth2).

               Note: when binding more than one port to a single
               compute (aka multi vNICs) and ordering is desired, it
               is mandatory that all ports will be set with an order
               value. The order values shall represent a positive,
               arithmetic progression that starts with 0 (i.e. 0, 1,
               2,..., n).

               If the property is not present, it shall be left to the
               VIM to assign a value when creating the instance.";
            reference
              "GS NFV IFA011: Section 7.1.6.4, VduCpd information
               element.";
          }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
290
          uses cpd;
291
292
293
        }
        leaf virtual-compute-desc {
          type leafref {
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
294
            path "../../nfv:virtual-compute-desc/nfv:id";
295
          }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
296
          must "../../nfv:virtual-compute-desc[id=current()]/" +
297
298
299
300
               "nfv:virtual-memory/size >=" +
               "../../nfv:sw-image-desc[id=current()/" +
               "../sw-image-desc]/min-ram" {
          }
301
302
303
304
305
306
307
308
          description
            "Describes CPU, Memory and acceleration requirements of
             the Virtualisation Container realizing this VDU.";
          reference
            "GS NFV IFA011: Section 7.1.6.2, VDU information
             element, and Section 7.1.9.2.2, VirtualComputeDesc
             information element.";
        }
309

310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
        leaf-list virtual-storage-desc {
          type leafref {
            path "../../nfv:virtual-storage-descriptor/" +
                 "nfv:id";
          }
          description
            "Describes storage requirements for a VirtualStorage
             instance attached to the virtualisation container
             created from virtualComputeDesc defined for this VDU.";
          reference
            "GS NFV IFA011: Section 7.1.6.2, VDU information
             element, and Section 7.1.9.4, Information elements
             related to Virtual Storage.";
        }
        list boot-order {
          ordered-by user;
326
327
328
329
330
          key "key";
          leaf key {
            type uint32;
          }
          leaf value {
331
332
333
334
            type leafref {
              path "../../nfv:virtual-storage-desc";
            }
          }
335
336
337
338
339
340
341
342
343
344
345
346
          description
            "The key indicates the boot index (lowest index defines
             highest boot priority). The Value references a descriptor
             from which a valid boot device is created e.g.
             VirtualStorageDesc from which a VirtualStorage instance
             is created.

             Editor's note: The boot-order node requires further
             study.";
          reference
            "GS NFV IFA011: Section 7.1.6.2, Vdu information
             element.";
347
        }
348
349
350
351
        leaf sw-image-desc {
          type leafref {
            path "../../sw-image-desc/id";
          }
352
353
354
355
          description
            "Describes the software image which is directly loaded on
             the virtualisation container realising this Vdu.";
          reference
356
357
            "GS NFV IFA011: Section 7.1.6.2, Vdu information
             element.";
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
        }
        leaf-list nfvi-constraint {
          type string;
          description
            "Describes constraints on the NFVI for the VNFC
             instance(s) created from this Vdu. For example, aspects
             of a secure hosting environment for the VNFC instance
             that involve additional entities or processes.";
          reference
            "GS NFV IFA011: Section 7.1.6.2, VDU Information
             element.";
        }
        list monitoring-parameter {
          key "id";
          leaf id {
            type string;
            description
              "Unique identifier of the monitoring parameter.";
            reference
              "GS NFV IFA011: Section 7.1.11.3, MonitoringParameter
               information element.";
          }
380
          uses monitoring-parameter;
381
        }
382
383
384
385
386
387
388
389
        list configurable-properties {
          key "key";
          leaf key {
            type string;
          }
          leaf value {
            type string;
          }
390
          description
391
392
            "It provides VNFC configurable properties that can be
             modified using the ModifyVnfInfo operation.";
393
          reference
394
395
396
            "GS NFV IFA011: Section 7.1.6.7,
             VnfcConfigurableProperties Information element.";
        }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
397
398
        leaf boot-data {
	  type string;
399
400
401
402
403
404
405
406
407
          description
            "Contains a string or a URL to a file contained in the
             VNF package used to customize a virtualised compute
             resource at boot time. The bootData may contain variable
             parts that are replaced by deployment specific values
             before being sent to the VIM.";
          reference
            "GS NFV IFA011: Section 7.1.6.7,
             VnfcConfigurableProperties Information element.";
408
409
        }
      }
410

Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
411
      list virtual-compute-desc {
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
        key "id";
        description
          "Defines descriptors of virtual compute resources to be
           used by the VNF.";
        leaf id {
          type string;
          description
            "Unique identifier of this VirtualComputeDesc in the
             VNFD.";
          reference
            "GS NFV IFA011: Section 7.1.9.2, Information elements
             related to Virtual CPU.";
        }

        list logical-node {
427
428
429
          key "id";

          leaf id {
430
            type string;
431
432
433
434
435
            description
              "Identifies this set of logical node requirements.";
            reference
              "GS NFV IFA011: Section 7.1.9.6, LogicalNodeRequirements
               Information elements.";
436
          }
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460

          list requirement-detail {
            key "key";

            leaf key {
              type string;
            }
            leaf value {
              type string;
            }
            description
              "The logical node-level compute, memory and I/O
               requirements. An array of key-value pairs that
               articulate the deployment requirements.

               This could include the number of CPU cores on this
               logical node, a memory configuration specific to a
               logical node (e.g. such as available in the Linux
               kernel via the libnuma library) or a requirement
               related to the association of an I/O device with the
               logical node.";
            reference
              "GS NFV IFA011: Section 7.1.9.6, LogicalNodeRequirements
               information element.";
461
462
          }
          description
463
            "The logical node requirements.";
464
          reference
465
            "GS NFV IFA011: Section 7.1.9.2, VirtualComputeDesc
466
467
468
469
470
471
472
473
474
475
476
477
             information element.";
        }

        list request-additional-capability {
          key "name";
          leaf name {
            type string;
            description
              "Identifies a requested additional capability for the
               VDU. ETSI GS NFV-IFA 002 [i.1] describes acceleration
               capabilities.";
            reference
478
              "GS NFV IFA011: Section 7.1.9.5,
479
480
481
482
483
484
485
486
487
               RequestedAdditionalCapabilityData Information
               element.";
          }
          leaf support-mandatory {
            type boolean;
            description
              "Indicates whether the requested additional capability
               is mandatory for successful operation.";
            reference
488
              "GS NFV IFA011: Section 7.1.9.5,
489
490
491
492
493
494
495
               RequestedAdditionalCapabilityData Information
               element.";
          }

          leaf min-version {
            type string;
            description
496
              "Identifies the minimum version of the requested
497
498
               additional capability.";
            reference
499
              "GS NFV IFA011: Section 7.1.9.5,
500
501
502
503
504
505
506
507
508
509
               RequestedAdditionalCapabilityData Information
               element.";
          }

          leaf preferred-version {
            type string;
            description
              "Identifies the preferred version of the requested
               additional capability.";
            reference
510
              "GS NFV IFA011: Section 7.1.9.5,
511
512
513
514
515
516
517
518
519
520
521
522
               RequestedAdditionalCapabilityData Information
               element.";
          }
          list target-performance-parameters {
            key "key";
            leaf key {
              type string;
            }
            leaf value {
              type string;
            }
            description
523
              "Identifies specific attributes, dependent on the
524
525
               requested additional capability type.";
            reference
526
              "GS NFV IFA011: Section 7.1.9.5,
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
               RequestedAdditionalCapabilityData Information
               element.";
          }
        }

        leaf compute-requirements {
          type string;
          description
            "Specifies compute requirements.";
          reference
            "GS NFV IFA011: Section 7.1.9.2.2, VirtualComputeDesc
             Information element.";
        }

        container virtual-memory {
          leaf size {
            type decimal64 {
              fraction-digits 1;
              range "0..max";
            }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
547
548
            units "GB";
            default 1;
549
            description
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
550
              "Amount of virtual memory in GB.";
551
552
553
554
555
556
557
            reference
              "GS NFV IFA011: Section 7.1.9.3, Information elements
               related to Virtual Memory.";
          }
          leaf over-subscription-policy {
            type string;
            description
558
              "The memory core oversubscription policy in terms of
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
               virtual memory to physical memory on the platform.
               The cardinality can be 0 during the allocation
               request, if no particular value is requested.";
            reference
              "GS NFV IFA011: Section 7.1.9.3, Information elements
               related to Virtual Memory.";
          }
          list vdu-mem-requirements {
            key "key";
            leaf key {
              type string;
            }
            leaf value {
              type string;
            }
            description
              "Array of key-value pair requirements on the memory for
               the VDU.";
            reference
              "GS NFV IFA011: Section 7.1.9.3.2, VirtualMemoryData
               information element.";
          }

          leaf numa-enabled {
            type boolean;
            description
              "It specifies the memory allocation to be cognisant of
               the relevant process/core allocation. The cardinality
               can be 0 during the allocation request, if no
               particular value is requested.";
            reference
              "GS NFV IFA011: Section 7.1.9.3, Information elements
               related to Virtual Memory.";
          }
          description
            "The virtual memory of the virtualised compute.";
          reference
            "GS NFV IFA011: Section 7.1.9.2.2, VirtualComputeDesc
             Information element.";
        }
        container virtual-cpu {
          description
            "The virtual CPU(s)of the virtualised compute.";
          reference
            "GS NFV IFA011: Section 7.1.9.2.2, VirtualComputeDesc
             Information element.";

          leaf cpu-architecture {
            type string;
            description
              "CPU architecture type. Examples are x86, ARM. The
               cardinality can be 0 during the allocation request,
               if no particular CPU architecture type is requested.";
            reference
              "GS NFV IFA011: Section 7.1.9.2.3, VirtualCpuData
               information elements.";
          }
          leaf num-virtual-cpu {
            type uint16 {
              range "1..max";
            }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
620
            default 1;
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
652
653
654
655
656
657
658
659
660
661
662
663
            description
              "Number of virtual CPUs.";
            reference
              "GS NFV IFA011: Section 7.1.9.2.3, VirtualCpuData
               information elements.";
          }
          leaf clock {
            type uint32;
            units "MHz";
            description
              "Minimum virtual CPU clock rate (e.g. in MHz). The
               cardinality can be 0 during the allocation request,
               if no particular value is requested.";
            reference
              "GS NFV IFA011: Section 7.1.9.2.3, VirtualCpuData
               information elements.";
          }
          leaf oversubscription-policy {
            type string;
            description
              "The CPU core oversubscription policy e.g. the relation
               of virtual CPU cores to physical CPU cores/threads.
               The cardinality can be 0 during the allocation request,
               if no particular value is requested.";
            reference
              "GS NFV IFA011: Section 7.1.9.2.3, VirtualCpuData
               information elements.";
          }
          list vdu-cpu-requirements {
            key "key";
            leaf key {
              type string;
            }
            leaf value {
              type string;
            }
            description
              "Array of key-value pair requirements on the compute
               (CPU) for the VDU.";
            reference
              "GS NFV IFA011: Section 7.1.9.3.2, VirtualCpuData
               information element.";
          }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
664
          container pinning {
665
            presence "Set to specify CPU pinning.";
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
666
667
            leaf policy {
              default "dynamic";
668
669
670
671
672
              type enumeration {
                enum "static";
                enum "dynamic";
              }
              description
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
673
674
675
676
677
678
679
680
681
682
683
                "The policy can take values of 'static' or 'dynamic'.
                 In case of 'static' the virtual CPU cores are
                 requested to be allocated to logical CPU cores
                 according to the rules defined in
                 virtualCpuPinningRules. In case of 'dynamic' the
                 allocation of virtual CPU cores to logical CPU cores
                 is decided by the VIM. (e.g. SMT (Simultaneous
                 MultiThreading) requirements).";
              reference
                "GS NFV IFA011: Section 7.1.9.2.4,
                 VirtualCpuPinningData information element.";
684
            }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701

            list rule {
              when "../nfv:policy = 'static'";
              key "key";
              leaf key {
                type string;
              }
              leaf value {
                type string;
              }
              description
                "A 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.";
702
703
            }
            description
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
704
705
706
707
708
              "The virtual CPU pinning configuration for the
               virtualised compute resource.";
            reference
              "GS NFV IFA011: Section 7.1.9.2.3,
                 VirtualCpuData information element.";
709
710
711
          }
        }
      }
712

713
714
715
716
717
718
719
720
721
722
723
      list virtual-storage-descriptor {
        key "id";
        description
          "Storage requirements for a Virtual Storage instance
           attached to the VNFC created from this VDU";
        leaf id {
          type string;
          description
            "Unique identifier of this VirtualStorageDesc in the
             VNFD.";
          reference
724
            "GS NFV IFA011: Section 7.1.9.4, Information elements
725
726
727
728
729
             related to Virtual Storage.";
        }

        leaf type-of-storage {
          // Needed to be able to onboard images
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
730
731
732
733
          default "root-storage";
          type identityref {
	    base storage-type;
	  }
734
          description
735
            "Type of virtualised storage resource (e.g. volume,
736
737
             object).";
          reference
738
            "GS NFV IFA011: Section 7.1.9.4, Information elements
739
740
741
742
             related to Virtual Storage.";
        }
        leaf size-of-storage {
          type uint64;
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
743
744
          units "GB";
          default 0;
745
746
          description
            "Size of virtualised storage resource (e.g. size of
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
747
             volume, in GB)";
748
          reference
749
            "GS NFV IFA011: Section 7.1.9.4, Information elements
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
             related to Virtual Storage.";
        }
        list vdu-storage-requirements {
          key "key";
          leaf key {
            type string;
          }
          leaf value {
            type string;
          }
          description
            "Array of key-value pairs that articulate the storage
             deployment requirements.";
          reference
            "GS NFV IFA011: Section 7.1.9.4.2, VirtualStorageDesc
             information element.";
        }
        leaf rdma-enabled {
          type boolean;
          description
            "Indicate if the storage support RDMA.";
          reference
772
            "GS NFV IFA011: Section 7.1.9.4, Information elements
773
774
775
776
             related to Virtual Storage.";
        }
        leaf sw-image-desc {
          type leafref {
777
            path "../../sw-image-desc/id";
778
          }
779
780
781
          must "../nfv:size-of-storage >=" +
            "../../nfv:sw-image-desc[id=current()]/min-disk" {
          }
782
783
784
785
786
787
788
789
          description
            "Software image to be loaded on the VirtualStorage
             resource created based on this VirtualStorageDesc.";
          reference
            "GS NFV IFA011: Section 7.1.9.4, Information elements
             related to Virtual Storage.";
        }
      }
790

791
792
      list sw-image-desc {
        key "id";
793
794
795
796
797
798
799
800
801
802
803
804
805
806
        description
          "Defines descriptors of software images to be used by the
           VNF.";
        reference
          "GS NFV IFA011: Section 7.1.2, VNFD Information element.";
        leaf id {
          type string;
          description
            "The identifier of this software image.";
          reference
            "GS NFV IFA011: Section 7.1.6.5, SwImageDesc
             information element";
        }
        leaf name {
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
807
          mandatory true;
808
809
810
811
812
813
814
          type string;
          description
            "The name of this software image.";
          reference
            "GS NFV IFA011: Section 7.1.6.5 SwImageDesc
             information element.";
        }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
815

816
        leaf version {
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
817
	  mandatory true;
818
819
820
821
822
823
824
          type string;
          description
            "The version of this software image.";
          reference
            "GS NFV IFA011: Section 7.1.6.5 SwImageDesc
             information element.";
        }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
825

Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
826
        container checksum {
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
827

Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
828
          leaf algorithm {
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
829
	    mandatory true;
830
831
832
            type identityref {
	      base checksum-algorithm;
	    }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
833
834
835
836
837
838
839
            description
              "Species the algorithm used to obtain the checksum
               value.";
            reference
              "GS NFV IFA011: Section 7.1.6.10 ChecksumData
               information element.";
	  }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
840

Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
841
	  leaf hash {
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
842
	    mandatory true;
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
843
844
845
846
847
848
849
850
851
	    type string;
	    description
	      "Contains the result of applying the algorithm
               indicated by the algorithm attribute to the data to
               which this ChecksumData refers.";
            reference
              "GS NFV IFA011: Section 7.1.6.10 ChecksumData
               information element.";
	  }
852
853
854
855
856
857
          description
            "The checksum of the software image file.";
          reference
            "GS NFV IFA011: Section 7.1.6.5 SwImageDesc
             information element.";
        }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
858

859
        leaf container-format {
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
860
          default "bare";
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
          type enumeration {
            enum "aki" {
              description
                "An Amazon kernel image.";
            }
            enum "ami" {
              description
                "An Amazon machine image.";
            }
            enum "ari" {
              description
                "An Amazon ramdisk image.";
            }
            enum "bare" {
              description
                "The image does not have a container or metadata
                 envelope.";
            }
            enum "docker" {
              description
                "A docker container format.";
            }
            enum "ova" {
              description
                "An OVF package in a tarfile.";
            }
            enum "ovf" {
              description
                "The OVF container format.";
            }
          }
          description
            "The container format describes the container file
             format in which software image is provided.";
          reference
            "GS NFV IFA011: Section 7.1.6.5 SwImageDesc
             information element.";
        }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
899

900
        leaf disk-format {
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
901
          default "qcow2";
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
          type enumeration {
            enum "aki" {
              description
                "An Amazon kernel image.";
            }
            enum "ami" {
              description
                "An Amazon machine image.";
            }
            enum "ari" {
              description
                "An Amazon ramdisk image.";
            }
            enum "iso" {
              description
                "An archive format for the data contents of an
                 disk, such as CD-ROM.";
            }
            enum "qcow2" {
              description
                "Supported by the QEMU emulator that can expand
                 dynamically and supports Copy on Write.";
            }
            enum "raw" {
              description
                "An unstructured disk image format; if you have a
                 file without an extension it is possibly a raw
                 format.";
            }
            enum "vdi" {
              description
                "Supported by VirtualBox virtual machine monitor
                 and the QEMU emulator.";
            }
            enum "vhd" {
              description
                "The VHD disk format, a common disk format used by
                 virtual machine monitors from VMware, Xen,
                 Microsoft, VirtualBox, and others.";
            }
            enum "vhdx" {
              description
                "The VHDX disk format, an enhanced version of the
                 VHD format, which supports larger disk sizes among
                 other features.";
            }
            enum "vmdk" {
              description
                "Common disk format supported by many common virtual
                 machine monitors.";
            }
          }
          description
            "The disk format of a software image is the format of
             the underlying disk image.";
        }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
958

959
960
        leaf min-disk {
          type uint64;
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
961
          units "GB";
962
          default 0;
963
964
965
966
967
968
969
970
971
972
          description
            "The minimal disk size requirement for this software
             image. The value of the 'size of storage' attribute
             of the VirtualStorageDesc referencing this
             SwImageDesc shall not be smaller than the value of
             minDisk.";
          reference
            "GS NFV IFA011: Section 7.1.6.5, SwImageDesc
             information element.";
        }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
973

974
975
976
977
978
        leaf min-ram {
          type decimal64 {
            fraction-digits 1;
            range "0..max";
          }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
979
          units "GB";
980
          default 0;
981
982
983
984
985
986
987
988
989
990
          description
            "The minimal RAM requirement for this software image.
             The value of the 'size' attribute of
             VirtualMemoryData of the Vdu referencing this
             SwImageDesc shall not be smaller than the value of
             minRam.";
          reference
            "GS NFV IFA011: Section 7.1.6.5, SwImageDesc
             information element.";
        }
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
991

992
        leaf size {
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
993
	  mandatory true;
994
          type uint64;
Mahesh Jethanandani's avatar
Mahesh Jethanandani committed
995
          units "GB";
996
997
998
999
1000
          description
            "The size of this software image.";
          reference
            "GS NFV IFA011: Section 7.1.6.5, SwImageDesc
             information element.";
For faster browsing, not all history is shown. View entire blame