summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorScott Seabolt <js9808@att.com>2017-10-10 11:27:11 -0400
committerPatrick Brady <pb071s@att.com>2017-10-10 18:41:26 +0000
commitf7824831d63aeb5be44077de7bf51fa05a4e5010 (patch)
treea0630791386af4ecacce90ffbff108857822c2a3
parentc4842e4992d4f8dfc7ec38da6c4f6d69a1e223ab (diff)
Updating the formatting for APPC docs
Updated header formatting for docs Issue-Id: APPC-102 Change-Id: Id26a4c85c8d370088eb0d2aef5e9aaadc075f4ab Signed-off-by: Scott Seabolt <js9808@att.com>
-rw-r--r--docs/APPC API Guide/APPC API Guide.rst34
-rw-r--r--docs/APPC Client Library Guide/APPC Client Library Guide.rst13
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.