+============================================
ONAP Application Controller (APPC) API Guide
============================================
This document is intended for an advanced technical audience, such as the engineers or architects who need to use this guide to develop an interfacing application. The guide assumes a knowledge of the Open Network Automation Platform (ONAP) components and features, and familiarity with JSON notation.
-Conventions
------------
-
-+--------------+------------------------------------------------------------------------------------------+
-| Convention | Description |
-| | |
-+==============+==========================================================================================+
-|``Monospace`` | This font indicates sample codes, screenshots, or elements. For example:: |
-| | |
-| | "contact": { |
-| | "contactType": "USER", |
-| | "source": "app1", |
-| | } |
-| | |
-+--------------+------------------------------------------------------------------------------------------+
-|*Italics* | Emphasizes a point or denotes new terms at the place where they are defined in the text. |
-| | Indicates an external book title reference. |
-| | |
-+--------------+------------------------------------------------------------------------------------------+
-
-
-
Life Cycle Management Commands
==============================
For more details, see the APPC Client Library Guide at:
- guides/appc_api_client
+ :ref:`appc_client_library`
The client library supports both synchronous and asynchronous flows as follows.
-Asynchronous Flow
-^^^^^^^^^^^^^^^^^
+**Asynchronous Flow**
- The APPC Client Library is called via an asynchronous API using a full command object, which is mapped to a JSON representation.
- The APPC client calls the UEB/DMaaP client and sends the JSON command to a configured topic.
- The APPC client pulls response messages from the configured topic.
- On receiving the response for the command, APPC client runs the relevant callback method of the consumer ResponseHandler.
-Synchronous Flow
-^^^^^^^^^^^^^^^^
+**Synchronous Flow**
- The APPC Client Library is called via a synchronous API using a full command object, which is mapped to a JSON representation.
- The APPC client calls the UEB/DMaaP client and sends the JSON command to a configured topic.
The LCM API general request format is applicable for both POST HTTP API and for the message body received via the EUB/DMaaP bus.
LCM Request
-^^^^^^^^^^^
+-----------
The LCM request comprises a common header and a section containing the details of the LCM action.
The LCM request conforms to the following structure::
LCM Response
-^^^^^^^^^^^^
+------------
The LCM response comprises a common header and a section containing the payload and action details.
Status Codes
-^^^^^^^^^^^^
+------------
The status code is returned in the response message as the code parameter, and the description as the message parameter.
Malformed Message Response
-^^^^^^^^^^^^^^^^^^^^^^^^^^
+--------------------------
A malformed message is an invalid request based on the LCM API YANG scheme specification. APPC rejects malformed requests as implemented by ODL infrastructure level.
artifacts to SDC which distributes them to all APPC instances in the
same environment (e.g., production).
-For more details, see the APPC Self-Service VNF Onboarding Guide (add link).
+For more details, see the APPC Self-Service VNF Onboarding Guide.
+----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------+----------------------------------+
Audit Response
-^^^^^^^^^^^^^^
+--------------
The audit response returns an indication of success or failure of the audit. If a new configuration is uploaded to the APPC database, the payload contains the ‘upload\_config\_id’ and values for any records created. In addition, the configuration is sent to the ECOMP Data Router bus which may be received by an external configuration storage system.
+------------------------------+--------------------------------------------------------+
CheckLock Response
-^^^^^^^^^^^^^^^^^^
+------------------
The CheckLock command returns a customized version of the LCM
response.
Configure Response
-^^^^^^^^^^^^^^^^^^
+------------------
The Configure response returns an indication of success or failure of the request. If successful, the return payload contains the ‘upload\_config\_id’ and values for any records created. In addition, the configuration is sent to the ECOMP Data Router bus which may be received by an external configuration storage system.
A failed Configure action returns a failure response and the specific failure message in the response block.
ConfigModify Response
-^^^^^^^^^^^^^^^^^^^^^
+---------------------
The ConfigModify response returns an indication of success or failure of the request. If successful, the return payload contains the ‘upload\_config\_id’ and values for any records created. In addition, the configuration is sent to the ECOMP Data Router bus which may be received by an external configuration storage system.
+---------------------+-------------------------------------------------------------------------+---------------------+------------------------------------+
Snapshot Response
-^^^^^^^^^^^^^^^^^
+-----------------
The Snapshot command returns an extended version of the LCM response.
+---------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------+-----------------------------------------------------------------+
StartApplication Response
-^^^^^^^^^^^^^^^^^^^^^^^^^
+-------------------------
The StartApplication response returns an indication of success or failure of the request.
+---------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------+-----------------------------------------------------------------+
StopApplication Response
-^^^^^^^^^^^^^^^^^^^^^^^^
+------------------------
The StopApplication response returns an indication of success or failure of the request.