API specifications: Difference between revisions

From NFVwiki
No edit summary
Line 85: Line 85:
*[https://www.brighttalk.com/webcast/6985/263719/common-api-for-nfv-interop  Webinar on APIs for interoperability]
*[https://www.brighttalk.com/webcast/6985/263719/common-api-for-nfv-interop  Webinar on APIs for interoperability]
*[https://play.webvideocore.net/popplayer.php?it=6dq6y2ugg9c8&c1=%23c8c8c8&c2=%23a6a6a6&w=720&h=505&p=0&title=123LIVE%21+%3A+Common+API+for+NFV+%7C+Bruno+Chatras+%7C+Orange Tutorial at SDN NFV World Congress, Nov 2017]
*[https://play.webvideocore.net/popplayer.php?it=6dq6y2ugg9c8&c1=%23c8c8c8&c2=%23a6a6a6&w=720&h=505&p=0&title=123LIVE%21+%3A+Common+API+for+NFV+%7C+Bruno+Chatras+%7C+Orange Tutorial at SDN NFV World Congress, Nov 2017]
== OpenAPIs ==
<center>
<big>
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
[https://forge.etsi.org/bugzilla/enter_bug.cgi?product=NFV here.]
</big>
</center>
How to use the links:
<div style="color:red">=> '''Beginners are recommended to start navigating the links in the UI column'''.</div>
* '''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 [https://swagger.io/swagger-ui/ 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 [https://swagger.io/swagger-editor/ click here].
<big>
{| class="wikitable sortable center"
! Interface
! Specification
! API Producer
! YAML (raw)
! JSON (raw)
! Swagger UI
! Swagger Editor
|-
| SOL002-VNFConfiguration-API
| SOL002
| VNF
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL002-VNFConfiguration-API.yaml/*view*/ Link]
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL002-VNFConfiguration-API.json/*view*/ Link]
| [https://forge.etsi.org/swagger/ui?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL002-VNFConfiguration-API.yaml/*view*/ Link]
| [https://forge.etsi.org/swagger/editor?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL002-VNFConfiguration-API.yaml/*view*/ Link]
|-
| SOL002-VNFIndicator-API
| SOL002
| VNF/EM
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL002-VNFIndicator-API.yaml/*view*/ Link]
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL002-VNFIndicator-API.json/*view*/ Link]
| [https://forge.etsi.org/swagger/ui?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL002-VNFIndicator-API.yaml/*view*/ Link]
| [https://forge.etsi.org/swagger/editor?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL002-VNFIndicator-API.yaml/*view*/ Link]
|-
| SOL002-VNFIndicatorNotification-API
| SOL002
| VNFM
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL002-VNFIndicatorNotification-API.yaml/*view*/ Link]
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL002-VNFIndicatorNotification-API.json/*view*/ Link]
| [https://forge.etsi.org/swagger/ui?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL002-VNFIndicatorNotification-API.yaml/*view*/ Link]
| [https://forge.etsi.org/swagger/editor?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL002-VNFIndicatorNotification-API.yaml/*view*/ Link]
|-
| SOL003-VirtualisedResourcesQuotaAvailableNotification-API
| SOL003
| NFVO
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VirtualisedResourcesQuotaAvailableNotification-API.yaml/*view*/ Link]
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VirtualisedResourcesQuotaAvailableNotification-API.json/*view*/ Link]
| [https://forge.etsi.org/swagger/ui?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VirtualisedResourcesQuotaAvailableNotification-API.yaml/*view*/ Link]
| [https://forge.etsi.org/swagger/editor?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VirtualisedResourcesQuotaAvailableNotification-API.yaml/*view*/ Link]
|-
| SOL003-VNFFaultManagement-API
| SOL003
| VNFM
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFFaultManagement-API.yaml/*view*/ Link]
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFFaultManagement-API.json/*view*/ Link]
| [https://forge.etsi.org/swagger/ui?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFFaultManagement-API.yaml/*view*/ Link]
| [https://forge.etsi.org/swagger/editor?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFFaultManagement-API.yaml/*view*/ Link]
|-
| SOL003-VNFFaultManagementNotification-API
| SOL003
| NFVO
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFFaultManagementNotification-API.yaml/*view*/ Link]
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFFaultManagementNotification-API.json/*view*/ Link]
| [https://forge.etsi.org/swagger/ui?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFFaultManagementNotification-API.yaml/*view*/ Link]
| [https://forge.etsi.org/swagger/editor?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFFaultManagementNotification-API.yaml/*view*/ Link]
|-
| SOL003-VNFIndicator-API
| SOL003
| VNFM
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFIndicator-API.yaml/*view*/ Link]
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFIndicator-API.json/*view*/ Link]
| [https://forge.etsi.org/swagger/ui?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFIndicator-API.yaml/*view*/ Link]
| [https://forge.etsi.org/swagger/editor?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFIndicator-API.yaml/*view*/ Link]
|-
| SOL003-VNFIndicatorNotification-API
| SOL003
| NFVO
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFIndicatorNotification-API.yaml/*view*/ Link]
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFIndicatorNotification-API.json/*view*/ Link]
| [https://forge.etsi.org/swagger/ui?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFIndicatorNotification-API.yaml/*view*/ Link]
| [https://forge.etsi.org/swagger/editor?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFIndicatorNotification-API.yaml/*view*/ Link]
|-
| SOL003-VNFLifecycleManagement-API
| SOL003
| VNFM
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFLifecycleManagement-API.yaml/*view*/ Link]
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFLifecycleManagement-API.json/*view*/ Link]
| [https://forge.etsi.org/swagger/ui?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFLifecycleManagement-API.yaml/*view*/ Link]
| [https://forge.etsi.org/swagger/editor?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFLifecycleManagement-API.yaml/*view*/ Link]
|-
| SOL003-VNFLifecycleOperationGranting-API
| SOL003
| NFVO
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFLifecycleOperationGranting-API.yaml/*view*/ Link]
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFLifecycleOperationGranting-API.json/*view*/ Link]
| [https://forge.etsi.org/swagger/ui?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFLifecycleOperationGranting-API.yaml/*view*/ Link]
| [https://forge.etsi.org/swagger/editor?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFLifecycleOperationGranting-API.yaml/*view*/ Link]
|-
| SOL003-VNFPackageManagement-API
| SOL003
| NFVO
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFPackageManagement-API.yaml/*view*/ Link]
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFPackageManagement-API.json/*view*/ Link]
| [https://forge.etsi.org/swagger/ui?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFPackageManagement-API.yaml/*view*/ Link]
| [https://forge.etsi.org/swagger/editor?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFPackageManagement-API.yaml/*view*/ Link]
|-
| SOL003-VNFPackageManagementNotification-API
| SOL003
| VNFM
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFPackageManagementNotification-API.yaml/*view*/ Link]
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFPackageManagementNotification-API.json/*view*/ Link]
| [https://forge.etsi.org/swagger/ui?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFPackageManagementNotification-API.yaml/*view*/ Link]
| [https://forge.etsi.org/swagger/editor?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFPackageManagementNotification-API.yaml/*view*/ Link]
|-
| SOL003-VNFPerformanceManagement-API
| SOL003
| VNFM
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFPerformanceManagement-API.yaml/*view*/ Link]
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFPerformanceManagement-API.json/*view*/ Link]
| [https://forge.etsi.org/swagger/ui?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFPerformanceManagement-API.yaml/*view*/ Link]
| [https://forge.etsi.org/swagger/editor?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFPerformanceManagement-API.yaml/*view*/ Link]
|-
| SOL003-VNFPerformanceManagementNotification-API
| SOL003
| NFVO
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFPerformanceManagementNotification-API.yaml/*view*/ Link]
| [https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFPerformanceManagementNotification-API.json/*view*/ Link]
| [https://forge.etsi.org/swagger/ui?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFPerformanceManagementNotification-API.yaml/*view*/ Link]
| [https://forge.etsi.org/swagger/editor?url=https://forge.etsi.org/jenkins/job/NFV%20-%20Network%20Functions%20Virtualisation/job/sol002-sol003-master/lastSuccessfulBuild/artifact/build/SOL003-VNFPerformanceManagementNotification-API.yaml/*view*/ Link]
|}
</big>


== Link ==
== Link ==

Revision as of 10:11, 22 January 2018

API conventions

API specifications

APIs exposed on MANO reference points
APIs Latest Published Version v2.3.1 Latest Drafts Bug Tracker 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

Not Applicable 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:

=> Beginners are recommended to start navigating the links in the UI column.
  • 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 Specification API Producer YAML (raw) JSON (raw) Swagger UI Swagger Editor
SOL002-VNFConfiguration-API SOL002 VNF Link Link Link Link
SOL002-VNFIndicator-API SOL002 VNF/EM Link Link Link Link
SOL002-VNFIndicatorNotification-API SOL002 VNFM Link Link Link Link
SOL003-VirtualisedResourcesQuotaAvailableNotification-API SOL003 NFVO Link Link Link Link
SOL003-VNFFaultManagement-API SOL003 VNFM Link Link Link Link
SOL003-VNFFaultManagementNotification-API SOL003 NFVO Link Link Link Link
SOL003-VNFIndicator-API SOL003 VNFM Link Link Link Link
SOL003-VNFIndicatorNotification-API SOL003 NFVO Link Link Link Link
SOL003-VNFLifecycleManagement-API SOL003 VNFM Link Link Link Link
SOL003-VNFLifecycleOperationGranting-API SOL003 NFVO Link Link Link Link
SOL003-VNFPackageManagement-API SOL003 NFVO Link Link Link Link
SOL003-VNFPackageManagementNotification-API SOL003 VNFM Link Link Link Link
SOL003-VNFPerformanceManagement-API SOL003 VNFM Link Link Link Link
SOL003-VNFPerformanceManagementNotification-API SOL003 NFVO Link Link Link Link

Link

Return to NFV Solutions page

Return to ETSI ISG NFV page