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

...

  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

...

, 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

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)

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/

...

System limits

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

...

  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.

.

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)

...

  1. none

...

Diagram

...

.

  • 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

13-Test plan/Testing Strategy

  1. Unit Testing  - Junits built into code base plus 
  2. Dev-to-Dev Testing  - wiremock 
  3. 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.

      N/A minor clean up changes only