SOL005NSLifecycleManagement_def.yaml 270 KB
Newer Older
piscione's avatar
piscione committed
4001
      of the notification types to facilitate automated code generation systems.
4002
4003
4004
4005
4006
    type: object
    properties:
      nsInstanceSubscriptionFilter:
        description: >
          Filter criteria to select NS instances about which to notify.
4007
        $ref: "../../definitions/SOL005_def.yaml#/definitions/NsInstanceSubscriptionFilter"
4008
4009
4010
4011
4012
4013
4014
4015
      notificationTypes:
        description: >
          Match particular notification types.
          Permitted values:
          - NsLcmOperationOccurenceNotification
          - NsIdentifierCreationNotification
          - NsIdentifierDeletionNotification
          - NsChangeNotification
piscione's avatar
piscione committed
4016
4017

          See note.
4018
4019
4020
4021
4022
4023
4024
        type: array
        items:
          type: string
          enum:
            - NsLcmOperationOccurenceNotification
            - NsIdentifierCreationNotification
            - NsIdentifierDeletionNotification
4025
            - NsChangeNotification
4026
4027
4028
4029
4030
4031
4032
4033
4034
4035
      operationTypes:
        description: >
          Match particular NS lifecycle operation types
          for the notification of type
          NsLcmOperationOccurrenceNotification.
          May be present if the "notificationTypes"
          attribute contains the value
          "NsLcmOperationOccurrenceNotification", and
          shall be absent otherwise.
        type: array
4036
        items:
4037
4038
4039
4040
4041
4042
4043
4044
4045
4046
4047
          $ref: "#/definitions/NsLcmOpType"
      operationStates:
        description: >
          Match particular LCM operation state values as
          reported in notifications of type
          NsLcmOperationOccurrenceNotification.
          May be present if the "notificationTypes"
          attribute contains the value
          "NsLcmOperationOccurrenceNotification", and
          shall be absent otherwise.
        type: array
4048
        items:
4049
4050
4051
4052
4053
4054
4055
4056
          $ref: "#/definitions/LcmOperationStateType"
      nsComponentTypes:
        description: >
          Match particular NS component types for the
          notification of type NsChangeNotification.
          May be present if the "notificationTypes"
          attribute contains the value "NsChang.
        type: array
4057
        items:
4058
4059
4060
4061
4062
4063
4064
4065
4066
          $ref: "#/definitions/NsComponentType"
      lcmOpNameImpactingNsComponent:
        description: >
          Match particular LCM operation names for the
          notification of type NsChangeNotification.
          May be present if the "notificationTypes"
          attribute contains the value
          "NsChangeNotification", and shall be absent otherwise.
        type: array
4067
        items:
4068
4069
4070
4071
4072
4073
4074
4075
4076
4077
          $ref: "#/definitions/LcmOpNameForChangeNotificationType"
      lcmOpOccStatusImpactingNsComponent:
        description: >
          Match particular LCM operation status values
          as reported in notifications of type
          NsChangeNotification.
          May be present if the "notificationTypes"
          attribute contains the value
          "NsChangeNotification", and shall be absent otherwise.
        type: array
4078
        items:
4079
          $ref: "#/definitions/LcmOpOccStatusForChangeNotificationType"
4080

4081
4082
4083
4084
4085
4086
4087
4088
4089
4090
4091
  NsScaleInfo:
    description: >
      This type represents the target NS Scale level for each NS scaling aspect of the current deployment flavor.
    type: object
    required:
      - nsScalingAspectId
      - nsScaleLevelId
    properties:
      nsScalingAspectId:
        description: >
          Identifier of the NS scaling aspect.
4092
        $ref: "#/definitions/IdentifierInNsd"
4093
4094
4095
      nsScaleLevelId:
        description: >
          Identifier of the NS scale level.
4096
        $ref: "#/definitions/IdentifierInNsd"
4097

4098
4099
4100
  ScaleNsData:
    description: >
      This type represents the information to scale a NS.
piscione's avatar
piscione committed
4101
4102
4103
4104
4105
4106
4107
4108
4109
      NOTE 1:	No more than two attributes between vnfInstanceToBeAdded,
      vnfInstanceToBeRemoved, scaleNsByStepsData and scaleNsToLevelData shall be present.
      In case of two, the attributes shall be vnfInstanceToBeAdded and vnfInstanceToBeRemoved.
      NOTE 2:	The DF of the VNF instance shall match the VNF DF present in the associated VNF
      Profile of the new NS flavour.
      NOTE 3:	This functionality is the same as the one provided by the Update NS operation when
      the AddVnf update type is selected (see clause 7.3.5).
      NOTE 4:	This functionality is the same as the one provided by the Update NS operation when
      the RemoveVnf update type is selected (see clause 7.3.5).
4110
4111
4112
4113
4114
4115
4116
4117
    type: object
    properties:
      vnfInstanceToBeAdded:
        description: >
          An existing VNF instance to be added to the NS
          instance as part of the scaling operation. If
          needed, the VNF Profile to be used for this VNF
          instance may also be provided.
piscione's avatar
piscione committed
4118
          See note 1, note 2 and note 3.
4119
        type: array
4120
4121
        items:
          $ref: "#/definitions/VnfInstanceData"
4122
4123
4124
4125
      vnfInstanceToBeRemoved:
        description: >
          The VNF instance to be removed from the NS
          instance as part of the scaling operation.
piscione's avatar
piscione committed
4126
          See note 1 and note 4.
4127
        type: array
4128
        items:
4129
          $ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
4130
4131
4132
4133
      scaleNsByStepsData:
        description: >
          The information used to scale an NS instance by
          one or more scaling steps.
piscione's avatar
piscione committed
4134
          See note 1.
4135
        $ref: "#/definitions/ScaleNsByStepsData"
4136
4137
4138
      scaleNsToLevelData:
        description: >
          The information used to scale an NS instance to a target size.
piscione's avatar
piscione committed
4139
          See note 1.
4140
        $ref: "#/definitions/ScaleNsToLevelData"
4141
4142
4143
4144
4145
      additionalParamsForNs:
        description: >
          Allows the OSS/BSS to provide additional
          parameter(s) at the NS level necessary for the
          NS scaling (as opposed to the VNF level, which is
4146
          covered in additionalParamsForVnf).
4147
        $ref: "#/definitions/ParamsForVnf"
4148
4149
4150
4151
4152
      additionalParamsForVnf:
        description: >
          Allows the OSS/BSS to provide additional
          parameter(s) per VNF instance (as opposed to
          the NS level, which is covered in
4153
          additionalParamsforNs). This is for VNFs that are
4154
4155
4156
4157
          to be created by the NFVO as part of the NS
          scaling and not for existing VNF that are covered
          by the scaleVnfData.
        type: array
4158
4159
        items:
          $ref: "#/definitions/ParamsForVnf"
4160
4161
4162
4163
4164
4165
4166
      locationConstraints:
        description: >
          The location constraints for the VNF to be
          instantiated as part of the NS scaling.
          An example can be a constraint for the VNF to be
          in a specific geographic location.
        type: array
4167
4168
        items:
          $ref: "#/definitions/VnfLocationConstraint"
4169
4170
4171
4172
4173
4174
4175
      nestedNslocationConstraints:
        description: >
          Defines the location constraints for the nested NS to be instantiated as part of the NS instantiation.
          An example can be a constraint for the nested NS to be in a specific geographic location.
        type: array
        items:
          $ref: "#/definitions/NestedNsLocationConstraint"
4176
4177
4178
4179
4180

  ScaleVnfData:
    description: >
      This type represents defines the information to scale a VNF instance 
      to a given level, or to scale a VNF instance by steps.
piscione's avatar
piscione committed
4181
4182
4183
4184
4185
4186
4187
4188
      NOTE 1:	ETSI GS NFV-IFA 010 (available at https://www.etsi.org/deliver/etsi_gs/NFV-IFA/001_099/010/03.02.01_60/gs_NFV-IFA010v030201p.pdf)
      specifies that the lifecycle management operations that expandor contract a VNF instance
      include scale in, scale out, scale up and scale down. Vertical scaling (scale up, scale down)
      is not supported in the present document.
      NOTE 2:	Either scaletoLevelData or scaleByStepData but not both shall be present. The scaleByStepData
      is used for scale out/in type of scaling, and the scaleToLevelData is used for scale to instantiation/scale
      level type of scaling.

4189
4190
    type: object
    required:
Francesca Moscatelli's avatar
Francesca Moscatelli committed
4191
      - vnfInstanceId
4192
      - scaleVnfType
4193
4194
4195
4196
4197
    oneOf:
      - required:
          - scaleToLevelData
      - required:
          - scaleByStepData
4198
    properties:
4199
      vnfInstanceId:
4200
4201
        description: >
          Identifier of the VNF instance being scaled.
4202
        $ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
4203
4204
4205
4206
4207
4208
4209
4210
4211
      scaleVnfType:
        description: >
          Type of the scale VNF operation requested.
          Allowed values are:
          - SCALE_OUT
          - SCALE_IN
          - SCALE_TO_INSTANTIATION_LEVEL
          - SCALE_TO_SCALE_LEVEL(S)
          The set of types actually supported depends on the
piscione's avatar
piscione committed
4212
          capabilities of the VNF being managed. See note 1.
4213
        type: string
4214
        enum:
4215
          - SCALE_OUT
4216
4217
4218
          - SCALE_IN
          - SCALE_TO_INSTANTIATION_LEVEL
          - SCALE_TO_SCALE_LEVEL(S)
4219
4220
4221
      scaleToLevelData:
        description: >
          The information used for scaling to a given level.
4222
        $ref: "#/definitions/ScaleToLevelData"
4223
4224
      scaleByStepData:
        description: >
piscione's avatar
piscione committed
4225
          The information used for scaling by steps. See note 2.
4226
4227
        $ref: "#/definitions/ScaleByStepData"

4228
4229
4230
4231
4232
4233
4234
4235
4236
4237
4238
4239
4240
4241
4242
4243
4244
4245
4246
4247
4248
4249
4250
4251
  ScaleNsByStepsData:
    description: >
      This type represents the information used to scale an NS instance by one or more scaling steps, with respect to a
      particular NS scaling aspect. Performing a scaling step means increasing/decreasing the capacity of an NS instance in a
      discrete manner, i.e. moving from one NS scale level to another. The NS scaling aspects and their corresponding NS
      scale levels applicable to the NS instance are declared in the NSD.
    type: object
    required:
      - scalingDirection
      - aspectId
    properties:
      scalingDirection:
        description: >
          The scaling direction. Possible values are:
          - SCALE_IN
          - SCALE_OUT.
        type: string
        enum:
          - SCALE_IN
          - SCALE_OUT
      aspectId:
        description: >
          The aspect of the NS that is requested to be scaled, as
          declared in the NSD.
4252
        $ref: "#/definitions/IdentifierInNsd"
4253
4254
4255
4256
4257
4258
4259
4260
4261
4262
4263
4264
      numberOfSteps:
        description: >
          The number of scaling steps to be performed. Defaults to 1.
        type: integer
        default: 1

  ScaleNsToLevelData:
    description: >
      This type represents the information used to scale an NS instance to a target size. The target size is either expressed as
      an NS instantiation level or as a list of NS scale levels, one per NS scaling aspect, of the current DF. The NS
      instantiation levels, the NS scaling aspects and their corresponding NS scale levels applicable to the NS instance are
      declared in the NSD.
piscione's avatar
piscione committed
4265
      NOTE:	Either nsInstantiationLevel or nsScaleInfo, but not both, shall be present.
4266
    type: object
4267
4268
4269
4270
4271
    oneOf:
      - required:
          - nsInstantiationLevel
      - required:
          - nsScaleInfo
4272
4273
4274
4275
    properties:
      nsInstantiationLevel:
        description: >
          Identifier of the target NS instantiation level of the
piscione's avatar
piscione committed
4276
          current DF to which the NS instance is requested to be scaled. See note.
4277
        $ref: "#/definitions/IdentifierInNsd"
4278
4279
4280
      nsScaleInfo:
        description: >
          For each NS scaling aspect of the current DF, defines
piscione's avatar
piscione committed
4281
          the target NS scale level to which the NS instance is to be scaled. See note.
4282
        type: array
4283
        items:
4284
          $ref: "#/definitions/NsScaleInfo"
4285

4286
4287
4288
4289
4290
  ScaleToLevelData:
    description: >
      This type describes the information used to scale a VNF instance to a target size. The target size is either expressed as
      an instantiation level of that DF as defined in the VNFD, or given as a list of scale levels, one per scaling aspect of that
      DF. Instantiation levels and scaling aspects are declared in the VNFD. The NFVO shall then invoke the
piscione's avatar
piscione committed
4291
4292
      ScaleVnfToLevel operation towards the appropriate VNFM.
      NOTE: Either the instantiationLevelId attribute or the scaleInfo attribute shall be included.
4293
    type: object
4294
4295
4296
4297
4298
    anyOf:
      - required:
          - vnfInstantiationLevelId
      - required:
          - vnfScaleInfo
4299
4300
4301
4302
    properties:
      vnfInstantiationLevelId:
        description: >
          Identifier of the target instantiation level of the current
piscione's avatar
piscione committed
4303
          deployment flavor to which the VNF is requested to be scaled. See note.
4304
        $ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd"
4305
4306
4307
4308
      vnfScaleInfo:
        description: >
          For each scaling aspect of the current deployment
          flavor, indicates the target scale level to which the VNF
piscione's avatar
piscione committed
4309
          is to be scaled. See note.
4310
        type: array
4311
4312
        items:
          $ref: "#/definitions/VnfScaleInfo"
4313
4314
4315
4316
      additionalParams:
        description: >
          Additional parameters passed by the NFVO as input to
          the scaling process, specific to the VNF being scaled.
4317
        $ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
4318
4319
4320
4321
4322
4323

  ScaleByStepData:
    description: >
      This type describes the information to scale a VNF instance by steps. 
      The NFVO shall then invoke the Scale VNF
      operation towards the appropriate VNFM.
piscione's avatar
piscione committed
4324
      NOTE:	A scaling step is the smallest unit by which a VNF instance can be scaled w.r.t a particular scaling aspect.
4325
4326
4327
4328
4329
4330
4331
4332
    type: object
    required:
      - aspectId
    properties:
      aspectId:
        description: >
          Identifier of (reference to) the aspect of the VNF that is
          requested to be scaled, as declared in the VNFD.
4333
        $ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd"
4334
4335
4336
4337
4338
4339
4340
      numberOfSteps:
        description: >
          Number of scaling steps. It shall be a positive number.
          Defaults to 1.
          The VNF provider defines in the VNFD whether or not a
          particular VNF supports performing more than one step
          at a time. Such a property in the VNFD applies for all
piscione's avatar
piscione committed
4341
          instances of a particular VNF. See note.
4342
        type: integer
4343
        default: 1
4344
4345
4346
4347
      additionalParams:
        description: >
          Additional parameters passed by the NFVO as input to
          the scaling process, specific to the VNF instance being scaled.
4348
        $ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
4349

4350
4351
4352
4353
4354
4355
4356
4357
4358
4359
4360
4361
4362
4363
4364
4365
4366
4367
4368
4369
  LcmOperationStateType:
    description: >
      Value | Description
      ------|------------
      PROCESSING | The LCM operation is currently in execution.
      COMPLETED | The LCM operation has been completed successfully.
      PARTIALLY_COMPLETED | The LCM operation has been partially completed with accepTable errors.
      FAILED_TEMP | The LCM operation has failed and execution has stopped, but the execution of the operation is not considered to be closed.
      FAILED | The LCM operation has failed and it cannot be retried or rolled back, as it is determined that such action will not succeed.
      OLLING_BACK | The LCM operation is currently being rolled back.
      ROLLED_BACK | The LCM operation has been successfully rolled back, i.e. The state of the NS prior to the original operation invocation has been restored as closely as possible.
    type: string
    enum:
      - PROCESSING
      - COMPLETED
      - PARTIALLY_COMPLETED
      - FAILED_TEMP
      - FAILED
      - ROLLING_BACK
      - ROLLED_BACK
4370

4371
4372
4373
4374
4375
4376
4377
4378
4379
4380
4381
4382
  NsComponentType:
    description: >
      The enumeration NsComponentType represents the NS component type. It shall comply with the provisions defined in Table 6.5.4.5-1.
      Value | Description
      ------|------------
      VNF | Represents the impacted NS component is a VNF.
      PNF | Represents the impacted NS component is a PNF.
      NS | Represents the impacted NS component is a nested NS.
    type: string
    enum:
      - VNF
      - PNF
4383
      - NS
4384

4385
4386
4387
4388
4389
4390
4391
4392
4393
4394
4395
4396
4397
4398
4399
4400
4401
4402
4403
4404
4405
4406
4407
  LcmOpNameForChangeNotificationType:
    description: >
      The enumeration LcmOpNameForChangeNotificationType represents the name of the lifecycle operation that impacts the NS component and trigger an NS change notification. It shall comply with the provisions defined in Table 6.5.4.6-1.
      Value | Description
      ------|------------
      VNF_INSTANTIATE | Represents the "Instantiate VNF" LCM operation.
      VNF_SCALE | Represents the "Scale VNF" LCM operation.
      VNF_SCALE_TO_LEVEL | Represents the "Scale VNF to Level" LCM operation.
      VNF_CHANGE_FLAVOUR | Represents the "Change VNF Flavor" LCM operation.
      VNF_TERMINATE | Represents the "Terminate VNF" LCM operation.
      VNF_HEAL | Represents the "Heal VNF" LCM operation.
      VNF_OPERATE | Represents the "Operate VNF" LCM operation.
      VNF_CHANGE_EXT_CONN | Represents the "Change external VNF connectivity" LCM operation.
      VNF_MODIFY_INFO | Represents the "Modify VNF Information" LCM operation.           
      NS_INSTANTIATE | Represents the "Instantiate NS" LCM operation
      NS_SCALE | Represents the "Scale NS" LCM operation.
      NS_UPDATE | Represents the "Update NS" LCM operation.
      NS_TERMINATE | Represents the "Terminate NS" LCM operation.
      NS_HEAL | Represents the "Heal NS" LCM operation.
    type: string
    enum:
      - VNF_INSTANTIATE
      - VNF_SCALE
4408
      - VNF_SCALE_TO_LEVEL
4409
4410
4411
4412
4413
4414
4415
4416
      - VNF_CHANGE_FLAVOUR
      - VNF_TERMINATE
      - VNF_HEAL
      - VNF_OPERATE
      - VNF_CHANGE_EXT_CONN
      - VNF_MODIFY_INFO
      - NS_INSTANTIATE
      - NS_SCALE
4417
      - NS_UPDATE
4418
4419
      - NS_TERMINATE
      - NS_HEAL
4420

4421
4422
4423
4424
4425
4426
4427
4428
4429
  LcmOpOccStatusForChangeNotificationType:
    description: >
      The enumeration LcmOpOccStatusForChangeNotificationType represents the status of the lifecycle management
      operation occurrence that impacts the NS component and triggers an NS change notification. It shall comply with the
      provisions defined in Table 6.5.4.7-1.
      Value | Description
      ------|------------
      START | The impact on the NS component is identified.
      COMPLETED | The impact on the NS component stops and related lifecycle operation completes successfully.
4430
      PARTIALLY_COMPLETED | The impact on the NS component stops and related lifecycle operation partially completes. Inconsistency state may exist on the NS       component.
4431
4432
4433
4434
4435
4436
      FAILED | The impact on the NS component stops and related lifecycle operation fails. Inconsistency state may exist for the NS component.
      ROLLED_BACK | The impact on the NS component stops and related lifecycle operation is rolled back.
    type: string
    enum:
      - START
      - COMPLETED
4437
      - PARTIALLY_COMPLETED
4438
      - FAILED
4439
4440
4441
4442
4443
4444
      - ROLLED_BACK

  NsLcmOpOcc:
    description: >
      This type represents a request a NS lifecycle operation occurrence.
      It shall comply with the provisions defined in Table 6.5.2.3-1.
piscione's avatar
piscione committed
4445
4446
4447
4448
4449
4450
4451
4452

      NOTE 1:	This allows the OSS/BSS to obtain a copy of the latest "result" notification if it has not received
      it due to an error. If the notification represents the successful result of a lifecycle operation, at least
      an affectedVnf, or affectedPnf, or affectedVl, or affectedVnffg or affectedNs, or affectedSap shall be present.

      NOTE 2:	A coordination action has timed out if the NFVO has not been able to read the "Individual coordination
      action" resource within a timeout interval after requesting the coordination to be started or to be cancelled.
      The length of the timeout interval is defined by means outside the scope of the present document
4453
4454
4455
4456
    type: object
    required:
      - id
      - operationState
4457
      - statusEnteredTime
4458
4459
4460
4461
4462
4463
4464
4465
4466
4467
      - nsInstanceId
      - lcmOperationType
      - startTime
      - isAutomaticInvocation
      - isCancelPending
      - _links
    properties:
      id:
        description: >
          Identifier of this NS lifecycle operation occurrence.
4468
4469
4470
4471
4472
4473
4474
4475
4476
4477
          NOTE 1:	This allows the OSS/BSS to obtain a copy of the latest "result"
          notification if it has not received it due to an error. If the notification
          represents the successful result of a lifecycle operation, at least an affectedVnf,
          or affectedPnf, or affectedVl, or affectedVnffg or affectedNs, or affectedSap
          shall be present.

          NOTE 2:	A coordination action has timed out if the NFVO has not been able to read
          the "Individual coordination action" resource within a timeout interval after requesting
          the coordination to be started or to be cancelled. The length of the timeout interval
          is defined by means outside the scope of the present document.
4478
        $ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
4479
4480
4481
      operationState:
        description: >
          The state of the NS LCM operation.
4482
        $ref: "#/definitions/NsLcmOperationStateType"
4483
      stateEnteredTime:
4484
        description: >
4485
          Date-time when the current state has been entered.
4486
        $ref: "../../definitions/SOL005_def.yaml#/definitions/DateTime"
4487
4488
4489
      nsInstanceId:
        description: >
          Identifier of the NS instance to which the operation applies.
4490
        $ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
4491
4492
4493
4494
      lcmOperationType:
        description: >
          Type of the actual LCM operation represented by this
          lcm operation occurrence.
4495
        $ref: "#/definitions/NsLcmOpType"
4496
4497
4498
      startTime:
        description: >
          Date-time of the start of the operation.
4499
        $ref: "../../definitions/SOL005_def.yaml#/definitions/DateTime"
4500
4501
4502
4503
4504
4505
4506
4507
4508
4509
4510
4511
4512
4513
4514
4515
4516
4517
4518
4519
4520
4521
4522
4523
4524
4525
4526
4527
4528
4529
4530
4531
4532
4533
4534
4535
4536
4537
4538
4539
4540
4541
4542
4543
4544
4545
4546
4547
4548
4549
4550
      isAutomaticInvocation:
        description: >
          Set to true if this NS LCM operation occurrence has
          been automatically triggered by the NFVO. This occurs
          in the case of auto-scaling, auto-healing and when a
          nested NS is modified as a result of an operation on its
          composite NS. Set to false otherwise.
        type: boolean
      operationParams:
        description: >
          Input parameters of the LCM operation. This attribute
          shall be formatted according to the request data type of
          the related LCM operation.
          The following mapping between lcmOperationType and
          the data type of this attribute shall apply:
          - INSTANTIATE: InstantiateNsRequest
          - SCALE: ScaleNsRequest
          - UPDATE: UpdateNsRequest
          - HEAL: HealNsRequest
          - TERMINATE: TerminateNsRequest
          This attribute shall be present if this data type is returned
          in a response to reading an individual resource, and may
          be present according to the chosen attribute selector
          parameter if this data type is returned in a response to a
          query of a container resource.
        type: string
        enum:
          - INSTANTIATE
          - SCALE
          - UPDATE
          - HEAL
          - TERMINATE
      isCancelPending:
        description: >
          If the LCM operation occurrence is in "PROCESSING"
          or "ROLLING_BACK" state and the operation is being
          cancelled, this attribute shall be set to true. Otherwise, it
          shall be set to false.
        type: boolean
      cancelMode:
        description: >
          The mode of an ongoing cancellation. Shall be present
          when isCancelPending=true, and shall be absent otherwise.
        $ref: "#/definitions/CancelModeType"
      error:
        description: >
          If "operationState" is "FAILED_TEMP" or "FAILED" or "operationState"
          is "PROCESSING" or "ROLLING_BACK" and previous value of
          "operationState" was "FAILED_TEMP", this attribute shall be present
          and contain error information, unless it has been requested to be
          excluded via an attribute selector.
4551
        $ref: "../../definitions/SOL005_def.yaml#/definitions/ProblemDetails"
4552
4553
4554
4555
4556
4557
4558
4559
4560
4561
4562
      resourceChanges:
        description: >
          This attribute contains information about the cumulative
          changes to virtualised resources that were performed so
          far by the LCM operation since its start, if applicable
        type: object
        properties:
          affectedVnfs:
            description: >
              Information about the VNF instances that were affected
              during the lifecycle operation, if this notification
4563
              represents the result of a lifecycle operation. See note 1.
4564
4565
            type: array
            items:
4566
              $ref: "#/definitions/AffectedVnf"
4567
4568
4569
4570
          affectedPnfs:
            description: >
              Information about the PNF instances that were affected
              during the lifecycle operation, if this notification
4571
              represents the result of a lifecycle operation. See note 1.
4572
4573
            type: array
            items:
4574
              $ref: "#/definitions/AffectedPnf"
4575
4576
4577
4578
          affectedVls:
            description: >
              Information about the VL instances that were affected
              during the lifecycle operation, if this notification
4579
              represents the result of a lifecycle operation. See note 1.
4580
4581
            type: array
            items:
4582
              $ref: "#/definitions/AffectedVirtualLink"
4583
4584
4585
4586
          affectedVnffgs:
            description: >
              Information about the VNFFG instances that were
              affected during the lifecycle operation, if this notification
4587
              represents the result of a lifecycle operation. See note 1.
4588
4589
            type: array
            items:
4590
              $ref: "#/definitions/AffectedVnffg"
4591
4592
4593
4594
          affectedNss:
            description: >
              Information about the nested NS instances that were
              affected during the lifecycle operation, if this notification
4595
              represents the result of a lifecycle operation. See note 1.
4596
4597
            type: array
            items:
4598
              $ref: "#/definitions/AffectedNs"
4599
4600
4601
4602
          affectedSaps:
            description: >
              Information about the nested NS instances that were
              affected during the lifecycle operation, if this notification
4603
              represents the result of a lifecycle operation. See note 1.
4604
4605
            type: array
            items:
4606
              $ref: "#/definitions/AffectedSap"
4607
4608
4609
4610
4611
4612
4613
4614
4615
4616
4617
4618
4619
4620
4621
4622
4623
4624
4625
4626
4627
4628
4629
4630
4631
4632
4633
4634

      lcmCoordinations:
        description: >
          Information about LCM coordination actions (see clause 12.5.4.3)
          related to this LCM operation occurrence.
        type: array
        items:
          type: object
          required:
              - id
              - coordinationActionName
              - startTime
              - endpointType
          properties:
              id:
               description: >
                Identifier of this coordination action. For a terminated coordination action,
                this attribute refers to the "id" attribute in the LcmCoord data structure
                (see clause 12.5.2.3). For a timed-out or ongoing coordination action, this
                attribute refers to the {coordinationId} URI variable in the "Location" header
                of the "202 Accepted" HTTP response to the POST request that has initiated the
                coordination action (see clause 12.4.2.3.1).
               $ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"

              coordinationActionName:
                description: >
                  Indicator of the actual coordination action.
                $ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
4635
4636
4637
4638
4639
4640
4641
4642
              coordinationResult:
                description: >
                  The result of executing the coordination action which also implies the action
                  to be performed by the NFVO as the result of this coordination.
                  Shall be present if the coordination has been finished. Shall be absent if
                  the coordination is ongoing or has timed out (see note 2).
                $ref: "../../NSLCMCoordination/definitions/SOL005NSLCMCoordination_def.yaml#/definitions/LcmCoordResultType"

4643
4644
4645
4646
4647
4648
4649
4650
4651
4652
4653
4654
4655
4656
4657
4658
4659
4660
4661
4662
4663
4664
4665
4666
4667
4668
4669
4670
4671
              startTime:
                description: >
                  The time when the coordination action has been started.
                $ref: "../../definitions/SOL005_def.yaml#/definitions/DateTime"
              endTime:
                description: >
                  The end time of the coordination action. Shall be present for a coordination
                  action that has finished or timed out (see note 2) and shall be absent if the
                  coordination is ongoing.
                $ref: "../../definitions/SOL005_def.yaml#/definitions/DateTime"
              endpointType:
                description: >
                  The endpoint type used by this coordination action.
                  Valid values:
                  -	MGMT: coordination with other operation supporting management systems (e.g. OSS/BSS)
                type: string
                enum:
                  - MGMT
              warnings:
                description: >
                  Warning messages that were generated while the operation was executing.

                  If the operation has included VNF LCM operations or NS LCM coordination
                  actions and these have resulted in warnings, such warnings should be
                  added to this attribute.
                type: array
                items:
                  type: string

4672
4673
4674
4675
4676
4677
4678
4679
4680
4681
4682
      _links:
        description: >
          Links to resources related to this resource.
        type: object
        required:
          - self
          - nsInstance
        properties:
          self:
            description: >
              URI of this resource.
4683
            $ref: "../../definitions/SOL005_def.yaml#/definitions/Link"
4684
4685
4686
          nsInstance:
            description: >
              Link to the NS instance that the operation applies to.
4687
            $ref: "../../definitions/SOL005_def.yaml#/definitions/Link"
4688
4689
4690
4691
4692
          cancel:
            description: >
              Link to the task resource that represents the "cancel"
              operation for this LCM operation occurrence, if
              cancelling is currently allowed.
4693
            $ref: "../../definitions/SOL005_def.yaml#/definitions/Link"
4694
4695
4696
4697
4698
          retry:
            description: >
              Link to the task resource that represents the "cancel"
              operation for this LCM operation occurrence,
              if cancelling is currently allowed.
4699
            $ref: "../../definitions/SOL005_def.yaml#/definitions/Link"
4700
4701
4702
4703
4704
          rollback:
            description: >
              Link to the task resource that represents the "rollback"
              operation for this LCM operation occurrence, if rolling
              back is currently allowed.
4705
            $ref: "../../definitions/SOL005_def.yaml#/definitions/Link"
4706
4707
4708
4709
4710
          continue:
            description: >
              Link to the task resource that represents the "continue"
              operation for this LCM operation occurrence, if rolling
              back is currently allowed.
4711
            $ref: "../../definitions/SOL005_def.yaml#/definitions/Link"
4712
4713
4714
4715
4716
          fail:
            description: >
              Link to the task resource that represents the "fail"
              operation for this LCM operation occurrence, if rolling
              back is currently allowed.
4717
4718
4719
4720
4721
4722
4723
4724
4725
4726
4727
4728
4729
4730
4731
4732
4733
4734
4735
4736
4737
4738
4739
4740
4741
4742
4743
4744
4745
4746
4747
4748
4749
4750
4751
4752
4753
            $ref: "../../definitions/SOL005_def.yaml#/definitions/Link"

  subscriptionId:
    description: >
      Identifier of the subscription that this notification relates to.
    type: string

  nsInstanceId:
    description: >
      The deleted NS instance identifier.
    type: string

  CpProtocolData:
    description: >
      This type represents network protocol data.
    type: object
    required:
      - layerProtocol
    properties:
      layerProtocol:
        description: >
          Identifier of layer(s) and protocol(s).
          Permitted values: IP_OVER_ETHERNET.
        type: string
        enum:
          - IP_OVER_ETHERNET
      ipOverEthernet:
        description: >
          Network address data for IP over Ethernet to
          assign to the extCP instance. Shall be
          present if layerProtocol is equal to
          "IP_OVER_ETHERNET", and shall be absent otherwise.
        $ref: "#/definitions/IpOverEthernetAddressData"

  IpOverEthernetAddressData:
    description: >
      This type represents network address data for IP over Ethernet.
piscione's avatar
piscione committed
4754
4755
4756
4757
4758
4759
4760
4761
4762
4763
      NOTE 1:	At least one of "macAddress" or "ipAddresses" shall be present.
      NOTE 2:	Exactly one of "fixedAddresses", "numDynamicAddresses" or "ipAddressRange" shall be present.
      NOTE 3:	If the CP instance represents a subport in a trunk, "segmentationId" shall be present.
      Otherwise it shall not be present.
      NOTE 4:	Depending on the NFVI networking infrastructure, the "segmentationId" may indicate
      the actual network segment value (e.g. vlan Id, Vxlan segmentation id, etc.) used in the transport
      header of the packets or it may be an identifier used between the application and the NFVI networking
      infrastructure to identify the network sub-interface of the trunk port in question. In the latter
      case the NFVI infrastructure will map this local "segmentationId" to whatever "segmentationId" is actually
      used by the NFVI's transport technology.
4764
    type: object
4765
4766
4767
4768
4769
    anyOf:
      - required:
          - ipAddresses
      - required:
          - macAddress
4770
4771
4772
4773
    properties:
      macAddress:
        description: >
          MAC address. If this attribute is not present, it shall be chosen by the NFV MANO.
piscione's avatar
piscione committed
4774
          See note 1.
4775
        $ref: "#/definitions/MacAddress"
4776
4777
4778
4779
4780
4781
4782
4783
4784
4785
4786
4787
      segmentationType:
        description: >
          Specifies the encapsulation type for the traffics coming in and out of the trunk subport.
          Permitted values are:
          -	VLAN: The subport uses VLAN as encapsulation type.
          -	INHERIT: The subport gets its segmentation type from the network it is connected to.
          This attribute may be present for CP instances that represent subports in a trunk and shall be absent otherwise.
          If this attribute is not present for a subport CP instance, default value VLAN shall be used.
        type: string
        enum:
         - VLAN
         - INHERIT
4788
4789
      segmentationId:
        description: >
piscione's avatar
piscione committed
4790
          Identification of the network segment to which the CP instance connects to. See note 3 and note 4.
4791
        type: string
4792
4793
4794
4795
4796
      ipAddresses:
        description: >
          List of IP addresses to assign to the CP instance. Each entry
          represents IP address data for fixed or dynamic IP address
          assignment per subnet.
piscione's avatar
piscione committed
4797
          If this attribute is not present, no IP address shall be assigned. See note 1.
4798
4799
4800
4801
4802
        type: array
        items:
          type: object
          required:
            - type
4803
4804
4805
4806
4807
4808
4809
          oneOf:
            - required:
                - fixedAddresses
            - required:
                - numDynamicAddresses
            - required:
                - addressRange
4810
4811
4812
4813
          properties:
            type:
              description: >
                The type of the IP addresses.
4814
4815
4816
                Permitted values:
                  - IPV4
                  - IPV6
4817
4818
4819
4820
4821
4822
4823
4824
4825
4826
4827
4828
              type: string
              enum:
                - IPV4
                - IPV6
            fixedAddresses:
              description: >
                Fixed addresses to assign (from the subnet defined by
                "subnetId" if provided).
                Exactly one of "fixedAddresses", "numDynamicAddresses" or
                "ipAddressRange" shall be present.
              type: array
              items:
4829
                $ref: "#/definitions/IpAddress"
4830
4831
4832
4833
            numDynamicAddresses:
              description: >
                Number of dynamic addresses to assign (from the subnet defined
                by "subnetId" if provided).
piscione's avatar
piscione committed
4834
                See note 2.
4835
4836
4837
4838
4839
4840
4841
4842
4843
4844
4845
4846
4847
4848
4849
              type: integer
            addressRange:
              description: >
                An IP address range to be used, e.g. in case of egress
                connections.
                In case this attribute is present, IP addresses from the range
                will be used.
              type: object
              required:
                - minAddress
                - maxAddress
              properties:
                minAddress:
                  description: >
                    Lowest IP address belonging to the range.
4850
                  $ref: "#/definitions/IpAddress"
4851
4852
4853
                maxAddress:
                  description: >
                    Highest IP address belonging to the range.
4854
                  $ref: "#/definitions/IpAddress"
4855
4856
4857
4858
4859
4860
4861
            subnetId:
              description: >
                Subnet defined by the identifier of the subnet resource in the
                VIM.
                In case this attribute is present, IP addresses from that
                subnet will be assigned; otherwise, IP addresses not bound to
                a subnet will be assigned.
4862
              $ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVim"
4863
4864
4865

  ExtVirtualLinkData:
    description: >
piscione's avatar
piscione committed
4866
4867
4868
4869
4870
4871
4872
4873
4874
4875
4876
      This type represents an external VL.

      NOTE:	A link port is not needed for an external CP instance that exposes a VIP CP in the following cases:
      1.	For a VIP CP directly exposed as extCP:
        1.1.	no dedicated IP address is allocated as VIP address, as indicated in the VNFD
        1.2.	a dedicated IP address is allocated as VIP address,
        but the NFVO indicates that no port is needed (createExtLinkPort in VnfExtCpConfig set to false).
      2.	For a VIP CP exposed as extCP via a floating IP address:
      2.1.	no dedicated IP address is allocated as VIP address, as indicated in the VNFD,
        and the VNFC CP associated to the VIP CP is also exposed via a floating IP address.

4877
4878
4879
4880
4881
4882
4883
4884
4885
4886
4887
4888
4889
4890
4891
4892
4893
4894
4895
4896
4897
4898
4899
4900
4901
4902
4903
4904
    type: object
    required:
      - resourceId
      - extCps
    properties:
      extVirtualLinkId:
        description: >
          The identifier of the external VL instance, if provided.
        $ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
      vimId:
        description: >
          Identifier of the VIM that manages this resource. This
          attribute shall only be supported and present if VNFrelated
          resource management in direct mode is applicable.
        $ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
      resourceProviderId:
        description: >
          Identifies the entity responsible for the management of
          this resource.
          This attribute shall only be supported and present if
          VNF-related resource management in indirect mode is
          applicable. The identification scheme is outside the
          scope of the present document.
        $ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
      resourceId:
        description: >
          The identifier of the resource in the scope of the VIM or
          the resource provider.
4905
        $ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVim"
4906
4907
4908
4909
4910
4911
4912
4913
4914
      extCps:
        description: >
          External CPs of the VNF to be connected to this external VL.
        type: array
        items:
          $ref: "#/definitions/VnfExtCpData"
      extLinkPorts:
        description: >
          Externally provided link ports to be used to connect
4915
4916
4917
          external connection points to this external VL unless
          the extCp exposes a VIP CP and a link port is not needed
          for it based on the conditions defined below.
piscione's avatar
piscione committed
4918
          See note.
4919
4920
4921
4922
4923
4924
4925
4926
4927
4928
        type: array
        items:
          $ref: "#/definitions/ExtLinkPortData"

  ExtManagedVirtualLinkData:
    description: >
      This type represents an externally-managed internal VL.
      It shall comply with the provisions defined in Table 6.5.3.27-1.
    type: object
    required:
4929
      - vnfVirtualLinkDescId
4930
4931
4932
4933
4934
4935
4936
      - resourceId
    properties:
      extManagedVirtualLinkId:
        description: >
          The identifier of the externally-managed internal VL
          instance, if provided.
        $ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
4937
      vnfVirtualLinkDescId:
4938
4939
        description: >
          The identifier of the VLD in the VNFD for this VL.
4940
        $ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd"
4941
4942
4943
4944
4945
4946
4947
4948
4949
4950
4951
4952
4953
4954
4955
4956
4957
4958
      vimId:
        description: >
          Identifier of the VIM that manage this resource. This
          attribute shall only be supported and present if VNFrelated
          resource management in direct mode is applicable.
        $ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
      resourceProviderId:
        description: >
          Identifies the entity responsible for the management of
          this resource. This attribute shall only be supported and present if
          VNF-related resource management in indirect mode is
          applicable. The identification scheme is outside the
          scope of the present document.
        $ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
      resourceId:
        description: >
          The identifier of the resource in the scope of the VIM or
          the resource provider.
4959
        $ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVim"
4960
4961
4962
4963
4964
4965
4966
4967
4968
4969
4970
4971
4972
4973
4974
4975
      vnfLinkPort:
        description: >
          Externally provided link ports to be used to connect VNFC connection points to this externally-managed VL on
          this network resource. If this attribute is not present, the VNFM shall create the link ports on the
          externally-managed VL.
        type: array
        items:
          $ref: "#/definitions/VnfLinkPortData"
      extManagedMultisiteVirtualLinkId:
        description: >
          Identifier of the externally-managed multi-site VL instance. The identifier is assigned by the NFV-MANO entity
          that manages the externally managed multi-site VL instance. It shall be present when the present externally-managed
          internal VL (indicated by extManagedVirtualLinkId) is part of a multi-site VL, e.g., in support of multi-site VNF
          spanning several VIMs. All externally-managed internal VL instances corresponding to an internal VL created based
          on the same virtualLinkDescId shall refer to the same extManagedMultisiteVirtualLinkId.
        $ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
4976
4977
4978
4979
4980

  VnfExtCpData:
    description: >
      This type represents configuration information for external CPs created
      from a CPD.
piscione's avatar
piscione committed
4981
4982
4983
4984
4985
4986
4987
4988
4989
4990
4991
4992
4993
4994
4995

      NOTE 1:	In case this identifier refers to a CPD with trunking enabled, the external
      CP instances created from this CPD will represent ports in a trunk.
      NOTE 2: 	The map entry value shall be set to "null" in order to delete a "VnfExtCpConfig"
      entry identified by a particular key value from the map, i.e. for the disconnection of an
      existing external CP instance addressed by cpInstanceId in the deleted map entry from a particular
      external virtual link, and deletion of that instance in case it represents a subport. Deleting
      the last key from the map removes the affected instance of the "VnfExtCpData" structure from its
      parent data structure.
      NOTE 3: 	Within one VNF instance, all VNFC instances created from a particular VDU have the
      same external connectivity. Thus, given a particular value of the "cpdId' attribute, there
      shall be one "cpConfig" entry for each VNFC instance that has been or can be created from
      a VDU which includes a CPD identified by the "cpdId" attribute. If the cpConfig represents
      a subport in a trunk, all "cpConfig" entries in this list shall have the same segmentationId,
      which means they are connected to the same set of external VLs via the trunk.
4996
4997
4998
4999
5000
    type: object
    required:
      - cpdId
    properties:
      cpdId:
For faster browsing, not all history is shown. View entire blame