f24afcf705
This patch provides Tacker documents for multi-version API support. VNF LCM API Version 2 is added to API Reference and the page hierarchy is changed for readability. Also, the Show VNF LCM Versions command is added to Command-Line Interface Reference. Furthermore, a manual of the Userdata script is added to Tacker User Guide. Implements: blueprint multi-version-api Implements: blueprint support-nfv-solv3-start-and-terminate-vnf Implements: blueprint support-nfv-solv3-query-vnf-instances Implements: blueprint support-nfv-solv3-query-operation-occurrences Implements: blueprint support-nfv-solv3-subscriptions Change-Id: I603e32090303af080b17e549a0caf7e862aa7e1e
1515 lines
42 KiB
YAML
1515 lines
42 KiB
YAML
# variables in header
|
|
|
|
subscription_id:
|
|
description: |
|
|
Identifier of the subscription.
|
|
in: path
|
|
required: true
|
|
type: string
|
|
vnf_instance_id:
|
|
description: |
|
|
Identifier of the VNF instance.
|
|
in: path
|
|
required: true
|
|
type: string
|
|
vnf_lcm_op_occ_id:
|
|
description: |
|
|
Identifier of the VNF lifecycle management operation occurrence.
|
|
in: path
|
|
required: true
|
|
type: string
|
|
|
|
# variables in body
|
|
added_storage_resource_ids:
|
|
description: |
|
|
References to VirtualStorage resources that
|
|
have been added.
|
|
Each value refers to a
|
|
VirtualStorageResourceInfo item in the
|
|
VnfInstance that was added to the VNFC.
|
|
It shall be provided if at least one storage
|
|
resource was added to the VNFC.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
affected_virtual_links:
|
|
description: |
|
|
Information about VL instances that were affected during
|
|
the lifecycle operation.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
affected_virtual_links_change_type:
|
|
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.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
affected_virtual_links_id:
|
|
description: |
|
|
Identifier of the virtual link instance, identifying
|
|
the applicable "vnfVirtualLinkResourceInfo"
|
|
entry in the "VnfInstance" data type.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
affected_virtual_storages:
|
|
description: |
|
|
Information about virtualised storage instances that were
|
|
affected during the lifecycle operation.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
affected_virtual_storages_change_type:
|
|
description: |
|
|
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.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
affected_virtual_storages_id:
|
|
description: |
|
|
Identifier of the storage instance, identifying the
|
|
applicable "virtualStorageResourceInfo" entry
|
|
in the "VnfInstance" data type.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
affected_virtual_storages_virtual_storage_desc_id:
|
|
description: |
|
|
Identifier of the related VirtualStorage
|
|
descriptor in the VNFD.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
affected_vnfc_cp_ids:
|
|
description: |
|
|
Identifiers of CP(s) of the VNFC instance that
|
|
were affected by the change.
|
|
Shall be present for those affected CPs of the
|
|
VNFC instance that are associated to an
|
|
external CP of the VNF instance.
|
|
May be present for further affected CPs of the
|
|
VNFC instance.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
affected_vnfcs:
|
|
description: |
|
|
Information about VNFC instances that were affected
|
|
during the lifecycle operation.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
affected_vnfcs_change_type:
|
|
description: |
|
|
Signals the type of change
|
|
Permitted values:
|
|
|
|
ADDED
|
|
|
|
REMOVED
|
|
|
|
MODIFIED
|
|
|
|
TEMPORARY
|
|
|
|
For a temporary resource, an AffectedVnfc
|
|
structure exists as long as the temporary
|
|
resource exists.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
affected_vnfcs_id:
|
|
description: |
|
|
Identifier of the Vnfc instance, identifying the
|
|
applicable "vnfcResourceInfo" entry in the
|
|
"VnfInstance" data type.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
affected_vnfcs_vdu_id:
|
|
description: |
|
|
Identifier of the related VDU in the VNFD.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
aspect_id:
|
|
description: |
|
|
Identifier of the scaling aspect.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
authentication:
|
|
description: |
|
|
Authentication parameters to configure the use of
|
|
Authorization when sending notifications
|
|
corresponding to this subscription.
|
|
This attribute shall only be present if the subscriber
|
|
requires authorization of notifications.
|
|
in: body
|
|
required: false
|
|
type: object
|
|
authentication_auth_type:
|
|
description: |
|
|
Defines the types of Authentication/Authorization which
|
|
the API consumer is willing to accept when receiving a
|
|
notification.
|
|
Permitted values:
|
|
|
|
BASIC: In every HTTP request to the
|
|
notification endpoint, use HTTP Basic
|
|
authentication with the client credentials.
|
|
|
|
OAUTH2_CLIENT_CREDENTIALS: In every
|
|
HTTP request to the notification endpoint, use
|
|
an OAuth 2.0 bearer token, obtained using the
|
|
client credentials grant type.
|
|
|
|
TLS_CERT: Every HTTP request to the
|
|
notification endpoint is sent over a mutually
|
|
authenticated TLS session, i.e. not only the
|
|
server is authenticated, but also the client is
|
|
authenticated during the TLS tunnel setup.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
authentication_params_basic:
|
|
description: |
|
|
Parameters for authentication/authorization using BASIC.
|
|
Shall be present if authType is "BASIC" and the
|
|
contained information has not been provisioned out of
|
|
band. Shall be absent otherwise.
|
|
in: body
|
|
required: false
|
|
type: object
|
|
authentication_params_basic_password:
|
|
description: |
|
|
Password to be used in HTTP Basic authentication.
|
|
Shall be present if it has not been provisioned out of band.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
authentication_params_basic_user_name:
|
|
description: |
|
|
Username to be used in HTTP Basic authentication.
|
|
Shall be present if it has not been provisioned out of band.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
authentication_params_oauth2_client_credentials:
|
|
description: |
|
|
Parameters for authentication/authorization using
|
|
OAUTH2_CLIENT_CREDENTIALS.
|
|
Shall be present if authType is
|
|
"OAUTH2_CLIENT_CREDENTIALS" and the contained
|
|
information has not been provisioned out of band.
|
|
Shall be absent otherwise.
|
|
in: body
|
|
required: false
|
|
type: object
|
|
authentication_params_oauth2_client_credentials_client_id:
|
|
description: |
|
|
Client identifier to be used in the access token request
|
|
of the OAuth 2.0 client credentials grant type. Shall be
|
|
present if it has not been provisioned out of band.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
authentication_params_oauth2_client_credentials_client_password:
|
|
description: |
|
|
Client password to be used in the access token request
|
|
of the OAuth 2.0 client credentials grant type. Shall be
|
|
present if it has not been provisioned out of band.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
authentication_params_oauth2_client_credentials_token_endpoint:
|
|
description: |
|
|
The token endpoint from which the access token can be
|
|
obtained. Shall be present if it has not been provisioned
|
|
out of band.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
callback_uri:
|
|
description: |
|
|
The URI of the endpoint to send the notification to.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
cause:
|
|
description: |
|
|
Indicates the reason why a healing procedure is required.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
changed_ext_connectivity:
|
|
description: |
|
|
Information about changed external connectivity,
|
|
if applicable
|
|
in: body
|
|
required: false
|
|
type: object
|
|
changed_ext_connectivity_id:
|
|
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.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
changed_info:
|
|
description: |
|
|
Information about the changed VNF instance information,
|
|
including VNF configurable properties, if applicable.
|
|
in: body
|
|
required: false
|
|
type: object
|
|
changed_info_metadata:
|
|
description: |
|
|
If present, this attribute signals modifications of the
|
|
"metadata" attribute in "VnfInstance".
|
|
in: body
|
|
required: false
|
|
type: string
|
|
changed_info_vim_connection_info:
|
|
description: |
|
|
If present, this attribute signals modifications of certain
|
|
entries in the "vimConnectionInfo" attribute array in "VnfInstance".
|
|
in: body
|
|
required: false
|
|
type: array
|
|
changed_info_vnf_instance_description:
|
|
description: |
|
|
If present, this attribute signals modifications of the
|
|
"vnfInstanceDescription" attribute in "VnfInstance".
|
|
in: body
|
|
required: false
|
|
type: string
|
|
changed_info_vnf_instance_name:
|
|
description: |
|
|
If present, this attribute signals modifications of the
|
|
"vnfInstanceName" attribute in "VnfInstance".
|
|
in: body
|
|
required: false
|
|
type: string
|
|
changed_info_vnf_pkg_id:
|
|
description: |
|
|
If present, this attribute signals modifications of the
|
|
"vnfPkgId" attribute in "VnfInstance".
|
|
in: body
|
|
required: false
|
|
type: string
|
|
changed_info_vnf_product_name:
|
|
description: |
|
|
If present, this attribute signals modifications of the
|
|
"vnfProductName" attribute in "VnfInstance".
|
|
in: body
|
|
required: false
|
|
type: string
|
|
changed_info_vnf_provider:
|
|
description: |
|
|
If present, this attribute signals modifications of the
|
|
"vnfProvider" attribute in "VnfInstance".
|
|
in: body
|
|
required: false
|
|
type: string
|
|
changed_info_vnf_sotware_version:
|
|
description: |
|
|
If present, this attribute signals modifications of the
|
|
"vnfSoftwareVersion" attribute in "VnfInstance".
|
|
in: body
|
|
required: false
|
|
type: string
|
|
changed_info_vnfd_id:
|
|
description: |
|
|
If present, this attribute signals modifications of the
|
|
"vnfdId" attribute in "VnfInstance".
|
|
in: body
|
|
required: false
|
|
type: string
|
|
changed_info_vnfd_version:
|
|
description: |
|
|
If present, this attribute signals modifications of the
|
|
"vnfdVersion" attribute in "VnfInstance".
|
|
in: body
|
|
required: false
|
|
type: string
|
|
cp_config:
|
|
description: |
|
|
List of instance data that need to be configured on the CP instances
|
|
created from the respective CPD.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
cp_instance_id:
|
|
description: |
|
|
Identifier of the external Connection Point instance to which this set of
|
|
configuration parameters is requested to be applied.
|
|
|
|
Shall be present if this instance has already been created.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
cp_protocol_data:
|
|
description: |
|
|
Parameters for configuring the network protocols on the link port that
|
|
connects the CP to a VL.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
cpd_id:
|
|
description: |
|
|
The identifier of the CPD in the VNFD.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
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.
|
|
in: body
|
|
required: false
|
|
type: object
|
|
error_detail:
|
|
description: |
|
|
A human-readable explanation specific to this occurrence
|
|
of the problem.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
error_status:
|
|
description: |
|
|
The HTTP status code for this occurrence of the problem.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
error_title:
|
|
description: |
|
|
A URI reference according to IETF RFC 3986 that
|
|
identifies the problem type. It is encouraged that the URI
|
|
provides human-readable documentation for the problem
|
|
(e.g. using HTML) when dereferenced. When this
|
|
member is not present, its value is assumed to be
|
|
"about:blank".
|
|
in: body
|
|
required: false
|
|
type: string
|
|
ext_cp_info:
|
|
description: |
|
|
Information about the external CPs exposed by the VNF instance.
|
|
in: body
|
|
required: true
|
|
type: array
|
|
ext_cp_info_associated_vnfc_cp_id:
|
|
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.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
ext_cp_info_cp_protocol_info:
|
|
description: |
|
|
Network protocol information for this CP.
|
|
in: body
|
|
required: true
|
|
type: array
|
|
ext_cp_info_cpd_id:
|
|
description: |
|
|
Identifier of the external CPD, VnfExtCpd, in the VNFD.
|
|
An identifier that is unique for the respective type within a VNF
|
|
instance, but that need not be globally unique. Representation: string of
|
|
variable length.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
ext_cp_info_ext_link_port_id:
|
|
description: |
|
|
Identifier of the "extLinkPortInfo" structure inside the "extVirtualLinkInfo"
|
|
structure. Shall be present if the CP is associated to a link port.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
ext_cp_info_id:
|
|
description: |
|
|
Identifier of the external CP instance and the related information instance.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
ext_cp_info_metadata:
|
|
description: |
|
|
Metadata about this external CP.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
ext_cps:
|
|
description: |
|
|
External CPs of the VNF to be connected to this external VL.
|
|
in: body
|
|
required: true
|
|
type: array
|
|
ext_link_port_id:
|
|
description: |
|
|
Identifier of this link port as provided by the entity that has created the
|
|
link port.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
ext_link_port_resource_handle:
|
|
description: |
|
|
Reference to the virtualised resource realizing this link port.
|
|
in: body
|
|
required: true
|
|
type: object
|
|
ext_link_ports:
|
|
description: |
|
|
Externally provided link ports to be used to connect external connection
|
|
points to this external VL. If this attribute is not present, the VNFM
|
|
shall create the link ports on the external VL.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
ext_managed_virtual_link_data_id:
|
|
description: |
|
|
The identifier of the externally-managed internal VL instance. The
|
|
identifier is assigned by the NFV-MANO entity that manages this
|
|
VL instance.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
ext_managed_virtual_link_data_resource_id:
|
|
description: |
|
|
The identifier of the resource in the scope of the VIM or the
|
|
resource provider.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
ext_managed_virtual_link_info:
|
|
description: |
|
|
Information about the externally-managed internal VLs of the VNF instance.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
ext_managed_virtual_link_info_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.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
ext_managed_virtual_link_info_network_resource:
|
|
description: |
|
|
Reference to the VirtualNetwork resource.
|
|
in: body
|
|
required: true
|
|
type: object
|
|
ext_managed_virtual_link_info_vnf_virtual_link_desc_id:
|
|
description: |
|
|
Identifier of the VNF Virtual Link Descriptor (VLD) in the VNFD.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
ext_managed_virtual_links:
|
|
description: |
|
|
List of information about internal VLs that are managed by the NFVO.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
ext_virtual_link_info:
|
|
description: |
|
|
Information about the external VLs the VNF instance is connected to.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
ext_virtual_link_info_ext_link_ports:
|
|
description: |
|
|
Link ports of this VL.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
ext_virtual_link_info_ext_link_ports_cp_instance_id:
|
|
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.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
ext_virtual_link_info_ext_link_ports_id:
|
|
description: |
|
|
Identifier of this link port as provided by the entity that
|
|
has created the link port.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
ext_virtual_link_info_id:
|
|
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.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
ext_virtual_links:
|
|
description: |
|
|
Information about external VLs to connect the VNF to.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
ext_virtual_links_id:
|
|
description: |
|
|
The identifier of the external VL instance. The identifier is assigned
|
|
by the NFV-MANO entity that manages this VL instance.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
ext_virtual_links_resource_id:
|
|
description: |
|
|
The identifier of the resource in the scope of the VIM or the
|
|
resource provider.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
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.
|
|
in: body
|
|
required: false
|
|
type: object
|
|
filter_notification_types:
|
|
description: |
|
|
Match particular notification types.
|
|
Permitted values:
|
|
|
|
VnfLcmOperationOccurrenceNotification
|
|
|
|
VnfIdentifierCreationNotification
|
|
|
|
VnfIdentifierDeletionNotification
|
|
in: body
|
|
required: false
|
|
type: string
|
|
filter_operation_states:
|
|
description: |
|
|
Match particular LCM operation state
|
|
values as reported in notifications of type
|
|
VnfLcmOperationOccurrenceNotification.
|
|
May be present if the "notificationTypes"
|
|
attribute contains the value
|
|
"VnfLcmOperationOccurrenceNotification" and
|
|
shall be absent otherwise.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
filter_operation_types:
|
|
description: |
|
|
Match particular VNF lifecycle operation types for
|
|
the notification of type
|
|
VnfLcmOperationOccurrenceNotification.
|
|
May be present if the "notificationTypes" attribute
|
|
contains the value
|
|
"VnfLcmOperationOccurrenceNotification", and
|
|
shall be absent otherwise.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
filter_vnf_instance_subscription_filter:
|
|
description: |
|
|
This type represents subscription filter
|
|
criteria to match VNF instances.
|
|
in: body
|
|
required: false
|
|
type: object
|
|
fixed_addresses:
|
|
description: |
|
|
Fixed addresses to assign (from the subnet defined by "subnetId"
|
|
if provided).
|
|
Exactly one of "fixedAddresses" or "numDynamicAddresses" shall be present.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
flavour_id:
|
|
description: |
|
|
Identifier of the VNF deployment flavour to be instantiated.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
flavour_id_response:
|
|
description: |
|
|
Identifier of the VNF deployment flavour applied to this VNF instance.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
graceful_termination_timeout:
|
|
description: |
|
|
This attribute is only applicable in case of graceful termination.
|
|
It defines the time to wait for the VNF to be taken out of service
|
|
before shutting down the VNF and releasing the resources.
|
|
|
|
The unit is seconds.
|
|
|
|
If not given and the "terminationType" attribute is set to "GRACEFUL",
|
|
it is expected that the VNFM waits for the successful taking out of
|
|
service of the VNF, no matter how long it takes, before shutting down
|
|
the VNF and releasing the resources.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
grant_id:
|
|
description: |
|
|
Identifier of the grant related to this VNF LCM operation
|
|
occurrence. Shall be set to the value of the "id" attribute in
|
|
the "Grant" representing the associated "Individual Grant",
|
|
if such grant exists.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
instantiated_vnf_info:
|
|
description: |
|
|
Information specific to an instantiated VNF instance. This attribute shall
|
|
be present if the instantiateState attribute value is INSTANTIATED.
|
|
in: body
|
|
required: false
|
|
type: object
|
|
instantiation_level_id:
|
|
description: |
|
|
Identifier of the instantiation level of the deployment flavour to be
|
|
instantiated. If not present, the default instantiation level as declared
|
|
in the VNFD is instantiated.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
ip_address_type:
|
|
description: |
|
|
The type of the IP addresses. Permitted values: IPV4, IPV6.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
ip_addresses:
|
|
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.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
ip_addresses_cp_info:
|
|
description: |
|
|
Addresses assigned to the CP instance. Each entry represents IP
|
|
addresses assigned by fixed or dynamic IP address assignment per
|
|
subnet.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
ip_over_ethernet:
|
|
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.
|
|
in: body
|
|
required: false
|
|
type: object
|
|
ip_over_ethernet_cp_info:
|
|
description: |
|
|
IP addresses over Ethernet to assign to the extCP instance. Shall be
|
|
present if layerProtocol is equal to "IP_OVER_ETHERNET", and shall
|
|
be absent otherwise.
|
|
in: body
|
|
required: false
|
|
type: object
|
|
is_automatic_invocation:
|
|
description: |
|
|
Set to true if this VNF LCM operation occurrence has
|
|
been triggered by an automated procedure inside the
|
|
VNFM (i.e. ScaleVnf triggered by autoscale,
|
|
or HealVnf triggered by auto-heal).
|
|
Set to false otherwise.
|
|
in: body
|
|
required: true
|
|
type: boolean
|
|
is_cancel_pending:
|
|
description: |
|
|
If the VNF LCM operation occurrence is in "STARTING",
|
|
"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.
|
|
in: body
|
|
required: true
|
|
type: boolean
|
|
is_dynamic:
|
|
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.
|
|
in: body
|
|
required: false
|
|
type: boolean
|
|
layer_protocol:
|
|
description: |
|
|
Identifier of layer(s) and protocol(s).
|
|
|
|
Permitted values: IP_OVER_ETHERNET
|
|
in: body
|
|
required: true
|
|
type: string
|
|
layer_protocol_cp_info:
|
|
description: |
|
|
The identifier of layer(s) and protocol(s) associated to the network
|
|
address information.
|
|
|
|
Permitted values: IP_OVER_ETHERNET
|
|
in: body
|
|
required: true
|
|
type: string
|
|
link_port_id:
|
|
description: |
|
|
Identifier of a pre-configured link port to which the external CP will
|
|
be associated. See note.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
mac_address:
|
|
description: |
|
|
MAC address. If this attribute is not present, it shall be chosen by the
|
|
VIM. At least one of "macAddress" or "ipAddresses" shall be present.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
mac_address_cp_info:
|
|
description: |
|
|
MAC address, if assigned.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
num_dynamic_addresses:
|
|
description: |
|
|
Number of set the dynamic address.
|
|
Exactly one of "fixedAddresses" or "numDynamicAddresses" shall be present.
|
|
in: body
|
|
required: false
|
|
type: int
|
|
number_of_steps:
|
|
description: |
|
|
Number of scaling steps to be executed as part of this
|
|
Scale VNF operation. It shall be a positive number and the
|
|
default value shall be 1.
|
|
in: body
|
|
required: false
|
|
type: int
|
|
operation:
|
|
description: |
|
|
Type of the actual LCM operation represented by this
|
|
VNF LCM operation occurrence.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
operation_params:
|
|
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 operationType and the
|
|
data type of this attribute shall apply:
|
|
|
|
INSTANTIATE: InstantiateVnfRequest
|
|
|
|
SCALE: ScaleVnfRequest
|
|
|
|
HEAL: HealVnfRequest
|
|
|
|
TERMINATE: TerminateVnfRequest
|
|
|
|
MODIFY_INFO: VnfInfoModificationRequest
|
|
|
|
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.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
operation_state:
|
|
description: |
|
|
The state of the LCM operation.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
removed_storage_resource_ids:
|
|
description: |
|
|
References to VirtualStorage resources that
|
|
have been removed.
|
|
The value contains the identifier of a
|
|
VirtualStorageResourceInfo item that has been
|
|
removed from the VNFC, and might no longer
|
|
exist in the VnfInstance.
|
|
It shall be provided if at least one storage
|
|
resource was removed from the VNFC.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
resource_changes:
|
|
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.
|
|
in: body
|
|
required: false
|
|
type: object
|
|
resource_handle:
|
|
description: |
|
|
Reference to the resource realizing this VL.
|
|
in: body
|
|
required: true
|
|
type: object
|
|
resource_handle_resource_id:
|
|
description: |
|
|
Identifier of the resource in the scope of the VIM or the resource
|
|
provider.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
resource_handle_vim_level_resource_type:
|
|
description: |
|
|
Type of the resource in the scope of the VIM or the resource provider.
|
|
provider.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
scale_additional_params:
|
|
description: |
|
|
Additional parameters passed by the NFVO as input to the
|
|
scaling process, specific to the VNF being scaled, as
|
|
declared in the VNFD as part of "ScaleVnfOpConfig".
|
|
in: body
|
|
required: false
|
|
type: string
|
|
scale_status:
|
|
description: |
|
|
Scale status of the VNF, one entry per aspect.
|
|
Represents for every scaling aspect how "big"
|
|
the VNF has been scaled with reference to that aspect.
|
|
This attribute shall be present if the VNF
|
|
supports scaling.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
scale_status_aspect_id:
|
|
description: |
|
|
Identifier of the scaling aspect.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
scale_status_scale_level:
|
|
description: |
|
|
Indicates the scale level. The minimum value shall be 0
|
|
and the maximum value shall be less than or equal to maxScaleLevel as
|
|
described in the VNFD.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
scale_type:
|
|
description: |
|
|
Indicates the type of the scale operation requested.
|
|
Permitted values:
|
|
|
|
SCALE_OUT: adding additional VNFC instances to the VNF to increase capacity.
|
|
|
|
SCALE_IN: removing VNFC instances from the VNF in order to release unused capacity.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
start_time:
|
|
description: |
|
|
Date-time of the start of the operation.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
state_entered_time:
|
|
description: |
|
|
Date-time when the current state has been entered.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
subnet_id:
|
|
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.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
subscription_id_response:
|
|
description: |
|
|
Identifier of this subscription resource.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
termination_type:
|
|
description: |
|
|
Indicates whether forceful or graceful termination is requested.
|
|
Permitted values:
|
|
|
|
FORCEFUL: The VNFM will shut down the VNF and release the resources
|
|
immediately after accepting the request.
|
|
|
|
GRACEFUL: The VNFM will first arrange to take the VNF out of service
|
|
after accepting the request. Once the operation of taking the VNF out of
|
|
service finishes (irrespective of whether it has succeeded or failed) or
|
|
once the timer value specified in the "gracefulTerminationTimeout"
|
|
attribute expires, the VNFM will shut down the VNF and release the
|
|
resources.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vim_connection_id:
|
|
description: |
|
|
Identifier of the VIM connection to manage the resource.
|
|
This attribute shall only be supported and present if VNF related
|
|
resource management in direct mode is applicable.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
vim_connection_info_access_info:
|
|
description: |
|
|
Authentication credentials for accessing the VIM, and other access-related
|
|
information such as tenants or infrastructure resource groups (see note).
|
|
The applicable keys are dependent on the content of vimType.
|
|
|
|
If the VimConnectionInfo structure is part of an HTTP response payload
|
|
body, sensitive attributes that are children of this attributes
|
|
(such as passwords) shall not be included.
|
|
|
|
If the VimConnectionInfo structure is part of an HTTP request payload
|
|
body, sensitive attributes that are children of this attribute (such as
|
|
passwords) shall be present if they have not been provisioned out of band.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
vim_connection_info_access_info_password:
|
|
description: |
|
|
The password to use for access.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vim_connection_info_access_info_region:
|
|
description: |
|
|
The OpenStack region to use for the VIM connection.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vim_connection_info_access_info_tenant:
|
|
description: |
|
|
The OpenStack tenant to use for the VIM connection.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vim_connection_info_access_info_username:
|
|
description: |
|
|
The username to use for access.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vim_connection_info_id:
|
|
description: |
|
|
The identifier of the VIM Connection. This identifier is managed by
|
|
the NFVO.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vim_connection_info_interface_info:
|
|
description: |
|
|
Information about the interface or interfaces to the VIM, if
|
|
applicable, such as the URI of an interface endpoint to
|
|
communicate with the VIM. The applicable keys are
|
|
dependent on the content of vimType.
|
|
|
|
Alternatively, such information may have been configured
|
|
into the VNFM and bound to the vimId.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
vim_connection_info_interface_info_endpoint:
|
|
description: |
|
|
The url representing the interface endpoint.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vim_connection_info_vim_id:
|
|
description: |
|
|
The identifier of the VIM instance. This identifier is managed by
|
|
the NFVO.
|
|
|
|
Shall be present to address additional information about the VIM
|
|
if such information has been configured into the VNFM by means outside
|
|
the scope of the present document, and should be absent otherwise.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
vim_connection_info_vim_type:
|
|
description: |
|
|
Discriminator for the different types of the VIM information.
|
|
|
|
The value of this attribute determines the structure of the
|
|
"interfaceInfo" and "accessInfo" attributes, based on the type of the VIM.
|
|
|
|
The set of permitted values is expected to change over time as new
|
|
types or versions of VIMs become available.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
virtual_storage_resource_info:
|
|
description: |
|
|
Information about the virtualised storage resources used as storage for
|
|
the VNF instance.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
virtual_storage_resource_info_id:
|
|
description: |
|
|
Identifier of this VirtualStorageResourceInfo instance.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
virtual_storage_resource_info_storage_resource:
|
|
description: |
|
|
Reference to the VirtualStorage resource.
|
|
in: body
|
|
required: true
|
|
type: object
|
|
virtual_storage_resource_info_virtual_storage_desc_id:
|
|
description: |
|
|
Identifier of the VirtualStorageDesc in the VNFD.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vnf_instance_additional_params:
|
|
description: |
|
|
Additional input parameters for the flavour change
|
|
process, specific to the VNF being modified, as declared
|
|
in the VNFD as part of "ChangeVnfFlavourOpConfig".
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vnf_instance_create_request_description:
|
|
description: |
|
|
Human-readable description of the VNF instance to be created.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
vnf_instance_create_request_metadata:
|
|
description: |
|
|
This attribute provides values for the "metadata" attribute in "VnfInstance".
|
|
in: body
|
|
required: false
|
|
type: array
|
|
vnf_instance_create_request_name:
|
|
description: |
|
|
Human-readable name of the VNF instance to be created.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
vnf_instance_create_request_vnfd_id:
|
|
description: |
|
|
Identifier that identifies the VNFD which defines the VNF instance to be created.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vnf_instance_description:
|
|
description: |
|
|
Human-readable description of the VNF instance.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
vnf_instance_extensions:
|
|
description: |
|
|
description
|
|
in: body
|
|
required: false
|
|
type: string
|
|
vnf_instance_id_response:
|
|
description: |
|
|
Identifier of the VNF instance.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vnf_instance_instantiation_state:
|
|
description: |
|
|
The instantiation state of the VNF instance.
|
|
|
|
NOT_INSTANTIATED: The VNF instance is terminated or not instantiated.
|
|
|
|
INSTANTIATED: The VNF instance is instantiated.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vnf_instance_links:
|
|
description: |
|
|
Links to resources related to this resource.
|
|
in: body
|
|
required: true
|
|
type: object
|
|
vnf_instance_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.
|
|
in: body
|
|
required: false
|
|
type: object
|
|
vnf_instance_modify_request_description:
|
|
description: |
|
|
New value of the "vnfInstanceDescription" attribute in
|
|
"VnfInstance", or "null" to remove the attribute.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
vnf_instance_modify_request_metadata:
|
|
description: |
|
|
Modifications of the "metadata" attribute in
|
|
"VnfInstance". If present, these modifications shall be
|
|
applied according to the rules of JSON Merge PATCH
|
|
in: body
|
|
required: false
|
|
type: string
|
|
vnf_instance_modify_request_name:
|
|
description: |
|
|
New value of the "vnfInstanceName" attribute in
|
|
"VnfInstance", or "null" to remove the attribute.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
vnf_instance_modify_request_vim_connection_info:
|
|
description: |
|
|
New content of certain entries in the
|
|
"vimConnectionInfo" attribute array in "VnfInstance", as
|
|
defined below this table.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
vnf_instance_modify_request_vnf_pkg_id:
|
|
description: |
|
|
New value of the "vnfPkgId" attribute in "VnfInstance". The
|
|
value "null" is not permitted.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
vnf_instance_modify_request_vnfd_id:
|
|
description: |
|
|
New value of the "vnfdId" attribute in "VnfInstance". The
|
|
value "null" is not permitted.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
vnf_instance_name:
|
|
description: |
|
|
Name of the VNF instance.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
vnf_instance_subscription_filter:
|
|
description: |
|
|
Filter criteria to select VNF instances
|
|
about which to notify.
|
|
in: body
|
|
required: false
|
|
type: object
|
|
vnf_instance_vim_connection_info:
|
|
description: |
|
|
Information about VIM connections to be used for managing the resources
|
|
for the VNF instance, or refer to external / externally-managed virtual links.
|
|
|
|
This attribute shall only be supported and may be present if VNF-related
|
|
resource management in direct mode is applicable.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
vnf_instance_vnf_pkg_id:
|
|
description: |
|
|
Identifier of information held by the NFVO about the specific VNF package
|
|
on which the VNF is based.
|
|
This identifier is allocated by the NFVO
|
|
and can be modified with the PATCH method.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vnf_instance_vnf_product_name:
|
|
description: |
|
|
Name to identify the VNF Product. The value is copied from the VNFD.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vnf_instance_vnf_provider:
|
|
description: |
|
|
Provider of the VNF and the VNFD. The value is copied from the VNFD.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vnf_instance_vnf_software_version:
|
|
description: |
|
|
Software version of the VNF. The value is copied from the VNFD.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vnf_instance_vnfd_id:
|
|
description: |
|
|
Identifier of the VNFD on which the VNF instance is based.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vnf_instance_vnfd_version:
|
|
description: |
|
|
Identifies the version of the VNFD. The value is copied from the VNFD.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vnf_lcm_op_occ_id_response:
|
|
description: |
|
|
Identifier of this VNF lifecycle management operation occurrence.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vnf_lcm_vnf_instance_id:
|
|
description: |
|
|
Identifier of the VNF instance to which the operation applies.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vnf_link_port_cp_instance_id:
|
|
description: |
|
|
When the link port is used for external connectivity by the VNF, this
|
|
attribute represents the identifier associated with 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 "vnfcResourceInfo" item in the VnfInstance.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
vnf_link_port_id:
|
|
description: |
|
|
Identifier of this link port as provided by the entity that has created
|
|
the link port.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vnf_link_port_resource_handle:
|
|
description: |
|
|
Reference to the virtualised network resource realizing this link port.
|
|
in: body
|
|
required: true
|
|
type: object
|
|
vnf_link_ports:
|
|
description: |
|
|
Links ports of this VL.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
vnf_state:
|
|
description: |
|
|
State of the VNF instance.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
vnf_virtual_link_desc_id:
|
|
description: |
|
|
The identifier of the VLD in the VNFD for this VL.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vnf_virtual_link_resource_info:
|
|
description: |
|
|
Information about the virtualised network
|
|
resources used by the VLs of the VNF instance.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
vnf_virtual_link_resource_info_id:
|
|
description: |
|
|
Identifier of this VnfVirtualLinkResourceInfo instance.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vnf_virtual_link_resource_info_network_resource:
|
|
description: |
|
|
Reference to the VirtualNetwork resource.
|
|
in: body
|
|
required: true
|
|
type: object
|
|
vnf_virtual_link_resource_info_vnf_virtual_link_desc_id:
|
|
description: |
|
|
Identifier of the VNF Virtual Link Descriptor (VLD) in the
|
|
VNFD.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vnfc_cp_info_cp_protocol_info:
|
|
description: |
|
|
Network protocol information for this CP.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
vnfc_cp_info_cpd_id:
|
|
description: |
|
|
Identifier of the VDU CPD, cpdId, in the VNFD.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vnfc_cp_info_id:
|
|
description: |
|
|
Identifier of this VNFC CP instance and the associated array entry.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vnfc_cp_info_vnf_ext_cp_id:
|
|
description: |
|
|
When the VNFC CP is exposed as external CP of the VNF, the
|
|
identifier of this external VNF CP.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
vnfc_cp_info_vnf_link_port_id:
|
|
description: |
|
|
Identifier of the "vnfLinkPorts" structure in the
|
|
"VnfVirtualLinkResourceInfo" structure. Shall be present if the CP is
|
|
associated to a link port.
|
|
in: body
|
|
required: false
|
|
type: string
|
|
vnfc_info:
|
|
description: |
|
|
Information about the VNFC instances.
|
|
in: body
|
|
required: array
|
|
type: string
|
|
vnfc_info_id:
|
|
description: |
|
|
Identifier of the VNFC instance.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vnfc_info_vdu_id:
|
|
description: |
|
|
Reference to the applicable VDU information element in the VNFD.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vnfc_info_vnfc_state:
|
|
description: |
|
|
State of the VNFC instance.
|
|
Permitted values:
|
|
|
|
STARTED: The VNFC instance is up and running.
|
|
|
|
STOPPED: The VNFC instance has been shut down.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vnfc_resource_info:
|
|
description: |
|
|
Information about the virtualised compute and storage resources used by
|
|
the VNFCs of the VNF instance.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
vnfc_resource_info_compute_resource:
|
|
description: |
|
|
Reference to the VirtualCompute resource.
|
|
in: body
|
|
required: true
|
|
type: object
|
|
vnfc_resource_info_id:
|
|
description: |
|
|
Identifier of this VnfcResourceInfo instance.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vnfc_resource_info_ids:
|
|
description: |
|
|
List of VNFC instances requiring a healing action.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
vnfc_resource_info_storage_resource_ids:
|
|
description: |
|
|
References to the VirtualStorage resources. The value refers to a
|
|
VirtualStorageResourceInfo item in the VnfInstance.
|
|
in: body
|
|
required: false
|
|
type: array
|
|
vnfc_resource_info_vdu_id:
|
|
description: |
|
|
Reference to the applicable VDU in the VNFD.
|
|
in: body
|
|
required: true
|
|
type: string
|
|
vnfc_resource_info_vnfc_cp_info:
|
|
description: |
|
|
CPs of the VNFC instance.
|
|
Shall be present when that particular CP
|
|
of the VNFC instance is associated to an external CP of the VNF
|
|
instance.
|
|
May be present otherwise.
|
|
in: body
|
|
required: false
|
|
type: array
|