ARC ExternalAPI Component Description - Guilin (R7) Rlease (Copy)
Page Status: Copied from R6 - Mar, 22, 2020
Component Status: Pending PTL Updates and ArchCom Review
Last Reviewed on:
Certified by:
External API:
1 High Level Component Definition and Architectural Relationships
External API exposes ONAPs capabilities through TMF standardized interfaces. It enables ONAP to hide the internal API.
It provides
Exposes the ONAP service catalogue capabilities
Exposes the ONAP inventory capabilities
Exposes ONAP Service Ordering capabilities
Interfaces to manage subscription to ExternalAPI events
2. API definitions
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:
| |
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:
| |
ExternalAPIE-3 Service Catalogue Interface | Find service specifications that can be instantiated | Provides:
| |
ExternalAPIE-4 Service Ordering Interface | Request the instantiation of a service | Provides
| |
ExternalAPIE-5 Service Inventory Interface | Query information about instantiated services | Provides
|
Note: xxxI interface is a Component internal interface. xxxxE interface is a component external interface
The current API documents can be found at:
External API interface: https://docs.onap.org/en/casablanca/_downloads/8cce799c6c8f3f5916f265c52ab60ba7/nbicallflow.pdf
ExternalAPI consumes the following Interfaces:
Interface Name | Purpose Reason For Use | API Spec (Swagger) |
---|---|---|
SDCE-6 | To receive the notifications of a new service. | |
SDCE-7 | To query the catalogue for service specifications | |
SOE-X | To request a service instantiation | |
AAIE-1 | To query the instantiated services | |
MSBE-1 | Register NBI API | |
DMAAPE-1 | Poll 2 topics: AAI events SDC events |
3. Component Description:
A more detailed figure and description of the component.
<< For later inclusion >>
4. Known system limitations
FFS
5. Used Models
ExternalAPI uses the following models:
-
6. System Deployment Architecture
7. New Capabilities in this Release
8. References
External API architecture: https://docs.onap.org/en/latest/submodules/externalapi/nbi.git/docs/releasenotes/releasenotes.html
External API interface: https://docs.onap.org/en/casablanca/_downloads/8cce799c6c8f3f5916f265c52ab60ba7/nbicallflow.pdf