API specifications: Difference between revisions

Latest revision as of 08:47, 26 November 2020

API conventions

ETSI GS NFV-SOL 015 defines patterns and conventions for RESTful NFV-MANO API specifications, gives recommendations on API versioning and provides an API specification template. This GS defines provisions to be followed by the ETSI NFV Industry Specification Group (ISG) when creating RESTful NFV-MANO API specifications. The provisions do not apply to implementations.

API specifications

ETSI NFV Management and Orchestration (NFV-MANO) Core APIs
	APIs	Published Versions	Bug Tracker
NFV-SOL 002 (Ve-Vnfm)	VNF Lifecycle Management interface (as produced by the VNFM towards the EM/VNF) VNF Performance Management interface (as produced by the VNFM towards the EM) VNF Fault Management interface (as produced by the VNFM towards the EM) VNF Indicator interface (as produced by the EM/VNF towards the VNFM) VNF Configuration interface (as produced by the VNF towards the VNFM) VNF LCM Coordination interface (as produced by the VNF/EM) - Release 3 only VNFC Snapshot Package Management interface (as produced by the VNFM) - Release 3 only This specification fulfils the requirements specified in ETSI GS NFV-IFA 008	Published specifications	Issue Tracker
NFV-SOL 003 (Or-Vnfm)	VNF Lifecycle Management interface (as produced by the VNFM towards the NFVO). VNF Performance Management interface (as produced by the VNFM towards the NFVO). VNF Fault Management interface (as produced by the VNFM towards the NFVO). VNF Indicator interface (as produced by the VNFM towards the NFVO). VNF Lifecycle Operation Granting interface (as produced by the NFVO towards the VNFM). VNF Package Management interface (as produced by the NFVO towards the VNFM). Virtualised Resources Quota Available Notification interface (as produced by the NFVO towards the VNFM). VNF Snapshot Package Management interface (as produced by the VNFM) - Release 3 only This specification fulfils the requirements specified in ETSI GS NFV-IFA 007	Published specifications	Issue Tracker
NFV-SOL 005 (Os-Ma-Nfvo)	NSD Management interface (as produced by the NFVO towards the OSS/BSS) NS Lifecycle Management interface (as produced by the NFVO towards the OSS/BSS) NS Performance Management interface (as produced by the NFVO towards the OSS/BSS) NS Fault Management interface (as produced by the NFVO towards the OSS/BSS) VNF Package Management interface (as produced by the NFVO towards the OSS/BSS) NFVI Capacity Information interface (as produced by the NFVO) - Release 3 only VNF Snapshot Package Management interface (as produced by the NFVO) - Release 3 only LCM Coordination interface (as produced by the OSS/BSS) - Release 3 only This specification fulfils the requirements specified in ETSI GS NFV-IFA 013	Published specifications	Issue Tracker

Note that ETSI GS NFV-SOL 013 and ETSI GS NFV-SEC 022 complement the aforementioned specifications with common procedures (e.g. version management) and security aspects, respectively.

Draft specifications under development are available at https://docbox.etsi.org/ISG/NFV/Open/Drafts

Other ETSI NFV Management and Orchestration (NFV-MANO) APIs
	APIs	Published Versions	Bug Tracker
NFV-SOL 009 (MANO management)	NFV-MANO configuration and information management interface NFV-MANO performance management interface NFV-MANO Fault Management interface NFV-MANO log management interface This specification fulfils the requirements specified in ETSI GS NFV-IFA 031	Published specifications	Issue Tracker
NFV-SOL 011 (Or-Or)	VNF Lifecycle Management interface (as produced by the VNFM towards the NFVO). VNF Performance Management interface (as produced by the VNFM towards the NFVO). VNF Fault Management interface (as produced by the VNFM towards the NFVO). VNF Indicator interface (as produced by the VNFM towards the NFVO). VNF Lifecycle Operation Granting interface (as produced by the NFVO towards the VNFM). VNF Package Management interface (as produced by the NFVO towards the VNFM). Virtualised Resources Quota Available Notification interface (as produced by the NFVO towards the VNFM). This specification fulfils the requirements specified in ETSI GS NFV-IFA 011	Published specifications	Issue Tracker
NFV-SOL 012 (Policy Management)	Policy Management interface	Draft available	Issue Tracker

Note that ETSI GS NFV-SOL 013 and ETSI GS NFV-SEC 022 complement the aforementioned specifications with common procedures (e.g. version management) and security aspects, respectively.

Draft specifications under development are available at https://docbox.etsi.org/ISG/NFV/Open/Drafts

OpenAPIs

For each of the APIs specified in the aforementionned documents, an OpenAPI representation is made available on the ETSI Forge Server. These representations, along with developement guidelines, can be found here.

Conformance testing

Conformance tests for APIs are specified in ETSI GS NFV-TST 010. The Robot code for all test cases is available on the ETSI Forge

Tutorials

Links to tutorials and webinars

Link

Return to NFV Solutions page

Return to ETSI ISG NFV page

@@ Line 1: / Line 1: @@
 == API conventions==
-[https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/015/_-_RESTful_API_Patterns_and_Conventions ETSI GS NFV-SOL 015] defines patterns and conventions for RESTful NFV-MANO API specifications, gives recommendations on API versioning and provides an API specification template. This GS defines provisions to be followed by the ETSI NFV Industry Specification Group (ISG) when creating RESTful NFV-MANO API specifications. The provisions do not apply to implementations.
+[https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/015/ ETSI GS NFV-SOL 015] defines patterns and conventions for RESTful NFV-MANO API specifications, gives recommendations on API versioning and provides an API specification template. This GS defines provisions to be followed by the ETSI NFV Industry Specification Group (ISG) when creating RESTful NFV-MANO API specifications. The provisions do not apply to implementations.
 == API specifications ==
@@ Line 56: / Line 56: @@
 This specification fulfils the requirements specified in [http://www.etsi.org/deliver/etsi_gs/NFV-IFA/001_099/007/ ETSI GS NFV-IFA 007]
-  | [http://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/003/02.05.01_60/gs_nfv-sol003v020501p.pdf Published specifications]
+  | [http://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/003/ Published specifications]
   | [http://forge.etsi.org/mantis/set_project.php?project_id=153;218&make_default=no&ref=view_all_bug_page.php Issue Tracker]
   |-
@@ Line 145: / Line 145: @@
 Note that [https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/013/ ETSI GS NFV-SOL 013] and [https://www.etsi.org/deliver/etsi_gs/NFV-SEC/001_099/022/ ETSI GS NFV-SEC 022] complement the aforementioned specifications with common procedures (e.g. version management) and security aspects, respectively.
 Draft specifications under development are available at https://docbox.etsi.org/ISG/NFV/Open/Drafts
 == OpenAPIs ==
-For each of the APIs specified in the aforementionned documents, an OpenAPI representationi s made available on the ETSI Forge Server. These representations, along with developement guidelines, can be found [[SOL OpenAPI Main Page|here]].
+For each of the APIs specified in the aforementionned documents, an OpenAPI representation is made available on the ETSI Forge Server. These representations, along with developement guidelines, can be found [[SOL_OpenAPI_Representations|here]].
+== Conformance testing ==
+Conformance tests for APIs are specified in [https://www.etsi.org/deliver/etsi_gs/NFV-TST/001_099/010/ ETSI GS NFV-TST 010]. The Robot code for all test cases is available on the [https://forge.etsi.org/rep/nfv/ ETSI Forge]
 == Tutorials ==