Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

1- Brief Project Overview (brief as it should be known)

NBI stands for NorthBound Interface. It brings to ONAP a set of APIs that can be used by external systems such BSS for example. These APIs are based on TMForum and MEF APIs

2- New component capabilities for Honolulu-R8, i.e. the functional enhancements, if applicable

There are no planned Enhancement features for Honolulu, minor bug fix only.

3- New or modified interfaces

None

4- If they are modified, are they backwards compatible?

Not applicable, no modifications

6- Interface naming (point to an example)

https://docs.onap.org/projects/onap-externalapi-nbi/en/latest/

...

architecture/

...

architecture.html

7- Consumed API from other projects

...

Project

...

API Dependency

...

Notes

APi Specs

https://docs.onap.org/projects/onap-externalapi-nbi/en/latest/consumedapis/consumedapis.html


8- Published API

https://docs.onap.org/projects/onap-externalapi-nbi/en/latest/offeredapis/offeredapis.html


9- Reference to the interfaces.

External API provides the following interfaces:

Interface Name

Interface Definition

 Interface Capabilities

API Spec (Swagger)

...

Project

...

API

...

Notes

...

APi Specs

(Swagger)

9- Reference to the interfaces.

...

ExternalAPIE-1 NBI Management Interface

Provides a healthcheck to verify that the NBI component is running fine


Provides:
  • Healthcheck of a NBI service
https://docs.onap.org/projects/onap-externalapi-nbi/en/latest/_downloads/350675a49dbe01d7970309dac13aaa30/swagger.json
ExternalAPIE-2 Subscription Management Interface

Provides the ability to subscribe to and unsubscribe from External API events.

(also known as the External API Hub interface) 

Provides:
  • Create/Delete a Notification
  • List notification
  • Retrieve a notification
  • Listen to notifications
https://docs.onap.org/projects/onap-externalapi-nbi/en/latest/_downloads/7a0359a1069cff9bb3f7db69109b5294/swagger.json
ExternalAPIE-3 Service Catalogue Interface Find service specifications that can be instantiated

 Provides:

  • Search for services in the catalogue (with filters)
  • Retrieve a service specification from the catalogue
https://docs.onap.org/projects/onap-externalapi-nbi/en/latest/_downloads/ca979e4ad0e48c22d6e62f403b4b0c7c/swagger.json
ExternalAPIE-4 Service Ordering Interface Request the instantiation of a service

 Provides

  • Search for service orders
  • Retrieve a service order
  • Request a service instantiation
https://docs.onap.org/projects/onap-externalapi-nbi/en/latest/_downloads/9450323ada78d8f7eeb360141ed68b63/swagger.json
ExternalAPIE-5 Service Inventory Interface Query information about instantiated services Provides
  • Search for instantiated Services
  • Retrieve information about an instantiated order
https://docs.onap.org/projects/onap-externalapi-nbi/en/latest/_downloads/58f285f89bb1416ea0a0ceec1e325800/swagger.json

10- What are the system limits?

No known system limit. APIs by default do not have RBAC enabled

System Requirements documented herehttps://docs.onap.org/projects/onap-externalapi-nbi/en/latest/architecture/NBI_Developer_Guide.html

11- Involved use cases, architectural capabilities or functional requirements.

No new use case support planned for Honolulu release. External API had been used in CCVPN, BBS and 5G E2E Slicing usecases in previous releases.

12- Listing of new or impacted models used by the project (for information only).

...

  • Models based on information exchanges from Use Cases

...

    • Forward looking models that may be implemented in future releases
      • Specification work for alignment between TMF 628 Performance Mgmt API enhancements per TMF/MEF for Datalake access with ONAP internal DES APIs.
  • Describe how exposed APIs are mapped to information models

(list all the relevant Jira tickets)

13-Test plan/Testing Strategy

  1. Unit

...

  1. Testing  - Junits built into code base plus 
  2. Dev-to-Dev Testing 

...

  1. - wiremock 
  2. Integration - Health check API includes consumed APIs from other components integration checks 


14- Any other details that are specific to this functional enhancement or UseCase.

  1. Project Overview

NBI stands for NorthBound Interface. It brings to ONAP a set of APIs that can be used by external systems such BSS for example. These APIs are based on TMForum and MEF APIs 

  1. Improvement to external swagger documentation with reference to ONAP API style guidelines

  1. New or modified interfaces

    1. Modified : Service Order - additional internal support for macromode and activate/deactivate SO APIs

...

Reference to the interfaces

  1. Latest documentation and swagger available on latest readthedoc https://docs.onap.org/projects/onap-externalapi-nbi/en/latest/offeredapis/offeredapis.html 

System limits

...

Involved use cases, architectural capabilities or functional requirements

  1. 5G E2E Slicing usecase usecase

    1. service order  ( activate/deactivate service ) 5GNetworkSlicing_ExtAPI_20200610_v1.0.pptx small modification to support activate/deactivate and macromode.

...

Listing of new or impacted models used by the project (for information only)

  1. none

...

Diagram

...

      N/A minor clean up changes only