From f7824831d63aeb5be44077de7bf51fa05a4e5010 Mon Sep 17 00:00:00 2001 From: Scott Seabolt Date: Tue, 10 Oct 2017 11:27:11 -0400 Subject: Updating the formatting for APPC docs Updated header formatting for docs Issue-Id: APPC-102 Change-Id: Id26a4c85c8d370088eb0d2aef5e9aaadc075f4ab Signed-off-by: Scott Seabolt --- docs/APPC API Guide/APPC API Guide.rst | 34 ++++++++++++---------- .../APPC Client Library Guide.rst | 13 +++++---- 2 files changed, 27 insertions(+), 20 deletions(-) diff --git a/docs/APPC API Guide/APPC API Guide.rst b/docs/APPC API Guide/APPC API Guide.rst index 6938d1511..8b071903b 100644 --- a/docs/APPC API Guide/APPC API Guide.rst +++ b/docs/APPC API Guide/APPC API Guide.rst @@ -1,9 +1,11 @@ +.. _appc_api_guide: + ============================================ ONAP Application Controller (APPC) API Guide ============================================ Revision History ----------------- +================ +--------------+------------+---------------+--------------------------------------------------------+ | Date | Revision | Author | Changes | @@ -21,7 +23,7 @@ Revision History | 2017-02-06 | 1.0.0 | mjf | copyright updated | +--------------+------------+---------------+--------------------------------------------------------+ -| + Introduction ============ @@ -71,14 +73,16 @@ For more details, see the APPC Client Library Guide at: 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. @@ -128,7 +132,7 @@ Generic Request Format 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:: @@ -252,7 +256,7 @@ The response format is applicable for both POST HTTP API and for the message bod LCM Response ------------- +^^^^^^^^^^^^ The LCM response comprises a common header and a section containing the payload and action details. @@ -633,7 +637,7 @@ The Audit action does not require any payload parameters. +----------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------+----------------------------------+ 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. @@ -664,7 +668,7 @@ The CheckLock action does not require any payload parameters. +------------------------------+--------------------------------------------------------+ CheckLock Response ------------------- +^^^^^^^^^^^^^^^^^^ The CheckLock command returns a customized version of the LCM response. @@ -751,7 +755,7 @@ A failed Configure action returns a failure response and the specific failure me 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. @@ -809,7 +813,7 @@ If successful, this request returns a success response. 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. @@ -855,7 +859,7 @@ A failed ConfigBackup action returns a failure response code and the specific fa +---------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------+-----------------------------------------------------------------+ ConfigBackup Response ---------------------- +^^^^^^^^^^^^^^^^^^^^^ The ConfigBackup response returns an indication of success or failure of the request. @@ -901,7 +905,7 @@ A failed ConfigRestore action returns a failure response code and the specific f +---------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------+-----------------------------------------------------------------+ ConfigRestore Response ----------------------- +^^^^^^^^^^^^^^^^^^^^^^ The ConfigRestore response returns an indication of success or failure of the request. @@ -1204,7 +1208,7 @@ Payload Parameters +---------------------+-------------------------------------------------------------------------+---------------------+------------------------------------+ Snapshot Response ------------------ +^^^^^^^^^^^^^^^^^ The Snapshot command returns an extended version of the LCM response. @@ -1275,7 +1279,7 @@ A failed StartApplication action returns a failure response code and the specifi +---------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------+-----------------------------------------------------------------+ StartApplication Response -------------------------- +^^^^^^^^^^^^^^^^^^^^^^^^^ The StartApplication response returns an indication of success or failure of the request. @@ -1335,7 +1339,7 @@ A failed StopApplication action returns a failure response code and the specific +---------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+---------------------+-----------------------------------------------------------------+ StopApplication Response ------------------------- +^^^^^^^^^^^^^^^^^^^^^^^^ The StopApplication response returns an indication of success or failure of the request. diff --git a/docs/APPC Client Library Guide/APPC Client Library Guide.rst b/docs/APPC Client Library Guide/APPC Client Library Guide.rst index 7de54b339..37b8716ad 100644 --- a/docs/APPC Client Library Guide/APPC Client Library Guide.rst +++ b/docs/APPC Client Library Guide/APPC Client Library Guide.rst @@ -6,14 +6,13 @@ Application Controller (APPC) Client Library Guide Revision History ----------------- +================ +--------------+------------+---------------+--------------------------------------------------+ | Date | Revision | Author | Changes | +--------------+------------+---------------+--------------------------------------------------+ | 2017-08-22 | 1.0.0 | Paul Miller | First draft | +--------------+------------+---------------+--------------------------------------------------+ -+--------------+------------+---------------+--------------------------------------------------+ Introduction ============ @@ -26,7 +25,9 @@ This document is for an advanced technical audience, which includes engineers an Related Documentation --------------------- -For additional information, see the ONAP Application Controller (APPC) API Guide. +For additional information, see + + :ref:`appc_api_guide` Client Library Background @@ -54,14 +55,16 @@ APP-C Client Library Flow |image0| -**Asynchronous Flow** +Asynchronous Flow +^^^^^^^^^^^^^^^^^ - The APPC Client Library is called using an asynchronous API using a full command object, which is mapped to a JSON representation. - The APPC client calls the UEB 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, the APPC client runs the relevant callback method of the consumer ResponseHandler. -**Synchronous Flow** +Synchronous Flow +^^^^^^^^^^^^^^^^ - The APPC Client Library is called using a synchronous API using a full command object, which is mapped to a JSON representation. - The APPC client calls the UEB client and sends the JSON command to a configured topic. -- cgit 1.2.3-korg