Newer
Older
title: SOL003 - VNF Lifecycle Management interface
description: |
SOL003 - VNF Lifecycle Management interface
![Michele Carignani Michele Carignani's avatar](/rep/assets/no_avatar-849f9c04a3a0d0cea2424ae97b27447dc64a7dbfae83c036c45b403392f0e8ba.png)
Michele Carignani
committed
IMPORTANT: Please note that this file might be not aligned to the current
version of the ETSI Group Specification it refers to. In case of
discrepancies the published ETSI Group Specification takes precedence.
Giacomo Bernini
committed
Please report bugs to https://forge.etsi.org/rep/nfv/SOL002-SOL003/issues
url: https://forge.etsi.org/etsi-forge-copyright-notice.txt
version: "2.0.0-impl:etsi.org:ETSI_NFV_OpenAPI:1"
![Michele Carignani Michele Carignani's avatar](/rep/assets/no_avatar-849f9c04a3a0d0cea2424ae97b27447dc64a7dbfae83c036c45b403392f0e8ba.png)
Michele Carignani
committed
externalDocs:
description: ETSI GS NFV-SOL 003 V3.3.1
Giacomo Bernini
committed
url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/003/02.07.01_60/gs_NFV-SOL003v020701p.pdf
servers:
- url: http://127.0.0.1/vnflcm/v1
- url: https://127.0.0.1/vnflcm/v1
Giacomo Bernini
committed
###############################################################################
# API Versions #
###############################################################################
/api_versions:
$ref: ../../endpoints/SOL002SOL003_endpoints.yaml#/endpoints/api-versions
###############################################################################
# VNF instances #
###############################################################################
parameters:
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Accept
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Authorization
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Version
The POST method creates a new VNF instance resource based on a VNF package that is onboarded and in
"ENABLED" state.
This method shall follow the provisions specified in the tables 5.4.2.3.1-1 and 5.4.2.3.1-2
for URI query parameters, request and response data structures, and response codes.
As the result of successfully executing this method, a new "Individual VNF instance"
resource as defined in clause 5.4.3 shall have been created, and the value of the
"instantiationState" attribute in the representation of that resource shall be "NOT_INSTANTIATED".
A notification of type VnfIdentifierCreationNotification shall be triggered as part of successfully
executing this method as defined in clause 5.5.2.18.
When initiating the creation of a VNF instance resource, the passed metadata values can differ from
the default values for metadata, if any, declared in the VNFD.
The VNFM shall apply the "metadata" attributes in the "CreateVnfRequest" data structure in the payload
body to the "metadata" attribute in the "VnfInstance" data structure on top of the default values that
were obtained from the VNFD according to the rules of JSON Merge Patch (see IETF RFC 7396).
For all metadata keys defined in the VNFD, the VNFM shall ensure that the content of the resulting
"metadata" attributes is valid against the data type definitions in the VNFD. The absence of a metadata
item that is marked "required" in the VNFD shall not be treated as an error. In case a "metadata" child
attribute is not defined in the VNFD, the VNFM shall consider it valid in case it is a valid JSON structure.
In case of an error, the operation shall be rejected with a "422 Unprocessable Entity" error.
requestBody:
$ref: '#/components/requestBodies/CreateVnfRequest'
$ref: '#/components/responses/VNFInstances.Post.201'
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/400"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/401"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/403"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/404"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/405"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/406"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/422"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/500"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/503"
504:
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/504"
Query VNF.
The GET method queries information about multiple VNF instances.
parameters:
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/filter
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/all_fields
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/fields
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/exclude_fields
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/exclude_default
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/nextpage_opaque_marker
$ref: '#/components/responses/VNFInstances.Get.200'
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/400"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/401"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/403"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/404"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/405"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/406"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/416"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/500"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/503"
504:
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/504"
moscatelli
committed
###############################################################################
# Individual VNF instance #
###############################################################################
#SOL003 location: 5.4.3.2
parameters:
- $ref: '#/components/parameters/VnfInstanceId'
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Authorization
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Version
The GET method retrieves information about a VNF instance by reading an "Individual VNF instance" resource.
This method shall follow the provisions specified in the tables 5.4.3.3.2-1 and 5.4.3.3.2-2
for URI query parameters, request and response data structures, and response codes.
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Accept
$ref: '#/components/responses/IndividualVnfInstance.Get.200'
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/400"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/401"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/403"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/404"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/405"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/406"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/416"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/500"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/503"
moscatelli
committed
504:
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/504"
patch:
#SOL003 location: 5.4.3.3.4
moscatelli
committed
Modify VNF Information.
This method modifies an "Individual VNF instance" resource.
Changes to the VNF configurable properties are applied to the configuration in the VNF instance,
and are reflected in the representation of this resource.
Other changes are applied to the VNF instance information managed by the VNFM, and are reflected
in the representation of this resource.
This method shall follow the provisions specified in the tables 5.4.3.3.4-1 and 5.4.3.3.4-2
for URI query parameters, request and response data structures, and response codes.
The steps and conditions that apply as the result of successfully executing this method are
specified in clause 5.4.1.2.
The VNFM shall apply the "metadata", "extensions" and "vnfConfigurableProperties" attributes in the
"VnfInfoModificationRequest" data structure in the payload body to the existing "extensions" and
"vnfConfigurableProperties" attributes from the "VnfInstance" data structure according to the
rules of JSON Merge Patch (see IETF RFC 7396).
The VNFM shall ensure that the content of the child attributes of the resulting "metadata", "extensions"
and "vnfConfigurableProperties" attributes is valid against the data types definitions of these child
attributes in the VNFD.
In case a "metadata" child attribute is not defined in the VNFD, the VNFM shall consider it valid in
case it is a valid JSON structure.
NOTE: "Extensions" and "vnfConfigurableProperties" child attributes are always declared in the VNFD.
If the VNF instance is in the "INSTANTIATED" state, the validation shall also include
ensuring the presence of all "extensions" and "vnfConfigurableProperties" child attributes that are
marked as "required" in the VNFD.
NOTE: This allows to build the set of "extensions" and "vnfConfigurableProperties" incrementally
prior VNF instantiation but ensures their completeness for an instantiated VNF instance.
The absence of a metadata item that is marked "required" in the VNFD shall not be treated as an error.
In case of an error during validation, the operation shall be automatically rolled back, and
appropriate error information shall be provided in the "VnfLcmOperationOccurrenceNotification"
message and the "VnfLcmOpOcc" data structure.
The processing of changes to the "metadata" / "extensions" / "vnfConfigurableProperties" attributes
shall be performed in the "PROCESSING" phase of the LCM operation. The change shall be atomic, i.e. the
result of intermediate stages shall not be visible in the API. In case of successful completion of the
processing and validation, the attributes shall be provided in the "VnfInstance" data structure and
the operation shall proceed towards successful completion.
requestBody:
$ref: '#/components/requestBodies/VnfInfoModificationRequest'
$ref: '#/components/responses/IndividualVnfInstance.Patch.202'
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/400"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/401"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/403"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/404"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/405"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/406"
Giacomo Bernini
committed
#409 CONFLICT
Giacomo Bernini
committed
#Shall be returned upon the following error: The operation cannot be executed currently,
#due to a conflict with the state of the "Individual VNF instance" resource.
#Typically, this is due to the fact that another LCM operation is ongoing.
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/409"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/412"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/500"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/503"
delete:
#SOL003 location: 5.4.3.3.5
moscatelli
committed
Delete VNF Identifier.
This method deletes an "Individual VNF instance" resource.
This method shall follow the provisions specified in the tables 5.4.3.3.5-1 and 5.4.3.3.5-2
for URI query parameters, request and response data structures, and response codes.
As the result of successfully executing this method, the "Individual VNF instance" resource
shall not exist any longer.
A notification of type "VnfIdentifierDeletionNotification" shall be triggered as part of successfully
executing this method as defined in clause 5.5.2.19.
$ref: '#/components/responses/IndividualVnfInstance.Delete.204'
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/400"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/401"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/403"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/404"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/405"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/406"
Giacomo Bernini
committed
#409 CONFLICT
Giacomo Bernini
committed
#Shall be returned upon the following error: The operation cannot be executed currently,
#due to a conflict with the state of the resource.
#Typically, this is due to the fact that the "Individual VNF instance" resource is in INSTANTIATED state.
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/409"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/412"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/500"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/503"
###############################################################################
# Instantiate VNF task #
###############################################################################
/vnf_instances/{vnfInstanceId}/instantiate:
#SOL003 location: 5.4.4.2
parameters:
- $ref: '#/components/parameters/VnfInstanceId'
Instantiate VNF.
The POST method instantiates a VNF instance.
This method shall follow the provisions specified in the tables 5.4.4.3.1-1 and 5.4.4.3.1-2
for URI query parameters, request and response data structures, and response codes.
The steps and conditions that apply as the result of successfully executing this method
are specified in clause 5.4.1.2.
In addition, once the VNFM has successfully completed the underlying VNF LCM operation occurrence,
it shall set the "instantiationState" attribute to the value "INSTANTIATED" and the "vnfState"
attribute to the value "STARTED" in the representation of the "Individual VNF instance" resource.
When instantiating a VNF instance, the values of the extensions and/or VNF configurable properties
passed in the instantiation request can differ from the values in the "VnfInstance" data structure
that were initialized from default values, if any, declared in the VNFD.
The VNFM shall apply the "extensions" and "vnfConfigurableProperties" attributes in the
"InstantiateVnfRequest" data structure in the payload body to the existing "extensions" and
"vnfConfigurableProperties" attributes from the "VnfInstance" data structure according to the rules
of JSON Merge Patch (see IETF RFC 7396). The VNFM shall ensure that the content of the resulting
"extensions" and "vnfConfigurableProperties" attributes is valid against the VNFD (including the
presence of all child attributes that are marked as "required" in the VNFD). In case of an error
during validation, the operation shall be automatically rolled back, and appropriate error information
shall be provided in the "VnfLcmOperationOccurrenceNotification" message and the "VnfLcmOpOcc"
data structure. The processing of changes to the "extensions" / "vnfConfigurableProperties" attributes
shall be performed in the "STARTING" phase of the LCM operation. The change shall be atomic, i.e.
the result of intermediate stages shall not be visible in the API. In case of successful completion
of the processing and validation, the attributes shall be provided in the "VnfInstance" data structure
and the operation shall proceed to obtain the grant.
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Accept
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Authorization
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Version
requestBody:
$ref: '#/components/requestBodies/InstantiateVnfRequest'
$ref: '#/components/responses/InstantiateVnfInstance.Post.202'
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/400"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/401"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/403"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/404"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/405"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/406"
Giacomo Bernini
committed
#409 CONFLICT
#Shall be returned upon the following error: The operation cannot be executed currently,
#due to a conflict with the state of the resource.
#Typically, this is due to the fact that the "Individual VNF instance" resource is in INSTANTIATED state,
#or that a required child attribute of the "extensions" attribute has not been set.
#Those attributes are marked as "required" in the VNFD.
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/409"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/416"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/500"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/503"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/504"
###############################################################################
# Scale VNF task #
###############################################################################
/vnf_instances/{vnfInstanceId}/scale:
#SOL003 location: 5.4.5.2
parameters:
- $ref: '#/components/parameters/VnfInstanceId'
Scale VNF.
The POST method requests to scale a VNF instance resource incrementally.
This method shall follow the provisions specified in the tables 5.4.5.3.1-1 and 5.4.5.3.1-2
for URI query parameters, request and response data structures, and response codes.
The steps and conditions that apply as the result of successfully executing this method are
specified in clause 5.4.1.2.
In addition, once the VNFM has successfully completed the underlying VNF LCM operation occurrence,
it shall reflect the result of scaling the VNF instance by updating the "scaleStatus" attribute
in the representation of the "Individual VNF instance" resource.
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Accept
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Authorization
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Version
requestBody:
$ref: '#/components/requestBodies/ScaleVnfRequest'
$ref: '#/components/responses/ScaleVnfInstance.Post.202'
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/400"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/401"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/403"
Giacomo Bernini
committed
#404 NOT FOUND
#Shall be returned upon the following error: The API producer did not find a current representation
#for the target resource or is not willing to disclose that one exists.
#The general cause for this error and its handling is specified in clause 6.4 of ETSI GS NFV-SOL 013,
#including rules for the presence of the response body.
#Specifically in case of this task resource, the response code 404 shall also returned if
#the task is not supported for the VNF instance represented by the parent resource, which means that the
#task resource consequently does not exist.
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/404"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/405"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/406"
Giacomo Bernini
committed
#409 CONFLICT
#Shall be returned upon the following error: The operation cannot be executed currently,
#due to a conflict with the state of the resource.
#Typically, this is due to the fact that the "Individual VNF instance" resource is in
#NOT_INSTANTIATED state, or that another lifecycle management operation is ongoing, or that
#a required child attribute of the "extensions" attribute has not been set.
#Those attributes are marked as "required" in the VNFD.
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/409"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/500"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/503"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/504"
###############################################################################
# Scale VNF to Level task #
###############################################################################
/vnf_instances/{vnfInstanceId}/scale_to_level:
#SOL003 location: 5.4.6.2
parameters:
- $ref: '#/components/parameters/VnfInstanceId'
Scale VNF to Level.
The POST method requests to scale a VNF instance resource to a target level.
This method shall follow the provisions specified in the tables 5.4.6.3.1-1 and 5.4.6.3.1-2
for URI query parameters, request and response data structures, and response codes.
The steps and conditions that apply as the result of successfully executing this method are
specified in clause 5.4.1.2.
In addition, once the VNFM has successfully completed the underlying VNF LCM operation occurrence,
it shall reflect the result of scaling the VNF instance by updating the "scaleStatus" attribute
in the representation of the "Individual VNF instance" resource.
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Accept
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Authorization
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Version
requestBody:
$ref: '#/components/requestBodies/ScaleVnfToLevelRequest'
$ref: '#/components/responses/ScaleToLevelVnfInstance.Post.202'
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/400"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/401"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/403"
Giacomo Bernini
committed
#404 NOT FOUND
#Shall be returned upon the following error: The API producer did not find a current representation
#for the target resource or is not willing to disclose that one exists.
#The general cause for this error and its handling is specified in clause 6.4 of ETSI GS NFV-SOL 013,
#including rules for the presence of the response body.
#Specifically in case of this task resource, the response code 404 shall also returned if the task
#is not supported for the VNF instance represented by the parent resource, which means that the task resource
#consequently does not exist.
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/404"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/405"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/406"
Giacomo Bernini
committed
#409 CONFLICT
#Shall be returned upon the following error: The operation cannot be executed currently,
#due to a conflict with the state of the resource.
#Typically, this is due to the fact that the VNF instance resource is in NOT_INSTANTIATED state,
#that another lifecycle management operation is ongoing, or that a required child attribute of
#the "extensions" attribute has not been set.
#Those attributes are marked as "required" in the VNFD.
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/409"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/500"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/503"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/504"
###############################################################################
# Change VNF Flavour task #
###############################################################################
/vnf_instances/{vnfInstanceId}/change_flavour:
#SOL003 location: 5.4.7.2
parameters:
- $ref: '#/components/parameters/VnfInstanceId'
Change VNF Flavour.
This method shall follow the provisions specified in the tables 5.4.7.3.1-1 and 5.4.7.3.1-2
for URI query parameters, request and response data structures, and response codes.
The steps and conditions that apply as the result of successfully executing this method
are specified in clause 5.4.1.2.
In addition, once the VNFM has successfully completed the underlying VNF LCM operation occurrence,
it shall set the "flavourId" attribute in the representation of the "Individual VNF instance"
resource to the value of the "newFlavourId" attribute passed in the "ChangeVnfFlavourRequest"
data in the POST request.
When initiating a change of the current VNF flavour, the values of the extensions and/or VNF
configurable properties, can differ between the new flavour and the old flavour of the VNF instance.
The VNFM shall apply the "extensions" and "vnfConfigurableProperties" attributes in the
"ChangeVnfFlavourRequest" data structure in the payload body to the existing "extensions" and
"vnfConfigurableProperties" attributes from the "VnfInstance" data structure according to the rules
of JSON Merge Patch (see IETF RFC 7396). The VNFM shall ensure that the content of the resulting
"extensions" and "vnfConfigurableProperties" attributes is valid against the VNFD (which includes
ensuring the presence of all child attributes that are marked as "required" in the VNFD). In case
of an error, the operation shall be automatically rolled back, and appropriate error information
shall be provided in the "VnfLcmOperationOccurrenceNotification" message and the "VnfLcmOpOcc" data
structure. The processing of changes to the "extensions" / "vnfConfigurableProperties" attributes
shall be performed in the "STARTING" phase of the LCM operation. The change shall be atomic, i.e.
the result of intermediate stages shall not be visible in the API. In case of successful completion
of the processing and validation, the attributes shall be provided in the "VnfInstance" data structure
and the operation shall proceed to obtain the grant.
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Accept
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Authorization
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Version
requestBody:
$ref: '#/components/requestBodies/ChangeVnfFlavourRequest'
$ref: '#/components/responses/ChangeFlavourVnfInstance.Post.202'
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/400"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/401"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/403"
Giacomo Bernini
committed
#404 NOT FOUND
#Shall be returned upon the following error: The API producer did not find a current representation
#for the target resource or is not willing to disclose that one exists.
#The general cause for this error and its handling is specified in clause 6.4 of ETSI GS NFV-SOL 013,
#including rules for the presence of the response body.
#Specifically in case of this task resource, the response code 404 shall also returned if the task
#is not supported for the VNF instance represented by the parent resource, which means that the task resource
#consequently does not exist.
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/404"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/405"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/406"
Giacomo Bernini
committed
#409 CONFLICT
#Shall be returned upon the following error: The operation cannot be executed currently,
#due to a conflict with the state of the resource.
#Typically, this is due to the fact that the VNF instance resource is in NOT_INSTANTIATED state,
#that another lifecycle management operation is ongoing, or that a required child attribute of
#the "extensions" attribute has not been set.
#Those attributes are marked as "required" in the VNFD.
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/409"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/500"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/503"
moscatelli
committed
504:
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/504"
moscatelli
committed
###############################################################################
# Terminate VNF task #
###############################################################################
/vnf_instances/{vnfInstanceId}/terminate:
#SOL003 location: 5.4.8.2
parameters:
- $ref: '#/components/parameters/VnfInstanceId'
moscatelli
committed
Terminate VNF.
Giacomo Bernini
committed
The POST method triggers the VNFM to terminate a VNF instance and to request to the VIM
the release of its used virtualised resources.
This method shall follow the provisions specified in the tables 5.4.8.3.1-1 and 5.4.8.3.1-2
for URI query parameters, request and response data structures, and response codes.
The steps and conditions that apply as the result of successfully executing this method
are specified in clause 5.4.1.2.
In addition, once the VNFM has successfully completed the underlying VNF LCM operation occurrence,
it shall set the "instantiationState" attribute in the representation of the "Individual VNF instance"
resource to the value "NOT_INSTANTIATED".
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Accept
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Authorization
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Version
requestBody:
$ref: '#/components/requestBodies/TerminateVnfRequest'
$ref: '#/components/responses/TerminateVnfInstance.Post.202'
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/400"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/401"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/403"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/404"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/405"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/406"
Giacomo Bernini
committed
#409 CONFLICT
#Shall be returned upon the following error: The operation cannot be executed currently,
#due to a conflict with the state of the resource.
#Typically, this is due to the fact that the VNF instance resource is in NOT_INSTANTIATED state,
#that another lifecycle management operation is ongoing, or that a required child attribute of
#the "extensions" attribute has not been set.
#Those attributes are marked as "required" in the VNFD.
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/409"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/500"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/503"
moscatelli
committed
504:
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/504"
moscatelli
committed
###############################################################################
# Heal VNF task #
###############################################################################
/vnf_instances/{vnfInstanceId}/heal:
#SOL003 location: 5.4.9.2
parameters:
- $ref: '#/components/parameters/VnfInstanceId'
moscatelli
committed
Heal VNF.
The POST method requests to heal a VNF instance.
This method shall follow the provisions specified in the tables 5.4.9.3.1-1 and 5.4.9.3.1-2
for URI query parameters, request and response data structures, and response codes.
The steps and conditions that apply as the result of successfully executing this method
are specified in clause 5.4.1.2.
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Accept
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Authorization
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Version
requestBody:
$ref: '#/components/requestBodies/HealVnfRequest'
$ref: '#/components/responses/HealVnfInstance.Post.202'
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/400"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/401"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/403"
Giacomo Bernini
committed
#404 NOT FOUND
#Shall be returned upon the following error: The API producer did not find a current representation
#for the target resource or is not willing to disclose that one exists.
#The general cause for this error and its handling is specified in clause 6.4 of ETSI GS NFV-SOL 013,
#including rules for the presence of the response body.
#Specifically in case of this task resource, the response code 404 shall also returned if the task is
#not supported for the VNF instance represented by the parent resource, which means that the task resource
#consequently does not exist.
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/404"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/405"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/406"
Giacomo Bernini
committed
#409 CONFLICT
#Shall be returned upon the following error: The operation cannot be executed currently,
#due to a conflict with the state of the resource.
#Typically, this is due to the fact that the VNF instance resource is in NOT_INSTANTIATED state,
#that another lifecycle management operation is ongoing, or that a required child attribute of
#the "extensions" attribute has not been set.
#Those attributes are marked as "required" in the VNFD.
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/409"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/500"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/503"
moscatelli
committed
504:
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/504"
moscatelli
committed
###############################################################################
# Operate VNF task #
###############################################################################
/vnf_instances/{vnfInstanceId}/operate:
#SOL003 location: 5.4.10.2
- $ref: '#/components/parameters/VnfInstanceId'
moscatelli
committed
Operate VNF.
The POST method changes the operational state of a VNF instance resource.
This method shall follow the provisions specified in the tables 5.4.10.3.1-1 and 5.4.10.3.1-2
for URI query parameters, request and response data structures, and response codes.
The steps and conditions that apply as the result of successfully executing this method
are specified in clause 5.4.1.2.
In addition, once the VNFM has successfully completed the underlying VNF LCM operation occurrence,
it shall set the "vnfState" attribute in the representation of the "Individual VNF instance" resource
to the value of the "changeStateTo" attribute passed in the "OperateVnfRequest" data in the POST request.
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Accept
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Authorization
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Version
requestBody:
$ref: '#/components/requestBodies/OperateVnfRequest'
$ref: '#/components/responses/OperateVnfInstance.Post.202'
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/400"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/401"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/403"
Giacomo Bernini
committed
#404 NOT FOUND
#Shall be returned upon the following error: The API producer did not find a current representation
#for the target resource or is not willing to disclose that one exists.
#The general cause for this error and its handling is specified in clause 6.4 of ETSI GS NFV-SOL 013,
#including rules for the presence of the response body.
#Specifically in case of this task resource, the response code 404 shall also returned if the task is
#not supported for the VNF instance represented by the parent resource, which means that the task resource
#consequently does not exist.
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/404"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/405"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/406"
Giacomo Bernini
committed
#409 CONFLICT
#Shall be returned upon the following error: The operation cannot be executed currently,
#due to a conflict with the state of the resource.
#Typically, this is due to the fact that the VNF instance resource is in NOT_INSTANTIATED state,
#that another lifecycle management operation is ongoing, or that a required child attribute of
#the "extensions" attribute has not been set.
#Those attributes are marked as "required" in the VNFD.
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/409"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/500"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/503"
moscatelli
committed
504:
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/504"
moscatelli
committed
###############################################################################
# Change external VNF connectivity task #
###############################################################################
/vnf_instances/{vnfInstanceId}/change_ext_conn:
#SOL003 location: 5.4.11.2
- $ref: '#/components/parameters/VnfInstanceId'
Change External VNF Connectivity.
The POST method changes the external connectivity of a VNF instance.
This method shall follow the provisions specified in the tables 5.4.11.3.1-1 and 5.4.11.3.1-2
for URI query parameters, request and response data structures, and response codes.
The steps and conditions that apply as the result of successfully executing this method
are specified in clause 5.4.1.2.
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Accept
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Authorization
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Version
requestBody:
$ref: '#/components/requestBodies/ChangeExtVnfConnectivityRequest'
$ref: '#/components/responses/ChangeExtConnVnfInstance.Post.202'
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/400"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/401"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/403"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/404"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/405"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/406"
Giacomo Bernini
committed
#409 CONFLICT
#Shall be returned upon the following error: The operation cannot be executed currently,
#due to a conflict with the state of the resource.
#Typically, this is due to the fact that another lifecycle management operation is ongoing,
#or that a required child attribute of the "extensions" attribute has not been set.
#Those attributes are marked as "required" in the VNFD.
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/409"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/500"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/503"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/504"
###############################################################################
# Change current VNF package task #
###############################################################################
/vnf_instances/{vnfInstanceId}/change_vnfpkg:
#SOL003 location: 5.4.11a.2
parameters:
- $ref: '#/components/parameters/VnfInstanceId'
The POST method changes the current VNF package on which the VNF instance is based.
This method shall follow the provisions specified in the tables 5.4.11a.3.1-1 and
5.4.11a.3.1-2 for URI query parameters, request and response data structures, and
response codes.
The steps and conditions that apply as the result of successfully executing this method
are specified in clause 5.4.1.2.
During a change of the current VNF package, the allowed and required extensions and/or
VNF configurable properties and their data types, as well as the metadata data types,
can differ between the source and the destination VNFD.
parameters:
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Accept
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Authorization
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Version
requestBody:
$ref: '#/components/requestBodies/ChangeCurrentVnfPkgRequest'
$ref: '#/components/responses/ChangeVnfpkgVnfInstance.Post.202'
400:
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/400"
401:
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/401"
403:
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/403"
404:
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/404"
405:
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/405"
406:
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/406"
409:
#409 CONFLICT
#Shall be returned upon the following error: The operation cannot be executed currently,
#due to a conflict with the state of the resource.
#Typically, this is due to the fact that another lifecycle management operation is ongoing,
#or that a required child attribute of the "extensions" attribute has not been set.
#Those attributes are marked as "required" in the VNFD.
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/409"
500:
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/500"
503:
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/503"
504:
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/504"
###############################################################################
# VNF LCM operation occurrences #
###############################################################################
Giacomo Bernini
committed
The API consumer can use this method to query status information about multiple
VNF lifecycle management operation occurrences.
This method shall follow the provisions specified in the tables 5.4.12.3.2-1 and 5.4.12.3.2-2
for URI query parameters, request and response data structures, and response codes.
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Accept
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Authorization
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/filter
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/all_fields
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/fields
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/exclude_fields
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/exclude_default
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/nextpage_opaque_marker
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Version
$ref: '#/components/responses/VnfLcmOpOccs.Get.200'
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/400"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/401"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/403"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/404"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/405"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/406"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/500"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/503"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/504"
###############################################################################
# Individual VNF LCM operation occurrence #
###############################################################################
#SOL003 location: 5.4.13
parameters:
- $ref: '#/components/parameters/VnfLcmOpOccId'
Giacomo Bernini
committed
The API consumer can use this method to retrieve status information about a VNF lifecycle
management operation occurrence by reading an "Individual VNF LCM operation occurrence" resource.
This method shall follow the provisions specified in the tables 5.4.13.3.2-1 and 5.4.13.3.2-2
for URI query parameters, request and response data structures, and response codes.
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Accept
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Authorization
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Version
$ref: '#/components/responses/IndividualVnfLcmOpOcc.Get.200'
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/400"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/401"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/403"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/404"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/405"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/406"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/500"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/503"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/504"
###############################################################################
# Retry operation task #
###############################################################################
/vnf_lcm_op_occs/{vnfLcmOpOccId}/retry:
#SOL003 location: 5.4.14
parameters:
- $ref: '#/components/parameters/VnfLcmOpOccId'
The POST method initiates retrying a VNF lifecycle operation if that operation
has experienced a temporary failure, i.e. the related "Individual VNF LCM operation occurrence"
resource is in "FAILED_TEMP" state.
This method shall follow the provisions specified in the tables 5.4.14.3.1-1 and 5.4.14.3.1-2
for URI query parameters, request and response data structures, and response codes.
In case of success of processing the asynchronous request, the "operationState" attribute
in the representation of the parent resource shall be changed to "PROCESSING" and the applicable
"start" notification according to clause 5.6.2.2 shall be emitted to indicate that the underlying
VNF LCM operation occurrence proceeds.
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Authorization
- $ref: ../../components/SOL002SOL003_params.yaml#/components/parameters/Version
$ref: '#/components/responses/RetryVnfLcmOpOcc.Post.202'
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/400"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/401"
$ref: "../../responses/SOL002SOL003_resp.yaml#/components/responses/403"
Giacomo Bernini
committed
#404 NOT FOUND
#Shall be returned upon the following error: The API producer did not find a current representation
#for the target resource or is not willing to disclose that one exists.
#The general cause for this error and its handling is specified in clause 6.4 of ETSI GS NFV-SOL 013,
#including rules for the presence of the response body.
#Specifically in case of this task resource, the response code 404 shall also be returned if the task