...
Interface Name | Interface Definition | Interface Capabilities | Version | Status | API Spec (Swagger) | ||
---|---|---|---|---|---|---|---|
AAIE-1 | Inventory Service Interface. CRUD & Queries | An interface to create, update, retrieve, query, delete the service, resources and relationship inventory information for:
AAI also provides Inventory History information | v16 | provides multiple interfaces to use canned queries, dynamic queries (DSL), and CRUD operations (Resources) | v20 | AAI XSD | |
AAIE-2 | AAI Graphical User Interfaces | Provides the capability to view the inventory |
...
The current API documents can be found at:
- AAI REST Guilin API Documentation - Dublin
- AAI GUI: AAI Graphical User Interface
...
Interface Name | Purpose Reason For Use | API Spec (Swagger) |
---|---|---|
SDCE-6 | To receive the service and resource artifacts from SDC. | N/A No exposed Interface |
3. Component Description:
...
4. known system limitations
- Eventually consistent database (CAP Theorem - Performance over Consistency) - see Warning! AAI REST API Not Safe With Concurrent Access (i.e. more than 1 REST client)
- Basic issue is when running multiple instances and calls are made to the same objects concurrently, there runs the risk of creating duplicates or ghost vertices, see https://docs.janusgraph.org/advanced-topics/eventual-consistency/ for more
- We have provided a sticky config in HAProxy, to keep clients operating on the same instance for X mins and data grooming (via GraphAdmin) to clean up bad data
5. Used Models
AAI uses the following models:
...
This release, AAI adds the following Capabilities:
- No new platform functionality in Guilin
- Use Cases supported: AAI R7 Guilin Release: Functional Use Cases-
8. References
- AAI Guilin API Documentation
- AAI read the docs: https://docs.onap.org/en/casablanca/submodules/aai/aai-common.git/docs/index.html?highlight=AAI
- AAI REST API Documentation - Dublin
- AAI GUI: AAI Graphical User Interface
...