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://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL015_-_RESTful_API_Patterns_and_Conventions ETSI GS NFV-SOL 015] (draft) 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 ==
   {| class="wikitable alternance center"
-  |+ ETSI NFV Management and Orchestration (NFV-MANO) APIs - Release 2
+  |+ ETSI NFV Management and Orchestration (NFV-MANO) Core APIs
   |-
   |
   ! scope="col" | APIs
   ! scope="col" | Published Versions
- ! scope="col" | Latest Drafts
   ! scope="col" | Bug Tracker
- ! scope="col" | Draft OpenAPI
   |-
@@ Line 28: / Line 26: @@
 VNF Configuration interface (as produced by the VNF towards the VNFM)
-This specification fulfills the requirements specified in [http://www.etsi.org/deliver/etsi_gs/NFV-IFA/001_099/008/ ETSI GS NFV-IFA 008]
+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 [http://www.etsi.org/deliver/etsi_gs/NFV-IFA/001_099/008/ ETSI GS NFV-IFA 008]
   | [http://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/002/ Published specifications]
- | [https://docbox.etsi.org/ISG/NFV/Open/Drafts/ Draft]
   | [http://forge.etsi.org/mantis/set_project.php?project_id=153;217&make_default=no&ref=view_all_bug_page.php Issue Tracker]
- | [https://forge.etsi.org/gitlab/nfv/SOL002-SOL003 Git repository]
   |-
   ! scope="row" | NFV-SOL 003
@@ Line 52: / Line 52: @@
 Virtualised Resources Quota Available Notification interface (as produced by the NFVO towards the VNFM).
-This specification fulfills the requirements specified in [http://www.etsi.org/deliver/etsi_gs/NFV-IFA/001_099/007/ ETSI GS NFV-IFA 007]
+VNF Snapshot Package Management interface (as produced by  the VNFM) - Release 3 only
+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]
- | [https://docbox.etsi.org/ISG/NFV/Open/Drafts/ Draft]
   | [http://forge.etsi.org/mantis/set_project.php?project_id=153;218&make_default=no&ref=view_all_bug_page.php Issue Tracker]
- | [https://forge.etsi.org/gitlab/nfv/SOL002-SOL003 Git repository]
   |-
   ! scope="row" | NFV-SOL 005
@@ Line 72: / Line 72: @@
 VNF Package Management interface (as produced by the NFVO towards the OSS/BSS)
-This specification fulfills the requirements specified in [http://www.etsi.org/deliver/etsi_gs/NFV-IFA/001_099/013/ ETSI GS NFV-IFA 013]
+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 [http://www.etsi.org/deliver/etsi_gs/NFV-IFA/001_099/013/ ETSI GS NFV-IFA 013]
   | [http://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/ Published specifications]
- | [https://docbox.etsi.org/ISG/NFV/Open/Drafts/ Draft]
   | [http://forge.etsi.org/mantis/set_project.php?project_id=153;227&make_default=no&ref=view_all_bug_page.php Issue Tracker]
- | [https://forge.etsi.org/gitlab/nfv/SOL005/ Git repository]
   |}
 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
+ {| class="wikitable alternance center"
+ |+ Other ETSI NFV Management and Orchestration (NFV-MANO) APIs
+ |-
+ |
+ ! scope="col" | APIs
+ ! scope="col" | Published Versions
+ ! scope="col" | Bug Tracker
+ |-
+ ! scope="row" | NFV-SOL 009
+(MANO management)   <br>
+ | align="left" |
+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 [http://www.etsi.org/deliver/etsi_gs/NFV-IFA/001_099/031/ ETSI GS NFV-IFA 031]
+ | [http://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/009/ Published specifications]
+ | [http://tinyurl.com/t9dhvpq Issue Tracker]
+ |-
+ ! scope="row" | NFV-SOL 011
+(Or-Or)
+ | align="left" |
+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 [http://www.etsi.org/deliver/etsi_gs/NFV-IFA/001_099/007/ ETSI GS NFV-IFA 011]
+ | [http://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/003/02.05.01_60/gs_nfv-sol003v020501p.pdf Published specifications]
+ | [http://tinyurl.com/wgdrdb6 Issue Tracker]
+ |-
+ ! scope="row" | NFV-SOL 012
+(Policy Management)   <br>
+ | align="left" |
+Policy Management interface
+ | [https://docbox.etsi.org/ISG/NFV/Open/Drafts/SOL012ed331_Protocol_Spec_for_Policy_Mgmt_Intface Draft available]
+ | [http://oldforge.etsi.org/mantis/search.php?project_id=256&sticky_issues=off&sortby=last_updated&dir=DESC&hide_status_id=-2&match_type=0 Issue Tracker]
+ |}
+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 [[SOL OpenAPI Main Page|OpenAPI representation]]<nowiki/>is 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 ==