API specifications: Difference between revisions
| Line 364: | Line 364: | ||
(1) Base GS are NFV-SOL 002, NFV-SOL 003, and NFV-SOL 005. | (1) Base GS are NFV-SOL 002, NFV-SOL 003, and NFV-SOL 005. | ||
Note: | |||
* Submitters of comments are required to assign a category for their comment | |||
* After further evaluation of the comment, the project lead or delegate can re-categorize the comment in Bugzilla | |||
== Governance == | == Governance == | ||
Revision as of 09:49, 16 April 2018
API conventions
API specifications
| APIs | Latest Published Version v2.4.1 | Latest Drafts | Bug Tracker | Draft OpenAPI | |
|---|---|---|---|---|---|
| Ve-Vnfm (NFV-SOL 002) |
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) This specification fulfills the requirements specified in ETSI GS NFV-IFA 008 |
Published specification | Draft | Issue Tracker | Git repository |
| Or-Vnfm (NFV-SOL 003) |
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 fulfills the requirements specified in ETSI GS NFV-IFA 007 |
Published specification | Draft | Issue Tracker | Git repository |
| Os-Ma-Nfvo (NFV-SOL 005) |
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) This specification fulfills the requirements specified in ETSI GS NFV-IFA 013 |
Published specification | Draft | Issue Tracker | Work In Progress |
Tutorials
Links to tutorials and webinars
OpenAPIs
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.
If you found a discrepancy between the NFV Specifications and their OpenAPI description, please report it here.
How to use the links:
- The PDF column contains links to the PDF export of the API definition.
- YAML and JSON columns contain links to the raw text files. They will open a page in the browser with a lot of non readable text and they are meant to be downloaded or used as input for other tools;
- The UI column contains links to the graphical view of the interface using the Swagger UI tool hosted at the Forge. If you want to know more about the Swagger UI tool click here.
- The EDITOR column contains links to a window with both the textual and the graphical views of the interface using the Swagger Editor tool hosted at the Forge. If you want to know more about the Swagger Editor tool click here.
| Interface | Ref Point | Producer | YAML | JSON | UI | EDITOR | |
|---|---|---|---|---|---|---|---|
| SOL002-VNFConfiguration-API | Ve-Vnfm | VNF | Link | Link | Link | Link | Link |
| SOL002-VNFIndicator-API | Ve-Vnfm | VNF/EM | Link | Link | Link | Link | Link |
| SOL002-VNFIndicatorNotification-API | Ve-Vnfm | VNFM | Link | Link | Link | Link | Link |
| SOL002-VNFFaultManagement-API | Ve-Vnfm | VNFM | Link | Link | Link | Link | Link |
| SOL002-VNFLifecycleManagement-API | Ve-Vnfm | VNFM | Link | Link | Link | Link | Link |
| SOL002-VNFPerformanceManagement-API | Ve-Vnfm | VNFM | Link | Link | Link | Link | Link |
| SOL003-VirtualisedResourcesQuotaAvailableNotification-API | Or-Vnfm | NFVO | Link | Link | Link | Link | Link |
| SOL003-VNFFaultManagement-API | Or-Vnfm | VNFM | Link | Link | Link | Link | Link |
| SOL003-VNFFaultManagementNotification-API | Or-Vnfm | NFVO | Link | Link | Link | Link | Link |
| SOL003-VNFIndicator-API | Or-Vnfm | VNFM | Link | Link | Link | Link | Link |
| SOL003-VNFIndicatorNotification-API | Or-Vnfm | NFVO | Link | Link | Link | Link | Link |
| SOL003-VNFLifecycleManagement-API | Or-Vnfm | VNFM | Link | Link | Link | Link | Link |
| SOL003-VNFLifecycleOperationGranting-API | Or-Vnfm | NFVO | Link | Link | Link | Link | Link |
| SOL003-VNFPackageManagement-API | Or-Vnfm | NFVO | Link | Link | Link | Link | Link |
| SOL003-VNFPackageManagementNotification-API | Or-Vnfm | VNFM | Link | Link | Link | Link | Link |
| SOL003-VNFPerformanceManagement-API | Or-Vnfm | VNFM | Link | Link | Link | Link | Link |
| SOL003-VNFPerformanceManagementNotification-API | Or-Vnfm | NFVO | Link | Link | Link | Link | Link |
| SOL005-NSDManagement-API | Os-Ma | NFVO | Link | Link | Link | Link | Link |
| SOL005-NSLifecycleManagement-API | Os-Ma | NFVO | Link | Link | Link | Link | Link |
| SOL005-NSFaultManagement-API | Os-Ma | NFVO | Link | Link | Link | Link | Link |
| SOL005-VNFPackageManagement-API | Os-Ma | NFVO | Link | Link | Link | Link | Link |
Report issues and feedback
Instructions for the user:
- Log in at the Forge (at https://forge.etsi.org/index.php/users/login )
- Note that non-ETSI members can also report a comment by registering on Forge to get an account
- Navigate to the link above in the center
- Fill in the information for the issue (summary and description)
- Click the “Submit Comment” button
The current OpenAPI comment list is available here.
The link to create a new comment is currently advertised in the following pages:
- https://nfvwiki.etsi.org/index.php?title=API_specifications#OpenAPIs
- https://forge.etsi.org/rep/gitweb.cgi/NFV-SOL002-SOL003.git/tree
- And at the beginning of each OpenAPI file.
Please file your reports in the Bugzilla. Use the following categories for your issues:
| Category | Short name | Description | OpenAPI Bug? |
|---|---|---|---|
| 1 | Functionality missing in the OpenAPI | Functionality bug
representation compared to the base GS* (e.g., SOL003),Ex. Missing resource, missing attribute |
yes |
| 2 | Syntax bug | Errors in the OpenAPI representation or textual description
errors,Ex: “Integer” instead of “String”, cardinality incorrect or missing |
yes |
| 3 | Suggestion | Suggested functionality to be included in
the OpenAPI,Ex. A new base GS* feature/capability is suggested |
no |
| 4 | No Spec | The OpenAPI is designed beyond the scope of the base
GS (1) |
yes |
| 5 | Comment | General comments on the OpenAPI | no |
(1) Base GS are NFV-SOL 002, NFV-SOL 003, and NFV-SOL 005.
Note:
- Submitters of comments are required to assign a category for their comment
- After further evaluation of the comment, the project lead or delegate can re-categorize the comment in Bugzilla
Governance
Why the governance is needed?
- OpenAPI governance is needed to ensure
- Comments on the OpenAPIs can be reported
- Categorization of the comments
- Timeliness for resolving OpenAPI comments
- Accountability (who is responsible for resolving)
- Provide added value for the consumers of ETSI NFV API specifications and foster adoption