ARC VID Component Description - Honolulu-R8



Page Status: Copied from Guilin-R7 - Aug-24-2020

Component Status: Pending PTL updates and ArchCom Review

Last Reviewed on:

Certified by:



1. High Level Component Definition and Architectural Relationships

VID (Virtual Infrastructure Deployment) is a UI interface that allows the operations and network infrastructure engineers to orchestrate and change configurations related to the infrastructure expansion and maintenance.

Following is a high level orchestration component diagram that allows to show a compartmentalized view of internal VID components and shows systems that it interacts with





2. Component API definitions

VID Interacts with the following components

Interface Name

Purpose Reason For Use

Version(s)

API Spec (swagger)

Interface Name

Purpose Reason For Use

Version(s)

API Spec (swagger)

SO

Interface to Service Orchestrator (SO) for various Operations - for example orchestrating a new VNF.



SO API

SDC

Interface to Service Design Catalog (SDC) for getting Service Model



SDC API

A&AI

Interface to Active & Available Inventory (A&AI) for managing Service Instances - For example for Change Management.



AAI REST API Documentation - Honolulu









Offered APIs

Entity

Method

Path Info

Description

Entity

Method

Path Info

Description

Health Check

GET

/healthCheck

The Health Status of the application checks the DB connection.







Used by IDNS for redundancy

return response entity:
- statusCode Either 200 or 500
- detailedMsg of the result, in case of failure particular error message

Expected:

{ "statusCode": 200, "detailedMsg": "health check succeeded", "date": current date }

Health Check

GET

rest/healthCheck/{User-Agent}/{X-ECOMP-RequestID}

The Health Status of the application checks the DB connection







return response entity:
- statusCode Either 200 or 500
- detailedMsg of the result, in case of failure particular error message
- date string indicating the current date & time

Expected:

{ "statusCode": 200, "detailedMsg": "health check succeeded", "date": current date }

Commit Version

GET

/commitInfo

Displays info about the last commit of the running build







return response entity:
- commitId full id of the commit
- commitMessageShort short message from the commit
- commitTime time of the commit

Expected:

{ "commitId": id of the last commit "commitMessageShort": short message of the last commit "commitTime": time of the last commit }

Maintenance APIs



Maintenance: Category Parameters

POST

/maintenance/category_parameter/{categoryName}

Populate VID Project/Owning entity/Line of Business/Platform drop downs







{categoryName} is one of lineOfBusiness, platform, project, owningEntity.

POST body:

{ "options": [ <list of strings> ] }

Next  Previous

3. Component Description:

4. Known System limitations

Non known.

5. System Deployment Architecture



6. New Release Capabilities

https://lf-onap.atlassian.net/browse/REQ-430

7. References

  1. https://docs.onap.org/en/elalto/submodules/vid.git/docs/consumedapis.html

  2. VID R4 M3 Architecture Review