Newer
Older
title: SOL003 - VNF Lifecycle Management interface
description: |
SOL003 - VNF Lifecycle Management interface
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
committed
externalDocs:
description: ETSI GS NFV-SOL 003 V3.3.1
url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/003/03.03.01_60/gs_NFV-SOL003v030301p.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.
Loading full blame...