Versions Compared

Key

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

...

Drawio
bordertrue
viewerToolbartrue
fitWindowfalse
diagramDisplayNameExternalAPI System Context View
lboxtrue
revision57
diagramNameExternalAPI System Context View
simpleViewerfalse
width600
linksauto
tbstyletop
diagramWidth492

...

External API exposes ONAPs capabilities through defined TMF standardized interfaces.  Enables It enables ONAP to be viewed as a "black box"hide the internal API.


It provides

  • Exposes the ONAP service catalogue capabilities

  • Exposes the ONAP inventory capabiliteiscapabilities

  • Exposes ONAP Service Ordering capabilities

  • Interaces Interfaces to manage subscription to ExternalAPI events 

2. API definitions

Extenal External API provides the following interfaces:

Interface NameInterface Definition Interface Capabilities
ExternalAPIE-1 NBI Management Interface

Retrieve the avaible NBIS and Validates the health of a NBI interfaceProvides a healthcheck to verify that the NBI component is running fine


Provides:
  • Discover NBI services
  • Request a healthcheck Healthcheck of a NBI service
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 hub
  • List notification hubs
  • Retrieve a notification hub
  • Listen to notifications
ExternalAPIE-3 Service Catalogue Interface Find service specifications that can be instantiated

 Provides:

  • Search for services in the catalogue (with filters)
  • Retrieve a service specificaiton specification from the catalogue
  • Create a service (course grain action)
ExternalAPIE-4 Service Ording Ordering Interface Request the instantiation of a service

 Provides

  • Search for service orders
  • Retrieve a service order
  • Request a service instantiation
ExternalAPIE-5 Service Inventory Interface Query information about instantiated services Provides
  • Search for instantiated Services
  • Retrieve information about an instantiated order

...

Interface NamePurpose Reason For Use
SDCE-6To receive the notifications of a new service.
SDCE-7To query the catalogue for service specifications 
SOE-X To request a service instantiation 
AAIE-1 To query the instantiated services 
MSBE-1Register NBI API
DMAAPE-1

Poll 2 topics:

AAI events

SDC events


3. Component Description:

...

<< For later inclusion >>

Image RemovedImage Added

4.

...

Known system limitations

  • FFS


5. Used Models

ExternalAPI uses the following models:

...

6. System Deployment Architecture

ExternalAPI consists of 1 containers:

  • ExternalAPI

...


This needs to be updated

7. New Capabilities in this Release

This release, ExternalAPI adds the following Capabilities:

...

...

8. References

  1. External API architecture: https://docs.onap.org/en/casablancalatest/submodules/externalapi/nbi.git/docs/architecturereleasenotes/architecturereleasenotes.html
  2. External API interface: https://docs.onap.org/en/casablanca/_downloads/8cce799c6c8f3f5916f265c52ab60ba7/nbicallflow.pdf 

...