Newer
Older
rameshnaraya
committed
title: SOL005 - NSD Management Interface
description: |
IMPORTANT: Please note that this file might be not aligned to the current
version of the ETSI Group Specification it refers to and has not been
approved by the ETSI NFV ISG. In case of discrepancies the published ETSI
Group Specification takes precedence.
Please report bugs to https://forge.etsi.org/bugzilla/buglist.cgi?component=Nfv-Openapis
contact:
name: NFV-SOL WG
name: ETSI Forge copyright notice
url: https://forge.etsi.org/etsi-forge-copyright-notice.txt
version: 2.0.0-impl:etsi.org:ETSI_NFV_OpenAPI:1
rameshnaraya
committed
externalDocs:
description: ETSI GS NFV-SOL 005 V3.3.1
url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/02.06.01_60/gs_NFV-SOL005v020701p.pdf
servers:
- url: http://127.0.0.1/nsd/v2
- url: https://127.0.0.1/nsd/v2
moscatelli
committed
###############################################################################
# API Versions #
###############################################################################
moscatelli
committed
$ref: '../endpoints/SOL005_endpoints.yaml#/endpoints/api-versions'
moscatelli
committed
moscatelli
committed
###############################################################################
# NS Descriptors #
###############################################################################
#ETSI GS NFV-SOL 005 V2.4.1 location: 5.4.2
- $ref: ../components/SOL005_params.yaml#/components/parameters/Authorization
- $ref: ../components/SOL005_params.yaml#/components/parameters/Version
- $ref: ../components/SOL005_params.yaml#/components/parameters/Accept
post:
summary: Create a new NS descriptor resource.
The POST method is used to create a new NS descriptor resource.
- $ref: ../components/SOL005_params.yaml#/components/parameters/ContentType
requestBody:
$ref: '#/components/requestBodies/CreateNsdInfoRequest'
$ref: '#/components/responses/NSDescriptors.Post.201'
$ref: "../responses/SOL005_resp.yaml#/components/responses/400"
$ref: "../responses/SOL005_resp.yaml#/components/responses/401"
$ref: "../responses/SOL005_resp.yaml#/components/responses/403"
$ref: "../responses/SOL005_resp.yaml#/components/responses/404"
$ref: "../responses/SOL005_resp.yaml#/components/responses/405"
$ref: "../responses/SOL005_resp.yaml#/components/responses/406"
$ref: "../responses/SOL005_resp.yaml#/components/responses/500"
$ref: "../responses/SOL005_resp.yaml#/components/responses/503"
504:
$ref: "../responses/SOL005_resp.yaml#/components/responses/504"
summary: Query information about multiple NS descriptor resources.
moscatelli
committed
The GET method queries information about multiple NS descriptor resources.
parameters:
- $ref: ../components/SOL005_params.yaml#/components/parameters/filter
- $ref: ../components/SOL005_params.yaml#/components/parameters/all_fields
- $ref: ../components/SOL005_params.yaml#/components/parameters/fields
- $ref: ../components/SOL005_params.yaml#/components/parameters/exclude_fields
- $ref: ../components/SOL005_params.yaml#/components/parameters/exclude_default
- $ref: ../components/SOL005_params.yaml#/components/parameters/nextpage_opaque_marker
$ref: '#/components/responses/NSDescriptors.Get.200'
$ref: "../responses/SOL005_resp.yaml#/components/responses/400"
rameshnaraya
committed
401:
$ref: "../responses/SOL005_resp.yaml#/components/responses/401"
rameshnaraya
committed
403:
$ref: "../responses/SOL005_resp.yaml#/components/responses/403"
rameshnaraya
committed
404:
$ref: "../responses/SOL005_resp.yaml#/components/responses/404"
rameshnaraya
committed
405:
$ref: "../responses/SOL005_resp.yaml#/components/responses/405"
rameshnaraya
committed
406:
$ref: "../responses/SOL005_resp.yaml#/components/responses/406"
rameshnaraya
committed
500:
$ref: "../responses/SOL005_resp.yaml#/components/responses/500"
rameshnaraya
committed
503:
$ref: "../responses/SOL005_resp.yaml#/components/responses/503"
504:
$ref: "../responses/SOL005_resp.yaml#/components/responses/504"
moscatelli
committed
###############################################################################
# Individual NS Descriptor #
###############################################################################
/ns_descriptors/{nsdInfoId}:
#ETSI GS NFV-SOL 005 V2.4.1 location: 5.4.3
parameters:
- $ref: '#/components/parameters/NsdInfoId'
- $ref: ../components/SOL005_params.yaml#/components/parameters/Authorization
- $ref: ../components/SOL005_params.yaml#/components/parameters/Version
summary: Read information about an individual NS descriptor resource.
moscatelli
committed
The GET method reads information about an individual NS descriptor.
- $ref: ../components/SOL005_params.yaml#/components/parameters/Accept
$ref: '#/components/responses/IndividualNSDescriptor.Get.200'
rameshnaraya
committed
400:
$ref: "../responses/SOL005_resp.yaml#/components/responses/400"
rameshnaraya
committed
401:
$ref: "../responses/SOL005_resp.yaml#/components/responses/401"
rameshnaraya
committed
403:
$ref: "../responses/SOL005_resp.yaml#/components/responses/403"
rameshnaraya
committed
404:
$ref: "../responses/SOL005_resp.yaml#/components/responses/404"
rameshnaraya
committed
405:
$ref: "../responses/SOL005_resp.yaml#/components/responses/405"
rameshnaraya
committed
406:
$ref: "../responses/SOL005_resp.yaml#/components/responses/406"
rameshnaraya
committed
500:
$ref: "../responses/SOL005_resp.yaml#/components/responses/500"
rameshnaraya
committed
503:
$ref: "../responses/SOL005_resp.yaml#/components/responses/503"
504:
$ref: "../responses/SOL005_resp.yaml#/components/responses/504"
summary: Modify the operational state and/or the user defined data of an individual NS descriptor resource.
The PATCH method modifies the operational state and/or user defined data of an individual NS descriptor resource.
This method can be used to:
1) Enable a previously disabled individual NS descriptor resource, allowing again its use for instantiation of new
network service with this descriptor. The usage state (i.e. "IN_USE/NOT_IN_USE") shall not change as a
result.
2) Disable a previously enabled individual NS descriptor resource, preventing any further use for instantiation of
new network service(s) with this descriptor. The usage state (i.e. "IN_USE/NOT_IN_USE") shall not change
as a result.
rameshnaraya
committed
3) Modify the user defined data of an individual NS descriptor resource.
requestBody:
$ref: '#/components/requestBodies/NsdInfoModifications'
moscatelli
committed
responses:
$ref: '#/components/responses/IndividualNSDescriptor.Patch.200'
$ref: "../responses/SOL005_resp.yaml#/components/responses/400"
$ref: "../responses/SOL005_resp.yaml#/components/responses/401"
$ref: "../responses/SOL005_resp.yaml#/components/responses/403"
$ref: "../responses/SOL005_resp.yaml#/components/responses/404"
$ref: "../responses/SOL005_resp.yaml#/components/responses/405"
$ref: "../responses/SOL005_resp.yaml#/components/responses/406"
Samir Medjiah
committed
# 409 CONFLICT
# Error: The operation cannot be executed currently,
# due to a conflict with the state of the resource.
# Typically, this is due to an operational state
# mismatch, i.e. enable an already enabled or
# disable an already disabled individual NS
# descriptor resource, or the "nsdOnboardingState"
# is not ONBOARDED.
# The response body shall contain a ProblemDetails
# structure, in which the "detail" attribute shall convey
# more information about the error.
$ref: "../responses/SOL005_resp.yaml#/components/responses/409"
$ref: "../responses/SOL005_resp.yaml#/components/responses/412"
$ref: "../responses/SOL005_resp.yaml#/components/responses/500"
$ref: "../responses/SOL005_resp.yaml#/components/responses/503"
504:
$ref: "../responses/SOL005_resp.yaml#/components/responses/504"
moscatelli
committed
summary: Delete an individual NS descriptor resource.
The DELETE method deletes an individual NS descriptor resource.
An individual NS descriptor resource can only be deleted when there is no NS instance using it (i.e. usageState =
NOT_IN_USE) and has been disabled already (i.e. operationalState = DISABLED). Otherwise, the DELETE method
shall fail.
responses:
204:
$ref: '#/components/responses/IndividualNSDescriptor.Delete.204'
rameshnaraya
committed
400:
$ref: "../responses/SOL005_resp.yaml#/components/responses/400"
rameshnaraya
committed
401:
$ref: "../responses/SOL005_resp.yaml#/components/responses/401"
rameshnaraya
committed
403:
$ref: "../responses/SOL005_resp.yaml#/components/responses/403"
rameshnaraya
committed
404:
$ref: "../responses/SOL005_resp.yaml#/components/responses/404"
rameshnaraya
committed
405:
$ref: "../responses/SOL005_resp.yaml#/components/responses/405"
rameshnaraya
committed
406:
$ref: "../responses/SOL005_resp.yaml#/components/responses/406"
rameshnaraya
committed
409:
Samir Medjiah
committed
# 409 CONFLICT
# Error: The operation cannot be executed currently,
# due to a conflict with the state of the resource.
# Typically, this is due to the fact the NS descriptor
# resource is in the enabled operational state (i.e.
# operationalState = ENABLED) or there are running
# NS instances using the concerned individual NS
# descriptor resource (i.e. usageState = IN_USE).
# The response body shall contain a ProblemDetails
# structure, in which the "detail" attribute shall convey
# more information about the error.
$ref: "../responses/SOL005_resp.yaml#/components/responses/409"
rameshnaraya
committed
500:
$ref: "../responses/SOL005_resp.yaml#/components/responses/500"
rameshnaraya
committed
503:
$ref: "../responses/SOL005_resp.yaml#/components/responses/503"
504:
$ref: "../responses/SOL005_resp.yaml#/components/responses/504"
moscatelli
committed
###############################################################################
Samir Medjiah
committed
# NSD Archive Content #
moscatelli
committed
###############################################################################
/ns_descriptors/{nsdInfoId}/nsd_content:
#ETSI GS NFV-SOL 005 V2.4.1 location: 5.4.4
parameters:
- $ref: '#/components/parameters/NsdInfoId'
- $ref: ../components/SOL005_params.yaml#/components/parameters/Authorization
- $ref: ../components/SOL005_params.yaml#/components/parameters/Version
The GET method fetches the content of the NSD archive.
The NSD archive is implemented as a single zip file.
The content of the NSD archive is provided as onboarded,
i.e. depending on the security option used, the CSAR wrapped
in a ZIP archive together with an external signature is returned,
as defined in clause 5.1 of ETSI GS NFV-SOL 007.
NOTE: Information about the applicable security option can be
obtained by evaluating the "archiveSecurityOption"
attribute in the "nsdInfo" structure.
This method shall follow the provisions specified in the T
ables 5.4.4.3.2-1 and 5.4.4.3.2-2 for URI query parameters,
request and response data structures, and response codes.
- $ref: '#/components/parameters/AcceptTextOrZip'
- $ref: ../components/SOL005_params.yaml#/components/parameters/Range
$ref: '#/components/responses/NsdArchiveContent.Get.200'
Samir Medjiah
committed
# 206 PARTIAL CONTENT
# On success, if the NFVO supports range requests,
# a single consecutive byte range from the content of
# the NSD file is returned.
# The response body shall contain the requested part
# of the NSD file.
# The "Content-Range" HTTP header shall be
# provided according to IETF RFC 7233.
# The "Content-Type" HTTP header shall be set as
# defined above for the "200 OK" response.
$ref: "../responses/SOL005_resp.yaml#/components/responses/206"
rameshnaraya
committed
400:
$ref: "../responses/SOL005_resp.yaml#/components/responses/400"
rameshnaraya
committed
401:
$ref: "../responses/SOL005_resp.yaml#/components/responses/401"
rameshnaraya
committed
403:
$ref: "../responses/SOL005_resp.yaml#/components/responses/403"
rameshnaraya
committed
404:
$ref: "../responses/SOL005_resp.yaml#/components/responses/404"
rameshnaraya
committed
405:
$ref: "../responses/SOL005_resp.yaml#/components/responses/405"
Samir Medjiah
committed
# 406 NOT ACCEPTABLE
# If the "Accept" header does not contain at least one
# name of a content type for which the NFVO can
# provide a representation of the NSD, the NFVO
# shall respond with this response code.
# The "ProblemDetails" structure may be included
# with the "detail" attribute providing more information
# about the error.
$ref: "../responses/SOL005_resp.yaml#/components/responses/406"
Samir Medjiah
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
# "nsdOnboardingState" has a value different from
# ONBOARDED.
# The response body shall contain a ProblemDetails
# structure, in which the "detail" attribute shall convey
# more information about the error.
$ref: "../responses/SOL005_resp.yaml#/components/responses/409"
Samir Medjiah
committed
# 416 RANGE NOT SATISFIABLE
# The byte range passed in the "Range" header did
# not match any available byte range in the NSD file
# (e.g. "access after end of file").
# The response body may contain a ProblemDetails
# structure.
$ref: "../responses/SOL005_resp.yaml#/components/responses/416"
rameshnaraya
committed
500:
$ref: "../responses/SOL005_resp.yaml#/components/responses/500"
rameshnaraya
committed
503:
$ref: "../responses/SOL005_resp.yaml#/components/responses/503"
504:
$ref: "../responses/SOL005_resp.yaml#/components/responses/504"
moscatelli
committed
The PUT method is used to upload the content of an NSD archive.
The NSD to be uploaded is implemented as a single ZIP file as defined in clause 5.4.4.3.2.
The "Content-Type" HTTP header in the PUT request shall be set to "application/zip".
This method shall follow the provisions specified in the Tables 5.4.4.3.3-1 and
5.4.4.3.3-2 for URI query parameters, request and response data structures, and response codes.
- $ref: '#/components/parameters/ContentTypeZip'
$ref: '#/components/responses/NsdArchiveContent.Put.202'
$ref: '#/components/responses/NsdArchiveContent.Put.204'
rameshnaraya
committed
400:
$ref: "../responses/SOL005_resp.yaml#/components/responses/400"
rameshnaraya
committed
401:
$ref: "../responses/SOL005_resp.yaml#/components/responses/401"
rameshnaraya
committed
403:
$ref: "../responses/SOL005_resp.yaml#/components/responses/403"
rameshnaraya
committed
404:
$ref: "../responses/SOL005_resp.yaml#/components/responses/404"
rameshnaraya
committed
405:
$ref: "../responses/SOL005_resp.yaml#/components/responses/405"
rameshnaraya
committed
406:
$ref: "../responses/SOL005_resp.yaml#/components/responses/406"
# 409 CONFLICT
#
# 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
# NsdOnboardingState has a value other than
# CREATED.
# The response body shall contain a ProblemDetails
# structure, in which the "detail" attribute shall convey
# more information about the error.
$ref: "../responses/SOL005_resp.yaml#/components/responses/409"
$ref: "../responses/SOL005_resp.yaml#/components/responses/500"
$ref: "../responses/SOL005_resp.yaml#/components/responses/503"
$ref: "../responses/SOL005_resp.yaml#/components/responses/504"
###############################################################################
# NSD #
###############################################################################
/ns_descriptors/{nsdInfoId}/nsd:
#ETSI GS NFV-SOL 005 V2.4.1 location: 5.4.4a
parameters:
- $ref: '#/components/parameters/NsdInfoId'
- $ref: ../components/SOL005_params.yaml#/components/parameters/Authorization
- $ref: ../components/SOL005_params.yaml#/components/parameters/Version
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
The GET method reads the content of the NSD within an NSD archive.
The NSD can be implemented as a single file or as a collection of
multiple files. If the NSD is implemented in the form of multiple files,
a ZIP file embedding these files shall be returned. If the NSD is implemented
as a single file, either that file or a ZIP file embedding that file shall be returned.
The selection of the format is controlled by the "Accept" HTTP header passed in the GET request:
• If the "Accept" header contains only "text/plain" and the NSD is implemented as a single file,
the file shall be returned; otherwise, an error message shall be returned.
• If the "Accept" header contains only "application/zip", the single file or
the multiple files that make up the NSD shall be returned embedded in a ZIP file.
• If the "Accept" header contains both "text/plain" and "application/zip", it is up
to the NFVO to choose the format to return for a single-file NSD; for a multi-file NSD,
a ZIP file shall be returned.
The default format of the ZIP file shall be the one specified in ETSI GS NFV-SOL 007
where only the YAML files representing the NSD, and information necessary to navigate
the ZIP file and to identify the file that is the entry point for parsing the NSD and
(if requested) further security information are included. This means that the content
of the ZIP archive shall contain the following files from the NSD archive:
• TOSCA.meta (if available in the NSD archive);
• the main service template (either as referenced from TOSCA.meta or available as a
file with the extension ".yml" or ".yaml" from the root of the archive);
• every component of the NSD referenced (recursively) from the main service template;
• the related security information, if the "include_signatures" URI parameter is provided, as follows:
- the manifest file;
- the singleton certificate file in the root of the NSD archive (if available in the NSD archive);
- the signing certificates of the individual files included in the ZIP archive
(if available in the NSD archive);
- the signatures of the individual files (if available in the NSD archive).
This method shall follow the provisions specified in the Tables 5.4.4a.3.2-1 and 5.4.4a.3.2-2 for
URI query parameters, request and response data structures, and response codes.
parameters:
- $ref: ../components/SOL005_params.yaml#/components/parameters/include_signatures
- $ref: '#/components/parameters/AcceptTextOrZip'
$ref: '#/components/responses/NSD.Get.200'
$ref: "../responses/SOL005_resp.yaml#/components/responses/400"
$ref: "../responses/SOL005_resp.yaml#/components/responses/401"
$ref: "../responses/SOL005_resp.yaml#/components/responses/403"
$ref: "../responses/SOL005_resp.yaml#/components/responses/404"
$ref: "../responses/SOL005_resp.yaml#/components/responses/405"
$ref: "../responses/SOL005_resp.yaml#/components/responses/406"
$ref: "../responses/SOL005_resp.yaml#/components/responses/409"
$ref: "../responses/SOL005_resp.yaml#/components/responses/500"
$ref: "../responses/SOL005_resp.yaml#/components/responses/503"
$ref: "../responses/SOL005_resp.yaml#/components/responses/504"
###############################################################################
# NSD Archive Manifest #
###############################################################################
/ns_descriptors/{nsdInfoId}/manifest:
#ETSI GS NFV-SOL 005 V2.4.1 location: 5.4.4b
parameters:
- $ref: '#/components/parameters/NsdInfoId'
- $ref: ../components/SOL005_params.yaml#/components/parameters/Authorization
- $ref: ../components/SOL005_params.yaml#/components/parameters/Version
get:
summary: Fetch the content of the manifest in an NSD archive.
The GET method reads the content of the manifest file within an NSD archive.
This method shall follow the provisions specified in the Tables 5.4.4b.3.2-1
and 5.4.4b.3.2-2 for URI query parameters, request and response data structures,
and response codes.
parameters:
- $ref: '#/components/parameters/AcceptTextOrZip'
- $ref: ../components/SOL005_params.yaml#/components/parameters/include_signatures
$ref: '#/components/responses/NsdArchiveManifest.Get.200'
$ref: "../responses/SOL005_resp.yaml#/components/responses/400"
$ref: "../responses/SOL005_resp.yaml#/components/responses/401"
$ref: "../responses/SOL005_resp.yaml#/components/responses/403"
$ref: "../responses/SOL005_resp.yaml#/components/responses/404"
$ref: "../responses/SOL005_resp.yaml#/components/responses/405"
Samir Medjiah
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
# "nsdOnboardingState" has a value different from
# ONBOARDED.
# The response body shall contain a ProblemDetails
# structure, in which the "detail" attribute shall convey
# more information about the error.
$ref: "../responses/SOL005_resp.yaml#/components/responses/409"
rameshnaraya
committed
500:
$ref: "../responses/SOL005_resp.yaml#/components/responses/500"
rameshnaraya
committed
503:
$ref: "../responses/SOL005_resp.yaml#/components/responses/503"
504:
$ref: "../responses/SOL005_resp.yaml#/components/responses/504"
moscatelli
committed
Samir Medjiah
committed
###############################################################################
# Individual NSD Archive Artifact #
###############################################################################
/ns_descriptors/{nsdInfoId}/artifacts/{artifactPath}:
Samir Medjiah
committed
#ETSI GS NFV-SOL 005 V3.3.1 location: 5.4.4c
parameters:
- $ref: '#/components/parameters/NsdInfoId'
- $ref: '#/components/parameters/ArtifactPathInNSD'
- $ref: ../components/SOL005_params.yaml#/components/parameters/Authorization
- $ref: ../components/SOL005_params.yaml#/components/parameters/Version
Samir Medjiah
committed
get:
Samir Medjiah
committed
The GET method fetches the content of an individual artifact within
a NSD archive.
This method shall follow the provisions specified in the Tables 5.4.4c.3.2-1
and 5.4.4c.3.2-2 for URI query parameters, request and response data structures,
and response codes.
parameters:
- $ref: ../components/SOL005_params.yaml#/components/parameters/Range
- $ref: ../components/SOL005_params.yaml#/components/parameters/include_signatures
Samir Medjiah
committed
responses:
200:
$ref: '#/components/responses/IndividualNsdArchiveArtifact.Get.200'
Samir Medjiah
committed
206:
$ref: '#/components/responses/IndividualNsdArchiveArtifact.Get.206'
Samir Medjiah
committed
400:
$ref: "../responses/SOL005_resp.yaml#/components/responses/400"
401:
$ref: "../responses/SOL005_resp.yaml#/components/responses/401"
403:
$ref: "../responses/SOL005_resp.yaml#/components/responses/403"
404:
$ref: "../responses/SOL005_resp.yaml#/components/responses/404"
406:
Samir Medjiah
committed
# If the related request contained an "Accept" header not compatible with the Content type
# "application/zip" but the "include_signatures" flag was provided, the NFVO shall respond
# with this response code.
# The "ProblemDetails" structure may be included with the "detail" attribute providing more
# information about the error.
$ref: "../responses/SOL005_resp.yaml#/components/responses/405"
405:
$ref: "../responses/SOL005_resp.yaml#/components/responses/406"
409:
Samir Medjiah
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 "nsdOnboardingState" has a value different from
# "ONBOARDED".
# The response body shall contain a ProblemDetails structure, in which the "detail" attribute
# shall convey more information about the error.
$ref: "../responses/SOL005_resp.yaml#/components/responses/409"
416:
Samir Medjiah
committed
# The byte range passed in the "Range" header did not match any available byte range in the
# artifact file (e.g. "access after end of file").
# The response body may contain a ProblemDetails structure.
$ref: "../responses/SOL005_resp.yaml#/components/responses/416"
500:
$ref: "../responses/SOL005_resp.yaml#/components/responses/500"
503:
$ref: "../responses/SOL005_resp.yaml#/components/responses/503"
504:
$ref: "../responses/SOL005_resp.yaml#/components/responses/504"
moscatelli
committed
###############################################################################
# PNF Descriptors #
###############################################################################
#ETSI GS NFV-SOL 005 V2.4.1 location: 5.4.5
- $ref: ../components/SOL005_params.yaml#/components/parameters/Authorization
- $ref: ../components/SOL005_params.yaml#/components/parameters/Version
post:
summary: Create a new PNF descriptor resource.
The POST method is used to create a new PNF descriptor resource
parameters:
- $ref: ../components/SOL005_params.yaml#/components/parameters/Accept
- $ref: ../components/SOL005_params.yaml#/components/parameters/ContentType
requestBody:
$ref: '#/components/requestBodies/CreatePnfdInfoRequest'
$ref: '#/components/responses/PNFDescriptors.Post.201'
$ref: "../responses/SOL005_resp.yaml#/components/responses/400"
$ref: "../responses/SOL005_resp.yaml#/components/responses/401"
$ref: "../responses/SOL005_resp.yaml#/components/responses/403"
$ref: "../responses/SOL005_resp.yaml#/components/responses/404"
$ref: "../responses/SOL005_resp.yaml#/components/responses/405"
$ref: "../responses/SOL005_resp.yaml#/components/responses/406"
$ref: "../responses/SOL005_resp.yaml#/components/responses/500"
$ref: "../responses/SOL005_resp.yaml#/components/responses/503"
504:
$ref: "../responses/SOL005_resp.yaml#/components/responses/504"
summary: Query information about multiple PNF descriptor resources.
rameshnaraya
committed
"The GET method queries information about multiple PNF descriptor
resources."
- $ref: ../components/SOL005_params.yaml#/components/parameters/filter
- $ref: ../components/SOL005_params.yaml#/components/parameters/all_fields
- $ref: ../components/SOL005_params.yaml#/components/parameters/fields
- $ref: ../components/SOL005_params.yaml#/components/parameters/exclude_fields
- $ref: ../components/SOL005_params.yaml#/components/parameters/exclude_default
- $ref: ../components/SOL005_params.yaml#/components/parameters/nextpage_opaque_marker
$ref: '#/components/responses/PNFDescriptors.Get.200'
rameshnaraya
committed
400:
$ref: "../responses/SOL005_resp.yaml#/components/responses/400"
rameshnaraya
committed
401:
$ref: "../responses/SOL005_resp.yaml#/components/responses/401"
rameshnaraya
committed
403:
$ref: "../responses/SOL005_resp.yaml#/components/responses/403"
rameshnaraya
committed
404:
$ref: "../responses/SOL005_resp.yaml#/components/responses/404"
rameshnaraya
committed
405:
$ref: "../responses/SOL005_resp.yaml#/components/responses/405"
rameshnaraya
committed
406:
$ref: "../responses/SOL005_resp.yaml#/components/responses/406"
rameshnaraya
committed
500:
$ref: "../responses/SOL005_resp.yaml#/components/responses/500"
rameshnaraya
committed
503:
$ref: "../responses/SOL005_resp.yaml#/components/responses/503"
504:
$ref: "../responses/SOL005_resp.yaml#/components/responses/504"
moscatelli
committed
###############################################################################
# Individual PNF Descriptor #
###############################################################################
/pnf_descriptors/{pnfdInfoId}:
#ETSI GS NFV-SOL 005 V2.4.1 location: 5.4.6
parameters:
- $ref: '#/components/parameters/PnfdInfoId'
summary: Read an individual PNFD resource.
The GET method reads information about an individual PNF descriptor.
parameters:
- $ref: ../components/SOL005_params.yaml#/components/parameters/Accept
- $ref: ../components/SOL005_params.yaml#/components/parameters/Authorization
- $ref: ../components/SOL005_params.yaml#/components/parameters/Version
$ref: '#/components/responses/IndividualPnfDescriptor.Get.200'
rameshnaraya
committed
400:
$ref: "../responses/SOL005_resp.yaml#/components/responses/400"
rameshnaraya
committed
401:
$ref: "../responses/SOL005_resp.yaml#/components/responses/401"
rameshnaraya
committed
403:
$ref: "../responses/SOL005_resp.yaml#/components/responses/403"
rameshnaraya
committed
404:
$ref: "../responses/SOL005_resp.yaml#/components/responses/404"
rameshnaraya
committed
405:
$ref: "../responses/SOL005_resp.yaml#/components/responses/405"
rameshnaraya
committed
406:
$ref: "../responses/SOL005_resp.yaml#/components/responses/406"
rameshnaraya
committed
500:
$ref: "../responses/SOL005_resp.yaml#/components/responses/500"
rameshnaraya
committed
503:
$ref: "../responses/SOL005_resp.yaml#/components/responses/503"
504:
$ref: "../responses/SOL005_resp.yaml#/components/responses/504"
patch:
summary: Modify the user defined data of an individual PNF descriptor resource.
The PATCH method modifies the user defined data of an individual PNF descriptor resource.
parameters:
- $ref: ../components/SOL005_params.yaml#/components/parameters/Accept
- $ref: ../components/SOL005_params.yaml#/components/parameters/ContentType
requestBody:
$ref: '#/components/requestBodies/PnfdInfoModifications'
$ref: '#/components/responses/IndividualPnfDescriptor.Patch.200'
rameshnaraya
committed
400:
$ref: "../responses/SOL005_resp.yaml#/components/responses/400"
rameshnaraya
committed
401:
$ref: "../responses/SOL005_resp.yaml#/components/responses/401"
rameshnaraya
committed
403:
$ref: "../responses/SOL005_resp.yaml#/components/responses/403"
rameshnaraya
committed
404:
$ref: "../responses/SOL005_resp.yaml#/components/responses/404"
rameshnaraya
committed
405:
$ref: "../responses/SOL005_resp.yaml#/components/responses/405"
rameshnaraya
committed
406:
$ref: "../responses/SOL005_resp.yaml#/components/responses/406"
$ref: "../responses/SOL005_resp.yaml#/components/responses/412"
rameshnaraya
committed
500:
$ref: "../responses/SOL005_resp.yaml#/components/responses/500"
rameshnaraya
committed
503:
$ref: "../responses/SOL005_resp.yaml#/components/responses/503"
504:
$ref: "../responses/SOL005_resp.yaml#/components/responses/504"
moscatelli
committed
delete:
summary: Delete an individual PNF descriptor resource.
The DELETE method deletes an individual PNF descriptor resource.
An individual PNF descriptor resource can only be deleted when t
here is no NS instance using it or there is NSD referencing it.
To delete all PNFD versions identified by a particular value of
the "pnfdInvariantId" attribute, the procedure is to first use t
he GET method with filter "pnfdInvariantId" towards the PNF
descriptors resource to find all versions of the PNFD. Then,
he API consumer uses the DELETE method described in this clause
to delete each PNFD version individually.
This method shall follow the provisions specified in the Tables
5.4.6.3.5-1 and 5.4.6.3.5-2 for URI query parameters, request
and response data structures, and response codes.
$ref: '#/components/responses/IndividualPnfDescriptor.Delete.200'
$ref: "../responses/SOL005_resp.yaml#/components/responses/400"
$ref: "../responses/SOL005_resp.yaml#/components/responses/401"
$ref: "../responses/SOL005_resp.yaml#/components/responses/403"
$ref: "../responses/SOL005_resp.yaml#/components/responses/404"
$ref: "../responses/SOL005_resp.yaml#/components/responses/405"
$ref: "../responses/SOL005_resp.yaml#/components/responses/406"
$ref: "../responses/SOL005_resp.yaml#/components/responses/500"
$ref: "../responses/SOL005_resp.yaml#/components/responses/503"
504:
$ref: "../responses/SOL005_resp.yaml#/components/responses/504"
moscatelli
committed
###############################################################################
moscatelli
committed
###############################################################################
/pnf_descriptors/{pnfdInfoId}/pnfd_content:
#ETSI GS NFV-SOL 005 V2.4.1 location: 5.4.7
parameters:
- $ref: '#/components/parameters/PnfdInfoId'
- $ref: ../components/SOL005_params.yaml#/components/parameters/Authorization
- $ref: ../components/SOL005_params.yaml#/components/parameters/Version
The GET method fetches the content of the PNFD archive.
The content of the PNFD archive is provided as onboarded,
i.e. depending on the security option used, the CSAR or
the CSAR wrapped in a ZIP archive together with an external
signature is returned, as defined in clause 5.1 of ETSI GS NFV-SOL 004.
NOTE: Information about the applicable security option can be obtained
by evaluating the "archiveSecurityOption" attribute in the "pnfdInfo" structure.
This method shall follow the provisions specified in the Tables 5.4.7.3.2-1
and 5.4.7.3.2-2 for URI query parameters, request and response data structures,
and response codes.
- $ref: '#/components/parameters/AcceptText'
- $ref: ../components/SOL005_params.yaml#/components/parameters/Range
$ref: '#/components/responses/PnfdArchiveContent.Get.200'
$ref: '#/components/responses/PnfdArchiveContent.Get.206'
rameshnaraya
committed
400:
$ref: "../responses/SOL005_resp.yaml#/components/responses/400"
rameshnaraya
committed
401:
$ref: "../responses/SOL005_resp.yaml#/components/responses/401"
rameshnaraya
committed
403:
$ref: "../responses/SOL005_resp.yaml#/components/responses/403"
rameshnaraya
committed
404:
$ref: "../responses/SOL005_resp.yaml#/components/responses/404"
rameshnaraya
committed
405:
$ref: "../responses/SOL005_resp.yaml#/components/responses/405"
rameshnaraya
committed
406:
$ref: "../responses/SOL005_resp.yaml#/components/responses/406"
rameshnaraya
committed
409:
Samir Medjiah
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 pnfdOnboardingState
# has a value different from ONBOARDED.
# The response body shall contain a ProblemDetails
# structure, in which the "detail" attribute shall convey
# more information about the error.
$ref: "../responses/SOL005_resp.yaml#/components/responses/409"
$ref: "../responses/SOL005_resp.yaml#/components/responses/416"
rameshnaraya
committed
500:
$ref: "../responses/SOL005_resp.yaml#/components/responses/500"
rameshnaraya
committed
503:
$ref: "../responses/SOL005_resp.yaml#/components/responses/503"
504:
$ref: "../responses/SOL005_resp.yaml#/components/responses/504"
summary: Upload the content of a PNFD.
The PUT method is used to upload the content of a PNFD archive.
This resource represents the content of the individual PNF descriptor, i.e. PNFD content.
The client can use this resource to upload and download the content of the PNFD.
- $ref: '#/components/parameters/AcceptText'
- $ref: '#/components/parameters/ContentTypeZip'
$ref: '#/components/responses/PnfdArchiveContent.Put.200'