Newer
Older
rameshnaraya
committed
# Copyright (c) ETSI 2017.
# https://forge.etsi.org/etsi-forge-copyright-notice.txt
definitions:
Samir Medjiah
committed
HealNsRequest:
description: >
This type represents request parameters for the "Heal NS" operation. This operation supports the healing of an NS
instance, either by healing the complete NS instance or by healing one of more of the VNF instances that are part of this
NS. It shall comply with the provisions defined in Table 6.5.2.13-1.
Either the parameter healNsData or the parameter healVnfData, but not both shall be provided.
Samir Medjiah
committed
type: object
oneOf:
- required:
- healNsData
- required:
- healVnfData
Samir Medjiah
committed
properties:
healNsData:
description: >
Provides the information needed to heal an NS. See note
Samir Medjiah
committed
$ref: "#/definitions/HealNsData"
healVnfData:
description: >
Provides the information needed to heal a VNF. See note.
Samir Medjiah
committed
type: array
items:
$ref: "#/definitions/HealVnfData"
CancelMode:
description: >
This type represents a parameter to select the mode of canceling an ongoing NS LCM operation occurrence.
It shall comply with the provisions defined in Table 6.5.2.16-1.
type: object
required:
- cancelMode
properties:
cancelMode:
description: >
Cancellation mode to apply.
$ref: "#/definitions/CancelModeType"
HealNsData:
description: >
This type represents the information used to heal a NS.
It shall comply with the provisions defined in Table 6.5.3.43-1.
type: object
required:
- degreeHealing
oneOf:
- required:
- actionsHealing
- required:
- healScript
Samir Medjiah
committed
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
properties:
degreeHealing:
description: >
Indicates the degree of healing. Possible values
include:
- HEAL_RESTORE: Complete the healing of
the NS restoring the state of the NS before
the failure occurred
- HEAL_QOS: Complete the healing of the NS
based on the newest QoS values
- HEAL_RESET: Complete the healing of the
NS resetting to the original instantiation state of the NS
- PARTIAL_HEALING
type: string
enum:
- HEAL_RESTORE
- HEAL_QOS
- HEAL_RESET
- PARTIAL_HEALING
actionsHealing:
description: >
Used to specify dedicated healing actions in a
particular order (e.g. as a script). The actionsHealing
attribute can be used to provide a specific script whose
content and actions might only be possible to be
derived during runtime.
type: array
items:
$ref: "../../definitions/SOL005_def.yaml#/definitions/String"
healScript:
description: >
Reference to a script from the NSD that shall be used
to execute dedicated healing actions in a particular
order. The healScript, since it refers to a script in the
NSD, can be used to execute healing actions which
are defined during NS design time.
$ref: "#/definitions/IdentifierInNsd"
Samir Medjiah
committed
additionalParamsforNs:
description: >
Allows the OSS/BSS to provide additional
parameter(s) to the healing process at the NS level.
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
HealVnfData:
description: >
This type represents the information to heal a VNF that is part of an NS.
The NFVO shall then invoke the Heal VNF operation towards the appropriate VNFM.
Samir Medjiah
committed
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
It shall comply with the provisions defined in Table 6.5.3.44-1.
type: object
required:
- vnfInstanceId
properties:
vnfInstanceId:
description: >
Identifies the VNF instance, part of the NS, requiring a
healing action.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
cause:
description: >
Indicates the reason why a healing procedure is required.
type: string
additionalParams:
description: >
Additional parameters passed by the NFVO as input to
the healing process, specific to the VNF being healed.
EXAMPLE: Input parameters to VNF-specific healing procedures.
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
TerminateNsRequest:
description: >
This type represents a NS termination request.
It shall comply with the provisions defined in Table 6.5.2.15-1.
type: object
properties:
terminationTime:
description: >
Timestamp indicating the end time of the NS, i.e. the NS
will be terminated automatically at this timestamp.
Cardinality "0" indicates the NS termination takes place immediately
$ref: "../../definitions/SOL005_def.yaml#/definitions/DateTime"
CreateNsRequest:
type: object
required:
- nsdId
- nsName
- nsDescription
properties:
nsdId:
description: >
Identifier of the NSD that defines the NS instance to be
created.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
nsName:
description: >
Human-readable name of the NS instance to be created.
type: string
nsDescription:
description: >
Human-readable description of the NS instance to be created.
type: string
moscatelli
committed
CancelModeType:
description: >
Cancellation mode.
The NFVO shall not start any new VNF lifecycle management and resource
management operation, and shall wait for the ongoing VNF lifecycle management
and resource management operations in the underlying system, typically the VNFM
and VIM, to finish execution or to time out. After that, the NFVO shall put the
operation occurrence into the FAILED_TEMP state.
The NFVO shall not start any new VNF lifecycle management and resource
management operation, shall cancel the ongoing VNF lifecycle management and
resource management operations in the underlying system, typically the VNFM and
VIM, and shall wait for the cancellation to finish or to time out. After that, the NFVO
shall put the operation occurrence into the FAILED_TEMP state.
type: string
enum:
- GRACEFUL
- FORCEFUL
NsInstance:
description: >
This type represents a response for Query NS operation.
It shall comply with the provisions defined in Table 6.5.2.10-1.
type: object
required:
- id
- nsInstanceName
- nsInstanceDescription
- nsdId
- nsdInfoId
- nsState
properties:
id:
description: >
Identifier of the NS instance.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
nsInstanceName:
description: >
Human readable name of the NS instance.
type: string
nsInstanceDescription:
description: >
Human readable description of the NS instance.
type: string
nsdId:
description: >
Identifier of the NSD on which the NS instance is based. The value is copied from the NSD.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
nsdInfoId:
description: >
Identifier of the NSD information object on which the
NS instance is based. This identifier has been allocated by the NFVO.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
flavourId:
description: >
Identifier of the NS deployment flavor applied to
the NS instance. This attribute shall be present if the nsState attribute
value is INSTANTIATED.
$ref: "#/definitions/IdentifierInNsd"
vnfInstance:
description: >
Information on constituent VNF(s) of the NS instance.
type: array
items:
moscatelli
committed
$ref: "#/definitions/VnfInstance"
pnfInfo:
description: >
Information on the PNF(s) that are part of the NS instance.
type: array
items:
moscatelli
committed
$ref: "#/definitions/PnfInfo"
virtualLinkInfo:
description: >
Information on the VL(s) of the NS instance.
This attribute shall be present if the nsState attribute
value is INSTANTIATED and if the NS instance has
specified connectivity.
type: array
items:
moscatelli
committed
$ref: "#/definitions/NsVirtualLinkInfo"
vnffgInfo:
description: >
Information on the VNFFG(s) of the NS instance.
type: array
items:
moscatelli
committed
$ref: "#/definitions/VnffgInfo"
sapInfo:
description: >
Information on the SAP(s) of the NS instance.
type: array
moscatelli
committed
items:
$ref: "#/definitions/SapInfo"
nestedNsInstanceId:
description: >
Identifier of the nested NS(s) of the NS instance.
type: array
moscatelli
committed
items:
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
vnfSnapshotInfoIds:
description: >
Identifier of information on VNF snapshots of VNF instances that are part of this NS instance.
type: array
items:
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
nsState:
description: >
The state of the NS instance.
Permitted values:
NOT_INSTANTIATED: The NS instance is
terminated or not instantiated.
INSTANTIATED: The NS instance is instantiated.
type: string
moscatelli
committed
enum:
moscatelli
committed
- INSTANTIATED
monitoringParameter:
description: >
Performance metrics tracked by the NFVO (e.g. for
auto-scaling purposes) as identified by the NS
designer in the NSD.
type: array
items:
$ref: "#/definitions/NsMonitoringParameter"
nsScaleStatus:
description: >
Status of each NS scaling aspect declared in the
applicable DF, how "big" the NS instance has been
scaled w.r.t. that aspect.
This attribute shall be present if the nsState attribute
rameshnaraya
committed
value is INSTANTIATED.
moscatelli
committed
$ref: "#/definitions/NsScaleInfo"
additionalAffinityOrAntiAffinityRule:
description: >
Information on the additional affinity or anti-affinity
rule from NS instantiation operation. Shall not
conflict with rules already specified in the NSD.
type: array
moscatelli
committed
items:
$ref: "#/definitions/AffinityOrAntiAffinityRule"
wanConnectionInfo:
description: >
Information about WAN related connectivity enabling multi-site VLs.
type: array
items:
$ref: "#/definitions/WanConnectionInfo"
rameshnaraya
committed
description: Links to resources related to this resource.
required:
- self
properties:
self:
description: >
URI of this resource.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Link"
nestedNsInstances:
description: >
Links to resources related to this notification.
type: array
items:
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Link"
vnfSnapshotInfos:
description: >
Links to the VNF snapshots associated to VNF instances which are part of this NS instance.
type: array
items:
$ref: "../../definitions/SOL005_def.yaml#/definitions/Link"
instantiate:
description: >
Link to the "instantiate" task resource, if the related
operation is possible based on the current status of
this NS instance resource (i.e. NS instance in
NOT_INSTANTIATED state).
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Link"
terminate:
description: >
Link to the "terminate" task resource, if the related
operation is possible based on the current status of
this NS instance resource (i.e. NS instance is in
INSTANTIATED state).
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Link"
update:
description: >
Link to the "update" task resource, if the related
operation is possible based on the current status of
this NS instance resource (i.e. NS instance is in
INSTANTIATED state).
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Link"
scale:
description: >
Link to the "scale" task resource, if the related
operation is supported for this NS instance, and is
possible based on the current status of this NS
instance resource (i.e. NS instance is in
INSTANTIATED state).
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Link"
heal:
description: >
Link to the "heal" task resource, if the related
operation is supported for this NS instance, and is
possible based on the current status of this NS
instance resource (i.e. NS instance is in
INSTANTIATED state).
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Link"
moscatelli
committed
VnfInstance:
description: >
This type represents a VNF instance.
Clause B.3.2 of ETSI GS NFV-SOL 003 [4] provides examples illustrating the relationship among the
different run-time information elements (CP, VL and link ports) used to represent the connectivity of a
VNF.
type: object
required:
- id
- vnfdId
- vnfProvider
- vnfProductName
- vnfSoftwareVersion
- vnfdVersion
- vnfPkgId
- instantiationState
properties:
id:
description: >
Identifier of the VNF instance.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
vnfInstanceName:
description: >
Name of the VNF instance.
Modifications to this attribute can be requested using the "ModifyVnfInfoData" structure.
type: string
vnfInstanceDescription:
description: >
Human-readable description of the VNF instance.
Modifications to this attribute can be requested using the "ModifyVnfInfoData" structure.
type: string
vnfdId:
description: >
Identifier of the VNFD on which the VNF instance is based.
Modifications to this attribute can be requested using the "ModifyVnfInfoData" structure.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
vnfProvider:
description: >
Provider of the VNF and the VNFD. The value is copied from the VNFD.
type: string
vnfProductName:
description: >
Name to identify the VNF Product. The value is copied from the VNFD.
type: string
vnfSoftwareVersion:
description: >
Software version of the VNF. The value is copied from the VNFD.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Version"
vnfdVersion:
description: >
Identifies the version of the VNFD. The value is copied from the VNFD.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Version"
vnfPkgId:
description: >
moscatelli
committed
Identifier of information held by the NFVO about
the specific VNF package on which the VNF is
based. This identifier has been allocated by the NFVO.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
vnfConfigurableProperties:
description: >
Additional VNF-specific attributes that provide the current values
of the configurable properties of the VNF instance.
These attributes represent values that are stored persistently in the
VnfInstance structure and that correspond to configuration parameters
of the VNF instance.
Modifying these attributes affects the configuration of the VNF instance
either directly(if the VNF instance is in INSTANTIATED state at the time
of the modification) or as part of the subsequent VNF instantiation operation
(if the VNF instance is in NOT_INSTANTIATED state at the time of the modification).
Configurable properties referred in these attributes are declared in
ETSI GS NFV-SOL 001 specifies the structure and format of the VNFD
based on TOSCA specifications.
VNF configurable properties are sometimes also referred to as
configuration parameters applicable to a VNF. Some of these are set
prior to instantiation and cannot be modified if the VNF is
instantiated, some are set prior to instantiation (are part of
initial configuration) and can be modified later, and others can be
set only after instantiation. The applicability of certain
configuration may depend on the VNF and the required operation of
the VNF at a certain point in time.
These configurable properties include the following standard
attributes, which are declared in the VNFD if auto-scaling and/or
auto-healing are supported by the VNF:
- isAutoscaleEnabled: If present, the VNF supports auto-scaling. If
set to true, auto-scaling is currently enabled. If set to false,
auto-scaling is currently disabled.
- isAutohealEnabled: If present, the VNF supports auto-healing. If
set to true, auto-healing is currently enabled. If set to false,
auto-healing is currently disabled.
Modifications to this attribute can be requested using the "ModifyVnfInfoData" structure.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
vimId:
description: >
Identifier of a VIM that manages resources for the VNF instance.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
instantiationState:
description: >
The instantiation state of the VNF.
type: string
enum:
- NOT_INSTANTIATED
- INSTANTIATED
instantiatedVnfInfo:
description: >
Information specific to an instantiated VNF instance. This attribute
shall be present if the instantiateState attribute value is INSTANTIATED.
type: object
required:
- flavourId
- vnfState
properties:
flavourId:
description: >
Identifier of the VNF deployment flavor applied to this VNF instance.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd"
vnfState:
description: >
The state of the VNF instance.
$ref: "#/definitions/VnfOperationalStateType"
scaleStatus:
description: >
Scale status of the VNF, one entry per aspect. Represents for every
scaling aspect how "big" the VNF has been scaled w.r.t. that aspect.
type: array
items:
$ref: "#/definitions/VnfScaleInfo"
maxScaleLevels:
description: >
Maximum allowed scale levels of the VNF, one
entry per aspect.
This attribute shall be present if the VNF
supports scaling.
type: array
items:
$ref: "#/definitions/VnfScaleInfo"
extCpInfo:
description: >
Information about the external CPs exposed by the VNF instance.
When trunking is enabled, the list of entries includes both,
external CPs corresponding to parent ports of a trunk, and external
CPs associated to sub-ports of a trunk.
type: array
minItems: 1
items:
$ref: "#/definitions/VnfExtCpInfo"
extVirtualLinkInfo:
description: >
Information about the external VLs the VNF instance is connected to.
type: array
items:
$ref: "#/definitions/ExtVirtualLinkInfo"
extManagedVirtualLinkInfo:
description: >
External virtual links the VNF instance is connected to.
It is possible to have several ExtManagedVirtualLinkInfo for the same VNF internal VL in case of a multi-site
VNF spanning several VIMs. The set of ExtManagedVirtualLinkInfo corresponding to the same VNF internal VL
shall indicate so by referencing to the same VnfVirtualLinkDesc and externally-managed multi-site VL instance
(refer to clause 6.5.3.59).
type: array
items:
$ref: "#/definitions/ExtManagedVirtualLinkInfo"
monitoringParameters:
description: >
Performance metrics tracked by the VNFM (e.g. for
auto-scaling purposes) as identified by the VNF
provider in the VNFD.
$ref: "#/definitions/VnfMonitoringParameter"
localizationLanguage:
description: >
Information about localization language of the VNF (includes e.g.
strings in the VNFD). The localization languages supported by a VNF
can be declared in the VNFD, and localization language selection can
take place at instantiation time.
The value shall comply with the format defined in IETF RFC 5646.
type: string
vnfcResourceInfo:
description: >
moscatelli
committed
Information about the virtualised compute and storage resources used
by the VNFCs of the VNF instance.
type: array
items:
$ref: "#/definitions/VnfcResourceInfo"
virtualLinkResourceInfo:
description: >
Information about the virtualised network resources used by the VLs
of the VNF instance.
type: array
items:
$ref: "#/definitions/VnfVirtualLinkResourceInfo"
virtualStorageResourceInfo:
description: >
Information on the virtualised storage resource(s) used as storage for the VNF instance.
type: array
items:
$ref: "#/definitions/VirtualStorageResourceInfo"
metadata:
description: >
Additional VNF-specific attributes that provide
metadata describing the VNF instance.
These attributes represent values that are
stored persistently in the VnfInstance structure
for consumption by functional blocks that
invoke the VNF lifecycle management
interface. They are not consumed by the
VNFM, or the lifecycle management scripts.
Modifying the values of these attributes has no
effect on the VNF instance, it only affects the
information represented in the VnfInstance
structure.
Metadata that the VNF provider foresees are expected to be declared in the VNFD.
Modifications to these attributes can be requested using the "ModifyVnfInfoData" structure.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
extensions:
description: >
Additional VNF-specific attributes that affect the lifecycle management of this VNF instance.
These attributes represent values that are stored persistently in the VnfInstance structure
for consumption by the VNFM, or by the lifecycle management scripts. during the execution
of VNF lifecycle management operations.
Modifying the values of these attributes has no direct effect on the VNF instance; however,
the modified attribute values can be considered during subsequent VNF lifecycle management
operations, which means that the modified values can indirectly affect the configuration of the VNF instance.
Extensions that are allowed for the VNF are declared in the VNFD.
Modifications to these attributes can be requested using the "ModifyVnfInfoData" structure.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
moscatelli
committed
moscatelli
committed
required:
moscatelli
committed
properties:
nsInstance:
description: >
Link to the resource representing the NS instance to
which the notified change applies..
$ref: "../../definitions/SOL005_def.yaml#/definitions/NotificationLink"
subscription:
description: >
Link to the subscription that triggered this notification.
$ref: "../../definitions/SOL005_def.yaml#/definitions/NotificationLink"
description: >
Link to the lifecycle operation occurrence that this
notification is related to. Shall be present if there is a
related lifecycle operation occurrence
$ref: "../../definitions/SOL005_def.yaml#/definitions/NotificationLink"
moscatelli
committed
VnfOperationalStateType:
type: string
enum:
- STARTED
- STOPPED
moscatelli
committed
VnfScaleInfo:
required:
- aspectId
- scaleLevel
type: object
properties:
aspectId:
description: >
Identifier of the scaling aspect.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd"
vnfdId:
description: >
Identifier of the VNFD.
Shall be present in case the value differs from the vnfdId attribute of the VnfInstance (e.g. during a "Change
current VNF package" operation or due to its final failure).
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
scaleLevel:
description: >
Indicates the scale level. The minimum value shall be 0 and the
maximum value shall be <= maxScaleLevel as described in the VNFD.
type: integer
PnfInfo:
description: >
This type represents the information about a PNF that is part of an NS instance.
It shall comply with the provisions
defined in Table 6.5.3.13-1.
type: object
required:
- pnfId
- pnfdId
- pnfdInfoId
- pnfProfileId
properties:
pnfId:
description: >
Identifier of the PNF. This identifier is allocated by the OSS/BSS.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
pnfName:
description: >
Name of the PNF.
type: string
pnfdId:
description: >
Identifier of the PNFD on which the PNF is based.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
pnfdInfoId:
description: >
Identifier of the PNFD information onject related to this
PNF. This identifier is allocated by the NFVO
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
pnfProfileId:
description: >
Identifier of the related PnfProfile in the NSD on which
the PNF is based.
$ref: "#/definitions/IdentifierInNsd"
cpInfo:
description: >
Information on the external CP of the PNF.
$ref: "#/definitions/PnfExtCpInfo"
moscatelli
committed
PnfExtCpInfo:
description: >
This type represents the information about the external CP of the PNF.
It shall comply with the provisions defined in
Table 6.5.3.17-1.
type: object
required:
- cpInstanceId
- cpdId
properties:
cpInstanceId:
description: >
Identifier of the CP in the scope of the PNF.
$ref: "#/definitions/IdentifierInPnf"
cpdId:
description: >
Identifier of (reference to) the Connection Point
Descriptor (CPD) for this CP.
$ref: "#/definitions/IdentifierInNsd"
cpProtocolData:
description: >
Parameters for configuring the network protocols on the CP.
type: array
moscatelli
committed
items:
Samir Medjiah
committed
$ref: "#/definitions/CpProtocolData"
moscatelli
committed
NsVirtualLinkInfo:
description: >
This type specifies the information about an NS VL instance.
It shall comply with the provisions defined in
Table 6.5.3.53-1
type: object
required:
- id
- nsVirtualLinkDescId
- nsVirtualLinkProfileId
properties:
id:
description: >
Identifier of the VL instance.
$ref: "#/definitions/IdentifierInNs"
nsVirtualLinkDescId:
description: >
Identifier of the VLD in the NSD.
$ref: "#/definitions/IdentifierInNsd"
nsVirtualLinkProfileId:
description: >
Identifier of the VL profile in the NSD.
$ref: "#/definitions/IdentifierInNsd"
resourceHandle:
description: >
Identifier(s) of the virtualised network resource(s) and/or multi-site connectivity service(s)
realizing the VL instance.
As an NS can include NFs deployed in NFVI PoPs under the control of several different VIMs, therefore deploying
an NS VL can involve several VIMs, each allocating different virtualised network resources, as well as WIMs
handling the connectivity in between the NFVI-PoPs in the form of multi-site connectivity services. When this
NsVirtualLink is provided as an ExtVirtualLink as input of a VNF LCM operation, the id of the ExtVirtualLink
shall be the same as the corresponding NsVirtualLink.
moscatelli
committed
items:
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/ResourceHandle"
linkPort:
description: >
Link ports of the VL instance.
Cardinality of zero indicates that no port has yet been
created for the VL instance.
type: array
moscatelli
committed
items:
$ref: "#/definitions/NsLinkPortInfo"
VnffgInfo:
description: >
Information on the VNFFG(s) of the NS instance.
type: object
required:
- id
- vnffgdId
- vnfInstanceId
- pnfInfoId
properties:
id:
description: >
Identifier of this VNFFG instance.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
vnffgdId:
description: >
Identifier of the VNFFGD in the NSD.
$ref: "#/definitions/IdentifierInNsd"
vnfInstanceId:
description: >
Identifier(s) of the constituent VNF instance(s) of this VNFFG instance.
type: array
moscatelli
committed
items:
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
pnfdInfoId:
description: >
Identifier(s) of the constituent PNF instance(s) of this
VNFFG instance.
type: array
moscatelli
committed
items:
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
nsVirtualLinkInfoId:
description: >
Identifier(s) of the constituent VL instance(s) of this
VNFFG instance.
type: array
moscatelli
committed
items:
$ref: "#/definitions/IdentifierInNs"
nsCpHandle:
description: >
Identifiers of the CP instances attached to the
constituent VNFs and PNFs or the SAP instances of the
VNFFG. See note.
type: array
moscatelli
committed
items:
$ref: "#/definitions/NsCpHandle"
NfpInfo:
description: >
This type represents an NFP instance. It shall comply with
the provisions defined in Table 6.5.3.66-1.
type: object
required:
- id
- nfpRule
- nfpState
properties:
id:
description: >
Identifier of this NFP instance.
$ref: "#/definitions/IdentifierInNs"
nfpdId:
description: >
Identifier of the NFPD used to instantiate this NFP
instance. It shall be present if the NFP instance is
instantiated from the NFPD.
$ref: "#/definitions/IdentifierInNsd"
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
nfpName:
description: >
Human readable name for the NFP instance.
type: string
description:
description: >
Human readable description for the NFP instance.
type: string
cpGroup:
description: >
Group(s) of CPs and/or SAPs which the NFP passes through.
When multiple identifiers are included, the position of
the identifier in the CpGroup data type specifies the
position of the group in the path.
type: array
minItems: 1
items:
$ref: "#/definitions/NsCpHandle"
totalCp:
description: >
Total number of CP and SAP instances in this NFP instance.
type: integer
nfpRule:
description: >
NFP classification and selection rule.
$ref: "#/definitions/NfpRule"
nfpState:
description: >
The state of the NFP instance.
Permitted values:
* ENABLED: The NFP instance is enabled.
* DISABLED: The NFP instance is disabled.
type: string
enum:
- ENABLED
- DISABLED
NsCpHandle:
description: >
This type represents an identifier of the CP or SAP instance.
It shall comply with the provisions defined in
Table 6.5.3.56-1.
moscatelli
committed
type: object
oneOf:
- required:
- vnfInstanceId
- vnfExtCpInstanceId
- required:
- pnfInfoId
- pnfExtCpInstanceId
- required:
- nsInstanceId
- nsSapInstanceId
properties:
vnfInstanceId:
description: >
Identifier of the VNF instance associated to the CP instance.
This attribute shall be present if the CP instance is VNF external CP.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
vnfExtCpInstanceId:
description: >
Identifier of the VNF external CP instance in the scope
of the VNF instance. This attribute shall be present if the CP instance is VNF
external CP. See notes 1 and 4.
$ref: "#/definitions/IdentifierInVnf"
pnfInfoId:
description: >
Identifier of the PNF instance associated to the CP
instance. This attribute shall be present if the CP instance is PNF
external CP. See notes 2 and 4.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
pnfExtCpInstanceId:
description: >
Identifier of the PNF external CP instance in the scope
of the PNF. This attribute shall be present if the CP instance is PNF
external CP. See notes 2 and 4.
$ref: "#/definitions/IdentifierInPnf"
nsInstanceId:
description: >
Identifier of the NS instance associated to the SAP
instance. This attribute shall be present if the CP instance is NS
SAP. See notes 3 and 4.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
nsSapInstanceId:
description: >
Identifier of the SAP instance in the scope of the NS
instance. This attribute shall be present if the CP instance is NS
SAP. See notes 3 and 4.
$ref: "#/definitions/IdentifierInNs"
moscatelli
committed
SapInfo:
description: >
This type represents an SAP instance. It shall comply with the provisions defined in Table 6.5.3.67-1.
type: object
required:
- id
- sapdId
- sapName
- sapProtocolInfo
properties:
id:
description: >
Identifier of the SAP instance.
$ref: "#/definitions/IdentifierInNs"
sapdId:
description: >
Identifier of the SAPD in the NSD.
$ref: "#/definitions/IdentifierInNsd"
sapName:
description: >
Human readable name for the SAP instance.
type: string
description:
description: >
Human readable description for the SAP instance.
type: string
sapProtocolInfo:
description: >
Network protocol information for this SAP.
type: array
moscatelli
committed
items:
$ref: "#/definitions/CpProtocolInfo"
moscatelli
committed
NsMonitoringParameter:
description: >
This type represents a monitoring parameter that is tracked by the NFVO, for example,
for auto-scaling purposes. It shall comply with the provisions defined in Table 6.5.3.68-1.
type: object
required:
- id
- performanceMetric
properties:
id:
description: >
Identifier of the monitoring parameter defined in the NSD.
$ref: "#/definitions/IdentifierInNsd"
name:
description: >
Human readable name of the monitoring parameter, as defined in the NSD.
type: string
performanceMetric:
description: >
Performance metric that is monitored. This attribute shall contain the related
"Measurement Name" value as defined in clause 7.2 of ETSI GS NFV-IFA 027.
type: string
VnfMonitoringParameter:
description: >
This type represents a monitoring parameter that is tracked by the VNFM, for example,
for auto-scaling purposes. It shall comply with the provisions defined in Table 6.5.3.69-1.
type: object
required:
- id
- performanceMetric
properties:
id:
description: >
Identifier of the monitoring parameter defined in the VNFD.
$ref: "#/definitions/IdentifierInNsd"
vnfdId:
description: >
Identifier of the VNFD.
Shall be present in case the value differs from the vnfdId attribute of the VnfInstance (e.g. during a
"Change current VNF package" operation or due to its final failure).
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
name:
description: >
Human readable name of the monitoring parameter, as defined in the VNFD.
type: string
performanceMetric:
description: >
Performance metric that is monitored. This attribute shall contain the related
"Measurement Name" value as defined in clause 7.2 of ETSI GS NFV-IFA 027.
type: string
VnfExtCpInfo:
description: >
This type represents information about an external CP of a VNF. It shall comply
with the provisions defined in Table 6.5.3.70-1.
type: object
required:
- id
- cpdId
- required:
- associatedVnfcCpId
- required:
- associatedVnfVirtualLinkId
properties:
id:
description: >
Identifier of the external CP instance and the related information instance.
$ref: "#/definitions/IdentifierInVnf"
cpdId:
description: >
Identifier of the external CPD, VnfExtCpd, in the VNFD.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd"
cpConfigId:
description: >
Identifier that references the applied "VnfExtCpConfig" entry in the "cpConfig"
map of the "currentVnfExtCpData" in the "ExtVirtualLinkInfo" structure.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd"
vnfdId:
description: >
Identifier of the VNFD.
Shall be present in case the value differs from the vnfdId attribute of the
VnfInstance (e.g. during a "Change current VNF package" operation or due to
its final failure).
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
cpProtocolInfo:
description: >
Network protocol information for this CP.
type: array
minItems: 1
items:
$ref: "#/definitions/CpProtocolInfo"
extLinkPortId:
description: >
Identifier of the "extLinkPortInfo" structure inside the "extVirtualLinkInfo"
structure. Shall be present if the CP is associated to a link port.
$ref: "#/definitions/CpProtocolInfo"
metadata:
description: >
Metadata about this external CP.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
associatedVnfcCpId:
description: >
Identifier of the "vnfcCpInfo" structure in "VnfcResourceInfo" structure
that represents the VNFC CP which is exposed by this external CP instance.
Shall be present in case this CP instance maps to a VNFC CP(s).
The attributes "associatedVnfcCpId" and "associatedVnfVirtualLinkId" are
mutually exclusive. One and only one shall be present.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
associatedVnfVirtualLinkId:
description: >
Identifier of the "VnfVirtualLinkResourceInfo" structure that represents
the internal VL, which is exposed by this external CP instance. Shall be
present in case this CP instance maps to an internal VL.
The attributes "associatedVnfcCpId" and "associatedVnfVirtualLinkId" are
mutually exclusive. One and only one shall be present.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
CpGroupInfo:
description: >
This type represents describes a group of CPs and/or SAPs pairs associated to
the same position in an NFP. It shall comply with the provisions defined in
Table 6.5.3.71-1.
type: object
properties:
cpPairInfo:
description: >
One or more pair(s) of ingress and egress CPs or SAPs which the NFP passes by.
All CP or SAP pairs in a group shall be instantiated from connection point
descriptors or service access point descriptors referenced in the corresponding
NfpPositionDesc.
type: array
minItems: 1
items:
$ref: "#/definitions/CpPairInfo"
forwardingBehaviour:
description: >
Identifies a rule to apply to forward traffic to the ingress CPs or SAPs of
the group.
Permitted values:
* ALL = Traffic flows shall be forwarded simultaneously to all CPs or SAPs
of the group.
* LB = Traffic flows shall be forwarded to one CP or SAP of the group selected
based on a loadbalancing algorithm.
type: string
enum:
- ALL
- LB
forwardingBehaviourInputParameters:
description: >
Provides input parameters to configure the forwarding behaviour (e.g. identifies
a load balancing algorithm and criteria).
$ref: "#/definitions/ForwardingBehaviourInputParameters"
CpPairInfo:
description: >
This type represents describes a pair of ingress and egress CPs or SAPs which
the NFP passes by. It shall comply with the provisions defined in Table 6.5.3.72-1.
type: object
properties:
vnfExtCpIds:
description: >
Identifier(s) of the VNF CP(s) which form the pair.
The presence of a single vnfExpCpId, pnfExtCpId, or sapId occurrence indicates
that the CP or SAP is used both as an ingress and egress port at a particular
NFP position.
type: array
maxItems: 2
items:
$ref: "#/definitions/IdentifierInVnf"
pnfExtCpIds:
description: >
Identifier(s) of the PNF CP(s) which form the pair.
The presence of a single vnfExpCpId, pnfExtCpId, or sapId occurrence indicates
that the CP or SAP is used both as an ingress and egress port at a particular
NFP position.
type: array
maxItems: 2
items:
$ref: "#/definitions/IdentifierInPnf"
sapIds:
description: >
Identifier(s) of the SAP(s) which form the pair.
The presence of a single vnfExpCpId, pnfExtCpId, or sapId occurrence indicates
that the CP or SAP is used both as an ingress and egress port at a particular
NFP position.
type: array
maxItems: 2
items:
$ref: "#/definitions/IdentifierInNs"
Samir Medjiah
committed
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
ForwardingBehaviourInputParameters:
description: >
This type represents provides input parameters to configure the forwarding behaviour.
It shall comply with the provisions defined in Table 6.5.3.73-1.
type: object
properties:
algortihmName:
description: >
May be included if forwarding behaviour is equal to LB. Shall not be included otherwise.
Permitted values:
* ROUND_ROBIN
* LEAST_CONNECTION
* LEAST_TRAFFIC
* LEAST_RESPONSE_TIME
* CHAINED_FAILOVER
* SOURCE_IP_HASH
* SOURCE_MAC_HASH
type: string
enum:
- ROUND_ROBIN
- LEAST_CONNECTION
- LEAST_TRAFFIC
- LEAST_RESPONSE_TIME
- CHAINED_FAILOVER
- SOURCE_IP_HASH
Samir Medjiah
committed
algorithmWeights:
description: >
Percentage of messages sent to a CP instance. May be included if applicable to
the algorithm.
If applicable to the algorithm but not provided, default values determined by
the VIM or NFVI are expected to be used.
Weight applies to the CP instances in the order they have been created.
type: array
items:
type: integer
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
CpProtocolInfo:
description: >
This type describes the protocol layer(s) that a CP or SAP uses together with protocol-related information, like
addresses. It shall comply with the provisions defined in Table 6.5.3.58-1.
type: object
required:
- layerProtocol
- ipOverEthernet
properties:
layerProtocol:
description: >
The identifier of layer(s) and protocol(s)
associated to the network address information.
Permitted values: IP_OVER_ETHERNET See note.
type: string
enum:
- IP_OVER_ETHERNET
ipOverEthernet:
description: >
IP addresses over Ethernet to assign to the CP
or SAP instance. Shall be present if
layerProtocol is equal to "
IP_OVER_ETHERNET", and shall be absent otherwise.
$ref: "#/definitions/IpOverEthernetAddressInfo"
IpOverEthernetAddressInfo:
moscatelli
committed
description: >
This type represents information about a network address that has been assigned.
It shall comply with the provisions defined in Table 6.5.3.18-1.
type: object
anyOf:
- required:
- macAddress
- required:
- ipAddresses
moscatelli
committed
properties:
macAddress:
description: >
Assigned MAC address.
$ref: "#/definitions/MacAddress"
segmentationId:
description: >
Identification of the network segment to which the Cp instance connects to.
If the Cp instance represents a subport in a trunk, "segmentationId" shall be present.
Otherwise it shall not be present.
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.
type: string
moscatelli
committed
ipAddresses:
description: >
Addresses assigned to the CP instance. Each entry represents IP
addresses assigned by fixed or dynamic IP address assignment per
subnet.
type: array
items:
type: object
required:
- type
oneOf:
- required:
- addresses
- required:
- addressRange
moscatelli
committed
properties:
type:
description: >
The type of the IP addresses.
Permitted values: IPV4, IPV6.
type: string
enum:
- IPV4
- IPV6
addresses:
description: >
Fixed addresses assigned (from the subnet defined by
"subnetId" if provided).
type: array
items:
$ref: "#/definitions/IpAddress"
moscatelli
committed
isDynamic:
description: >
Indicates whether this set of addresses was assigned
dynamically (true) or based on address information provided as
input from the API consumer (false). Shall be present if
"addresses" is present and shall be absent otherwise.
type: boolean
addressRange:
description: >
An IP address range used, e.g., in case of egress connections.
Exactly one of "addresses" or "addressRange" shall be present.
type: object
required:
- minAddress
- maxAddress
properties:
minAddress:
description: >
Lowest IP address belonging to the range.
$ref: "#/definitions/IpAddress"
moscatelli
committed
maxAddress:
description: >
Highest IP address belonging to the range
$ref: "#/definitions/IpAddress"
moscatelli
committed
subnetId:
description: >
Subnet defined by the identifier of the subnet resource in
the VIM.
In case this attribute is present, IP addresses are bound
to that subnet.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVim"
moscatelli
committed
type:
description: >
The type of the IP addresses
type: string
enum:
- PV4
- PV6
addresses:
description: >
Fixed addresses assigned (from the subnet
defined by "subnetId" if provided). See note.
type: array
items:
$ref: "#/definitions/IpAddress"
moscatelli
committed
isDynamic:
description: >
Indicates whether this set of addresses was
assigned dynamically (true) or based on address
information provided as input from the API
consumer (false). Shall be present if "addresses"
is present and shall be absent otherwise.
type: boolean
addressRange:
description: >
An IP address range used, e.g. in case of egress
connections. See note.
type: object
required:
- minAddress
- maxAddress
properties:
minAddress:
description: >
Lowest IP address belonging to the range.
$ref: "#/definitions/IpAddress"
moscatelli
committed
maxAddress:
description: >
Highest IP address belonging to the range
$ref: "#/definitions/IpAddress"
moscatelli
committed
minAddress:
description: >
Lowest IP address belonging to the range
$ref: "#/definitions/IpAddress"
moscatelli
committed
maxAddress:
description: >
Highest IP address belonging to the range.
$ref: "#/definitions/IpAddress"
moscatelli
committed
subnetId:
description: >
Subnet defined by the identifier of the subnet
resource in the VIM.
In case this attribute is present, IP addresses
are bound to that subnet.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVim"
moscatelli
committed
ExtVirtualLinkInfo:
type: object
required:
- id
- resourceHandle
properties:
id:
moscatelli
committed
description: >
Identifier of the external VL and the related external VL
information instance.
The identifier is assigned by the NFV-MANO entity that manages this
VL instance.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
resourceHandle:
description: >
Reference to the resource realizing this VL.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/ResourceHandle"
extLinkPorts:
description: >
Link ports of this VL.
type: array
items:
$ref: "#/definitions/ExtLinkPortInfo"
currentVnfExtCpData:
description: >
Allows the API consumer to read the current CP configuration information
for the connection of external CPs to the external virtual link, as
specified in clause 5.5.3.2 of ETSI GS NFV-SOL 003.
$ref: "#/definitions/VnfExtCpData"
ExtLinkPortInfo:
description: >
This type represents information about a link port of an external VL,
i.e. a port providing connectivity for the VNF to an NS VL.
type: object
required:
- id
- resourceHandle
properties:
id:
description: >
Identifier of this link port as provided by the entity that has
created the link port.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
resourceHandle:
description: >
Reference to the virtualised resource realizing this link port.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/ResourceHandle"
cpInstanceId:
description: >
Identifier of the external CP of the VNF connected to this link
port. There shall be at most one link port associated with any
external connection point instance. The value refers to an
"extCpInfo" item in the VnfInstance.
$ref: "#/definitions/IdentifierInVnf"
ExtManagedVirtualLinkInfo:
type: object
required:
- id
- vnfVirtualLinkDescId
properties:
id:
description: >
Identifier of the externally-managed internal VL and the related
externally-managed VL information instance.
The identifier is assigned by the NFV-MANO entity that manages this
VL instance.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
vnfdId:
description: >
Identifier of the VNFD.
Shall be present in case the value differs from the vnfdId attribute of the VnfInstance (e.g. during a
"Change current VNF package" operation or due to its final failure).
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
vnfVirtualLinkDescId:
description: >
Identifier of the VNF Virtual Link Descriptor (VLD) in the VNFD.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd"
networkResource:
description: >
Reference to the VirtualNetwork resource or multi-site connectivity service providing this VL.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/ResourceHandle"
vnfLinkPorts:
description: >
Link ports of this VL.
type: array
items:
$ref: "#/definitions/VnfLinkPortInfo"
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 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"
VnfLinkPortInfo:
type: object
required:
- id
- resourceHandle
properties:
id:
description: >
Identifier of this link port as provided by the entity that has created the link port.
$ref: "#/definitions/IdentifierInVnf"
resourceHandle:
description: >
Reference to the virtualised resource realizing this link port.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/ResourceHandle"
cpInstanceId:
description: >
When the link port is used for external connectivity by the VNF,
this attribute represents the identifier of the external CP of the
VNF to be connected to this link port.
When the link port is used for internal connectivity in the VNF,
this attribute represents the VNFC CP to be connected to this link
port.
Shall be present when the link port is used for external
connectivity by the VNF.
may be present if used to reference a VNFC CP instance.
There shall be at most one link port associated with any external
connection point instance or internal connection point
(i.e. VNFC CP) instance.
The value refers to an "extCpInfo" item in the VnfInstance or a
"vnfcCpInfo" item of a "vnfcResouceInfo" item in the VnfInstance.
$ref: "#/definitions/IdentifierInVnf"
cpInstanceType:
description: >
Type of the CP instance that is identified by cpInstanceId.
Shall be present if "cpInstanceId" is present, and shall be
absent otherwise.
Permitted values:
* VNFC_CP: The link port is connected to a VNFC CP
* EXT_CP: The link port is associated to an external CP.
type: string
enum:
- VNFC_CP
- EXT_CP
MonitoringParameter:
type: object
required:
- id
- value
- timeStamp
properties:
id:
description: >
Identifier of the monitoring parameter defined in the VNFD.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd"
name:
description: >
Human readable name of the monitoring parameter, as defined in the VNFD.
type: string
value:
description: >
Value of the monitoring parameter known to the VNFM (e.g. obtained
rameshnaraya
committed
for auto-scaling purposes).
The type of the "value" attribute (i.e. scalar, structure (Object in
JSON), or array (of scalars, arrays or structures/Objects)) is
assumed to be defined in an external measurement specification.
type: object
rameshnaraya
committed
timeStamp:
description: >
Represents the point in time when the measurement has been performed,
as known to the VNFM.
Should be formatted according to ETF RFC 3339.
type: string
VnfcResourceInfo:
description: >
This type represents the information on virtualised compute and storage
resources used by a VNFC in a VNF instance.
type: object
required:
- id
- vduId
- computeResource
properties:
id:
description: >
Identifier of this VnfcResourceInfo instance.
$ref: "#/definitions/IdentifierInVnf"
vnfdId:
description: >
Identifier of the VNFD.
Shall be present in case the value differs from the vnfdId attribute of the VnfInstance (e.g. during a
"Change current VNF package" operation or due to its final failure).
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
vduId:
description: >
Reference to the applicable VDU in the VNFD.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd"
computeResource:
description: >
Reference to the VirtualCompute resource.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/ResourceHandle"
storageResourceIds:
description: >
References to the VirtualStorage resources. The value refers to a
VirtualStorageResourceInfo item in the VnfInstance.
type: array
items:
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
reservationId:
description: >
The reservation identifier applicable to the resource. It shall be
present when an applicable reservation exists.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
vnfcCpInfo:
description: >
CPs of the VNFC instance.
Shall be present when that particular CP of the VNFC instance is
exposed as an external CP of the VNF instance or is connected to
an external CP of the VNF instance.
A VNFC CP is "connected to" an external CP if the VNFC CP is
connected to an internal VL that exposes an external CP. A VNFC
CP is "exposed as" an external CP if it is connected directly to
an external VL. May be present otherwise.
type: array
items:
type: object
required:
- id
- cpdId
properties:
id:
description: >
Identifier of this VNFC CP instance and the associated array
entry.
$ref: "#/definitions/IdentifierInVnf"
cpdId:
description: >
Identifier of the VDU CPD, cpdId, in the VNFD.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd"
vnfExtCpId:
description: >
Identifier of the related external CP. Shall be present when the VNFC CP is exposed as an external CP
of the VNF instance or connected to an external CP of the VNF instance and shall be absent otherwise.
A VNFC CP is "connected to" an external CP if the VNFC CP is connected to an internal VL that exposes
an external CP. A VNFC CP is "exposed as" an external CP if it is connected directly to an external VL.
$ref: "#/definitions/IdentifierInVnf"
cpProtocolInfo:
description: >
Network protocol information for this CP.
May be omitted if the VNFC CP is exposed as an external CP.
The information can be omitted because it is already available as part of the external CP information.
type: array
items:
$ref: "#/definitions/CpProtocolInfo"
vnfLinkPortId:
description: >
Identifier of the "vnfLinkPorts" structure in the "VnfVirtualLinkResourceInfo" structure. Shall be present if
the CP is associated to a link port on an internal VL of the VNF instance and shall be absent otherwise.
$ref: "#/definitions/IdentifierInVnf"
metadata:
description: >
Metadata about this CP.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
metadata:
description: >
Metadata about this resource.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
VnfVirtualLinkResourceInfo:
moscatelli
committed
description: >
This type represents the information that allows addressing a virtualised
resource that is used by an internal VL instance in a VNF instance.
type: object
required:
- id
- vnfVirtualLinkDescId
- networkResource
properties:
id:
description: >
Identifier of this VnfVirtualLinkResourceInfo instance.
$ref: "#/definitions/IdentifierInVnf"
vnfdId:
description: >
Identifier of the VNFD.
Shall be present in case the value differs from the vnfdId attribute of the VnfInstance (e.g. during a
"Change current VNF package" operation or due to its final failure).
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
moscatelli
committed
vnfVirtualLinkDescId:
description: >
Identifier of the VNF Virtual Link Descriptor (VLD) in the VNFD.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd"
moscatelli
committed
networkResource:
description: >
Reference to the VirtualNetwork resource.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/ResourceHandle"
moscatelli
committed
reservationId:
description: >
The reservation identifier applicable to the resource. It shall be
present when an applicable reservation exists.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
moscatelli
committed
vnfLinkPorts:
description: >
Links ports of this VL.
Shall be present when the linkPort is used for external connectivity
by the VNF (refer to VnfLinkPortInfo).
May be present otherwise.
type: array
items:
$ref: "#/definitions/VnfLinkPortInfo"
metadata:
description: >
Metadata about this resource.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
moscatelli
committed
VirtualStorageResourceInfo:
moscatelli
committed
description: >
This type represents the information that allows addressing a virtualised
resource that is used by a VNF instance.
type: object
required:
- id
- virtualStorageDescId
- storageResource
properties:
id:
description: >
Identifier of this VirtualStorageResourceInfo instance.
$ref: "#/definitions/IdentifierInVnf"
moscatelli
committed
virtualStorageDescId:
description: >
Identifier of the VirtualStorageDesc in the VNFD.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd"
moscatelli
committed
storageResource:
description: >
Reference to the VirtualStorage resource.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/ResourceHandle"
moscatelli
committed
reservationId:
description: >
The reservation identifier applicable to the resource. It shall be
present when an applicable reservation exists.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
moscatelli
committed
metadata:
description: >
Metadata about this resource.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
moscatelli
committed
moscatelli
committed
description: >
This type represents information about a link port of a VL instance.
It shall comply with the provisions defined in Table 6.5.3.55-1.
type: object
required:
- id
- resourceHandle
properties:
id:
description: >
Identifier of this link port as provided by the entity that
has created the link port.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
moscatelli
committed
resourceHandle:
description: >
Identifier of the virtualised resource realizing
moscatelli
committed
this link port.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/ResourceHandle"
moscatelli
committed
nsCpHandle:
description: >
Identifier of the CP/SAP instance to be connected to this
link port. The value refers to a vnfExtCpInfo item in the
VnfInstance, or a pnfExtCpInfo item in the PnfInfo, or a
sapInfo item in the NS instance.
There shall be at most one link port associated with any
connection point instance.
type: array
items:
$ref: "#/definitions/NsCpHandle"
AffinityOrAntiAffinityRule:
moscatelli
committed
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
description: >
This type describes the additional affinity or anti-affinity rule
applicable between the VNF instances to be instantiated
in the NS instantiation operation request or between the VNF instances
to be instantiated in the NS instantiation
operation request and the existing VNF instances..
type: object
required:
- affinityOrAntiAffiinty
- scope
properties:
vnfdId:
description: >
Reference to a VNFD.
When the VNFD which is not used to instantiate VNF, it
presents all VNF instances of this type as the subjects
of the affinity or anti-affinity rule. The VNF instance
which the VNFD presents is not necessary as a part of
the NS to be instantiated.
type: array
items:
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
moscatelli
committed
vnfProfileId:
description: >
Reference to a vnfProfile defined in the NSD.
At least one VnfProfile which is used to instantiate VNF
for the NS to be instantiated as the subject of the affinity
or anti-affinity rule shall be present. When the VnfProfile
which is not used to instantiate VNF, it presents all VNF
instances of this type as the subjects of the affinity or
anti-affinity rule. The VNF instance which the VnfProfile
presents is not necessary as a part of the NS to be instantiated.
type: array
items:
$ref: "#/definitions/IdentifierInNsd"
moscatelli
committed
vnfInstanceId:
description: >
Reference to the existing VNF instance as the subject of
the affinity or anti-affinity rule. The existing VNF instance
is not necessary as a part of the NS to be instantiated.
type: array
items:
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
moscatelli
committed
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
affinityOrAntiAffiinty:
description: >
The type of the constraint.
Permitted values:
AFFINITY
ANTI_AFFINITY.
type: string
enum:
- AFFINITY
- ANTI_AFFINITY
scope:
description: >
Specifies the scope of the rule where the placement
constraint applies.
Permitted values:
NFVI_POP
ZONE
ZONE_GROUP
NFVI_NODE.
type: string
enum:
- NFVI_POP
- ZONE
- ZONE_GROUP
- NFVI_NODE
InstantiateNsRequest:
type: object
required:
moscatelli
committed
- nsFlavourId
properties:
nsFlavourId:
description: >
Identifier of the NS deployment flavor to be instantiated.
$ref: "#/definitions/IdentifierInNsd"
sapData:
description: >
moscatelli
committed
Create data concerning the SAPs of this NS.
moscatelli
committed
items:
$ref: "#/definitions/SapData"
addpnfData:
description: >
Information on the PNF(s) that are part of this NS.
type: array
moscatelli
committed
items:
$ref: "#/definitions/AddPnfData"
vnfInstanceData:
description: >
Specify an existing VNF instance to be used in the NS.
If needed, the VNF Profile to be used for this VNF
instance is also provided.
The DF of the VNF instance shall match the VNF DF
present in the associated VNF Profile.
moscatelli
committed
items:
$ref: "#/definitions/VnfInstanceData"
nestedNsInstanceData:
description: >
Specify an existing NS instance to be used as a nested
NS within the NS.
If needed, the NS Profile to be used for this nested NS
instance is also provided.
NOTE 2: The NS DF of each nested NS shall be one of the
allowed flavours in the associated NSD (as referenced in the
nestedNsd attribute of the NSD of the NS to be instantiated).
NOTE 3: The NSD of each referenced NSs (i.e. each
nestedInstanceId) shall match the one of the nested NSD in
the composite NSD.
moscatelli
committed
items:
$ref: "#/definitions/NestedNsInstanceData"
locationConstraints:
description: >
Defines the location constraints for the VNF to be
instantiated as part of the NS instantiation.
An example can be a constraint for the VNF to be in a
specific geographic location..
type: array
moscatelli
committed
items:
$ref: "#/definitions/VnfLocationConstraint"
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/NsLocationConstraint"
additionalParamsForNs:
description: >
Allows the OSS/BSS to provide additional parameter(s)
at the composite NS level (as opposed to the VNF level,
which is covered in additionalParamsForVnf), and as
opposed to the nested NS level, which is covered in
additionalParamForNestedNs.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
additionalParamForNestedNs:
description: >
Allows the OSS/BSS to provide additional parameter(s)
per nested NS instance (as opposed to the composite NS
level, which is covered in additionalParamForNs, and as
opposed to the VNF level, which is covered in
additionalParamForVnf). This is for nested NS instances
that are to be created by the NFVO as part of the NS
instantiation and not for existing nested NS instances that
are referenced for reuse.
type: array
items:
$ref: "#/definitions/ParamsForNestedNs"
additionalParamsForVnf:
description: >
Allows the OSS/BSS to provide additional parameter(s)
per VNF instance (as opposed to the composite NS level,
which is covered in additionalParamsForNs and as opposed
to the nested NS level, which is covered in
additionalParamForNestedNs). This is for VNFs that are
to be created by the NFVO as part of the NS instantiation
and not for existing VNF that are referenced for reuse.
moscatelli
committed
items:
$ref: "#/definitions/ParamsForVnf"
startTime:
description: >
Timestamp indicating the earliest time to instantiate the NS.
Cardinality "0" indicates the NS instantiation takes place immediately.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/DateTime"
nsInstantiationLevelId:
description: >
Identifies one of the NS instantiation levels declared in
the DF applicable to this NS instance. If not present, the
default NS instantiation level as declared in the NSD
shall be used.
$ref: "#/definitions/IdentifierInNsd"
wanConnectionData:
description: >
Information for connecting VNs to the WAN when VLs are deployed across a WAN.
When the NS is deployed over several sites, the VLs of this NS will include VNs in each site connected over
the WAN. In this case, the "wanConnectionData" provides the needed information required to connect each VN
to the WAN. Annex E provides additional information and guidelines about the usage of the "wanConnectionData"
attribute.
type: array
items:
$ref: "#/definitions/WanConnectionData"
additionalAffinityOrAntiAffinityRule:
moscatelli
committed
Specifies additional affinity or anti-affinity constraint for
the VNF instances to be instantiated as part of the NS
instantiation.
Shall not conflict with rules already specified in the NSD.
moscatelli
committed
items:
$ref: "#/definitions/AffinityOrAntiAffinityRule"
ParamsForNestedNs:
description: >
This type specifies additional parameters on a per-nested NS instance basis.
It shall comply with the provisions defined in Table 6.5.3.21a-1.
type: object
required:
- nsProfileId
properties:
nsProfileId:
description: >
Identifier of a NsProfile to which the additional parameters apply.
$ref: "#/definitions/IdentifierInNsd"
additionalParam:
description: >
Additional parameters that are to be applied on a per nested NS instance.
type: array
items:
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
moscatelli
committed
description: >
This type defines the additional parameters for the VNF instance
to be created associated with an NS instance.
It shall comply with the provisions defined in Table 6.5.3.22-1.
type: object
required:
- vnfProfileId
properties:
vnfProfileId:
description: >
Identifier of (reference to) a vnfProfile to which the
additional parameters apply.
$ref: "#/definitions/IdentifierInNsd"
1952
1953
1954
1955
1956
1957
1958
1959
1960
1961
1962
1963
1964
1965
1966
1967
1968
1969
1970
1971
1972
1973
1974
1975
1976
vnfInstanceName:
description: >
Human-readable name of the VNF instance to be created.
type: string
vnfInstanceDescription:
description: >
Human-readable description of the VNF instance to be created.
type: string
vnfConfigurableProperties:
description: >
Values for the "vnfConfigurableProperties" input
parameter of the Instantiate VNF operation defined in
ETSI GS NFV-SOL 003 [4].
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
metadata:
description: >
Values for the "metadata" input parameter of the Create
VNF Identifier operation defined in ETSI
GS NFV-SOL 003 [4].
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
extensions:
description: >
Values for the "extensions" attribute of the Instantiate
VNF operation defined in ETSI GS NFV-SOL 003 [4].
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
moscatelli
committed
additionalParams:
description: >
Additional input parameters for the instantiation process,
specific to the VNF being instantiated, as declared in the
VNFD as part of "InstantiateVnfOpConfig".
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
moscatelli
committed
moscatelli
committed
description: >
This type represents location constraints for a VNF to be instantiated.
The location constraints can be represented as follows:
• as a country code
• as a civic address combined with a country code
• as an area, conditionally combined with a country code
The LocationConstraints data type shall comply with the provisions defined in Table 6.5.3.21-1.
moscatelli
committed
type: object
properties:
countryCode:
description: >
The two-letter ISO 3166 [29] country code in capital letters.
Shall be present in case the "area" attribute is absent. May be absent if the "area" attribute is present.
If both "countryCode" and "area" are present, no conflicts should exist between the values of these two attributes.
In case of conflicts, the API producer (i.e. the NFVO) shall disregard parts of the geographic area signalled
by "area" that are outside the boundaries of the country signalled by "countryCode". If "countryCode" is absent,
it is solely the "area" attribute that defines the location constraint.
moscatelli
committed
type: string
civicAddressElement:
description: >
Zero or more elements comprising the civic address.
Shall be absent if the "area" attribute is present.
moscatelli
committed
type: array
items:
type: object
required:
- caType
- caValue
properties:
caType:
description: >
Describe the content type of caValue. The value of
caType shall comply with Section 3.4 of IETF
RFC 4776 [13].
type: integer
caValue:
description: >
Content of civic address element corresponding to the
caType. The format caValue shall comply with
Section 3.4 of IETF RFC 4776 [13].
type: string
area:
description: >
Geographic area. Shall be absent if the "civicAddressElement" attribute is present.
The content of this attribute shall follow the provisions for the "Polygon" geometry object as defined in
IETF RFC 7946, for which the "type" member shall be set to the value "Polygon".
If both "countryCode" and "area" are present, no conflicts should exist between the values of these two attributes.
In case of conflicts, the API producer (i.e. the NFVO) shall disregard parts of the geographic area signalled
by "area" that are outside the boundaries of the country signalled by "countryCode". If "countryCode" is absent,
it is solely the "area" attribute that defines the location constraint.
type: object
moscatelli
committed
moscatelli
committed
description: >
This type represents the association of location constraints to a VNF instance
to be created according to a specific VNF profile.
It shall comply with the provisions defined in Table 6.5.3.20-1.
type: object
required:
- vnfProfileId
properties:
vnfProfileId:
description: >
Identifier of (reference to) a vnfProfile to which the
additional parameters apply.
$ref: "#/definitions/IdentifierInNsd"
moscatelli
committed
locationConstraints:
description: >
Defines the location constraints for the VNF instance to
be created based on the VNF profile.
$ref: "#/definitions/LocationConstraints"
moscatelli
committed
description: >
This type specifies an existing VNF instance to be used in the NS instance and
if needed, the VNF Profile to use for this VNF instance.
It shall comply with the provisions defined in Table 6.5.3.19-1.
type: object
required:
- vnfInstanceId
- vnfProfileId
properties:
vnfInstanceId:
description: >
Identifier of the existing VNF instance to be used in the NS.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
moscatelli
committed
vnfProfileId:
description: >
Identifier of (Reference to) a vnfProfile defined in the
NSD which the existing VNF instance shall be matched
with. If not present, the NFVO will select the VnfProfile
matching the information in the VNF instance.
$ref: "#/definitions/IdentifierInNsd"
moscatelli
committed
NestedNsInstanceData:
description: >
This type specifies an existing nested NS instance to be used in the NS instance
and if needed, the NsProfile to use for this nested NS instance.
It shall comply with the provisions defined in Table 6.5.3.19a-1.
type: object
required:
- nestedNsInstanceId
properties:
description: >
Identifier of the existing nested NS instance to be used in the NS.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
nsProfileId:
description: >
Identifier of an NsProfile defined in the NSD which the existing
nested NS instance shall be matched with.
If not present, the NFVO will select the NsProfile matching the
information in the nested NS instance.
$ref: "#/definitions/IdentifierInNs"
moscatelli
committed
description: >
This type represents the information related to a SAP of a NS.
It shall comply with the provisions defined in Table 6.5.3.10-1.
type: object
required:
- sapdId
- sapName
- description
properties:
sapdId:
description: >
Reference to the SAPD for this SAP.
$ref: "#/definitions/IdentifierInNsd"
moscatelli
committed
sapName:
description: >
Human readable name for the SAP.
type: string
description:
description: >
Human readable description for the SAP.
type: string
sapProtocolData:
description: >
Parameters for configuring the network protocols on the SAP.
type: array
moscatelli
committed
items:
$ref: "#/definitions/CpProtocolData"
rameshnaraya
committed
description: >
moscatelli
committed
This type represents a request for the scale NS operation.
Either the parameter scaleNsData or the parameter scaleVnfData, but not both shall be provided
type: object
required:
moscatelli
committed
- scaleType
oneOf:
- required:
- scaleNsData
- required:
- scaleVnfData
moscatelli
committed
scaleType:
moscatelli
committed
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
2158
2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
Indicates the type of scaling to be performed.
Possible values:
- SCALE_NS
- SCALE_VNF
type: string
enum:
- SCALE_NS
- SCALE_VNF
scaleNsData:
description: >
The necessary information to scale the referenced NS instance.
It shall be present when scaleType = SCALE_NS.
$ref: "#/definitions/ScaleNsData"
scaleVnfData:
description: >
The necessary information to scale the referenced NS instance.
It shall be present when scaleType = SCALE_VNF.
type: array
items:
$ref: "#/definitions/ScaleVnfData"
scaleTime:
description: >
Timestamp indicating the scale time of the NS, i.e. the
NS will be scaled at this timestamp. Cardinality "0"
indicates the NS scaling takes place immediately".
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/DateTime"
moscatelli
committed
UpdateNsRequest:
description: >
This operation supports the update of a NS instance,
It shall comply with the provisions defined in Table 6.5.2.12-1.
type: object
required:
- updateType
properties:
updateType:
description: >
The type of update. It determines also which one of the following parameters is present in the operation.
moscatelli
committed
Possible values include:
* ADD_VNF: Adding existing VNF instance(s)
* REMOVE_VNF: Removing VNF instance(s)
* INSTANTIATE_VNF: Instantiating new VNF(s)
* CHANGE_VNF_DF: Changing VNF DF
* OPERATE_VNF: Changing VNF state,
* MODIFY_VNF_INFORMATION: Modifying VNF information and/or the configurable properties of VNF instance(s)
* CHANGE_EXTERNAL_VNF_CONNECTIVITY: Changing the external connectivity of VNF instance(s)
* CHANGE_VNFPKG: Changing the VNF package(s) on which (a) VNF instance(s) is/are based
* REMOVE_SAP: Removing SAP(s)
* ADD_NESTED_NS: Adding existing NS instance(s) as nested NS(s)
* REMOVE_NESTED_NS: Removing existing nested NS instance(s)
* ASSOC_NEW_NSD_VERSION: Associating a new NSD version to the NS instance
* MOVE_VNF: Moving VNF instance(s) from one origin NS instance to another target NS instance
* ADD_VNFFG: Adding VNFFG(s)
* REMOVE_VNFFG: Removing VNFFG(s)
* UPDATE_VNFFG: Updating VNFFG(s)
* CHANGE_NS_DF: Changing NS DF
* ADD_PNF: Adding PNF
* MODIFY_PNF: Modifying PNF
* REMOVE_PNF: Removing PNF
* CREATE_VNF_SNAPSHOT: Creating VNF Snapshots of VNF instances belonging to the NS instance.
It depends on the VNF capabilities, and is declared in the VNFD whether the operation is supported for a particular VNF.
* REVERT_VNF_TO_SNAPSHOT: Reverting a VNF instance belonging to the NS instance to a VNF Snapshot.
It depends on the VNF capabilities, and is declared in the VNFD whether the operation is supported for a particular VNF.
The operation might be service-disruptive.
* DELETE_VNF_SNAPSHOT_INFO: Deleting available VNF Snapshot information for a VNF instance belonging to the NS instance.
It depends on the VNF capabilities, and is declared in the VNFD whether the operation is supported for a particular VNF.
* MODIFY_WAN_CONNECTION_INFO: Modify WAN related connectivity information.
* CREATE_NS_VIRTUAL_LINK: Create an NsVirtualLink instance.
* DELETE_NS_VIRTUAL_LINK: Delete an NsVirtualLink instance.
moscatelli
committed
enum:
- ADD_VNF
- REMOVE_VNF
- INSTANTIATE_VNF
- CHANGE_VNF_DF
- OPERATE_VNF
- MODIFY_VNF_INFORMATION
- CHANGE_EXTERNAL_VNF_CONNECTIVITY
- REMOVE_SAP
- ADD_NESTED_NS
- REMOVE_NESTED_NS
- ASSOC_NEW_NSD_VERSION
- MOVE_VNF
- ADD_VNFFG
moscatelli
committed
- REMOVE_VNFFG
- UPDATE_VNFFG
- CHANGE_NS_DF
- ADD_PNF
- MODIFY_PNF
- REMOVE_PNF
- CREATE_VNF_SNAPSHOT
- REVERT_VNF_TO_SNAPSHOT
- DELETE_VNF_SNAPSHOT_INFO
- MODIFY_WAN_CONNECTION_INFO
- CREATE_NS_VIRTUAL_LINK
- DELETE_NS_VIRTUAL_LINK
addVnfIstance:
description: >
Identifies an existing VNF instance to be added to the
NS instance. It shall be present only if updateType = "ADD_VNF".
type: array
moscatelli
committed
items:
$ref: "#/definitions/VnfInstanceData"
removeVnfInstanceId:
description: >
Identifies an existing VNF instance to be removed from
the NS instance. It contains the identifier(s) of the VNF
instances to be removed. It shall be present only if
updateType = "REMOVE_VNF." Note: If a VNF instance
is removed from a NS and this NS was the last one for
which this VNF instance was a part, the VNF instance is
terminated by the NFVO.
type: array
moscatelli
committed
items:
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
instantiateVnfData:
description: >
Identifies the new VNF to be instantiated. It can be used
e.g. for the bottom-up NS creation. It shall be present
only if updateType = "INSTANTIATE_VNF".
type: array
moscatelli
committed
items:
$ref: "#/definitions/InstantiateVnfData"
changeVnfFlavourData:
description: >
Identifies the new DF of the VNF instance to be
changed to. It shall be present only if updateType = "CHANGE_VNF_DF".
type: array
moscatelli
committed
items:
$ref: "#/definitions/ChangeVnfFlavourData"
operateVnfData:
description: >
Identifies the state of the VNF instance to be changed.
It shall be present only if updateType = "OPERATE_VNF".
type: array
moscatelli
committed
items:
$ref: "#/definitions/OperateVnfData"
modifyVnfInfoData:
description: >
Identifies the VNF information parameters and/or the
configurable properties of VNF instance to be modified.
It shall be present only if updateType = "MODIFY_VNF_INFORMATION".
type: array
moscatelli
committed
items:
$ref: "#/definitions/ModifyVnfInfoData"
changeExtVnfConnectivityData:
description: >
Specifies the new external connectivity data of the VNF
instance to be changed. It shall be present only if
updateType = "CHANGE_EXTERNAL_VNF_CONNECTIVITY".
type: array
moscatelli
committed
items:
$ref: "#/definitions/ChangeExtVnfConnectivityData"
changeVnfPackageData:
description: >
Specifies the details to change the VNF package on which the VNF instance is based.
It shall be present only if updateType = "CHANGE_VNFPKG".
type: array
items:
$ref: "#/definitions/ChangeVnfPackageData"
addSap:
description: >
Identifies a new SAP to be added to the NS instance.
It shall be present only if updateType = "ADD_SAP."
type: array
moscatelli
committed
items:
$ref: "#/definitions/SapData"
removeSapId:
description: >
The identifier an existing SAP to be removed from the
NS instance. It shall be present only if updateType = "REMOVE_SAP."
type: array
moscatelli
committed
items:
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
Samir Medjiah
committed
addNestedNsData:
description: >
The identifier of an existing nested NS instance to be
added to (nested within) the NS instance. It shall be
present only if updateType = "ADD_NESTED_NS".
type: array
moscatelli
committed
items:
Samir Medjiah
committed
$ref: "#/definitions/NestedNsInstanceData"
moscatelli
committed
description: >
The identifier of an existing nested NS instance to be
removed from the NS instance. It shall be present only if
updateType = "REMOVE_NESTED_NS".
type: array
items:
$ref: "#/definitions/IdentifierInNs"
assocNewNsdVersionData:
description: >
Specify the new NSD to be used for the NS instance. It
shall be present only if updateType =
ASSOC_NEW_NSD_VERSION".
$ref: "#/definitions/AssocNewNsdVersionData"
moveVnfInstanceData:
description: >
Specify existing VNF instance to be moved from one NS
instance to another NS instance. It shall be present only
if updateType = MOVE_VNF".
type: array
moscatelli
committed
items:
$ref: "#/definitions/MoveVnfInstanceData"
addVnffg:
description: >
Specify the new VNFFG to be created to the NS
Instance. It shall be present only if updateType =
"ADD_VNFFG".
type: array
moscatelli
committed
items:
$ref: "#/definitions/AddVnffgData"
removeVnffgId:
description: >
Identifier of an existing VNFFG to be removed from the
NS Instance. It shall be present only if updateType =
"REMOVE_VNFFG".
type: array
moscatelli
committed
items:
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
updateVnffg:
description: >
Specify the new VNFFG Information data to be updated
for a VNFFG of the NS Instance. It shall be present only
if updateType = "UPDATE_VNFFG".
type: array
moscatelli
committed
items:
$ref: "#/definitions/UpdateVnffgData"
changeNsFlavourData:
description: >
Specifies the new DF to be applied to the NS instance. It
shall be present only if updateType =
"CHANGE_NS_DF".
moscatelli
committed
$ref: "#/definitions/ChangeNsFlavourData"
addPnfData:
description: >
specifies the PNF to be added into the NS instance.
It shall be present only if updateType = "ADD_PNF".
type: array
moscatelli
committed
items:
$ref: "#/definitions/AddPnfData"
modifyPnfData:
description: >
Specifies the PNF to be modified in the NS instance.
It shall be present only if updateType = "MODIFY_PNF".
type: array
moscatelli
committed
items:
$ref: "#/definitions/ModifyPnfData"
removePnfId:
description: >
Identifier of the PNF to be deleted from the NS instance.
It shall be present only if updateType = "REMOVE_PNF".
type: array
moscatelli
committed
items:
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
modifyWanConnectionInfoData:
description: >
Specifies the data to modify about WAN related connectivity information.
It shall be present only if updateType = "MODIFY_WAN_CONNECTION_INFO".
type: array
items:
$ref: "#/definitions/ModifyWanConnectionInfoData"
updateTime:
description: >
Timestamp indicating the update time of the NS, i.e. the
NS will be updated at this timestamp. Cardinality "0"
indicates the NS update takes place immediately.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/DateTime"
2415
2416
2417
2418
2419
2420
2421
2422
2423
2424
2425
2426
2427
2428
2429
2430
2431
2432
2433
2434
2435
2436
2437
2438
2439
2440
2441
2442
2443
createSnapshotData:
description: >
Specify the VNF instance to be snapshotted. It shall be present only if updateType = "CREATE_VNF_SNAPSHOT".
$ref: '#/definitions/CreateVnfSnapshotData'
revertVnfToSnapshotData:
description: >
Specify the VNF instance to be reverted and the VNF Snapshot to be reverted to. It shall be present only if
updateType = "REVERT_VNF_TO_SNAPSHOT".
$ref: '#/definitions/CreateVnfSnapshotData'
$ref: '#/definitions/RevertVnfToSnapshotData'
deleteVnfSnapshotData:
description: >
Specify the VNF Snapshot info to be deleted and the related VNF instance. It shall be present only if
updateType = "DELETE_VNF_SNAPSHOT_INFO".
$ref: '#/definitions/DeleteVnfSnapshotData'
addNsVirtualLinkData:
description: >
Specify data to be used to create a new NsVirtualLink instance. This parameter shall be present only if
updateType = “CREATE_NS_VIRTUAL_LINK”.
type: array
items:
$ref: '#/definitions/AddNsVirtualLinkData'
deleteNsVirtualLinkId:
description: >
Identify an existing NsVirtualLink instance to be deleted. The parameter shall be present only if
updateType = “DELETE_NS_VIRTUAL_LINK”.
type: array
items:
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
Samir Medjiah
committed
InstantiateVnfData:
description: >
This type represents the information related to a SAP of a NS. The InstantiateVnfData data type specifies the
parameters that are needed for VNF instantiation. This information element is used for the bottom-up NS creation when
the OSS/BSS explicitly requests VNF instantiation for a given NS. When the NFVO invokes the Instantiate VNF
update operation, a set of these parameters are then passed by the NFVO to the VNFM. It shall comply with the
provisions defined in Table 6.5.3.24-1.
type: object
required:
- vnfdId
moscatelli
committed
- vnfFlavourId
properties:
vnfdId:
description: >
Information sufficient to identify the VNFD which defines
the VNF to be instantiated.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
vnfFlavourId:
description: >
Identifier of the VNF deployment flavor to be instantiated.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd"
vnfInstantiationLevelId:
description: >
Identifier of the instantiation level of the deployment
flavor to be instantiated. If not present, the default
instantiation level as declared in the VNFD is
instantiated.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd"
vnfInstanceName:
description: >
Human-readable name of the VNF instance to be created.
type: string
vnfInstanceDescription:
description: >
Human-readable description of the VNF instance to be created.
type: string
extVirtualLinks:
description: >
Information about external VLs to connect the VNF to.
type: array
moscatelli
committed
items:
$ref: "#/definitions/ExtVirtualLinkData"
extManagedVirtualLinks:
description: >
Information about internal VLs that are managed by other entities than the VNFM.
It is possible to have several ExtManagedVirtualLinkData for the same VNF internal VL in case of a multi-site
VNF spanning several VIMs. The set of ExtManagedVirtualLinkData corresponding to the same VNF internal VL shall
indicate so by referencing to the same VnfVirtualLinkDesc and externally-managed multi-site VL instance
(refer to clause 6.5.3.27).
moscatelli
committed
items:
$ref: "#/definitions/ExtManagedVirtualLinkData"
localizationLanguage:
description: >
moscatelli
committed
Localization language of the VNF to be instantiated.
The value shall comply with the format defined in IETF RFC 5646.
moscatelli
committed
type: string
vnfConfigurableProperties:
description: >
Values for the "vnfConfigurableProperties" input
parameter of the Instantiate VNF operation
defined in ETSI GS NFV-SOL 003 [4].
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
moscatelli
committed
additionalParams:
description: >
Additional input parameters for the instantiation process,
specific to the VNF being instantiated.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
metadata:
description: >
This attribute provides values for the "metadata" input parameter of
the Create VNF Identifier operation.
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
extensions:
description: >
This attribute provides values for the "extensions" input parameter of
the Instantiate VNF operation.
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
locationConstraints:
description: >
Defines the location constraints for the VNF to be
instantiated as part of the NS Update.
An example can be a constraint for the VNF to be
in a specific geographic location.
$ref: "#/definitions/VnfLocationConstraint"
moscatelli
committed
ChangeVnfFlavourData:
description: >
The type represents the information that is requested to be changed
deployment flavor for an existing VNF instance.
It shall comply with the provisions defined in Table 6.5.3.25-1.
type: object
required:
- vnfInstanceId
- newFlavourId
properties:
vnfInstanceId:
description: >
Identifier of the VNF instance to be modified.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
moscatelli
committed
newFlavourId:
description: >
Identifier of the VNF deployment flavor to be instantiated.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd"
moscatelli
committed
instantiationLevelId:
description: >
Identifier of the instantiation level of the deployment
flavor to be instantiated. If not present, the default
instantiation level as declared in the VNFD is
instantiated.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd"
moscatelli
committed
extVirtualLinks:
description: >
Information about external VLs to connect the VNF to.
type: array
items:
$ref: "#/definitions/ExtVirtualLinkData"
moscatelli
committed
extManagedVirtualLinks:
description: >
information about internal VLs that are managed by NFVO.
The indication of externally-managed internal VLs is needed in case networks have been pre-configured for use
with certain VNFs, for instance to ensure that these networks have certain properties such as security or
acceleration features, or to address particular network topologies. The present document assumes that
xternally-managed internal VLs are managed by the NFVO and created towards the VIM.
It is possible to have several ExtManagedVirtualLinkData for the same VNF internal VL in case of a multi-site
VNF spanning several VIMs. The set of ExtManagedVirtualLinkData corresponding to the same VNF internal VL shall
indicate so by referencing to the same VnfVirtualLinkDesc and externally-managed multi-site VL instance
(refer to clause 6.5.3.27).
moscatelli
committed
type: array
items:
$ref: "#/definitions/ExtManagedVirtualLinkData"
moscatelli
committed
additionalParams:
description: >
Additional input parameters for the flavor change
process, specific to the VNF being modified, as declared
in the VNFD as part of "ChangeVnfFlavourOpConfig".
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
extensions:
description: >
This attribute provides values for the "extensions" input parameter of the Change VNF Flavour
operation defined in ETSI GS NFV-SOL 003.
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
vnfConfigurableProperties:
description: >
This attribute provides values for the "vnfConfigurableProperties" input parameter of the Change VNF Flavour
operation defined in ETSI GS NFV-SOL 003.
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
moscatelli
committed
OperateVnfData:
description: >
This type represents a VNF instance for which the operational state
needs to be changed and the requested new state. It
shall comply with the provisions defined in Table 6.5.3.31-1.
type: object
required:
- vnfInstanceId
- changeStateTo
properties:
vnfInstanceId:
description: >
Identifier of the VNF instance.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
moscatelli
committed
changeStateTo:
description: >
The desired operational state (i.e. started or stopped)
to change the VNF to.
$ref: "#/definitions/OperationalStates"
stopType:
description: >
It signals whether forceful or graceful stop is requested.
$ref: "#/definitions/StopType"
gracefulStopTimeout:
description: >
The time interval (in seconds) to wait for the VNF to be
taken out of service during graceful stop, before
stopping the VNF.
type: integer
additionalParam:
description: >
Additional parameters passed by the OSS/BSS as input
to the Operate VNF operation, specific to the VNF being
operated.
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
moscatelli
committed
OperationalStates:
description: >
STARTED - The VNF instance is up and running.
STOPPED - The VNF instance has been shut down.
type: string
enum:
- STARTED
- STOPPED
Samir Medjiah
committed
moscatelli
committed
2638
2639
2640
2641
2642
2643
2644
2645
2646
2647
2648
2649
2650
2651
2652
2653
2654
2655
2656
2657
2658
2659
2660
2661
2662
2663
StopType:
description: >
* FORCEFUL: The VNFM will stop the VNF immediately after accepting the
request.
* GRACEFUL: The VNFM will first arrange to take the VNF out of service
after accepting the request. Once that operation is successful or once
the timer value specified in the "gracefulStopTimeout" attribute
expires, the VNFM will stop the VNF.
type: string
enum:
- FORCEFUL
- GRACEFUL
ModifyVnfInfoData:
description: >
This type represents the information that is requested to be modified for a VNF instance. The information to be
modified shall comply with the associated NSD.
EXAMPLE. The vnfPkgId attribute value for a particular VNF instance can only be updated with a value that
matches the identifier value of a VNF package whose vnfdId is present in the associated profile of the NSD.
type: object
required:
- vnfInstanceId
properties:
vnfInstanceId:
description: >
Identifier of the VNF instance.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
moscatelli
committed
vnfInstanceName:
description: >
New value of the "vnfInstanceName" attribute in
"VnfInstance", or "null" to remove the attribute.
type: string
vnfInstanceDescription:
description: >
New value of the "vnfInstanceDescription" attribute in "VnfInstance",
or "null" to remove the attribute.
type: string
moscatelli
committed
description: >
New value of the "vnfdId" attribute in "VnfInstance".
moscatelli
committed
The value "null" is not permitted
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
moscatelli
committed
vnfConfigurableProperties:
description: >
Modifications to entries in the
"vnfConfigurableProperties" attribute in "VnfInstance", as defined below in clause 6.5.3.57.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
metadata:
moscatelli
committed
description: >
Modifications to entries in the "metadata" attribute in "VnfInstance", as defined below in clause 6.5.3.57.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
extensions:
moscatelli
committed
description: >
Modifications to entries in the "extensions" attribute in "VnfInstance", as defined below in clause 6.5.3.57.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
moscatelli
committed
ChangeExtVnfConnectivityData:
description: >
This type describes the information invoked by the NFVO to change the external VNF connectivity information
maintained by the VNFM. The types of changes that this operation supports are:
1) Disconnect the external CPs that are connected to a particular external VL, and connect them to a different
external VL.
2) Disconnect and delete external CPs that are connected to a particular external VL and that represent subports
in a trunk, i.e. CP instances that are created from external CPDs that have trunk mode configured according to
clause 7.1.6.3 in ETSI GS NFV-IFA 011. If the parent port is exposed as an "extCp", the VNFM shall ensure that
the parent port is not deleted. If the parent port is exposed as an "extCp" and there are other subports connected,
the VNFM shall ensure that the parent port is not disconnected, unless it is reconnected to a different external
VL in the same operation.
3) Change the connectivity parameters of the existing external CPs, including changing addresses.
NOTE: Depending on the capabilities of the underlying VIM resources, certain changes (e.g. modifying the IP address
assignment) might not be supported without deleting the resource and creating another one with the modified
configuration.
4) Create new CPs that represent supports in a trunk, i.e. CP instances that are created from external CPDs that
have trunk mode configured according to clause 7.1.6.3 in ETSI GS NFV-IFA 011, and connect them to a particular
external VL. Creation of the parent port with this operation is not supported. This type shall comply with the
provisions defined in Table 6.5.3.33-1.
moscatelli
committed
type: object
required:
- vnfInstanceId
moscatelli
committed
properties:
vnfInstanceId:
description: >
Identifier of the VNF instance.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
moscatelli
committed
description: >
Information about external VLs to change (e.g. connect the VNF to).
type: array
items:
$ref: "#/definitions/ExtVirtualLinkData"
moscatelli
committed
additionalParams:
description: >
Additional parameters passed by the OSS as input to
the external connectivity change process, specific to the
VNF instance being changed.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
moscatelli
committed
AssocNewNsdVersionData:
description: >
This type specifies a new NSD version that is associated to the NS instance. After issuing the Update NS operation with
updateType = "AssocNewNsdVersion", the NFVO shall use the referred NSD as a basis for the given NS instance.
Different versions of the same NSD have same nsdInvariantId, but different nsdId attributes, therefore if the
nsdInvariantId of the NSD version that is to be associated to this NS instance is different from the one used before, the
NFVO shall reject the request. Only new versions of the same NSD can be associated to an existing NS instance. This
data type shall comply with the provisions defined in Table 6.5.3.34-1.
type: object
required:
- newNsdId
properties:
newNsdId:
description: >
Identifier of the new NSD version that is to be
associated to the NS instance.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
moscatelli
committed
2755
2756
2757
2758
2759
2760
2761
2762
2763
2764
2765
2766
2767
2768
2769
2770
2771
2772
2773
2774
2775
2776
2777
2778
2779
2780
2781
2782
2783
2784
2785
2786
2787
2788
2789
sync:
description: >
Specify whether the NS instance shall be automatically
synchronized to the new NSD by the NFVO (in case of
true value) or the NFVO shall not do any action (in case
of a false value) and wait for further guidance from
OSS/BSS (i.e. waiting for OSS/BSS to issue NS
lifecycle management operation to explicitly add/remove
VNFs and modify information of VNF instances
according to the new NSD).
The synchronization to the new NSD means e.g.
instantiating/adding those VNFs whose VNFD is
referenced by the new NSD version but not referenced
by the old one, terminating/removing those VNFs whose
VNFD is referenced by the old NSD version but not
referenced by the new NSD version, modifying
information of VNF instances to the new applicable
VNFD provided in the new NSD version.
A cardinality of 0 indicates that synchronization shall not be done.
type: boolean
MoveVnfInstanceData:
description: >
This type specifies existing VNF instances to be moved from one NS instance (source) to another NS instance
(destination). The NS instance defined in the Update NS operation indicates the source NS instance and the destination
NS instance is specified in this data type (referred to targetNsInstanceId).
It shall comply with the provisions defined in Table 6.5.3.35-1.
type: object
required:
- targetNsInstanceId
properties:
targetNsInstanceId:
description: >
Specify the target NS instance where the VNF instances
are moved to.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
moscatelli
committed
vnfInstanceId:
description: >
Specify the VNF instance that is moved.
type: array
items:
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
moscatelli
committed
AddVnffgData:
description: >
This type specifies the parameters used for the creation of a new VNFFG instance.
It shall comply with the provisions defined in Table 6.5.3.36-1.
type: object
required:
- vnffgdId
- vnffgName
- description
properties:
targetNsInstanceId:
description: >
Identifier of the VNFFGD used to create this VNFFG
instance.
$ref: "#/definitions/IdentifierInNsd"
moscatelli
committed
vnffgName:
description: >
Human readable name for the VNFFG.
type: string
description:
description: >
Human readable description for the VNFFG.
type: string
UpdateVnffgData:
description: >
This type specifies the parameters used for the update of an existing VNFFG instance.
It shall comply with the provisions defined in Table 6.5.3.37-1.
type: object
required:
- vnffgInfoId
properties:
vnffgInfoId:
description: >
Identifier of an existing VNFFG to be updated for the NS Instance.
$ref: "#/definitions/IdentifierInNs"
moscatelli
committed
nfp:
description: >
Indicate the desired new NFP(s) for a given VNFFG
after the operations of addition/removal of NS
components (e.g. VNFs, VLs, etc.) have been
completed, or indicate the updated or newly created
NFP classification and selection rule which applied to an existing NFP.
type: array
items:
$ref: "#/definitions/NfpData"
nfpInfoId:
description: >
Identifier(s) of the NFP to be deleted from a given VNFFG.
type: array
items:
$ref: "#/definitions/IdentifierInNs"
moscatelli
committed
NfpData:
description: >
This type contains information used to create or modify NFP instance parameters
for the update of an existing VNFFG instance.
It shall comply with the provisions defined in Table 6.5.3.38-1.
type: object
properties:
nfpInfoId:
description: >
Identifier of the NFP to be modified. It shall be present
for modified NFPs and shall be absent for the new NFP.
It shall be present for modified NFPs and shall be absent
for the new NFP.
$ref: "#/definitions/IdentifierInNs"
moscatelli
committed
nfpName:
description: >
Human readable name for the NFP. It shall be present
for the new NFP, and it may be present otherwise.
It shall be present for the new NFP, and it may be
present otherwise.
moscatelli
committed
type: string
description:
description: >
Human readable description for the NFP. It shall be
present for the new NFP, and it may be present otherwise.
It shall be present for the new NFP, and it may be
present otherwise.
moscatelli
committed
type: string
moscatelli
committed
description: >
Group(s) of CPs and/or SAPs which the NFP passes by.
moscatelli
committed
Cardinality can be 0 if only updated or newly created
NFP classification and selection rule which applied to an
existing NFP is provided.
At least a CP or an nfpRule shall be present.
When multiple identifiers are included, the position of
the identifier in the cpGroup value specifies the position
of the group in the path.
moscatelli
committed
type: array
items:
$ref: "#/definitions/CpGroupInfo"
moscatelli
committed
nfpRule:
description: >
NFP classification and selection rule. See note 1.
$ref: "#/definitions/NfpRule"
NfpRule:
description: >
The NfpRule data type is an expression of the conditions that shall be met
in order for the NFP to be applicable to the packet. The condition acts as a flow classifier and
it is met only if all the values expressed in the condition are matched
by those in the packet. It shall comply with the provisions defined in Table 6.5.3.40-1.
type: object
2904
2905
2906
2907
2908
2909
2910
2911
2912
2913
2914
2915
2916
2917
2918
2919
2920
2921
2922
2923
2924
2925
2926
anyOf:
- required:
- etherDestinationAddress
- required:
- etherSourceAddress
- required:
- etherType
- required:
- vlanTag
- required:
- protocol
- required:
- dscp
- required:
- sourcePortRange
- required:
- destinationPortRange
- required:
- sourceIpAddressPrefix
- required:
- destinationIpAddressPrefix
- required:
- extendedCriteria
moscatelli
committed
properties:
etherDestinationAddress:
description: >
Indicates a destination Mac address.
$ref: "#/definitions/MacAddress"
moscatelli
committed
etherSourceAddress:
description: >
Indicates a source Mac address.
$ref: "#/definitions/MacAddress"
moscatelli
committed
etherType:
description: >
Human readable description for the VNFFG.
type: string
enum:
- IPV4
- IPV6
vlanTag:
description: >
Indicates a VLAN identifier in an IEEE 802.1Q-2018
moscatelli
committed
tag [6] Multiple tags can be included for QinQ stacking. See note.
type: array
items:
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/String"
moscatelli
committed
2950
2951
2952
2953
2954
2955
2956
2957
2958
2959
2960
2961
2962
2963
2964
2965
2966
2967
2968
2969
2970
2971
2972
2973
2974
2975
2976
2977
protocol:
description: >
Indicates the L4 protocol, For IPv4 [7] this
corresponds to the field called "Protocol" to identify
the next level protocol. For IPv6 [28] this
corresponds to the field is called the "Next Header" field.
Permitted values: Any keyword defined in the IANA
protocol registry [1], e.g.:
TCP
UDP
ICMP
type: string
enum:
- TCP
- UDP
- ICMP
dscp:
description: >
For IPv4 [7] a string of "0" and "1" digits that
corresponds to the 6-bit Differentiated Services
Code Point (DSCP) field of the IP header.
For IPv6 [28] a string of "0" and "1" digits that
corresponds to the 6 differentiated services bits of
the traffic class header field
type: string
sourcePortRange:
description: >
Indicates a range of source ports
$ref: "#/definitions/PortRange"
moscatelli
committed
destinationPortRange:
description: >
Indicates a range of destination ports.
$ref: "#/definitions/PortRange"
moscatelli
committed
sourceIpAddressPrefix:
description: >
Indicates the source IP address range in CIDR format.
$ref: "#/definitions/IpAddressPrefix"
moscatelli
committed
destinationIpAddressPrefix:
description: >
Indicates the destination IP address range in CIDR format.
$ref: "#/definitions/IpAddressPrefix"
moscatelli
committed
extendedCriteria:
description: >
Indicates values of specific bits in a frame.
type: array
items:
$ref: "#/definitions/Mask"
moscatelli
committed
ChangeNsFlavourData:
description: >
This type specifies an existing NS instance for which the DF needs to be changed.
This specifies the new DF, the instantiationLevel of the new DF that may be used and
the additional parameters as input for the flavour change.
It shall comply with the provisions defined in Table 6.5.3.39-1.
type: object
required:
- newNsFlavourId
properties:
newNsFlavourId:
description: >
Identifier of the new NS DF to apply to this NS instance.
$ref: "#/definitions/IdentifierInNsd"
moscatelli
committed
instantiationLevelId:
description: >
Identifier of the instantiation level of the deployment flavour to be instantiated.
If not present, the default instantiation level as declared in the NSD is instantiated.
$ref: "#/definitions/IdentifierInNsd"
moscatelli
committed
AddPnfData:
description: >
This type specifies an PNF to be added to the NS instance and the PNF Profile
to use for this PNF. It shall comply with the provisions defined in Table 6.5.3.14-1.
type: object
required:
- pnfId
- pnfName
- pnfdId
- pnfProfileId
properties:
pnfId:
description: >
Identifier of the PNF. This identifier is allocated by the OSS/BSS.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
moscatelli
committed
pnfName:
description: >
Name of the PNF
type: string
pnfdId:
description: >
Identifier of the PNFD on which the PNF is based.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
moscatelli
committed
pnfProfileId:
description: >
Identifier of related PnfProfile in the NSD on which the PNF is based.
$ref: "#/definitions/IdentifierInNsd"
moscatelli
committed
cpData:
description: >
Address assigned for the PNF external CP(s).
type: array
items:
$ref: "#/definitions/PnfExtCpData"
PnfExtCpData:
description: >
This type represents the configuration data on the external CP of the PNF.
It shall comply with the provisions defined in
Table 6.5.3.16-1.
type: object
required:
- cpProtocolData
properties:
moscatelli
committed
description: >
Identifier of the CP. Shall be present for existing CP.
$ref: "#/definitions/IdentifierInPnf"
moscatelli
committed
cpdId:
description: >
Identifier of the Connection Point Descriptor (CPD) for this CP. Shall be present for new CP.
$ref: "#/definitions/IdentifierInNsd"
moscatelli
committed
cpProtocolData:
description: >
Address assigned for this CP.
type: array
items:
Samir Medjiah
committed
$ref: "#/definitions/CpProtocolData"
moscatelli
committed
ModifyPnfData:
description: >
This type specifies an PNF to be modified in the NS instance.
It shall comply with the provisions defined in
Table 6.5.3.15-1.
type: object
required:
- pnfId
anyOf:
- required:
- pnfName
- required:
- cpData
moscatelli
committed
properties:
pnfId:
description: >
Identifier of the PNF. This identifier is allocated by the OSS/BSS.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
moscatelli
committed
3094
3095
3096
3097
3098
3099
3100
3101
3102
3103
3104
3105
3106
3107
3108
3109
3110
3111
3112
3113
3114
3115
3116
3117
3118
3119
pnfName:
description: >
Name of the PNF.
type: string
cpData:
description: >
Address assigned for the PNF external CP(s).
type: array
items:
$ref: "#/definitions/PnfExtCpData"
AffectedVirtualLink:
description: >
This type provides information about added, deleted, modified and
temporary VLs.
type: object
required:
- id
- virtualLinkDescId
- changeType
- networkResource
properties:
id:
description: >
Identifier of the virtual link instance, identifying the applicable
"vnfVirtualLinkResourceInfo" entry in the "VnfInstance" data type.
$ref: "#/definitions/IdentifierInVnf"
moscatelli
committed
virtualLinkDescId:
description: >
Identifier of the related VLD in the VNFD.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd"
moscatelli
committed
changeType:
description: >
Signals the type of change. Permitted values:
* ADDED
* REMOVED
* MODIFIED
* TEMPORARY
* LINK_PORT_ADDED
* LINK_PORT_REMOVED
For a temporary resource, an AffectedVirtualLink structure exists as
long as the temporary resource exists.
moscatelli
committed
enum:
- ADDED
- REMOVED
- MODIFIED
- TEMPORARY
- LINK_PORT_ADDED
- LINK_PORT_REMOVED
linkPortIds:
description: >
Identifiers of the link ports of the affected VL related to the change.
Each identifier references an "NsLinkPortInfo" structure.
Shall be set when changeType is equal to "ADD_LINK_PORT" or "REMOVE_LINK_PORT", and the related "NsLinkPortInfo"
structures are present (case "add") or have been present (case "remove") in the NsVirtualLinkInfo structure
that is represented by the "virtualLink¬Info" attribute in the "NsInstance" structure.
The resource handles of the affected NS link ports can be found by dereferencing the identifiers in the
"linkPortIds" attribute.
type: array
items:
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInNs"
moscatelli
committed
networkResource:
moscatelli
committed
Reference to the VirtualNetwork resource. Detailed information is
(for new and modified resources) or has been (for removed
resources) available from the VIM.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/ResourceHandle"
moscatelli
committed
metadata:
description: >
Metadata about this resource.
The content of this attribute shall be a copy of the content of the
"metadata" attribute of the VnfVirtualLinkResourceInfo structure.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
moscatelli
committed
AffectedVirtualStorage:
moscatelli
committed
This type provides information about added, deleted, modified and
temporary virtual storage resources.
type: object
required:
moscatelli
committed
- id
- virtualStorageDescId
- changeType
- storageResource
moscatelli
committed
id:
moscatelli
committed
Identifier of the storage instance, identifying the applicable
"virtualStorageResourceInfo" entry in the "VnfInstance" data type.
$ref: "#/definitions/IdentifierInVnf"
moscatelli
committed
virtualStorageDescId:
moscatelli
committed
Identifier of the related VirtualStorage descriptor in the VNFD.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd"
moscatelli
committed
changeType:
moscatelli
committed
Signals the type of change. Permitted values:
* ADDED
* REMOVED
* MODIFIED
* TEMPORARY
For a temporary resource, an AffectedVirtualStorage structure exists
as long as the temporary resource exists.
type: string
enum:
- ADDED
- REMOVED
- MODIFIED
- TEMPORARY
storageResource:
description: >
Reference to the VirtualStorage resource. Detailed information is
(for new and modified resources) or has been (for removed
resources) available from the VIM.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/ResourceHandle"
moscatelli
committed
metadata:
moscatelli
committed
Metadata about this resource.
The content of this attribute shall be a copy of the content of the
"metadata" attribute of the VirtualStorageResourceInfo structure.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
AffectedVnf:
description: >
This type provides information about added, deleted and modified VNFs.
It shall comply with the provisions in Table 6.5.3.2-1.
type: object
required:
- vnfInstanceId
- vnfdId
moscatelli
committed
- vnfProfileId
- vnfName
- changeType
- changeResult
anyOf:
- required:
- changedExtConnectivity
- oneOf:
- required:
- changedVnfInfo
- required:
- modificationsTriggeredByVnfPkgChange
properties:
vnfInstanceId:
description: >
Identifier of the VNF instance.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
vnfdId:
description: >
Identifier of the VNFD of the VNF Instance.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
vnfProfileId:
description: >
Identifier of the VNF profile of the NSD.
$ref: "#/definitions/IdentifierInNsd"
vnfName:
description: >
Name of the VNF Instance.
type: string
changeType:
description: >
Signals the type of change
Permitted values:
- ADD
- REMOVE
- INSTANTIATE
- TERMINATE
- SCALE
- CHANGE_FLAVOUR
- HEAL
- OPERATE
- MODIFY_INFORMATION
- CHANGE_EXTERNAL_VNF_CONNECTIVITY
type: string
enum:
- ADD
moscatelli
committed
- REMOVE
- INSTANTIATE
- TERMINATE
- SCALE
- CHANGE_FLAVOUR
- HEAL
moscatelli
committed
- OPERATE
- MODIFY_INFORMATION
- CHANGE_EXTERNAL_VNF_CONNECTIVITY
changeResult:
description: >
Signals the result of change identified by the
"changeType" attribute.
Permitted values:
- COMPLETED
- ROLLED_BACK
- FAILED
type: string
enum:
- COMPLETED
moscatelli
committed
- ROLLED_BACK
- FAILED
changedInfo:
description: >
Information about the changed VNF instance
rameshnaraya
committed
information, including VNF configurable properties,if applicable.
When the "changedInfo" attribute is present,
either the "changedVnfInfo" attribute or the
"changedExtConnectivity" attribute or both shall be present.
anyOf:
- required:
- changedVnfInfo
- required:
- changedVnfInfo
- required:
- modificationsTriggeredByVnfPkgChange
oneOf:
- required:
- changedVnfInfo
- required:
- modificationsTriggeredByVnfPkgChange
rameshnaraya
committed
changedVnfInfo:
description: >
Information about the changed VNF instance
information, including configurable properties,
if applicable.
$ref: "#/definitions/ModifyVnfInfoData"
changedExtConnectivity:
description: >
Information about changed external connectivity,
if applicable.
type: array
items:
$ref: "#/definitions/ExtVirtualLinkInfo"
modificationsTriggeredByVnfPkgChange:
description: >
Information about performed changes of "VnfInstance" attributes triggered by changing the current
VNF package, if applicable. Shall be absent if the "operation" attribute is different from "CHANGE_VNFPKG".
At least one of the attributes "changedVnfInfo", "changedExtConnectivity" or "modificationsTriggeredByVnfPkgChange"
shall be present. Not more than one of "changedVnfInfo" and "modificationsTriggeredByVnfPkgChange" shall be present.
$ref: "#/definitions/ModificationsTriggeredByVnfPkgChange"
AffectedPnf:
description: >
This type provides information about added, deleted and modified PNFs.
It shall comply with the provisions in Table 6.5.3.3-1.
type: object
required:
- pnfId
- pnfdId
- pnfProfileId
moscatelli
committed
- cpInstanceId
properties:
pnfId:
description: >
Identifier of the affected PNF. This identifier is
allocated by the OSS/BSS.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
pnfdId:
description: >
Identifier of the PNFD on which the PNF is based.
$ref: "#/definitions/IdentifierInNsd"
pnfProfileId:
description: >
Identifier of the VNF profile of the NSD.
$ref: "#/definitions/IdentifierInNsd"
pnfName:
description: >
Name of the PNF.
type: string
cpInstanceId:
description: >
Identifier of the CP in the scope of the PNF.
type: array
moscatelli
committed
items:
$ref: "#/definitions/IdentifierInPnf"
changeType:
description: >
Signals the type of change.
Permitted values:
- ADD
- REMOVE
- MODIFY
type: string
enum:
- ADD
moscatelli
committed
- REMOVE
- MODIFY
changeResult:
description: >
Signals the result of change identified by the
"changeType" attribute.
Permitted values:
- COMPLETED
- ROLLED_BACK
- FAILED
type: string
enum:
- COMPLETED
moscatelli
committed
- ROLLED_BACK
- FAILED
AffectedVl:
description: >
This type provides information about added, deleted and modified VLs.
It shall comply with the provisions in Table 6.5.3.4-1.
type: object
required:
- nsVirtualLinkInstanceId
- nsVirtualLinkDescId
moscatelli
committed
- vlProfileId
properties:
nsVirtualLinkInstanceId:
description: >
Identifier of the VL Instance.
$ref: "#/definitions/IdentifierInNs"
nsVirtualLinkDescId:
description: >
Identifier of the VLD in the NSD for this VL.
$ref: "#/definitions/IdentifierInNsd"
vlProfileId:
description: >
Identifier of the VLD in the NSD for this VL.
$ref: "#/definitions/IdentifierInNsd"
changeType:
description: >
Signals the type of change.
Permitted values:
- ADD
- DELETE
- MODIFY
- ADD_LINK_PORT
- REMOVE_LINK_PORT
type: string
enum:
- ADD
moscatelli
committed
- DELETE
- MODIFY
moscatelli
committed
- REMOVE_LINK_PORT
changeResult:
description: >
Signals the result of change identified by the
"changeType" attribute.
Permitted values:
- COMPLETED
- ROLLED_BACK
- FAILED
type: string
enum:
- COMPLETED
moscatelli
committed
- ROLLED_BACK
moscatelli
committed
moscatelli
committed
description: >
This type provides information about added, deleted and modified VNFFG instances.
It shall comply with the
provisions in Table 6.5.3.5-1.
type: object
required:
- vnffgInstanceId
- vnffgdId
properties:
vnffgInstanceId:
description: >
Identifier of the VNFFG instance.
$ref: "#/definitions/IdentifierInNs"
moscatelli
committed
vnffgdId:
description: >
Identifier of the VNFFGD of the VNFFG instance.
$ref: "#/definitions/IdentifierInNsd"
moscatelli
committed
3467
3468
3469
3470
3471
3472
3473
3474
3475
3476
3477
3478
3479
3480
3481
3482
3483
3484
3485
3486
3487
3488
3489
3490
3491
3492
changeType:
description: >
Signals the type of change.
Permitted values:
- ADD
- DELETE
- MODIFY
type: string
enum:
- ADD
- DELETE
- MODIFY
changeResult:
description: >
Signals the result of change identified by the
"changeType" attribute.
Permitted values:
- COMPLETED
- ROLLED_BACK
- FAILED
type: string
enum:
- COMPLETED
- ROLLED_BACK
- FAILED
moscatelli
committed
description: >
This type provides information about added, deleted and modified nested NSs.
It shall comply with the provisions in Table 6.5.3.6-1.
type: object
required:
- nsInstanceId
- nsdId
- changeType
- changeResult
moscatelli
committed
properties:
nsInstanceId:
description: >
Identifier of the nested NS instance.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
moscatelli
committed
nsdId:
description: >
Identifier of the NSD of the nested NS instance.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
moscatelli
committed
3512
3513
3514
3515
3516
3517
3518
3519
3520
3521
3522
3523
3524
3525
3526
3527
3528
3529
3530
3531
3532
3533
3534
3535
3536
3537
3538
3539
3540
3541
3542
3543
3544
3545
3546
changeType:
description: >
Signals the type of lifecycle change.
Permitted values:
- ADD
- REMOVE
- INSTANTIATE
- SCALE
- UPDATE
- HEAL
- TERMINATE
type: string
enum:
- ADD
- REMOVE
- INSTANTIATE
- SCALE
- UPDATE
- HEAL
- TERMINATE
changeResult:
description: >
Signals the result of change identified by the
"changeType" attribute.
Permitted values:
- COMPLETED
- ROLLED_BACK
- FAILED
- PARTIALLY_COMPLETED
type: string
enum:
- COMPLETED
- ROLLED_BACK
- FAILED
- PARTIALLY_COMPLETED
changedInfo:
description: >
Information about the changed NS instance information, if applicable.
type: object
properties:
wanConnectionInfoModifications:
description: >
Information about the modified WAN related connectivity information, if applicable.
type: array
items:
$ref: "#/definitions/WanConnectionInfoModification"
moscatelli
committed
description: >
This type provides information about added, deleted and modified SAP of a NS.
It shall comply with the provisions in Table 6.5.3.7-1.
type: object
required:
- sapInstanceId
- sapdId
properties:
sapInstanceId:
description: >
Identifier of the nested NS instance.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
moscatelli
committed
sapdId:
description: >
Identifier of the NSD of the nested NS instance.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
moscatelli
committed
3576
3577
3578
3579
3580
3581
3582
3583
3584
3585
3586
3587
3588
3589
3590
3591
3592
3593
3594
3595
3596
3597
3598
3599
3600
3601
3602
3603
3604
3605
sapName:
description: >
Human readable name for the SAP.
type: string
changeType:
description: >
Signals the type of lifecycle change.
Permitted values:
- ADD
- REMOVE
- MODIFY
type: string
enum:
- ADD
- REMOVE
- MODIFY
changeResult:
description: >
Signals the result of change identified by the
"changeType" attribute.
Permitted values:
- COMPLETED
- ROLLED_BACK
- FAILED
type: string
enum:
- COMPLETED
- ROLLED_BACK
- FAILED
NsLcmOperationStateType:
description: >
The enumeration NsLcmOperationStateType shall comply with the provisions defined in Table 6.5.4.4-1.
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 won't 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 VNF prior to the original operation invocation has been restored as closely as possible.
type: string
enum:
- PROCESSING
- COMPLETED
- FAILED_TEMP
- FAILED
- ROLLING_BACK
moscatelli
committed
- ROLLED_BACK
moscatelli
committed
description: >
The enumeration NsLcmOpType represents those lifecycle operations that trigger a NS lifecycle management operation
occurrence notification.
Value | Description
------|------------
INSTANTIATE | Represents the "Instantiate NS" LCM operation.
SCALE | Represents the "Scale NS" LCM operation.
UPDATE | Represents the "Update NS" LCM operation.
TERMINATE | Represents the "Terminate NS" LCM operation.
HEAL | Represents the "Heal NS" LCM operation.
type: string
enum:
- INSTANTIATE
- SCALE
- UPDATE
- TERMINATE
- HEAL
LccnSubscriptionRequest:
description: >
This type represents a subscription request related to notifications
about NS lifecycle changes. It shall comply with the
provisions defined in Table 6.5.2.2-1..
type: object
required:
- callbackUri
properties:
moscatelli
committed
filter:
moscatelli
committed
Filter settings for this subscription, to define the subset
of all notifications this subscription relates to. A
particular notification is sent to the subscriber if the filter
matches, or if there is no filter.
$ref: "#/definitions/LifecycleChangeNotificationsFilter"
callbackUri:
description: >
The URI of the endpoint to send the notification to.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Uri"
authentication:
description: >
Authentication parameters to configure the use of Authorization when
sending notifications corresponding to this subscription, as defined
in clause 8.3.4 of ETSI GS NFV-SOL 013.
This attribute shall only be present if the subscriber requires
authorization of notifications.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/SubscriptionAuthentication"
verbosity:
description: >
This attribute signals the requested verbosity of LCM operation occurrence notifications.
If it is not present, it shall default to the value "FULL".
$ref: "#/definitions/LcmOpOccNotificationVerbosityType"
moscatelli
committed
LccnSubscription:
description: >
This type represents a subscription related to notifications about NS lifecycle changes.
It shall comply with the provisions defined in Table 6.5.2.4-1.
type: object
required:
- id
- callbackUri
- _links
properties:
id:
description: >
Identifier of this subscription resource.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
filter:
description: >
Filter settings for this subscription, to define the subset of all
notifications this subscription relates to. A particular
notification is sent to the subscriber if the filter matches, or if
there is no filter.
$ref: "#/definitions/LifecycleChangeNotificationsFilter"
callbackUri:
description: >
The URI of the endpoint to send the notification to.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Uri"
verbosity:
description: >
This attribute signals the verbosity of LCM operation occurrence notifications.
$ref: "#/definitions/LcmOpOccNotificationVerbosityType"
_links:
description: >
Links to resources related to this resource.
type: object
required:
- self
properties:
self:
description: >
URI of this resource.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Link"
LifecycleChangeNotificationsFilter:
description: >
This type represents a subscription filter related to notifications about
NS lifecycle changes. It shall comply with the
provisions defined in Table 6.5.3.8-1.
At a particular nesting level in the filter structure, the following applies:
All attributes shall match in order for the filter
to match (logical "and" between different filter attributes).
If an attribute is an array, the attribute shall match if at least
one of the values in the array matches (logical "or" between the values of one filter attribute).
type: object
properties:
nsInstanceSubscriptionFilter:
description: >
Filter criteria to select NS instances about which to notify.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/NsInstanceSubscriptionFilter"
notificationTypes:
description: >
Match particular notification types.
Permitted values:
- NsLcmOperationOccurenceNotification
- NsIdentifierCreationNotification
- NsIdentifierDeletionNotification
- NsChangeNotification
type: array
items:
type: string
enum:
- NsLcmOperationOccurenceNotification
- NsIdentifierCreationNotification
- NsIdentifierDeletionNotification
moscatelli
committed
- NsChangeNotification
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
moscatelli
committed
items:
$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
moscatelli
committed
items:
$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
moscatelli
committed
items:
$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
moscatelli
committed
items:
$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
moscatelli
committed
items:
$ref: "#/definitions/LcmOpOccStatusForChangeNotificationType"
moscatelli
committed
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.
$ref: "#/definitions/IdentifierInNsd"
nsScaleLevelId:
description: >
Identifier of the NS scale level.
$ref: "#/definitions/IdentifierInNsd"
ScaleNsData:
description: >
This type represents the information to scale a NS.
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.
type: array
moscatelli
committed
items:
$ref: "#/definitions/VnfInstanceData"
vnfInstanceToBeRemoved:
description: >
The VNF instance to be removed from the NS
instance as part of the scaling operation.
type: array
moscatelli
committed
items:
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
scaleNsByStepsData:
description: >
The information used to scale an NS instance by
one or more scaling steps.
moscatelli
committed
$ref: "#/definitions/ScaleNsByStepsData"
scaleNsToLevelData:
description: >
The information used to scale an NS instance to a target size.
moscatelli
committed
$ref: "#/definitions/ScaleNsToLevelData"
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
covered in additionalParamForVnf).
moscatelli
committed
$ref: "#/definitions/ParamsForVnf"
additionalParamsForVnf:
description: >
Allows the OSS/BSS to provide additional
parameter(s) per VNF instance (as opposed to
the NS level, which is covered in
additionalParamforNs). This is for VNFs that are
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
moscatelli
committed
items:
$ref: "#/definitions/ParamsForVnf"
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
moscatelli
committed
items:
$ref: "#/definitions/VnfLocationConstraint"
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"
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.
type: object
required:
- vnfInstanceid
moscatelli
committed
- scaleVnfType
oneOf:
- required:
- scaleToLevelData
- required:
- scaleByStepData
description: >
Identifier of the VNF instance being scaled.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
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
capabilities of the VNF being managed.
type: string
moscatelli
committed
enum:
moscatelli
committed
- SCALE_IN
- SCALE_TO_INSTANTIATION_LEVEL
- SCALE_TO_SCALE_LEVEL(S)
scaleToLevelData:
description: >
The information used for scaling to a given level.
moscatelli
committed
$ref: "#/definitions/ScaleToLevelData"
scaleByStepData:
description: >
The information used for scaling by steps.
moscatelli
committed
$ref: "#/definitions/ScaleByStepData"
3933
3934
3935
3936
3937
3938
3939
3940
3941
3942
3943
3944
3945
3946
3947
3948
3949
3950
3951
3952
3953
3954
3955
3956
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.
$ref: "#/definitions/IdentifierInNsd"
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.
type: object
oneOf:
- required:
- nsInstantiationLevel
- required:
- nsScaleInfo
properties:
nsInstantiationLevel:
description: >
Identifier of the target NS instantiation level of the
current DF to which the NS instance is requested to be scaled.
$ref: "#/definitions/IdentifierInNsd"
nsScaleInfo:
description: >
For each NS scaling aspect of the current DF, defines
the target NS scale level to which the NS instance is to be scaled.
type: array
moscatelli
committed
items:
$ref: "#/definitions/NsScaleInfo"
moscatelli
committed
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
ScaleVnfToLevel operation towards the appropriate VNFM..
type: object
anyOf:
- required:
- vnfInstantiationLevelId
- required:
- vnfScaleInfo
properties:
vnfInstantiationLevelId:
description: >
Identifier of the target instantiation level of the current
deployment flavor to which the VNF is requested to be scaled.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd"
vnfScaleInfo:
description: >
For each scaling aspect of the current deployment
flavor, indicates the target scale level to which the VNF
is to be scaled.
type: array
moscatelli
committed
items:
$ref: "#/definitions/VnfScaleInfo"
additionalParams:
description: >
Additional parameters passed by the NFVO as input to
the scaling process, specific to the VNF being scaled.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
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.
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.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd"
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
instances of a particular VNF.
type: integer
moscatelli
committed
default: 1
additionalParams:
description: >
Additional parameters passed by the NFVO as input to
the scaling process, specific to the VNF instance being scaled.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
moscatelli
committed
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
moscatelli
committed
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
moscatelli
committed
- NS
Samir Medjiah
committed
4087
4088
4089
4090
4091
4092
4093
4094
4095
4096
4097
4098
4099
4100
4101
4102
4103
4104
4105
4106
4107
4108
4109
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
moscatelli
committed
- VNF_SCALE_TO_LEVEL
- VNF_CHANGE_FLAVOUR
- VNF_TERMINATE
- VNF_HEAL
- VNF_OPERATE
- VNF_CHANGE_EXT_CONN
- VNF_MODIFY_INFO
- NS_INSTANTIATE
- NS_SCALE
moscatelli
committed
- NS_UPDATE
- NS_TERMINATE
- NS_HEAL
Samir Medjiah
committed
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.
PARTIALLY_COMPLETED | The impact on the NS component stops and related lifecycle operation partially completes. Inconsistency state may exist on the NS component.
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
moscatelli
committed
- PARTIALLY_COMPLETED
- 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.
type: object
required:
- id
- operationState
- nsInstanceId
- lcmOperationType
- startTime
- isAutomaticInvocation
- isCancelPending
- _links
properties:
id:
description: >
Identifier of this NS lifecycle operation occurrence.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
operationState:
description: >
The state of the NS LCM operation.
Samir Medjiah
committed
$ref: "#/definitions/NsLcmOperationStateType"
Date-time when the current state has been entered.
$ref: "../../definitions/SOL005_def.yaml#/definitions/DateTime"
nsInstanceId:
description: >
Identifier of the NS instance to which the operation applies.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
lcmOperationType:
description: >
Type of the actual LCM operation represented by this
lcm operation occurrence.
Samir Medjiah
committed
$ref: "#/definitions/NsLcmOpType"
startTime:
description: >
Date-time of the start of the operation.
$ref: "../../definitions/SOL005_def.yaml#/definitions/DateTime"
4184
4185
4186
4187
4188
4189
4190
4191
4192
4193
4194
4195
4196
4197
4198
4199
4200
4201
4202
4203
4204
4205
4206
4207
4208
4209
4210
4211
4212
4213
4214
4215
4216
4217
4218
4219
4220
4221
4222
4223
4224
4225
4226
4227
4228
4229
4230
4231
4232
4233
4234
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.
$ref: "../../definitions/SOL005_def.yaml#/definitions/ProblemDetails"
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
represents the result of a lifecycle operation.
type: array
items:
Samir Medjiah
committed
$ref: "#/definitions/AffectedVnf"
affectedPnfs:
description: >
Information about the PNF instances that were affected
during the lifecycle operation, if this notification
represents the result of a lifecycle operation.
type: array
items:
Samir Medjiah
committed
$ref: "#/definitions/AffectedPnf"
affectedVls:
description: >
Information about the VL instances that were affected
during the lifecycle operation, if this notification
represents the result of a lifecycle operation.
type: array
items:
$ref: "#/definitions/AffectedVirtualLink"
affectedVnffgs:
description: >
Information about the VNFFG instances that were
affected during the lifecycle operation, if this notification
represents the result of a lifecycle operation. See note
type: array
items:
Samir Medjiah
committed
$ref: "#/definitions/AffectedVnffg"
affectedNss:
description: >
Information about the nested NS instances that were
affected during the lifecycle operation, if this notification
represents the result of a lifecycle operation. See note.
type: array
items:
Samir Medjiah
committed
$ref: "#/definitions/AffectedNs"
affectedSaps:
description: >
Information about the nested NS instances that were
affected during the lifecycle operation, if this notification
represents the result of a lifecycle operation. See note.
type: array
items:
Samir Medjiah
committed
$ref: "#/definitions/AffectedSap"
_links:
description: >
Links to resources related to this resource.
type: object
required:
- self
- nsInstance
properties:
self:
description: >
URI of this resource.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Link"
nsInstance:
description: >
Link to the NS instance that the operation applies to.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Link"
cancel:
description: >
Link to the task resource that represents the "cancel"
operation for this LCM operation occurrence, if
cancelling is currently allowed.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Link"
retry:
description: >
Link to the task resource that represents the "cancel"
operation for this LCM operation occurrence,
if cancelling is currently allowed.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Link"
rollback:
description: >
Link to the task resource that represents the "rollback"
operation for this LCM operation occurrence, if rolling
back is currently allowed.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Link"
continue:
description: >
Link to the task resource that represents the "continue"
operation for this LCM operation occurrence, if rolling
back is currently allowed.
Samir Medjiah
committed
$ref: "../../definitions/SOL005_def.yaml#/definitions/Link"
fail:
description: >
Link to the task resource that represents the "fail"
operation for this LCM operation occurrence, if rolling
back is currently allowed.
Samir Medjiah
committed
4336
4337
4338
4339
4340
4341
4342
4343
4344
4345
4346
4347
4348
4349
4350
4351
4352
4353
4354
4355
4356
4357
4358
4359
4360
4361
4362
4363
4364
4365
4366
4367
4368
4369
4370
4371
4372
4373
$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.
type: object
anyOf:
- required:
- ipAddresses
- required:
- macAddress
Samir Medjiah
committed
properties:
macAddress:
description: >
MAC address. If this attribute is not present, it shall be chosen by the NFV MANO.
$ref: "#/definitions/MacAddress"
segmentationId:
description: >
Identification of the network segment to which the Cp instance connects to.
If the Cp instance represents a subport in a trunk, "segmentationId" shall be present.
Otherwise it shall not be present.
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.
type: string
Samir Medjiah
committed
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.
If this attribute is not present, no IP address shall be assigned.
type: array
items:
type: object
required:
- type
oneOf:
- required:
- fixedAddresses
- required:
- numDynamicAddresses
- required:
- addressRange
Samir Medjiah
committed
properties:
type:
description: >
The type of the IP addresses.
Permitted values: IPV4, IPV6.
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:
$ref: "#/definitions/IpAddress"
Samir Medjiah
committed
4431
4432
4433
4434
4435
4436
4437
4438
4439
4440
4441
4442
4443
4444
4445
4446
4447
4448
4449
4450
4451
numDynamicAddresses:
description: >
Number of dynamic addresses to assign (from the subnet defined
by "subnetId" if provided).
Exactly one of "fixedAddresses", "numDynamicAddresses" or
"ipAddressRange" shall be present.
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.
$ref: "#/definitions/IpAddress"
Samir Medjiah
committed
maxAddress:
description: >
Highest IP address belonging to the range.
$ref: "#/definitions/IpAddress"
Samir Medjiah
committed
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.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVim"
Samir Medjiah
committed
4465
4466
4467
4468
4469
4470
4471
4472
4473
4474
4475
4476
4477
4478
4479
4480
4481
4482
4483
4484
4485
4486
4487
4488
4489
4490
4491
4492
4493
4494
4495
4496
ExtVirtualLinkData:
description: >
This type represents an external VL. It shall comply with the provisions defined in Table 6.5.3.26-1.
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.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVim"
Samir Medjiah
committed
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
external connection points to this external VL.
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:
Samir Medjiah
committed
- resourceId
properties:
extManagedVirtualLinkId:
description: >
The identifier of the externally-managed internal VL
instance, if provided.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
Samir Medjiah
committed
description: >
The identifier of the VLD in the VNFD for this VL.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd"
Samir Medjiah
committed
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.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVim"
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"
Samir Medjiah
committed
VnfExtCpData:
description: >
This type represents configuration information for external CPs created
from a CPD.
type: object
required:
- cpdId
properties:
cpdId:
description: >
The identifier of the CPD in the VNFD.
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.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd"
Samir Medjiah
committed
cpConfig:
description: >
Map of instance data that need to be configured on the CP instances created from the respective CPD.
The key of the map which identifies the individual VnfExtCpConfig entries is managed by the API consumer.
The entries shall be applied by the VNFM according to the rules of JSON Merge Patch (see IETF RFC 7396).
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.
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.
Samir Medjiah
committed
4595
4596
4597
4598
4599
4600
4601
4602
4603
4604
4605
4606
4607
4608
4609
4610
4611
4612
4613
4614
4615
4616
4617
4618
4619
4620
4621
4622
4623
4624
4625
4626
type: array
items:
$ref: "#/definitions/VnfExtCpConfig"
ExtLinkPortData:
description: >
This type represents an externally provided link port to be used to
connect an external connection point to an external VL.
type: object
required:
- id
- resourceHandle
properties:
id:
description: >
Identifier of this link port as provided by the entity that has
created the link port.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
resourceHandle:
description: >
Reference to the virtualised resource realizing this link port.
$ref: "../../definitions/SOL005_def.yaml#/definitions/ResourceHandle"
VnfExtCpConfig:
description: >
This type represents an externally provided link port or network address
information per instance of an external connection point. In case a link
port is provided, the VNFM shall use that link port when connecting the
external CP to the external VL. In a link port is not provided, the VNFM
shall create a link port on the external VL, and use that link port to
connect the external CP to the external VL.
type: object
anyOf:
- required:
- linkPortId
- required:
- cpProtocolData
Samir Medjiah
committed
properties:
parentCpConfigId:
description: >
Value of the key that identifies to the "VnfExtCpConfig" entry that corresponds to the parent port of the trunk.
Only present in "VnfExtCpConfig" map structures which provide configuration information for a CP which represents
a subport in a trunk, and if parent ports are supported.
$ref: "#/definitions/IdentifierInVnf"
Samir Medjiah
committed
linkPortId:
description: >
Identifier of a pre-configured link port to which the external CP
will be associated.
The following conditions apply to the attributes "linkPortId" and
"cpProtocolData":
* At least one of the "linkPortId" and "cpProtocolData" attributes
shall be present for a to-be-created external CP instance or an
existing external CP instance.
Samir Medjiah
committed
* If the "linkPortId" attribute is absent, the VNFM shall create a
link port.
* If the "cpProtocolData" attribute is absent, the "linkPortId"
attribute shall be provided referencing a pre-created link port,
and the VNFM can use means outside the scope of the present
document to obtain the pre-configured address information for the
connection point from the resource representing the link port.
* If both "cpProtocolData" and "linkportId" are provided, the API
consumer shall ensure that the cpProtocolData can be used with the
pre-created link port referenced by "linkPortId".
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
cpProtocolData:
description: >
Parameters for configuring the network protocols on the link port
that connects the CP to a VL.
The following conditions apply to the attributes "linkPortId" and "cpProtocolData":
* At least one of the "linkPortId" and "cpProtocolData" attributes
shall be present for a to-be-created external CP instance or an
existing external CP instance.
* If the "linkPortId" attribute is absent, the VNFM shall create a
link port.
* If the "cpProtocolData" attribute is absent, the "linkPortId"
attribute shall be provided referencing a pre-created link port,
and the VNFM can use means outside the scope of the present
document to obtain the pre-configured address information for the
connection point from the resource representing the link port.
* If both "cpProtocolData" and "linkportId" are provided, the API
consumer shall ensure that the cpProtocolData can be used with the
pre-created link port referenced by "linkPortId".
Samir Medjiah
committed
type: array
items:
$ref: "#/definitions/CpProtocolData"
4681
4682
4683
4684
4685
4686
4687
4688
4689
4690
4691
4692
4693
4694
4695
4696
4697
4698
4699
4700
4701
4702
4703
4704
4705
4706
4707
4708
4709
4710
4711
4712
4713
4714
4715
4716
4717
4718
4719
4720
4721
4722
4723
4724
4725
4726
4727
4728
IdentifierInNs:
description: >
An identifier that is unique with respect to a NS. Representation: string of variable length.
type: string
IdentifierInNsd:
description: >
An identifier that is unique within a NS descriptor. Representation: string of variable length.
type: string
IdentifierInPnf:
description: >
An Identifier that is unique within respect to a PNF. Representation: string of variable length.
type: string
IdentifierInVim:
description: >
An identifier maintained by the VIM or other resource provider.
It is expected to be unique within the VIM instance. Representation: string of variable length.
type: string
IdentifierInVnf:
description: >
An identifier that is unique for the respective type within a VNF
instance, but may not be globally unique.
type: string
MacAddress:
description: >
A MAC address. Representation: string that consists of groups of two hexadecimal digits,
separated by hyphens or colons.
type: string
format: MAC
IpAddress:
description: >
An IPV4 or IPV6 address. Representation: In case of an IPV4 address, string that consists of four decimal
integers separated by dots, each integer ranging from 0 to 255. In case of an IPV6 address, string that
consists of groups of zero to four hexadecimal digits, separated by colons.
type: string
format: IP
IpAddressPrefix:
description: >
An IPV4 or IPV6 address range in CIDR format. For IPV4 address range, refer to IETF RFC 4632 [12].
For IPV6 address range, refer to IETF RFC 4291.
type: string
Samir Medjiah
committed
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
4754
4755
4756
4757
4758
4759
4760
4761
4762
4763
4764
4765
4766
4767
4768
4769
4770
4771
4772
4773
PortRange:
description: >
The PortRange data type provides the lower and upper bounds of a range of Internet ports.
It shall comply with the provisions defined in Table 6.5.3.42-1.
type: object
required:
- lowerPort
- upperPort
properties:
lowerPort:
description: >
Identifies the lower bound of the port range. upperPort Integer
type: integer
minimum: 0
upperPort:
description: >
Identifies the upper bound of the port range.
type: integer
minimum: 0
Mask:
description: >
The Mask data type identifies the value to be matched for a sequence of
bits at a particular location in a frame. It shall
comply with the provisions defined in Table 6.5.3.41-1.
type: object
required:
- startingPoint
- length
- value
properties:
startingPoint:
description: >
Indicates the offset between the last bit of the source
mac address and the first bit of the sequence of bits
to be matched.
type: integer
length:
description: >
Indicates the number of bits to be matched.
type: integer
value:
description: >
Provide the sequence of bit values to be matched.
type: string
VnfSnapshotInfo:
description: |
This type represents an "Individual VNF snapshot" resource. The "id" attributed is used by the NFVO to index and
identify the VNF snapshots information resources that are accessible via the NFVO. The identifier is still
generated by the VNFM and copied into the present "VnfSnapshotInfo" representing the "Individual VNF snapshot"
resource hold by the NFVO.
type: object
required:
- id
properties:
id:
description: >
Identifier of the "Individual VNF snapshot" resource. This identifier is allocated by the VNFM.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
vnfSnapshotPkgId:
description: >
Identifier of the VNF snapshot package information held by the NFVO. Shall be present when the
"Individual VNF snapshot" resource is created from a VNF snapshot package extraction.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
vnfSnapshot:
description: >
Information about the VNF snapshot, content and/or references to its content. Shall be present when the
"Individual VNF snapshot" resource is associated to a VNF snapshot on a VNFM, either created via the
corresponding "Create VNF Snapshot" task resource or extracted from a VNF snapshot package.
$ref: '#/definitions/VnfSnapshot'
_links:
description: >
Links to resources related to this resource.
type: object
required:
- self
properties:
self:
description: >
URI of this resource.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Link"
4811
4812
4813
4814
4815
4816
4817
4818
4819
4820
4821
4822
4823
4824
4825
4826
4827
4828
4829
4830
4831
4832
VnfSnapshot:
description: >
This type represents a VNF Snapshot. It shall comply with the provisions defined in table 6.5.2.18-1.
type: object
required:
- id
- vnfInstanceId
- triggeredAt
- createdAt
- vnfdId
- vnfInstance
- vnfcSnapshots
properties:
id:
description: >
Identifier of the VNF snapshot. This identifier is allocated by the VNFM.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
vnfInstanceId:
description: >
Identifier of the snapshotted VNF instance.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
Timestamp indicating when the VNF Snapshot creation has been started by the VNFM.
$ref: "../../definitions/SOL005_def.yaml#/definitions/DateTime"
Timestamp indicating when the VNF Snapshot has been completed by the VNFM.
4840
4841
4842
4843
4844
4845
4846
4847
4848
4849
4850
4851
4852
4853
4854
4855
4856
4857
4858
4859
4860
4861
4862
4863
4864
4865
4866
4867
4868
4869
4870
4871
4872
4873
4874
4875
4876
4877
4878
4879
4880
4881
4882
4883
4884
4885
4886
4887
4888
4889
4890
4891
4892
4893
4894
4895
4896
4897
$ref: "../../definitions/SOL005_def.yaml#/definitions/DateTime"
vnfdId:
description: >
Identifier of the VNFD in use at the time the snapshot of the VNF instance has been created.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
vnfInstance:
description: >
VNF instance information of the snapshotted VNF instance. This is a copy of the "Individual VNF instance" resource.
$ref: '#/definitions/VnfInstance'
vnfcSnapshots:
description: >
Information about VNFC Snapshots constituting this VNF Snapshot.
type: array
items:
$ref: '#/definitions/VnfcSnapshotInfo'
userDefinedData:
description: >
User defined data for the VNF Snapshot.
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
WanConnectionInfo:
description: |
This type provides information about the connectivity to the WAN of network resources realizing a VL, e.g.,
when the VL is deployed on several sites across a WAN. It shall comply with the provisions defined in table 6.5.3.90-1.
type: object
required:
- wanConnectionInfoId
oneOf:
- required:
- nsVirtualLinkInfoId
- required:
- vnfVirtualLinkResourceInfoId
properties:
wanConnectionInfoId:
description: >
Identifies this WAN connection information.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInNs"
nsVirtualLinkInfoId:
description: >
References the NS VL instance to which the connection information is associated. Shall be present if a
corresponding NS VL instance has been created.
Either a "nsVirtualLinkInfoId" or a "vnfVirtualLinkResourceInfoId" shall be provided, but not both.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInNs"
vnfVirtualLinkResourceInfoId:
description: >
References the VNF VL instance to which the connection information is associated. Shall be present if a
corresponding VNF VL instance has been created.
Either a "nsVirtualLinkInfoId" or a "vnfVirtualLinkResourceInfoId" shall be provided, but not both.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInNs"
protocolInfo:
description: >
Protocol specific information for connecting to the WAN.
$ref: "#/definitions/WanConnectionProtocolInfo"
WanConnectionProtocolInfo:
description: |
This type provides protocol specific information about the connectivity to the WAN of network resources realizing
a VL, e.g., when the VL is deployed on several sites and across a WAN, and the related multi-site connectivity
service (MSCS) enabling the connectivity through the WAN. This type supports providing information about both
pre-provisioned WAN connectivity realized by external entities to NFV-MANO but parts of such connectivity is known
to the NFVO, as well as information about MSCS created under NFV-MANO responsibility (i.e., connectivity is realized
when NFVO communicates with the WIM). It shall comply with the provisions defined in table 6.5.3.91-1.
4902
4903
4904
4905
4906
4907
4908
4909
4910
4911
4912
4913
4914
4915
4916
4917
4918
4919
4920
4921
4922
4923
4924
4925
4926
4927
4928
4929
4930
4931
4932
4933
4934
4935
4936
4937
4938
4939
4940
4941
4942
4943
4944
4945
4946
4947
4948
4949
4950
4951
4952
4953
4954
4955
4956
4957
4958
4959
4960
4961
4962
4963
4964
4965
4966
4967
4968
4969
4970
4971
4972
4973
4974
4975
4976
4977
4978
4979
4980
4981
4982
4983
4984
4985
4986
4987
4988
4989
4990
4991
4992
4993
4994
4995
4996
4997
4998
4999
5000
5001
5002
5003
5004
5005
5006
5007
5008
5009
5010
5011
5012
5013
5014
5015
5016
5017
5018
5019
5020
5021
5022
5023
5024
5025
5026
5027
5028
5029
5030
5031
5032
5033
5034
5035
5036
5037
5038
5039
5040
5041
5042
5043
5044
5045
5046
5047
5048
5049
5050
5051
5052
5053
5054
5055
5056
5057
5058
5059
5060
5061
5062
5063
5064
5065
5066
5067
5068
5069
5070
5071
5072
5073
5074
5075
5076
5077
5078
type: object
properties:
mscsInfo:
description: >
Information about the provisioned MSCS, if already available.
$ref: "#/definitions/MscsInfo"
connectivityServiceEndpoints:
description: >
Configuration information about the network resources in the NFVI-PoP and their connectivity to the WAN.
type: array
items:
$ref: "#/definitions/ConnectivityServiceEndpointInfo"
NsLocationConstraint:
description: |
type: object
WanConnectionData:
description: |
This type provides information used to connect the comprising network resources realizing a VL, e.g., when the VL
is deployed on several sites and across a WAN. It shall comply with the provisions defined in table 6.5.3.80-1.
type: object
required:
- protocolData
oneOf:
- required:
- nsVirtualLink
- required:
- vnfVirtualLink
properties:
nsVirtualLink:
description: >
Information used to identify the NS VL for which the WAN connectivity data is applicable.
Either a "nsVirtualLink" or a "vnfVirtualLink" shall be provided, but not both.
type: object
required:
- nsVirtualLinkDescId
- nsVirtualLinkProfileId
properties:
nsVirtualLinkDescId:
description: >
Identifier of the VLD in the NSD from which the VL is created in the case of a multi-site NS VL.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInNsd"
nsVirtualLinkProfileId:
description: >
Identifier of the VL profile in the NSD.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInNsd"
vnfVirtualLink:
description: >
Information used to identify the VNF VL for which the WAN connectivity data is applicable.
Either a "nsVirtualLink" or a "vnfVirtualLink" shall be provided, but not both.
type: object
required:
- vnfProfileId
- vnfVirtualLinkDescId
- vnfVirtualLinkProfileId
properties:
vnfProfileId:
description: >
Identifier of the VNF profile.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInNsd"
vnfVirtualLinkDescId:
description: >
Identifier of the VLD in the VNFD from which the VL is created in the case of a multi-site internal VNF VL.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd"
vnfVirtualLinkProfileId:
description: >
Identifier of the VL profile in the VNFD.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInVnfd"
protocolData:
description: >
Protocol specific information for connecting to the WAN.
$ref: "#/definitions/WanConnectionProtocolData"
ChangeVnfPackageData:
description: |
This type specifies the information needed to change the current VNF package for a VNF instance. Clause B.3 of the
ETSI GS NFV-IFA 007 illustrates the variants of changes to the current VNF Package and information flow procedures.
This operation encompasses the following scenarios:
* Changes of the VNF virtualised resources, such as requirements, composition and structure between the VNF versions,
without changing the VNF software version.
* Changes of both the VNF software version and the VNF virtualised resources. This case includes replacing the VNF
software version by means of virtualised resources management, such as terminating the current virtualized resource
instances running the current software version and instantiating new virtualized resource instances with the
destination VNF software version. The new virtualized resource instances may have the same characteristics as the
current virtualized resource instances.
* Changes related to the VNFD, such as correction of bugs in the VNFD, changes in the naming scheme of VNFD components
(e.g. name of the VDU, vduId), and adding/removing descriptors of VNF Package changes (VnfPackageChangeInfo).
NOTE: For software updates that are executed by functional entities outside NFV-MANO and that require synchronization
of the information held by the NFV-MANO entities with a new VNF package that reflects the same changes, an
alternative procedure using the PATCH method on the "Individual VNF instance" resource has been defined, as
illustrated in annex B.2 of ETSI GS NFV-IFA 007 [19]. This procedure assumes certain restrictions on the
characteristics of the new VNF package, as defined in note 1 in table 5.5.2.2-1 of ETSI GS NFV-SOL 003.
This type shall comply with the provisions defined in Table 6.5.3.54-1.
type: object
required:
- vnfInstanceId
- vnfdId
properties:
vnfInstanceId:
description: >
Identifier of the VNF instance.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
vnfdId:
description: >
Identifier of the VNFD which defines the destination VNF Package for the change.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
extVirtualLinks:
description: >
Information about external VLs to connect the VNF to. Entries in the list that are unchanged need not be
supplied as part of this request.
type: array
items:
$ref: "#/definitions/ExtVirtualLinkData"
extManagedVirtualLinks:
description: >
Information about internal VLs that are managed by the NFVO.
type: array
items:
$ref: "#/definitions/ExtManagedVirtualLinkData"
additionalParams:
description: >
Additional parameters passed by the OSS/BSS as input to the change current VNF package process, specific to the
VNF of which the underlying VNF package is changed, as declared in the VNFD as part of "ChangeCurrentVnfPkgOpConfig".
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
extensions:
description: >
If present, this attribute provides modifications to the values of the "extensions" attribute in "VnfInstance",
as defined in clause 6.5.3.57. Provisions for handling extensions during the operation, and needed passed
parameter values in case of conflicts, are defined in clause 5.4.11a.3.1 of ETSI GS NFV-SOL 003.
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
vnfConfigurableProperties:
description: >
If present, this attribute provides modifications to the values of the VNF configurable properties attribute in
the "VnfInstance", as defined in clause 6.5.3.57. Provisions for handling VNF configurable properties during the
operation, and needed passed parameter values in case of conflicts, are defined in clause 5.4.11a.3.1 of ETSI
GS NFV-SOL 003.
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
DeleteVnfSnapshotData:
description: >
This type specifies the identifier of information of an available VNF Snapshot to be deleted and the identifier of
the related VNF instance of the NS instance. It shall comply with the provisions defined in Table 6.5.3.74-1.
type: object
required:
- vnfInstanceId
- vnfSnapshotInfoId
properties:
vnfInstanceId:
description: >
Identifier of the VNF instance to identify the VNFM holding the VNF Snapshot information to be deleted.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
vnfSnapshotInfoId:
description: >
Identifier of information held by the VNFM about the VNF Snapshot to be deleted.
This identifier was allocated by the VNFM.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
RevertVnfToSnapshotData:
description: >
This type specifies the identifier of an existing VNF instance of the NS instance to be reverted and the identifier
of an existing VNF Snapshot to be reverted to. It shall comply with the provisions defined in Table 6.5.3.75-1.
type: object
required:
- vnfInstanceId
- vnfSnapshotInfoId
properties:
vnfInstanceId:
description: >
Identifier of the VNF instance to identify the VNFM holding the VNF Snapshot information to be reverted.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
vnfSnapshotInfoId:
description: >
Identifier of information held by the VNFM about the VNF Snapshot to be reverted.
This identifier was allocated by the VNFM.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
additionalParams:
description: >
Additional input parameters for the revert to VNF snapshot process, specific for the VNF being “reverted”,
as declared in the VNFD as part of “RevertToSnapshotVnfOpConfig”.
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
5084
5085
5086
5087
5088
5089
5090
5091
5092
5093
5094
5095
5096
5097
5098
5099
5100
5101
5102
5103
5104
5105
5106
5107
5108
5109
5110
5111
5112
5113
5114
5115
5116
5117
5118
5119
5120
5121
5122
5123
5124
5125
5126
5127
CreateVnfSnapshotData:
description: >
This type represents the information that are needed for VNF snapshot creation. When the NFVO invokes the Create
VNF snapshot operation, a set of these parameters are then passed by the NFVO to the VNFM. It shall comply with
the provisions defined in Table 6.5.3.76-1.
type: object
required:
- vnfInstanceId
properties:
vnfInstanceId:
description: >
Identifier of the VNF instance to perform the snapshot from.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
additionalParams:
description: >
Additional input parameters for the snapshot creation process, specific for the VNF being “snapshotted”, as
declared in the VNFD as part of “CreateSnapshotVnfOpConfig”.
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
userDefinedData:
description: >
User defined data for the VNF snapshot.
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
VnfcSnapshotInfo:
description: >
This type represents a VNFC Snapshot. It shall comply with the provisions defined in table 6.5.3.77-1.
type: object
required:
- id
- vnfcInstanceId
- triggeredAt
- createdAt
- vnfcInfoId
properties:
id:
description: >
Identifier of the information held by the VNFM about a specific VNFC Snapshot. This identifier is allocated by
the VNFM and is unique within the scope of a VNF snapshot.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
vnfcInstanceId:
description: >
Identifier of the snapshotted VNFC instance.
$ref: "#/definitions/IdentifierInVnf"
Timestamp indicating when the VNFC Snapshot creation has been started by the VNFM.
$ref: "../../definitions/SOL005_def.yaml#/definitions/DateTime"
Timestamp indicating when the VNFC Snapshot has been completed by the VNFM.
$ref: "../../definitions/SOL005_def.yaml#/definitions/DateTime"
Reference to the "VnfcResourceInfo" structure that represents the resources of the snapshotted VNFC instance.
A snapshot of that structure is available in the "vnfInstance" attribute of the "VnfSnapshot" structure.
$ref: "#/definitions/IdentifierInVnf"
computeSnapshotResource:
description: >
Reference to a compute snapshot resource.
The identifier of the compute snapshot resource is assigned during creation of a VNFC Snapshot being returned
from the VIM as output data in the response message of the individual resource operations.
This attribute shall only be present for a VNFC snapshot that has been newly created by the VNFM as a result
of the "Create VNF snapshot task".
$ref: "../../definitions/SOL005_def.yaml#/definitions/ResourceHandle"
storageSnapshotResources:
description: >
Reference to the "VirtualStorageResourceInfo" structure in the "VnfInstance" structure that represents
the virtual storage resource.
type: array
items:
type: object
required:
- storageResourceId
properties:
storageResourceId:
description: >
Reference to the virtual storage resource.
$ref: "#/definitions/IdentifierInVnf"
storageSnapshotResources:
description: >
Reference to a storage snapshot resource.
The identifier of the storage snapshot resource is assigned during creation of a VNFC snapshot being
returned from the VIM as output data in the response message of the individual resource operations.
This attribute shall only be present for a VNFC snapshot with an associated storage resource and that
has been newly created by the VNFM as a result of the "Create VNF snapshot task".
5170
5171
5172
5173
5174
5175
5176
5177
5178
5179
5180
5181
5182
5183
5184
5185
5186
5187
5188
5189
5190
5191
5192
5193
5194
5195
5196
5197
5198
5199
5200
5201
5202
5203
5204
$ref: "../../definitions/SOL005_def.yaml#/definitions/ResourceHandle"
userDefinedData:
description: >
User defined data for the VNF Snapshot.
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
VnfLinkPortData:
description: >
This type represents an externally provided link port to be used to connect a VNFC connection point to an
externally-managed VL. It shall comply with the provisions defined in table 6.5.3.78-1.
type: object
required:
- vnfLinkPortId
- resourceHandle
properties:
vnfLinkPortId:
description: >
Identifier of this link port as provided by the entity that has created the link port.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
resourceHandle:
description: >
Resource handle of the virtualised resource that realizes the link port.
$ref: "../../definitions/SOL005_def.yaml#/definitions/ResourceHandle"
ModificationsTriggeredByVnfPkgChange:
description: >
This type represents attribute modifications that were performed on an "Individual VNF instance" resource when
changing the current VNF package. The attributes that can be included consist of those requested to be modified
explicitly in the "ChangeCurrentVnfPkgRequest" data structure, and additional attributes of the "VnfInstance" data
structure that were modified implicitly during the operation.
The "ModificationsTriggeredByVnfPkgChange" data type shall comply with the provisions defined in table 6.5.3.79-1.
type: object
properties:
vnfConfigurableProperties:
description: >
This attribute signals the modifications of the "vnfConfigurableProperties" attribute in "VnfInstance"
performed by the operation and shall be present if that attribute was modified during the operation.
This attribute represents the delta (semantics as per IETF RFC 7396 [11], JSON Merge Patch) between
the value of the attribute at the start of the "Change current VNF package" operation and the value
of the attribute at its completion.
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
metadata:
description: >
This attribute signals the modifications of the "metadata" attribute in "VnfInstance" performed by the operation
and shall be present if that attribute was modified during the operation. This attribute represents the delta
(semantics as per IETF RFC 7396, JSON Merge Patch) between the value of the attribute at the start of the
"Change current VNF package" operation and the value of the attribute at its completion.
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
extensions:
description: >
This attribute signals the modifications of the "extensions" attribute in "VnfInstance" performed by the operation
and shall be present if that attribute was modified during the operation. This attribute represents the delta
(semantics as per IETF RFC 7396 [11], JSON Merge Patch) between the value of the attribute at the start of the
"Change current VNF package" operation and the value of the attribute at its completion.
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
vnfdId:
description: >
If present, this attribute signals the new value of the "vnfdId" attribute in "VnfInstance".
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
vnfProvider:
description: >
If present, this attribute signals the new value of the "vnfProvider" attribute in "VnfInstance".
If present, this attribute (which depends on the value of the "vnfdId" attribute) was modified implicitly
during the related operation, and contains a copy of the value of the related attribute from the VNFD in the
VNF Package identified by the "vnfdId" attribute.
type: string
vnfProductName:
description: >
If present, this attribute signals the new value of the "vnfProductName" attribute in "VnfInstance".
If present, this attribute (which depends on the value of the "vnfdId" attribute) was modified implicitly
during the related operation, and contains a copy of the value of the related attribute from the VNFD in the
VNF Package identified by the "vnfdId" attribute.
type: string
vnfSoftwareVersion:
description: >
If present, this attribute signals the new value of the "vnfSoftwareVersion" attribute in "VnfInstance".
If present, this attribute (which depends on the value of the "vnfdId" attribute) was modified implicitly
during the related operation, by copying the value of this attribute from the VNFD in the VNF Package
identified by the "vnfdId" attribute.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Version"
vnfdVersion:
description: >
If present, this attribute signals the new value of the "vnfdVersion" attribute in "VnfInstance".
If present, this attribute (which depends on the value of the "vnfdId" attribute) was modified implicitly
during the related operation, by copying the value of this attribute from the VNFD in the VNF Package
identified by the "vnfdId" attribute.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Version"
WanConnectionProtocolData:
description: >
This type provides protocol specific information used to connect the comprising network resources realizing a VL,
e.g., when the VL is deployed on several sites and across a WAN. This type supports signalling input information
about both pre-provisioned WAN connectivity realized by external entities to NFV-MANO, as well as for the creation
of MSCS under NFV-MANO responsibility (i.e., when connectivity is realized when NFVO communicates with the WIM).
It shall comply with the provisions defined in table 6.5.3.81-1.
anyOf:
- required:
- mscsInfo
- required:
- connectivityServiceEndpointConfigDatas
- required:
- mscsConfigData
5273
5274
5275
5276
5277
5278
5279
5280
5281
5282
5283
5284
5285
5286
5287
5288
5289
5290
5291
5292
5293
5294
5295
5296
5297
5298
5299
5300
5301
5302
5303
5304
5305
5306
5307
5308
5309
5310
5311
5312
5313
5314
5315
5316
5317
5318
5319
5320
properties:
mscsInfo:
description: >
Information about the pre-provisioned multi-site connectivity service (MSCS), if already available.
At least one of these attributes shall be present. Annex E documents the applicability of certain attributes
depending on the WAN and NFVI-PoP network management and the responsibilities of NFV-MANO in its provisioning.
$ref: "#/definitions/MscsInfo"
connectivityServiceEndpointConfigDatas:
description: >
Configuration data for the network resources in the NFVI-PoP.
At least one of these attributes shall be present. Annex E documents the applicability of certain attributes
depending on the WAN and NFVI-PoP network management and the responsibilities of NFV-MANO in its provisioning.
type: array
items:
$ref: "#/definitions/ConnectivityServiceEndpointInfo"
mscsConfigData:
description: >
Configuration data for the provisioning of the MSCS, if such MSCS is to be created by NFV-MANO.
At least one of these attributes shall be present. Annex E documents the applicability of certain attributes
depending on the WAN and NFVI-PoP network management and the responsibilities of NFV-MANO in its provisioning.
$ref: "#/definitions/MscsConfigData"
MscsInfo:
description: >
This type provides information about an already provisioned multi-site connectivity service (MSCS) deployed across
a WAN. It shall comply with the provisions defined in Table 6.5.3.82-1.
type: object
required:
- mscsId
- mscsType
properties:
mscsId:
description: >
Identifier of the MSCS established over the WAN.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
mscsName:
description: >
Human readable name of the MSCS.
type: string
mscsDescription:
description: >
Human readable description of the MSCS.
type: string
mscsType:
description: >
The type of connectivity that is provided to the virtualized networks in the NFVI-PoP and characterizes the
connectivity service across the WAN.
Permitted values:
type: string
enum:
- L2VPN
- L3VPN
mscsLayerProtocol:
description: >
Type of underlying connectivity service and protocol associated to the MSCS.
Permitted values are as listed below and restricted by the type of MSCS:
- EVPN_BGP_MPLS: as specified in IETF RFC 7432. Only applicable for mscsType="L2".
- EVPN_VPWS: as specified in IETF RFC 8214. Only applicable for mscsType="L2".
- VPLS_BGP: as specified in IETF RFC 4761 and IETF RFC 6624. Only applicable for mscsType="L2".
- VPLS_LDP_L2TP: as specified in IETF RFC 4762. Only applicable for mscsType="L2".
- VPWS_LDP_L2TP: as specified in IETF RFC 6074. Only applicable for mscsType="L2".
- BGP_IP_VPN: BGP/MPLS based IP VPN as specified in IETF RFC 4364. Only applicable for mscsType="L3".
type: string
enum:
- EVPN_BGP_MPLS
- EVPN_VPWS
5341
5342
5343
5344
5345
5346
5347
5348
5349
5350
5351
5352
5353
5354
5355
5356
5357
5358
5359
5360
5361
5362
5363
5364
5365
5366
5367
5368
5369
5370
5371
5372
5373
5374
5375
5376
5377
5378
5379
5380
5381
5382
5383
5384
5385
5386
5387
5388
5389
5390
5391
5392
5393
5394
5395
5396
5397
5398
5399
5400
5401
5402
5403
5404
5405
5406
5407
5408
5409
5410
5411
5412
5413
5414
5415
5416
5417
5418
5419
5420
5421
5422
5423
5424
5425
5426
5427
5428
5429
5430
5431
5432
5433
5434
5435
5436
5437
5438
5439
5440
5441
5442
5443
5444
5445
5446
5447
5448
5449
5450
5451
5452
5453
5454
5455
5456
5457
5458
5459
5460
5461
5462
5463
5464
5465
5466
5467
5468
5469
5470
5471
5472
5473
5474
5475
5476
5477
5478
5479
5480
5481
5482
5483
5484
5485
5486
5487
5488
5489
5490
5491
5492
5493
5494
5495
5496
5497
5498
5499
5500
5501
5502
5503
5504
5505
5506
5507
5508
5509
- VPLS_BGP
- VPLS_LDP
- VPWS
- BGP_IP_VPN
siteAccessProtectionSchemes:
description: >
Information to determine the proper MSCS endpoints configuration to fulfil certain resiliency/protection
requirements, e.g., by considering certain availability and redundancy of connectivity service endpoints
in between NFVI-PoP and WAN.
type: array
items:
type: object
properties:
locationConstraints:
description: >
Defines the location constraints according to an NFVI-PoP (site).
$ref: "#/definitions/LocationConstraints"
protectionScheme:
description: >
Defines the protection scheme.
Permitted values:
- UNPROTECTED: to indicate no protection.
- ONE_TO_ONE: to indicate an active-passive access protection.
- ONE_PLUS_ONE: to indicate an active-active access protection.
- ONE_TO_N: to indicate an N active to 1 passive access protection.
type: string
enum:
- UNPROTECTED
- ONE_TO_ONE
- ONE_PLUS_ONE
- ONE_TO_N
mtuMscs:
description: >
Maximum Transmission Unit (MTU) that can be forwarded over the MSCS (in bytes). Default value is "1500" (bytes).
type: number
mscsEndpoints:
description: >
Information about the MSCS endpoints of the MSCS.
type: array
items:
$ref: "#/definitions/MscsEndpointInfo"
MscsEndpointInfo:
description: >
This type provides encapsulates information about an MSCS endpoint of the MSCS. It shall comply with the provisions
defined in table 6.5.3.83-1.
type: object
required:
- mscsEndpointId
- directionality
- connectivityServiceEndpoinId
properties:
mscsEndpointId:
description: >
Identifier of the MSCS endpoint.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
directionality:
description: >
Directionality of the data traffic in the context of the terminating MSCS endpoint from WAN’s perspective.
Permitted values:
- INBOUND: to indicate into the WAN.
- OUTBOUND: to indicate from the WAN.
- BOTH: to indicate bidirectional data traffic to/from the WAN.
type: string
enum:
- INBOUND
- OUTBOUND
- BOTH
connectivityServiceEndpoinId:
description: >
References the connectivity service endpoint configuration information applicable to support the MSCS endpoint.
More than one connectivity service endpoint can be referred when endpoints are in LAG mode.
type: array
items:
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
ConnectivityServiceEndpointInfo:
description: >
This type provides configuration data for the NFVI-PoP network gateway providing connectivity service endpoints.
The connectivity service endpoints are used as endpoints by an MSCS. It shall comply with the provisions defined
in Table 6.5.3.84-1.
type: object
required:
- connectivityServiceEndpointId
- vimId
properties:
connectivityServiceEndpointId:
description: >
Identifier of the connectivity service endpoint of the NFVI-PoP (site) providing the UNI in between the
NFVI-PoP and the WAN.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
vimId:
description: >
Identifier of the VIM responsible for the management of the virtualized networks in the NFVI-PoP of the
applicable VL, and for which the connection data is applicable.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
siteToWanLayer2ProtocolData:
description: >
Layer 2 protocol specific information for the configuration of the NFVI-PoP network gateway to enable the
stitching of the intra-site VN to the MSCS over the WAN.
$ref: "#/definitions/SiteToWanLayer2ProtocolData"
siteToWanLayer3ProtocolData:
description: >
Layer 3 protocol specific information for the configuration of NFVI-PoP network gateway to enable the stitching
of the intra-site VN to the MSCS over the WAN.
$ref: "#/definitions/SiteToWanLayer3ProtocolData"
SiteToWanLayer2ProtocolData:
description: >
This type provides information about Layer 2 protocol specific information for the configuration of the NFVI-PoP
network gateway to enable the stitching of the intra-site VN to the MSCS over the WAN. It shall comply with the
provisions defined in Table 6.5.3.85-1.
type: object
required:
- layer2ConnectionInfo
properties:
layer2ConnectionInfo:
description: >
Layer 2 protocol parameters of the connectivity service endpoint (CSE).
type: object
required:
- connectionType
- interfaceType
- interfaceTagging
- encapsulationType
properties:
connectionType:
description: >
The type of connection to be established on the connectivity service point.
Permitted values:
- CSE: defined by the characteristics of the existing referred connectivity service point.
- AGGREGATE_CSE: create an aggregation of the connectivity service endpoints.
type: string
enum:
- CSE
- AGGREGATE_CSE
interfaceType:
description: >
To indicate whether to create logical interfaces on the referred connectivity service endpoint or new
aggregated connectivity service endpoint.
Permitted values:
- PARENT: use the mapped interface to the connectivity service endpoint as is, i.e., do not create logical interfaces.
- LOGICAL: create logical interfaces.
type: string
enum:
- PARENT
- LOGICAL
interfaceTagging:
description: >
The type of frames to forward on the connectivity service point.
Permitted values:
- UNTAGGED: an interface where frames are not tagged.
- TAGGED: an interface configured to forward tagged frames (i.e., enabled for VLAN tagging).
type: string
enum:
- UNTAGGED
- TAGGED
encapsulationType:
description: >
The type of encapsulation. If the interfaceTagging="TAGGED", either "VLAN" or "VXLAN" shall be set.
Permitted values:
- ETH: generic Ethernet encapsulation.
- VLAN: encapsulation based on VLAN.
- VXLAN: encapsulation based on VXLAN.
type: string
enum:
- ETH
- VLAN
- VXLAN
Type of encapsulation method for VLAN tagging. Shall be present if interfaceTagging="TAGGED" and
encapsulationType="VLAN".
- DOT1Q: used when packets on the CSE are encapsulated with one or a set of customer VLAN identifiers.
- QINQ: used when packets on the CSE are encapsulated with multiple customer VLAN identifiers and a single
service VLAN identifier.
- QINANY: used when packets on the CSE have no specific customer VLAN and a service VLAN identifier is used.
type: string
enum:
- DOT1Q
- QINQ
wanSegmentIds:
description: >
Segment identifiers to pass on the tagged interface. Shall be present if encapsulationType="VLAN" or “VXLAN".
type: object
required:
- wanSegmentIdValue
properties:
wanSegmentIdValue:
description: >
Identifier of the network segment (e.g., VLAN id or VNI).
type: string
wanSegmentIdUpperRange:
description: >
Identifier of the upper range network segment, in case the "wanSegmentIds" is used to define a range.
type: string
5539
5540
5541
5542
5543
5544
5545
5546
5547
5548
5549
5550
5551
5552
5553
5554
5555
5556
5557
5558
5559
5560
5561
5562
5563
vxlanConfig:
description: >
Additional configuration needed when using VXLAN encapsulation. Shall be present if interfaceTagging="TAGGED"
and encapsulationType="VXLAN".
type: object
required:
- peerMode
properties:
peerMode:
description: >
Type of VXLAN access mode. Default value is "STATIC".
Permitted values:
- STATIC
- BGP_EVPN
type: string
enum:
- STATIC
- BGP_EVPN
peers:
description: >
List of IP addresses of VTEP peers when using static mode.
type: array
items:
$ref: "#/definitions/IpAddress"
5564
5565
5566
5567
5568
5569
5570
5571
5572
5573
5574
5575
5576
5577
5578
5579
5580
5581
5582
5583
5584
5585
5586
5587
5588
5589
5590
5591
5592
lagInterfaceData:
description: >
Information for setting up a LAG interface aggregating multiple connectivity service endpoints.
type: object
required:
- aggregatedEndpoints
- lacpActivation
- lacpConfig
properties:
aggregatedEndpoints:
description: >
List of the connectivity service endpoints that are to be aggregated. Shall be present if
connectionType="AGGREGATE_CSE". In case of aggregating connectivity service endpoints, only one
SiteToWanLayer2ProtocolData shall be provided for the whole set of aggregated endpoints.
type: array
items:
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
lacpActivation:
description: >
Indicates whether to activate LACP on the interface. If "TRUE", the LACP is to be activated, or "FALSE"
otherwise. Default value is "FALSE".
type: boolean
lacpConfig:
description: >
Specific configuration for the LACP. Examples include configuration to indicate the minimum number of
active connectivity service endpoints, the time internal and priority of LACP packet data units (PDU).
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
layer2ControlProtocol:
description: >
Configuration enabling the L2 control protocol in between the NFVI-PoP network gateway and the WAN.
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
mtuL2:
description: >
Maximum Transmission Unit (MTU) that can be forwarded at layer 2 (in bytes). Default value is "1500" (bytes).
virtualRoutingAndForwarding:
description: >
Configuration related to the L2 virtual routing and forwarding (MAC-VRF).
type: object
required:
- macVrfName
properties:
macVrfName:
description: >
Name (or identifier) of the MAC-VRF instance.
type: string
forwardingConfig:
description: >
Information related to the forwarding of the VN in the NFVI-PoP to the connectivity service endpoint,
if information about the VN to "stitch" is already known. . by the OSS/BSS. Shall not be provided otherwise,
in which case the NFVO will infer the forwarding configuration based on the NS VL, or external VL, or
externally-managed VL provisioning.
oneOf:
- required:
- networkResources
- required:
- vnSegmentIds
5622
5623
5624
5625
5626
5627
5628
5629
5630
5631
5632
5633
5634
5635
5636
5637
5638
5639
5640
5641
5642
5643
5644
5645
5646
5647
5648
5649
5650
5651
5652
5653
5654
5655
5656
5657
5658
5659
5660
5661
5662
5663
5664
5665
5666
5667
5668
5669
5670
5671
5672
5673
5674
5675
5676
5677
5678
properties:
networkResources:
description: >
Reference to the VN resource to be forwarded into/from the MSCS.
Either "networkResources" or "vnSegmentsIds" shall be provided, but not both.
type: array
items:
$ref: "../../definitions/SOL005_def.yaml#/definitions/ResourceHandle"
vnSegmentIds:
description: >
Identifiers of the network segments of the VN resources to be forwarded into/from the MSCS.
type: object
required:
- vnSegmentIdValue
properties:
vnSegmentIdValue:
description: >
Identifier of the network segment.
type: string
vnSegmentIdUpperRange:
description: >
Identifier of the upper range network segment, in case the "vnSegmentIds" is used to define a range.
type: string
SiteToWanLayer3ProtocolData:
description: >
This type provides information about Layer 3 protocol specific information for the stitching of the intra-site VN
to the multi-site connectivity service over the WAN. It shall comply with the provisions defined in Table 6.5.3.86-1.
type: object
required:
- routingInfo
properties:
logicalInterfaceIpAddress:
description: >
IP addressing information associated to a logical interface. Shall be present if the "interfaceType" of the
SiteToWanLayer2ProtocolData is equal to "LOGICAL".
type: object
required:
- ipAddress
- associatedSegmentId
properties:
ipAddress:
description: >
The IP address to be assigned to the interface.
$ref: "#/definitions/IpAddress"
associatedSegmentId:
description: >
The associated segment identifier that has triggered the creation of the logical interface.
The value shall be one of the values listed in the "wanSegmentIds" of the "siteToWanLayer2ProtocolData".
type: string
routingInfo:
description: >
The routing information that is activated on the connectivity service endpoint. More than one "routingInfo" is
allowed to enable stacking different routing protocols (e.g., one routing protocol for IPv4 and another one for IPv6).
type: object
required:
- routingProtocol
5680
5681
5682
5683
5684
5685
5686
5687
5688
5689
5690
5691
5692
5693
5694
5695
5696
5697
5698
5699
5700
5701
5702
5703
5704
5705
5706
5707
5708
5709
5710
5711
5712
5713
5714
5715
5716
5717
5718
5719
5720
5721
5722
5723
5724
5725
5726
5727
5728
5729
5730
5731
5732
5733
5734
5735
5736
5737
5738
5739
5740
5741
5742
5743
5744
5745
5746
5747
5748
5749
properties:
routingProtocol:
description: >
The routing protocol that is activated on the connectivity service endpoint.
Permitted values:
- BGP: used for dynamic routing BGPv4.
- RIP: used for dynamic routing RIPv2.
- OSPF: used for dynamic routing (OSPF version 2 for IPv4; and OSPF version 3 for IPv6).
- STATIC: used for static routing.
- DIRECT: used when the NFVI-PoP network is directly connected to the WAN provider network.
- VRRP: used when the NFVI-PoP network is directly connected to the WAN provider network with virtual
router redundancy protocol support (VRRP).
type: string
enum:
- BGP
- RIP
- OSPF
- STATIC
- DIRECT
- VRRP
staticRouting:
description: >
Defines a static route. It shall only be present if the routingProtocol="STATIC".
type: object
required:
- ipVersion
- ipPrefix
- prefixSize
- nextHop
properties:
ipVersion:
description: >
The IP version applicable to the routing entry.
Permitted values:
- IPV4
- IPV6
type: string
enum:
- IPV4
- IPV6
ipPrefix:
description: >
The IP network prefix.
$ref: '#/definitions/IpAddress'
prefixSize:
description: >
The IP prefix size.
type: number
nextHop:
description: >
The next hop’s IP address.
$ref: '#/definitions/IpAddress'
routingAddressFamily:
description: >
The IP version applicable to the dynamic routing protocol. Shall be present for dynamic routing protocols.
Permitted values:
- IPV4
- IPV6
type: string
enum:
- IPV4
- IPv6
ospfRouting:
description: >
Defines parameters for OSPF routing. It shall only be present if the routingProtocol="OSPF".
type: object
required:
- areaId
properties:
areaId:
5751
5752
5753
5754
5755
5756
5757
5758
5759
5760
5761
5762
5763
5764
5765
5766
5767
5768
5769
5770
5771
5772
5773
5774
5775
The routing area identifier, e.g., a number or an IP address.
type: string
bgpRouting:
description: >
Defines parameters for BGP routing. It shall only be present if the routingProtocol="BGP".
type: object
required:
- bgpAs
properties:
bgpAs:
description: >
The Autonomous System (AS) identification applicable to the BGP routing info entry.
type: object
bgpNeighbour:
description: >
The IP address of the BGP neighbour.
$ref: '#/definitions/IpAddress'
bgpAdditionalParam:
description: >
Additional parameters for setting up the BGP neighbour, such as information about the remote AS.
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
routeMapsDistribution:
description: >
Maps of routes that are permitted or denied for redistribution.
type: object
5776
5777
5778
5779
5780
5781
5782
5783
5784
5785
5786
5787
5788
5789
5790
5791
5792
5793
5794
5795
5796
5797
5798
5799
5800
5801
required:
- policy
- sequence
- matchAndSetRule
properties:
policy:
description: >
The policy to apply to the route distribution.
Permitted values:
- PERMIT
- DENY
type: string
enum:
- PERMIT
- DENY
sequence:
description: >
Sequence or index number assigned to the route-map.
type: number
matchAndSetRule:
description: >
Set of "match" and "set" rules for the distribution of routing information. "Match" key entries define
the routes that are selected. "Set" key entries define what information to modify when distributing the
routing information.
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
5802
5803
5804
5805
5806
5807
5808
5809
5810
5811
5812
5813
5814
5815
5816
5817
5818
5819
5820
5821
5822
5823
5824
5825
5826
5827
5828
5829
5830
5831
5832
5833
5834
mtuL3:
description: >
Maximum Transmission Unit (MTU) that can be forwarded at layer 3 (in bytes). Default value is "1500" (bytes).
type: number
virtualRoutingAndForwarding:
description: >
Configuration related to the virtual routing and forwarding (VRF).
type: object
required:
- vrfName
properties:
vrfName:
description: >
Name (or identifier) of the VRF instance.
type: string
bfdConfig:
description: >
Configuration related to bidirectional forwarding detection (BFD).
$ref: "../../definitions/SOL005_def.yaml#/definitions/KeyValuePairs"
MscsConfigData:
description: >
This type provides configuration data for the creation of an MSCS. It shall comply with the provisions defined in
Table 6.5.3.87-1.
type: object
required:
- mscsType
properties:
mscsType:
description: >
The type of connectivity that is requested to be provided to the virtualized networks in the NFVI-PoP and
characterizes the connectivity service across the WAN.
Permitted values:
type: string
enum:
5841
5842
5843
5844
5845
5846
5847
5848
5849
5850
5851
5852
5853
5854
5855
5856
5857
5858
5859
5860
5861
5862
5863
5864
5865
5866
5867
5868
5869
5870
5871
5872
5873
5874
5875
5876
5877
5878
5879
5880
5881
5882
5883
5884
5885
5886
5887
5888
5889
5890
5891
5892
5893
5894
5895
5896
siteAccessProtectionSchemes:
description: >
Information to determine the proper MSCS endpoints configuration to fulfil certain resiliency/protection
requirements, e.g., by considering certain availability and redundancy of connectivity service endpoints in
between NFVI-PoP and WAN.
type: array
items:
type: object
required:
- locationConstraints
- protectionScheme
properties:
locationConstraints:
description: >
Defines the location constraints according to an NFVI-PoP (site).
$ref: '#/definitions/LocationConstraints'
protectionScheme:
description: >
Defines the protection scheme.
Permitted values:
- UNPROTECTED
- ONE_TO_ONE
- ONE_PLUS_ONE
- ONE_TO_N
type: string
enum:
- UNPROTECTED
- ONE_TO_ONE
- ONE_PLUS_ONE
- ONE_TO_N
mtuMscs:
description: >
Maximum Transmission Unit (MTU) that can be forwarded over the MSCS (in bytes). Default value is "1500" (bytes).
type: number
wanLayer2ProtocolData:
description: >
Layer 2 protocol specific information for the configuration of the multi-site connectivity service over the WAN.
$ref: '#/definitions/WanLayer2ProtocolData'
wanLayer3ProtocolData:
description: >
Layer 3 protocol specific information for the configuration of the multi-site connectivity service over the WAN.
$ref: '#/definitions/WanLayer3ProtocolData'
WanLayer2ProtocolData:
description: >
This type provides information about Layer 2 protocol specific information for the configuration of the MSCS over
the WAN. It shall comply with the provisions defined in Table 6.5.3.88-1.
type: object
required:
- isSegmentPreservation
- isSegmentCosPreservation
properties:
mscsLayer2Protocol:
description: >
Type of underlying connectivity service and protocol associated to the type of MSCS.
Permitted values are as listed below and restricted by the type of MSCS:
- EVPN_BGP_MPLS: as specified in IETF RFC 7432.
- EVPN_VPWS: as specified in IETF RFC 8214.
- VPLS_BGP: as specified in IETF RFC 4761 and IETF RFC 6624.
- VPLS_LDP_L2TP: as specified in IETF RFC 4762 and IETF RFC 6074.
- VPWS_LDP_L2TP: as specified in IETF RFC 6074.
type: string
enum:
- EVPN_BGP_MPLS
- EVPN_VPWS
- VPLS_LDP_L2TP
- VPWS_LDP_L2TP
5909
5910
5911
5912
5913
5914
5915
5916
5917
5918
5919
5920
5921
5922
5923
5924
5925
5926
5927
5928
5929
5930
5931
5932
5933
5934
5935
5936
5937
5938
5939
5940
5941
5942
5943
5944
5945
5946
5947
5948
5949
5950
5951
5952
5953
5954
5955
5956
5957
5958
5959
5960
5961
5962
5963
5964
5965
5966
5967
5968
5969
5970
5971
5972
5973
5974
5975
5976
5977
5978
5979
5980
5981
5982
5983
5984
5985
5986
5987
5988
5989
5990
5991
5992
5993
5994
5995
5996
5997
5998
5999
6000
6001
6002
6003
6004
6005
6006
6007
6008
6009
6010
6011
6012
6013
6014
6015
6016
6017
6018
6019
6020
6021
6022
6023
6024
6025
6026
6027
6028
6029
6030
6031
6032
6033
6034
6035
6036
6037
6038
6039
6040
6041
6042
6043
6044
6045
6046
6047
6048
6049
6050
6051
6052
6053
6054
6055
6056
6057
6058
6059
6060
6061
6062
6063
6064
isSegmentPreservation:
description: >
Indicates the requirement of whether to ensure network segment (e.g., VLAN id) preservation across the MSCS
endpoints (i.e., from/to the NFVI-PoPs). If "TRUE", segment identifiers shall be preserved, "FALSE" otherwise.
Default value is "FALSE".
type: boolean
isSegmentCosPreservation:
description: >
Indicates the requirement of whether to ensure network segment class of service preservation across the MSCS
endpoints (i.e., from/to the NFVI-PoPs). If "TRUE", segment class of service shall be preserved, "FALSE" otherwise.
Default value is "FALSE".
type: boolean
WanLayer3ProtocolData:
description: >
Type of underlying connectivity service and protocol associated to the type of MSCS.
Permitted values are as listed below and restricted by the type of MSCS:
- BGP_IP_VPN: BGP/MPLS based IP VPN as specified in IETF RFC 4364.
type: string
enum:
- BGP_IP_VPN
ModifyWanConnectionInfoData:
description: >
This type represents attribute modifications for WAN connection information. The attributes of the "WanConnectionInfo"
that can be modified according to the provisions of the "UpdateNsRequest" in clause 6.5.2.12 related to WAN connection
information are included in the "ModifyWanConnectionInfoData" data type. It shall comply with the provisions defined
in table 6.5.3.92-1.
type: object
required:
- wanConnectionInfoId
properties:
wanConnectionInfoId:
description: >
Identifier of the WAN connection information to modify.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
mscsName:
description: >
New value of the "mscsName" attribute in "MscsInfo", or "null" to remove the attribute.
type: string
mscsDescription:
description: >
New value of the "mscsDescription" attribute in "MscsInfo", or "null" to remove the attribute.
type: string
mscsEndpoints:
description: >
New content of certain entries of MSCS endpoints in the "mscsEndpoints" attribute in "MscsInfo",
as defined below this table.
type: array
items:
$ref: "#/definitions/MscsEndpointInfo"
removeMscsEndpointIds:
description: >
List of identifier entries to be deleted from the "mscsEndpoints" attribute array in "MscsInfo", to be used
as "deleteIdList" as defined below this table.
type: array
items:
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
connectivityServiceEndpoints:
description: >
New content of certain entries of connectivity service endpoints in the "connectivityServiceEndpointInfos"
attribute in "WanConnectionProtocolInfo", as defined below this table.
type: array
items:
$ref: "#/definitions/ConnectivityServiceEndpointInfo"
removeConnectivityServiceEndpoints:
description: >
List of identifier entries to be deleted from the "connectivityServiceEndpointInfos" attribute array in
"WanConnectionProtocolInfo", to be used as "deleteIdList" as defined below this table.
type: array
items:
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
WanConnectionInfoModification :
description: >
This type represents attribute modifications that were performed on WAN connection information.
The attributes that can be included consist of those requested to be modified explicitly with the "UpdateNsRequest"
data structure. It shall comply with the provisions defined in table 6.5.3.93-1.
type: object
required:
- wanConnectionInfoId
properties:
wanConnectionInfoId:
description: >
Identifier of the WAN connection information that has been modified.
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
mscsName:
description: >
If present, this attribute signals modifications of the "mscsName" attribute in "MscsInfo" as defined in
clause 6.5.3.82.
type: string
mscsDescription:
description: >
If present, this attribute signals modifications of the "mscsDescription" attribute in "MscsInfo" as defined
in clause 6.5.3.82.
type: string
mscsEndpoints:
description: >
If present, this attribute signals modifications of certain entries in the "mscsEndpoints" attribute array in
"MscsInfo", as defined in clause 6.5.3.82.
type: array
items:
$ref: "#/definitions/MscsEndpointInfo"
removeMscsEndpointIds:
description: >
If present, this attribute signals the deletion of certain entries in the "mscsEndpoints" attribute array in
"MscsInfo", as defined in clause 6.5.3.82.
type: array
items:
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
connectivityServiceEndpoints:
description: >
If present, this attribute signals modifications of certain entries in the "connectivityServiceEndpoints"
attribute array in "WanConnectionProtocolInfo", as defined in clause 6.5.3.91.
type: array
items:
$ref: "#/definitions/ConnectivityServiceEndpointInfo"
removeConnectivityServiceEndpoints:
description: >
If present, this attribute signals the deletion of certain entries in the "connectivityServiceEndpoints"
attribute array in "WanConnectionProtocolInfo", as defined in clause 6.5.3.91.
type: array
items:
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
AddNsVirtualLinkData:
description: >
This type specifies the parameters used for the creation of a new NsVirtualLink instance.
It shall comply with the provisions defined in table 6.5.3.95-1.
type: object
required:
- nsVirtualLinkProfileId
properties:
nsVirtualLinkProfileId:
description: >
Identifier of the virtual link profile to be used to create a new NsVirtualLink instance.
All NsVirtualLink instances of a particular NS DF based on a specific "NsVirtualLinkDesc"
have the same characteristics as they use the same "VirtualLinkProfile".
$ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
NestedNsLocationConstraint:
description: >
This type represents the association of location constraints to a nested NS instance to be created according to a
specific NS profile. It shall comply with the provisions defined in Table 6.5.3.96-1.
type: object
required:
- nsProfileId
- locationConstraints
properties:
nsProfileId:
description: >
Identifier of an NsProfile defined in the NSD which the existing nested NS instance shall be matched with.
$ref: "../../definitions/SOL005_def.yaml#/definitions/IdentifierInNs"
locationConstraints:
description: >
Defines the location constraints for the nested NS instance to be created based on the NS profile.
$ref: "#/definitions/LocationConstraints"
LcmOpOccNotificationVerbosityType:
description: >
The enumeration LcmOpOccNotificationVerbosityType provides values to control the verbosity of LCM operation
occurrence notifications. It shall comply with the provisions defined in table 6.5.4.11-1.
* FULL: This signals a full notification which contains all change details.
* SHORT: This signals a short notification which omits large-volume change details to reduce the size of data to
be sent via the notification mechanism.
type: string
enum:
- FULL
- SHORT